@metaobjectsdev/runtime-ts 0.5.0-rc.1

package/dist/query-builder.js

@@ -0,0 +1,178 @@
+import { TYPE_FIELD, TYPE_IDENTITY, IDENTITY_SUBTYPE_PRIMARY, IDENTITY_ATTR_FIELDS, resolveTableName, resolveColumnName, } from "@metaobjectsdev/metadata";
+import { MetadataError } from "./errors.js";
+export { resolveTableName } from "@metaobjectsdev/metadata";
+export function resolvePkFields(entity) {
+    const primary = entity.ownChildren().find((c) => c.type === TYPE_IDENTITY && c.subType === IDENTITY_SUBTYPE_PRIMARY);
+    if (!primary) {
+        throw new MetadataError(`Entity '${entity.name}' has no primary identity`, { entity: entity.name });
+    }
+    const attr = primary.ownAttr(IDENTITY_ATTR_FIELDS);
+    if (!Array.isArray(attr) || attr.length === 0) {
+        throw new MetadataError(`Entity '${entity.name}' primary identity has no @fields`, { entity: entity.name });
+    }
+    return attr.map(String);
+}
+function listFieldNames(entity) {
+    const out = [];
+    for (const child of entity.ownChildren()) {
+        if (child.type === TYPE_FIELD)
+            out.push(child.name);
+    }
+    return out;
+}
+function getField(entity, fieldName) {
+    const f = entity.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === fieldName);
+    if (!f) {
+        throw new MetadataError(`Unknown field '${fieldName}' on entity '${entity.name}'`, { entity: entity.name });
+    }
+    return f;
+}
+function rowToColumns(entity, data) {
+    const out = {};
+    for (const [k, v] of Object.entries(data)) {
+        const field = getField(entity, k);
+        out[resolveColumnName(field)] = v;
+    }
+    return out;
+}
+/**
+ * Returns null when `filter` has no clauses ({} or { $and: [] }) — meaning "match all"
+ * (callers should treat null the same as omitting the where clause entirely).
+ */
+export function compileFilter(entity, filter) {
+    if ("$and" in filter && Array.isArray(filter.$and)) {
+        // TS can't narrow $and away from the Record branch, so the runtime check above
+        // proves it's a Filter[] but the element type still needs a bridge cast.
+        const andFilters = filter.$and;
+        const clauses = andFilters.map((f) => compileFilter(entity, f)).filter((c) => c !== null);
+        if (clauses.length === 0)
+            return null;
+        return clauses.length === 1 ? clauses[0] : { kind: "and", clauses };
+    }
+    const entries = Object.entries(filter);
+    if (entries.length === 0)
+        return null;
+    if (entries.length === 1) {
+        return compileEntry(entity, entries[0][0], entries[0][1]);
+    }
+    return {
+        kind: "and",
+        clauses: entries.map(([k, v]) => compileEntry(entity, k, v)),
+    };
+}
+function compileEntry(entity, fieldName, value) {
+    const field = getField(entity, fieldName);
+    const column = resolveColumnName(field);
+    if (value === null)
+        return { kind: "isNull", column, not: false };
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return { kind: "eq", column, value };
+    }
+    if (Array.isArray(value)) {
+        return { kind: "in", column, values: value };
+    }
+    // If multiple operators are set on one field ({ $gte: 5, $lte: 10 }), the FIRST match wins
+    // and later operators are silently ignored. Range queries must use $and: [...] explicitly.
+    const op = value;
+    if ("$eq" in op && op.$eq !== undefined) {
+        if (op.$eq === null)
+            return { kind: "isNull", column, not: false };
+        return { kind: "eq", column, value: op.$eq };
+    }
+    if ("$ne" in op && op.$ne !== undefined) {
+        if (op.$ne === null)
+            return { kind: "isNull", column, not: true };
+        return { kind: "ne", column, value: op.$ne };
+    }
+    if ("$gt" in op && op.$gt !== undefined)
+        return { kind: "gt", column, value: op.$gt };
+    if ("$gte" in op && op.$gte !== undefined)
+        return { kind: "gte", column, value: op.$gte };
+    if ("$lt" in op && op.$lt !== undefined)
+        return { kind: "lt", column, value: op.$lt };
+    if ("$lte" in op && op.$lte !== undefined)
+        return { kind: "lte", column, value: op.$lte };
+    if ("$like" in op && op.$like !== undefined)
+        return { kind: "like", column, pattern: op.$like };
+    if ("$in" in op && op.$in !== undefined)
+        return { kind: "in", column, values: op.$in };
+    if ("$isNull" in op && op.$isNull !== undefined) {
+        return { kind: "isNull", column, not: !op.$isNull };
+    }
+    throw new MetadataError(`No recognized operator on filter for field '${fieldName}'`);
+}
+function normalizeOrderBy(input, entity) {
+    if (input === undefined)
+        return undefined;
+    const arr = Array.isArray(input[0]) ? input : [input];
+    return arr.map(([fieldName, dir]) => {
+        const field = getField(entity, fieldName);
+        return { column: resolveColumnName(field), direction: dir };
+    });
+}
+/** If `projectedFields` is provided, only those fields are selected (PK is auto-added). */
+export function buildSelectSpec(entity, filter, opts, projectedFields) {
+    const allFields = projectedFields ?? listFieldNames(entity);
+    const pkFields = resolvePkFields(entity);
+    const fieldSet = new Set(allFields);
+    for (const pk of pkFields)
+        fieldSet.add(pk);
+    const columns = [...fieldSet].map((f) => resolveColumnName(getField(entity, f)));
+    const orderBy = normalizeOrderBy(opts.orderBy, entity);
+    const spec = {
+        table: resolveTableName(entity),
+        columns,
+    };
+    const where = filter !== undefined ? compileFilter(entity, filter) : null;
+    if (where !== null)
+        spec.where = where;
+    if (orderBy !== undefined)
+        spec.orderBy = orderBy;
+    if (opts.limit !== undefined)
+        spec.limit = opts.limit;
+    if (opts.offset !== undefined)
+        spec.offset = opts.offset;
+    return spec;
+}
+export function buildCountSpec(entity, filter) {
+    const spec = { table: resolveTableName(entity) };
+    const where = filter !== undefined ? compileFilter(entity, filter) : null;
+    if (where !== null)
+        spec.where = where;
+    return spec;
+}
+export function buildInsertSpec(entity, data) {
+    const values = rowToColumns(entity, data);
+    const allFields = listFieldNames(entity);
+    return {
+        table: resolveTableName(entity),
+        values,
+        returning: allFields.map((f) => resolveColumnName(getField(entity, f))),
+    };
+}
+export function buildUpdateSpec(entity, data, id) {
+    const values = rowToColumns(entity, data);
+    const pkFields = resolvePkFields(entity);
+    if (pkFields.length !== 1) {
+        throw new MetadataError(`update-by-id requires single-column PK on '${entity.name}'; use updateMany for composite PKs`, { entity: entity.name });
+    }
+    const pkColumn = resolveColumnName(getField(entity, pkFields[0]));
+    return {
+        table: resolveTableName(entity),
+        values,
+        where: { kind: "eq", column: pkColumn, value: id },
+        returning: listFieldNames(entity).map((f) => resolveColumnName(getField(entity, f))),
+    };
+}
+export function buildDeleteSpec(entity, id) {
+    const pkFields = resolvePkFields(entity);
+    if (pkFields.length !== 1) {
+        throw new MetadataError(`delete-by-id requires single-column PK on '${entity.name}'; use deleteMany for composite PKs`, { entity: entity.name });
+    }
+    const pkColumn = resolveColumnName(getField(entity, pkFields[0]));
+    return {
+        table: resolveTableName(entity),
+        where: { kind: "eq", column: pkColumn, value: id },
+    };
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

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

package/dist/ref-codec.d.ts

@@ -0,0 +1,8 @@
+export interface DecodedRef {
+    entity: string;
+    /** PK values come back as strings; caller coerces back to number/etc. per metadata. */
+    pkValues: string[];
+}
+export declare function encodeRef(entity: string, record: Record<string, unknown>, pkFields: string[]): string;
+export declare function decodeRef(refString: string): DecodedRef;
+//# sourceMappingURL=ref-codec.d.ts.map

package/dist/ref-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-codec.d.ts","sourceRoot":"","sources":["../src/ref-codec.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CA6BrG;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAoBvD"}

package/dist/ref-codec.js

@@ -0,0 +1,42 @@
+// Reference-string format ("Entity:pk" or "Entity:pk1,pk2") mirrors Java's getObjectByRef.
+// PK values containing commas are not supported in v0.1 — commas are the composite separator.
+import { MetadataError, UnsafeNameError } from "./errors.js";
+import { REF_SEPARATOR, REF_PK_SEPARATOR, VALID_ENTITY_NAME } from "./constants.js";
+export function encodeRef(entity, record, pkFields) {
+    if (!VALID_ENTITY_NAME.test(entity)) {
+        throw new UnsafeNameError(`Unsafe entity name '${entity}' — must match ${VALID_ENTITY_NAME}`, { value: entity });
+    }
+    if (pkFields.length === 0) {
+        throw new MetadataError(`No primary-key fields declared for entity '${entity}'`, { entity });
+    }
+    const values = [];
+    for (const field of pkFields) {
+        const value = record[field];
+        if (value === undefined || value === null) {
+            throw new MetadataError(`Missing PK field '${field}' on record while encoding ref for '${entity}'`, { entity });
+        }
+        const str = String(value);
+        if (str.includes(REF_PK_SEPARATOR)) {
+            throw new MetadataError(`PK value for '${field}' on '${entity}' contains '${REF_PK_SEPARATOR}' — reserved as the composite-PK separator in ref strings`, { entity });
+        }
+        values.push(str);
+    }
+    return `${entity}${REF_SEPARATOR}${values.join(REF_PK_SEPARATOR)}`;
+}
+export function decodeRef(refString) {
+    const sepIdx = refString.indexOf(REF_SEPARATOR);
+    if (sepIdx <= 0) {
+        throw new MetadataError(`Reference string '${refString}' missing '${REF_SEPARATOR}' separator`);
+    }
+    const entity = refString.slice(0, sepIdx);
+    const pkPart = refString.slice(sepIdx + 1);
+    if (!VALID_ENTITY_NAME.test(entity)) {
+        throw new UnsafeNameError(`Unsafe entity name '${entity}' in reference '${refString}'`, { value: entity });
+    }
+    if (pkPart.length === 0) {
+        throw new MetadataError(`Reference string '${refString}' has empty PK part`, { entity });
+    }
+    const pkValues = pkPart.split(REF_PK_SEPARATOR);
+    return { entity, pkValues };
+}
+//# sourceMappingURL=ref-codec.js.map

package/dist/ref-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-codec.js","sourceRoot":"","sources":["../src/ref-codec.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,8FAA8F;AAE9F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAQpF,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAA+B,EAAE,QAAkB;IAC3F,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CACvB,uBAAuB,MAAM,kBAAkB,iBAAiB,EAAE,EAClE,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,aAAa,CAAC,8CAA8C,MAAM,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,aAAa,CACrB,qBAAqB,KAAK,uCAAuC,MAAM,GAAG,EAC1E,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CACrB,iBAAiB,KAAK,SAAS,MAAM,eAAe,gBAAgB,2DAA2D,EAC/H,EAAE,MAAM,EAAE,CACX,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,aAAa,CACrB,qBAAqB,SAAS,cAAc,aAAa,aAAa,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CACvB,uBAAuB,MAAM,mBAAmB,SAAS,GAAG,EAC5D,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CAAC,qBAAqB,SAAS,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/relation-resolver.d.ts

@@ -0,0 +1,27 @@
+import type { MetaData } from "@metaobjectsdev/metadata";
+import { CARDINALITY_ONE, CARDINALITY_MANY } from "@metaobjectsdev/metadata";
+import type { SelectSpec, Row } from "./persistence-driver.js";
+export interface RelationDescriptor {
+    /** "one" = source holds the FK pointing at target. "many" = target holds the FK pointing back at source. */
+    cardinality: typeof CARDINALITY_ONE | typeof CARDINALITY_MANY;
+    /** Entity name we're loading rows OF. */
+    targetEntityName: string;
+    /** Field on the source record to read the lookup value from (one-side: FK column; many-side: source PK). */
+    sourceField: string;
+    /** Field on the target table to filter by (one-side: target PK; many-side: back-pointing FK). */
+    targetField: string;
+}
+/**
+ * Walks one-side (relationship children of `sourceEntity`) then many-side (relationship
+ * children of any OTHER entity pointing to `sourceEntity`). The inverse-side relation name
+ * is computed via the same convention as SP2's relation-resolver: variableNameFromEntity
+ * (lower-camel + plural) of the declaring source.
+ *
+ * FK direction is sourced from identity.reference declarations, not relationship attrs.
+ */
+export declare function resolveRelationDescriptor(sourceEntity: MetaData, relationName: string, root: MetaData): RelationDescriptor;
+/** Returns null when the source-side lookup value is null — caller returns null/[]. */
+export declare function buildLazyRelateSpec(desc: RelationDescriptor, sourceRecord: Row, root: MetaData): SelectSpec | null;
+/** Builds one batched IN(...) lookup. Returns null when there are no non-null source values. */
+export declare function buildIncludeBatchSpec(desc: RelationDescriptor, sourceRecords: Row[], root: MetaData): SelectSpec | null;
+//# sourceMappingURL=relation-resolver.d.ts.map

package/dist/relation-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-resolver.d.ts","sourceRoot":"","sources":["../src/relation-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAML,eAAe,EAAE,gBAAgB,EAClC,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAAE,UAAU,EAAkB,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,4GAA4G;IAC5G,WAAW,EAAE,OAAO,eAAe,GAAG,OAAO,gBAAgB,CAAC;IAC9D,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,4GAA4G;IAC5G,WAAW,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAC;CACrB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,QAAQ,EACtB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,GACb,kBAAkB,CAkEpB;AAUD,uFAAuF;AACvF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,YAAY,EAAE,GAAG,EACjB,IAAI,EAAE,QAAQ,GACb,UAAU,GAAG,IAAI,CAKnB;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,aAAa,EAAE,GAAG,EAAE,EACpB,IAAI,EAAE,QAAQ,GACb,UAAU,GAAG,IAAI,CAUnB"}

package/dist/relation-resolver.js

@@ -0,0 +1,136 @@
+import { TYPE_OBJECT, TYPE_RELATIONSHIP, TYPE_IDENTITY, IDENTITY_SUBTYPE_REFERENCE, IDENTITY_ATTR_FIELDS, IDENTITY_REFERENCE_ATTR_REFERENCES, RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, CARDINALITY_ONE, CARDINALITY_MANY, } from "@metaobjectsdev/metadata";
+import { MetadataError } from "./errors.js";
+import { buildSelectSpec, resolvePkFields, } from "./query-builder.js";
+/**
+ * Find an identity.reference declared on `holder` whose @references targets `targetName`.
+ * Returns the FK field name (first field on the identity) or undefined.
+ */
+function findReferenceFkField(holder, targetName) {
+    for (const child of holder.ownChildren()) {
+        if (child.type !== TYPE_IDENTITY)
+            continue;
+        if (child.subType !== IDENTITY_SUBTYPE_REFERENCE)
+            continue;
+        const ref = child.ownAttr(IDENTITY_REFERENCE_ATTR_REFERENCES);
+        if (typeof ref !== "string")
+            continue;
+        const dotIdx = ref.indexOf(".");
+        const entityName = dotIdx === -1 ? ref : ref.slice(0, dotIdx);
+        if (entityName !== targetName)
+            continue;
+        const fields = child.ownAttr(IDENTITY_ATTR_FIELDS);
+        if (Array.isArray(fields) && fields.length > 0)
+            return String(fields[0]);
+        if (typeof fields === "string") {
+            const first = fields.split(",")[0]?.trim();
+            if (first)
+                return first;
+        }
+    }
+    return undefined;
+}
+/**
+ * Walks one-side (relationship children of `sourceEntity`) then many-side (relationship
+ * children of any OTHER entity pointing to `sourceEntity`). The inverse-side relation name
+ * is computed via the same convention as SP2's relation-resolver: variableNameFromEntity
+ * (lower-camel + plural) of the declaring source.
+ *
+ * FK direction is sourced from identity.reference declarations, not relationship attrs.
+ */
+export function resolveRelationDescriptor(sourceEntity, relationName, root) {
+    for (const child of sourceEntity.ownChildren()) {
+        if (child.type !== TYPE_RELATIONSHIP)
+            continue;
+        if (child.name !== relationName)
+            continue;
+        const card = child.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
+        if (card !== CARDINALITY_ONE)
+            continue;
+        const targetEntityName = child.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+        if (!targetEntityName) {
+            throw new MetadataError(`Relationship '${relationName}' on '${sourceEntity.name}' missing @objectRef`, { entity: sourceEntity.name });
+        }
+        const fkField = findReferenceFkField(sourceEntity, targetEntityName);
+        if (!fkField) {
+            throw new MetadataError(`Relationship '${relationName}' on '${sourceEntity.name}' has no identity.reference targeting '${targetEntityName}'`, { entity: sourceEntity.name });
+        }
+        const target = root.ownChildren().find((c) => c.type === TYPE_OBJECT && c.name === targetEntityName);
+        if (!target) {
+            throw new MetadataError(`Target entity '${targetEntityName}' not found for relation '${relationName}' on '${sourceEntity.name}'`, { entity: sourceEntity.name });
+        }
+        return {
+            cardinality: "one",
+            targetEntityName,
+            sourceField: fkField,
+            targetField: resolvePkFields(target)[0],
+        };
+    }
+    for (const other of root.ownChildren()) {
+        if (other.type !== TYPE_OBJECT)
+            continue;
+        if (other.name === sourceEntity.name)
+            continue;
+        for (const child of other.ownChildren()) {
+            if (child.type !== TYPE_RELATIONSHIP)
+                continue;
+            const card = child.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
+            if (card !== CARDINALITY_ONE)
+                continue;
+            const targetEntityName = child.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+            if (targetEntityName !== sourceEntity.name)
+                continue;
+            const inverseName = inversePluralName(other.name);
+            if (inverseName !== relationName)
+                continue;
+            const fkField = findReferenceFkField(other, sourceEntity.name);
+            if (!fkField) {
+                throw new MetadataError(`Inverse relationship for '${relationName}' on '${sourceEntity.name}': entity '${other.name}' has no identity.reference targeting '${sourceEntity.name}'`, { entity: sourceEntity.name });
+            }
+            return {
+                cardinality: "many",
+                targetEntityName: other.name,
+                sourceField: resolvePkFields(sourceEntity)[0],
+                targetField: fkField,
+            };
+        }
+    }
+    throw new MetadataError(`Unknown relation '${relationName}' on entity '${sourceEntity.name}'`, { entity: sourceEntity.name });
+}
+// Mirrors codegen-ts's variableNameFromEntity: lower-camel + plural.
+function inversePluralName(entityName) {
+    const camel = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    if (/(s|x|z|ch|sh)$/i.test(camel))
+        return camel + "es";
+    if (/[^aeiou]y$/i.test(camel))
+        return camel.slice(0, -1) + "ies";
+    return camel + "s";
+}
+/** Returns null when the source-side lookup value is null — caller returns null/[]. */
+export function buildLazyRelateSpec(desc, sourceRecord, root) {
+    const lookup = sourceRecord[desc.sourceField];
+    if (lookup === null || lookup === undefined)
+        return null;
+    const target = mustGetEntity(root, desc.targetEntityName);
+    return buildSelectSpec(target, { [desc.targetField]: lookup }, {});
+}
+/** Builds one batched IN(...) lookup. Returns null when there are no non-null source values. */
+export function buildIncludeBatchSpec(desc, sourceRecords, root) {
+    const seen = new Set();
+    for (const rec of sourceRecords) {
+        const v = rec[desc.sourceField];
+        if (v === null || v === undefined)
+            continue;
+        seen.add(v);
+    }
+    if (seen.size === 0)
+        return null;
+    const target = mustGetEntity(root, desc.targetEntityName);
+    return buildSelectSpec(target, { [desc.targetField]: [...seen] }, {});
+}
+function mustGetEntity(root, name) {
+    const e = root.ownChildren().find((c) => c.type === TYPE_OBJECT && c.name === name);
+    if (!e)
+        throw new MetadataError(`Entity '${name}' not found`, { entity: name });
+    return e;
+}
+//# sourceMappingURL=relation-resolver.js.map

package/dist/relation-resolver.js.map

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

package/dist/type-coercer.d.ts

@@ -0,0 +1,5 @@
+import type { MetaData } from "@metaobjectsdev/metadata";
+import type { Dialect, Row } from "./persistence-driver.js";
+export declare function coerceRowOnRead(entity: MetaData, row: Row, dialect: Dialect): Row;
+export declare function coerceRowOnWrite(entity: MetaData, row: Row, dialect: Dialect): Row;
+//# sourceMappingURL=type-coercer.d.ts.map

package/dist/type-coercer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-coercer.d.ts","sourceRoot":"","sources":["../src/type-coercer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAE5D,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAGjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG,CAGlF"}

package/dist/type-coercer.js

@@ -0,0 +1,43 @@
+// v0.1 only handles SQLite's int↔boolean. Date/timestamp coercion (ISO string ↔ Date) is deferred.
+import { TYPE_FIELD, FIELD_SUBTYPE_BOOLEAN } from "@metaobjectsdev/metadata";
+export function coerceRowOnRead(entity, row, dialect) {
+    if (dialect !== "sqlite")
+        return row;
+    return mapBooleansFromInt(entity, row);
+}
+export function coerceRowOnWrite(entity, row, dialect) {
+    if (dialect !== "sqlite")
+        return row;
+    return mapBooleansToInt(entity, row);
+}
+function mapBooleansFromInt(entity, row) {
+    const out = { ...row };
+    for (const child of entity.ownChildren()) {
+        if (child.type !== TYPE_FIELD)
+            continue;
+        if (child.subType !== FIELD_SUBTYPE_BOOLEAN)
+            continue;
+        const v = out[child.name];
+        if (v === 0)
+            out[child.name] = false;
+        else if (v === 1)
+            out[child.name] = true;
+    }
+    return out;
+}
+function mapBooleansToInt(entity, row) {
+    const out = { ...row };
+    for (const child of entity.ownChildren()) {
+        if (child.type !== TYPE_FIELD)
+            continue;
+        if (child.subType !== FIELD_SUBTYPE_BOOLEAN)
+            continue;
+        const v = out[child.name];
+        if (v === true)
+            out[child.name] = 1;
+        else if (v === false)
+            out[child.name] = 0;
+    }
+    return out;
+}
+//# sourceMappingURL=type-coercer.js.map

package/dist/type-coercer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-coercer.js","sourceRoot":"","sources":["../src/type-coercer.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAGnG,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAG7E,MAAM,UAAU,eAAe,CAAC,MAAgB,EAAE,GAAQ,EAAE,OAAgB;IAC1E,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAgB,EAAE,GAAQ,EAAE,OAAgB;IAC3E,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAgB,EAAE,GAAQ;IACpD,MAAM,GAAG,GAAQ,EAAE,GAAG,GAAG,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACxC,IAAI,KAAK,CAAC,OAAO,KAAK,qBAAqB;YAAE,SAAS;QACtD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;aAChC,IAAI,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAgB,EAAE,GAAQ;IAClD,MAAM,GAAG,GAAQ,EAAE,GAAG,GAAG,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACxC,IAAI,KAAK,CAAC,OAAO,KAAK,qBAAqB;YAAE,SAAS;QACtD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAC/B,IAAI,CAAC,KAAK,KAAK;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/validator-runner.d.ts

@@ -0,0 +1,14 @@
+import type { MetaData } from "@metaobjectsdev/metadata";
+import type { ValidationFailure } from "./errors.js";
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: ValidationFailure[];
+};
+export interface RunValidatorsOpts {
+    /** Partial-update mode: required-checks only fire for fields whose key is present in `data`. */
+    partial?: boolean;
+}
+export declare function runValidators(entity: MetaData, data: Record<string, unknown>, opts?: RunValidatorsOpts): ValidationResult;
+//# sourceMappingURL=validator-runner.d.ts.map

package/dist/validator-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-runner.d.ts","sourceRoot":"","sources":["../src/validator-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAUzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAO/C,MAAM,WAAW,iBAAiB;IAChC,gGAAgG;IAChG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,GAAE,iBAAsB,GAC3B,gBAAgB,CA6FlB"}