@gettersethya/mira-client 0.1.0-alpha.2

package/dist/src/client/factory.d.ts

@@ -0,0 +1,76 @@
+import type { AnyCollectionDef, FieldsMap } from "@gettersethya/mira-collection";
+import type { BrowserAuth, ServerAuth } from "./auth.js";
+import type { CollectionClient, RetryOptions } from "./collection.js";
+import type { ClientHandler } from "./handler.js";
+import type { InferRecord } from "./types.js";
+type CollectionAdapter = <F extends FieldsMap>(client: CollectionClient<F>, name: string) => CollectionClient<F>;
+type BaseClient<A extends BrowserAuth | ServerAuth = BrowserAuth | ServerAuth> = {
+    collection<C extends AnyCollectionDef>(def: C): CollectionClient<C["fields"]>;
+    auth: A;
+    withCollections<M extends Record<string, AnyCollectionDef>>(map: M, opts?: {
+        adapter?: CollectionAdapter;
+    }): BaseClient<A> & CollectionAccessors<M>;
+};
+type CollectionAccessors<M extends Record<string, AnyCollectionDef>> = {
+    [K in keyof M]: CollectionClient<M[K]["fields"]> & (M[K]["schema"]["x-collection-kind"] extends "auth" ? {
+        authWithPassword(): ClientHandler<{
+            token: string;
+            record: InferRecord<M[K]["fields"]>;
+        }, {
+            email: string;
+            password: string;
+        }>;
+    } : {});
+};
+type BrowserMiraClient = BaseClient<BrowserAuth>;
+type ServerMiraClient = BaseClient<ServerAuth>;
+/**
+ * Create a Mira client instance for the browser (default mode).
+ * Uses cookies for auth — the client tracks login state via `auth.isLoggedIn()`.
+ *
+ * @param baseUrl - Base URL of the Mira server (default: "/" for same-origin)
+ * @param opts.defaultRetryOptions - Optional default retry schedule for all operations
+ * @returns A BrowserMiraClient with `auth: BrowserAuth`
+ *
+ * @example
+ * import { createMiraClient } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("http://localhost:3000")
+ * const posts = await mira.posts.getList().raw()
+ *
+ * @example
+ * // With retry options
+ * import { Schedule } from "effect"
+ * const mira = createMiraClient("/", {
+ *   defaultRetryOptions: { schedule: Schedule.exponential(100) }
+ * })
+ */
+export declare function createMiraClient(baseUrl?: string, opts?: {
+    type?: "browser";
+    defaultRetryOptions?: RetryOptions;
+}): BrowserMiraClient;
+/**
+ * Create a Mira client instance for server-side rendering (SSR).
+ * Uses `type: "server"` to enable manual JWT token management via `auth: ServerAuth`.
+ *
+ * In server mode, the client does NOT track login state — you must call
+ * `mira.auth.setToken(token)` explicitly with the JWT from your SSR context.
+ *
+ * @param baseUrl - Base URL of the Mira server
+ * @param opts.type - Must be "server"
+ * @param opts.defaultRetryOptions - Optional default retry schedule
+ * @returns A ServerMiraClient with `auth: ServerAuth`
+ *
+ * @example
+ * import { createMiraClient } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("http://localhost:3000", { type: "server" })
+ * mira.auth.setToken("eyJ...")  // set token from SSR context
+ * const posts = await mira.posts.getList().raw()
+ */
+export declare function createMiraClient(baseUrl: string | undefined, opts: {
+    type: "server";
+    defaultRetryOptions?: RetryOptions;
+}): ServerMiraClient;
+export {};
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/client/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/client/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,cAAc,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,KAAK,iBAAiB,GAAG,CAAC,CAAC,SAAS,SAAS,EAC3C,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,IAAI,EAAE,MAAM,KACT,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAExB,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,IAAI;IAC/E,UAAU,CAAC,CAAC,SAAS,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7E,IAAI,EAAE,CAAC,CAAA;IACP,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACxD,GAAG,EAAE,CAAC,EACN,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAE,GACrC,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAC1C,CAAA;AAED,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI;KACpE,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC9C,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC,SAAS,MAAM,GAC/C;QACE,gBAAgB,IAAI,aAAa,CAC/B;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;SAAE,EACtD;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CACpC,CAAA;KACF,GACD,EAAE,CAAC;CACV,CAAA;AAED,KAAK,iBAAiB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;AAEhD,KAAK,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;AAwG9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,mBAAmB,CAAC,EAAE,YAAY,CAAA;CAAE,GAC9D,iBAAiB,CAAA;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,mBAAmB,CAAC,EAAE,YAAY,CAAA;CAAE,GAC3D,gBAAgB,CAAA"}

