@rudderjs/orm 1.9.1 → 1.9.3

package/dist/relations/where-has.js

@@ -0,0 +1,239 @@
+import { camelHead } from '../utils.js';
+import { resolveBelongsToManyMeta, resolveMorphToManyMeta, resolveMorphedByManyMeta, } from './pivot-meta.js';
+// ─── Constraint capture ────────────────────────────────────
+/**
+ * Run the constrain callback against a recording-only QueryBuilder that
+ * captures `.where()` calls into a flat `WhereClause[]` and treats every
+ * other chainable method as a no-op. Nested `whereHas` inside the callback
+ * throws — recursive predicates are deferred to v2.
+ */
+export function captureConstraintWheres(constrain) {
+    const wheres = [];
+    const recorder = new Proxy({}, {
+        get(_t, prop) {
+            const name = String(prop);
+            if (name === 'where') {
+                return (col, opOrVal, maybeVal) => {
+                    if (maybeVal === undefined) {
+                        wheres.push({ column: col, operator: '=', value: opOrVal });
+                    }
+                    else {
+                        wheres.push({ column: col, operator: opOrVal, value: maybeVal });
+                    }
+                    return recorder;
+                };
+            }
+            if (name === 'whereHas' || name === 'whereDoesntHave' || name === 'withWhereHas') {
+                return () => {
+                    throw new Error(`[RudderJS ORM] Nested ${name} inside a whereHas constrain callback is deferred to v2. ` +
+                        `Filter on flat columns inside the callback for now.`);
+                };
+            }
+            if (name === 'orWhere') {
+                return () => {
+                    throw new Error(`[RudderJS ORM] orWhere inside a whereHas constrain callback is not supported in v1 — ` +
+                        `the WhereClause contract has no boolean flag, so the OR semantic can't round-trip to the adapter. ` +
+                        `Compose the predicate with where() (AND), or run two queries and merge in app code.`);
+                };
+            }
+            // All other chainable methods record nothing and return the recorder so
+            // `q.orderBy('x').limit(1)` chains through silently. Terminal methods
+            // (find/get/etc.) don't make sense in a constrain callback — they'd
+            // execute mid-build — but we don't intercept them here; they'd just
+            // return the recorder which then fails downstream. Keep the contract
+            // simple.
+            return () => recorder;
+        },
+    });
+    constrain(recorder);
+    return wheres;
+}
+// ─── belongsTo lookup ──────────────────────────────────────
+/**
+ * Resolve the `belongsTo` relation declaration on `Self` that points at
+ * `ParentCtor`. When `relation` is given, looks it up directly. Otherwise
+ * scans `Self.relations` for a single `belongsTo` whose `model()` resolves
+ * to `ParentCtor` — throws on zero or multiple candidates.
+ */
+export function resolveBelongsToFor(Self, ParentCtor, relation) {
+    if (relation !== undefined) {
+        const def = Self.relations[relation];
+        if (!def)
+            throw new Error(`[RudderJS ORM] Relation "${relation}" is not defined on ${Self.name}.`);
+        if (def.type !== 'belongsTo') {
+            throw new Error(`[RudderJS ORM] Relation "${relation}" on ${Self.name} is "${def.type}", not "belongsTo".`);
+        }
+        return def;
+    }
+    const candidates = [];
+    for (const [name, def] of Object.entries(Self.relations)) {
+        if (def.type !== 'belongsTo')
+            continue;
+        const btDef = def;
+        if (btDef.model() === ParentCtor)
+            candidates.push([name, btDef]);
+    }
+    if (candidates.length === 0) {
+        throw new Error(`[RudderJS ORM] whereBelongsTo: ${Self.name} has no belongsTo relation pointing at ${ParentCtor.name}. ` +
+            `Pass a relation name explicitly.`);
+    }
+    if (candidates.length > 1) {
+        const names = candidates.map(([n]) => n).join(', ');
+        throw new Error(`[RudderJS ORM] whereBelongsTo: ${Self.name} has multiple belongsTo relations pointing at ${ParentCtor.name} (${names}). ` +
+            `Pass the relation name explicitly.`);
+    }
+    return candidates[0][1];
+}
+// ─── Predicate builder ─────────────────────────────────────
+/**
+ * Build the {@link RelationExistencePredicate} for a relation declared on
+ * `Parent`. `morphTo` is rejected before reaching this function (the related
+ * table is dynamic).
+ */
+export function buildRelationPredicate(Parent, relation, def, exists, constraintWheres) {
+    const Related = def.model();
+    if (def.type === 'belongsToMany') {
+        const meta = resolveBelongsToManyMeta(Parent, Related, def);
+        return {
+            relation,
+            exists,
+            relatedTable: Related.getTable(),
+            parentColumn: meta.parentKey,
+            relatedColumn: meta.relatedKey,
+            constraintWheres,
+            through: {
+                pivotTable: meta.pivotTable,
+                foreignPivotKey: meta.foreignPivotKey,
+                relatedPivotKey: meta.relatedPivotKey,
+            },
+        };
+    }
+    if (def.type === 'morphToMany') {
+        const meta = resolveMorphToManyMeta(Parent, Related, def);
+        return {
+            relation,
+            exists,
+            relatedTable: Related.getTable(),
+            parentColumn: meta.parentKey,
+            relatedColumn: meta.relatedKey,
+            constraintWheres,
+            extraEquals: { [meta.morphTypeKey]: meta.morphTypeValue },
+            through: {
+                pivotTable: meta.pivotTable,
+                foreignPivotKey: meta.foreignPivotKey,
+                relatedPivotKey: meta.relatedPivotKey,
+            },
+        };
+    }
+    if (def.type === 'morphedByMany') {
+        const meta = resolveMorphedByManyMeta(Parent, Related, def);
+        return {
+            relation,
+            exists,
+            relatedTable: Related.getTable(),
+            parentColumn: meta.parentKey,
+            relatedColumn: meta.relatedKey,
+            constraintWheres,
+            extraEquals: { [meta.morphTypeKey]: meta.morphTypeValue },
+            through: {
+                pivotTable: meta.pivotTable,
+                foreignPivotKey: meta.foreignPivotKey,
+                relatedPivotKey: meta.relatedPivotKey,
+            },
+        };
+    }
+    if (def.type === 'morphMany' || def.type === 'morphOne') {
+        const idCol = `${def.morphName}Id`;
+        const typeCol = `${def.morphName}Type`;
+        const localCol = def.localKey ?? Parent.primaryKey;
+        const typeVal = def.morphType ?? Parent.morphAlias ?? Parent.name;
+        return {
+            relation,
+            exists,
+            relatedTable: Related.getTable(),
+            parentColumn: localCol,
+            relatedColumn: idCol,
+            constraintWheres,
+            extraEquals: { [typeCol]: typeVal },
+        };
+    }
+    if (def.type === 'belongsTo') {
+        const fk = def.foreignKey ?? `${camelHead(Related.name)}Id`;
+        const localCol = def.localKey ?? fk;
+        return {
+            relation,
+            exists,
+            relatedTable: Related.getTable(),
+            parentColumn: localCol,
+            relatedColumn: Related.primaryKey,
+            constraintWheres,
+        };
+    }
+    // hasOne / hasMany — related table holds the FK pointing back to Parent.
+    const fk = def.foreignKey ?? `${camelHead(Parent.name)}Id`;
+    const localCol = def.localKey ?? Parent.primaryKey;
+    return {
+        relation,
+        exists,
+        relatedTable: Related.getTable(),
+        parentColumn: localCol,
+        relatedColumn: fk,
+        constraintWheres,
+    };
+}
+// ─── Public attach helpers ─────────────────────────────────
+/**
+ * Build the predicate for a relation declared on `Parent` and dispatch it to
+ * the adapter via `q.whereRelationExists(predicate)`. Returns the same
+ * QueryBuilder for chaining (the adapter mutates in place).
+ *
+ * `morphTo` throws — the related table isn't statically known so a single
+ * EXISTS subquery can't represent it. Filter on the discriminator + id
+ * columns directly when you need that semantic.
+ */
+export function attachWhereHas(Parent, q, relation, exists, constrain) {
+    const def = Parent.relations[relation];
+    if (!def) {
+        throw new Error(`[RudderJS ORM] Relation "${relation}" is not defined on ${Parent.name}.`);
+    }
+    if (def.type === 'morphTo') {
+        throw new Error(`[RudderJS ORM] morphTo "${relation}" cannot be used with whereHas — the related table is dynamic. ` +
+            `Filter on ${def.morphName}Id / ${def.morphName}Type directly instead.`);
+    }
+    const constraintWheres = constrain ? captureConstraintWheres(constrain) : [];
+    const predicate = buildRelationPredicate(Parent, relation, def, exists, constraintWheres);
+    return q.whereRelationExists(predicate);
+}
+/**
+ * `withWhereHas` — run `whereHas` AND eager-load the relation under the
+ * same constraint when the adapter implements `withConstrained`. Adapters
+ * without it fall back to plain `with(relation)` (constraint applies only
+ * to the parent filter, not the eagerly loaded children).
+ */
+export function attachWithWhereHas(Parent, q, relation, constrain) {
+    const constraintWheres = constrain ? captureConstraintWheres(constrain) : [];
+    // Reuse attachWhereHas for the parent-side filter — it re-runs the
+    // constrain callback against a fresh recorder, so the WhereClause[] we
+    // capture above and the one captured inside attachWhereHas come from
+    // distinct recorder instances. That's intentional: each captures the
+    // same constraint independently and neither is mutated by the adapter.
+    attachWhereHas(Parent, q, relation, true, constrain);
+    const withConstrained = q.withConstrained;
+    if (constraintWheres.length > 0 && typeof withConstrained === 'function') {
+        return withConstrained.call(q, relation, constraintWheres);
+    }
+    return q.with(relation);
+}
+export function attachWhereBelongsTo(Self, q, parent, relation) {
+    const ParentCtor = parent.constructor;
+    const def = resolveBelongsToFor(Self, ParentCtor, relation);
+    const Related = def.model();
+    const fk = def.foreignKey ?? `${camelHead(Related.name)}Id`;
+    const localCol = def.localKey ?? fk;
+    const parentVal = parent[ParentCtor.primaryKey];
+    if (parentVal === undefined || parentVal === null) {
+        throw new Error(`[RudderJS ORM] whereBelongsTo: parent.${ParentCtor.primaryKey} is unset on ${ParentCtor.name}.`);
+    }
+    return q.where(localCol, parentVal);
+}
+//# sourceMappingURL=where-has.js.map

