@venizia/ignis-connectors 0.2.0-42 → 0.2.0-44

package/dist/cjs/relational/core/datasources/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAO/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAEtF,+EAA+E;AAC/E,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,EAChB,UAAU,GAAG,OAAO,CACpB,SAAQ,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,CAAC;gBACnF,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE,wEAAwE;IAC/D,SAAS,IAAI,MAAM;IAK5B,SAAS,CAAC,cAAc,IAAI,MAAM;IA2BlC,qBAAqB,IAAI,OAAO;IAKvB,eAAe;;;IAIT,gBAAgB,CAC7B,IAAI,CAAC,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IA4D9C,2LAA2L;IAC3L,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,6BAA6B,GAAG,MAAM;CACrF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/base.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAO/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAGtF,+EAA+E;AAC/E,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,EAChB,UAAU,GAAG,OAAO,CACpB,SAAQ,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,CAAC;gBACnF,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE,wEAAwE;IAC/D,SAAS,IAAI,MAAM;IAK5B,SAAS,CAAC,cAAc,IAAI,MAAM;IAgDlC,qBAAqB,IAAI,OAAO;IAKvB,eAAe;;;IAIT,gBAAgB,CAC7B,IAAI,CAAC,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IA4D9C,2LAA2L;IAC3L,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,6BAA6B,GAAG,MAAM;CACrF"}

package/dist/cjs/relational/core/datasources/base.js

@@ -5,12 +5,13 @@ const ignis_kernel_1 = require("@venizia/ignis-kernel");
 const ignis_kernel_2 = require("@venizia/ignis-kernel");
 const core_1 = require("@venizia/ignis-helpers/core");
 // Deep import, not a barrel: `discoverSchema()` below is the only production call site that needs
-// `createRelations`, so the install runs from here rather than `dialect/relation.ts` - nothing else
+// `createRelations`, so the install runs from here rather than `dialect/relations/create.ts` - nothing else
 // value-imports that file's `createRelations` export, and a `sideEffects: false` bundler drops an
 // unused export's module body even when it is reachable through a barrel `export *` chain (verified
 // with `bun build --target=browser`, the tool `make purity` uses).
-const relation_1 = require("../repositories/dialect/relation");
+const create_1 = require("../repositories/dialect/relations/create");
 const abstract_1 = require("./abstract");
