feat: initial commit - kratos admin service

web/src/services/index.ts

@@ -0,0 +1,60 @@
+import { createAdminServiceClient } from "@/services/kratos/admin/v1";
+import { request } from "@umijs/max";
+
+type Request = {
+  path: string;
+  method: string;
+  body: string | null;
+};
+
+function requestHandler({ path, method, body }: Request) {
+  // Use protojson so proto semantics (oneof, well-known types like Timestamp)
+  // are preserved in both directions. kratos selects the codec from the
+  // Content-Type / Accept subtype, so both headers must name protojson.
+  const headers: Record<string, string> = {
+    Accept: "application/protojson",
+  };
+  // Generated clients pass a body only on POST / PUT / PATCH.
+  if (body) {
+    headers["Content-Type"] = "application/protojson";
+  }
+  return request("/" + path, {
+    method: method,
+    data: body,
+    headers: headers,
+  });
+}
+
+// Generated clients are stateless closures over the handler, so one instance
+// per service is enough. Add a resource by adding one line here; call sites
+// keep importing `services` unchanged.
+export const services = {
+  admin: createAdminServiceClient(requestHandler),
+};
+
+/**
+ * The structured error body the server returns (kratos `errors.Status` in its
+ * protojson form). This is a data shape, not an Error subclass: narrow it with
+ * `asServiceError` rather than `instanceof`.
+ */
+export type ServiceError = {
+  code?: number;
+  reason?: string;
+  message?: string;
+  metadata?: Record<string, string>;
+};
+
+/**
+ * Read the structured error body out of whatever `request` rejected with.
+ * Returns undefined when the failure carries no structured body — a gateway
+ * plain-text 502, a proxy timeout, an aborted request.
+ */
+export function asServiceError(error: unknown): ServiceError | undefined {
+  const data = (error as { response?: { data?: unknown } })?.response?.data;
+  return data && typeof data === "object" ? (data as ServiceError) : undefined;
+}
+
+// Re-export DTOs so pages import types and clients from the same place. If a
+// second domain ever collides on a type name, switch to namespaced exports
+// (`export * as adminV1 from "@/services/kratos/admin/v1"`).
+export type * from "@/services/kratos/admin/v1";