@browserlessapi/inferlo 0.0.0-stage → 0.4.0

package/dist/db/table.js

@@ -0,0 +1,274 @@
+/**
+ * Typed table clients: db.tickets.insert(...), db.tickets.findMany({ where: { status: "open" } }).
+ * Inserts and updates are always validated against the model, and every query is parameterised.
+ */
+import { InferloError, didYouMean, notFound } from "../errors.js";
+import { ValidationError } from "../schema.js";
+const OPS = ["eq", "ne", "gt", "gte", "lt", "lte", "in", "notIn", "like", "ilike", "isNull"];
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 1000;
+export class Table {
+    model;
+    #adapter;
+    #models;
+    constructor(model, adapter, models = [model]) {
+        this.model = model;
+        this.#adapter = adapter;
+        this.#models = models;
+    }
+    get #fields() {
+        return ["id", "createdAt", "updatedAt", ...Object.keys(this.model.fields)];
+    }
+    /** Validate and insert one row. Returns the stored row. */
+    async insert(data) {
+        const parsed = this.#validate(this.model.create, data, "insert");
+        const now = new Date();
+        const row = { id: crypto.randomUUID(), createdAt: now, updatedAt: now, ...parsed };
+        return (await this.#adapter().insert(this.model, row));
+    }
+    async insertMany(items) {
+        const out = [];
+        for (const item of items)
+            out.push(await this.insert(item));
+        return out;
+    }
+    /** Row by id, or null. */
+    async find(id, options = {}) {
+        const relations = this.#relations(options.include);
+        const rows = await this.#adapter().select(this.model, { where: [{ field: "id", op: "eq", value: id }], orderBy: [], limit: 1 });
+        await this.#load(rows, relations);
+        return rows[0] ?? null;
+    }
+    /** Row by id. Throws IL4001 (HTTP 404) when it does not exist. */
+    async get(id, options = {}) {
+        const row = await this.find(id, options);
+        if (!row)
+            throw notFound(`${singular(this.model.name)} ${id} was not found.`, { table: this.model.name, id });
+        return row;
+    }
+    /** First row matching where, or null. */
+    async findOne(where, options = {}) {
+        const rows = await this.findMany({ where, limit: 1, include: options.include });
+        return rows[0] ?? null;
+    }
+    /** Rows matching where. include: { owner: true } loads related rows with one extra query per relation. */
+    async findMany(options = {}) {
+        const relations = this.#relations(options.include);
+        const rows = await this.#adapter().select(this.model, this.#query(options));
+        await this.#load(rows, relations);
+        return rows;
+    }
+    /**
+     * Relations of this model. "one": a t.ref field <name>Id of this model (owner for ownerId).
+     * "many": a t.ref field <name>Id of another model that points here (tickets for tickets.ownerId,
+     * or ticketsByOwner when tickets has several such fields).
+     */
+    #available() {
+        const eligible = (m) => Object.entries(m.fields).filter(([field, schema]) => schema.def.kind === "ref" && field.length > 2 && field.endsWith("Id") && !(field.slice(0, -2) in m.fields));
+        const forward = [];
+        for (const [field, schema] of eligible(this.model)) {
+            const target = this.#models.find((m) => m.name === schema.def.refTable);
+            forward.push({ kind: "one", name: field.slice(0, -2), field, table: schema.def.refTable, target });
+        }
+        const taken = new Set([...this.#fields, ...forward.map((r) => r.name)]);
+        const reverse = [];
+        for (const m of this.#models) {
+            const fields = eligible(m).filter(([, schema]) => schema.def.refTable === this.model.name);
+            for (const [field] of fields) {
+                const relation = field.slice(0, -2);
+                const name = fields.length === 1 ? m.name : `${m.name}By${relation.charAt(0).toUpperCase()}${relation.slice(1)}`;
+                if (!taken.has(name))
+                    reverse.push({ kind: "many", name, field, table: m.name, target: m });
+            }
+        }
+        return [...forward, ...reverse];
+    }
+    /** The included relations. Unknown names raise IL4023. */
+    #relations(include) {
+        if (!include)
+            return [];
+        const available = this.#available();
+        const out = [];
+        for (const [name, wanted] of Object.entries(include)) {
+            if (wanted === undefined || wanted === false)
+                continue;
+            const relation = available.find((r) => r.name === name);
+            if (!relation || wanted !== true) {
+                const names = available.map((r) => r.name);
+                const ambiguous = available.filter((r) => r.kind === "many" && r.table === name);
+                throw new InferloError("IL4023", relation
+                    ? `include.${name} must be true or false.`
+                    : ambiguous.length
+                        ? `"${name}" has several t.ref fields to "${this.model.name}", so include.${name} is ambiguous.`
+                        : `"${this.model.name}" has no relation "${name}".${didYouMean(name, names)}`, {
+                    fix: ambiguous.length
+                        ? `Name the field: ${ambiguous.map((r) => `${r.name} (${name}.${r.field})`).join(", ")}. Use include: { ${ambiguous[0].name}: true }.`
+                        : names.length
+                            ? `Relations of "${this.model.name}": ${available.map(describeRelation).join(", ")}. Use include: { ${names[0]}: true }.`
+                            : `"${this.model.name}" has no relations. Add a t.ref field named <name>Id, e.g. ownerId: t.ref("users"), to include owner; models that reference "${this.model.name}" that way can be included by their table name.`,
+                });
+            }
+            if (!relation.target)
+                throw new InferloError("IL6005", `${this.model.name}.${relation.field} references "${relation.table}", which is not a registered model.`);
+            out.push(relation);
+        }
+        return out;
+    }
+    /** One query per relation: every referenced id at once, never one query per row. */
+    async #load(rows, relations) {
+        for (const relation of relations) {
+            const target = relation.target;
+            if (relation.kind === "many") {
+                const ids = [...new Set(rows.map((row) => row.id))];
+                const related = ids.length
+                    ? await this.#adapter().select(target, { where: [{ field: relation.field, op: "in", value: ids }], orderBy: [["createdAt", "asc"], ["id", "asc"]] })
+                    : [];
+                const byParent = new Map();
+                for (const r of related) {
+                    const list = byParent.get(r[relation.field]);
+                    if (list)
+                        list.push(r);
+                    else
+                        byParent.set(r[relation.field], [r]);
+                }
+                for (const row of rows)
+                    row[relation.name] = byParent.get(row.id) ?? [];
+                continue;
+            }
+            const ids = [...new Set(rows.map((row) => row[relation.field]).filter((id) => typeof id === "string"))];
+            const related = ids.length
+                ? await this.#adapter().select(target, { where: [{ field: "id", op: "in", value: ids }], orderBy: [], limit: ids.length })
+                : [];
+            const byId = new Map(related.map((r) => [r.id, r]));
+            for (const row of rows)
+                row[relation.name] = (typeof row[relation.field] === "string" ? byId.get(row[relation.field]) : undefined) ?? null;
+        }
+    }
+    async count(where = {}) {
+        return this.#adapter().count(this.model, this.#where(where));
+    }
+    /** Validate and update one row by id. Throws IL4001 (HTTP 404) when it does not exist. */
+    async update(id, patch) {
+        const parsed = this.#validate(this.model.update, patch, "update");
+        const rows = await this.#adapter().update(this.model, [{ field: "id", op: "eq", value: id }], { ...parsed, updatedAt: new Date() });
+        if (!rows[0])
+            throw notFound(`${singular(this.model.name)} ${id} was not found.`, { table: this.model.name, id });
+        return rows[0];
+    }
+    /** Update every row matching where. Returns the updated rows. */
+    async updateMany(where, patch) {
+        const conditions = this.#where(where);
+        const parsed = this.#validate(this.model.update, patch, "update");
+        return (await this.#adapter().update(this.model, conditions, { ...parsed, updatedAt: new Date() }));
+    }
+    /** Delete by id. Returns true if a row was deleted. */
+    async delete(id) {
+        return (await this.#adapter().delete(this.model, [{ field: "id", op: "eq", value: id }])) > 0;
+    }
+    /** Delete every row matching where. Refuses an empty where to prevent accidental wipes. */
+    async deleteMany(where) {
+        const conditions = this.#where(where);
+        if (!conditions.length) {
+            throw new InferloError("IL4007", `deleteMany() on "${this.model.name}" needs a where filter.`, {
+                fix: "Pass a filter, e.g. deleteMany({ status: \"closed\" }). To delete everything use deleteMany({ id: { isNull: false } }).",
+            });
+        }
+        return this.#adapter().delete(this.model, conditions);
+    }
+    #validate(schema, data, action) {
+        const result = schema.safeParse(data);
+        if (!result.ok)
+            throw new ValidationError(result.issues, `${singular(this.model.name)} ${action}`);
+        return result.value;
+    }
+    #checkField(field, where) {
+        if (!this.#fields.includes(field)) {
+            throw new InferloError("IL4003", `Unknown field "${field}" in ${where} on "${this.model.name}".${didYouMean(field, this.#fields)}`, {
+                fix: `Use one of: ${this.#fields.join(", ")}`,
+                status: 500,
+            });
+        }
+    }
+    #where(where = {}) {
+        const out = [];
+        for (const [field, value] of Object.entries(where)) {
+            if (value === undefined)
+                continue;
+            this.#checkField(field, "where");
+            if (value !== null && typeof value === "object" && !(value instanceof Date) && !Array.isArray(value)) {
+                for (const [op, operand] of Object.entries(value)) {
+                    if (operand === undefined)
+                        continue;
+                    if (!OPS.includes(op)) {
+                        throw new InferloError("IL4003", `Unknown operator "${op}" for "${field}".${didYouMean(op, OPS)}`, {
+                            fix: `Operators: ${OPS.join(", ")}`,
+                        });
+                    }
+                    out.push({ field, op: op, value: operand });
+                }
+            }
+            else if (value === null) {
+                out.push({ field, op: "isNull", value: true });
+            }
+            else {
+                out.push({ field, op: "eq", value });
+            }
+        }
+        return out;
+    }
+    #query(options) {
+        const orderBy = [];
+        const raw = options.orderBy;
+        const entries = Array.isArray(raw) ? raw : Object.entries(raw ?? {});
+        for (const [field, direction] of entries) {
+            this.#checkField(field, "orderBy");
+            if (direction !== "asc" && direction !== "desc") {
+                throw new InferloError("IL4003", `orderBy direction for "${field}" must be "asc" or "desc".`);
+            }
+            orderBy.push([field, direction]);
+        }
+        const limit = Math.min(Math.max(0, Math.floor(options.limit ?? DEFAULT_LIMIT)), MAX_LIMIT);
+        const offset = Math.max(0, Math.floor(options.offset ?? 0));
+        return { where: this.#where(options.where), orderBy, limit, offset };
+    }
+}
+function describeRelation(r) {
+    return r.kind === "one" ? `${r.name} (${r.field})` : `${r.name} (${r.table}.${r.field})`;
+}
+function singular(name) {
+    const word = name.endsWith("ies") ? name.slice(0, -3) + "y" : name.endsWith("s") ? name.slice(0, -1) : name;
+    return word.charAt(0).toUpperCase() + word.slice(1).replace(/_/g, " ");
+}
+export function createDb(models, adapter) {
+    const build = (current) => {
+        const db = {};
+        for (const m of models)
+            db[m.name] = new Table(m, () => current, models);
+        const helpers = {
+            $adapter: current,
+            $sync: (options) => current.sync([...models], options),
+            $transaction: async (fn) => (current.transaction ? current.transaction((tx) => fn(build(tx))) : fn(build(current))),
+            $sql: async (text, params) => {
+                if (!current.sql)
+                    throw new InferloError("IL4008", `Raw SQL is not supported by the ${current.dialect} adapter.`, { fix: "Use postgres() from @browserlessapi/inferlo/postgres." });
+                return current.sql(text, params);
+            },
+            $close: async () => current.close?.(),
+        };
+        Object.assign(db, helpers);
+        return new Proxy(db, {
+            get(target, prop) {
+                if (typeof prop === "string" && !(prop in target) && !prop.startsWith("$") && prop !== "then" && prop !== "toJSON") {
+                    const names = models.map((m) => m.name);
+                    throw new InferloError("IL4002", `db.${prop} does not exist.${didYouMean(prop, names)}`, {
+                        fix: `Registered tables: ${names.join(", ") || "(none)"}. Add the model to createApp({ models: [...] }).`,
+                    });
+                }
+                return Reflect.get(target, prop);
+            },
+        });
+    };
+    adapter.connect?.([...models]);
+    return build(adapter);
+}
+//# sourceMappingURL=table.js.map

