contentbase 0.4.0 → 0.4.1

package/dist/query/collection-query.js

@@ -0,0 +1,184 @@
+import { QueryBuilder } from "./query-builder";
+import { operators } from "./operators";
+import { createModelInstance } from "../model-instance";
+export class CollectionQuery {
+    #collection;
+    #definition;
+    #queryBuilder;
+    #sorts = [];
+    #limit;
+    #offset;
+    #include = [];
+    constructor(collection, definition) {
+        this.#collection = collection;
+        this.#definition = definition;
+        this.#queryBuilder = new QueryBuilder();
+    }
+    /**
+     * Include related models in query results.
+     * Named relationships will be eagerly resolved and included in toJSON() output.
+     *
+     * @example
+     *   await collection.query(Project).include("plans").fetchAll()
+     *   await collection.query(Project).include("plans", "goal").fetchAll()
+     */
+    include(...names) {
+        this.#include.push(...names);
+        return this;
+    }
+    /** Returns the serialize options based on include() calls */
+    get serializeOptions() {
+        const opts = {};
+        if (this.#include.length > 0)
+            opts.related = this.#include;
+        return opts;
+    }
+    where(pathOrObject, operatorOrValue, value) {
+        this.#queryBuilder.where(pathOrObject, operatorOrValue, value);
+        return this;
+    }
+    whereIn(path, values) {
+        this.#queryBuilder.whereIn(path, values);
+        return this;
+    }
+    whereNotIn(path, values) {
+        this.#queryBuilder.whereNotIn(path, values);
+        return this;
+    }
+    whereGt(path, value) {
+        this.#queryBuilder.whereGt(path, value);
+        return this;
+    }
+    whereLt(path, value) {
+        this.#queryBuilder.whereLt(path, value);
+        return this;
+    }
+    whereGte(path, value) {
+        this.#queryBuilder.whereGte(path, value);
+        return this;
+    }
+    whereLte(path, value) {
+        this.#queryBuilder.whereLte(path, value);
+        return this;
+    }
+    whereContains(path, value) {
+        this.#queryBuilder.whereContains(path, value);
+        return this;
+    }
+    whereStartsWith(path, value) {
+        this.#queryBuilder.whereStartsWith(path, value);
+        return this;
+    }
+    whereEndsWith(path, value) {
+        this.#queryBuilder.whereEndsWith(path, value);
+        return this;
+    }
+    whereRegex(path, pattern) {
+        this.#queryBuilder.whereRegex(path, pattern);
+        return this;
+    }
+    whereExists(path) {
+        this.#queryBuilder.whereExists(path);
+        return this;
+    }
+    whereNotExists(path) {
+        this.#queryBuilder.whereNotExists(path);
+        return this;
+    }
+    scope(name) {
+        const scopeFn = this.#definition.scopes?.[name];
+        if (!scopeFn) {
+            throw new Error(`Unknown scope "${name}" on model "${this.#definition.name}"`);
+        }
+        return scopeFn(this);
+    }
+    sort(path, direction = "asc") {
+        this.#sorts.push({ path, direction });
+        return this;
+    }
+    limit(n) {
+        this.#limit = n;
+        return this;
+    }
+    offset(n) {
+        this.#offset = n;
+        return this;
+    }
+    async fetchAll() {
+        const collection = this.#collection;
+        if (!collection.loaded)
+            await collection.load();
+        const definition = this.#definition;
+        const conditions = this.#queryBuilder.conditions;
+        let results = [];
+        for (const pathId of collection.available) {
+            // Delegate all matching logic to collection (handles _model meta, prefix, Base fallback)
+            const matchedDef = collection.findModelDefinition(pathId);
+            if (matchedDef?.name !== definition.name)
+                continue;
+            const doc = collection.document(pathId);
+            const instance = createModelInstance(doc, definition, collection);
+            // Apply query conditions
+            const passesAll = conditions.every((cond) => {
+                const actual = getNestedValue(instance, cond.path);
+                return operators[cond.operator](actual, cond.value);
+            });
+            if (passesAll) {
+                results.push(instance);
+            }
+        }
+        if (this.#sorts.length > 0) {
+            results.sort((a, b) => {
+                for (const { path, direction } of this.#sorts) {
+                    const aVal = getNestedValue(a, path);
+                    const bVal = getNestedValue(b, path);
+                    if (aVal === bVal)
+                        continue;
+                    if (aVal == null)
+                        return direction === "asc" ? 1 : -1;
+                    if (bVal == null)
+                        return direction === "asc" ? -1 : 1;
+                    const cmp = aVal < bVal ? -1 : 1;
+                    return direction === "asc" ? cmp : -cmp;
+                }
+                return 0;
+            });
+        }
+        // Apply pagination
+        if (this.#offset && this.#offset > 0) {
+            results = results.slice(this.#offset);
+        }
+        if (this.#limit !== undefined && this.#limit >= 0) {
+            results = results.slice(0, this.#limit);
+        }
+        // Bind serialize options from include() so toJSON() includes relationships
+        if (this.#include.length > 0) {
+            const opts = this.serializeOptions;
+            for (const instance of results) {
+                const original = instance.toJSON;
+                instance.toJSON = (overrides) => {
+                    const merged = { ...opts, ...overrides };
+                    if (opts.related && overrides?.related) {
+                        merged.related = [...new Set([...opts.related, ...overrides.related])];
+                    }
+                    return original(merged);
+                };
+            }
+        }
+        return results;
+    }
+    async first() {
+        return (await this.fetchAll())[0];
+    }
+    async last() {
+        const all = await this.fetchAll();
+        return all[all.length - 1];
+    }
+    async count() {
+        return (await this.fetchAll()).length;
+    }
+}
+function getNestedValue(obj, path) {
+    return path.split(".").reduce((acc, key) => acc?.[key], obj);
+}
+//# sourceMappingURL=collection-query.js.map

package/dist/query/collection-query.js.map

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

package/dist/query/index.d.ts

@@ -0,0 +1,8 @@
+export { CollectionQuery } from "./collection-query";
+export { QueryBuilder } from "./query-builder";
+export { operators } from "./operators";
+export type { Operator } from "./operators";
+export type { Condition } from "./query-builder";
+export { queryDSLSchema, parseWhereClause, parseSortClause, executeQueryDSL, } from "./query-dsl";
+export type { QueryDSL } from "./query-dsl";
+//# sourceMappingURL=index.d.ts.map

package/dist/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,5 @@
+export { CollectionQuery } from "./collection-query";
+export { QueryBuilder } from "./query-builder";
+export { operators } from "./operators";
+export { queryDSLSchema, parseWhereClause, parseSortClause, executeQueryDSL, } from "./query-dsl";
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/query/operators.d.ts

@@ -0,0 +1,3 @@
+export type Operator = "eq" | "neq" | "in" | "notIn" | "gt" | "lt" | "gte" | "lte" | "contains" | "startsWith" | "endsWith" | "regex" | "exists";
+export declare const operators: Record<Operator, (actual: any, expected: any) => boolean>;
+//# sourceMappingURL=operators.d.ts.map

package/dist/query/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/query/operators.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,UAAU,GACV,YAAY,GACZ,UAAU,GACV,OAAO,GACP,QAAQ,CAAC;AAEb,eAAO,MAAM,SAAS,EAAE,MAAM,CAC5B,QAAQ,EACR,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAmBxC,CAAC"}

package/dist/query/operators.js

@@ -0,0 +1,18 @@
+export const operators = {
+    eq: (a, b) => a === b || JSON.stringify(a) === JSON.stringify(b),
+    neq: (a, b) => !operators.eq(a, b),
+    in: (a, b) => Array.isArray(b) && b.includes(a),
+    notIn: (a, b) => Array.isArray(b) && !b.includes(a),
+    gt: (a, b) => a > b,
+    lt: (a, b) => a < b,
+    gte: (a, b) => a >= b,
+    lte: (a, b) => a <= b,
+    contains: (a, b) => typeof a === "string" && a.includes(b),
+    startsWith: (a, b) => typeof a === "string" && a.startsWith(b),
+    endsWith: (a, b) => typeof a === "string" && a.endsWith(b),
+    regex: (a, b) => b instanceof RegExp
+        ? b.test(String(a))
+        : new RegExp(b).test(String(a)),
+    exists: (a, b) => b ? a !== undefined && a !== null : a === undefined || a === null,
+};
+//# sourceMappingURL=operators.js.map

package/dist/query/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../src/query/operators.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,SAAS,GAGlB;IACF,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;IACnB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;IACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;IACrB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACd,CAAC,YAAY,MAAM;QACjB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;CACpE,CAAC"}

package/dist/query/query-builder.d.ts

@@ -0,0 +1,34 @@
+import type { Operator } from "./operators";
+export interface Condition {
+    path: string;
+    operator: Operator;
+    value: unknown;
+}
+export declare class QueryBuilder {
+    #private;
+    get conditions(): Condition[];
+    /**
+     * Add a where condition.
+     *
+     * Three call signatures:
+     *   where({ "meta.status": "active" })         -- object shorthand, implicit eq
+     *   where("meta.status", "active")              -- two args, implicit eq
+     *   where("meta.priority", "gt", 5)             -- three args, explicit operator
+     *
+     * Always returns `this` for chaining (fixes bug in original).
+     */
+    where(pathOrObject: string | Record<string, unknown>, operatorOrValue?: Operator | unknown, value?: unknown): this;
+    whereIn(path: string, values: unknown[]): this;
+    whereNotIn(path: string, values: unknown[]): this;
+    whereGt(path: string, value: unknown): this;
+    whereLt(path: string, value: unknown): this;
+    whereGte(path: string, value: unknown): this;
+    whereLte(path: string, value: unknown): this;
+    whereContains(path: string, value: string): this;
+    whereStartsWith(path: string, value: string): this;
+    whereEndsWith(path: string, value: string): this;
+    whereRegex(path: string, pattern: RegExp | string): this;
+    whereExists(path: string): this;
+    whereNotExists(path: string): this;
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/query/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/query/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,YAAY;;IAGvB,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED;;;;;;;;;OASG;IACH,KAAK,CACH,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,eAAe,CAAC,EAAE,QAAQ,GAAG,OAAO,EACpC,KAAK,CAAC,EAAE,OAAO,GACd,IAAI;IA0BP,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAS9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI5C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC"}

package/dist/query/query-builder.js

@@ -0,0 +1,84 @@
+export class QueryBuilder {
+    #conditions = [];
+    get conditions() {
+        return [...this.#conditions];
+    }
+    /**
+     * Add a where condition.
+     *
+     * Three call signatures:
+     *   where({ "meta.status": "active" })         -- object shorthand, implicit eq
+     *   where("meta.status", "active")              -- two args, implicit eq
+     *   where("meta.priority", "gt", 5)             -- three args, explicit operator
+     *
+     * Always returns `this` for chaining (fixes bug in original).
+     */
+    where(pathOrObject, operatorOrValue, value) {
+        if (typeof pathOrObject === "object" && pathOrObject !== null) {
+            for (const [k, v] of Object.entries(pathOrObject)) {
+                this.#conditions.push({ path: k, operator: "eq", value: v });
+            }
+            return this;
+        }
+        if (value === undefined) {
+            // Two-arg form: where("path", value) -- implicit eq
+            this.#conditions.push({
+                path: pathOrObject,
+                operator: "eq",
+                value: operatorOrValue,
+            });
+        }
+        else {
+            // Three-arg form: where("path", operator, value)
+            this.#conditions.push({
+                path: pathOrObject,
+                operator: operatorOrValue,
+                value,
+            });
+        }
+        return this;
+    }
+    whereIn(path, values) {
+        this.#conditions.push({
+            path,
+            operator: "in",
+            value: values.filter(Boolean),
+        });
+        return this;
+    }
+    whereNotIn(path, values) {
+        this.#conditions.push({ path, operator: "notIn", value: values });
+        return this;
+    }
+    whereGt(path, value) {
+        return this.where(path, "gt", value);
+    }
+    whereLt(path, value) {
+        return this.where(path, "lt", value);
+    }
+    whereGte(path, value) {
+        return this.where(path, "gte", value);
+    }
+    whereLte(path, value) {
+        return this.where(path, "lte", value);
+    }
+    whereContains(path, value) {
+        return this.where(path, "contains", value);
+    }
+    whereStartsWith(path, value) {
+        return this.where(path, "startsWith", value);
+    }
+    whereEndsWith(path, value) {
+        return this.where(path, "endsWith", value);
+    }
+    whereRegex(path, pattern) {
+        return this.where(path, "regex", pattern);
+    }
+    whereExists(path) {
+        return this.where(path, "exists", true);
+    }
+    whereNotExists(path) {
+        return this.where(path, "exists", false);
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query/query-builder.js.map

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

package/dist/query/query-dsl.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { Collection } from "../collection";
+import type { Condition } from "./query-builder";
+export declare const queryDSLSchema: z.ZodObject<{
+    model: z.ZodString;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>, z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        direction: z.ZodDefault<z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>>;
+    }, z.core.$strip>>]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    related: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    method: z.ZodDefault<z.ZodEnum<{
+        fetchAll: "fetchAll";
+        first: "first";
+        last: "last";
+        count: "count";
+    }>>;
+}, z.core.$strip>;
+export type QueryDSL = z.infer<typeof queryDSLSchema>;
+export declare function parseWhereClause(where: Record<string, unknown>): Condition[];
+export declare function parseSortClause(sort: unknown): Array<{
+    path: string;
+    direction: "asc" | "desc";
+}>;
+export declare function executeQueryDSL(collection: Collection, dsl: QueryDSL): Promise<Record<string, unknown> | Record<string, unknown>[] | null>;
+//# sourceMappingURL=query-dsl.d.ts.map