package/dist/relations/where-has.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where-has.js","sourceRoot":"","sources":["../../src/relations/where-has.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AAcxB,8DAA8D;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAA2C;IAE3C,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,MAAM,QAAQ,GAAwB,IAAI,KAAK,CAAC,EAAyB,EAAE;QACzE,GAAG,CAAC,EAAE,EAAE,IAAI;YACV,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YACzB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAW,EAAE,OAAgB,EAAE,QAAkB,EAAuB,EAAE;oBAChF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;oBAC7D,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAwB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;oBACnF,CAAC;oBACD,OAAO,QAAQ,CAAA;gBACjB,CAAC,CAAA;YACH,CAAC;YACD,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;gBACjF,OAAO,GAAwB,EAAE;oBAC/B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,2DAA2D;wBACxF,qDAAqD,CACtD,CAAA;gBACH,CAAC,CAAA;YACH,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,GAAwB,EAAE;oBAC/B,MAAM,IAAI,KAAK,CACb,uFAAuF;wBACvF,oGAAoG;wBACpG,qFAAqF,CACtF,CAAA;gBACH,CAAC,CAAA;YACH,CAAC;YACD,wEAAwE;YACxE,sEAAsE;YACtE,oEAAoE;YACpE,oEAAoE;YACpE,qEAAqE;YACrE,UAAU;YACV,OAAO,GAAwB,EAAE,CAAC,QAAQ,CAAA;QAC5C,CAAC;KACF,CAAC,CAAA;IACF,SAAS,CAAC,QAAQ,CAAC,CAAA;IACnB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,8DAA8D;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAwB,EACxB,UAAwB,EACxB,QAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,uBAAuB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QAClG,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,qBAAqB,CAAC,CAAA;QAC7G,CAAC;QACD,OAAO,GAAwB,CAAA;IACjC,CAAC;IACD,MAAM,UAAU,GAAuC,EAAE,CAAA;IACzD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,SAAQ;QACtC,MAAM,KAAK,GAAG,GAAwB,CAAA;QACtC,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,UAAU;YAAE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAClE,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,IAAI,0CAA0C,UAAU,CAAC,IAAI,IAAI;YACxG,kCAAkC,CACnC,CAAA;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnD,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,CAAC,IAAI,iDAAiD,UAAU,CAAC,IAAI,KAAK,KAAK,KAAK;YAC1H,oCAAoC,CACrC,CAAA;IACH,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,8DAA8D;AAE9D;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA8B,EAC9B,QAAwB,EACxB,GAAkE,EAClE,MAAyB,EACzB,gBAA+B;IAE/B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,EAAkB,CAAA;IAE3C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QAC3D,OAAO;YACL,QAAQ;YACR,MAAM;YACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAG,IAAI,CAAC,SAAS;YAC7B,aAAa,EAAE,IAAI,CAAC,UAAU;YAC9B,gBAAgB;YAChB,OAAO,EAAE;gBACP,UAAU,EAAO,IAAI,CAAC,UAAU;gBAChC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC;SACF,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QACzD,OAAO;YACL,QAAQ;YACR,MAAM;YACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAG,IAAI,CAAC,SAAS;YAC7B,aAAa,EAAE,IAAI,CAAC,UAAU;YAC9B,gBAAgB;YAChB,WAAW,EAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE;YAC1D,OAAO,EAAE;gBACP,UAAU,EAAO,IAAI,CAAC,UAAU;gBAChC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC;SACF,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QAC3D,OAAO;YACL,QAAQ;YACR,MAAM;YACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAG,IAAI,CAAC,SAAS;YAC7B,aAAa,EAAE,IAAI,CAAC,UAAU;YAC9B,gBAAgB;YAChB,WAAW,EAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE;YAC1D,OAAO,EAAE;gBACP,UAAU,EAAO,IAAI,CAAC,UAAU;gBAChC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC;SACF,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,KAAK,GAAM,GAAG,GAAG,CAAC,SAAS,IAAI,CAAA;QACrC,MAAM,OAAO,GAAI,GAAG,GAAG,CAAC,SAAS,MAAM,CAAA;QACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAA;QAClD,MAAM,OAAO,GAAI,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAA;QAClE,OAAO;YACL,QAAQ;YACR,MAAM;YACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAG,QAAQ;YACvB,aAAa,EAAE,KAAK;YACpB,gBAAgB;YAChB,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE;SACpC,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAS,GAAG,CAAC,UAAU,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA;QACjE,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAM,EAAE,CAAA;QACrC,OAAO;YACL,QAAQ;YACR,MAAM;YACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;YACjC,YAAY,EAAG,QAAQ;YACvB,aAAa,EAAE,OAAO,CAAC,UAAU;YACjC,gBAAgB;SACjB,CAAA;IACH,CAAC;IAED,yEAAyE;IACzE,MAAM,EAAE,GAAS,GAAG,CAAC,UAAU,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAA;IAChE,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAM,MAAM,CAAC,UAAU,CAAA;IACpD,OAAO;QACL,QAAQ;QACR,MAAM;QACN,YAAY,EAAG,OAAO,CAAC,QAAQ,EAAE;QACjC,YAAY,EAAG,QAAQ;QACvB,aAAa,EAAE,EAAE;QACjB,gBAAgB;KACjB,CAAA;AACH,CAAC;AAED,8DAA8D;AAE9D;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAuB,EACvB,CAA2B,EAC3B,QAAiB,EACjB,MAAkB,EAClB,SAA4C;IAE5C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,uBAAuB,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;IAC5F,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,2BAA2B,QAAQ,iEAAiE;YACpG,aAAa,GAAG,CAAC,SAAS,QAAQ,GAAG,CAAC,SAAS,wBAAwB,CACxE,CAAA;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5E,MAAM,SAAS,GAAU,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAChG,OAAO,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAA;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAuB,EACvB,CAA2B,EAC3B,QAAiB,EACjB,SAA4C;IAE5C,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5E,mEAAmE;IACnE,uEAAuE;IACvE,qEAAqE;IACrE,qEAAqE;IACrE,uEAAuE;IACvE,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IACpD,MAAM,eAAe,GAAI,CAA2F,CAAC,eAAe,CAAA;IACpI,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QACzE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAuB,EACvB,CAA2B,EAC3B,MAAgB,EAChB,QAAiB;IAEjB,MAAM,UAAU,GAAG,MAAM,CAAC,WAA2B,CAAA;IACrD,MAAM,GAAG,GAAU,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IAClE,MAAM,OAAO,GAAM,GAAG,CAAC,KAAK,EAAkB,CAAA;IAC9C,MAAM,EAAE,GAAW,GAAG,CAAC,UAAU,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA;IACnE,MAAM,QAAQ,GAAK,GAAG,CAAC,QAAQ,IAAM,EAAE,CAAA;IACvC,MAAM,SAAS,GAAK,MAA6C,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IACxF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,UAAU,gBAAgB,UAAU,CAAC,IAAI,GAAG,CACjG,CAAA;IACH,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACrC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Lowercase first character. Used for camelCase identifier construction
+ * (e.g. class name → foreign key column: `Author` → `authorId`).
+ */
+export declare function camelHead(s: string): string;
+/**
+ * Uppercase first character. Used for aggregate suffix construction
+ * (`sum` + `views` → `SumViews`).
+ */
+export declare function capitalize(s: string): string;
+/**
+ * Read a dynamic property by string key from a Model instance (or any
+ * object with typed fields). Encapsulates the unsafe-cast that TS otherwise
+ * forces at every dynamic-field-access site. Returns `unknown` — the caller
+ * is responsible for whatever narrowing is appropriate.
+ */
+export declare function readField(obj: object, key: string): unknown;
+/**
+ * Write a dynamic property by string key onto a Model instance (or any
+ * object with typed fields). Mirror of {@link readField}.
+ */
+export declare function writeField(obj: object, key: string, value: unknown): void;
+/**
+ * Delete a dynamic property by string key on a Model instance.
+ * Mirror of {@link readField}. Used by `instance.refresh()` when pruning
+ * stale fields before re-reading the row.
+ */
+export declare function deleteField(obj: object, key: string): void;
+/**
+ * Loose attribute equality used by dirty tracking and relation predicates.
+ * Handles primitives, nulls, Dates (by getTime), and plain objects (by JSON
+ * round-trip). Returns false for objects that don't round-trip cleanly.
+ */
+export declare function attrEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAQzD"}

