@weave-kit/engine 0.1.0

package/dist/runtime/data-access/builder.js

@@ -0,0 +1,203 @@
+import { SchemaError } from "../../core/index.js";
+import { DETAILS_COLUMNS } from "../../core/index.js";
+import { FIELD_TYPES } from "../../core/index.js";
+import { FILTER_OPS, PAGINATION } from "./values.js";
+const q = (id) => `"${id}"`;
+const PARENT_COLUMNS = new Set(Object.values(DETAILS_COLUMNS));
+/** renumber a parameterized fragment (`$1..$k`) to start after `offset` already-used params */
+export function scopeSuffix(scope, offset) {
+    if (offset === 0)
+        return scope;
+    return {
+        sql: scope.sql.replace(/\$\d+/g, (m) => `$${Number(m.slice(1)) + offset}`),
+        params: scope.params,
+    };
+}
+function fail(ctx, field) {
+    throw new SchemaError("data.field.unknown", { object: ctx.object, field }, ctx.locale);
+}
+function isArrayColumn(field) {
+    return (field.type === FIELD_TYPES.MULTI_RELATION ||
+        (field.type === FIELD_TYPES.ENUM && field.multiple === true) ||
+        (field.type === FIELD_TYPES.IMAGE && field.multiple === true));
+}
+const FILTER_OP_VALUES = Object.values(FILTER_OPS);
+function isFilterValue(v) {
+    return (typeof v === "object" &&
+        v !== null &&
+        !Array.isArray(v) &&
+        Object.keys(v).length > 0 &&
+        Object.keys(v).every((k) => FILTER_OP_VALUES.includes(k)));
+}
+function fieldOf(object, name) {
+    return object.fields.find((f) => f.name === name);
+}
+function isKnown(object, ctx, name) {
+    const field = fieldOf(object, name);
+    if (field !== undefined && field.type !== FIELD_TYPES.DETAILS)
+        return true;
+    return ctx.allowParentCols === true && PARENT_COLUMNS.has(name);
+}
+function conditionSql(field, op, value, idx) {
+    const col = q(field.name);
+    const p = `$${idx}`;
+    switch (op) {
+        case FILTER_OPS.EQ:
+            return { sql: `${col} = ${p}`, params: [value] };
+        case FILTER_OPS.NE:
+            return { sql: `${col} <> ${p}`, params: [value] };
+        case FILTER_OPS.GT:
+            return { sql: `${col} > ${p}`, params: [value] };
+        case FILTER_OPS.GTE:
+            return { sql: `${col} >= ${p}`, params: [value] };
+        case FILTER_OPS.LT:
+            return { sql: `${col} < ${p}`, params: [value] };
+        case FILTER_OPS.LTE:
+            return { sql: `${col} <= ${p}`, params: [value] };
+        case FILTER_OPS.IN:
+            return { sql: `${col} = ANY(${p})`, params: [value] };
+        case FILTER_OPS.CONTAINS:
+            return { sql: `${col} @> ${p}::text[]`, params: [value] };
+        case FILTER_OPS.LIKE:
+            return { sql: `${col} ILIKE ${p}`, params: [`%${value}%`] };
+    }
+}
+/**
+ * Build one field condition and append its params. Returns `''` when the
+ * condition must be skipped (multi-operator on one field, or `contains` on a
+ * non-array column); unknown fields throw via `fail`.
+ */
+function buildFieldClause(object, name, rawValue, ctx, params) {
+    if (!isKnown(object, ctx, name))
+        fail(ctx, name);
+    const field = fieldOf(object, name);
+    // parent_* columns have no field definition; treat as plain string columns
+    const effective = field ??
+        { name, type: FIELD_TYPES.STRING };
+    // `rawValue` is either a bare scalar (`eq`) or a `FilterValue` object of one
+    // or more operators on the same field. Multiple operators are AND'd together,
+    // which is how a date/time range (`{ gte, lte }`) is expressed.
+    let ops;
+    if (isFilterValue(rawValue)) {
+        ops = Object.entries(rawValue);
+        for (const [op] of ops) {
+            if (op === FILTER_OPS.CONTAINS && !isArrayColumn(effective))
+                return "";
+        }
+    }
+    else {
+        ops = [[FILTER_OPS.EQ, rawValue]];
+    }
+    const baseIdx = params.length + 1;
+    const pieces = [];
+    for (const [op, value] of ops) {
+        const { sql, params: p } = conditionSql(effective, op, value, baseIdx + pieces.length);
+        pieces.push(sql);
+        params.push(...p);
+    }
+    if (pieces.length === 0)
+        return "";
+    return pieces.length === 1 ? pieces[0] : `(${pieces.join(" AND ")})`;
+}
+/** build the WHERE clause (including leading "WHERE" when non-empty); rowScope is AND'd last */
+export function buildWhere(object, filter, ctx, rowScope) {
+    const clauses = [];
+    const params = [];
+    if (filter !== undefined) {
+        const orGroups = filter.$or;
+        if (orGroups !== undefined && orGroups.length > 0) {
+            const orClauses = [];
+            for (const group of orGroups) {
+                const inner = [];
+                for (const [name, rawValue] of Object.entries(group)) {
+                    const sql = buildFieldClause(object, name, rawValue, ctx, params);
+                    if (sql !== "")
+                        inner.push(sql);
+                }
+                if (inner.length > 0)
+                    orClauses.push(`(${inner.join(" AND ")})`);
+            }
+            if (orClauses.length > 0)
+                clauses.push(`(${orClauses.join(" OR ")})`);
+        }
+        for (const [name, rawValue] of Object.entries(filter)) {
+            if (name === "$or")
+                continue;
+            const sql = buildFieldClause(object, name, rawValue, ctx, params);
+            if (sql !== "")
+                clauses.push(sql);
+        }
+    }
+    if (rowScope !== undefined) {
+        const scope = scopeSuffix(rowScope, params.length);
+        clauses.push(`(${scope.sql})`);
+        params.push(...scope.params);
+    }
+    return {
+        sql: clauses.length === 0 ? "" : `WHERE ${clauses.join(" AND ")}`,
+        params,
+    };
+}
+/** build ORDER BY clause (empty when no sort) */
+export function buildOrderBy(object, sort, ctx) {
+    if (sort === undefined || sort.length === 0)
+        return "";
+    const parts = [];
+    for (const s of sort) {
+        if (!isKnown(object, ctx, s.field))
+            fail(ctx, s.field);
+        parts.push(`${q(s.field)} ${s.dir.toUpperCase()}`);
+    }
+    return ` ORDER BY ${parts.join(", ")}`;
+}
+/** build SELECT columns (whitelist projection, defaults to all model columns + parent_* for children) */
+export function buildColumns(object, fields, ctx, exclude) {
+    const modelCols = object.fields
+        .filter((f) => f.type !== FIELD_TYPES.DETAILS)
+        .map((f) => f.name);
+    const allCols = [
+        ...modelCols,
+        ...(ctx.allowParentCols === true ? [...PARENT_COLUMNS] : []),
+    ];
+    const isExcluded = (name) => exclude !== undefined && exclude.includes(name);
+    if (fields === undefined) {
+        return allCols
+            .filter((c) => !isExcluded(c))
+            .map(q)
+            .join(", ");
+    }
+    for (const name of fields) {
+        if (!allCols.includes(name))
+            fail(ctx, name);
+    }
+    return fields
+        .filter((c) => !isExcluded(c))
+        .map(q)
+        .join(", ");
+}
+/** resolve pagination with defaults/caps */
+export function resolvePagination(opts) {
+    const limit = Math.min(opts.limit ?? PAGINATION.DEFAULT_LIMIT, PAGINATION.MAX_LIMIT);
+    const offset = Math.max(opts.offset ?? PAGINATION.DEFAULT_OFFSET, 0);
+    return { limit, offset };
+}
+/** full SELECT query */
+export function buildFindSql(object, opts, ctx, rowScope, exclude) {
+    const table = q(object.name);
+    const cols = buildColumns(object, opts.fields, ctx, exclude);
+    const { sql: where, params } = buildWhere(object, opts.filter, ctx, rowScope);
+    const orderBy = buildOrderBy(object, opts.sort, ctx);
+    const { limit, offset } = resolvePagination(opts);
+    const sql = `SELECT ${cols} FROM ${table} ${where}${orderBy} LIMIT $${params.length + 1} OFFSET $${params.length + 2}`;
+    return { sql, params: [...params, limit, offset] };
+}
+/** COUNT query for total (same filter, no sort/pagination) */
+export function buildCountSql(object, opts, ctx, rowScope) {
+    const table = q(object.name);
+    const { sql: where, params } = buildWhere(object, opts.filter, ctx, rowScope);
+    return {
+        sql: `SELECT COUNT(*)::int AS total FROM ${table} ${where}`,
+        params,
+    };
+}
+//# sourceMappingURL=builder.js.map

