@gettersethya/mira-collection 0.1.0-alpha.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/collection/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAY,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAwB3F;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAC7D,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CAClD,GACA,gBAAgB,GAAG;IAAE,mBAAmB,EAAE,CAAC,CAAA;CAAE,CAkD/C"}

package/dist/src/collection/serialize.js

@@ -0,0 +1,127 @@
+const ID_PROPERTY = {
+    type: "string",
+    "x-system": true
+};
+const SEQID_PROPERTY = {
+    type: "integer",
+    "x-kind": "seqId",
+    "x-system": true,
+    "x-hidden": true
+};
+const CREATED_PROPERTY = {
+    type: "string",
+    "x-system": true
+};
+const UPDATED_PROPERTY = {
+    type: "string",
+    "x-system": true
+};
+/**
+ * Converts a user-facing field definition map into a JSON Schema `CollectionSchema`.
+ *
+ * - Automatically injects `seqId` as the first property.
+ - Injects system fields (e.g., auth email/password) before user fields.
+ - Collects `required` from fields without defaults.
+ - Normalizes `unique`/`indexed` flags into `x-indexes`.
+ - Merges collection-level indexes from `options.indexes`.
+ - Passes through `x-rules` and `x-view-query` if provided.
+ *
+ * Used internally by `BaseCollection.define()`, `AuthCollection.define()`, and `ViewCollection.define()`.
+ */
+export function toJSONSchema(kind, _name, fields, options) {
+    const xIndexes = [];
+    const required = [];
+    const properties = {};
+    for (const [key, prop] of Object.entries(options.systemFields ?? {})) {
+        if (prop.default === undefined) {
+            required.push(key);
+        }
+    }
+    for (const [key, field] of Object.entries(fields)) {
+        const name = field.name ?? key;
+        const prop = fieldToProperty(field);
+        if (field.required !== false && field.default === undefined) {
+            required.push(name);
+        }
+        if (field.unique) {
+            xIndexes.push({ fields: [name], unique: true });
+        }
+        if (field.indexed) {
+            xIndexes.push({ fields: [name], unique: false });
+        }
+        properties[name] = prop;
+    }
+    for (const idx of options.indexes ?? []) {
+        xIndexes.push({ fields: [...idx.fields], unique: idx.unique });
+    }
+    const result = {
+        "x-collection-kind": kind,
+        ...(xIndexes.length > 0 ? { "x-indexes": xIndexes } : {}),
+        ...(options.rules !== undefined ? { "x-rules": options.rules } : {}),
+        ...(options.viewQuery !== undefined ? { "x-view-query": options.viewQuery } : {}),
+        type: "object",
+        properties: {
+            ...(kind !== "view" ? { id: ID_PROPERTY, seqId: SEQID_PROPERTY } : {}),
+            ...(options.systemFields ?? {}),
+            ...properties,
+            ...(kind !== "view" ? { created: CREATED_PROPERTY, updated: UPDATED_PROPERTY } : {})
+        },
+        ...(required.length > 0 ? { required } : {})
+    };
+    return result;
+}
+/** Converts a single `FieldDef` to its JSON Schema property representation. */
+function fieldToProperty(field) {
+    const base = (() => {
+        switch (field.kind) {
+            case "text":
+                return {
+                    type: "string",
+                    ...(field.minLength !== undefined ? { minLength: field.minLength } : {}),
+                    ...(field.maxLength !== undefined ? { maxLength: field.maxLength } : {})
+                };
+            case "number":
+                return {
+                    type: "number",
+                    ...(field.min !== undefined ? { minimum: field.min } : {}),
+                    ...(field.max !== undefined ? { maximum: field.max } : {})
+                };
+            case "integer":
+                return {
+                    type: "integer",
+                    ...(field.min !== undefined ? { minimum: field.min } : {}),
+                    ...(field.max !== undefined ? { maximum: field.max } : {})
+                };
+            case "boolean":
+                return {
+                    type: "boolean",
+                    ...(field.default !== undefined ? { default: field.default } : {})
+                };
+            case "email":
+                return { type: "string", format: "email" };
+            case "date":
+                return { type: "string", "x-kind": "date" };
+            case "json":
+                return { "x-kind": "json" };
+            case "relation":
+                return {
+                    type: "string",
+                    "x-kind": "relation",
+                    "x-collection": field.targetCollection,
+                    "x-field": field.targetField ?? "id"
+                };
+            case "seqId":
+                return { type: "integer", "x-kind": "seqId", "x-system": true };
+            case "file":
+                return {
+                    type: "string",
+                    "x-kind": "file",
+                    ...(field.maxSize !== undefined ? { "x-maxSize": field.maxSize } : {}),
+                    ...(field.mimeTypes !== undefined ? { "x-mimeTypes": field.mimeTypes } : {}),
+                    ...(field.protected === true ? { "x-protected": true } : {})
+                };
+        }
+    })();
+    return field.viewOnly ? { ...base, "x-view-only": true } : base;
+}
+//# sourceMappingURL=serialize.js.map

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

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

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

