@gettersethya/mira-client 0.1.0-alpha.10

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,13 @@
+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";
+export { makeTelemetryClient } from "./telemetry.js";
+export type { TelemetryClient } from "./telemetry.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;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/client/index.js

@@ -0,0 +1,7 @@
+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";
+export { makeTelemetryClient } from "./telemetry.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;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,50 @@
+import type { FilterNode } from "@gettersethya/mira-collection";
+import type { ClientHandler, ExecuteFn } from "./handler.js";
+type LogEntry = {
+    id: number;
+    level: string;
+    message: string;
+    timestamp: string;
+    traceId: string | null;
+    spanId: string | null;
+};
+type SpanEntry = {
+    id: number;
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentSpanId: string | null;
+    kind: string;
+    durationMs: number;
+    status: "ok" | "error";
+    error: string | null;
+    attributes: Record<string, string | number | boolean>;
+    timestamp: string;
+};
+type LogsResponse = {
+    logs: Array<LogEntry>;
+    total: number;
+    limit: number;
+    offset: number;
+};
+type SpansResponse = {
+    spans: Array<SpanEntry>;
+    total: number;
+    limit: number;
+    offset: number;
+};
+export type TelemetryClient = {
+    getLogs(opts?: {
+        limit?: number;
+        offset?: number;
+        filter?: FilterNode;
+    }): ClientHandler<LogsResponse>;
+    getSpans(opts?: {
+        limit?: number;
+        offset?: number;
+        traceId?: string;
+    }): ClientHandler<SpansResponse>;
+};
+export declare function makeTelemetryClient(execute: ExecuteFn): TelemetryClient;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/client/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAG5D,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAED,KAAK,SAAS,GAAG;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACrD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,IAAI,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,UAAU,CAAA;KACpB,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;IAE/B,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,GAAG,aAAa,CAAC,aAAa,CAAC,CAAA;CACjC,CAAA;AAWD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,eAAe,CAoBvE"}

package/dist/src/client/telemetry.js

