@podosoft/podokit-api-client 0.4.0

package/dist/index.js

@@ -0,0 +1,87 @@
+import { createAuthClient } from "better-auth/client";
+import { adminClient, twoFactorClient } from "better-auth/client/plugins";
+/** Error thrown when the API returns the standard error envelope or a non-2xx status. */
+export class ApiError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(code, message, statusCode, details) {
+        super(message);
+        this.name = "ApiError";
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+    }
+}
+function toApiError(data, response) {
+    if (data && typeof data === "object" && "error" in data) {
+        const error = data.error;
+        if (error && typeof error === "object") {
+            const record = error;
+            return new ApiError(typeof record.code === "string" ? record.code : "HTTP_ERROR", typeof record.message === "string" ? record.message : response.statusText, typeof record.statusCode === "number" ? record.statusCode : response.status, record.details);
+        }
+    }
+    return new ApiError("HTTP_ERROR", response.statusText || "Request failed", response.status);
+}
+/**
+ * Create a typed API client. Every frontend talks to the PodoKit backend
+ * through this single entry point — never with a raw fetch.
+ *
+ * - `client.auth` is the better-auth client (email/password, sessions, and the
+ *   admin plugin: `client.auth.admin.listUsers()`, `banUser`, `setRole`, ...).
+ * - `client.get/post/put/patch/del` call the app's REST endpoints and parse the
+ *   standard error envelope, throwing {@link ApiError} on failure.
+ */
+export function createApiClient(options = {}) {
+    const baseUrl = options.baseUrl ?? "";
+    const apiBasePath = options.apiBasePath ?? "/api";
+    const credentials = options.credentials ?? "include";
+    const doFetch = options.fetch ?? globalThis.fetch;
+    // better-auth mounts at /api/auth and needs an absolute origin. In the
+    // browser an empty baseUrl resolves to the current origin.
+    const authOrigin = options.baseUrl ?? (typeof globalThis.location === "undefined" ? "" : globalThis.location.origin);
+    // Inner factory so the return type keeps the admin plugin's client methods
+    // (a bare ReturnType<typeof createAuthClient> would drop the plugin augmentation).
+    const makeAuthClient = () => createAuthClient({
+        baseURL: authOrigin,
+        plugins: [adminClient(), twoFactorClient()],
+        fetchOptions: {
+            credentials,
+            ...(options.fetch ? { customFetchImpl: options.fetch } : {}),
+        },
+    });
+    // Created lazily: REST-only usage (and SSR without an origin) never triggers
+    // the better-auth client's eager URL validation.
+    let authClient;
+    function getAuth() {
+        authClient ??= makeAuthClient();
+        return authClient;
+    }
+    async function request(method, path, body) {
+        const response = await doFetch(`${baseUrl}${apiBasePath}${path}`, {
+            method,
+            credentials,
+            headers: body === undefined ? undefined : { "content-type": "application/json" },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        const text = await response.text();
+        const data = text ? JSON.parse(text) : undefined;
+        if (!response.ok) {
+            throw toApiError(data, response);
+        }
+        return data;
+    }
+    return {
+        /** The better-auth client (auth + admin plugin), created on first access. */
+        get auth() {
+            return getAuth();
+        },
+        /** Low-level typed request against the app's REST API. */
+        request,
+        get: (path) => request("GET", path),
+        post: (path, body) => request("POST", path, body),
+        put: (path, body) => request("PUT", path, body),
+        patch: (path, body) => request("PATCH", path, body),
+        del: (path) => request("DELETE", path),
+    };
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@podosoft/podokit-api-client",
+  "version": "0.4.0",
+  "description": "Typed API client for PodoKit backends: better-auth (auth + admin) plus a standard error-envelope request layer.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/podosoft-dev/podokit.git",
+    "directory": "packages/api-client"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "better-auth": "^1.6.23"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}