@@ -0,0 +1,119 @@
+/**
+ * The kind of constraint that failed validation on a field.
+ * Passed to the `error` callback on `FieldDef` so callers can return
+ * a per-constraint custom message.
+ */
+export type ConstraintKind = "type" | "required" | "minLength" | "maxLength" | "email" | "minimum" | "maximum" | "int";
+/** Constraint kinds that can fire on a `Field.text()` field. */
+export type TextConstraintKind = "type" | "required" | "minLength" | "maxLength";
+/** Constraint kinds that can fire on a `Field.email()` field. */
+export type EmailConstraintKind = "type" | "required" | "email";
+/** Constraint kinds that can fire on a `Field.number()` field. */
+export type NumberConstraintKind = "type" | "required" | "minimum" | "maximum";
+/** Constraint kinds that can fire on a `Field.integer()` field. */
+export type IntegerConstraintKind = "type" | "required" | "int" | "minimum" | "maximum";
+/** Constraint kinds that can fire on simple fields (boolean, date, json, file, relation). */
+export type SimpleConstraintKind = "type" | "required";
+/** Supported field kinds that define the data type of a collection field. */
+export type FieldKind = "text" | "number" | "integer" | "boolean" | "email" | "date" | "json" | "relation" | "file" | "seqId";
+/**
+ * Describes a single field in a collection definition.
+ * Created via `Field.*()` builders — never constructed directly.
+ *
+ * @example
+ * Field.text({ maxLength: 200 })
+ * Field.relation(Users, { field: "id" })
+ */
+export type FieldDef = {
+    _tag: "FieldDef";
+    kind: FieldKind;
+    name?: string;
+    required?: boolean;
+    unique?: boolean;
+    indexed?: boolean;
+    default?: unknown;
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    targetCollection?: string;
+    targetField?: string;
+    maxSize?: number;
+    mimeTypes?: Array<string>;
+    viewOnly?: boolean;
+    protected?: boolean;
+    _target?: AnyCollectionDef;
+    error?(kind: ConstraintKind): string | undefined;
+};
+/** A database index on one or more fields, either unique or non-unique. */
+export type IndexDef = {
+    fields: Array<string>;
+    unique: boolean;
+};
+import type { RuleMap } from "../rule/types.js";
+/**
+ * The JSON Schema representation of a collection.
+ * This is the serialized format stored in the `_collections` table.
+ * TypeScript field definitions are compiled down to this format.
+ */
+export type CollectionSchema = {
+    "x-collection-kind": "base" | "auth" | "view";
+    "x-indexes"?: Array<IndexDef>;
+    "x-rules"?: RuleMap;
+    "x-view-query"?: string;
+    type: "object";
+    properties: Record<string, JsonSchemaProperty>;
+    required?: Array<string>;
+};
+/** A single property within a JSON Schema collection definition. */
+export type JsonSchemaProperty = {
+    type?: "string" | "number" | "integer" | "boolean";
+    format?: "email";
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    "x-kind"?: "date" | "json" | "relation" | "file" | "seqId";
+    "x-collection"?: string;
+    "x-field"?: string;
+    "x-maxSize"?: number;
+    "x-mimeTypes"?: Array<string>;
+    "x-protected"?: boolean;
+    "x-system"?: boolean;
+    "x-hidden"?: boolean;
+    "x-view-only"?: boolean;
+};
+/**
+ * A record mapping field names to their `FieldDef` definitions.
+ * Used when defining collection fields.
+ *
+ * @example
+ * { title: Field.text(), published: Field.boolean() }
+ */
+export type FieldsMap = Record<string, FieldDef>;
+/**
+ * The user-facing output of a collection definition.
+ * Returned by `BaseCollection.define()`, `AuthCollection.define()`, and `ViewCollection.define()`.
+ */
+export type AnyCollectionDef = {
+    name: string;
+    fields: FieldsMap;
+    schema: CollectionSchema;
+};
+/** Maps each FieldKind to its corresponding TypeScript scalar type. */
+export type FieldKindToType = {
+    text: string;
+    number: number;
+    integer: number;
+    boolean: boolean;
+    email: string;
+    date: string;
+    json: unknown;
+    relation: string;
+    file: string;
+    seqId: number;
+};
+/** Infers the TypeScript value type for a given FieldDef. */
+export type InferFieldValue<T extends FieldDef> = FieldKindToType[T["kind"]];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/collection/types.js

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

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

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

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