package/dist/src/client/factory.js

@@ -0,0 +1,106 @@
+import { HttpClient, HttpClientRequest as HCR } from "@effect/platform";
+import { Effect, MutableRef } from "effect";
+import { makeBrowserAuth, makeServerAuth } from "./auth.js";
+import { makeCollectionClient } from "./collection.js";
+import { MiraError } from "./errors.js";
+import { makeClientHandler as makeHandler } from "./handler.js";
+function catchAllErrors(effect) {
+    return effect.pipe(Effect.catchTags({
+        RequestError: (e) => Effect.fail(new MiraError({ status: 0, body: e.message })),
+        ResponseError: (e) => Effect.fail(new MiraError({ status: e.response.status, body: e.message })),
+        HttpBodyError: (e) => Effect.fail(new MiraError({ status: 500, body: String(e) }))
+    }));
+}
+function createExecute(baseUrl, authTokenRef) {
+    return (req) => {
+        const raw = Effect.gen(function* () {
+            const http = yield* HttpClient.HttpClient;
+            const token = authTokenRef ? MutableRef.get(authTokenRef) : null;
+            const finalReq = HCR.prependUrl(baseUrl)(token ? HCR.setHeader(req, "Authorization", `Bearer ${token}`) : req);
+            const res = yield* http.execute(finalReq);
+            if (res.status >= 400) {
+                const body = yield* res.json;
+                return yield* new MiraError({ status: res.status, body });
+            }
+            if (res.status === 204) {
+                return undefined;
+            }
+            return (yield* res.json);
+        });
+        return catchAllErrors(raw);
+    };
+}
+function createMiraClientInternal(baseUrl = "/", type = "browser", defaultRetryOptions) {
+    const fileTokenCacheRef = MutableRef.make(new Map());
+    const authTokenRef = type === "server" ? MutableRef.make(null) : null;
+    const loggedInRef = type === "browser" ? MutableRef.make(false) : null;
+    const execute = createExecute(baseUrl, authTokenRef);
+    const makeClientHandler = (effect) => makeHandler(effect);
+    function buildCollectionClient(def) {
+        const isAuth = def.schema["x-collection-kind"] === "auth";
+        return makeCollectionClient({
+            collectionName: def.name,
+            schema: def.schema,
+            fields: def.fields,
+            execute,
+            baseUrl,
+            authTokenRef,
+            loggedInRef,
+            fileTokenCacheRef,
+            isAuth,
+            ...(defaultRetryOptions !== undefined ? { defaultRetryOptions } : {})
+        });
+    }
+    function makeAuth() {
+        if (type === "server" && authTokenRef !== null) {
+            return makeServerAuth(authTokenRef, fileTokenCacheRef);
+        }
+        if (loggedInRef !== null) {
+            return makeBrowserAuth(execute, makeClientHandler, loggedInRef);
+        }
+        return makeBrowserAuth(execute, makeClientHandler, MutableRef.make(false));
+    }
+    function withCollections(map, opts) {
+        const baseClient = buildBaseClient();
+        const collections = {};
+        for (const key of Object.keys(map)) {
+            const raw = buildCollectionClient(map[key]);
+            collections[key] = (opts?.adapter ? opts.adapter(raw, String(key)) : raw);
+        }
+        return Object.assign(baseClient, collections);
+    }
+    function buildBaseClient() {
+        return {
+            collection: (def) => buildCollectionClient(def),
+            auth: makeAuth(),
+            withCollections
+        };
+    }
+    return buildBaseClient();
+}
+/**
+ * Create a Mira client instance.
+ *
+ * In browser mode (default), auth is cookie-based and `isLoggedIn()` reflects
+ * client-side login state. In server mode, you manage the JWT token explicitly
+ * via `auth.setToken()`.
+ *
+ * Use `withCollections()` to create typed accessors for each collection:
+ *
+ * @example
+ * const mira = createMiraClient("/").withCollections({ posts, users })
+ * const posts = await mira.posts.getList().raw()
+ * const loginResult = await mira.users.authWithPassword().raw({
+ *   email: "admin@test.com",
+ *   password: "admin1234"
+ * })
+ *
+ * @see BrowserAuth — client-side auth
+ * @see ServerAuth — server-side auth
+ * @see CollectionClient — the per-collection client interface
+ */
+export function createMiraClient(baseUrl = "/", opts = {}) {
+    const { type = "browser", defaultRetryOptions } = opts;
+    return createMiraClientInternal(baseUrl, type, defaultRetryOptions);
+}
+//# sourceMappingURL=factory.js.map

