@gettersethya/mira-client 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Getter Sethya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,66 @@
+import type { HttpClient } from "@effect/platform";
+import { Effect, MutableRef } from "effect";
+import type { MiraError } from "./errors.js";
+import type { ClientHandler, ExecuteFn } from "./handler.js";
+/**
+ * Browser-side authentication helper. Uses a `loggedInRef` to track whether
+ * the client has authenticated.
+ *
+ * In browser mode, the JWT token is handled via cookies — the client only
+ * tracks `isLoggedIn()` state. `clear()` sends a POST to `/api/auth/logout`
+ * and resets the ref.
+ *
+ * @example
+ * import { createMiraClient } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("/")  // browser mode by default
+ * if (mira.auth.isLoggedIn()) {
+ *   // user is authenticated
+ * }
+ * mira.auth.clear()  // sends POST /api/auth/logout
+ *
+ * @see ServerAuth — server-side alternative for SSR environments
+ */
+export type BrowserAuth = {
+    isLoggedIn(): boolean;
+    clear(): void;
+};
+/**
+ * Server-side authentication helper. Stores the JWT token in a `MutableRef`
+ * for manual management (e.g., during SSR hydration).
+ *
+ * The `token` getter/setter provides direct access to the raw JWT string.
+ * `isValid()` checks the JWT `exp` claim against the current time without
+ * making an HTTP request — it only validates expiry, not signature.
+ *
+ * @example
+ * import { createMiraClient } from "@gettersethya/mira-client"
+ *
+ * const mira = createMiraClient("/", { type: "server" })
+ * mira.auth.setToken("eyJ...")  // set token from SSR context
+ * console.log(mira.auth.isValid())  // true if token is not expired
+ * const currentToken = mira.auth.token  // "eyJ..."
+ * mira.auth.clear()  // clears token and file token cache
+ *
+ * @see BrowserAuth — browser-side alternative
+ */
+export type ServerAuth = {
+    token: string | null;
+    setToken(token: string): void;
+    clear(): void;
+    isValid(): boolean;
+};
+/**
+ * Factory function for `BrowserAuth`. Called internally by `createMiraClient` in browser mode.
+ * @internal Use `createMiraClient()` instead of calling this directly
+ */
+export declare function makeBrowserAuth(execute: ExecuteFn, makeClientHandler: <T>(effect: Effect.Effect<T, MiraError, HttpClient.HttpClient>) => ClientHandler<T>, loggedInRef: MutableRef.MutableRef<boolean>): BrowserAuth;
+/**
+ * Factory function for `ServerAuth`. Called internally by `createMiraClient` in server mode.
+ * @internal Use `createMiraClient("/", { type: "server" })` instead of calling this directly
+ */
+export declare function makeServerAuth(authTokenRef: MutableRef.MutableRef<string | null>, fileTokenCacheRef: MutableRef.MutableRef<Map<string, {
+    token: string;
+    expiresAt: number;
+}>>): ServerAuth;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/client/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,IAAI,OAAO,CAAA;IACrB,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,IAAI,IAAI,CAAA;IACb,OAAO,IAAI,OAAO,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,EAClB,iBAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,EACtG,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,GAC1C,WAAW,CAWb;AAcD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,EAClD,iBAAiB,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAC1F,UAAU,CAoBZ"}

package/dist/src/client/auth.js