package/dist/query/query-dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dsl.d.ts","sourceRoot":"","sources":["../../src/query/query-dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;iBAYzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,SAAS,EAAE,CA+Cb;AAMD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,GACZ,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC,CAapD;AA6BD,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,QAAQ,uEA+Dd"}

package/dist/query/query-dsl.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { resolveModelDef } from "../cli/commands/api/helpers.js";
+// ---------------------------------------------------------------------------
+// Operator mapping: $dsl → internal
+// ---------------------------------------------------------------------------
+const OPERATOR_MAP = {
+    $eq: "eq",
+    $neq: "neq",
+    $in: "in",
+    $notIn: "notIn",
+    $gt: "gt",
+    $lt: "lt",
+    $gte: "gte",
+    $lte: "lte",
+    $contains: "contains",
+    $startsWith: "startsWith",
+    $endsWith: "endsWith",
+    $regex: "regex",
+    $exists: "exists",
+};
+const VALID_OPERATORS = new Set(Object.keys(OPERATOR_MAP));
+// ---------------------------------------------------------------------------
+// Security helpers
+// ---------------------------------------------------------------------------
+const FORBIDDEN_PATH_SEGMENTS = new Set([
+    "__proto__",
+    "constructor",
+    "prototype",
+]);
+const MAX_REGEX_LENGTH = 200;
+function validatePath(path) {
+    const segments = path.split(".");
+    for (const seg of segments) {
+        if (FORBIDDEN_PATH_SEGMENTS.has(seg)) {
+            throw new Error(`Forbidden path segment "${seg}" in "${path}"`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+const whereValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(z.unknown()),
+    z.record(z.string(), z.unknown()),
+]);
+const sortSchema = z.union([
+    z.record(z.string(), z.enum(["asc", "desc"])),
+    z.array(z.object({
+        path: z.string(),
+        direction: z.enum(["asc", "desc"]).default("asc"),
+    })),
+]);
+export const queryDSLSchema = z.object({
+    model: z.string(),
+    where: z.record(z.string(), whereValueSchema).optional(),
+    sort: sortSchema.optional(),
+    select: z.array(z.string()).optional(),
+    related: z.array(z.string()).optional(),
+    scopes: z.array(z.string()).optional(),
+    limit: z.number().int().min(0).optional(),
+    offset: z.number().int().min(0).optional(),
+    method: z
+        .enum(["fetchAll", "first", "last", "count"])
+        .default("fetchAll"),
+});
+// ---------------------------------------------------------------------------
+// Parser: where object → Condition[]
+// ---------------------------------------------------------------------------
+export function parseWhereClause(where) {
+    const conditions = [];
+    for (const [path, value] of Object.entries(where)) {
+        validatePath(path);
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            // Literal → implicit $eq
+            conditions.push({ path, operator: "eq", value });
+        }
+        else if (Array.isArray(value)) {
+            // Array → implicit $in
+            conditions.push({ path, operator: "in", value });
+        }
+        else if (typeof value === "object" && value !== null) {
+            // Operator object: { "$gt": 5, "$lte": 10 }
+            for (const [opKey, opValue] of Object.entries(value)) {
+                if (!VALID_OPERATORS.has(opKey)) {
+                    throw new Error(`Unknown operator: ${opKey}. Valid: ${[...VALID_OPERATORS].join(", ")}`);
+                }
+                const operator = OPERATOR_MAP[opKey];
+                // Regex length guard
+                if (operator === "regex" &&
+                    typeof opValue === "string" &&
+                    opValue.length > MAX_REGEX_LENGTH) {
+                    throw new Error(`Regex pattern exceeds maximum length of ${MAX_REGEX_LENGTH} characters`);
+                }
+                conditions.push({ path, operator, value: opValue });
+            }
+        }
+    }
+    return conditions;
+}
+// ---------------------------------------------------------------------------
+// Parser: sort clause → SortSpec[]
+// ---------------------------------------------------------------------------
+export function parseSortClause(sort) {
+    if (Array.isArray(sort)) {
+        return sort;
+    }
+    if (typeof sort === "object" && sort !== null) {
+        return Object.entries(sort).map(([path, direction]) => ({
+            path,
+            direction: direction,
+        }));
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Select helper
+// ---------------------------------------------------------------------------
+function applySelect(instance, select, related) {
+    const json = instance.toJSON({ related });
+    if (!select || select.length === 0)
+        return json;
+    const filtered = {};
+    for (const key of select) {
+        if (key in json) {
+            filtered[key] = json[key];
+        }
+        else if (key.startsWith("meta.") && json.meta) {
+            filtered[key] = json.meta[key.slice(5)];
+        }
+    }
+    return filtered;
+}
+// ---------------------------------------------------------------------------
+// Executor
+// ---------------------------------------------------------------------------
+export async function executeQueryDSL(collection, dsl) {
+    const def = resolveModelDef(collection, dsl.model);
+    if (!def) {
+        throw new Error(`Unknown model: ${dsl.model}`);
+    }
+    let q = collection.query(def);
+    // Apply scopes first
+    if (dsl.scopes) {
+        for (const name of dsl.scopes) {
+            q = q.scope(name);
+        }
+    }
+    // Apply where conditions
+    if (dsl.where) {
+        const conditions = parseWhereClause(dsl.where);
+        for (const cond of conditions) {
+            q = q.where(cond.path, cond.operator, cond.value);
+        }
+    }
+    // Apply sorts
+    if (dsl.sort) {
+        const sorts = parseSortClause(dsl.sort);
+        for (const { path, direction } of sorts) {
+            q = q.sort(path, direction);
+        }
+    }
+    // Apply pagination
+    if (dsl.limit !== undefined) {
+        q = q.limit(dsl.limit);
+    }
+    if (dsl.offset !== undefined) {
+        q = q.offset(dsl.offset);
+    }
+    // Execute based on method
+    switch (dsl.method) {
+        case "count":
+            return { count: await q.count() };
+        case "first": {
+            const result = await q.first();
+            return result ? applySelect(result, dsl.select, dsl.related) : null;
+        }
+        case "last": {
+            const result = await q.last();
+            return result ? applySelect(result, dsl.select, dsl.related) : null;
+        }
+        case "fetchAll":
+        default: {
+            const results = await q.fetchAll();
+            return results.map((instance) => applySelect(instance, dsl.select, dsl.related));
+        }
+    }
+}
+//# sourceMappingURL=query-dsl.js.map

package/dist/query/query-dsl.js.map

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

package/dist/relationships/belongs-to.d.ts

@@ -0,0 +1,9 @@
+import type { Document } from "../document";
+import type { Collection } from "../collection";
+import type { BelongsToDefinition, ModelDefinition, InferModelInstance, BelongsToAccessor, ModelInstanceFactory } from "../types";
+export declare class BelongsToRelationship<TTarget extends ModelDefinition<any, any, any, any, any>> implements BelongsToAccessor<TTarget> {
+    #private;
+    constructor(document: Document, collection: Collection, definition: BelongsToDefinition<TTarget>, factory: ModelInstanceFactory, sourceDef: ModelDefinition<any, any, any, any, any>);
+    fetch(): InferModelInstance<TTarget>;
+}
+//# sourceMappingURL=belongs-to.d.ts.map

package/dist/relationships/belongs-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"belongs-to.d.ts","sourceRoot":"","sources":["../../src/relationships/belongs-to.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,qBAAa,qBAAqB,CAChC,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CACxD,YAAW,iBAAiB,CAAC,OAAO,CAAC;;gBASnC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACxC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IASrD,KAAK,IAAI,kBAAkB,CAAC,OAAO,CAAC;CAuBrC"}