package/dist/db/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/db/table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAqG/C,MAAM,GAAG,GAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnG,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,MAAM,OAAO,KAAK;IACP,KAAK,CAAI;IAClB,QAAQ,CAAgB;IACxB,OAAO,CAAsB;IAE7B,YAAY,KAAQ,EAAE,OAAsB,EAAE,SAA8B,CAAC,KAAK,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,MAAM,CAAC,IAAoB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QACnF,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAW,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuB;QACtC,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,IAAI,CAA0C,EAAU,EAAE,UAA0B,EAAE;QAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAChI,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,OAAQ,IAAI,CAAC,CAAC,CAA+B,IAAI,IAAI,CAAC;IACxD,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,GAAG,CAA0C,EAAU,EAAE,UAA0B,EAAE;QACzF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,MAAM,QAAQ,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9G,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,OAAO,CAA0C,KAAoB,EAAE,UAA0B,EAAE;QACvG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACzB,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,QAAQ,CAA0C,UAAoD,EAAE;QAC5G,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,IAAmC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,MAAM,QAAQ,GAAG,CAAC,CAAW,EAAE,EAAE,CAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAmC,CAAC,CAAC,MAAM,CAC1D,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAChI,CAAC;QACJ,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,QAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3F,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,0DAA0D;IAC1D,UAAU,CAAC,OAA2B;QACpC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK;gBAAE,SAAS;YACvD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;gBACjF,MAAM,IAAI,YAAY,CACpB,QAAQ,EACR,QAAQ;oBACN,CAAC,CAAC,WAAW,IAAI,yBAAyB;oBAC1C,CAAC,CAAC,SAAS,CAAC,MAAM;wBAChB,CAAC,CAAC,IAAI,IAAI,kCAAkC,IAAI,CAAC,KAAK,CAAC,IAAI,iBAAiB,IAAI,gBAAgB;wBAChG,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,sBAAsB,IAAI,KAAK,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EACjF;oBACE,GAAG,EAAE,SAAS,CAAC,MAAM;wBACnB,CAAC,CAAC,mBAAmB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,WAAW;wBACvI,CAAC,CAAC,KAAK,CAAC,MAAM;4BACZ,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,CAAC,CAAC,WAAW;4BACzH,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,gIAAgI,IAAI,CAAC,KAAK,CAAC,IAAI,iDAAiD;iBAC1N,CACF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,gBAAgB,QAAQ,CAAC,KAAK,qCAAqC,CAAC,CAAC;YAChK,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,KAAK,CAAC,IAAgB,EAAE,SAAqB;QACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAO,CAAC;YAChC,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAY,CAAC,CAAC,CAAC,CAAC;gBAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM;oBACxB,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;oBACpJ,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;gBAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAW,CAAC,CAAC;oBACvD,IAAI,IAAI;wBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;wBAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtD,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,IAAI;oBAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAY,CAAC,IAAI,EAAE,CAAC;gBAClF,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtH,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM;gBACxB,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC1H,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QACvJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAuB,EAAE;QACnC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAqB;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACpI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,MAAM,QAAQ,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAClH,OAAO,IAAI,CAAC,CAAC,CAAW,CAAC;IAC3B,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,UAAU,CAAC,KAAoB,EAAE,KAAqB;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClE,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAa,CAAC;IAClH,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChG,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,UAAU,CAAC,KAAoB;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,oBAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,yBAAyB,EAAE;gBAC7F,GAAG,EAAE,yHAAyH;aAC/H,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,MAAkG,EAAE,IAAa,EAAE,MAAc;QACzI,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACnG,OAAO,MAAM,CAAC,KAAiB,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,KAAa;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,kBAAkB,KAAK,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE;gBAClI,GAAG,EAAE,eAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC7C,MAAM,EAAE,GAAG;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAoB,EAAE;QAC3B,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrG,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClD,IAAI,OAAO,KAAK,SAAS;wBAAE,SAAS;oBACpC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAQ,CAAC,EAAE,CAAC;wBAC5B,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,qBAAqB,EAAE,UAAU,KAAK,KAAK,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE;4BACjG,GAAG,EAAE,cAAc,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;yBACpC,CAAC,CAAC;oBACL,CAAC;oBACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAC,OAA6B;QAClC,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,OAA6B,EAAE,CAAC;YAC/D,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACnC,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gBAChD,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,0BAA0B,KAAK,4BAA4B,CAAC,CAAC;YAChG,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACvE,CAAC;CACF;AAWD,SAAS,gBAAgB,CAAC,CAAW;IACnC,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC;AAC3F,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5G,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC;AAiBD,MAAM,UAAU,QAAQ,CAA2C,MAAc,EAAE,OAAgB;IACjG,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAc,EAAE;QAC7C,MAAM,EAAE,GAA4B,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,OAAO,GAAc;YACzB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC;YACtD,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACnH,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;gBAC3B,IAAI,CAAC,OAAO,CAAC,GAAG;oBAAE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,mCAAmC,OAAO,CAAC,OAAO,WAAW,EAAE,EAAE,GAAG,EAAE,uDAAuD,EAAE,CAAC,CAAC;gBACpL,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE;SACtC,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;YACnB,GAAG,CAAC,MAAM,EAAE,IAAI;gBACd,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACxC,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,mBAAmB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;wBACvF,GAAG,EAAE,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,kDAAkD;qBAC1G,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;SACF,CAAe,CAAC;IACnB,CAAC,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC"}