@@ -0,0 +1,60 @@
+import { HttpClientRequest as HCR } from "@effect/platform";
+import { Effect, MutableRef } from "effect";
+/**
+ * Factory function for `BrowserAuth`. Called internally by `createMiraClient` in browser mode.
+ * @internal Use `createMiraClient()` instead of calling this directly
+ */
+export function makeBrowserAuth(execute, makeClientHandler, loggedInRef) {
+    return {
+        isLoggedIn: () => MutableRef.get(loggedInRef),
+        clear: () => {
+            const effect = Effect.gen(function* () {
+                yield* execute(HCR.post("/api/auth/logout"));
+                MutableRef.set(loggedInRef, false);
+            });
+            void makeClientHandler(effect).raw();
+        },
+    };
+}
+function decodeJwtExp(token) {
+    try {
+        const parts = token.split(".");
+        if (parts.length !== 3)
+            return null;
+        const payload = JSON.parse(globalThis.atob(parts[1].replace(/-/g, "+").replace(/_/g, "/")));
+        if (typeof payload.exp === "number")
+            return payload.exp;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Factory function for `ServerAuth`. Called internally by `createMiraClient` in server mode.
+ * @internal Use `createMiraClient("/", { type: "server" })` instead of calling this directly
+ */
+export function makeServerAuth(authTokenRef, fileTokenCacheRef) {
+    return {
+        get token() {
+            return MutableRef.get(authTokenRef);
+        },
+        setToken(token) {
+            MutableRef.set(authTokenRef, token);
+        },
+        clear: () => {
+            MutableRef.set(authTokenRef, null);
+            MutableRef.set(fileTokenCacheRef, new Map());
+        },
+        isValid: () => {
+            const token = MutableRef.get(authTokenRef);
+            if (token === null)
+                return false;
+            const exp = decodeJwtExp(token);
+            if (exp === null)
+                return false;
+            return Date.now() < exp * 1000;
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/client/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAsD3C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAkB,EAClB,iBAAsG,EACtG,WAA2C;IAE3C,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;QAC7C,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACjC,KAAK,CAAC,CAAC,OAAO,CAAO,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAA;gBAClD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;YACpC,CAAC,CAAC,CAAA;YACF,KAAK,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC3F,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,GAAG,CAAA;QACvD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAkD,EAClD,iBAA2F;IAE3F,OAAO;QACL,IAAI,KAAK;YACP,OAAO,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QACrC,CAAC;QACD,QAAQ,CAAC,KAAa;YACpB,UAAU,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;QACD,KAAK,EAAE,GAAS,EAAE;YAChB,UAAU,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;YAClC,UAAU,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QAC9C,CAAC;QACD,OAAO,EAAE,GAAY,EAAE;YACrB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YAC1C,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAA;YAChC,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;YAC/B,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAA;YAC9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,239 @@
+import { MutableRef, Option, Schedule } from "effect";
+import type { AnyCollectionDef, FieldsMap, InferFieldValue, FilterNode, FieldFilterOperand } from "@gettersethya/mira-collection";
+import { MiraError } from "./errors.js";
+import type { ClientHandler, ExecuteFn } from "./handler.js";
+import type { CollectionFileFields, InferMutationInput, InferRecord, RelationKeys, WithExpand } from "./types.js";
+/**
+ * Optional retry configuration for collection operations.
+ * Wraps an Effect `Schedule` that determines retry behavior when a `MiraError` occurs.
+ *
+ * If not provided, the operation is not retried. Set at the collection level via
+ * `defaultRetryOptions` in `createMiraClient()` or per-call via the `retryOptions` parameter.
+ *
+ * @example
+ * import { Schedule } from "effect"
+ *
+ * const retry: RetryOptions = {
+ *   schedule: Schedule.exponential(100)  // retry with exponential backoff starting at 100ms
+ * }
+ *
+ * @see createMiraClient — accepts defaultRetryOptions
+ * @see CollectionClient — each method accepts retryOptions
+ */
+export type RetryOptions = {
+    schedule?: Schedule.Schedule<unknown, MiraError, never>;
+};
+type GetListOptions<F extends FieldsMap, E extends ReadonlyArray<string>> = {
+    filter?: (f: FilterBuilder<F>) => FilterNode;
+    sort?: keyof F & string;
+    order?: "asc" | "desc";
+    cursor?: number | null;
+    limit?: number;
+    select?: ReadonlyArray<keyof F & string>;
+    expand?: E;
+    retryOptions?: RetryOptions;
+};
+type GetOneOptions<F extends FieldsMap, E extends ReadonlyArray<string>> = {
+    select?: ReadonlyArray<keyof F & string>;
+    expand?: E;
+    retryOptions?: RetryOptions;
+};
+/**
+ * Typed filter builder used inside `CollectionClient` callback methods.
+ * Same shape as `FilterBuilder<F>` in `filter/builder.ts` but re-exported
+ * from the client module for convenience.
+ *
+ * @example
+ * const posts = await mira.posts.getList({
+ *   filter: (f) => f.and(
+ *     f.field("published").eq(true),
+ *     f.field("views").gte(100)
+ *   )
+ * }).raw()
+ *
+ * @see CollectionClient.getList — accepts filter callback
+ * @see Filter — untyped filter builder
+ */
+export type FilterBuilder<F extends FieldsMap> = {
+    field<K extends keyof F & string>(name: K): FieldFilterOperand<InferFieldValue<F[K]>>;
+    and(left: FilterNode, right: FilterNode): FilterNode;
+    or(left: FilterNode, right: FilterNode): FilterNode;
+    not(node: FilterNode): FilterNode;
+};
+/**
+ * Client interface for a single collection, providing typed CRUD operations.
+ * Created via `makeCollectionClient()` or automatically via `createMiraClient()`.
+ *
+ * All query methods return `ClientHandler` — call `.raw()` for Promise-based usage
+ * or `.toEffect()` for Effect-based usage.
+ * All mutation methods return a mutation `ClientHandler` — call `.raw(input)` with
+ * the data payload.
+ *
+ * @typeParam F - The FieldsMap type of the collection
+ *
+ * @example
+ * const posts = mira.posts  // inferred as CollectionClient<PostFields>
+ * const list = await posts.getList({ sort: "created", order: "desc" }).raw()
+ * const one = await posts.getOne("abc123").raw()
+ * const created = await posts.create().raw({ title: "hello", body: "world" })
+ *
+ * @see makeCollectionClient — constructs CollectionClient instances
+ * @see ClientHandler — return type of all methods
+ */
+export type CollectionClient<F extends FieldsMap> = {
+    /**
+     * List records with optional filtering, sorting, cursor pagination, and field selection.
+     *
+     * Returns `{ items, nextCursor }` where `nextCursor` is `null` when there are
+     * no more pages. Pagination is cursor-based — iterate by passing the previous
+     * response's `nextCursor` as the `cursor` option.
+     *
+     * @example
+     * let cursor: number | null = null
+     * do {
+     *   const { items, nextCursor } = await posts.getList({ cursor, limit: 20 }).raw()
+     *   cursor = nextCursor
+     * } while (cursor !== null)
+     *
+     * @param options.filter - Optional filter callback using the typed FilterBuilder
+     * @param options.sort - Field name to sort by
+     * @param options.order - Sort direction: "asc" or "desc" (default: "asc")
+     * @param options.cursor - Cursor for pagination (from previous response's nextCursor)
+     * @param options.limit - Maximum items per page (server default applies if omitted)
+     * @param options.select - Subset of field names to include in the response
+     * @param options.expand - Relation field names to expand (fetches related records)
+     * @param options.retryOptions - Optional retry schedule
+     * @returns ClientHandler for the paginated result
+     */
+    getList<E extends ReadonlyArray<RelationKeys<F>> = []>(options?: GetListOptions<F, E>): ClientHandler<{
+        items: WithExpand<F, E>[];
+        nextCursor: number | null;
+    }>;
+    /**
+     * Get the first record matching a filter, or `Option.none()` if none match.
+     *
+     * **Requires a `filter` callback** — unlike `getList`, the filter is mandatory.
+     * Internally calls `getList` with `limit: 1` and extracts the first item.
+     *
+     * @param filter - Filter callback (required) — use `(f) => f.field("id").eq("x")` etc.
+     * @param options.sort - Field name to sort by (determines which is "first")
+     * @param options.order - Sort direction
+     * @param options.select - Subset of field names to include
+     * @param options.expand - Relation field names to expand
+     * @param options.retryOptions - Optional retry schedule
+     * @returns ClientHandler resolving to Option of the record (None if no match)
+     */
+    getFirstOrNone<E extends ReadonlyArray<RelationKeys<F>> = []>(filter: (f: FilterBuilder<F>) => FilterNode, options?: Omit<GetListOptions<F, E>, "filter" | "limit" | "cursor">): ClientHandler<Option.Option<WithExpand<F, E>>>;
+    /**
+     * Fetch all records matching the filter, automatically following pagination.
+     * Defaults to `limit: 1000` — override via options if you need a different page size.
+     *
+     * Unlike `getList` which returns a single page with `nextCursor`,
+     * `getFullList` fetches pages internally and returns a flat array.
+     *
+     * @param options.filter - Optional filter callback
+     * @param options.sort - Field name to sort by
+     * @param options.order - Sort direction
+     * @param options.limit - Page size for internal pagination (default: 1000)
+     * @param options.select - Subset of field names to include
+     * @param options.expand - Relation field names to expand
+     * @param options.retryOptions - Optional retry schedule
+     * @returns ClientHandler resolving to a flat array of records
+     */
+    getFullList<E extends ReadonlyArray<RelationKeys<F>> = []>(options?: Omit<GetListOptions<F, E>, "limit" | "cursor"> & {
+        limit?: number;
+    }): ClientHandler<WithExpand<F, E>[]>;
+    /**
+     * Get a single record by its `id`.
+     * Returns a 404 `MiraError` if the record does not exist.
+     *
+     * @param id - The record ID (string UUID)
+     * @param options.select - Subset of field names to include
+     * @param options.expand - Relation field names to expand
+     * @param options.retryOptions - Optional retry schedule
+     * @returns ClientHandler resolving to the record
+     */
+    getOne<E extends ReadonlyArray<RelationKeys<F>> = []>(id: string, options?: GetOneOptions<F, E>): ClientHandler<WithExpand<F, E>>;
+    /**
+     * Create a new record.
+     *
+     * When the input contains any `File` or `Blob` values (for file fields), the
+     * request is automatically dispatched as `multipart/form-data` instead of JSON.
+     *
+     * @returns A mutation ClientHandler — call `.raw(input)` with the record data
+     */
+    create(): ClientHandler<InferRecord<F>, InferMutationInput<F>>;
+    /**
+     * Update an existing record by ID.
+     * Only the fields present in `data` are updated (partial/patch semantics).
+     *
+     * When `data` contains any `File` or `Blob` values, the request is automatically
+     * dispatched as `multipart/form-data`.
+     *
+     * @returns A mutation ClientHandler — call `.raw({ id, data })`
+     */
+    update(): ClientHandler<InferRecord<F>, {
+        id: string;
+        data: Partial<InferMutationInput<F>>;
+    }>;
+    /**
+     * Delete a record by ID.
+     * Returns `void` on success. Throws `MiraError` (404) if the record does not exist.
+     *
+     * @returns A mutation ClientHandler — call `.raw(id)` with the record ID
+     */
+    delete(): ClientHandler<void, string>;
+    /**
+     * Authenticate with email and password on an auth collection.
+     * Only available on collections defined with `AuthCollection.define()`.
+     * On success, stores the returned JWT token for subsequent requests.
+     *
+     * @example
+     * const { token, record } = await mira.users.authWithPassword().raw({
+     *   email: "user@example.com",
+     *   password: "secret123"
+     * })
+     *
+     * @returns A mutation ClientHandler — call `.raw({ email, password })`
+     */
+    authWithPassword?(): ClientHandler<{
+        token: string;
+        record: InferRecord<F>;
+    }, {
+        email: string;
+        password: string;
+    }>;
+    /**
+     * File field client interfaces for the collection.
+     * Provides `.url()` and `.asyncUrl()` methods for constructing file download URLs.
+     *
+     * @example
+     * const url = posts.fields.cover.url(post.id, "cover.jpg")
+     */
+    fields: CollectionFileFields<F>;
+};
+type MakeCollectionClientParams<F extends FieldsMap> = {
+    collectionName: string;
+    schema: AnyCollectionDef["schema"];
+    fields: F;
+    execute: ExecuteFn;
+    baseUrl: string;
+    authTokenRef: MutableRef.MutableRef<string | null> | null;
+    loggedInRef: MutableRef.MutableRef<boolean> | null;
+    fileTokenCacheRef: MutableRef.MutableRef<Map<string, {
+        token: string;
+        expiresAt: number;
+    }>>;
+    isAuth: boolean;
+    defaultRetryOptions?: RetryOptions;
+};
+/**
+ * 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 declare function makeCollectionClient<F extends FieldsMap>(params: MakeCollectionClientParams<F>): CollectionClient<F>;
+export {};
+//# sourceMappingURL=collection.d.ts.map

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

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

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