@gettersethya/mira-client 0.1.0-alpha.2

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

@@ -0,0 +1,138 @@
+import type { AnyCollectionDef, FieldKindToType, FieldsMap } from "@gettersethya/mira-collection";
+import type { ProtectedFileFieldClient, PublicFileFieldClient } from "./file.js";
+type FieldKindToInputType = Omit<FieldKindToType, "file"> & {
+    file: File | Blob;
+};
+/**
+ * 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]?: FieldKindToInputType[F[K]["kind"]] | 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]: FieldKindToInputType[F[K]["kind"]];
+};
+/**
+ * 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 ? FieldKindToType[F[K]["kind"]] | null : FieldKindToType[F[K]["kind"]];
+};
+/**
+ * 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]?: FieldKindToType[F[K]["kind"]] | 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]: FieldKindToType[F[K]["kind"]];
+};
+/**
+ * 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"}

package/dist/src/collection/auth.js

@@ -0,0 +1,50 @@
+import { makeRuleBuilder } from "../rule/builder.js";
+import { Index } from "./index-builder.js";
+import { toJSONSchema } from "./serialize.js";
+const AUTH_SYSTEM_PROPERTIES = {
+    email: { type: "string", format: "email", "x-system": true },
+    password: { type: "string", "x-system": true, "x-hidden": true },
+    emailVerified: { type: "boolean", "x-system": true, default: false }
+};
+const AUTH_SYSTEM_INDEXES = [{ fields: ["email"], unique: true }];
+function makeAuthBuilder(name, extraFields, indexesCb, rulesCb) {
+    const indexes = indexesCb?.(Index);
+    const authRuleBuilder = {
+        ...makeRuleBuilder(),
+        selfId() { return { kind: "authId", collection: name }; }
+    };
+    const rules = rulesCb?.(authRuleBuilder);
+    const schema = toJSONSchema("auth", name, extraFields, {
+        indexes: [...AUTH_SYSTEM_INDEXES, ...(indexes ?? [])],
+        systemFields: AUTH_SYSTEM_PROPERTIES,
+        ...(rules !== undefined ? { rules } : {})
+    });
+    return {
+        name,
+        fields: extraFields,
+        schema,
+        indexes: (cb) => makeAuthBuilder(name, extraFields, cb, rulesCb),
+        rules: (cb) => makeAuthBuilder(name, extraFields, indexesCb, cb)
+    };
+}
+/**
+ * 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 const AuthCollection = {
+    define(name, extraFields) {
+        return makeAuthBuilder(name, extraFields);
+    }
+};
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/collection/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAInD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAqD7C,MAAM,sBAAsB,GAAuC;IACjE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAChE,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;CACrE,CAAA;AAED,MAAM,mBAAmB,GAAoB,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAElF,SAAS,eAAe,CACtB,IAAY,EACZ,WAAc,EACd,SAAsB,EACtB,OAAmB;IAGnB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,KAAyB,CAAC,CAAA;IACtD,MAAM,eAAe,GAA6C;QAChE,GAAG,eAAe,EAA2B;QAC7C,MAAM,KAA+B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA,CAAC,CAAC;KACnF,CAAA;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,eAAe,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;QACrD,OAAO,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrD,YAAY,EAAE,sBAAsB;QACpC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAA;IACF,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,WAAW;QACnB,MAAM;QACN,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC;QAChE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,CAAC;KACjE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,CACJ,IAAY,EACZ,WAAc;QAEd,OAAO,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC3C,CAAC;CACF,CAAA"}

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

@@ -0,0 +1,64 @@
+import type { RuleBuilder } from "../rule/builder.js";
+import type { RuleMap } from "../rule/types.js";
+import type { IndexBuilder, IndexEntry } from "./index-builder.js";
+import type { CollectionSchema, FieldDef, FieldsMap } from "./types.js";
+type BaseForbiddenField = "id" | "seqId";
+type BaseSystemField = "id" | "seqId" | "created" | "updated";
+type BaseSystemFieldDefs = {
+    id: FieldDef & {
+        kind: "text";
+    };
+    created: FieldDef & {
+        kind: "date";
+    };
+    updated: FieldDef & {
+        kind: "date";
+    };
+    seqId: FieldDef & {
+        kind: "seqId";
+    };
+};
+type IndexCb<F extends FieldsMap> = (I: IndexBuilder<(keyof F & string) | BaseSystemField>) => Array<IndexEntry<(keyof F & string) | BaseSystemField>>;
+type RuleCb<F extends FieldsMap> = (R: RuleBuilder<F & BaseSystemFieldDefs>) => RuleMap;
+/**
+ * Builder returned by `BaseCollection.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 BaseCollectionBuilder<F extends FieldsMap> = {
+    name: string;
+    fields: F;
+    schema: CollectionSchema;
+    /**
+     * Add collection-level indexes (in addition to field-level `unique`/`indexed` flags).
+     * Pass a callback to get a typed index builder with auto-completion over field names.
+     */
+    indexes(cb: IndexCb<F>): BaseCollectionBuilder<F>;
+    /**
+     * Add per-action access rules. No rule means deny all.
+     * Pass a callback to get a typed rule builder with auto-completion over field names.
+     */
+    rules(cb: RuleCb<F>): BaseCollectionBuilder<F>;
+};
+/**
+ * Defines a standard data collection.
+ * Base collections are the primary storage type with full CRUD support.
+ *
+ * @example
+ * const Tasks = BaseCollection.define("tasks", {
+ *   title: Field.text({ maxLength: 200 }),
+ *   completed: Field.boolean({ default: false }),
+ *   ownerId: Field.text()
+ * })
+ * .indexes((I) => [I.on("ownerId")])
+ * .rules((R) => ({
+ *   list: Rule.public(),
+ *   view: R.field("ownerId").eq(R.authId(Users))
+ * }))
+ */
+export declare const BaseCollection: {
+    define<F extends FieldsMap & { [K in keyof F & BaseForbiddenField]?: never; }>(name: string, fields: F): BaseCollectionBuilder<F>;
+};
+export {};
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/collection/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEvE,KAAK,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAA;AACxC,KAAK,eAAe,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAE7D,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAO,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,OAAO,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,OAAO,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,KAAK,EAAI,QAAQ,GAAG;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAA;CACtC,CAAA;AAED,KAAK,OAAO,CAAC,CAAC,SAAS,SAAS,IAAI,CAClC,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,eAAe,CAAC,KAClD,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAA;AAE5D,KAAK,MAAM,CAAC,CAAC,SAAS,SAAS,IAAI,CACjC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,mBAAmB,CAAC,KACpC,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,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACjD;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;CAC/C,CAAA;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc;WAClB,CAAC,SAAS,SAAS,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,KAAK,GAAE,QACpE,MAAM,UACJ,CAAC,GACR,qBAAqB,CAAC,CAAC,CAAC;CAG5B,CAAA"}