package/dist/db/types.d.ts

@@ -0,0 +1,36 @@
+import type { AnyModel } from "../model.ts";
+export type Op = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "like" | "ilike" | "isNull";
+export interface Condition {
+    field: string;
+    op: Op;
+    value: unknown;
+}
+export interface Query {
+    where: Condition[];
+    orderBy: [field: string, direction: "asc" | "desc"][];
+    limit?: number;
+    offset?: number;
+}
+export type DbRecord = Record<string, unknown>;
+/**
+ * Storage backend. Inferlo ships memory() and postgres(). Adapters receive validated,
+ * already-normalised data with camelCase field names.
+ */
+export interface Adapter {
+    readonly dialect: string;
+    connect?(models: AnyModel[]): Promise<void> | void;
+    insert(model: AnyModel, row: DbRecord): Promise<DbRecord>;
+    select(model: AnyModel, query: Query): Promise<DbRecord[]>;
+    update(model: AnyModel, where: Condition[], patch: DbRecord): Promise<DbRecord[]>;
+    delete(model: AnyModel, where: Condition[]): Promise<number>;
+    count(model: AnyModel, where: Condition[]): Promise<number>;
+    /** Create missing tables, columns and indexes. Returns the statements it ran (or would run). */
+    sync(models: AnyModel[], options?: {
+        dryRun?: boolean;
+    }): Promise<string[]>;
+    /** Run fn inside a transaction, passing an adapter bound to it. */
+    transaction?<T>(fn: (tx: Adapter) => Promise<T>): Promise<T>;
+    /** Raw parameterised SQL (Postgres only). */
+    sql?(text: string, params?: unknown[]): Promise<DbRecord[]>;
+    close?(): Promise<void>;
+}

