@gettersethya/mira-collection 0.1.0-alpha.10

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/README.md

@@ -0,0 +1,164 @@
+# @gettersethya/mira-collection
+
+> **Early pre-alpha.** Breaking changes may occur without notice.
+
+Collection definitions, filter DSL, and access rule builder for [Mira](https://github.com/gettersethya/mira). Shared between server and client — isomorphic, no runtime dependencies beyond `effect`.
+
+## Installation
+
+```bash
+npm install @gettersethya/mira-collection effect
+# or
+pnpm add @gettersethya/mira-collection effect
+```
+
+## Collection types
+
+### Base collection
+
+Standard CRUD collection. System fields `id`, `seqId`, `created`, and `updated` are added automatically.
+
+```typescript
+import { BaseCollection, Bytes, Field, Rule } from "@gettersethya/mira-collection"
+
+const Posts = BaseCollection.define("posts", {
+  title:     Field.text({ maxLength: 200 }),
+  slug:      Field.text({ unique: true }),
+  content:   Field.text(),
+  published: Field.boolean({ default: false }),
+  authorId:  Field.relation(Users),
+  thumbnail: Field.file({ maxSize: Bytes.fromMB(5), mimeTypes: ["image/*"] }),
+})
+.indexes((I) => [
+  I.on("authorId"),
+  I.unique("slug"),
+])
+.rules((R) => ({
+  list:   R.field("published").eq(R.literal(true)),
+  view:   Rule.or(R.field("published").eq(R.literal(true)), R.field("authorId").eq(R.authId(Users))),
+  create: R.authId(Users).neq(R.literal(null)),
+  update: R.field("authorId").eq(R.authId(Users)),
+  delete: R.field("authorId").eq(R.authId(Users)),
+}))
+```
+
+### Auth collection
+
+Adds `email`, `password` (hashed), and `emailVerified` system fields. Exposes an `authWithPassword` endpoint.
+
+```typescript
+import { AuthCollection, Field, Rule } from "@gettersethya/mira-collection"
+
+const Users = AuthCollection.define("users", {
+  displayName: Field.text(),
+  username:    Field.text({ unique: true }),
+  role:        Field.text({ default: "user" }),
+})
+.rules((R) => ({
+  list:   Rule.public(),
+  view:   Rule.public(),
+  create: Rule.public(),
+  update: R.selfId().eq(R.authId(Users)),  // users can only edit themselves
+}))
+```
+
+### View collection
+
+Read-only, backed by a SQL `VIEW`. Supports `list` and `view` only. Every field must be marked `.view()`.
+
+```typescript
+import { Field, Rule, ViewCollection } from "@gettersethya/mira-collection"
+
+const PostsWithAuthors = ViewCollection.define(
+  "posts_with_authors",
+  `SELECT p.id, p.seqId, p.title, u.displayName AS authorName
+   FROM posts p LEFT JOIN users u ON p.authorId = u.id`,
+  {
+    id:         Field.text().view(),
+    seqId:      Field.integer().view(),
+    title:      Field.text().view(),
+    authorName: Field.text().view(),
+  }
+)
+.rules((R) => ({ list: Rule.public(), view: Rule.public() }))
+```
+
+## Field types
+
+```typescript
+Field.text({ minLength?, maxLength?, unique?, indexed?, required?, default? })
+Field.email()
+Field.integer({ min?, max?, unique?, indexed?, default? })
+Field.number({ min?, max? })
+Field.boolean({ default? })
+Field.date()
+Field.json()
+Field.file({ maxSize?, mimeTypes?, protected? })
+Field.relation(Collection)
+
+// File size helpers
+Bytes.fromKB(n)
+Bytes.fromMB(n)
+Bytes.fromGB(n)
+```
+
+## Indexes
+
+```typescript
+// Field-level (single column)
+Field.text({ unique: true })   // unique index
+Field.text({ indexed: true })  // non-unique index
+
+// Callback (composite or explicit)
+.indexes((I) => [
+  I.on("authorId"),                 // non-unique
+  I.on("authorId", "published"),    // composite
+  I.unique("slug"),                 // unique constraint
+  I.unique("teamId", "userId"),     // composite unique
+])
+```
+
+## Rules
+
+Rules are evaluated server-side on every request. A missing key means **deny all** for that action.
+
+```typescript
+Rule.public()                                        // allow all
+R.authId(Users).neq(R.literal(null))                // logged-in users only
+R.field("ownerId").eq(R.authId(Users))              // owner-only
+R.field("role").in(R.literal(["admin", "mod"]))     // role check
+R.auth(Users, "role").eq(R.literal("admin"))        // check a field on the auth record
+Rule.not(R.field("archived").eq(R.literal(true)))   // negation
+Rule.or(R.field("isPublic").eq(R.literal(true)), R.field("ownerId").eq(R.authId(Users)))
+Rule.and(R.field("published").eq(R.literal(true)), R.field("ownerId").eq(R.authId(Users)))
+
+// Date arithmetic
+R.field("created").gte(Rule.dateAdd(Rule.now(), -30, "day"))
+
+// Request values (header, query param, or body field)
+Rule.request("header", "x-api-key").eq(R.literal("secret"))
+
+// Subquery membership check
+Rule.subquery(Members, "teamId").where(R.field("userId").eq(R.authId(Users)))
+```
+
+## Filters
+
+Used in client queries. Type-checked against the collection's field types.
+
+```typescript
+f.field("published").eq(true)
+f.field("viewCount").gte(100)
+f.field("status").in(["draft", "published"])
+f.field("title").like("%effect%")
+f.field("deletedAt").null()
+f.field("price").between(10, 100)
+
+f.and(f.field("published").eq(true), f.field("viewCount").gte(100))
+f.or(f.field("category").eq("tech"), f.field("category").eq("science"))
+f.not(f.field("archived").eq(true))
+```
+
+## More
+
+See the [Mira root README](https://github.com/gettersethya/mira) for full documentation.

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;AA0CD;;;;;;;;;;;;;;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,55 @@
+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) {
+    let _schema;
+    return {
+        name,
+        fields: extraFields,
+        get schema() {
+            if (_schema === undefined) {
+                const indexes = indexesCb?.(Index);
+                const authRuleBuilder = {
+                    ...makeRuleBuilder(),
+                    selfId() { return { kind: "authId", collection: name }; }
+                };
+                const rules = rulesCb?.(authRuleBuilder);
+                _schema = toJSONSchema("auth", name, extraFields, {
+                    indexes: [...AUTH_SYSTEM_INDEXES, ...(indexes ?? [])],
+                    systemFields: AUTH_SYSTEM_PROPERTIES,
+                    ...(rules !== undefined ? { rules } : {})
+                });
+            }
+            return _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,IAAI,OAAyE,CAAA;IAC7E,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,WAAW;QACnB,IAAI,MAAM;YACR,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,KAAyB,CAAC,CAAA;gBACtD,MAAM,eAAe,GAA6C;oBAChE,GAAG,eAAe,EAA2B;oBAC7C,MAAM,KAA+B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA,CAAC,CAAC;iBACnF,CAAA;gBACD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,eAAe,CAAC,CAAA;gBACxC,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;oBAChD,OAAO,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBACrD,YAAY,EAAE,sBAAsB;oBACpC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C,CAAuD,CAAA;YAC1D,CAAC;YACD,OAAO,OAAQ,CAAA;QACjB,CAAC;QACD,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;AA6BD;;;;;;;;;;;;;;;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,45 @@
+import { makeRuleBuilder } from "../rule/builder.js";
+import { Index } from "./index-builder.js";
+import { toJSONSchema } from "./serialize.js";
+function makeBaseBuilder(name, fields, indexesCb, rulesCb) {
+    let _schema;
+    return {
+        name,
+        fields,
+        get schema() {
+            if (_schema === undefined) {
+                const indexes = indexesCb?.(Index);
+                const rules = rulesCb?.(makeRuleBuilder());
+                _schema = toJSONSchema("base", name, fields, {
+                    ...(indexes !== undefined ? { indexes } : {}),
+                    ...(rules !== undefined ? { rules } : {})
+                });
+            }
+            return _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,IAAI,OAAqC,CAAA;IACzC,OAAO;QACL,IAAI;QACJ,MAAM;QACN,IAAI,MAAM;YACR,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,KAAyB,CAAC,CAAA;gBACtD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,eAAe,EAA2B,CAAC,CAAA;gBACnE,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;oBAC3C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,OAAQ,CAAA;QACjB,CAAC;QACD,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"}