@gettersethya/mira-client 0.1.0-alpha.10

package/dist/src/client/collection.js

@@ -0,0 +1,137 @@
+import { HttpClientRequest as HCR } from "@effect/platform";
+import { Effect, MutableRef, Option, Schema } from "effect";
+import { Filter, FilterNodeSchema } from "@gettersethya/mira-collection";
+import { MiraError } from "./errors.js";
+import { makeClientHandler as makeHandler, makeMutationHandler } from "./handler.js";
+import { makeFileFields } from "./file.js";
+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) }))));
+}
+function hasFileOrBlob(input) {
+    return Object.values(input).some((v) => v instanceof Blob);
+}
+function buildFormData(input) {
+    const fd = new FormData();
+    for (const [key, value] of Object.entries(input)) {
+        if (value instanceof Blob) {
+            fd.append(key, value);
+        }
+        else if (value !== null && value !== undefined) {
+            fd.append(key, String(value));
+        }
+    }
+    return fd;
+}
+function makeFilterBuilder() {
+    return {
+        field: (name) => Filter.field(name),
+        and: (left, right) => Filter.and(left, right),
+        or: (left, right) => Filter.or(left, right),
+        not: (node) => Filter.not(node),
+    };
+}
+function buildQueryParams(params) {
+    const sp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            sp.set(k, v);
+    }
+    const qs = sp.toString();
+    return qs ? `?${qs}` : "";
+}
+/**
+ * Construct a `CollectionClient<F>` for a given collection definition.
+ * This is the internal factory — users should use `createMiraClient()` which
+ * handles all wiring (auth, execute, file fields).
+ *
+ * @internal Use `createMiraClient().collection(def)` or `withCollections()` instead.
+ */
+export function makeCollectionClient(params) {
+    const { collectionName, schema, fields, execute, baseUrl, authTokenRef, loggedInRef, fileTokenCacheRef, isAuth, defaultRetryOptions } = params;
+    function withRetry(effect, methodOptions) {
+        const schedule = methodOptions?.retryOptions?.schedule ?? defaultRetryOptions?.schedule;
+        return schedule ? Effect.retry(effect, schedule) : effect;
+    }
+    const fileFields = makeFileFields({ name: collectionName, fields, schema }, schema, baseUrl, execute, fileTokenCacheRef, makeHandler);
+    function getList(options) {
+        const filterNode = options?.filter?.(makeFilterBuilder());
+        const queryParams = buildQueryParams({
+            ...(filterNode ? { filter: Schema.encodeSync(Schema.parseJson(FilterNodeSchema))(filterNode) } : {}),
+            ...(options?.sort ? { sort: options.sort } : {}),
+            ...(options?.order ? { order: options.order } : {}),
+            ...(options?.cursor != null ? { after: String(options.cursor) } : {}),
+            ...(options?.limit ? { limit: String(options.limit) } : {}),
+            ...(options?.select ? { select: options.select.join(",") } : {}),
+            ...(options?.expand ? { expand: options.expand.join(",") } : {}),
+        });
+        const effect = execute(HCR.get(`/api/collections/${collectionName}${queryParams}`));
+        return makeHandler(withRetry(effect, options));
+    }
+    function getFirstOrNone(filter, options) {
+        const effect = getList({ ...options, filter, limit: 1 })
+            .toEffect()
+            .pipe(Effect.map(({ items }) => Option.fromNullable(items[0] ?? null)));
+        return makeHandler(effect);
+    }
+    function getFullList(options) {
+        const effect = getList({ ...options, limit: options?.limit ?? 1000 })
+            .toEffect()
+            .pipe(Effect.map(({ items }) => items));
+        return makeHandler(effect);
+    }
+    function getOne(id, options) {
+        const queryParams = buildQueryParams({
+            ...(options?.select ? { select: options.select.join(",") } : {}),
+            ...(options?.expand ? { expand: options.expand.join(",") } : {}),
+        });
+        const effect = execute(HCR.get(`/api/collections/${collectionName}/${id}${queryParams}`));
+        return makeHandler(withRetry(effect, options));
+    }
+    function create() {
+        return makeMutationHandler((input) => {
+            const reqEffect = hasFileOrBlob(input)
+                ? Effect.succeed(HCR.bodyFormData(HCR.post(`/api/collections/${collectionName}`), buildFormData(input)))
+                : HCR.bodyJson(HCR.post(`/api/collections/${collectionName}`), input);
+            return withRetry(toExecuteEffect(reqEffect, execute));
+        });
+    }
+    function update() {
+        return makeMutationHandler(({ id, data }) => {
+            const reqEffect = hasFileOrBlob(data)
+                ? Effect.succeed(HCR.bodyFormData(HCR.patch(`/api/collections/${collectionName}/${id}`), buildFormData(data)))
+                : HCR.bodyJson(HCR.patch(`/api/collections/${collectionName}/${id}`), data);
+            return withRetry(toExecuteEffect(reqEffect, execute));
+        });
+    }
+    function deleteFn() {
+        return makeMutationHandler((id) => {
+            const effect = execute(HCR.del(`/api/collections/${collectionName}/${id}`));
+            return withRetry(effect);
+        });
+    }
+    function authWithPassword() {
+        return makeMutationHandler(({ email, password }) => withRetry(Effect.gen(function* () {
+            const res = yield* toExecuteEffect(HCR.bodyJson(HCR.post(`/api/collections/${collectionName}/auth-with-password`), { email, password }), execute);
+            if (authTokenRef !== null) {
+                MutableRef.set(authTokenRef, res.token);
+            }
+            if (loggedInRef !== null) {
+                MutableRef.set(loggedInRef, true);
+            }
+            return res;
+        })));
+    }
+    const client = {
+        getList,
+        getFirstOrNone,
+        getFullList,
+        getOne,
+        create,
+        update,
+        delete: deleteFn,
+        ...(isAuth ? { authWithPassword } : {}),
+        fields: fileFields,
+    };
+    return client;
+}
+//# sourceMappingURL=collection.js.map

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

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

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