package/dist/db/types.js

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

package/dist/db/types.js.map

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

package/dist/describe.d.ts

@@ -0,0 +1,74 @@
+/**
+ * describe() returns a machine-readable map of the whole app. AI coding agents read it
+ * (inferlo describe --json) instead of searching the codebase.
+ */
+import type { App } from "./app.ts";
+import type { JSONSchema } from "./schema.ts";
+export interface FieldDescription {
+    type: string;
+    required: boolean;
+    nullable: boolean;
+    default?: unknown;
+    unique?: boolean;
+    index?: boolean;
+    references?: string;
+    values?: readonly unknown[];
+    column: string;
+    description?: string;
+}
+export interface AppDescription {
+    inferlo: string;
+    name: string;
+    version: string;
+    description?: string;
+    database: string;
+    auth: boolean;
+    endpoints: {
+        openapi: string | false;
+        mcp: string | false;
+    };
+    models: {
+        name: string;
+        fields: Record<string, FieldDescription>;
+    }[];
+    routes: {
+        name?: string;
+        method: string;
+        path: string;
+        auth: string;
+        summary?: string;
+        tool?: string;
+        rateLimit?: {
+            max: number;
+            per: string;
+            by: string;
+        };
+        params?: JSONSchema;
+        query?: JSONSchema;
+        body?: JSONSchema;
+    }[];
+    ai: {
+        configured: boolean;
+        aliases: Record<string, string[]>;
+    };
+    jobs: {
+        name: string;
+        summary?: string;
+        retries: number;
+        input: JSONSchema;
+    }[];
+    /** Schedules from cron(schedule, job), in UTC. */
+    crons: {
+        schedule: string;
+        job: string;
+    }[];
+    /** Where queued jobs are kept. */
+    jobQueue: "memory" | "database";
+}
+export declare const INFERLO_VERSION = "0.4.0";
+export declare function describeApp(app: App<any>, options: {
+    auth: boolean;
+    openapi: string | false;
+    mcp: string | false;
+    description?: string;
+}): AppDescription;