package/dist/src/collection/base.js

@@ -0,0 +1,40 @@
+import { makeRuleBuilder } from "../rule/builder.js";
+import { Index } from "./index-builder.js";
+import { toJSONSchema } from "./serialize.js";
+function makeBaseBuilder(name, fields, indexesCb, rulesCb) {
+    const indexes = indexesCb?.(Index);
+    const rules = rulesCb?.(makeRuleBuilder());
+    const schema = toJSONSchema("base", name, fields, {
+        ...(indexes !== undefined ? { indexes } : {}),
+        ...(rules !== undefined ? { rules } : {})
+    });
+    return {
+        name,
+        fields,
+        schema,
+        indexes: (cb) => makeBaseBuilder(name, fields, cb, rulesCb),
+        rules: (cb) => makeBaseBuilder(name, fields, indexesCb, cb)
+    };
+}
+/**
+ * Defines a standard data collection.
+ * Base collections are the primary storage type with full CRUD support.
+ *
+ * @example
+ * const Tasks = BaseCollection.define("tasks", {
+ *   title: Field.text({ maxLength: 200 }),
+ *   completed: Field.boolean({ default: false }),
+ *   ownerId: Field.text()
+ * })
+ * .indexes((I) => [I.on("ownerId")])
+ * .rules((R) => ({
+ *   list: Rule.public(),
+ *   view: R.field("ownerId").eq(R.authId(Users))
+ * }))
+ */
+export const BaseCollection = {
+    define(name, fields) {
+        return makeBaseBuilder(name, fields);
+    }
+};
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/collection/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA2C7C,SAAS,eAAe,CACtB,IAAY,EACZ,MAAS,EACT,SAAsB,EACtB,OAAmB;IAGnB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,KAAyB,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,eAAe,EAA2B,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QAChD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAA;IACF,OAAO;QACL,IAAI;QACJ,MAAM;QACN,MAAM;QACN,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC;QAC3D,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,CACJ,IAAY,EACZ,MAAS;QAET,OAAO,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;CACF,CAAA"}

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