@@ -0,0 +1,32 @@
+import { HttpClientRequest as HCR } from "@effect/platform";
+import { makeClientHandler } from "./handler.js";
+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}` : "";
+}
+export function makeTelemetryClient(execute) {
+    return {
+        getLogs: (opts) => {
+            const qs = buildQueryParams({
+                limit: opts?.limit !== undefined ? String(opts.limit) : undefined,
+                offset: opts?.offset !== undefined ? String(opts.offset) : undefined,
+                filter: opts?.filter !== undefined ? JSON.stringify(opts.filter) : undefined,
+            });
+            return makeClientHandler(execute(HCR.get(`/api/_telemetry/logs${qs}`)));
+        },
+        getSpans: (opts) => {
+            const qs = buildQueryParams({
+                limit: opts?.limit !== undefined ? String(opts.limit) : undefined,
+                offset: opts?.offset !== undefined ? String(opts.offset) : undefined,
+                traceId: opts?.traceId,
+            });
+            return makeClientHandler(execute(HCR.get(`/api/_telemetry/spans${qs}`)));
+        },
+    };
+}
+//# sourceMappingURL=telemetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/client/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAG3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAqDhD,SAAS,gBAAgB,CAAC,MAA0C;IAClE,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IACxB,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAkB;IACpD,OAAO;QACL,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,GAAG,gBAAgB,CAAC;gBAC1B,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBACjE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;aAC7E,CAAC,CAAA;YACF,OAAO,iBAAiB,CAAC,OAAO,CAAe,GAAG,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QACvF,CAAC;QAED,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,EAAE,GAAG,gBAAgB,CAAC;gBAC1B,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;gBACjE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,IAAI,EAAE,OAAO;aACvB,CAAC,CAAA;YACF,OAAO,iBAAiB,CAAC,OAAO,CAAgB,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QACzF,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,137 @@
+import type { AnyCollectionDef, FieldDef, FieldsMap, InferFieldValue } from "@gettersethya/mira-collection";
+import type { ProtectedFileFieldClient, PublicFileFieldClient } from "./file.js";
+/** Resolves the mutation value type for a field: File | Blob for file fields, InferFieldValue for everything else. */
+type MutationFieldValue<F extends FieldDef> = F["kind"] extends "file" ? File | Blob : InferFieldValue<F>;
+/**
+ * The input type for creating/updating records when file uploads are involved.
+ * Same structure as `InferCreateInput` but file fields accept `File | Blob`
+ * instead of the server-returned URL string.
+ *
+ * When the input contains any `Blob` values, the client SDK automatically
+ * dispatches a `multipart/form-data` request instead of JSON.
+ *
+ * @example
+ * // For a collection with { avatar: Field.file() }
+ * // InferMutationInput resolves avatar to: File | Blob
+ *
+ * @see InferCreateInput — create input without file upload support
+ * @see InferRecord — the corresponding output type
+ */
+export type InferMutationInput<F extends FieldsMap> = {
+    [K in keyof F as F[K]["kind"] extends "seqId" ? never : F[K]["viewOnly"] extends true ? never : F[K]["required"] extends false ? K : never]?: MutationFieldValue<F[K]> | null;
+} & {
+    [K in keyof F as F[K]["kind"] extends "seqId" ? never : F[K]["viewOnly"] extends true ? never : F[K]["required"] extends false ? never : K]: MutationFieldValue<F[K]>;
+};
+/**
+ * The full record type returned from the server for a collection.
+ * Includes the system-managed `id`, `created`, and `updated` fields plus all
+ * user-defined fields with their correct TypeScript types.
+ *
+ * Optional fields (`required: false`) are typed as `T | null`.
+ *
+ * @example
+ * interface Post { title: Field.text(); body: Field.text({ required: false }) }
+ * // InferRecord<Post> resolves to:
+ * // { id: string; created: string; updated: string } & {
+ * //   title: string;
+ * //   body: string | null;
+ * // }
+ *
+ * @see InferCreateInput — input type for creating records
+ * @see InferMutationInput — mutation input type (file fields use File | Blob)
+ */
+export type InferRecord<F extends FieldsMap> = {
+    id: string;
+    created: string;
+    updated: string;
+} & {
+    [K in keyof F as F[K]["kind"] extends "seqId" ? never : K]: F[K]["required"] extends false ? InferFieldValue<F[K]> | null : InferFieldValue<F[K]>;
+};
+/**
+ * The input type for creating a new record.
+ * Excludes system-managed fields (`seqId`) and view-only fields.
+ * Optional fields (`required: false`) are typed as `T | null` and are
+ * themselves optional (`K?`)
+ *
+ * @example
+ * // InferCreateInput<Post> resolves to:
+ * // { title: string; body?: string | null }
+ *
+ * @see InferRecord — the corresponding output type
+ * @see InferMutationInput — mutation variant that uses File | Blob for file fields
+ */
+export type InferCreateInput<F extends FieldsMap> = {
+    [K in keyof F as F[K]["kind"] extends "seqId" ? never : F[K]["viewOnly"] extends true ? never : F[K]["required"] extends false ? K : never]?: InferFieldValue<F[K]> | null;
+} & {
+    [K in keyof F as F[K]["kind"] extends "seqId" ? never : F[K]["viewOnly"] extends true ? never : F[K]["required"] extends false ? never : K]: InferFieldValue<F[K]>;
+};
+/**
+ * Extracts the field names of type `relation` from a FieldsMap.
+ * Used to constrain the `expand` option in collection queries.
+ *
+ * @example
+ * // For { author: Field.relation(Users), title: Field.text() }
+ * // RelationKeys resolves to: "author"
+ *
+ * @see WithExpand — uses RelationKeys to type the expand parameter
+ */
+export type RelationKeys<F extends FieldsMap> = {
+    [K in keyof F]: F[K]["kind"] extends "relation" ? K : never;
+}[keyof F] & string;
+/**
+ * Extracts the field names of type `file` from a FieldsMap.
+ *
+ * @example
+ * // For { avatar: Field.file(), name: Field.text() }
+ * // FileKeys resolves to: "avatar"
+ *
+ * @see CollectionFileFields — maps file fields to their client interfaces
+ */
+export type FileKeys<F extends FieldsMap> = {
+    [K in keyof F]: F[K]["kind"] extends "file" ? K : never;
+}[keyof F] & string;
+/**
+ * Augments `InferRecord<F>` with an `expand` property containing the resolved
+ * related records for the requested relation field names.
+ *
+ * When `E` is an empty tuple (no expand requested), the result is just
+ * `InferRecord<F>` without the `expand` property.
+ *
+ * @example
+ * // WithExpand<PostFields, ["author"]> resolves to:
+ * // InferRecord<Post> & {
+ * //   expand: { author: InferRecord<UserFields> }
+ * // }
+ *
+ * @see InferRecord — the base record type
+ * @see RelationKeys — used to constrain E to relation fields
+ */
+export type WithExpand<F extends FieldsMap, E extends ReadonlyArray<string>> = InferRecord<F> & ([
+    E
+] extends [[]] ? {} : {
+    expand: {
+        [K in E[number] & RelationKeys<F>]: F[K] extends {
+            _target: infer Target extends AnyCollectionDef;
+        } ? InferRecord<Target["fields"]> : Record<string, unknown>;
+    };
+});
+/**
+ * Maps file-type fields in a FieldsMap to their corresponding client interfaces.
+ * Protected file fields get `ProtectedFileFieldClient`; public file fields get
+ * `PublicFileFieldClient`.
+ *
+ * @example
+ * // For { avatar: Field.file({ protected: true }), cover: Field.file() }
+ * // CollectionFileFields resolves to:
+ * // { avatar: ProtectedFileFieldClient; cover: PublicFileFieldClient }
+ *
+ * @see PublicFileFieldClient — synchronous URL builder
+ * @see ProtectedFileFieldClient — async URL builder with token acquisition
+ */
+export type CollectionFileFields<F extends FieldsMap> = {
+    [K in keyof F as F[K]["kind"] extends "file" ? K : never]: F[K] extends {
+        protected: true;
+    } ? ProtectedFileFieldClient : PublicFileFieldClient;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/src/collection/auth.d.ts

@@ -0,0 +1,79 @@
+import type { RuleBuilder } from "../rule/builder.js";
+import type { RuleMap } from "../rule/types.js";
+import type { OperandNode } from "../rule/types.js";
+import type { IndexBuilder, IndexEntry } from "./index-builder.js";
+import type { CollectionSchema, FieldDef, FieldsMap } from "./types.js";
+type AuthSystemField = "id" | "email" | "password" | "emailVerified" | "created" | "updated" | "seqId";
+type AuthRuleField = "id" | "email" | "emailVerified" | "created" | "updated" | "seqId";
+type AuthSystemFieldDefs = {
+    id: FieldDef & {
+        kind: "text";
+    };
+    email: FieldDef & {
+        kind: "email";
+    };
+    emailVerified: FieldDef & {
+        kind: "boolean";
+    };
+    created: FieldDef & {
+        kind: "date";
+    };
+    updated: FieldDef & {
+        kind: "date";
+    };
+    seqId: FieldDef & {
+        kind: "seqId";
+    };
+};
+/** Rule builder for auth collections — extends RuleBuilder with `selfId()`. */
+type AuthRuleBuilder<F extends FieldsMap> = RuleBuilder<F> & {
+    /** authId operand for this collection. Use instead of `Rule.authId(ThisCollection)` to avoid circular references. */
+    selfId(): OperandNode<any, string>;
+};
+type IndexCb<F extends FieldsMap> = (I: IndexBuilder<(keyof F & string) | AuthRuleField>) => Array<IndexEntry<(keyof F & string) | AuthRuleField>>;
+type RuleCb<F extends FieldsMap> = (R: AuthRuleBuilder<F & AuthSystemFieldDefs>) => RuleMap;
+/**
+ * Builder returned by `AuthCollection.define()`.
+ * Immediately satisfies `AnyCollectionDef` — no terminal `.build()` needed.
+ * Chain `.indexes()` and/or `.rules()` to add optional concerns.
+ * Each chained method returns a new builder; the original is unchanged.
+ */
+export type AuthCollectionBuilder<F extends FieldsMap> = {
+    name: string;
+    fields: F;
+    schema: CollectionSchema & {
+        "x-collection-kind": "auth";
+    };
+    /**
+     * Add collection-level indexes (in addition to the system email unique index
+     * and any field-level `unique`/`indexed` flags).
+     * Pass a callback to get a typed index builder with auto-completion over field names.
+     */
+    indexes(cb: IndexCb<F>): AuthCollectionBuilder<F>;
+    /**
+     * Add per-action access rules. No rule means deny all.
+     * The rule builder includes `.selfId()` as a shorthand for the authenticated user's id
+     * on this collection — use it instead of `Rule.authId(ThisCollection)` to avoid circular references.
+     */
+    rules(cb: RuleCb<F>): AuthCollectionBuilder<F>;
+};
+/**
+ * Defines an auth collection for user authentication.
+ * Includes system-managed fields: `id`, `email`, `password`, `emailVerified`, `created`, `updated`, `seqId`.
+ * Only `extraFields` are user-defined; system field names are forbidden in `extraFields`.
+ *
+ * @example
+ * const Users = AuthCollection.define("users", {
+ *   name: Field.text(),
+ *   avatar: Field.file({ maxSize: Bytes.fromMB(2) })
+ * })
+ * .rules((R) => ({
+ *   list: R.field("id").eq(R.selfId()),
+ *   create: R.public()
+ * }))
+ */
+export declare const AuthCollection: {
+    define<F extends FieldsMap & { [K in keyof F & AuthSystemField]?: never; }>(name: string, extraFields: F): AuthCollectionBuilder<F>;
+};
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/collection/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/collection/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAgC,MAAM,YAAY,CAAA;AAErG,KAAK,eAAe,GAAG,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AACtG,KAAK,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvF,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAa,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,KAAK,EAAU,QAAQ,GAAG;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;IAC3C,aAAa,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAA;IAC7C,OAAO,EAAQ,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,OAAO,EAAQ,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,KAAK,EAAU,QAAQ,GAAG;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CAC5C,CAAA;AAED,+EAA+E;AAC/E,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAC3D,qHAAqH;IACrH,MAAM,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAED,KAAK,OAAO,CAAC,CAAC,SAAS,SAAS,IAAI,CAClC,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,aAAa,CAAC,KAChD,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;AAE1D,KAAK,MAAM,CAAC,CAAC,SAAS,SAAS,IAAI,CACjC,CAAC,EAAE,eAAe,CAAC,CAAC,GAAG,mBAAmB,CAAC,KACxC,OAAO,CAAA;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,SAAS,IAAI;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;IACT,MAAM,EAAE,gBAAgB,GAAG;QAAE,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACjD;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;CAC/C,CAAA;AAqCD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc;WAClB,CAAC,SAAS,SAAS,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,KAAK,GAAE,QACjE,MAAM,eACC,CAAC,GACb,qBAAqB,CAAC,CAAC,CAAC;CAG5B,CAAA"}