package/dist/describe.js

@@ -0,0 +1,69 @@
+import { toolName } from "./mcp.js";
+import { columnName } from "./model.js";
+export const INFERLO_VERSION = "0.4.0";
+function field(name, schema) {
+    const d = schema.def;
+    const out = {
+        type: d.kind,
+        required: !d.optional && !d.hasDefault,
+        nullable: d.nullable,
+        column: columnName(name),
+    };
+    if (d.hasDefault)
+        out.default = typeof d.defaultValue === "function" ? "(function)" : d.defaultValue;
+    if (d.unique)
+        out.unique = true;
+    if (d.index)
+        out.index = true;
+    if (d.refTable)
+        out.references = d.refTable;
+    if (d.values && d.kind === "enum")
+        out.values = d.values;
+    if (d.description)
+        out.description = d.description;
+    return out;
+}
+export function describeApp(app, options) {
+    return {
+        inferlo: INFERLO_VERSION,
+        name: app.name,
+        version: app.version,
+        description: options.description,
+        database: app.db.$adapter.dialect,
+        auth: options.auth,
+        endpoints: { openapi: options.openapi, mcp: options.mcp },
+        models: app.models.map((m) => ({
+            name: m.name,
+            fields: Object.fromEntries([
+                ["id", { type: "uuid", required: false, nullable: false, column: "id", description: "Set automatically" }],
+                ...Object.entries(m.fields).map(([k, s]) => [k, field(k, s)]),
+                ["createdAt", { type: "date", required: false, nullable: false, column: "created_at", description: "Set automatically" }],
+                ["updatedAt", { type: "date", required: false, nullable: false, column: "updated_at", description: "Set automatically" }],
+            ]),
+        })),
+        routes: app.routes.map((r) => {
+            const o = r.options;
+            const out = { method: r.method, path: r.path, auth: o.auth ?? "user" };
+            if (r.name)
+                out.name = r.name;
+            if (o.summary)
+                out.summary = o.summary;
+            if (o.tool)
+                out.tool = toolName(r);
+            if (o.rateLimit)
+                out.rateLimit = { max: o.rateLimit.max, per: o.rateLimit.per, by: o.rateLimit.by ?? "user" };
+            if (o.params)
+                out.params = o.params.toJSONSchema();
+            if (o.query)
+                out.query = o.query.toJSONSchema();
+            if (o.body)
+                out.body = o.body.toJSONSchema();
+            return out;
+        }),
+        ai: { configured: app.ai.configured, aliases: app.ai.aliases },
+        jobQueue: app.jobs.queue,
+        crons: app.jobs.crons.map((c) => ({ schedule: c.schedule, job: c.job.name })),
+        jobs: app.jobs.list.map((j) => ({ name: j.name, ...(j.options.summary ? { summary: j.options.summary } : {}), retries: j.options.retries ?? 3, input: j.options.input.toJSONSchema() })),
+    };
+}
+//# sourceMappingURL=describe.js.map