package/dist/runtime/data-access/builder.js.map

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

package/dist/runtime/data-access/details.d.ts

@@ -0,0 +1,10 @@
+import type { Locale, ObjectDefinition, ObjectRegistry } from '../../core/index.js';
+import type { Queryable } from './types.js';
+/**
+ * Insert nested details rows on parent create. Auto-fills parent_id/parent_type/
+ * parent_idx; each child row is validated against the child object definition.
+ */
+export declare function insertDetails(db: Queryable, parent: ObjectDefinition, parentPk: unknown, data: Record<string, unknown>, registry: ObjectRegistry, locale?: Locale): Promise<void>;
+/** delete all child rows of a parent (cascade on parent delete) */
+export declare function deleteDetailsChildren(db: Queryable, parent: ObjectDefinition, parentPk: unknown, registry: ObjectRegistry): Promise<void>;
+//# sourceMappingURL=details.d.ts.map

package/dist/runtime/data-access/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/runtime/data-access/details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc5C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/runtime/data-access/details.js

@@ -0,0 +1,56 @@
+import { SchemaError } from '../../core/index.js';
+import { DETAILS_COLUMNS, FIELD_TYPES } from '../../core/index.js';
+import { validateRecord } from './validate.js';
+import { WRITE_MODES } from './values.js';
+const q = (id) => `"${id}"`;
+function detailsFields(object) {
+    return object.fields.filter((f) => f.type === FIELD_TYPES.DETAILS);
+}
+function childDef(registry, target) {
+    return registry.get(target);
+}
+/**
+ * Insert nested details rows on parent create. Auto-fills parent_id/parent_type/
+ * parent_idx; each child row is validated against the child object definition.
+ */
+export async function insertDetails(db, parent, parentPk, data, registry, locale) {
+    for (const df of detailsFields(parent)) {
+        const rows = data[df.name];
+        if (rows === undefined)
+            continue;
+        if (!Array.isArray(rows)) {
+            throw new SchemaError('data.field.type', { object: parent.name, field: df.name, type: 'details array' }, locale);
+        }
+        const child = childDef(registry, df.target);
+        if (child === undefined)
+            continue;
+        const table = child.name;
+        const modelCols = child.fields.filter((f) => f.type !== FIELD_TYPES.DETAILS).map((f) => f.name);
+        const cols = [...modelCols, DETAILS_COLUMNS.PARENT_ID, DETAILS_COLUMNS.PARENT_TYPE, DETAILS_COLUMNS.PARENT_IDX];
+        for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            if (typeof row !== 'object' || row === null || Array.isArray(row)) {
+                throw new SchemaError('data.field.type', { object: parent.name, field: df.name, type: 'details array' }, locale);
+            }
+            const record = row;
+            record[DETAILS_COLUMNS.PARENT_ID] = parentPk;
+            record[DETAILS_COLUMNS.PARENT_TYPE] = parent.name;
+            record[DETAILS_COLUMNS.PARENT_IDX] = i + 1;
+            await validateRecord(child, record, WRITE_MODES.CREATE, { pool: db, registry, locale });
+            const values = [...modelCols.map((c) => record[c] ?? null), parentPk, parent.name, i + 1];
+            const placeholders = cols.map((_, idx) => `$${idx + 1}`).join(', ');
+            await db.query(`INSERT INTO ${q(table)} (${cols.map(q).join(', ')}) VALUES (${placeholders})`, values);
+        }
+    }
+}
+/** delete all child rows of a parent (cascade on parent delete) */
+export async function deleteDetailsChildren(db, parent, parentPk, registry) {
+    for (const df of detailsFields(parent)) {
+        const child = childDef(registry, df.target);
+        if (child === undefined)
+            continue;
+        const table = child.name;
+        await db.query(`DELETE FROM ${q(table)} WHERE ${q(DETAILS_COLUMNS.PARENT_ID)} = $1 AND ${q(DETAILS_COLUMNS.PARENT_TYPE)} = $2`, [parentPk, parent.name]);
+    }
+}
+//# sourceMappingURL=details.js.map