@@ -0,0 +1,57 @@
+import type { RuleBuilder } from "../rule/builder.js";
+import type { RuleMap } from "../rule/types.js";
+import type { CollectionSchema, FieldDef, FieldsMap } from "./types.js";
+type ViewFields = {
+    id: FieldDef & {
+        viewOnly: true;
+    };
+    seqId: FieldDef & {
+        viewOnly: true;
+    };
+};
+type RuleCb<F extends FieldsMap> = (R: RuleBuilder<F>) => RuleMap;
+/**
+ * Builder returned by `ViewCollection.define()`.
+ * Immediately satisfies `AnyCollectionDef` — no terminal `.build()` needed.
+ * Chain `.rules()` to add access rules. Views have no `.indexes()` — they are not physical tables.
+ * Each chained method returns a new builder; the original is unchanged.
+ */
+export type ViewCollectionBuilder<F extends FieldsMap> = {
+    name: string;
+    fields: F;
+    schema: CollectionSchema;
+    /**
+     * 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>): ViewCollectionBuilder<F>;
+};
+/** @internal Exported for testing only. */
+export declare function validateViewFields(name: string, fields: Record<string, {
+    viewOnly?: boolean;
+}>): void;
+/**
+ * Defines a read-only view collection backed by a raw SQL query.
+ * Requires `id` and `seqId` in the field map, both declared with `.view()`.
+ * No indexes are supported.
+ *
+ * @example
+ * const ActivePosts = ViewCollection.define(
+ *   "active_posts",
+ *   `WITH ranked AS (
+ *      SELECT p.id, p.title, ROW_NUMBER() OVER (ORDER BY p.created DESC) AS seqId
+ *      FROM posts p WHERE p.status = 'active'
+ *    ) SELECT * FROM ranked`,
+ *   {
+ *     id:    Field.text().view(),
+ *     seqId: Field.integer().view(),
+ *     title: Field.text().view()
+ *   }
+ * )
+ * .rules((R) => ({ list: R.public(), view: R.public() }))
+ */
+export declare const ViewCollection: {
+    define<F extends ViewFields & FieldsMap>(name: string, query: string, fields: F): ViewCollectionBuilder<F>;
+};
+export {};
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/collection/view.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,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEvE,KAAK,UAAU,GAAG;IAChB,EAAE,EAAK,QAAQ,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAA;IACpC,KAAK,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAA;CACrC,CAAA;AAED,KAAK,MAAM,CAAC,CAAC,SAAS,SAAS,IAAI,CACjC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KACd,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,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;CAC/C,CAAA;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,IAAI,CAKrG;AAqBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc;WAClB,CAAC,SAAS,UAAU,GAAG,SAAS,QAC/B,MAAM,SACL,MAAM,UACL,CAAC,GACR,qBAAqB,CAAC,CAAC,CAAC;CAI5B,CAAA"}

package/dist/src/collection/view.js

@@ -0,0 +1,49 @@
+import { makeRuleBuilder } from "../rule/builder.js";
+import { toJSONSchema } from "./serialize.js";
+/** @internal Exported for testing only. */
+export function validateViewFields(name, fields) {
+    if (!fields.id || fields.id.viewOnly !== true)
+        throw new Error(`ViewCollection "${name}": "id" must be declared with .view()`);
+    if (!fields.seqId || fields.seqId.viewOnly !== true)
+        throw new Error(`ViewCollection "${name}": "seqId" must be declared with .view()`);
+}
+function makeViewBuilder(name, query, fields, rulesCb) {
+    const rules = rulesCb?.(makeRuleBuilder());
+    const schema = toJSONSchema("view", name, fields, {
+        viewQuery: query,
+        ...(rules !== undefined ? { rules } : {})
+    });
+    return {
+        name,
+        fields,
+        schema,
+        rules: (cb) => makeViewBuilder(name, query, fields, cb)
+    };
+}
+/**
+ * Defines a read-only view collection backed by a raw SQL query.
+ * Requires `id` and `seqId` in the field map, both declared with `.view()`.
+ * No indexes are supported.
+ *
+ * @example
+ * const ActivePosts = ViewCollection.define(
+ *   "active_posts",
+ *   `WITH ranked AS (
+ *      SELECT p.id, p.title, ROW_NUMBER() OVER (ORDER BY p.created DESC) AS seqId
+ *      FROM posts p WHERE p.status = 'active'
+ *    ) SELECT * FROM ranked`,
+ *   {
+ *     id:    Field.text().view(),
+ *     seqId: Field.integer().view(),
+ *     title: Field.text().view()
+ *   }
+ * )
+ * .rules((R) => ({ list: R.public(), view: R.public() }))
+ */
+export const ViewCollection = {
+    define(name, query, fields) {
+        validateViewFields(name, fields);
+        return makeViewBuilder(name, query, fields);
+    }
+};
+//# sourceMappingURL=view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/collection/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA6B7C,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAA8C;IAC7F,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI;QAC3C,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,uCAAuC,CAAC,CAAA;IACjF,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI;QACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,0CAA0C,CAAC,CAAA;AACtF,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,KAAa,EACb,MAAS,EACT,OAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,eAAe,EAAK,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QAChD,SAAS,EAAE,KAAK;QAChB,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,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;KACxD,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,CACJ,IAAY,EACZ,KAAa,EACb,MAAS;QAET,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChC,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAC7C,CAAC;CACF,CAAA"}

package/dist/src/filter/builder.d.ts

@@ -0,0 +1,127 @@
+import type { FieldsMap, InferFieldValue } from "../collection/types.js";
+import type { FilterNode } from "./types.js";
+/**
+ * Operand returned by `Filter.field(name)` — provides comparison methods
+ * that each produce a `FilterNode`.
+ *
+ * The type parameter `V` constrains the value type for comparisons:
+ * when used through `FilterBuilder<F>.field(name)`, `V` is the inferred
+ * TypeScript type of the field (string, number, boolean, etc.). When used
+ * through the untyped `Filter.field(name)`, `V` is `unknown`.
+ *
+ * Available comparisons:
+ * - `.eq(v)` / `.neq(v)` — equality / inequality
+ * - `.gt(v)` / `.gte(v)` — greater than / greater or equal
+ * - `.lt(v)` / `.lte(v)` — less than / less or equal
+ * - `.in(values)` — membership in a list
+ * - `.like(pattern)` — SQL LIKE pattern match (always string-valued)
+ * - `.null()` / `.notNull()` — IS NULL / IS NOT NULL (no value argument)
+ * - `.between(lo, hi)` — compound of `.gte(lo)` + `.lte(hi)`
+ *
+ * @example
+ * import { Filter } from "@gettersethya/mira-collection"
+ *
+ * Filter.field("age").gte(18)
+ * Filter.field("title").like("%effect%")
+ * Filter.field("tags").in(["a", "b", "c"])
+ * Filter.field("deletedAt").null()
+ * Filter.field("price").between(10, 100)
+ *
+ * @see Filter — entry point to create FieldFilterOperand
+ * @see FilterBuilder — typed variant with field-name and value-type safety
+ */
+export type FieldFilterOperand<V = unknown> = {
+    eq(value: V): FilterNode;
+    neq(value: V): FilterNode;
+    gt(value: V): FilterNode;
+    gte(value: V): FilterNode;
+    lt(value: V): FilterNode;
+    lte(value: V): FilterNode;
+    in(values: ReadonlyArray<V>): FilterNode;
+    like(value: string): FilterNode;
+    null(): FilterNode;
+    notNull(): FilterNode;
+    between(lo: V, hi: V): FilterNode;
+};
+/**
+ * Typed filter builder constrained to a specific `FieldsMap`.
+ * Provides the same methods as `Filter` but narrows field names and value
+ * types according to the collection's field definitions.
+ *
+ * Used inside `CollectionClient.getList({ filter: (f) => ... })` callbacks.
+ *
+ * @example
+ * interface PostFields { title: FieldDef & { kind: "text" }; views: FieldDef & { kind: "number" } }
+ * const f: FilterBuilder<PostFields>
+ *
+ * f.field("title").eq("hello")     // typed — value is string
+ * f.field("views").gte(100)        // typed — value is number
+ * f.field("views").eq("bad")       // type error — expects number
+ * f.field("nonexistent").eq(1)     // type error — field does not exist
+ *
+ * @see Filter — untyped version of the same DSL
+ * @see FieldFilterOperand — the return type of .field()
+ */
+export type FilterBuilder<F extends FieldsMap = 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;
+};
+/**
+ * Filter DSL builder for constructing `FilterNode` expressions.
+ *
+ * Use `Filter.field(name)` to start a comparison chain, then call a comparison
+ * method (`.eq()`, `.neq()`, `.gt()`, etc.) to produce a `FilterNode`.
+ * Combine nodes with `Filter.and()`, `Filter.or()`, `Filter.not()`.
+ *
+ * This is the untyped variant — field names are plain strings and values are
+ * `unknown`. For type-safe field access, use `FilterBuilder<F>` via the
+ * `CollectionClient` callback pattern.
+ *
+ * @example
+ * import { Filter } from "@gettersethya/mira-collection"
+ *
+ * // Simple equality
+ * const published = Filter.field("published").eq(true)
+ *
+ * // Range check
+ * const popular = Filter.and(
+ *   Filter.field("views").gte(100),
+ *   Filter.field("views").lte(10_000)
+ * )
+ *
+ * // In-list
+ * const draftOrArchived = Filter.field("status").in(["draft", "archived"])
+ *
+ * // LIKE pattern
+ * const search = Filter.field("title").like("%effect%")
+ *
+ * // Null checks
+ * const hasDeletedAt = Filter.field("deletedAt").null()
+ * const notDeleted = Filter.field("deletedAt").notNull()
+ *
+ * // Complex combination
+ * const query = Filter.and(
+ *   Filter.field("published").eq(true),
+ *   Filter.or(
+ *     Filter.field("category").eq("tech"),
+ *     Filter.field("tags").contains("effect")
+ *   )
+ * )
+ *
+ * @see FilterNode — the AST node produced by filter methods
+ * @see FilterBuilder — typed variant used in CollectionClient methods
+ * @see filterNodeToWhereClause — compiles FilterNode to SQL
+ */
+export declare const Filter: {
+    /** Start a filter chain for a field by name. Returns a `FieldFilterOperand` with comparison methods. */
+    field: <K extends string>(name: K) => FieldFilterOperand<unknown>;
+    /** Combine two filter nodes with logical AND. Produces `(left) AND (right)` in SQL. */
+    and: (left: FilterNode, right: FilterNode) => FilterNode;
+    /** Combine two filter nodes with logical OR. Produces `(left) OR (right)` in SQL. */
+    or: (left: FilterNode, right: FilterNode) => FilterNode;
+    /** Negate a filter node with logical NOT. Produces `NOT (node)` in SQL. */
+    not: (node: FilterNode) => FilterNode;
+};
+//# sourceMappingURL=builder.d.ts.map