package/dist/src/client/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/client/factory.ts"],"names":[],"mappings":"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"}

package/dist/src/client/file.d.ts

@@ -0,0 +1,116 @@
+import type { HttpClient } from "@effect/platform";
+import { Effect, MutableRef } from "effect";
+import type { AnyCollectionDef, FieldsMap } from "@gettersethya/mira-collection";
+import { MiraError } from "./errors.js";
+import type { ClientHandler, ExecuteFn } from "./handler.js";
+import type { CollectionFileFields } from "./types.js";
+/**
+ * Build a file request URL for the Mira file-serving endpoint.
+ *
+ * Constructs a URL of the form:
+ * `{baseUrl}/api/files/{collection}/{id}/{filename}?token={token}&thumb={spec}`
+ *
+ * Query parameters are only appended when defined.
+ *
+ * @param baseUrl - The base URL of the Mira server (e.g., "http://localhost:3000" or "/" for same-origin)
+ * @param collection - The collection name
+ * @param id - The record ID
+ * @param filename - The filename as stored in the record's file field
+ * @param opts.token - Optional short-lived JWT token for protected files
+ * @param opts.thumb - Optional thumbnail spec (e.g., "200x200", "100x100_fit")
+ * @returns The fully constructed file URL string
+ *
+ * @example
+ * buildFileUrl("/", "posts", "abc123", "cover.jpg")
+ * // "/api/files/posts/abc123/cover.jpg"
+ *
+ * @example
+ * buildFileUrl("http://localhost:8090", "users", "u1", "avatar.png", {
+ *   token: "eyJ...",
+ *   thumb: "200x200"
+ * })
+ * // "http://localhost:8090/api/files/users/u1/avatar.png?token=eyJ...&thumb=200x200"
+ */
+export declare function buildFileUrl(baseUrl: string, collection: string, id: string, filename: string, opts?: {
+    token?: string;
+    thumb?: string;
+}): string;
+/**
+ * Create a function that retrieves a short-lived file-access JWT token for a collection.
+ * Tokens are cached per collection with a 30-second freshness buffer before expiry.
+ *
+ * @internal Called internally by `makeFileFields`. Use `ProtectedFileFieldClient.getToken()` instead.
+ */
+export declare function makeGetFileToken(execute: ExecuteFn, cacheRef: MutableRef.MutableRef<Map<string, {
+    token: string;
+    expiresAt: number;
+}>>): (collection: string) => Effect.Effect<string, MiraError, HttpClient.HttpClient>;
+/**
+ * Client interface for a public (non-protected) file field.
+ * File URLs are constructed synchronously because no auth token is needed.
+ *
+ * @example
+ * // Given a post with a public "cover" file field
+ * const url = post.fields.cover.url(post.id, "cover.jpg")
+ * // "/api/files/posts/abc/cover.jpg"
+ *
+ * @example
+ * // With thumbnail variant
+ * const thumbUrl = post.fields.cover.url(post.id, "cover.jpg", { thumb: "200x200" })
+ *
+ * @see ProtectedFileFieldClient — file client that requires auth tokens
+ * @see buildFileUrl — underlying URL builder
+ */
+export type PublicFileFieldClient = {
+    isProtected: false;
+    url(id: string, filename: string, opts?: {
+        thumb?: string;
+    }): string;
+};
+/**
+ * Client interface for a protected file field.
+ * Protected files require a short-lived JWT token to access.
+ *
+ * Three modes:
+ * - `url(id, filename, { token })` — synchronous URL construction when you already
+ *   have a token (e.g., from `getToken()`)
+ * - `asyncUrl(id, filename)` — returns a `ClientHandler<string>` that fetches a token
+ *   and constructs the URL in one async call
+ * - `getToken()` — fetches a fresh file-access token (cached for 30s by collection)
+ *
+ * @example
+ * // Async URL construction (fetches token automatically)
+ * const url = await post.fields.avatar.asyncUrl(post.id, "avatar.png").raw()
+ *
+ * @example
+ * // Manual token management for batch operations
+ * const token = await post.fields.avatar.getToken().raw()
+ * const u1 = post.fields.avatar.url("id1", "img1.png", { token })
+ * const u2 = post.fields.avatar.url("id2", "img2.png", { token })
+ *
+ * @see PublicFileFieldClient — file client for unprotected files
+ * @see buildFileUrl — underlying URL builder
+ */
+export type ProtectedFileFieldClient = {
+    isProtected: true;
+    asyncUrl(id: string, filename: string, opts?: {
+        thumb?: string;
+    }): ClientHandler<string>;
+    url(id: string, filename: string, opts: {
+        token: string;
+        thumb?: string;
+    }): string;
+    getToken(): ClientHandler<string>;
+};
+/**
+ * Build the file field client interfaces for a collection.
+ * Iterates over the schema's properties, creating `PublicFileFieldClient` or
+ * `ProtectedFileFieldClient` instances for each `file`-kind field.
+ *
+ * @internal Called by `makeCollectionClient` — use `collection.fields` instead.
+ */
+export declare function makeFileFields<F extends FieldsMap>(collection: AnyCollectionDef, schema: AnyCollectionDef["schema"], baseUrl: string, execute: ExecuteFn, cacheRef: MutableRef.MutableRef<Map<string, {
+    token: string;
+    expiresAt: number;
+}>>, makeClientHandler: <T>(effect: Effect.Effect<T, MiraError, HttpClient.HttpClient>) => ClientHandler<T>): CollectionFileFields<F>;
+//# sourceMappingURL=file.d.ts.map

