@gettersethya/mira-collection 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/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"}