package/dist/runtime/data-access/details.js.map

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

package/dist/runtime/data-access/formula.d.ts

@@ -0,0 +1,8 @@
+import type { ObjectDefinition, ObjectRegistry } from '../../core/index.js';
+import type { Queryable } from './types.js';
+/**
+ * Evaluate all formula fields of an object against a record (mutating it),
+ * resolving cross-object references and details aggregations via PG.
+ */
+export declare function computeFormulas(object: ObjectDefinition, record: Record<string, unknown>, db: Queryable, registry: ObjectRegistry, now: Date): Promise<void>;
+//# sourceMappingURL=formula.d.ts.map

package/dist/runtime/data-access/formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../../src/runtime/data-access/formula.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA4G5C;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/runtime/data-access/formula.js

@@ -0,0 +1,101 @@
+import { DETAILS_COLUMNS, FIELD_TYPES, primaryKeyOf } from '../../core/index.js';
+import { evaluate, extractRefs, parseFormula } from '../../core/index.js';
+const q = (id) => `"${id}"`;
+/** resolve a cross-object field reference (relation target field), or null */
+async function resolveRefValue(object, parent, name, record, db, registry) {
+    const parentField = object.fields.find((f) => f.name === parent);
+    if (parentField === undefined || parentField.type !== FIELD_TYPES.RELATION)
+        return null;
+    const fk = record[parent];
+    if (fk === null || fk === undefined)
+        return null;
+    const target = registry.get(parentField.target);
+    if (target === undefined)
+        return null;
+    const table = target.name;
+    const pk = primaryKeyOf(target);
+    if (pk === undefined)
+        return null;
+    const res = await db.query(`SELECT ${q(name)} FROM ${q(table)} WHERE ${q(pk)} = $1`, [fk]);
+    const row = res.rows[0];
+    return row === undefined ? null : (row[name] ?? null);
+}
+/** resolve details aggregation values for a child field (name = null for COUNT) */
+async function resolveAggregateValue(object, parent, name, record, db, registry) {
+    const parentField = object.fields.find((f) => f.name === parent);
+    if (parentField === undefined || parentField.type !== FIELD_TYPES.DETAILS)
+        return [];
+    const child = registry.get(parentField.target);
+    if (child === undefined)
+        return [];
+    const pk = primaryKeyOf(object);
+    if (pk === undefined)
+        return [];
+    const pkVal = record[pk];
+    if (pkVal === null || pkVal === undefined)
+        return [];
+    const table = child.name;
+    const res = await db.query(`SELECT ${name === null ? '1' : q(name)} AS v FROM ${q(table)}
+     WHERE ${q(DETAILS_COLUMNS.PARENT_TYPE)} = $1 AND ${q(DETAILS_COLUMNS.PARENT_ID)} = $2`, [object.name, pkVal]);
+    return res.rows.map((r) => r.v);
+}
+/** pre-fetch all cross refs + aggregates, then evaluate synchronously */
+async function evalWithResolvers(ast, object, record, db, registry, now) {
+    const { fields: refs, aggregates } = extractRefs(ast);
+    const refValues = new Map();
+    for (const ref of refs) {
+        if (ref.parent === null)
+            continue;
+        const key = `${ref.parent}.${ref.name}`;
+        if (refValues.has(key))
+            continue;
+        refValues.set(key, await resolveRefValue(object, ref.parent, ref.name, record, db, registry));
+    }
+    const aggValues = new Map();
+    for (const agg of aggregates) {
+        const key = `${agg.parent}.${agg.name ?? ''}`;
+        if (aggValues.has(key))
+            continue;
+        aggValues.set(key, await resolveAggregateValue(object, agg.parent, agg.name, record, db, registry));
+    }
+    return evaluate(ast, {
+        record,
+        resolveRef: (parent, name) => refValues.get(`${parent}.${name}`) ?? null,
+        resolveAggregate: (parent, name) => aggValues.get(`${parent}.${name ?? ''}`) ?? [],
+        now: () => now,
+    });
+}
+function coerce(value, type) {
+    if (value === null)
+        return null;
+    switch (type) {
+        case FIELD_TYPES.STRING:
+        case FIELD_TYPES.TEXT:
+            return String(value);
+        case FIELD_TYPES.INTEGER:
+            return typeof value === 'number' ? Math.round(value) : null;
+        case FIELD_TYPES.NUMBER:
+        case FIELD_TYPES.CURRENCY:
+            return typeof value === 'number' ? value : null;
+        case FIELD_TYPES.BOOLEAN:
+            return Boolean(value);
+        default:
+            return value;
+    }
+}
+/**
+ * Evaluate all formula fields of an object against a record (mutating it),
+ * resolving cross-object references and details aggregations via PG.
+ */
+export async function computeFormulas(object, record, db, registry, now) {
+    const formulaFields = object.fields.filter((f) => f.formula !== undefined);
+    if (formulaFields.length === 0)
+        return;
+    for (const field of formulaFields) {
+        const formula = field.formula;
+        const ast = parseFormula(formula);
+        const value = await evalWithResolvers(ast, object, record, db, registry, now);
+        record[field.name] = coerce(value, field.type);
+    }
+}
+//# sourceMappingURL=formula.js.map