+const relation_pairing_1 = require("./relation-pairing");
 /** Base DataSource with schema auto-discovery from registered repositories. */
 class BaseRelationalDataSource extends abstract_1.AbstractRelationalDataSource {
     constructor(opts) {
@@ -40,8 +41,26 @@ class BaseRelationalDataSource extends abstract_1.AbstractRelationalDataSource {
         this.logger
             .for(this.discoverSchema.name)
             .debug('Detected model(s) | Name: %s | Count: %s | Models: %j', this.name, models.length, models);
+        const discovered = { ...schema, ...relations };
+        // An inverse one() nothing pairs fails here; any other relation drizzle cannot pair is only
+        // reported, so a model set that boots today keeps booting, and its first query still throws.
+        const { unpaired, outside } = relation_pairing_1.RelationPairing.inspect({
+            dataSource: this.constructor.name,
+            schema: discovered,
+        });
+        const fatal = unpaired.find(item => relation_pairing_1.RelationPairing.isInverseOne({ relation: item.relation }));
+        if (fatal) {
+            throw (0, core_1.getError)({ message: fatal.message });
+        }
+        const logger = this.logger.for(this.discoverSchema.name);
+        for (const item of unpaired) {
+            logger.warn(item.message);
+        }
+        if (outside.length > 0) {
+            logger.debug(relation_pairing_1.RelationPairing.describeOutside({ outside }));
+        }
         // buildSchema() is shared by every connector so it returns Record<string, unknown>; the cast narrows back to the Drizzle schema shape.
-        return { ...schema, ...relations };
+        return discovered;
     }
     hasDiscoverableModels() {
         const registry = ignis_kernel_1.MetadataRegistry.getInstance();
@@ -104,5 +123,5 @@ exports.BaseRelationalDataSource = BaseRelationalDataSource;
 // Runs once this module loads. Every engine (postgres, sqlite) extends `BaseRelationalDataSource`,
 // and `discoverSchema()` above is the sole caller of `resolveModelRelations()`, so this is the one
 // place guaranteed to load whenever relation building is actually needed.
-ignis_kernel_2.RelationBuilderRegistry.set({ builder: relation_1.createRelations });
+ignis_kernel_2.RelationBuilderRegistry.set({ builder: create_1.createRelations });
 //# sourceMappingURL=base.js.map

package/dist/cjs/relational/core/datasources/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/base.ts"],"names":[],"mappings":";;;AAAA,wDAAyD;AACzD,wDAAuF;AAEvF,sDAAuD;AAEvD,kGAAkG;AAClG,4GAA4G;AAC5G,kGAAkG;AAClG,oGAAoG;AACpG,mEAAmE;AACnE,oFAA0F;AAC1F,yCAA0D;AAE1D,yDAAqD;AAErD,+EAA+E;AAC/E,MAAsB,wBAMpB,SAAQ,uCAAuF;IAC/F,YAAY,IAAyD;QACnE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,wEAAwE;IAC/D,SAAS;QAChB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAES,cAAc;QACtB,MAAM,QAAQ,GAAG,+BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAE9E,IAAI,QAAQ,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,gCAAgC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7F,OAAO,EAAY,CAAC;QACtB,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC;YACjD,UAAU,EAAE,IAAI,CAAC,WAAkC;SACpD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aAC7B,KAAK,CACJ,uDAAuD,EACvD,IAAI,CAAC,IAAI,EACT,MAAM,CAAC,MAAM,EACb,MAAM,CACP,CAAC;QAEJ,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QAE/C,4FAA4F;QAC5F,6FAA6F;QAC7F,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,kCAAe,CAAC,OAAO,CAAC;YACpD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACjC,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,kCAAe,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC/F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACzD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,kCAAe,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,uIAAuI;QACvI,OAAO,UAAoB,CAAC;IAC9B,CAAC;IAED,qBAAqB;QACnB,MAAM,QAAQ,GAAG,+BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAkC,EAAE,CAAC,CAAC;IACrF,CAAC;IAEQ,eAAe;QACtB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC7B,IAAoC;QAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAE5F,oLAAoL;YACpL,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAE7B,uMAAuM;QACvM,MAAM,MAAM,GAAG,KAAK,EAAE,UAA+C,EAAiB,EAAE;YACtF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;YAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,4NAA4N;gBAC5N,IAAI,gBAAgB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC5C,IAAI,CAAC,MAAM;yBACR,GAAG,CAAC,IAAI,CAAC;yBACT,KAAK,CAAC,uEAAuE,CAAC,CAAC;oBAClF,OAAO;gBACT,CAAC;gBAED,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,iBAAiB,IAAI,6BAA6B,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,uKAAuK;YACvK,QAAQ,GAAG,KAAK,CAAC;YAEjB,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,sCAAsC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBACtF,gBAAgB,GAAG,IAAI,CAAC;gBACxB,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,UAAU,CAAC,SAAS;YAE/B,IAAI,QAAQ;gBACV,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC7D,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;CAIF;AAjJD,4DAiJC;AAED,mGAAmG;AACnG,mGAAmG;AACnG,0EAA0E;AAC1E,sCAAuB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,wBAAmC,EAAE,CAAC,CAAC"}

package/dist/cjs/relational/core/datasources/relation-pairing.d.ts

@@ -0,0 +1,37 @@
+import type { Relation } from 'drizzle-orm';
+/** A relation drizzle cannot pair, with the message that names it and its fix. */
+interface IUnpairedRelation {
+    relation: Relation;
+    message: string;
+}
+/** What a datasource's schema discovery learns about its relations. */
+interface IRelationPairingReport {
+    /** Relations drizzle cannot pair, though their target has a model on the datasource. */
+    unpaired: Array<IUnpairedRelation>;
+    /** `Entity.relation -> Table` for each relation whose table has no model on the datasource. */
+    outside: Array<string>;
+}
+/**
+ * Pairs every relation the way drizzle does on the first query that includes it, so schema
+ * discovery can report - or refuse - what that query would hit. A relation whose table has no
+ * model on the datasource is kept apart: a datasource that carries a subset of models on purpose
+ * is a normal shape, not a defect.
+ */
+export declare class RelationPairing {
+    static inspect(opts: {
+        dataSource: string;
+        schema: Record<string, unknown>;
+    }): IRelationPairingReport;
+    /** An inverse one() - no fields of its own - exists only through the relation that pairs it. */
+    static isInverseOne(opts: {
+        relation: Relation;
+    }): boolean;
+    /** One line for every relation that points outside the datasource. */
+    static describeOutside(opts: {
+        outside: Array<string>;
+    }): string;
+    /** The fix for a relation drizzle cannot pair, in the entities' own names. */
+    private static buildUnpairedHint;
+}
+export {};
+//# sourceMappingURL=relation-pairing.d.ts.map

package/dist/cjs/relational/core/datasources/relation-pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-pairing.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/relation-pairing.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,kFAAkF;AAClF,UAAU,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,UAAU,sBAAsB;IAC9B,wFAAwF;IACxF,QAAQ,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACnC,+FAA+F;IAC/F,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,sBAAsB;IAiC1B,gGAAgG;IAChG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO;IAI1D,sEAAsE;IACtE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,MAAM;IAMhE,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAYjC"}

package/dist/cjs/relational/core/datasources/relation-pairing.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationPairing = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+/**
+ * Pairs every relation the way drizzle does on the first query that includes it, so schema
+ * discovery can report - or refuse - what that query would hit. A relation whose table has no
+ * model on the datasource is kept apart: a datasource that carries a subset of models on purpose
+ * is a normal shape, not a defect.
+ */
+class RelationPairing {
+    static inspect(opts) {
+        const { dataSource, schema } = opts;
+        const { tables, tableNamesMap } = (0, drizzle_orm_1.extractTablesRelationalConfig)(schema, drizzle_orm_1.createTableRelationsHelpers);
+        const unpaired = [];
+        const outside = [];
+        for (const [entity, table] of Object.entries(tables)) {
+            for (const [name, relation] of Object.entries(table.relations)) {
+                const target = tableNamesMap[(0, drizzle_orm_1.getTableUniqueName)(relation.referencedTable)];
+                if (!target) {
+                    outside.push(`${entity}.${name} -> ${(0, drizzle_orm_1.getTableName)(relation.referencedTable)}`);
+                    continue;
+                }
+                try {
+                    (0, drizzle_orm_1.normalizeRelation)(tables, tableNamesMap, relation);
+                }
+                catch (error) {
+                    const reason = error instanceof Error ? error.message : String(error);
+                    unpaired.push({
+                        relation,
+                        message: `[${dataSource}][discoverSchema] Cannot resolve relation '${name}' on entity '${entity}': ${reason} | ${RelationPairing.buildUnpairedHint({ entity, target, relation })}`,
+                    });
+                }
+            }
+        }
+        return { unpaired, outside };
+    }
+    /** An inverse one() - no fields of its own - exists only through the relation that pairs it. */
+    static isInverseOne(opts) {
+        return (0, drizzle_orm_1.is)(opts.relation, drizzle_orm_1.One) && !opts.relation.config;
+    }
+    /** One line for every relation that points outside the datasource. */
+    static describeOutside(opts) {
+        const { outside } = opts;
+        const count = outside.length === 1 ? '1 relation points' : `${outside.length} relations point`;
+        return `${count} to a table outside this datasource: ${outside.join(', ')} | A query that includes one fails here; bind that model to this datasource if you need it`;
+    }
+    /** The fix for a relation drizzle cannot pair, in the entities' own names. */
+    static buildUnpairedHint(opts) {
+        const { entity, target, relation } = opts;
+        if ((0, drizzle_orm_1.is)(relation, drizzle_orm_1.Many)) {
+            return `A many() pairs with the one() on '${target}' named '${relation.relationName}' - a one() is named by its key, or by its relationName if it sets one | Add that one() on '${target}', pointing back to '${entity}', or set relationName here to the name of the one() already there`;
+        }
+        return `'${target}' holds the foreign key, so this one() pairs with the one relation there that points back to '${entity}' - there must be exactly one | Add that one() on '${target}', or write fields and references on this side`;
+    }
+}
+exports.RelationPairing = RelationPairing;
+//# sourceMappingURL=relation-pairing.js.map

package/dist/cjs/relational/core/datasources/relation-pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-pairing.js","sourceRoot":"","sources":["../../../../../src/relational/core/datasources/relation-pairing.ts"],"names":[],"mappings":";;;AAAA,6CASqB;AAiBrB;;;;;GAKG;AACH,MAAa,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,IAGd;QACC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACpC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,2CAA6B,EAC7D,MAAM,EACN,yCAA2B,CAC5B,CAAC;QAEF,MAAM,QAAQ,GAA6B,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,IAAA,gCAAkB,EAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,OAAO,IAAA,0BAAY,EAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;oBAC/E,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,IAAA,+BAAiB,EAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;gBACrD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACtE,QAAQ,CAAC,IAAI,CAAC;wBACZ,QAAQ;wBACR,OAAO,EAAE,IAAI,UAAU,8CAA8C,IAAI,gBAAgB,MAAM,MAAM,MAAM,MAAM,eAAe,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;qBACnL,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,gGAAgG;IAChG,MAAM,CAAC,YAAY,CAAC,IAA4B;QAC9C,OAAO,IAAA,gBAAE,EAAC,IAAI,CAAC,QAAQ,EAAE,iBAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IACzD,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,eAAe,CAAC,IAAgC;QACrD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,kBAAkB,CAAC;QAC/F,OAAO,GAAG,KAAK,wCAAwC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4FAA4F,CAAC;IACxK,CAAC;IAED,8EAA8E;IACtE,MAAM,CAAC,iBAAiB,CAAC,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1C,IAAI,IAAA,gBAAE,EAAC,QAAQ,EAAE,kBAAI,CAAC,EAAE,CAAC;YACvB,OAAO,qCAAqC,MAAM,YAAY,QAAQ,CAAC,YAAY,+FAA+F,MAAM,wBAAwB,MAAM,oEAAoE,CAAC;QAC7R,CAAC;QACD,OAAO,IAAI,MAAM,iGAAiG,MAAM,sDAAsD,MAAM,gDAAgD,CAAC;IACvO,CAAC;CACF;AA9DD,0CA8DC"}

package/dist/cjs/relational/core/models/base.d.ts

@@ -2,7 +2,7 @@ import type { TIdSchemaType, TSchemaType } from '@venizia/ignis-kernel';
 import { AbstractEntity } from '@venizia/ignis-kernel';
 import type { TRelationConfig } from '../repositories/common';
 import type { TValueOrResolver } from '@venizia/ignis-helpers/common';
-import { createSchemaFactory } from 'drizzle-zod';
+import type { Table } from 'drizzle-orm';
 import type { IEntity, TTableInsert, TTableObject, TTableSchemaWithId } from './common';
 /** Base entity with Drizzle ORM support. Supports static schema or constructor-based schema. */
 export declare class BaseRelationalEntity<Schema extends TTableSchemaWithId = TTableSchemaWithId> extends AbstractEntity implements IEntity<Schema> {
@@ -11,11 +11,9 @@ export declare class BaseRelationalEntity<Schema extends TTableSchemaWithId = TT
     readonly $inferPersist?: TTableInsert<Schema>;
     static TABLE_NAME?: string;
     static AUTHORIZATION_SUBJECT?: string;
-    static schema: TTableSchemaWithId;
+    /** A carrier, deliberately widened to `Table`: a factory-built entity knows its table precisely, and a narrower static would reject that precise type. The CONTRACT stays on the instance, typed `Schema`. */
+    static schema: Table;
     static relations?: TValueOrResolver<Array<TRelationConfig>>;
-    /** Lazy singleton - shared across all BaseRelationalEntity instances. */
-    private static _schemaFactory?;
-    protected static get schemaFactory(): ReturnType<typeof createSchemaFactory>;
     constructor(opts?: {
         name?: string;
         schema?: Schema;

package/dist/cjs/relational/core/models/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAe,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGxF,gGAAgG;AAChG,qBAAa,oBAAoB,CAAC,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,CACtF,SAAQ,cACR,YAAW,OAAO,CAAC,MAAM,CAAC;IAE1B,MAAM,EAAE,MAAM,CAAC;IAGf,SAAiB,UAAU,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,SAAiB,aAAa,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAEtC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAClC,MAAM,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAE5D,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAyC;IACvE,SAAS,CAAC,MAAM,KAAK,aAAa,IAAI,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAE3E;gBAEW,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IASrD,6IAA6I;IACpI,SAAS,IAAI,aAAa;IAInC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;CAoBvD"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAe,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAQxF,gGAAgG;AAChG,qBAAa,oBAAoB,CAAC,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,CACtF,SAAQ,cACR,YAAW,OAAO,CAAC,MAAM,CAAC;IAE1B,MAAM,EAAE,MAAM,CAAC;IAGf,SAAiB,UAAU,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,SAAiB,aAAa,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAEtC,8MAA8M;IAC9M,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IACrB,MAAM,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;gBAEhD,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IASrD,6IAA6I;IACpI,SAAS,IAAI,aAAa;IAInC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;CAoBvD"}

package/dist/cjs/relational/core/models/base.js

@@ -5,11 +5,11 @@ const ignis_kernel_1 = require("@venizia/ignis-kernel");
 const core_1 = require("@venizia/ignis-helpers/core");
 const drizzle_zod_1 = require("drizzle-zod");
 const common_1 = require("./common");
+/** Lazy singleton, shared by every entity. */
+let schemaFactory;
+const getSchemaFactory = () => (schemaFactory ??= (0, drizzle_zod_1.createSchemaFactory)());
 /** Base entity with Drizzle ORM support. Supports static schema or constructor-based schema. */
 class BaseRelationalEntity extends ignis_kernel_1.AbstractEntity {
-    static get schemaFactory() {
-        return (BaseRelationalEntity._schemaFactory ??= (0, drizzle_zod_1.createSchemaFactory)());
-    }
     constructor(opts) {
         const ctor = new.target;
         const name = opts?.name ?? ctor.TABLE_NAME ?? ctor.name;
@@ -21,7 +21,7 @@ class BaseRelationalEntity extends ignis_kernel_1.AbstractEntity {
         return (0, common_1.getIdType)({ entity: this.schema }) === 'number' ? 'number' : 'string';
     }
     getSchema(opts) {
-        const factory = BaseRelationalEntity.schemaFactory;
+        const factory = getSchemaFactory();
         switch (opts.type) {
             case ignis_kernel_1.SchemaTypes.CREATE: {
                 return factory.createInsertSchema(this.schema);

package/dist/cjs/relational/core/models/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/base.ts"],"names":[],"mappings":";;;AACA,wDAAoE;AAGpE,sDAAuD;AACvD,6CAAkD;AAElD,qCAAmD;AAEnD,gGAAgG;AAChG,MAAa,oBACX,SAAQ,6BAAc;IAiBZ,MAAM,KAAK,aAAa;QAChC,OAAO,CAAC,oBAAoB,CAAC,cAAc,KAAK,IAAA,iCAAmB,GAAE,CAAC,CAAC;IACzE,CAAC;IAED,YAAY,IAAyC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAqC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC;QAExD,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAK,IAAI,CAAC,MAAiB,CAAC;IACxD,CAAC;IAED,6IAA6I;IACpI,SAAS;QAChB,OAAO,IAAA,kBAAU,EAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChF,CAAC;IAED,SAAS,CAAc,IAA2B;QAChD,MAAM,OAAO,GAAG,oBAAoB,CAAC,aAAa,CAAC;QAEnD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,2CAA2C,IAAI,CAAC,IAAI,aAAa,CAAC,0BAAW,CAAC,MAAM,EAAE,0BAAW,CAAC,MAAM,EAAE,0BAAW,CAAC,MAAM,CAAC,EAAE;iBACzI,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAxDD,oDAwDC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/base.ts"],"names":[],"mappings":";;;AACA,wDAAoE;AAGpE,sDAAuD;AACvD,6CAAkD;AAGlD,qCAAmD;AAEnD,8CAA8C;AAC9C,IAAI,aAAiE,CAAC;AACtE,MAAM,gBAAgB,GAAG,GAA2C,EAAE,CACpE,CAAC,aAAa,KAAK,IAAA,iCAAmB,GAAE,CAAC,CAAC;AAE5C,gGAAgG;AAChG,MAAa,oBACX,SAAQ,6BAAc;IAgBtB,YAAY,IAAyC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAqC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC;QAExD,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAK,IAAI,CAAC,MAAiB,CAAC;IACxD,CAAC;IAED,6IAA6I;IACpI,SAAS;QAChB,OAAO,IAAA,kBAAU,EAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChF,CAAC;IAED,SAAS,CAAc,IAA2B;QAChD,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QAEnC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,KAAK,0BAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxB,OAAO,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;YACtD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,eAAQ,EAAC;oBACb,OAAO,EAAE,2CAA2C,IAAI,CAAC,IAAI,aAAa,CAAC,0BAAW,CAAC,MAAM,EAAE,0BAAW,CAAC,MAAM,EAAE,0BAAW,CAAC,MAAM,CAAC,EAAE;iBACzI,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnDD,oDAmDC"}

package/dist/cjs/relational/core/models/common/types.d.ts

@@ -1,4 +1,5 @@
 import type { IdType } from '@venizia/ignis-kernel';
+import { RelationTypes } from '@venizia/ignis-kernel';
 import type { TRelationConfig } from '../../repositories/common';
 import type { TValueOrResolver } from '@venizia/ignis-helpers/common';
 import type { AnyColumn, ColumnBuilderBase, IsPrimaryKey, NotNull, Table, TableConfig } from 'drizzle-orm';
@@ -27,4 +28,48 @@ export interface IEntity<Schema extends TTableSchemaWithId = TTableSchemaWithId>
     schema: Schema;
     relations?: TValueOrResolver<Array<TRelationConfig>>;
 }
+/** The drizzle relation options for a given relation type, as its helper declares them. */
+export type TRelationMetadata<Type extends TRelationConfig['type']> = Extract<TRelationConfig, {
+    type: Type;
+}>['metadata'];
+export interface IManyRelation<Schema extends TTableSchemaWithId = TTableSchemaWithId> {
+    type: typeof RelationTypes.MANY;
+    schema: Schema;
+    metadata?: TRelationMetadata<typeof RelationTypes.MANY>;
+}
+export interface IOneRelation<Schema extends TTableSchemaWithId = TTableSchemaWithId> {
+    type: typeof RelationTypes.ONE;
+    schema: Schema;
+    metadata?: TRelationMetadata<typeof RelationTypes.ONE>;
+}
+export type TRelationDefinition = IManyRelation | IOneRelation;
+/**
+ * Relations keyed by name. Each points at a SCHEMA, never at another entity: an entity reference
+ * across two files that import each other collapses to `any` under TS7022, silently.
+ */
+export type TRelationDefinitions = Record<string, TRelationDefinition>;
+/**
+ * The entity shape {@link TEntityObject} reads: a class whose instances carry their row type, plus
+ * its relations. The row is read off the INSTANCE - the class's static `schema` is widened to
+ * `Table` on the base, and a row read through it would take `Table`'s index signature and let
+ * every unknown key through.
+ */
+export interface IDefinedEntity<Relations extends TRelationDefinitions = TRelationDefinitions> {
+    new (...args: never): {
+        $inferData?: unknown;
+    };
+    /** Undefined when the entity declares no relations. */
+    relationDefinitions: Relations | undefined;
+}
+type TRowOf<Entity> = Entity extends new (...args: never) => {
+    $inferData?: infer Row;
+} ? NonNullable<Row> : never;
+type TDefinitionsOf<Entity extends IDefinedEntity> = NonNullable<Entity['relationDefinitions']>;
+/** A row of the entity plus its relations, so a relation is declared once instead of twice. */
+export type TEntityObject<Entity extends IDefinedEntity> = TRowOf<Entity> & {
+    [Name in keyof TDefinitionsOf<Entity>]?: TDefinitionsOf<Entity>[Name] extends {
+        type: typeof RelationTypes.MANY;
+    } ? Array<TTableObject<TDefinitionsOf<Entity>[Name]['schema']>> : TTableObject<TDefinitionsOf<Entity>[Name]['schema']>;
+};
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/relational/core/models/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/models/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,KAAK,EACL,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAAC;CAC7C,CAAC;AACF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,iBAAiB,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhF,qMAAqM;AACrM,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEpD,sIAAsI;AACtI,MAAM,MAAM,kBAAkB,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG;IACjF,EAAE,EAAE,SAAS,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,kBAAkB,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC;AAC3E,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,kBAAkB,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC;AAC3E,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,kBAAkB,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE7E,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,kBAAkB,EAAE,MAAM;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,yCAE1E,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,OAAO,CAAC,MAAM,SAAS,kBAAkB,GAAG,kBAAkB;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;CACtD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/models/common/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/relational/core/models/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/relational/core/models/common/types.ts"],"names":[],"mappings":";;;AA8BO,MAAM,SAAS,GAAG,CAA+B,IAAmB,EAAE,EAAE;IAC7E,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,IAAI,SAAS,CAAC;AAChD,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/relational/core/models/common/types.ts"],"names":[],"mappings":";;;AA+BO,MAAM,SAAS,GAAG,CAA+B,IAAmB,EAAE,EAAE;IAC7E,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,IAAI,SAAS,CAAC;AAChD,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB"}

package/dist/cjs/relational/core/models/factory.d.ts

@@ -0,0 +1,29 @@
+import type { TValueOrResolver } from '@venizia/ignis-helpers/common';
+import type { TRelationConfig } from '../repositories/common';
+import { BaseRelationalEntity } from './base';
+import type { TRelationDefinitions, TTableSchemaWithId } from './common';
+/**
+ * The class `defineEntity` returns: every static and instance member of a hand-written
+ * `BaseRelationalEntity<Schema>`, with the table and the relations typed precisely. Named, so a
+ * consumer's declaration output can reference it.
+ */
+export type TDefinedEntityClass<Schema extends TTableSchemaWithId, Relations extends TRelationDefinitions> = typeof BaseRelationalEntity<Schema> & {
+    readonly TABLE_NAME: string;
+    readonly schema: Schema;
+    /** Undefined when the entity declares no relations. */
+    readonly relationDefinitions: Relations | undefined;
+    readonly relations: TValueOrResolver<Array<TRelationConfig>>;
+};
+/** Builds an entity class from its table, so a model states each fact once. */
+export declare class ModelFactory {
+    /**
+     * The table comes first, as a plain drizzle table (`pgTable`, `pgSchema(...).table`,
+     * `sqliteTable`): relations point at TABLES, so two entities that relate to each other never
+     * import each other, and the compiler keeps both row types.
+     */
+    static defineEntity<Schema extends TTableSchemaWithId, Relations extends TRelationDefinitions = {}>(opts: {
+        table: Schema;
+        relations?: () => Relations;
+    }): TDefinedEntityClass<Schema, Relations>;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/cjs/relational/core/models/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGzE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,kBAAkB,EACjC,SAAS,SAAS,oBAAoB,IACpC,OAAO,oBAAoB,CAAC,MAAM,CAAC,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF,+EAA+E;AAC/E,qBAAa,YAAY;IACvB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CACjB,MAAM,SAAS,kBAAkB,EACjC,SAAS,SAAS,oBAAoB,GAAG,EAAE,EAC3C,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,SAAS,CAAA;KAAE,GAAG,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC;CA+BhG"}

package/dist/cjs/relational/core/models/factory.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelFactory = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+const base_1 = require("./base");
+const relations_1 = require("./relations");
+/** Builds an entity class from its table, so a model states each fact once. */
+class ModelFactory {
+    /**
+     * The table comes first, as a plain drizzle table (`pgTable`, `pgSchema(...).table`,
+     * `sqliteTable`): relations point at TABLES, so two entities that relate to each other never
+     * import each other, and the compiler keeps both row types.
+     */
+    static defineEntity(opts) {
+        const { table, relations } = opts;
+        // Read on first use, not here: a thunk run at definition time throws for a table declared
+        // later in the file, or on the far side of a circular import.
+        let definitions;
+        let configs;
+        const readDefinitions = () => {
+            if (definitions === undefined && relations) {
+                definitions = relations();
+            }
+            return definitions;
+        };
+        class DefinedEntity extends base_1.BaseRelationalEntity {
+            static { this.TABLE_NAME = (0, drizzle_orm_1.getTableName)(table); }
+            static { this.schema = table; }
+            static get relationDefinitions() {
+                return readDefinitions();
+            }
+            static { this.relations = () => {
+                configs ??= (0, relations_1.toRelationConfigs)({ relations: readDefinitions() ?? {} });
+                return configs;
+            }; }
+        }
+        return DefinedEntity;
+    }
+}
+exports.ModelFactory = ModelFactory;
+//# sourceMappingURL=factory.js.map

package/dist/cjs/relational/core/models/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/factory.ts"],"names":[],"mappings":";;;AACA,6CAA2C;AAE3C,iCAA8C;AAE9C,2CAAgD;AAkBhD,+EAA+E;AAC/E,MAAa,YAAY;IACvB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAGjB,IAAoD;QACpD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElC,0FAA0F;QAC1F,8DAA8D;QAC9D,IAAI,WAAkC,CAAC;QACvC,IAAI,OAA2C,CAAC;QAEhD,MAAM,eAAe,GAAG,GAA0B,EAAE;YAClD,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3C,WAAW,GAAG,SAAS,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,WAAW,CAAC;QACrB,CAAC,CAAC;QAEF,MAAM,aAAc,SAAQ,2BAA4B;qBAC7B,eAAU,GAAW,IAAA,0BAAY,EAAC,KAAK,CAAC,CAAC;qBACzC,WAAM,GAAW,KAAK,CAAC;YAEhD,MAAM,KAAK,mBAAmB;gBAC5B,OAAO,eAAe,EAAE,CAAC;YAC3B,CAAC;qBAEwB,cAAS,GAA6C,GAAG,EAAE;gBAClF,OAAO,KAAK,IAAA,6BAAiB,EAAC,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtE,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC;;QAGJ,OAAO,aAAa,CAAC;IACvB,CAAC;CACF;AAxCD,oCAwCC"}

package/dist/cjs/relational/core/models/index.d.ts

@@ -1,4 +1,6 @@
 export * from './base';
 export * from './common';
 export * from './enrichers';
+export * from './factory';
+export * from './relations';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/relational/core/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/cjs/relational/core/models/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base"), exports);
 __exportStar(require("./common"), exports);
 __exportStar(require("./enrichers"), exports);
+__exportStar(require("./factory"), exports);
+__exportStar(require("./relations"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/relational/core/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B"}

package/dist/cjs/relational/core/models/relations.d.ts

@@ -0,0 +1,13 @@
+import { RelationTypes } from '@venizia/ignis-kernel';
+import type { TRelationConfig } from '../repositories/common';
+import type { TTableSchemaWithId } from './common';
+import type { IManyRelation, IOneRelation, TRelationDefinitions, TRelationMetadata } from './common';
+/** Declares a to-many relation to `schema`. */
+export declare const many: <Schema extends TTableSchemaWithId>(schema: Schema, metadata?: TRelationMetadata<typeof RelationTypes.MANY>) => IManyRelation<Schema>;
+/** Declares a to-one relation to `schema`. */
+export declare const one: <Schema extends TTableSchemaWithId>(schema: Schema, metadata?: TRelationMetadata<typeof RelationTypes.ONE>) => IOneRelation<Schema>;
+/** Flattens the keyed form into the array shape the query dialect reads, taking each relation's name from its key. */
+export declare const toRelationConfigs: (opts: {
+    relations: TRelationDefinitions;
+}) => Array<TRelationConfig>;
+//# sourceMappingURL=relations.d.ts.map

package/dist/cjs/relational/core/models/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../../../src/relational/core/models/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,+CAA+C;AAC/C,eAAO,MAAM,IAAI,GAAI,MAAM,SAAS,kBAAkB,EACpD,QAAQ,MAAM,EACd,WAAW,iBAAiB,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,KACtD,aAAa,CAAC,MAAM,CAAqD,CAAC;AAE7E,8CAA8C;AAC9C,eAAO,MAAM,GAAG,GAAI,MAAM,SAAS,kBAAkB,EACnD,QAAQ,MAAM,EACd,WAAW,iBAAiB,CAAC,OAAO,aAAa,CAAC,GAAG,CAAC,KACrD,YAAY,CAAC,MAAM,CAAoD,CAAC;AAE3E,sHAAsH;AACtH,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,SAAS,EAAE,oBAAoB,CAAC;CACjC,KAAG,KAAK,CAAC,eAAe,CAaxB,CAAC"}

package/dist/cjs/relational/core/models/relations.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRelationConfigs = exports.one = exports.many = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+/** Declares a to-many relation to `schema`. */
+const many = (schema, metadata) => ({ type: ignis_kernel_1.RelationTypes.MANY, schema, metadata });
+exports.many = many;
+/** Declares a to-one relation to `schema`. */
+const one = (schema, metadata) => ({ type: ignis_kernel_1.RelationTypes.ONE, schema, metadata });
+exports.one = one;
+/** Flattens the keyed form into the array shape the query dialect reads, taking each relation's name from its key. */
+const toRelationConfigs = (opts) => {
+    const { relations } = opts;
+    const configs = [];
+    for (const [name, relation] of Object.entries(relations)) {
+        configs.push(relation.type === ignis_kernel_1.RelationTypes.MANY
+            ? { name, type: ignis_kernel_1.RelationTypes.MANY, schema: relation.schema, metadata: relation.metadata }
+            : { name, type: ignis_kernel_1.RelationTypes.ONE, schema: relation.schema, metadata: relation.metadata });
+    }
+    return configs;
+};
+exports.toRelationConfigs = toRelationConfigs;
+//# sourceMappingURL=relations.js.map

package/dist/cjs/relational/core/models/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../../../../src/relational/core/models/relations.ts"],"names":[],"mappings":";;;AAAA,wDAAsD;AAUtD,+CAA+C;AACxC,MAAM,IAAI,GAAG,CAClB,MAAc,EACd,QAAuD,EAChC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,4BAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAHhE,QAAA,IAAI,QAG4D;AAE7E,8CAA8C;AACvC,MAAM,GAAG,GAAG,CACjB,MAAc,EACd,QAAsD,EAChC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,4BAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAH9D,QAAA,GAAG,OAG2D;AAE3E,sHAAsH;AAC/G,MAAM,iBAAiB,GAAG,CAAC,IAEjC,EAA0B,EAAE;IAC3B,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC3B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CACV,QAAQ,CAAC,IAAI,KAAK,4BAAa,CAAC,IAAI;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,4BAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;YAC1F,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,4BAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAfW,QAAA,iBAAiB,qBAe5B"}

package/dist/cjs/relational/core/repositories/common/types.d.ts

@@ -8,7 +8,8 @@ export type TRelationConfig = {
 } & ({
     type: typeof RelationTypes.ONE;
     schema: TTableSchemaWithId;
-    metadata: Parameters<ReturnType<typeof createTableRelationsHelpers>[typeof RelationTypes.ONE]>[1];
+    /** `fields` and `references` may be left out: they are read off the table's foreign key. */
+    metadata?: Partial<NonNullable<Parameters<ReturnType<typeof createTableRelationsHelpers>[typeof RelationTypes.ONE]>[1]>>;
 } | {
     type: typeof RelationTypes.MANY;
     schema: TTableSchemaWithId;

package/dist/cjs/relational/core/repositories/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/common/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/common/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/relational/core/repositories/dialect/index.d.ts

@@ -1,5 +1,5 @@
 export * from './filter';
 export * from './internal/json-utils';
-export * from './relation';
+export * from './relations';
 export * from './update';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/cjs/relational/core/repositories/dialect/index.js

@@ -18,6 +18,6 @@ __exportStar(require("./filter"), exports);
 // Exported despite living under internal/: a second engine composes its own path syntax on the same
 // parse and column checks.
 __exportStar(require("./internal/json-utils"), exports);
-__exportStar(require("./relation"), exports);
+__exportStar(require("./relations"), exports);
 __exportStar(require("./update"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/relational/core/repositories/dialect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,oGAAoG;AACpG,2BAA2B;AAC3B,wDAAsC;AACtC,6CAA2B;AAC3B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/core/repositories/dialect/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,oGAAoG;AACpG,2BAA2B;AAC3B,wDAAsC;AACtC,8CAA4B;AAC5B,2CAAyB"}

package/dist/cjs/relational/core/repositories/dialect/relations/common/constants.d.ts

@@ -0,0 +1,12 @@
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+/** The side of a `one` relation a declaration resolves to. */
+export declare class OneRelationSides {
+    /** Carries fields and references - written, or read off this table's foreign key. */
+    static readonly OWNING = "owning";
+    /** Carries nothing: the key is on the target, and drizzle pairs this side from there. */
+    static readonly INVERSE = "inverse";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): value is TOneRelationSide;
+}
+export type TOneRelationSide = TConstValue<typeof OneRelationSides>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/relations/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../../../src/relational/core/repositories/dialect/relations/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,8DAA8D;AAC9D,qBAAa,gBAAgB;IAC3B,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAgD;IAE1E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB;CAGzD;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/cjs/relational/core/repositories/dialect/relations/common/constants.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OneRelationSides = void 0;
+/** The side of a `one` relation a declaration resolves to. */
+class OneRelationSides {
+    /** Carries fields and references - written, or read off this table's foreign key. */
+    static { this.OWNING = 'owning'; }
+    /** Carries nothing: the key is on the target, and drizzle pairs this side from there. */
+    static { this.INVERSE = 'inverse'; }
+    static { this.SCHEME_SET = new Set([this.OWNING, this.INVERSE]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.OneRelationSides = OneRelationSides;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/relational/core/repositories/dialect/relations/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../../../src/relational/core/repositories/dialect/relations/common/constants.ts"],"names":[],"mappings":";;;AAEA,8DAA8D;AAC9D,MAAa,gBAAgB;IAC3B,qFAAqF;aACrE,WAAM,GAAG,QAAQ,CAAC;IAClC,yFAAyF;aACzE,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAVH,4CAWC"}

package/dist/cjs/relational/core/repositories/dialect/relations/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/relational/core/repositories/dialect/relations/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/relational/core/repositories/dialect/relations/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}