package/dist/src/client/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/client/file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAA;AAGrE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,MAAM,CAOR;AAcD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GACjF,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,CAkBjF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,KAAK,CAAA;IAClB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;CACrE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACxF,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;IAClF,QAAQ,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;CAClC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAClF,iBAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,GACrG,oBAAoB,CAAC,CAAC,CAAC,CAoCzB"}

package/dist/src/client/file.js

@@ -0,0 +1,99 @@
+import { HttpClientRequest as HCR } from "@effect/platform";
+import { Effect, MutableRef } from "effect";
+import { MiraError } from "./errors.js";
+/**
+ * Build a file request URL for the Mira file-serving endpoint.
+ *
+ * Constructs a URL of the form:
+ * `{baseUrl}/api/files/{collection}/{id}/{filename}?token={token}&thumb={spec}`
+ *
+ * Query parameters are only appended when defined.
+ *
+ * @param baseUrl - The base URL of the Mira server (e.g., "http://localhost:3000" or "/" for same-origin)
+ * @param collection - The collection name
+ * @param id - The record ID
+ * @param filename - The filename as stored in the record's file field
+ * @param opts.token - Optional short-lived JWT token for protected files
+ * @param opts.thumb - Optional thumbnail spec (e.g., "200x200", "100x100_fit")
+ * @returns The fully constructed file URL string
+ *
+ * @example
+ * buildFileUrl("/", "posts", "abc123", "cover.jpg")
+ * // "/api/files/posts/abc123/cover.jpg"
+ *
+ * @example
+ * buildFileUrl("http://localhost:8090", "users", "u1", "avatar.png", {
+ *   token: "eyJ...",
+ *   thumb: "200x200"
+ * })
+ * // "http://localhost:8090/api/files/users/u1/avatar.png?token=eyJ...&thumb=200x200"
+ */
+export function buildFileUrl(baseUrl, collection, id, filename, opts) {
+    const base = `${baseUrl}/api/files/${collection}/${id}/${filename}`;
+    const params = new URLSearchParams();
+    if (opts?.token !== undefined)
+        params.set("token", opts.token);
+    if (opts?.thumb !== undefined)
+        params.set("thumb", opts.thumb);
+    const qs = params.toString();
+    return qs ? `${base}?${qs}` : base;
+}
+function toExecuteEffect(reqEffect, execute) {
+    return reqEffect.pipe(Effect.flatMap((req) => execute(req)), Effect.catchTag("HttpBodyError", (e) => Effect.fail(new MiraError({ status: 500, body: String(e) }))));
+}
+/**
+ * Create a function that retrieves a short-lived file-access JWT token for a collection.
+ * Tokens are cached per collection with a 30-second freshness buffer before expiry.
+ *
+ * @internal Called internally by `makeFileFields`. Use `ProtectedFileFieldClient.getToken()` instead.
+ */
+export function makeGetFileToken(execute, cacheRef) {
+    return (collection) => Effect.gen(function* () {
+        const cache = MutableRef.get(cacheRef);
+        const cached = cache.get(collection);
+        if (cached !== undefined && Date.now() < cached.expiresAt - 30_000) {
+            return cached.token;
+        }
+        const data = yield* toExecuteEffect(HCR.bodyJson(HCR.post("/api/files/token"), { collection }), execute);
+        const newCache = new Map(cache).set(collection, data);
+        MutableRef.set(cacheRef, newCache);
+        return data.token;
+    });
+}
+/**
+ * Build the file field client interfaces for a collection.
+ * Iterates over the schema's properties, creating `PublicFileFieldClient` or
+ * `ProtectedFileFieldClient` instances for each `file`-kind field.
+ *
+ * @internal Called by `makeCollectionClient` — use `collection.fields` instead.
+ */
+export function makeFileFields(collection, schema, baseUrl, execute, cacheRef, makeClientHandler) {
+    const result = {};
+    const getFileToken = makeGetFileToken(execute, cacheRef);
+    for (const [key, prop] of Object.entries(schema.properties)) {
+        if (prop["x-kind"] !== "file")
+            continue;
+        const isProtected = prop["x-protected"] === true;
+        if (isProtected) {
+            const protectedField = {
+                isProtected: true,
+                asyncUrl: (id, filename, opts) => makeClientHandler(Effect.gen(function* () {
+                    const token = yield* getFileToken(collection.name);
+                    return buildFileUrl(baseUrl, collection.name, id, filename, { token, ...(opts?.thumb !== undefined ? { thumb: opts.thumb } : {}) });
+                })),
+                url: (id, filename, opts) => buildFileUrl(baseUrl, collection.name, id, filename, { token: opts.token, ...(opts.thumb !== undefined ? { thumb: opts.thumb } : {}) }),
+                getToken: () => makeClientHandler(getFileToken(collection.name)),
+            };
+            result[key] = protectedField;
+        }
+        else {
+            const publicField = {
+                isProtected: false,
+                url: (id, filename, opts) => buildFileUrl(baseUrl, collection.name, id, filename, opts),
+            };
+            result[key] = publicField;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=file.js.map

package/dist/src/client/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/client/file.ts"],"names":[],"mappings":"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"}

package/dist/src/client/handler.d.ts

@@ -0,0 +1,92 @@
+import type { HttpClient, HttpClientRequest } from "@effect/platform";
+import { Effect } from "effect";
+import type { MiraError } from "./errors.js";
+/**
+ * A dual-interface handler for dealing with Mira server responses.
+ *
+ * When `TInput extends void` (query operations: getList, getOne, getFirstOrNone, getFullList):
+ * - `.raw()` — returns `Promise<TData>`, throws `MiraError` on failure
+ * - `.toEffect()` — returns `Effect.Effect<TData, MiraError, HttpClient.HttpClient>`
+ *
+ * When `TInput` is provided (mutation operations: create, update, delete):
+ * - `.raw(input: TInput)` — returns `Promise<TData>`, throws `MiraError` on failure
+ * - `.toEffect(input: TInput)` — returns `Effect.Effect<TData, MiraError, HttpClient.HttpClient>`
+ *
+ * @example
+ * import type { ClientHandler } from "@gettersethya/mira-client"
+ *
+ * // Query handler: TInput = void
+ * const listHandler: ClientHandler<{ items: Post[]; nextCursor: number | null }>
+ * const items = await listHandler.raw()  // Promise-based
+ * const effect = listHandler.toEffect()  // Effect-based
+ *
+ * // Mutation handler: TInput = { title: string }
+ * const createHandler: ClientHandler<Post, { title: string }>
+ * const post = await createHandler.raw({ title: "hello" })
+ * const createEffect = createHandler.toEffect({ title: "hello" })
+ *
+ * @see makeClientHandler — constructs a ClientHandler from an Effect
+ * @see makeMutationHandler — constructs a ClientHandler for mutations
+ * @see MiraError — the error thrown by .raw()
+ */
+export type ClientHandler<TData, TInput = void> = TInput extends void ? {
+    raw(): Promise<TData>;
+    toEffect(): Effect.Effect<TData, MiraError, HttpClient.HttpClient>;
+} : {
+    raw(input: TInput): Promise<TData>;
+    toEffect(input: TInput): Effect.Effect<TData, MiraError, HttpClient.HttpClient>;
+};
+/**
+ * Construct a `ClientHandler<T>` (query variant, TInput = void) from an Effect.
+ *
+ * The Effect is provided `FetchHttpClient.layer` at runtime when `.raw()` is called.
+ * The `.toEffect()` method returns the Effect without providing the layer, allowing
+ * the caller to supply their own `HttpClient` implementation (e.g., for testing).
+ *
+ * @param effect - The Effect to wrap. Must produce `T` on success or `MiraError` on failure
+ * @returns A ClientHandler with zero-arg .raw() and .toEffect()
+ *
+ * @example
+ * import { Effect } from "effect"
+ * import { makeClientHandler } from "@gettersethya/mira-client"
+ *
+ * const handler = makeClientHandler<{ name: string }>(
+ *   Effect.succeed({ name: "test" })
+ * )
+ * const result = await handler.raw()  // { name: "test" }
+ */
+export declare function makeClientHandler<T>(effect: Effect.Effect<T, MiraError, HttpClient.HttpClient>): ClientHandler<T>;
+/**
+ * Construct a `ClientHandler<TData, TInput>` (mutation variant) from a function
+ * that accepts input and returns an Effect.
+ *
+ * The input is provided at call time (`.raw(input)` or `.toEffect(input)`).
+ * The Effect is provided `FetchHttpClient.layer` at runtime when `.raw()` is called.
+ *
+ * @param fn - A function that takes `TInput` and returns an Effect producing `TData`
+ * @returns A ClientHandler with input-arg .raw() and .toEffect()
+ *
+ * @example
+ * import { Effect } from "effect"
+ * import { makeMutationHandler } from "@gettersethya/mira-client"
+ *
+ * const handler = makeMutationHandler<{ id: string }, { name: string }>(
+ *   (input) => Effect.succeed({ id: "1", ...input })
+ * )
+ * const result = await handler.raw({ name: "test" })  // { id: "1", name: "test" }
+ */
+export declare function makeMutationHandler<TData, TInput>(fn: (input: TInput) => Effect.Effect<TData, MiraError, HttpClient.HttpClient>): ClientHandler<TData, TInput>;
+/**
+ * The core HTTP execution function used internally by all client handlers.
+ * Takes an `HttpClientRequest`, sends it to the server, and returns the
+ * deserialized response body.
+ *
+ * Handles authentication token injection, base URL prefixing, and error mapping
+ * (HTTP 4xx/5xx responses become `MiraError` in the Effect error channel).
+ *
+ * @typeParam T - The expected response body type
+ * @param req - The HTTP request to execute (constructed via `HttpClientRequest.*`)
+ * @returns Effect that resolves to the parsed response body, or fails with MiraError
+ */
+export type ExecuteFn = <T>(req: HttpClientRequest.HttpClientRequest) => Effect.Effect<T, MiraError, HttpClient.HttpClient>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/src/client/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/client/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAS,MAAM,EAAgB,MAAM,QAAQ,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,SAAS,IAAI,GACjE;IACE,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;CACnE,GACD;IACE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;CAChF,CAAA;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,GACzD,aAAa,CAAC,CAAC,CAAC,CAWlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAC/C,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,GAC5E,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAY9B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EACxB,GAAG,EAAE,iBAAiB,CAAC,iBAAiB,KACrC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA"}

package/dist/src/client/handler.js

@@ -0,0 +1,62 @@
+import { FetchHttpClient } from "@effect/platform";
+import { Cause, Effect, Exit, Option } from "effect";
+/**
+ * Construct a `ClientHandler<T>` (query variant, TInput = void) from an Effect.
+ *
+ * The Effect is provided `FetchHttpClient.layer` at runtime when `.raw()` is called.
+ * The `.toEffect()` method returns the Effect without providing the layer, allowing
+ * the caller to supply their own `HttpClient` implementation (e.g., for testing).
+ *
+ * @param effect - The Effect to wrap. Must produce `T` on success or `MiraError` on failure
+ * @returns A ClientHandler with zero-arg .raw() and .toEffect()
+ *
+ * @example
+ * import { Effect } from "effect"
+ * import { makeClientHandler } from "@gettersethya/mira-client"
+ *
+ * const handler = makeClientHandler<{ name: string }>(
+ *   Effect.succeed({ name: "test" })
+ * )
+ * const result = await handler.raw()  // { name: "test" }
+ */
+export function makeClientHandler(effect) {
+    return {
+        raw: () => Effect.runPromiseExit(effect.pipe(Effect.provide(FetchHttpClient.layer))).then((exit) => {
+            if (Exit.isSuccess(exit))
+                return exit.value;
+            return Promise.reject(Option.getOrElse(Cause.failureOption(exit.cause), () => Cause.squash(exit.cause)));
+        }),
+        toEffect: () => effect,
+    };
+}
+/**
+ * Construct a `ClientHandler<TData, TInput>` (mutation variant) from a function
+ * that accepts input and returns an Effect.
+ *
+ * The input is provided at call time (`.raw(input)` or `.toEffect(input)`).
+ * The Effect is provided `FetchHttpClient.layer` at runtime when `.raw()` is called.
+ *
+ * @param fn - A function that takes `TInput` and returns an Effect producing `TData`
+ * @returns A ClientHandler with input-arg .raw() and .toEffect()
+ *
+ * @example
+ * import { Effect } from "effect"
+ * import { makeMutationHandler } from "@gettersethya/mira-client"
+ *
+ * const handler = makeMutationHandler<{ id: string }, { name: string }>(
+ *   (input) => Effect.succeed({ id: "1", ...input })
+ * )
+ * const result = await handler.raw({ name: "test" })  // { id: "1", name: "test" }
+ */
+export function makeMutationHandler(fn) {
+    const handler = {
+        raw: (input) => Effect.runPromiseExit(fn(input).pipe(Effect.provide(FetchHttpClient.layer))).then((exit) => {
+            if (Exit.isSuccess(exit))
+                return exit.value;
+            return Promise.reject(Option.getOrElse(Cause.failureOption(exit.cause), () => Cause.squash(exit.cause)));
+        }),
+        toEffect: (input) => fn(input),
+    };
+    return handler;
+}
+//# sourceMappingURL=handler.js.map

package/dist/src/client/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/client/handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAyCpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA0D;IAE1D,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CACR,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACtF,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAA;YAC3C,OAAO,OAAO,CAAC,MAAM,CACnB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAClF,CAAA;QACH,CAAC,CAAC;QACJ,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;KACvB,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CACjC,EAA6E;IAE7E,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,CAAC,KAAa,EAAE,EAAE,CACrB,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACzF,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAA;YAC3C,OAAO,OAAO,CAAC,MAAM,CACnB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAClF,CAAA;QACH,CAAC,CAAC;QACJ,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC;KACvC,CAAA;IACD,OAAO,OAAuC,CAAA;AAChD,CAAC"}

package/dist/src/client/index.d.ts

@@ -0,0 +1,11 @@
+export { createMiraClient } from "./factory.js";
+export { makeClientHandler, makeMutationHandler } from "./handler.js";
+export type { ClientHandler, ExecuteFn } from "./handler.js";
+export { MiraError } from "./errors.js";
+export type { InferRecord, InferCreateInput, InferMutationInput, WithExpand, CollectionFileFields, RelationKeys, FileKeys } from "./types.js";
+export type { BrowserAuth, ServerAuth } from "./auth.js";
+export type { PublicFileFieldClient, ProtectedFileFieldClient } from "./file.js";
+export { buildFileUrl } from "./file.js";
+export { makeCollectionClient } from "./collection.js";
+export type { CollectionClient } from "./collection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACrE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,oBAAoB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC7I,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/src/client/index.js

@@ -0,0 +1,6 @@
+export { createMiraClient } from "./factory.js";
+export { makeClientHandler, makeMutationHandler } from "./handler.js";
+export { MiraError } from "./errors.js";
+export { buildFileUrl } from "./file.js";
+export { makeCollectionClient } from "./collection.js";
+//# sourceMappingURL=index.js.map

package/dist/src/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAIvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}