@@ -0,0 +1,46 @@
+declare const MiraError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "MiraError";
+} & Readonly<A>;
+/**
+ * Error thrown by `ClientHandler.raw()` when an HTTP request to the Mira server fails.
+ *
+ * Wraps the HTTP status code and response body. The `status` field corresponds to
+ * the HTTP status code (e.g., 404, 403, 422, 0 for network errors). The `body`
+ * field contains the server's JSON error response (typically `{ error, message, issues }`).
+ *
+ * `MiraError` is thrown **directly** from `.raw()` — it is NOT wrapped in `FiberFailure`.
+ * In the Effect channel (`toEffect()`), it is available in the error channel and can
+ * be caught via `Effect.catchTag("MiraError", ...)`.
+ *
+ * @example
+ * import { createMiraClient, MiraError } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("/")
+ *
+ * try {
+ *   await mira.posts.getOne("nonexistent").raw()
+ * } catch (e) {
+ *   if (e instanceof MiraError) {
+ *     console.error(`HTTP ${e.status}:`, e.body)
+ *   }
+ * }
+ *
+ * @example
+ * // In Effect context via toEffect()
+ * import { Effect } from "effect"
+ *
+ * mira.posts.getOne("nonexistent").toEffect().pipe(
+ *   Effect.catchTag("MiraError", (e) =>
+ *     Effect.logError(`HTTP ${e.status}: ${JSON.stringify(e.body)}`)
+ *   )
+ * )
+ *
+ * @see ClientHandler — the interface that throws MiraError from .raw()
+ */
+export declare class MiraError extends MiraError_base<{
+    readonly status: number;
+    readonly body: unknown;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/client/errors.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,SAAU,SAAQ,eAA8B;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB,CAAC;CAAG"}

package/dist/src/client/errors.js

@@ -0,0 +1,40 @@
+import { Data } from "effect";
+/**
+ * Error thrown by `ClientHandler.raw()` when an HTTP request to the Mira server fails.
+ *
+ * Wraps the HTTP status code and response body. The `status` field corresponds to
+ * the HTTP status code (e.g., 404, 403, 422, 0 for network errors). The `body`
+ * field contains the server's JSON error response (typically `{ error, message, issues }`).
+ *
+ * `MiraError` is thrown **directly** from `.raw()` — it is NOT wrapped in `FiberFailure`.
+ * In the Effect channel (`toEffect()`), it is available in the error channel and can
+ * be caught via `Effect.catchTag("MiraError", ...)`.
+ *
+ * @example
+ * import { createMiraClient, MiraError } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("/")
+ *
+ * try {
+ *   await mira.posts.getOne("nonexistent").raw()
+ * } catch (e) {
+ *   if (e instanceof MiraError) {
+ *     console.error(`HTTP ${e.status}:`, e.body)
+ *   }
+ * }
+ *
+ * @example
+ * // In Effect context via toEffect()
+ * import { Effect } from "effect"
+ *
+ * mira.posts.getOne("nonexistent").toEffect().pipe(
+ *   Effect.catchTag("MiraError", (e) =>
+ *     Effect.logError(`HTTP ${e.status}: ${JSON.stringify(e.body)}`)
+ *   )
+ * )
+ *
+ * @see ClientHandler — the interface that throws MiraError from .raw()
+ */
+export class MiraError extends Data.TaggedError("MiraError") {
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/client/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,OAAO,SAAU,SAAQ,IAAI,CAAC,WAAW,CAAC,WAAW,CAGzD;CAAG"}

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

@@ -0,0 +1,78 @@
+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";
+import type { TelemetryClient } from "./telemetry.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;
+    telemetry: TelemetryClient;
+    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;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD,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,SAAS,EAAE,eAAe,CAAA;IAC1B,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;AAyG9C;;;;;;;;;;;;;;;;;;;;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,108 @@
+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";
+import { makeTelemetryClient } from "./telemetry.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(),
+            telemetry: makeTelemetryClient(execute),
+            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":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAGvE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAG3C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAiCpD,SAAS,cAAc,CACrB,MAA4F;IAE5F,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,SAAS,CAAC;QACf,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAChG,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KACnF,CAAC,CACH,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,YAAyD;IAC/F,OAAO,CAAI,GAA0B,EAAE,EAAE;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;YACzC,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAEhE,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YAE9G,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACzC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAA;gBAC5B,OAAO,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3D,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,OAAO,SAAc,CAAA;YACvB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAM,CAAA;QAC/B,CAAC,CAAC,CAAA;QACF,OAAO,cAAc,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC,CAAA;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAAO,GAAG,GAAG,EACb,OAA6B,SAAS,EACtC,mBAAkC;IAElC,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,EAAgD,CAAC,CAAA;IAElG,MAAM,YAAY,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEpF,MAAM,WAAW,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAEtE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IAEpD,MAAM,iBAAiB,GAAG,CAAI,MAA0D,EAAoB,EAAE,CAC5G,WAAW,CAAC,MAAM,CAAC,CAAA;IAErB,SAAS,qBAAqB,CAA6B,GAAM;QAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAA;QACzD,OAAO,oBAAoB,CAAC;YAC1B,cAAc,EAAE,GAAG,CAAC,IAAI;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO;YACP,OAAO;YACP,YAAY;YACZ,WAAW;YACX,iBAAiB;YACjB,MAAM;YACN,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC,CAAA;IACJ,CAAC;IAED,SAAS,QAAQ;QACf,IAAI,IAAI,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,cAAc,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAA;QACjE,CAAC;QACD,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5E,CAAC;IAED,SAAS,eAAe,CACtB,GAAM,EACN,IAAsC;QAEtC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAA;QACpC,MAAM,WAAW,GAAG,EAA4B,CAAA;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAmB,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3C,WAAW,CAAC,GAAG,CAAC,GAAG,CACjB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAClB,CAAA;QACtC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IAC/C,CAAC;IAED,SAAS,eAAe;QACtB,OAAO;YACL,UAAU,EAAE,CAA6B,GAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC;YAC9E,IAAI,EAAE,QAAQ,EAAE;YAChB,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC;YACvC,eAAe;SAChB,CAAA;IACH,CAAC;IAED,OAAO,eAAe,EAAE,CAAA;AAC1B,CAAC;AAoDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAO,GAAG,GAAG,EACb,OAA4E,EAAE;IAE9E,MAAM,EAAE,IAAI,GAAG,SAAS,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAA;IACtD,OAAO,wBAAwB,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAyC,CAAA;AAC7G,CAAC"}

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"}