package/dist/runtime/data-access/formula.js.map

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

package/dist/runtime/data-access/index.d.ts

@@ -0,0 +1,18 @@
+export { FILTER_OPS, SORT_DIRS, PAGINATION, WRITE_MODES } from "./values.js";
+export type { FilterOp, SortDir, WriteMode } from "./values.js";
+export type { Filter, FilterGroup, FilterValue, Sort, FindOptions, FindResult, DataAccessContext, ObjectDataAccess, Queryable, } from "./types.js";
+export { buildWhere, buildOrderBy, buildColumns, resolvePagination, buildFindSql, buildCountSql, } from "./builder.js";
+export type { BuiltQuery, BuildContext, RowScope } from "./builder.js";
+export { validateRecord } from "./validate.js";
+export type { ValidateRecordOptions } from "./validate.js";
+export { ensureSeqTable, seqBucket, renderSeq, generateSeqNo, } from "./seqno.js";
+export { insertDetails, deleteDetailsChildren } from "./details.js";
+export { computeFormulas } from "./formula.js";
+export { executeRestrictedSql } from "./sql-executor.js";
+export type { RestrictedSqlOptions, RestrictedSqlResult, } from "./sql-executor.js";
+export { enforceSqlGates } from "./sql-gate.js";
+export type { SqlGateOptions } from "./sql-gate.js";
+export { DefaultObjectDataAccess, createDataAccess } from "./query.js";
+export { withRbac } from "./rbac.js";
+export { withTx } from "./tx.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/data-access/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/data-access/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACX,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/runtime/data-access/index.js