@@ -0,0 +1,51 @@
+/**
+ * Human-readable byte size helpers.
+ * Use instead of raw byte values in `Field.file({ maxSize })`.
+ *
+ * @example
+ * Field.file({ maxSize: Bytes.fromMB(5) })
+ * Bytes.fromGB(2) // => 2 * 1024^3
+ */
+export declare const Bytes: {
+    /**
+     * Convert kilobytes to bytes.
+     *
+     * @param n - Size in kilobytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromKB(500)  // 512000
+     */
+    fromKB: (n: number) => number;
+    /**
+     * Convert megabytes to bytes.
+     *
+     * @param n - Size in megabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromMB(5)  // 5242880
+     */
+    fromMB: (n: number) => number;
+    /**
+     * Convert gigabytes to bytes.
+     *
+     * @param n - Size in gigabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromGB(2)  // 2147483648
+     */
+    fromGB: (n: number) => number;
+    /**
+     * Convert terabytes to bytes.
+     *
+     * @param n - Size in terabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromTB(1)  // 1099511627776
+     */
+    fromTB: (n: number) => number;
+};
+//# sourceMappingURL=bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/collection/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;IAChB;;;;;;;;OAQG;gBACS,MAAM;IAElB;;;;;;;;OAQG;gBACS,MAAM;IAElB;;;;;;;;OAQG;gBACS,MAAM;IAElB;;;;;;;;OAQG;gBACS,MAAM;CACnB,CAAA"}

package/dist/src/collection/bytes.js

@@ -0,0 +1,51 @@
+/**
+ * Human-readable byte size helpers.
+ * Use instead of raw byte values in `Field.file({ maxSize })`.
+ *
+ * @example
+ * Field.file({ maxSize: Bytes.fromMB(5) })
+ * Bytes.fromGB(2) // => 2 * 1024^3
+ */
+export const Bytes = {
+    /**
+     * Convert kilobytes to bytes.
+     *
+     * @param n - Size in kilobytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromKB(500)  // 512000
+     */
+    fromKB: (n) => n * 1024,
+    /**
+     * Convert megabytes to bytes.
+     *
+     * @param n - Size in megabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromMB(5)  // 5242880
+     */
+    fromMB: (n) => n * 1024 ** 2,
+    /**
+     * Convert gigabytes to bytes.
+     *
+     * @param n - Size in gigabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromGB(2)  // 2147483648
+     */
+    fromGB: (n) => n * 1024 ** 3,
+    /**
+     * Convert terabytes to bytes.
+     *
+     * @param n - Size in terabytes
+     * @returns Size in bytes
+     *
+     * @example
+     * Bytes.fromTB(1)  // 1099511627776
+     */
+    fromTB: (n) => n * 1024 ** 4
+};
+//# sourceMappingURL=bytes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../../src/collection/bytes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI;IAE/B;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IAEpC;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IAEpC;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;CACrC,CAAA"}

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

@@ -0,0 +1,29 @@
+declare const ValidationError_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: "ValidationError";
+} & Readonly<A>;
+/**
+ * Error raised when collection field validation fails.
+ * Contains the collection name and a list of human-readable issue descriptions.
+ *
+ * Raised by:
+ * - `filterNodeToWhereClause()` — when a filter references an unknown field
+ * - `CollectionService` — when field-level constraints (type, required, min/max length, etc.)
+ *   fail validation on create or update
+ * - Effect Schema validation — when input fails schema decoding
+ *
+ * @example
+ * new ValidationError({
+ *   collection: "posts",
+ *   issues: ['Field "title" is required']
+ * })
+ *
+ * @see CollectionService — service that raises ValidationError
+ * @see filterNodeToWhereClause — raises ValidationError for unknown filter fields
+ */
+export declare class ValidationError extends ValidationError_base<{
+    collection: string;
+    issues: ReadonlyArray<string>;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/collection/errors.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC9B,CAAC;CAAG"}

package/dist/src/collection/errors.js

@@ -0,0 +1,23 @@
+import { Data } from "effect";
+/**
+ * Error raised when collection field validation fails.
+ * Contains the collection name and a list of human-readable issue descriptions.
+ *
+ * Raised by:
+ * - `filterNodeToWhereClause()` — when a filter references an unknown field
+ * - `CollectionService` — when field-level constraints (type, required, min/max length, etc.)
+ *   fail validation on create or update
+ * - Effect Schema validation — when input fails schema decoding
+ *
+ * @example
+ * new ValidationError({
+ *   collection: "posts",
+ *   issues: ['Field "title" is required']
+ * })
+ *
+ * @see CollectionService — service that raises ValidationError
+ * @see filterNodeToWhereClause — raises ValidationError for unknown filter fields
+ */
+export class ValidationError extends Data.TaggedError("ValidationError") {
+}
+//# sourceMappingURL=errors.js.map

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

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