package/dist/utils.js

@@ -0,0 +1,63 @@
+/**
+ * Lowercase first character. Used for camelCase identifier construction
+ * (e.g. class name → foreign key column: `Author` → `authorId`).
+ */
+export function camelHead(s) {
+    return s.charAt(0).toLowerCase() + s.slice(1);
+}
+/**
+ * Uppercase first character. Used for aggregate suffix construction
+ * (`sum` + `views` → `SumViews`).
+ */
+export function capitalize(s) {
+    if (s.length === 0)
+        return s;
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Read a dynamic property by string key from a Model instance (or any
+ * object with typed fields). Encapsulates the unsafe-cast that TS otherwise
+ * forces at every dynamic-field-access site. Returns `unknown` — the caller
+ * is responsible for whatever narrowing is appropriate.
+ */
+export function readField(obj, key) {
+    return obj[key];
+}
+/**
+ * Write a dynamic property by string key onto a Model instance (or any
+ * object with typed fields). Mirror of {@link readField}.
+ */
+export function writeField(obj, key, value) {
+    obj[key] = value;
+}
+/**
+ * Delete a dynamic property by string key on a Model instance.
+ * Mirror of {@link readField}. Used by `instance.refresh()` when pruning
+ * stale fields before re-reading the row.
+ */
+export function deleteField(obj, key) {
+    delete obj[key];
+}
+/**
+ * Loose attribute equality used by dirty tracking and relation predicates.
+ * Handles primitives, nulls, Dates (by getTime), and plain objects (by JSON
+ * round-trip). Returns false for objects that don't round-trip cleanly.
+ */
+export function attrEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null && b == null)
+        return true;
+    if (a instanceof Date && b instanceof Date)
+        return a.getTime() === b.getTime();
+    if (typeof a === 'object' && a !== null && typeof b === 'object' && b !== null) {
+        try {
+            return JSON.stringify(a) === JSON.stringify(b);
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC5B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,OAAQ,GAA+B,CAAC,GAAG,CAAC,CAAA;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,GAAW,EAAE,KAAc;IAChE,GAA+B,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW;IAClD,OAAQ,GAA+B,CAAC,GAAG,CAAC,CAAA;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;IAC9E,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/E,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAA;QAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rudderjs/orm",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -8,6 +8,9 @@
     "directory": "packages/orm"
   },
   "type": "module",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "files": [
     "dist",
     "boost"
@@ -29,7 +32,7 @@
     }
   },
   "dependencies": {
-    "@rudderjs/contracts": "^1.6.0"
+    "@rudderjs/contracts": "^1.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",