package/dist/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA6CxC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,SAAS,KAAK,CAAC,IAAY,EAAE,MAAiB;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;IACrB,MAAM,GAAG,GAAqB;QAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,UAAU;QACtC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;KACzB,CAAC;IACF,IAAI,CAAC,CAAC,UAAU;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACrG,IAAI,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,CAAC,KAAK;QAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,CAAC,QAAQ;QAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,IAAI,CAAC,CAAC,WAAW;QAAE,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAa,EAAE,OAA8F;IACvI,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QACzD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAsD,EAAE,EAAE,CAAC,CAAC;YAClF,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;gBACzB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;gBAC1G,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC7D,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;gBACzH,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;aAC1H,CAAC;SACH,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;YACpB,MAAM,GAAG,GAAqC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;YACzG,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YAC9B,IAAI,CAAC,CAAC,OAAO;gBAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,CAAC,SAAS;gBAAE,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;YAC9G,IAAI,CAAC,CAAC,MAAM;gBAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACnD,IAAI,CAAC,CAAC,KAAK;gBAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YAChD,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7C,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QACF,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE;QAC9D,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;QACxB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;KACzL,CAAC;AACJ,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,19 @@
+/** Use a fixed set of variables (tests, Cloudflare Workers bindings). */
+export declare function setEnv(values: Record<string, string | undefined> | undefined): void;
+interface EnvFn {
+    (name: string): string;
+    (name: string, options: {
+        default: string;
+    }): string;
+    (name: string, options: {
+        optional: true;
+    }): string | undefined;
+    int(name: string, options?: {
+        default?: number;
+    }): number;
+    bool(name: string, options?: {
+        default?: boolean;
+    }): boolean;
+}
+export declare const env: EnvFn;
+export {};