package/dist/src/filter/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/filter/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC5C,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACxB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACzB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACxB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACzB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACxB,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IACzB,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAAA;IACxC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;IAC/B,IAAI,IAAI,UAAU,CAAA;IAClB,OAAO,IAAI,UAAU,CAAA;IACrB,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAA;CAClC,CAAA;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI;IAC3D,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACrF,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAAA;IACpD,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAAA;IACnD,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;CAClC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,eAAO,MAAM,MAAM;IACjB,wGAAwG;YAChG,CAAC,SAAS,MAAM,QAAQ,CAAC,KAAG,kBAAkB,CAAC,OAAO,CAAC;IAG/D,uFAAuF;gBAC3E,UAAU,SAAS,UAAU,KAAG,UAAU;IAGtD,qFAAqF;eAC1E,UAAU,SAAS,UAAU,KAAG,UAAU;IAGrD,2EAA2E;gBAC/D,UAAU,KAAG,UAAU;CAEpC,CAAA"}

package/dist/src/filter/builder.js

@@ -0,0 +1,72 @@
+function toFieldOperand(field) {
+    return {
+        eq: (value) => ({ op: "eq", field, value }),
+        neq: (value) => ({ op: "neq", field, value }),
+        gt: (value) => ({ op: "gt", field, value }),
+        gte: (value) => ({ op: "gte", field, value }),
+        lt: (value) => ({ op: "lt", field, value }),
+        lte: (value) => ({ op: "lte", field, value }),
+        in: (values) => ({ op: "in", field, values }),
+        like: (value) => ({ op: "like", field, value }),
+        null: () => ({ op: "null", field }),
+        notNull: () => ({ op: "not_null", field }),
+        between: (lo, hi) => ({ op: "and", left: { op: "gte", field, value: lo }, right: { op: "lte", field, value: hi } })
+    };
+}
+/**
+ * Filter DSL builder for constructing `FilterNode` expressions.
+ *
+ * Use `Filter.field(name)` to start a comparison chain, then call a comparison
+ * method (`.eq()`, `.neq()`, `.gt()`, etc.) to produce a `FilterNode`.
+ * Combine nodes with `Filter.and()`, `Filter.or()`, `Filter.not()`.
+ *
+ * This is the untyped variant — field names are plain strings and values are
+ * `unknown`. For type-safe field access, use `FilterBuilder<F>` via the
+ * `CollectionClient` callback pattern.
+ *
+ * @example
+ * import { Filter } from "@gettersethya/mira-collection"
+ *
+ * // Simple equality
+ * const published = Filter.field("published").eq(true)
+ *
+ * // Range check
+ * const popular = Filter.and(
+ *   Filter.field("views").gte(100),
+ *   Filter.field("views").lte(10_000)
+ * )
+ *
+ * // In-list
+ * const draftOrArchived = Filter.field("status").in(["draft", "archived"])
+ *
+ * // LIKE pattern
+ * const search = Filter.field("title").like("%effect%")
+ *
+ * // Null checks
+ * const hasDeletedAt = Filter.field("deletedAt").null()
+ * const notDeleted = Filter.field("deletedAt").notNull()
+ *
+ * // Complex combination
+ * const query = Filter.and(
+ *   Filter.field("published").eq(true),
+ *   Filter.or(
+ *     Filter.field("category").eq("tech"),
+ *     Filter.field("tags").contains("effect")
+ *   )
+ * )
+ *
+ * @see FilterNode — the AST node produced by filter methods
+ * @see FilterBuilder — typed variant used in CollectionClient methods
+ * @see filterNodeToWhereClause — compiles FilterNode to SQL
+ */
+export const Filter = {
+    /** Start a filter chain for a field by name. Returns a `FieldFilterOperand` with comparison methods. */
+    field: (name) => toFieldOperand(name),
+    /** Combine two filter nodes with logical AND. Produces `(left) AND (right)` in SQL. */
+    and: (left, right) => ({ op: "and", left, right }),
+    /** Combine two filter nodes with logical OR. Produces `(left) OR (right)` in SQL. */
+    or: (left, right) => ({ op: "or", left, right }),
+    /** Negate a filter node with logical NOT. Produces `NOT (node)` in SQL. */
+    not: (node) => ({ op: "not", node })
+};
+//# sourceMappingURL=builder.js.map