@@ -0,0 +1,12 @@
+export { FILTER_OPS, SORT_DIRS, PAGINATION, WRITE_MODES } from "./values.js";
+export { buildWhere, buildOrderBy, buildColumns, resolvePagination, buildFindSql, buildCountSql, } from "./builder.js";
+export { validateRecord } from "./validate.js";
+export { ensureSeqTable, seqBucket, renderSeq, generateSeqNo, } from "./seqno.js";
+export { insertDetails, deleteDetailsChildren } from "./details.js";
+export { computeFormulas } from "./formula.js";
+export { executeRestrictedSql } from "./sql-executor.js";
+export { enforceSqlGates } from "./sql-gate.js";
+export { DefaultObjectDataAccess, createDataAccess } from "./query.js";
+export { withRbac } from "./rbac.js";
+export { withTx } from "./tx.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/data-access/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/data-access/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa7E,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/runtime/data-access/query.d.ts

@@ -0,0 +1,53 @@
+import type { AuditSink } from '../../core/audit/index.js';
+import type { EventPublisher } from '../../core/provider/event/index.js';
+import { type ScriptDispatcher } from '../../core/index.js';
+import type { DataAccessContext, FindOptions, FindResult, ObjectDataAccess } from './types.js';
+/** controlled object data-access implementation (PG-backed) */
+export declare class DefaultObjectDataAccess implements ObjectDataAccess {
+    private readonly audit?;
+    private readonly script;
+    /** M10 diff replay: attach before/after row snapshots to update/delete audit events */
+    private readonly replay;
+    /** M12 live events: publish committed writes to the bus (undefined = zero overhead) */
+    private readonly events?;
+    /** objects currently dispatching onLoad — skips re-entrant onLoad (a hook re-reading the same object) */
+    private readonly onLoadInFlight;
+    constructor(options?: {
+        audit?: AuditSink;
+        script?: ScriptDispatcher;
+        replay?: boolean;
+        events?: EventPublisher;
+    });
+    /**
+     * Run the read hook (`onLoad`) over a fetched batch. The hook receives the
+     * whole batch as `this.records` and returns an **equal-length** array (or
+     * undefined/null to keep the batch unchanged). A length mismatch is an error
+     * (fail-closed: never silently drop rows — `total` stays the DB count).
+     * Re-entrant onLoad for the same object is skipped to avoid recursion.
+     */
+    private runOnLoad;
+    /**
+     * Run a before-write hook (validate/beforeUpdate/beforeDelete). Throws on
+     * hook failure → the surrounding transaction rolls back. Returns the
+     * possibly-modified changes from beforeUpdate (undefined = keep original).
+     */
+    private runBeforeHook;
+    /**
+     * Run an after-write hook (afterUpdate/afterDelete) — the write is already
+     * committed, so a hook failure is a non-fatal warning: recorded to audit and
+     * delivered via `ctx.onWarnings`, never rethrown.
+     */
+    private runAfterHook;
+    find<T = Record<string, unknown>>(objectName: string, opts: FindOptions, ctx: DataAccessContext): Promise<FindResult<T>>;
+    findOne<T = Record<string, unknown>>(objectName: string, id: string, ctx: DataAccessContext): Promise<T | null>;
+    create<T = Record<string, unknown>>(objectName: string, data: Record<string, unknown>, ctx: DataAccessContext): Promise<T>;
+    update<T = Record<string, unknown>>(objectName: string, id: string, changes: Record<string, unknown>, ctx: DataAccessContext): Promise<T>;
+    delete(objectName: string, id: string, ctx: DataAccessContext): Promise<void>;
+}
+export declare function createDataAccess(options?: {
+    audit?: AuditSink;
+    script?: ScriptDispatcher;
+    replay?: boolean;
+    events?: EventPublisher;
+}): ObjectDataAccess;
+//# sourceMappingURL=query.d.ts.map

package/dist/runtime/data-access/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/runtime/data-access/query.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAwC,KAAK,gBAAgB,EAAoC,MAAM,qBAAqB,CAAC;AAKpI,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyH/F,+DAA+D;AAC/D,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB;IACzC,yGAAyG;IACzG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAA;KAAO;IAOrH;;;;;;OAMG;YACW,SAAS;IA6BvB;;;;OAIG;YACW,aAAa;IAgB3B;;;;OAIG;YACW,YAAY;IA8BpB,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAWnB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAUd,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,CAAC,CAAC;IA8GP,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,CAAC,CAAC;IAgFP,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAgDpF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG,gBAAgB,CAE5J"}