package/dist/env.js

@@ -0,0 +1,72 @@
+/**
+ * Read environment variables on Node, Bun, Deno and Workers, with clear errors.
+ *
+ *   env("DATABASE_URL")                  // required string
+ *   env("PORT", { default: "3000" })     // optional with default
+ *   env.int("PORT", { default: 3000 })
+ *   env.bool("DEBUG", { default: false })
+ */
+import { InferloError } from "./errors.js";
+let overrides;
+/** Use a fixed set of variables (tests, Cloudflare Workers bindings). */
+export function setEnv(values) {
+    overrides = values;
+}
+function read(name) {
+    if (overrides && name in overrides)
+        return overrides[name];
+    const g = globalThis;
+    if (g.process?.env)
+        return g.process.env[name];
+    if (g.Deno) {
+        try {
+            return g.Deno.env.get(name);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function missing(name) {
+    return new InferloError("IL7001", `Environment variable ${name} is not set.`, {
+        fix: `Set ${name} in your environment or .env file, or pass a default: env("${name}", { default: "..." }).`,
+    });
+}
+export const env = Object.assign((name, options = {}) => {
+    const value = read(name);
+    if (value !== undefined && value !== "")
+        return value;
+    if (options.default !== undefined)
+        return options.default;
+    if (options.optional)
+        return undefined;
+    throw missing(name);
+}, {
+    int(name, options = {}) {
+        const value = read(name);
+        if (value === undefined || value === "") {
+            if (options.default !== undefined)
+                return options.default;
+            throw missing(name);
+        }
+        const n = Number(value);
+        if (!Number.isInteger(n))
+            throw new InferloError("IL7002", `Environment variable ${name} must be a whole number, got "${value}".`);
+        return n;
+    },
+    bool(name, options = {}) {
+        const value = read(name)?.toLowerCase();
+        if (value === undefined || value === "") {
+            if (options.default !== undefined)
+                return options.default;
+            throw missing(name);
+        }
+        if (["1", "true", "yes", "on"].includes(value))
+            return true;
+        if (["0", "false", "no", "off"].includes(value))
+            return false;
+        throw new InferloError("IL7002", `Environment variable ${name} must be true or false, got "${value}".`);
+    },
+});
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Every error Inferlo raises has a stable code, a plain cause, a suggested fix and a docs link.
+ * Error codes never change meaning once released, so AI models and humans can rely on them.
+ */
+export declare const DOCS_BASE = "https://github.com/BrowserlessAPI/Inferlo/blob/main/docs/errors.md";
+export declare function docsUrl(code: string): string;
+export interface InferloErrorOptions {
+    status?: number;
+    fix?: string;
+    details?: unknown;
+    cause?: unknown;
+    /** Set to false to hide the message from API clients (it is still logged). */
+    expose?: boolean;
+}
+export declare class InferloError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly fix: string | undefined;
+    readonly details: unknown;
+    readonly expose: boolean;
+    constructor(code: string, message: string, options?: InferloErrorOptions);
+    get docs(): string;
+    toJSON(): {
+        error: Record<string, unknown>;
+    };
+    /** Multi-line text for terminals and logs. */
+    format(): string;
+}
+/** Throw from a handler to return an HTTP error with your own code and message. */
+export declare function httpError(status: number, message: string, options?: {
+    code?: string;
+    fix?: string;
+    details?: unknown;
+}): InferloError;
+export declare function notFound(message?: string, details?: unknown): InferloError;
+export declare function forbidden(message?: string): InferloError;
+export declare function badRequest(message: string, details?: unknown): InferloError;
+/** Closest candidate by edit distance, used for "did you mean" hints. */
+export declare function suggest(input: string, candidates: Iterable<string>): string | undefined;
+export declare function didYouMean(input: string, candidates: Iterable<string>): string;