package/dist/src/filter/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/filter/builder.ts"],"names":[],"mappings":"AA+CA,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO;QACL,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACtD,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACtD,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACtD,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACtD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACxD,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAe,EAAE,KAAK,EAAE,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,UAAmB,EAAE,KAAK,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAc,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAc,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;KAC/I,CAAA;AACH,CAAC;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,wGAAwG;IACxG,KAAK,EAAE,CAAmB,IAAO,EAA+B,EAAE,CAChE,cAAc,CAAC,IAAI,CAAC;IAEtB,uFAAuF;IACvF,GAAG,EAAE,CAAC,IAAgB,EAAE,KAAiB,EAAc,EAAE,CACvD,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAEvC,qFAAqF;IACrF,EAAE,EAAE,CAAC,IAAgB,EAAE,KAAiB,EAAc,EAAE,CACtD,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAEtC,2EAA2E;IAC3E,GAAG,EAAE,CAAC,IAAgB,EAAc,EAAE,CACpC,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,CAAC;CACjC,CAAA"}

package/dist/src/filter/compiler.d.ts

@@ -0,0 +1,48 @@
+import { Effect } from "effect";
+import type { CollectionSchema } from "../collection/types.js";
+import { ValidationError } from "../collection/errors.js";
+import type { FilterNode, WhereClause } from "./types.js";
+/**
+ * Compile a `FilterNode` AST into a `WhereClause` (`{ sql, params }`) suitable
+ * for splicing into an Effect SQL template literal via `unsafeFragment`.
+ *
+ * Validates each referenced field against the collection schema. Unknown fields
+ * produce a `ValidationError` in the Effect error channel.
+ *
+ * Field names are SQL-identifier-quoted (double-quoted as `t."fieldName"`).
+ * Values use `?`-style positional placeholders with params in the returned array.
+ *
+ * Edge cases:
+ * - `IN ()` with an empty array produces `1 = 0` (always false) instead of
+ *   invalid SQL like `IN ()`.
+ * - The `like` pattern is passed through verbatim — the caller is responsible
+ *   for adding `%` wildcards.
+ * - All column references use the hardcoded table alias `t`.
+ *
+ * @param node - The filter AST to compile
+ * @param schema - The collection schema (used for field validation)
+ * @param collectionName - Collection name (used only in error messages)
+ * @returns Effect that resolves to a WhereClause, or fails with ValidationError
+ *          if any field name in the filter does not exist in the schema
+ *
+ * @example
+ * import { Filter, filterNodeToWhereClause } from "@gettersethya/mira-collection"
+ * import type { CollectionSchema } from "@gettersethya/mira-collection"
+ *
+ * const schema: CollectionSchema = {
+ *   type: "object",
+ *   properties: { title: { type: "string" } }
+ * } as CollectionSchema
+ *
+ * const effect = filterNodeToWhereClause(
+ *   Filter.field("title").eq("hello"),
+ *   schema,
+ *   "posts"
+ * )
+ * // Resolves to: { sql: 't."title" = ?', params: ["hello"] }
+ *
+ * @see FilterNode — the AST type consumed by this function
+ * @see WhereClause — the output type
+ */
+export declare function filterNodeToWhereClause(node: FilterNode, schema: CollectionSchema, collectionName: string): Effect.Effect<WhereClause, ValidationError>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/src/filter/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/filter/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAE7C"}