@venizia/ignis-kernel 0.4.1 → 0.4.3

package/dist/cjs/base/controllers/rest/abstract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAOzB,kHAAkH;AAClH,8BAAsB,sBAAsB,CAC1C,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAEvF,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAE5E,YAAY,UAAS;IACrB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IA2BpC,mEAAmE;IACnE,SAAS;IAIT,kJAAkJ;IAClJ,0BAA0B,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;KAAE,GAAG,IAAI;IAiC/E,0GAA0G;IACpG,SAAS,CACb,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAqBxD,uFAAuF;IACvF,qBAAqB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;;;;;IAkD1F,oFAAoF;IACpF,eAAe,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcpF,4EAA4E;IAC5E,kBAAkB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcvF,kEAAkE;IAClE,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAC7D,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAEnE,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACvF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CACtE"}
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAOzB,kHAAkH;AAClH,8BAAsB,sBAAsB,CAC1C,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAEvF,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAE5E,YAAY,UAAS;IACrB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;gBAEb,IAAI,EAAE,kBAAkB;IA2BpC,mEAAmE;IACnE,SAAS;IAIT,kJAAkJ;IAClJ,0BAA0B,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAoCpE,0GAA0G;IACpG,SAAS,CACb,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAqBxD,uFAAuF;IACvF,qBAAqB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;;;;;IAkD1F,oFAAoF;IACpF,eAAe,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcpF,4EAA4E;IAC5E,kBAAkB,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE;;;IAcvF,kEAAkE;IAClE,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,CAAC,WAAW,SAAS,gBAAgB,EAAE,IAAI,EAAE;QAC7D,OAAO,EAAE,WAAW,CAAC;KACtB,GAAG,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;IAEnE,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,WAAW,SAAS,gBAAgB,EAAE,YAAY,GAAG,OAAO,EAAE,IAAI,EAAE;QACvF,OAAO,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC;CACtE"}

package/dist/cjs/base/controllers/rest/abstract.js

@@ -8,6 +8,7 @@ const form_body_middleware_1 = require("../../middlewares/form-body/form-body.mi
 const strategy_registry_1 = require("../../auth/authenticate/strategies/strategy-registry");
 const common_1 = require("../../metadata/routes/common");
 const registry_1 = require("../../../helpers/inversion/registry");
+const constants_2 = require("../common/constants");
 const html_response_1 = require("../common/html-response");
 const zod_openapi_1 = require("@hono/zod-openapi");
 const core_1 = require("@venizia/ignis-helpers/core");
@@ -46,7 +47,7 @@ class AbstractRestController extends core_1.BaseHelper {
     }
     /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */
     registerRoutesFromRegistry(opts) {
-        const { paths = 'all' } = opts ?? {};
+        const { paths = constants_2.RoutePathScopes.ALL } = opts ?? {};
         const logger = this.logger.for(this.registerRoutesFromRegistry.name);
         common_1.DroppedRouteDecorators.report({ logger });
         const routes = registry_1.MetadataRegistry.getInstance().getRoutes({
@@ -57,7 +58,8 @@ class AbstractRestController extends core_1.BaseHelper {
         }
         const routeDefs = routes.entries();
         for (const [methodName, routeConfigs] of routeDefs) {
-            if (paths !== 'all' && hasPathParam({ path: routeConfigs.path }) !== (paths === 'param')) {
+            if (paths !== constants_2.RoutePathScopes.ALL &&
+                hasPathParam({ path: routeConfigs.path }) !== (paths === constants_2.RoutePathScopes.PARAM)) {
                 continue;
             }
             // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.
@@ -81,9 +83,9 @@ class AbstractRestController extends core_1.BaseHelper {
         const configureOptions = opts ?? {};
         logger.info('START | Binding controller | Options: %j', configureOptions);
         // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).
-        this.registerRoutesFromRegistry({ paths: 'static' });
+        this.registerRoutesFromRegistry({ paths: constants_2.RoutePathScopes.STATIC });
         await this.binding();
-        this.registerRoutesFromRegistry({ paths: 'param' });
+        this.registerRoutesFromRegistry({ paths: constants_2.RoutePathScopes.PARAM });
         this.isConfigured = true;
         logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);
         return this.router;

package/dist/cjs/base/controllers/rest/abstract.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":";;;AAAA,yEAAgF;AAChF,0GAA8G;AAE9G,iGAAkG;AAClG,4FAAgG;AAChG,6FAAuG;AACvG,0DAAuE;AACvE,2DAAgE;AAChE,2EAAuE;AAEvE,mDAA6D;AAE7D,sDAAmE;AAWnE,sGAAsG;AACtG,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAW,EAAE;IACvD,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,kHAAkH;AAClH,MAAsB,sBAOpB,SAAQ,iBAAU;IAQlB,YAAY,IAAwB;QAClC,KAAK,CAAC,IAAI,CAAC,CAAC;QANd,iBAAY,GAAG,KAAK,CAAC;QAOnB,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,iBAAiB,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC;YAC7E,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,iBAAiB,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAE1D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,+FAA+F;aAC5H,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAW,CAAkC;YAC7D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;gBAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,MAAM,CAAC,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,kJAAkJ;IAClJ,0BAA0B,CAAC,IAA6C;QACtE,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACrE,+BAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE1C,MAAM,MAAM,GAAG,2BAAgB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;YACtD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,KAAK,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;gBACzF,SAAS;YACX,CAAC;YAED,iKAAiK;YACjK,MAAM,OAAO,GAAI,IAAyC,CAAC,UAAU,CAAC,CAAC;YACvE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC7E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAG,OAA4C,CAAC,IAAI,CAAC,IAAI,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,SAAS,CACb,IAA0B;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,gBAAgB,CAAC,CAAC;QAE1E,uMAAuM;QACvM,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,uFAAuF;IACvF,qBAAqB,CAAuC,IAA8B;QACxF,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACrE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,IAAI,GAAG,+BAAmB,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;QAEzE,+FAA+F;QAC/F,+FAA+F;QAC/F,iGAAiG;QACjG,iGAAiG;QACjG,8BAA8B;QAC9B,kDAA8B,CAAC,WAAW,EAAE,CAAC,kBAAkB,CAAC;YAC9D,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;SAC7B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAwC,EAAE,CAAC;QAEpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAA,sCAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAyB,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,IAAA,gCAAW,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,MAAM,oBAAoB,GAAG,UAAU,CAAC,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YAClD,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE3B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,SAAS;YACX,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QAED,kFAAkF;QAClF,IAAI,IAAA,kCAAW,EAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,qCAAc,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IAED,oFAAoF;IACpF,eAAe,CAAuC,IAA8B;QAClF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAEjC,mPAAmP;QACnP,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kBAAkB,CAAuC,IAA8B;QACrF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC;QAE5C,qEAAqE;QACrE,OAAO,IAAA,yBAAW,EAChB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAA,4BAAY,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC;YACnF,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,QAAQ;SACT,CAAQ,CACV,CAAC;IACJ,CAAC;CAeF;AAxMD,wDAwMC","sourcesContent":["import { AuthenticationModes } from '@/base/auth/authenticate/common/constants';\nimport { authenticate as authenticateFn } from '@/base/auth/authenticate/middlewares/authenticate.middleware';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport { authorize as authorizeFn } from '@/base/auth/authorize/middlewares/authorize.middleware';\nimport { formBodyReader, hasFormBody } from '@/base/middlewares/form-body/form-body.middleware';\nimport { AuthenticationStrategyRegistry } from '@/base/auth/authenticate/strategies/strategy-registry';\nimport { DroppedRouteDecorators } from '@/base/metadata/routes/common';\nimport { MetadataRegistry } from '@/helpers/inversion/registry';\nimport { htmlResponse } from '@/base/controllers/common/html-response';\nimport type { Hook } from '@hono/zod-openapi';\nimport { createRoute, OpenAPIHono } from '@hono/zod-openapi';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport type { Env, Schema } from 'hono';\nimport type {\n  IAuthRouteConfig,\n  IBindRouteOptions,\n  IController,\n  IControllerOptions,\n  IDefineRouteOptions,\n  TRouteHandler,\n} from '../common/types';\n\n/** True for a route path carrying a path parameter, in either supported syntax: `/{id}` or `/:id`. */\nconst hasPathParam = (opts: { path: string }): boolean => {\n  return /\\{[^}]+\\}|:[^/]+/.test(opts.path);\n};\n\n/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */\nexport abstract class AbstractRestController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ConfigurableOptions extends object = {},\n  Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>,\n>\n  extends BaseHelper\n  implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions>\n{\n  isConfigured = false;\n  router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;\n  path: string;\n  definitions: Definitions;\n\n  constructor(opts: IControllerOptions) {\n    super(opts);\n    const { isStrict = true } = opts;\n\n    const decoratorMetadata = MetadataRegistry.getInstance().getControllerMetadata({\n      target: new.target,\n    });\n    const resolvedPath = decoratorMetadata?.path ?? opts.path;\n\n    if (!resolvedPath) {\n      throw getError({\n        message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,\n      });\n    }\n\n    this.path = resolvedPath;\n\n    this.router = new OpenAPIHono<RouteEnv, RouteSchema, BasePath>({\n      strict: isStrict,\n      defaultHook: (result, _context) => {\n        if (!result.success) {\n          throw result.error;\n        }\n      },\n    });\n  }\n\n  /** Returns the OpenAPIHono router instance for this controller. */\n  getRouter() {\n    return this.router;\n  }\n\n  /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */\n  registerRoutesFromRegistry(opts?: { paths?: 'static' | 'param' | 'all' }): void {\n    const { paths = 'all' } = opts ?? {};\n\n    const logger = this.logger.for(this.registerRoutesFromRegistry.name);\n    DroppedRouteDecorators.report({ logger });\n\n    const routes = MetadataRegistry.getInstance().getRoutes({\n      target: Object.getPrototypeOf(this),\n    });\n\n    if (!routes?.size) {\n      return;\n    }\n\n    const routeDefs = routes.entries();\n    for (const [methodName, routeConfigs] of routeDefs) {\n      if (paths !== 'all' && hasPathParam({ path: routeConfigs.path }) !== (paths === 'param')) {\n        continue;\n      }\n\n      // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.\n      const handler = (this as Record<string | symbol, unknown>)[methodName];\n      if (typeof handler !== 'function') {\n        logger.warn('Route method \"%s\" not found on controller', String(methodName));\n        continue;\n      }\n\n      this.bindRoute({ configs: routeConfigs }).to({\n        handler: (handler as TRouteHandler<unknown, RouteEnv>).bind(this),\n      });\n    }\n  }\n\n  /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */\n  async configure(\n    opts?: ConfigurableOptions,\n  ): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {\n    if (this.isConfigured) {\n      return this.router;\n    }\n\n    const t = performance.now();\n    const logger = this.logger.for(this.configure.name);\n\n    const configureOptions = opts ?? {};\n    logger.info('START | Binding controller | Options: %j', configureOptions);\n\n    // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).\n    this.registerRoutesFromRegistry({ paths: 'static' });\n    await this.binding();\n    this.registerRoutesFromRegistry({ paths: 'param' });\n\n    this.isConfigured = true;\n    logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);\n    return this.router;\n  }\n\n  /** @internal Builds auth + custom middlewares and security specs from route config. */\n  buildRouteMiddlewares<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { authenticate = {}, authorize, ...restConfig } = opts.configs;\n    const { strategies = [], mode = AuthenticationModes.ANY } = authenticate;\n\n    // Boot-time and NON-fatal: names a misspelled strategy at error level instead of leaving it as\n    // a 401 nobody can explain. Deliberately not a throw - `defineAuthController` hard-codes `jwt`\n    // on four routes, and ANY mode tolerates a strategy that does not resolve, so failing here would\n    // stop applications booting that work today. `assertRegistered` is there for an application that\n    // does want the hard failure.\n    AuthenticationStrategyRegistry.getInstance().reportUnregistered({\n      names: strategies,\n      scope: this.constructor.name,\n    });\n\n    const security = strategies.map((strategy: string) => ({ [strategy]: [] }));\n    const mws: ReturnType<typeof authenticateFn>[] = [];\n\n    if (strategies.length > 0) {\n      mws.push(authenticateFn({ strategies, mode }));\n    }\n\n    // Inject authorize middleware AFTER authenticate\n    if (authorize) {\n      const specs: IAuthorizationSpec[] = Array.isArray(authorize) ? authorize : [authorize];\n      for (const spec of specs) {\n        mws.push(authorizeFn({ spec }));\n      }\n    }\n\n    const configuredMiddleware = restConfig.middleware;\n    const extraMws = Array.isArray(configuredMiddleware)\n      ? configuredMiddleware\n      : [configuredMiddleware];\n\n    for (const mw of extraMws) {\n      if (!mw) {\n        continue;\n      }\n\n      mws.push(mw);\n    }\n\n    // Last: an application middleware and any size check run before the body is read.\n    if (hasFormBody({ content: restConfig.request?.body?.content })) {\n      mws.push(formBodyReader);\n    }\n\n    return { restConfig, security, mws };\n  }\n\n  /** Processes route config, injecting auth middleware and OpenAPI security specs. */\n  getRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { tags = [] } = restConfig;\n\n    // `restConfig` already omitted `authenticate`/`authorize` (this library's fields, not Hono's `createRoute` ones); reassembled with the injected middleware/tags/security it no longer structurally overlaps RouteConfig enough to assert directly.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n\n  /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */\n  getJSXRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { responses, tags = [] } = restConfig;\n\n    // Same reassembled-vs-RouteConfig boundary as getRouteConfigs above.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        responses: Object.assign({}, htmlResponse({ description: 'HTML page' }), responses),\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n  /** Override to register routes using bindRoute or defineRoute. */\n  abstract binding(): ValueOrPromise<void>;\n\n  /** Creates a fluent binding for registering a route (call .to() to attach handler). */\n  abstract bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {\n    configs: RouteConfig;\n  }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n\n  /** Defines and registers a route with its handler in a single call. */\n  abstract defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {\n    configs: RouteConfig;\n    handler: TRouteHandler<ResponseType, RouteEnv>;\n    hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;\n  }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n}\n"]}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/base/controllers/rest/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { AuthenticationModes } from '@/base/auth/authenticate/common/constants';\nimport { authenticate as authenticateFn } from '@/base/auth/authenticate/middlewares/authenticate.middleware';\nimport type { IAuthorizationSpec } from '@/base/auth/authorize/common/types';\nimport { authorize as authorizeFn } from '@/base/auth/authorize/middlewares/authorize.middleware';\nimport { formBodyReader, hasFormBody } from '@/base/middlewares/form-body/form-body.middleware';\nimport { AuthenticationStrategyRegistry } from '@/base/auth/authenticate/strategies/strategy-registry';\nimport { DroppedRouteDecorators } from '@/base/metadata/routes/common';\nimport { MetadataRegistry } from '@/helpers/inversion/registry';\nimport { RoutePathScopes, type TRoutePathScope } from '@/base/controllers/common/constants';\nimport { htmlResponse } from '@/base/controllers/common/html-response';\nimport type { Hook } from '@hono/zod-openapi';\nimport { createRoute, OpenAPIHono } from '@hono/zod-openapi';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport type { Env, Schema } from 'hono';\nimport type {\n  IAuthRouteConfig,\n  IBindRouteOptions,\n  IController,\n  IControllerOptions,\n  IDefineRouteOptions,\n  TRouteHandler,\n} from '../common/types';\n\n/** True for a route path carrying a path parameter, in either supported syntax: `/{id}` or `/:id`. */\nconst hasPathParam = (opts: { path: string }): boolean => {\n  return /\\{[^}]+\\}|:[^/]+/.test(opts.path);\n};\n\n/** Abstract base class for all REST controllers, providing route registration and auth middleware integration. */\nexport abstract class AbstractRestController<\n  RouteEnv extends Env = Env,\n  RouteSchema extends Schema = {},\n  BasePath extends string = '/',\n  ConfigurableOptions extends object = {},\n  Definitions extends Record<string, IAuthRouteConfig> = Record<string, IAuthRouteConfig>,\n>\n  extends BaseHelper\n  implements IController<RouteEnv, RouteSchema, BasePath, ConfigurableOptions>\n{\n  isConfigured = false;\n  router: OpenAPIHono<RouteEnv, RouteSchema, BasePath>;\n  path: string;\n  definitions: Definitions;\n\n  constructor(opts: IControllerOptions) {\n    super(opts);\n    const { isStrict = true } = opts;\n\n    const decoratorMetadata = MetadataRegistry.getInstance().getControllerMetadata({\n      target: new.target,\n    });\n    const resolvedPath = decoratorMetadata?.path ?? opts.path;\n\n    if (!resolvedPath) {\n      throw getError({\n        message: `[${new.target.name}] Controller path is required. Provide path via @controller decorator or constructor options.`,\n      });\n    }\n\n    this.path = resolvedPath;\n\n    this.router = new OpenAPIHono<RouteEnv, RouteSchema, BasePath>({\n      strict: isStrict,\n      defaultHook: (result, _context) => {\n        if (!result.success) {\n          throw result.error;\n        }\n      },\n    });\n  }\n\n  /** Returns the OpenAPIHono router instance for this controller. */\n  getRouter() {\n    return this.router;\n  }\n\n  /** Registers decorator-defined routes from the metadata registry; `paths` selects them by shape - see the two-phase call in {@link configure}. */\n  registerRoutesFromRegistry(opts?: { paths?: TRoutePathScope }): void {\n    const { paths = RoutePathScopes.ALL } = opts ?? {};\n\n    const logger = this.logger.for(this.registerRoutesFromRegistry.name);\n    DroppedRouteDecorators.report({ logger });\n\n    const routes = MetadataRegistry.getInstance().getRoutes({\n      target: Object.getPrototypeOf(this),\n    });\n\n    if (!routes?.size) {\n      return;\n    }\n\n    const routeDefs = routes.entries();\n    for (const [methodName, routeConfigs] of routeDefs) {\n      if (\n        paths !== RoutePathScopes.ALL &&\n        hasPathParam({ path: routeConfigs.path }) !== (paths === RoutePathScopes.PARAM)\n      ) {\n        continue;\n      }\n\n      // Dynamic dispatch by decorator-recorded method name - the controller class has no static index signature, so this read cannot be typed narrower than `unknown`.\n      const handler = (this as Record<string | symbol, unknown>)[methodName];\n      if (typeof handler !== 'function') {\n        logger.warn('Route method \"%s\" not found on controller', String(methodName));\n        continue;\n      }\n\n      this.bindRoute({ configs: routeConfigs }).to({\n        handler: (handler as TRouteHandler<unknown, RouteEnv>).bind(this),\n      });\n    }\n  }\n\n  /** Configures the controller by binding all routes and registering decorator-based routes. Idempotent. */\n  async configure(\n    opts?: ConfigurableOptions,\n  ): Promise<OpenAPIHono<RouteEnv, RouteSchema, BasePath>> {\n    if (this.isConfigured) {\n      return this.router;\n    }\n\n    const t = performance.now();\n    const logger = this.logger.for(this.configure.name);\n\n    const configureOptions = opts ?? {};\n    logger.info('START | Binding controller | Options: %j', configureOptions);\n\n    // Hono matches in registration order, so registration runs by SHAPE not source: every static path first, then binding()'s routes, then decorator param routes last (`/{id}` early would eat `/count`).\n    this.registerRoutesFromRegistry({ paths: RoutePathScopes.STATIC });\n    await this.binding();\n    this.registerRoutesFromRegistry({ paths: RoutePathScopes.PARAM });\n\n    this.isConfigured = true;\n    logger.info('DONE | Binding controller | Took: %s (ms)', performance.now() - t);\n    return this.router;\n  }\n\n  /** @internal Builds auth + custom middlewares and security specs from route config. */\n  buildRouteMiddlewares<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { authenticate = {}, authorize, ...restConfig } = opts.configs;\n    const { strategies = [], mode = AuthenticationModes.ANY } = authenticate;\n\n    // Boot-time and NON-fatal: names a misspelled strategy at error level instead of leaving it as\n    // a 401 nobody can explain. Deliberately not a throw - `defineAuthController` hard-codes `jwt`\n    // on four routes, and ANY mode tolerates a strategy that does not resolve, so failing here would\n    // stop applications booting that work today. `assertRegistered` is there for an application that\n    // does want the hard failure.\n    AuthenticationStrategyRegistry.getInstance().reportUnregistered({\n      names: strategies,\n      scope: this.constructor.name,\n    });\n\n    const security = strategies.map((strategy: string) => ({ [strategy]: [] }));\n    const mws: ReturnType<typeof authenticateFn>[] = [];\n\n    if (strategies.length > 0) {\n      mws.push(authenticateFn({ strategies, mode }));\n    }\n\n    // Inject authorize middleware AFTER authenticate\n    if (authorize) {\n      const specs: IAuthorizationSpec[] = Array.isArray(authorize) ? authorize : [authorize];\n      for (const spec of specs) {\n        mws.push(authorizeFn({ spec }));\n      }\n    }\n\n    const configuredMiddleware = restConfig.middleware;\n    const extraMws = Array.isArray(configuredMiddleware)\n      ? configuredMiddleware\n      : [configuredMiddleware];\n\n    for (const mw of extraMws) {\n      if (!mw) {\n        continue;\n      }\n\n      mws.push(mw);\n    }\n\n    // Last: an application middleware and any size check run before the body is read.\n    if (hasFormBody({ content: restConfig.request?.body?.content })) {\n      mws.push(formBodyReader);\n    }\n\n    return { restConfig, security, mws };\n  }\n\n  /** Processes route config, injecting auth middleware and OpenAPI security specs. */\n  getRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { tags = [] } = restConfig;\n\n    // `restConfig` already omitted `authenticate`/`authorize` (this library's fields, not Hono's `createRoute` ones); reassembled with the injected middleware/tags/security it no longer structurally overlaps RouteConfig enough to assert directly.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n\n  /** Like getRouteConfigs but adds HTML response schema for JSX rendering. */\n  getJSXRouteConfigs<RouteConfig extends IAuthRouteConfig>(opts: { configs: RouteConfig }) {\n    const { restConfig, security, mws } = this.buildRouteMiddlewares(opts);\n    const { responses, tags = [] } = restConfig;\n\n    // Same reassembled-vs-RouteConfig boundary as getRouteConfigs above.\n    return createRoute<string, RouteConfig>(\n      Object.assign({}, restConfig, {\n        middleware: mws,\n        responses: Object.assign({}, htmlResponse({ description: 'HTML page' }), responses),\n        tags: [...tags, this.scope],\n        security,\n      }) as any,\n    );\n  }\n  /** Override to register routes using bindRoute or defineRoute. */\n  abstract binding(): ValueOrPromise<void>;\n\n  /** Creates a fluent binding for registering a route (call .to() to attach handler). */\n  abstract bindRoute<RouteConfig extends IAuthRouteConfig>(opts: {\n    configs: RouteConfig;\n  }): IBindRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n\n  /** Defines and registers a route with its handler in a single call. */\n  abstract defineRoute<RouteConfig extends IAuthRouteConfig, ResponseType = unknown>(opts: {\n    configs: RouteConfig;\n    handler: TRouteHandler<ResponseType, RouteEnv>;\n    hook?: Hook<any, RouteEnv, string, ValueOrPromise<any>>;\n  }): IDefineRouteOptions<RouteConfig, RouteEnv, RouteSchema, BasePath>;\n}\n"]}

package/dist/cjs/base/metadata/model-metadata.d.ts

@@ -0,0 +1,17 @@
+import type { IModelMetadata } from '../../helpers/inversion';
+/** The release that drops the deprecated `skipMigrate` key. */
+export declare const DEPRECATED_MODEL_METADATA_REMOVED_IN = "0.4.4";
+/**
+ * The one place the `@model` metadata outside `settings` is checked and normalised.
+ *
+ * - `type` is optional; a value must be one of {@link ModelTypes}.
+ * - `skipMigrate` (deprecated) becomes `migration: { use: !skipMigrate }`, and is reported so the
+ *   application warns once at boot. Setting both `skipMigrate` and `migration` throws.
+ * - When the model declares either, the registry entry carries BOTH `migration` and a derived
+ *   `skipMigrate`, so consumer tooling that reads `metadata.skipMigrate` keeps working this release.
+ */
+export declare const normalizeModelMetadata: (opts: {
+    model: string;
+    metadata: IModelMetadata;
+}) => IModelMetadata;
+//# sourceMappingURL=model-metadata.d.ts.map

package/dist/cjs/base/metadata/model-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-metadata.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/model-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGpF,+DAA+D;AAC/D,eAAO,MAAM,oCAAoC,UAAU,CAAC;AAE5D;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;CAC1B,KAAG,cAoCH,CAAC"}

package/dist/cjs/base/metadata/model-metadata.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeModelMetadata = exports.DEPRECATED_MODEL_METADATA_REMOVED_IN = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const constants_1 = require("../models/common/constants");
+/** The release that drops the deprecated `skipMigrate` key. */
+exports.DEPRECATED_MODEL_METADATA_REMOVED_IN = '0.4.4';
+/**
+ * The one place the `@model` metadata outside `settings` is checked and normalised.
+ *
+ * - `type` is optional; a value must be one of {@link ModelTypes}.
+ * - `skipMigrate` (deprecated) becomes `migration: { use: !skipMigrate }`, and is reported so the
+ *   application warns once at boot. Setting both `skipMigrate` and `migration` throws.
+ * - When the model declares either, the registry entry carries BOTH `migration` and a derived
+ *   `skipMigrate`, so consumer tooling that reads `metadata.skipMigrate` keeps working this release.
+ */
+const normalizeModelMetadata = (opts) => {
+    const { model, metadata } = opts;
+    const { type, skipMigrate, migration } = metadata;
+    if (type !== undefined && !constants_1.ModelTypes.isValid(type)) {
+        throw (0, core_1.getError)({
+            message: `[model][${model}] Invalid 'type' | Expected one of: ${[...constants_1.ModelTypes.SCHEME_SET].join(', ')} (or leave it out) | Got: ${String(type)}`,
+        });
+    }
+    if (skipMigrate !== undefined && migration !== undefined) {
+        throw (0, core_1.getError)({
+            message: `[model][${model}] skipMigrate and migration are both set | skipMigrate is the deprecated name of migration.use (inverted) | keep migration and remove skipMigrate`,
+        });
+    }
+    if (skipMigrate === undefined && migration === undefined) {
+        return metadata;
+    }
+    const deprecatedMetadata = [];
+    let use;
+    if (skipMigrate !== undefined) {
+        use = !skipMigrate;
+        deprecatedMetadata.push({ key: 'skipMigrate', use: 'migration: { use: false }' });
+    }
+    else {
+        use = migration?.use !== false;
+    }
+    return {
+        ...metadata,
+        migration: { ...migration, use },
+        skipMigrate: !use,
+        ...(deprecatedMetadata.length > 0 ? { deprecatedMetadata } : {}),
+    };
+};
+exports.normalizeModelMetadata = normalizeModelMetadata;
+//# sourceMappingURL=model-metadata.js.map

package/dist/cjs/base/metadata/model-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-metadata.js","sourceRoot":"","sources":["../../../../src/base/metadata/model-metadata.ts"],"names":[],"mappings":";;;AAAA,sDAAuD;AAEvD,0DAAwD;AAExD,+DAA+D;AAClD,QAAA,oCAAoC,GAAG,OAAO,CAAC;AAE5D;;;;;;;;GAQG;AACI,MAAM,sBAAsB,GAAG,CAAC,IAGtC,EAAkB,EAAE;IACnB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAElD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,sBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,WAAW,KAAK,uCAAuC,CAAC,GAAG,sBAAU,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,IAAI,CAAC,EAAE;SACjJ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,WAAW,KAAK,mJAAmJ;SAC7K,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,kBAAkB,GAA+B,EAAE,CAAC;IAC1D,IAAI,GAAY,CAAC;IAEjB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,GAAG,CAAC,WAAW,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,SAAS,EAAE,GAAG,KAAK,KAAK,CAAC;IACjC,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,SAAS,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE;QAChC,WAAW,EAAE,CAAC,GAAG;QACjB,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC,CAAC;AAvCW,QAAA,sBAAsB,0BAuCjC","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\nimport type { IDeprecatedModelMetadata, IModelMetadata } from '@/helpers/inversion';\nimport { ModelTypes } from '../models/common/constants';\n\n/** The release that drops the deprecated `skipMigrate` key. */\nexport const DEPRECATED_MODEL_METADATA_REMOVED_IN = '0.4.4';\n\n/**\n * The one place the `@model` metadata outside `settings` is checked and normalised.\n *\n * - `type` is optional; a value must be one of {@link ModelTypes}.\n * - `skipMigrate` (deprecated) becomes `migration: { use: !skipMigrate }`, and is reported so the\n *   application warns once at boot. Setting both `skipMigrate` and `migration` throws.\n * - When the model declares either, the registry entry carries BOTH `migration` and a derived\n *   `skipMigrate`, so consumer tooling that reads `metadata.skipMigrate` keeps working this release.\n */\nexport const normalizeModelMetadata = (opts: {\n  model: string;\n  metadata: IModelMetadata;\n}): IModelMetadata => {\n  const { model, metadata } = opts;\n  const { type, skipMigrate, migration } = metadata;\n\n  if (type !== undefined && !ModelTypes.isValid(type)) {\n    throw getError({\n      message: `[model][${model}] Invalid 'type' | Expected one of: ${[...ModelTypes.SCHEME_SET].join(', ')} (or leave it out) | Got: ${String(type)}`,\n    });\n  }\n\n  if (skipMigrate !== undefined && migration !== undefined) {\n    throw getError({\n      message: `[model][${model}] skipMigrate and migration are both set | skipMigrate is the deprecated name of migration.use (inverted) | keep migration and remove skipMigrate`,\n    });\n  }\n\n  if (skipMigrate === undefined && migration === undefined) {\n    return metadata;\n  }\n\n  const deprecatedMetadata: IDeprecatedModelMetadata[] = [];\n  let use: boolean;\n\n  if (skipMigrate !== undefined) {\n    use = !skipMigrate;\n    deprecatedMetadata.push({ key: 'skipMigrate', use: 'migration: { use: false }' });\n  } else {\n    use = migration?.use !== false;\n  }\n\n  return {\n    ...metadata,\n    migration: { ...migration, use },\n    skipMigrate: !use,\n    ...(deprecatedMetadata.length > 0 ? { deprecatedMetadata } : {}),\n  };\n};\n"]}

package/dist/cjs/base/metadata/model-settings.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Refuses a removed `@model` settings key. A model that still says `scopeFilter` would otherwise
+ * lose its row scope without a sound (a plain-JavaScript or `any`-typed model gets no type error),
+ * so the decorator throws instead, naming the key to use. `devz codemod model-settings --write` rewrites
+ * the keys.
+ */
+export declare const assertNoRemovedModelSettings: (opts: {
+    model: string;
+    settings: object | undefined;
+}) => void;
+//# sourceMappingURL=model-settings.d.ts.map

package/dist/cjs/base/metadata/model-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-settings.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/model-settings.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,KAAG,IAiBH,CAAC"}

package/dist/cjs/base/metadata/model-settings.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNoRemovedModelSettings = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+/** The keys 0.4.2 deprecated and 0.4.3 removed, and the key that replaces each. */
+const REMOVED_MODEL_SETTINGS = {
+    defaultFilter: 'query.filter',
+    defaultLimit: 'query.limit.default',
+    maxLimit: 'query.limit.max',
+    scopeFilter: 'access',
+};
+/**
+ * Refuses a removed `@model` settings key. A model that still says `scopeFilter` would otherwise
+ * lose its row scope without a sound (a plain-JavaScript or `any`-typed model gets no type error),
+ * so the decorator throws instead, naming the key to use. `devz codemod model-settings --write` rewrites
+ * the keys.
+ */
+const assertNoRemovedModelSettings = (opts) => {
+    const { model, settings } = opts;
+    if (!settings) {
+        return;
+    }
+    const removed = Object.keys(REMOVED_MODEL_SETTINGS).filter((key) => Object.hasOwn(settings, key));
+    if (removed.length === 0) {
+        return;
+    }
+    throw (0, core_1.getError)({
+        message: `[model][${model}] Removed settings key(s): ${removed
+            .map((key) => `settings.${key} (use settings.${REMOVED_MODEL_SETTINGS[key]})`)
+            .join(', ')} | removed in 0.4.3 | run 'devz codemod model-settings --write' to rewrite them`,
+    });
+};
+exports.assertNoRemovedModelSettings = assertNoRemovedModelSettings;
+//# sourceMappingURL=model-settings.js.map

package/dist/cjs/base/metadata/model-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-settings.js","sourceRoot":"","sources":["../../../../src/base/metadata/model-settings.ts"],"names":[],"mappings":";;;AAAA,sDAAuD;AAEvD,mFAAmF;AACnF,MAAM,sBAAsB,GAA2B;IACrD,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,qBAAqB;IACnC,QAAQ,EAAE,iBAAiB;IAC3B,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF;;;;;GAKG;AACI,MAAM,4BAA4B,GAAG,CAAC,IAG5C,EAAQ,EAAE;IACT,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAClG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,IAAA,eAAQ,EAAC;QACb,OAAO,EAAE,WAAW,KAAK,8BAA8B,OAAO;aAC3D,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,GAAG,kBAAkB,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC;aAC7E,IAAI,CAAC,IAAI,CAAC,iFAAiF;KAC/F,CAAC,CAAC;AACL,CAAC,CAAC;AApBW,QAAA,4BAA4B,gCAoBvC","sourcesContent":["import { getError } from '@venizia/ignis-helpers/core';\n\n/** The keys 0.4.2 deprecated and 0.4.3 removed, and the key that replaces each. */\nconst REMOVED_MODEL_SETTINGS: Record<string, string> = {\n  defaultFilter: 'query.filter',\n  defaultLimit: 'query.limit.default',\n  maxLimit: 'query.limit.max',\n  scopeFilter: 'access',\n};\n\n/**\n * Refuses a removed `@model` settings key. A model that still says `scopeFilter` would otherwise\n * lose its row scope without a sound (a plain-JavaScript or `any`-typed model gets no type error),\n * so the decorator throws instead, naming the key to use. `devz codemod model-settings --write` rewrites\n * the keys.\n */\nexport const assertNoRemovedModelSettings = (opts: {\n  model: string;\n  settings: object | undefined;\n}): void => {\n  const { model, settings } = opts;\n\n  if (!settings) {\n    return;\n  }\n\n  const removed = Object.keys(REMOVED_MODEL_SETTINGS).filter((key) => Object.hasOwn(settings, key));\n  if (removed.length === 0) {\n    return;\n  }\n\n  throw getError({\n    message: `[model][${model}] Removed settings key(s): ${removed\n      .map((key) => `settings.${key} (use settings.${REMOVED_MODEL_SETTINGS[key]})`)\n      .join(', ')} | removed in 0.4.3 | run 'devz codemod model-settings --write' to rewrite them`,\n  });\n};\n"]}

package/dist/cjs/base/metadata/persistents.d.ts

@@ -2,7 +2,7 @@ import type { IDataSourceMetadata, IModelMetadata, TRepositoryMetadata } from '.
 import type { IDataSource } from '../datasources';
 import type { AbstractEntity } from '../models';
 /** Registers a model class with its static schema and relations. */
-export declare const model: (metadata: IModelMetadata) => ClassDecorator;
+export declare const model: (input?: IModelMetadata) => ClassDecorator;
 /** Registers a datasource with driver and auto-discovery settings. */
 export declare const datasource: (metadata?: IDataSourceMetadata) => ClassDecorator;
 export declare const repository: <Model extends AbstractEntity = AbstractEntity, DataSource extends IDataSource = IDataSource>(metadata?: TRepositoryMetadata<Model, DataSource>) => ClassDecorator;

package/dist/cjs/base/metadata/persistents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,mBAAmB,EAEnB,cAAc,EAEd,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cA4BhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAQ3D,CAAC;AA0PF,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,WAAW,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAChD,cAeF,CAAC"}
+{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,mBAAmB,EAEnB,cAAc,EAEd,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,QAAO,cAAmB,KAAG,cAmClD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,WAAW,mBAAmB,KAAG,cAQ3D,CAAC;AA0PF,eAAO,MAAM,UAAU,GACrB,KAAK,SAAS,cAAc,GAAG,cAAc,EAC7C,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,WAAW,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,KAChD,cAeF,CAAC"}

package/dist/cjs/base/metadata/persistents.js

@@ -8,26 +8,31 @@ const core_1 = require("@venizia/ignis-helpers/core");
 const datasources_1 = require("../datasources");
 const constants_1 = require("../repositories/common/constants");
 const injectable_1 = require("./injectable");
+const model_metadata_1 = require("./model-metadata");
+const model_settings_1 = require("./model-settings");
 /** Registers a model class with its static schema and relations. */
-const model = (metadata) => {
+const model = (input = {}) => {
     return (target) => {
-        (0, injectable_1.injectable)({ type: inversion_1.ArtifactTypes.MODEL, ...(0, injectable_1.pickRegistrationOptions)({ metadata }) })(target);
-        const defaultLimit = metadata.settings?.defaultLimit;
+        (0, injectable_1.injectable)({ type: inversion_1.ArtifactTypes.MODEL, ...(0, injectable_1.pickRegistrationOptions)({ metadata: input }) })(target);
+        const metadata = (0, model_metadata_1.normalizeModelMetadata)({ model: target.name, metadata: input });
+        (0, model_settings_1.assertNoRemovedModelSettings)({ model: target.name, settings: metadata.settings });
+        const { settings } = metadata;
+        const defaultLimit = settings?.query?.limit?.default;
         if (defaultLimit !== undefined && (!Number.isInteger(defaultLimit) || defaultLimit <= 0)) {
             throw (0, core_1.getError)({
-                message: `[model][${target.name}] Invalid 'defaultLimit' | Expected a positive integer | Got: ${defaultLimit}`,
+                message: `[model][${target.name}] Invalid 'query.limit.default' | Expected a positive integer | Got: ${defaultLimit}`,
             });
         }
-        // Validated at DECORATION time, like defaultLimit: a bad ceiling is a wiring mistake, and
+        // Validated at DECORATION time, like the default limit: a bad ceiling is a wiring mistake, and
         // catching it at boot beats catching it on the one request that happens to reach the limit.
-        const maxLimit = metadata.settings?.maxLimit;
+        const maxLimit = settings?.query?.limit?.max;
         if (maxLimit !== undefined && (!Number.isInteger(maxLimit) || maxLimit <= 0)) {
             throw (0, core_1.getError)({
-                message: `[model][${target.name}] Invalid 'maxLimit' | Expected a positive integer | Got: ${maxLimit}`,
+                message: `[model][${target.name}] Invalid 'query.limit.max' | Expected a positive integer | Got: ${maxLimit}`,
             });
         }
         // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set
-        const principal = metadata.settings?.authorize?.principal;
+        const principal = settings?.authorize?.principal;
         if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {
             target.AUTHORIZATION_SUBJECT = principal;
         }

package/dist/cjs/base/metadata/persistents.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistents.js","sourceRoot":"","sources":["../../../../src/base/metadata/persistents.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAStD,mDAM6B;AAC7B,0DAA2E;AAC3E,sDAAuD;AAEvD,gDAAmD;AAEnD,gEAAmE;AACnE,6CAAmE;AAEnE,oEAAoE;AAC7D,MAAM,KAAK,GAAG,CAAC,QAAwB,EAAkB,EAAE;IAChE,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAA,uBAAU,EAAC,EAAE,IAAI,EAAE,yBAAa,CAAC,KAAK,EAAE,GAAG,IAAA,oCAAuB,EAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAE5F,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;QACrD,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,iEAAiE,YAAY,EAAE;aAC/G,CAAC,CAAC;QACL,CAAC;QAED,0FAA0F;QAC1F,4FAA4F;QAC5F,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,6DAA6D,QAAQ,EAAE;aACvG,CAAC,CAAC;QACL,CAAC;QAED,kFAAkF;QAClF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;QAC1D,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAAE,CAAC;YAChE,MAAkC,CAAC,qBAAqB,GAAG,SAAS,CAAC;QACxE,CAAC;QAED,4BAAgB,CAAC,WAAW,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,KAAK,SA4BhB;AAEF,sEAAsE;AAC/D,MAAM,UAAU,GAAG,CAAC,QAA8B,EAAkB,EAAE;IAC3E,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAA,uBAAU,EAAC;YACT,IAAI,EAAE,yBAAa,CAAC,UAAU;YAC9B,GAAG,IAAA,oCAAuB,EAAC,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;SACzD,CAAC,CAAC,MAAM,CAAC,CAAC;QACX,4BAAgB,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC,CAAC;AARW,QAAA,UAAU,cAQrB;AAEF,iKAAiK;AACjK,MAAM,0BAA0B,GAAG,CAGjC,IAGD,EAAQ,EAAE;IACT,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,2BAAe,CAAC,KAAK,CAAC;IAEpD,IAAI,CAAC,2BAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,6CAA6C,MAAM,CAAC,IAAI,wCAAwC,IAAI,uBAAuB,CAAC,GAAG,2BAAe,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACjL,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,KAAK,2BAAe,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,6CAA6C,MAAM,CAAC,IAAI,sCAAsC;SACxG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,KAAK,2BAAe,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,6CAA6C,MAAM,CAAC,IAAI,2BAA2B,2BAAe,CAAC,MAAM,+BAA+B;SAClJ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,6CAA6C,MAAM,CAAC,IAAI,2CAA2C;SAC7G,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF,oHAAoH;AACpH,MAAM,iCAAiC,GAAG,CAAC,IAI1C,EAAQ,EAAE;IACT,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAE5D,6FAA6F;IAC7F,2FAA2F;IAC3F,MAAM,gBAAgB,GAAG,IAAA,+BAAiB,EAAC,cAAc,CAAC,CAAC;IAE3D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,uFAAuF,cAAc,CAAC,IAAI,GAAG;SACnJ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,kBAAkB,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAChB,cAAc,KAAK,kBAAkB,IAAI,kBAAkB,CAAC,SAAS,YAAY,cAAc,CAAC;IAElG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,gEAAgE,cAAc,CAAC,IAAI,gCAAgC,kBAAkB,CAAC,IAAI,GAAG;SACnL,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,IAKpC,EAAQ,EAAE;IACT,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAErE,+MAA+M;IAC/M,MAAM,UAAU,GAAkC,OAAO,CAAC,cAAc,CACtE,wBAAY,CAAC,MAAM,EACnB,MAAM,CACP,CAAC;IACF,MAAM,cAAc,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;IAEvE,IAAI,cAAc,EAAE,CAAC;QACnB,8FAA8F;QAC9F,qFAAqF;QACrF,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM;YAC1C,CAAC,CAAC,IAAA,+BAAmB,EAAC,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC;YACxD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,SAAS,GACb,cAAc,CAAC,GAAG;YAClB,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEpF,8FAA8F;QAC9F,+FAA+F;QAC/F,MAAM,kBAAkB,GAAG,cAAc;YACvC,CAAC,CAAC,IAAA,+BAAiB,EAAC,cAAc,CAAC;YACnC,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,4BAAiB,CAAC,UAAU,GAAG,CAAC,CAAC;QAE9F,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,2FAA2F,MAAM,CAAC,SAAS,CAAC,qCAAqC,4BAAiB,CAAC,UAAU,0BAA0B;aAC7O,CAAC,CAAC;QACL,CAAC;QAED,OAAO;IACT,CAAC;IAED,iGAAiG;IACjG,gGAAgG;IAChG,6DAA6D;IAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,cAAc,IAAI,cAAc,KAAK,MAAM,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC/E,iCAAiC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,qGAAqG;IACrG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,cAAc,CACpB,wBAAY,CAAC,MAAM,EACnB,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EACnD,MAAM,CACP,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,uBAAW,CAAC,KAAK,CAAC;QACnC,SAAS,EAAE,4BAAiB,CAAC,UAAU;QACvC,GAAG,EAAE,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI;KAC3F,CAAC,CAAC;IAEH,kGAAkG;IAClG,oGAAoG;IACpG,0FAA0F;IAC1F,QAAQ,CAAC,iBAAiB,CAAC;QACzB,MAAM;QACN,KAAK,EAAE,CAAC;QACR,QAAQ,EACN,OAAO,aAAa,KAAK,QAAQ;YAC/B,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;YAClD,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;KAC9E,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,yBAAyB,GAAG,CAGhC,IAID,EAAkD,EAAE;IACnD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE5C,0BAA0B,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,MAAM,kBAAkB,GAAG,IAAA,qBAAY,EAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,iLAAiL;SACvN,CAAC,CAAC;IACL,CAAC;IAED,kFAAkF;IAClF,IAAI,QAAQ,CAAC,IAAI,KAAK,2BAAe,CAAC,MAAM,EAAE,CAAC;QAC7C,2BAA2B,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,aAAa,EAAE,QAAQ,CAAC,UAAU;YAClC,kBAAkB;SACnB,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,2BAAe,CAAC,MAAM;YAC5B,UAAU,EAAE,kBAAkB;YAC9B,cAAc,EAAE,QAAQ,CAAC,cAAc;SACxC,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,qBAAY,EAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAE9D,QAAQ,CAAC,yBAAyB,CAAC;QACjC,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,aAAa;QACpB,UAAU,EAAE,kBAAkB;KAC/B,CAAC,CAAC;IAEH,2BAA2B,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,aAAa,EAAE,QAAQ,CAAC,UAAU;QAClC,kBAAkB;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,2BAAe,CAAC,KAAK;QAC3B,KAAK,EAAE,aAAa;QACpB,UAAU,EAAE,kBAAkB;QAC9B,cAAc,EAAE,QAAQ,CAAC,cAAc;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,6OAA6O;AAC7O,MAAM,yBAAyB,GAAG,CAAC,IAGlC,EAAuB,EAAE;IACxB,8FAA8F;IAC9F,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAA,eAAQ,EAAC;YACb,OAAO,EAAE,iBAAiB,IAAI,CAAC,MAAM,CAAC,IAAI,qIAAqI;SAChL,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,KAAK,2BAAe,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IAC3E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAG9B,IAKD,EAAQ,EAAE;IACT,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAA,uBAAU,EAAC;QACT,IAAI,EAAE,yBAAa,CAAC,UAAU;QAC9B,GAAG,IAAA,oCAAuB,EAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;KACvD,CAAC,CAAC,MAAM,CAAC,CAAC;IAEX,MAAM,QAAQ,GAAG,yBAAyB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE3E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7F,CAAC,CAAC;AAEK,MAAM,UAAU,GAAG,CAIxB,QAAiD,EACjC,EAAE;IAClB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,QAAQ,GAAG,4BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,uBAAuB,CAAC;gBACtB,QAAQ,EAAE,yBAAyB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACzD,YAAY,EAAE,EAAE;gBAChB,MAAM;gBACN,QAAQ;aACT,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,uBAAuB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,UAAU,cAoBrB","sourcesContent":["import { BindingNamespaces } from '@/common/bindings';\nimport type {\n  IArtifactRegistrationOptions,\n  IDataSourceMetadata,\n  IInjectMetadata,\n  IModelMetadata,\n  IResolvedRepositoryMetadata,\n  TRepositoryMetadata,\n} from '@/helpers/inversion';\nimport {\n  ArtifactTypes,\n  BindingKeys,\n  MetadataKeys,\n  MetadataRegistry,\n  resolveInjectTarget,\n} from '@/helpers/inversion';\nimport { resolveClass, resolveValue } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IDataSource } from '../datasources';\nimport { isDataSourceClass } from '../datasources';\nimport type { AbstractEntity } from '../models';\nimport { RepositoryTypes } from '../repositories/common/constants';\nimport { injectable, pickRegistrationOptions } from './injectable';\n\n/** Registers a model class with its static schema and relations. */\nexport const model = (metadata: IModelMetadata): ClassDecorator => {\n  return (target) => {\n    injectable({ type: ArtifactTypes.MODEL, ...pickRegistrationOptions({ metadata }) })(target);\n\n    const defaultLimit = metadata.settings?.defaultLimit;\n    if (defaultLimit !== undefined && (!Number.isInteger(defaultLimit) || defaultLimit <= 0)) {\n      throw getError({\n        message: `[model][${target.name}] Invalid 'defaultLimit' | Expected a positive integer | Got: ${defaultLimit}`,\n      });\n    }\n\n    // Validated at DECORATION time, like defaultLimit: a bad ceiling is a wiring mistake, and\n    // catching it at boot beats catching it on the one request that happens to reach the limit.\n    const maxLimit = metadata.settings?.maxLimit;\n    if (maxLimit !== undefined && (!Number.isInteger(maxLimit) || maxLimit <= 0)) {\n      throw getError({\n        message: `[model][${target.name}] Invalid 'maxLimit' | Expected a positive integer | Got: ${maxLimit}`,\n      });\n    }\n\n    // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set\n    const principal = metadata.settings?.authorize?.principal;\n    if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {\n      (target as Record<string, unknown>).AUTHORIZATION_SUBJECT = principal;\n    }\n\n    MetadataRegistry.getInstance().registerModel({ target, metadata });\n  };\n};\n\n/** Registers a datasource with driver and auto-discovery settings. */\nexport const datasource = (metadata?: IDataSourceMetadata): ClassDecorator => {\n  return (target) => {\n    injectable({\n      type: ArtifactTypes.DATASOURCE,\n      ...pickRegistrationOptions({ metadata: metadata ?? {} }),\n    })(target);\n    MetadataRegistry.getInstance().setDataSourceMetadata({ target, metadata });\n  };\n};\n\n/** Mirrors the `TRepositoryMetadata` union for JavaScript callers: a known type, a dataSource always, a model exactly when the type is RepositoryTypes.MODEL. */\nconst validateRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  target: Function;\n}): void => {\n  const { metadata, target } = opts;\n  const type = metadata.type ?? RepositoryTypes.MODEL;\n\n  if (!RepositoryTypes.isValid(type)) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Unknown 'type': ${type} | Expected one of: ${[...RepositoryTypes.SCHEME_SET].join(', ')}`,\n    });\n  }\n\n  if (type === RepositoryTypes.MODEL && !metadata.model) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'model'`,\n    });\n  }\n\n  if (type === RepositoryTypes.REMOTE && metadata.model) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | A '${RepositoryTypes.REMOTE}' repository takes no 'model'`,\n    });\n  }\n\n  if (!metadata.dataSource) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'dataSource'`,\n    });\n  }\n};\n\n/** Asserts the constructor's first parameter is an AbstractDataSource compatible with what @repository declared. */\nconst validateFirstConstructorParameter = (opts: {\n  target: Function;\n  firstParamType: Function;\n  resolvedDataSource: string | Function;\n}): void => {\n  const { target, firstParamType, resolvedDataSource } = opts;\n\n  // NOT `instanceof`: two copies of this package give two `AbstractDataSource` classes and the\n  // check would be false across them, rejecting a perfectly valid repository at import time.\n  const isDataSourceType = isDataSourceClass(firstParamType);\n\n  if (!isDataSourceType) {\n    throw getError({\n      message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,\n    });\n  }\n\n  if (typeof resolvedDataSource !== 'function') {\n    return;\n  }\n\n  const isCompatible =\n    firstParamType === resolvedDataSource || resolvedDataSource.prototype instanceof firstParamType;\n\n  if (!isCompatible) {\n    throw getError({\n      message: `[@repository][${target.name}] Invalid constructor | Type mismatch | Constructor expects '${firstParamType.name}' but @repository specifies '${resolvedDataSource.name}'`,\n    });\n  }\n};\n\n/**\n * Auto-injects dataSource at constructor param[0] unless explicit @inject exists. A class is injected\n * by the class itself, so the container reads the key its registration recorded: a pinned\n * `binding` and a minified class name both resolve. Only a string reference is a key.\n */\nconst registerDataSourceInjection = (opts: {\n  target: Function;\n  registry: MetadataRegistry;\n  dataSourceRef: TRepositoryMetadata['dataSource'];\n  resolvedDataSource: string | Function;\n}): void => {\n  const { target, registry, dataSourceRef, resolvedDataSource } = opts;\n\n  // Own metadata only: `getInjectMetadata` walks the prototype chain, so a repository extending another @repository class would see the BASE's injection at param[0] and silently resolve the base's dataSource.\n  const ownInjects: IInjectMetadata[] | undefined = Reflect.getOwnMetadata(\n    MetadataKeys.INJECT,\n    target,\n  );\n  const injectAtIndex0 = ownInjects?.find((entry) => entry?.index === 0);\n\n  if (injectAtIndex0) {\n    // `@inject({ target })` carries no key; read the one recorded on the class. The function form\n    // resolves through the same helper the container uses, so both paths read one class.\n    const injectedTarget = injectAtIndex0.target\n      ? resolveInjectTarget({ target: injectAtIndex0.target })\n      : undefined;\n    const injectKey =\n      injectAtIndex0.key ??\n      (injectedTarget ? registry.getBindingKey({ target: injectedTarget }) : undefined);\n\n    // A class is judged by its brand: its key may sit under any namespace a `binding` pinned, and\n    // a provisional key may still change at registration. Only a bare key is judged by its prefix.\n    const isDataSourceTarget = injectedTarget\n      ? isDataSourceClass(injectedTarget)\n      : typeof injectKey === 'string' && injectKey.startsWith(`${BindingNamespaces.DATASOURCE}.`);\n\n    if (!isDataSourceTarget) {\n      throw getError({\n        message: `[@repository][${target.name}] Invalid constructor | First parameter must be a DataSource | Found @inject with key: '${String(injectKey)}' | Expected a key starting with '${BindingNamespaces.DATASOURCE}.' or a DataSource class`,\n      });\n    }\n\n    return;\n  }\n\n  // Checked only when this decorator writes the injection: an explicit @inject decides for itself.\n  // An interface emits `Object` and a type-only class import emits `Function` under tsc (`Object`\n  // under bun); neither names the class, so neither is judged.\n  const firstParamType = Reflect.getMetadata('design:paramtypes', target)?.[0];\n  if (firstParamType && firstParamType !== Object && firstParamType !== Function) {\n    validateFirstConstructorParameter({ target, firstParamType, resolvedDataSource });\n  }\n\n  // The inherited list is the base repository's own, and setInjectMetadata may write straight into it.\n  if (!ownInjects) {\n    Reflect.defineMetadata(\n      MetadataKeys.INJECT,\n      [...(registry.getInjectMetadata({ target }) ?? [])],\n      target,\n    );\n  }\n\n  const derivedKey = BindingKeys.build({\n    namespace: BindingNamespaces.DATASOURCE,\n    key: typeof resolvedDataSource === 'string' ? resolvedDataSource : resolvedDataSource.name,\n  });\n\n  // The class first, decided when the repository is resolved: by then any registration - decorated,\n  // `bindingList()`, or `dataSource(X, { binding })` - has recorded its key on the class. The derived\n  // key is the fallback for a class nothing recorded, bound by hand under exactly that key.\n  registry.setInjectMetadata({\n    target,\n    index: 0,\n    metadata:\n      typeof dataSourceRef === 'string'\n        ? { key: derivedKey, index: 0, isOptional: false }\n        : { target: dataSourceRef, key: derivedKey, index: 0, isOptional: false },\n  });\n};\n\n/** Resolves repository metadata and registers bindings for schema auto-discovery. */\nconst resolveRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  target: Function;\n  registry: MetadataRegistry;\n}): IResolvedRepositoryMetadata<Model, DataSource> => {\n  const { metadata, target, registry } = opts;\n\n  validateRepositoryMetadata({ metadata, target });\n\n  const resolvedDataSource = resolveClass({ ref: metadata.dataSource });\n  if (!resolvedDataSource) {\n    throw getError({\n      message: `[@repository][${target.name}] The dataSource resolver returned nothing at decoration time | An import cycle leaves the datasource class undefined here; import it without the cycle, or name it as a string`,\n    });\n  }\n\n  // No model, so no binding: the datasource owns no schema through this repository.\n  if (metadata.type === RepositoryTypes.REMOTE) {\n    registerDataSourceInjection({\n      target,\n      registry,\n      dataSourceRef: metadata.dataSource,\n      resolvedDataSource,\n    });\n    return {\n      type: RepositoryTypes.REMOTE,\n      dataSource: resolvedDataSource,\n      operationScope: metadata.operationScope,\n    };\n  }\n\n  const resolvedModel = resolveValue({ value: metadata.model });\n\n  registry.registerRepositoryBinding({\n    repository: target,\n    model: resolvedModel,\n    dataSource: resolvedDataSource,\n  });\n\n  registerDataSourceInjection({\n    target,\n    registry,\n    dataSourceRef: metadata.dataSource,\n    resolvedDataSource,\n  });\n\n  return {\n    type: RepositoryTypes.MODEL,\n    model: resolvedModel,\n    dataSource: resolvedDataSource,\n    operationScope: metadata.operationScope,\n  };\n};\n\n/** A bare `@repository()` on a subclass reuses the type, model and datasource its nearest decorated parent declared; the registration options (`binding`, `when`, ...) are never inherited, so the subclass registers under its own name. */\nconst inheritRepositoryMetadata = (opts: {\n  target: Function;\n  registry: MetadataRegistry;\n}): TRepositoryMetadata => {\n  // Own metadata does not exist yet at decoration time, so this read walks the prototype chain.\n  const inherited = opts.registry.getRepositoryMetadata({ target: opts.target });\n  if (!inherited) {\n    throw getError({\n      message: `[@repository][${opts.target.name}] No metadata given and no decorated repository above it in the prototype chain | pass { model, dataSource } or decorate the parent`,\n    });\n  }\n\n  if (inherited.type === RepositoryTypes.REMOTE) {\n    const { type, dataSource, operationScope } = inherited;\n    return { type, dataSource, operationScope };\n  }\n\n  const { type, model: parentModel, dataSource, operationScope } = inherited;\n  return { type, model: parentModel, dataSource, operationScope };\n};\n\nconst applyRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  registration: IArtifactRegistrationOptions;\n  target: Function;\n  registry: MetadataRegistry;\n}): void => {\n  const { metadata, registration, target, registry } = opts;\n  injectable({\n    type: ArtifactTypes.REPOSITORY,\n    ...pickRegistrationOptions({ metadata: registration }),\n  })(target);\n\n  const resolved = resolveRepositoryMetadata({ metadata, target, registry });\n\n  registry.setRepositoryMetadata({ target, metadata: { ...metadata, _resolved: resolved } });\n};\n\nexport const repository = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(\n  metadata?: TRepositoryMetadata<Model, DataSource>,\n): ClassDecorator => {\n  return (target) => {\n    const registry = MetadataRegistry.getInstance();\n    if (!metadata) {\n      applyRepositoryMetadata({\n        metadata: inheritRepositoryMetadata({ target, registry }),\n        registration: {},\n        target,\n        registry,\n      });\n      return;\n    }\n\n    applyRepositoryMetadata({ metadata, registration: metadata, target, registry });\n  };\n};\n"]}
+{"version":3,"file":"persistents.js","sourceRoot":"","sources":["../../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"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","sourcesContent":["import { BindingNamespaces } from '@/common/bindings';\nimport type {\n  IArtifactRegistrationOptions,\n  IDataSourceMetadata,\n  IInjectMetadata,\n  IModelMetadata,\n  IResolvedRepositoryMetadata,\n  TRepositoryMetadata,\n} from '@/helpers/inversion';\nimport {\n  ArtifactTypes,\n  BindingKeys,\n  MetadataKeys,\n  MetadataRegistry,\n  resolveInjectTarget,\n} from '@/helpers/inversion';\nimport { resolveClass, resolveValue } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IDataSource } from '../datasources';\nimport { isDataSourceClass } from '../datasources';\nimport type { AbstractEntity } from '../models';\nimport { RepositoryTypes } from '../repositories/common/constants';\nimport { injectable, pickRegistrationOptions } from './injectable';\nimport { normalizeModelMetadata } from './model-metadata';\nimport { assertNoRemovedModelSettings } from './model-settings';\n\n/** Registers a model class with its static schema and relations. */\nexport const model = (input: IModelMetadata = {}): ClassDecorator => {\n  return (target) => {\n    injectable({ type: ArtifactTypes.MODEL, ...pickRegistrationOptions({ metadata: input }) })(\n      target,\n    );\n\n    const metadata = normalizeModelMetadata({ model: target.name, metadata: input });\n\n    assertNoRemovedModelSettings({ model: target.name, settings: metadata.settings });\n    const { settings } = metadata;\n\n    const defaultLimit = settings?.query?.limit?.default;\n    if (defaultLimit !== undefined && (!Number.isInteger(defaultLimit) || defaultLimit <= 0)) {\n      throw getError({\n        message: `[model][${target.name}] Invalid 'query.limit.default' | Expected a positive integer | Got: ${defaultLimit}`,\n      });\n    }\n\n    // Validated at DECORATION time, like the default limit: a bad ceiling is a wiring mistake, and\n    // catching it at boot beats catching it on the one request that happens to reach the limit.\n    const maxLimit = settings?.query?.limit?.max;\n    if (maxLimit !== undefined && (!Number.isInteger(maxLimit) || maxLimit <= 0)) {\n      throw getError({\n        message: `[model][${target.name}] Invalid 'query.limit.max' | Expected a positive integer | Got: ${maxLimit}`,\n      });\n    }\n\n    // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set\n    const principal = settings?.authorize?.principal;\n    if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {\n      (target as Record<string, unknown>).AUTHORIZATION_SUBJECT = principal;\n    }\n\n    MetadataRegistry.getInstance().registerModel({ target, metadata });\n  };\n};\n\n/** Registers a datasource with driver and auto-discovery settings. */\nexport const datasource = (metadata?: IDataSourceMetadata): ClassDecorator => {\n  return (target) => {\n    injectable({\n      type: ArtifactTypes.DATASOURCE,\n      ...pickRegistrationOptions({ metadata: metadata ?? {} }),\n    })(target);\n    MetadataRegistry.getInstance().setDataSourceMetadata({ target, metadata });\n  };\n};\n\n/** Mirrors the `TRepositoryMetadata` union for JavaScript callers: a known type, a dataSource always, a model exactly when the type is RepositoryTypes.MODEL. */\nconst validateRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  target: Function;\n}): void => {\n  const { metadata, target } = opts;\n  const type = metadata.type ?? RepositoryTypes.MODEL;\n\n  if (!RepositoryTypes.isValid(type)) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Unknown 'type': ${type} | Expected one of: ${[...RepositoryTypes.SCHEME_SET].join(', ')}`,\n    });\n  }\n\n  if (type === RepositoryTypes.MODEL && !metadata.model) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'model'`,\n    });\n  }\n\n  if (type === RepositoryTypes.REMOTE && metadata.model) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | A '${RepositoryTypes.REMOTE}' repository takes no 'model'`,\n    });\n  }\n\n  if (!metadata.dataSource) {\n    throw getError({\n      message: `[validateRepositoryMetadata][@repository][${target.name}] Invalid metadata | Missing 'dataSource'`,\n    });\n  }\n};\n\n/** Asserts the constructor's first parameter is an AbstractDataSource compatible with what @repository declared. */\nconst validateFirstConstructorParameter = (opts: {\n  target: Function;\n  firstParamType: Function;\n  resolvedDataSource: string | Function;\n}): void => {\n  const { target, firstParamType, resolvedDataSource } = opts;\n\n  // NOT `instanceof`: two copies of this package give two `AbstractDataSource` classes and the\n  // check would be false across them, rejecting a perfectly valid repository at import time.\n  const isDataSourceType = isDataSourceClass(firstParamType);\n\n  if (!isDataSourceType) {\n    throw getError({\n      message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,\n    });\n  }\n\n  if (typeof resolvedDataSource !== 'function') {\n    return;\n  }\n\n  const isCompatible =\n    firstParamType === resolvedDataSource || resolvedDataSource.prototype instanceof firstParamType;\n\n  if (!isCompatible) {\n    throw getError({\n      message: `[@repository][${target.name}] Invalid constructor | Type mismatch | Constructor expects '${firstParamType.name}' but @repository specifies '${resolvedDataSource.name}'`,\n    });\n  }\n};\n\n/**\n * Auto-injects dataSource at constructor param[0] unless explicit @inject exists. A class is injected\n * by the class itself, so the container reads the key its registration recorded: a pinned\n * `binding` and a minified class name both resolve. Only a string reference is a key.\n */\nconst registerDataSourceInjection = (opts: {\n  target: Function;\n  registry: MetadataRegistry;\n  dataSourceRef: TRepositoryMetadata['dataSource'];\n  resolvedDataSource: string | Function;\n}): void => {\n  const { target, registry, dataSourceRef, resolvedDataSource } = opts;\n\n  // Own metadata only: `getInjectMetadata` walks the prototype chain, so a repository extending another @repository class would see the BASE's injection at param[0] and silently resolve the base's dataSource.\n  const ownInjects: IInjectMetadata[] | undefined = Reflect.getOwnMetadata(\n    MetadataKeys.INJECT,\n    target,\n  );\n  const injectAtIndex0 = ownInjects?.find((entry) => entry?.index === 0);\n\n  if (injectAtIndex0) {\n    // `@inject({ target })` carries no key; read the one recorded on the class. The function form\n    // resolves through the same helper the container uses, so both paths read one class.\n    const injectedTarget = injectAtIndex0.target\n      ? resolveInjectTarget({ target: injectAtIndex0.target })\n      : undefined;\n    const injectKey =\n      injectAtIndex0.key ??\n      (injectedTarget ? registry.getBindingKey({ target: injectedTarget }) : undefined);\n\n    // A class is judged by its brand: its key may sit under any namespace a `binding` pinned, and\n    // a provisional key may still change at registration. Only a bare key is judged by its prefix.\n    const isDataSourceTarget = injectedTarget\n      ? isDataSourceClass(injectedTarget)\n      : typeof injectKey === 'string' && injectKey.startsWith(`${BindingNamespaces.DATASOURCE}.`);\n\n    if (!isDataSourceTarget) {\n      throw getError({\n        message: `[@repository][${target.name}] Invalid constructor | First parameter must be a DataSource | Found @inject with key: '${String(injectKey)}' | Expected a key starting with '${BindingNamespaces.DATASOURCE}.' or a DataSource class`,\n      });\n    }\n\n    return;\n  }\n\n  // Checked only when this decorator writes the injection: an explicit @inject decides for itself.\n  // An interface emits `Object` and a type-only class import emits `Function` under tsc (`Object`\n  // under bun); neither names the class, so neither is judged.\n  const firstParamType = Reflect.getMetadata('design:paramtypes', target)?.[0];\n  if (firstParamType && firstParamType !== Object && firstParamType !== Function) {\n    validateFirstConstructorParameter({ target, firstParamType, resolvedDataSource });\n  }\n\n  // The inherited list is the base repository's own, and setInjectMetadata may write straight into it.\n  if (!ownInjects) {\n    Reflect.defineMetadata(\n      MetadataKeys.INJECT,\n      [...(registry.getInjectMetadata({ target }) ?? [])],\n      target,\n    );\n  }\n\n  const derivedKey = BindingKeys.build({\n    namespace: BindingNamespaces.DATASOURCE,\n    key: typeof resolvedDataSource === 'string' ? resolvedDataSource : resolvedDataSource.name,\n  });\n\n  // The class first, decided when the repository is resolved: by then any registration - decorated,\n  // `bindingList()`, or `dataSource(X, { binding })` - has recorded its key on the class. The derived\n  // key is the fallback for a class nothing recorded, bound by hand under exactly that key.\n  registry.setInjectMetadata({\n    target,\n    index: 0,\n    metadata:\n      typeof dataSourceRef === 'string'\n        ? { key: derivedKey, index: 0, isOptional: false }\n        : { target: dataSourceRef, key: derivedKey, index: 0, isOptional: false },\n  });\n};\n\n/** Resolves repository metadata and registers bindings for schema auto-discovery. */\nconst resolveRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  target: Function;\n  registry: MetadataRegistry;\n}): IResolvedRepositoryMetadata<Model, DataSource> => {\n  const { metadata, target, registry } = opts;\n\n  validateRepositoryMetadata({ metadata, target });\n\n  const resolvedDataSource = resolveClass({ ref: metadata.dataSource });\n  if (!resolvedDataSource) {\n    throw getError({\n      message: `[@repository][${target.name}] The dataSource resolver returned nothing at decoration time | An import cycle leaves the datasource class undefined here; import it without the cycle, or name it as a string`,\n    });\n  }\n\n  // No model, so no binding: the datasource owns no schema through this repository.\n  if (metadata.type === RepositoryTypes.REMOTE) {\n    registerDataSourceInjection({\n      target,\n      registry,\n      dataSourceRef: metadata.dataSource,\n      resolvedDataSource,\n    });\n    return {\n      type: RepositoryTypes.REMOTE,\n      dataSource: resolvedDataSource,\n      operationScope: metadata.operationScope,\n    };\n  }\n\n  const resolvedModel = resolveValue({ value: metadata.model });\n\n  registry.registerRepositoryBinding({\n    repository: target,\n    model: resolvedModel,\n    dataSource: resolvedDataSource,\n  });\n\n  registerDataSourceInjection({\n    target,\n    registry,\n    dataSourceRef: metadata.dataSource,\n    resolvedDataSource,\n  });\n\n  return {\n    type: RepositoryTypes.MODEL,\n    model: resolvedModel,\n    dataSource: resolvedDataSource,\n    operationScope: metadata.operationScope,\n  };\n};\n\n/** A bare `@repository()` on a subclass reuses the type, model and datasource its nearest decorated parent declared; the registration options (`binding`, `when`, ...) are never inherited, so the subclass registers under its own name. */\nconst inheritRepositoryMetadata = (opts: {\n  target: Function;\n  registry: MetadataRegistry;\n}): TRepositoryMetadata => {\n  // Own metadata does not exist yet at decoration time, so this read walks the prototype chain.\n  const inherited = opts.registry.getRepositoryMetadata({ target: opts.target });\n  if (!inherited) {\n    throw getError({\n      message: `[@repository][${opts.target.name}] No metadata given and no decorated repository above it in the prototype chain | pass { model, dataSource } or decorate the parent`,\n    });\n  }\n\n  if (inherited.type === RepositoryTypes.REMOTE) {\n    const { type, dataSource, operationScope } = inherited;\n    return { type, dataSource, operationScope };\n  }\n\n  const { type, model: parentModel, dataSource, operationScope } = inherited;\n  return { type, model: parentModel, dataSource, operationScope };\n};\n\nconst applyRepositoryMetadata = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(opts: {\n  metadata: TRepositoryMetadata<Model, DataSource>;\n  registration: IArtifactRegistrationOptions;\n  target: Function;\n  registry: MetadataRegistry;\n}): void => {\n  const { metadata, registration, target, registry } = opts;\n  injectable({\n    type: ArtifactTypes.REPOSITORY,\n    ...pickRegistrationOptions({ metadata: registration }),\n  })(target);\n\n  const resolved = resolveRepositoryMetadata({ metadata, target, registry });\n\n  registry.setRepositoryMetadata({ target, metadata: { ...metadata, _resolved: resolved } });\n};\n\nexport const repository = <\n  Model extends AbstractEntity = AbstractEntity,\n  DataSource extends IDataSource = IDataSource,\n>(\n  metadata?: TRepositoryMetadata<Model, DataSource>,\n): ClassDecorator => {\n  return (target) => {\n    const registry = MetadataRegistry.getInstance();\n    if (!metadata) {\n      applyRepositoryMetadata({\n        metadata: inheritRepositoryMetadata({ target, registry }),\n        registration: {},\n        target,\n        registry,\n      });\n      return;\n    }\n\n    applyRepositoryMetadata({ metadata, registration: metadata, target, registry });\n  };\n};\n"]}

package/dist/cjs/base/models/common/constants.d.ts

@@ -8,4 +8,21 @@ export declare class SchemaTypes {
     static isValid(input: string): input is TSchemaType;
 }
 export type TSchemaType = TConstValue<typeof SchemaTypes>;
+/** What `@model` declares. Only ENTITY (a table-backed model) exists; `type` may be left out. */
+export declare class ModelTypes {
+    static readonly ENTITY = "entity";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+/** Valid model type values. */
+export type TModelType = TConstValue<typeof ModelTypes>;
+/** The path-param id shape an entity family resolves to (`AbstractEntity.getIdType()`). */
+export declare class IdSchemaTypes {
+    static readonly NUMBER = "number";
+    static readonly STRING = "string";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+/** Valid id schema type values. */
+export type TIdSchemaType = TConstValue<typeof IdSchemaTypes>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/cjs/base/models/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkE;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkE;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D,iGAAiG;AACjG,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA0B;IAEpD,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD,2FAA2F;AAC3F,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAElC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+C;IAEzE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/cjs/base/models/common/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaTypes = void 0;
+exports.IdSchemaTypes = exports.ModelTypes = exports.SchemaTypes = void 0;
 class SchemaTypes {
     static { this.SELECT = 'select'; }
     static { this.UPDATE = 'update'; }
@@ -12,4 +12,23 @@ class SchemaTypes {
     }
 }
 exports.SchemaTypes = SchemaTypes;
+/** What `@model` declares. Only ENTITY (a table-backed model) exists; `type` may be left out. */
+class ModelTypes {
+    static { this.ENTITY = 'entity'; }
+    static { this.SCHEME_SET = new Set([this.ENTITY]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.ModelTypes = ModelTypes;
+/** The path-param id shape an entity family resolves to (`AbstractEntity.getIdType()`). */
+class IdSchemaTypes {
+    static { this.NUMBER = 'number'; }
+    static { this.STRING = 'string'; }
+    static { this.SCHEME_SET = new Set([this.NUMBER, this.STRING]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.IdSchemaTypes = IdSchemaTypes;
 //# sourceMappingURL=constants.js.map

package/dist/cjs/base/models/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;aACN,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAVH,kCAWC","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\n\nexport class SchemaTypes {\n  static readonly SELECT = 'select';\n  static readonly UPDATE = 'update';\n  static readonly CREATE = 'create';\n  static readonly EXECUTE = 'execute';\n\n  static readonly SCHEME_SET = new Set([this.SELECT, this.UPDATE, this.CREATE, this.EXECUTE]);\n\n  static isValid(input: string): input is TSchemaType {\n    return this.SCHEME_SET.has(input);\n  }\n}\n\nexport type TSchemaType = TConstValue<typeof SchemaTypes>;\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/base/models/common/constants.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;aACN,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAVH,kCAWC;AAID,iGAAiG;AACjG,MAAa,UAAU;aACL,WAAM,GAAG,QAAQ,CAAC;aAClB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpD,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AANH,gCAOC;AAKD,2FAA2F;AAC3F,MAAa,aAAa;aACR,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAElB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AARH,sCASC","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers/common';\n\nexport class SchemaTypes {\n  static readonly SELECT = 'select';\n  static readonly UPDATE = 'update';\n  static readonly CREATE = 'create';\n  static readonly EXECUTE = 'execute';\n\n  static readonly SCHEME_SET = new Set([this.SELECT, this.UPDATE, this.CREATE, this.EXECUTE]);\n\n  static isValid(input: string): input is TSchemaType {\n    return this.SCHEME_SET.has(input);\n  }\n}\n\nexport type TSchemaType = TConstValue<typeof SchemaTypes>;\n\n/** What `@model` declares. Only ENTITY (a table-backed model) exists; `type` may be left out. */\nexport class ModelTypes {\n  static readonly ENTITY = 'entity';\n  static readonly SCHEME_SET = new Set([this.ENTITY]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\n/** Valid model type values. */\nexport type TModelType = TConstValue<typeof ModelTypes>;\n\n/** The path-param id shape an entity family resolves to (`AbstractEntity.getIdType()`). */\nexport class IdSchemaTypes {\n  static readonly NUMBER = 'number';\n  static readonly STRING = 'string';\n\n  static readonly SCHEME_SET = new Set<string>([this.NUMBER, this.STRING]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\n/** Valid id schema type values. */\nexport type TIdSchemaType = TConstValue<typeof IdSchemaTypes>;\n"]}

package/dist/cjs/base/models/common/schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from '@hono/zod-openapi';
-import type { TIdSchemaType } from './types';
+import type { TIdSchemaType } from './constants';
 /**
  * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.
  * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.

package/dist/cjs/base/models/common/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE;;;;iBAkC9D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM;IACrD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;CAMA,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI1B,CAAC;AAEF,mCAAmC;AACnC,KAAK,aAAa,GAAG;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,4CAA4C;AAC5C,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEtD,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,gBAAgB,GAAG,SAAS,IAAI;IACpF,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcrD,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;iBA6BpB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE;;;;iBAkC9D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM;IACrD,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;CAMA,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI1B,CAAC;AAEF,mCAAmC;AACnC,KAAK,aAAa,GAAG;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF,4CAA4C;AAC5C,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEtD,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,gBAAgB,GAAG,SAAS,IAAI;IACpF,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,aAAa,SAAS,CAAC,CAAC,OAAO,EAC/B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcrD,CAAC"}

package/dist/cjs/base/models/common/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType } from './types';\n\n/**\n * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.\n * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.\n */\nexport const ErrorSchema = z\n  .object({\n    statusCode: z.number().optional(),\n    message: z.string(),\n    normalized: z\n      .object({\n        text: z.string(),\n        code: z.string(),\n        args: z.record(z.string(), z.any()),\n      })\n      .optional(),\n    extra: z.record(z.string(), z.any()).optional(),\n    requestId: z.string().optional(),\n    details: z.record(z.string(), z.any()).optional(),\n  })\n  .openapi('ErrorResponse', {\n    description: 'Error Schema',\n    example: {\n      statusCode: HTTP.ResultCodes.RS_4.Conflict,\n      message: 'A category named %{name} already exists.',\n      normalized: {\n        text: 'A category named %{name} already exists.',\n        code: 'server.commerce.category.create.duplicate_name',\n        args: { name: 'Ticket' },\n      },\n      extra: { categoryId: 42 },\n      requestId: 'abc-123-def',\n      details: { url: 'http://localhost:3000/categories', path: '/categories' },\n    },\n  });\n\nexport type TErrorResponse = z.infer<typeof ErrorSchema>;\n\nexport const idParamsSchema = (opts?: { idType: TIdSchemaType }) => {\n  const { idType = 'number' } = opts ?? {};\n\n  switch (idType) {\n    case 'number': {\n      return z.object({\n        id: z.number().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: [1, 2, 3],\n        }),\n      });\n    }\n    case 'string': {\n      return z.object({\n        id: z.string().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],\n        }),\n      });\n    }\n    default: {\n      throw getError({\n        message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,\n      });\n    }\n  }\n};\n\nexport const jsonContent = <T extends z.ZodType>(opts: {\n  schema: T;\n  description: string;\n  required?: boolean;\n}) => {\n  return {\n    description: opts.description,\n    content: { 'application/json': { schema: opts.schema } },\n    required: opts.required,\n  };\n};\n\n/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */\nexport const errorResponses = () => {\n  const errorResponse = jsonContent({ description: 'Error Response', schema: ErrorSchema });\n\n  return { '4XX': errorResponse, '5XX': errorResponse };\n};\n\n/** OpenAPI Header Object format */\ntype THeaderObject = {\n  description?: string;\n  schema: { type: string; examples?: Array<string> };\n};\n\n/** Map of header names to Header Objects */\ntype TResponseHeaders = Record<string, THeaderObject>;\n\ntype TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {\n  schema: T;\n  description?: string;\n  required?: boolean;\n  headers?: H;\n};\n\nexport const jsonResponse = <\n  ContentSchema extends z.ZodType,\n  HeaderSchema extends TResponseHeaders | undefined = undefined,\n>(\n  opts: TJsonResponseOpts<ContentSchema, HeaderSchema>,\n) => {\n  const baseResponse = jsonContent({\n    required: opts.required,\n    description: opts.description ?? 'Success Response',\n    schema: opts.schema,\n  });\n\n  const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;\n\n  return {\n    [HTTP.ResultCodes.RS_2.Ok]: successResponse,\n    ...errorResponses(),\n  };\n};\n"]}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/base/models/common/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from '@hono/zod-openapi';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { TIdSchemaType } from './constants';\n\n/**\n * The error RESPONSE for OpenAPI docs - here, beside the REST layer that already needs `@hono/zod-openapi`.\n * Named, so every route's `4XX` and `5XX` reference one `ErrorResponse` component.\n */\nexport const ErrorSchema = z\n  .object({\n    statusCode: z.number().optional(),\n    message: z.string(),\n    normalized: z\n      .object({\n        text: z.string(),\n        code: z.string(),\n        args: z.record(z.string(), z.any()),\n      })\n      .optional(),\n    extra: z.record(z.string(), z.any()).optional(),\n    requestId: z.string().optional(),\n    details: z.record(z.string(), z.any()).optional(),\n  })\n  .openapi('ErrorResponse', {\n    description: 'Error Schema',\n    example: {\n      statusCode: HTTP.ResultCodes.RS_4.Conflict,\n      message: 'A category named %{name} already exists.',\n      normalized: {\n        text: 'A category named %{name} already exists.',\n        code: 'server.commerce.category.create.duplicate_name',\n        args: { name: 'Ticket' },\n      },\n      extra: { categoryId: 42 },\n      requestId: 'abc-123-def',\n      details: { url: 'http://localhost:3000/categories', path: '/categories' },\n    },\n  });\n\nexport type TErrorResponse = z.infer<typeof ErrorSchema>;\n\nexport const idParamsSchema = (opts?: { idType: TIdSchemaType }) => {\n  const { idType = 'number' } = opts ?? {};\n\n  switch (idType) {\n    case 'number': {\n      return z.object({\n        id: z.number().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: [1, 2, 3],\n        }),\n      });\n    }\n    case 'string': {\n      return z.object({\n        id: z.string().openapi({\n          param: {\n            name: 'id',\n            in: 'path',\n            description: 'The unique id of the resource',\n          },\n          examples: ['4651e634-a530-4484-9b09-9616a28f35e3', 'some_unique_id'],\n        }),\n      });\n    }\n    default: {\n      throw getError({\n        message: `[idParamsSchema] Invalid input idType | valid: [string | number] | idType: ${idType}`,\n      });\n    }\n  }\n};\n\nexport const jsonContent = <T extends z.ZodType>(opts: {\n  schema: T;\n  description: string;\n  required?: boolean;\n}) => {\n  return {\n    description: opts.description,\n    content: { 'application/json': { schema: opts.schema } },\n    required: opts.required,\n  };\n};\n\n/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */\nexport const errorResponses = () => {\n  const errorResponse = jsonContent({ description: 'Error Response', schema: ErrorSchema });\n\n  return { '4XX': errorResponse, '5XX': errorResponse };\n};\n\n/** OpenAPI Header Object format */\ntype THeaderObject = {\n  description?: string;\n  schema: { type: string; examples?: Array<string> };\n};\n\n/** Map of header names to Header Objects */\ntype TResponseHeaders = Record<string, THeaderObject>;\n\ntype TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefined> = {\n  schema: T;\n  description?: string;\n  required?: boolean;\n  headers?: H;\n};\n\nexport const jsonResponse = <\n  ContentSchema extends z.ZodType,\n  HeaderSchema extends TResponseHeaders | undefined = undefined,\n>(\n  opts: TJsonResponseOpts<ContentSchema, HeaderSchema>,\n) => {\n  const baseResponse = jsonContent({\n    required: opts.required,\n    description: opts.description ?? 'Success Response',\n    schema: opts.schema,\n  });\n\n  const successResponse = opts.headers ? { ...baseResponse, headers: opts.headers } : baseResponse;\n\n  return {\n    [HTTP.ResultCodes.RS_2.Ok]: successResponse,\n    ...errorResponses(),\n  };\n};\n"]}

package/dist/cjs/base/models/common/types/id.d.ts

@@ -18,7 +18,5 @@ declare const entityIdBrand: unique symbol;
 export type TEntityId = string & {
     readonly [entityIdBrand]: never;
 };
-/** Path-param id shape every entity family resolves to (`AbstractEntity.getIdType()`). */
-export type TIdSchemaType = 'number' | 'string';
 export {};
 //# sourceMappingURL=id.d.ts.map

package/dist/cjs/base/models/common/types/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAErE,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC"}

package/dist/cjs/base/models/common/types/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"","sourcesContent":["export type NumberIdType = number;\nexport type StringIdType = string;\nexport type BigIntIdType = bigint;\nexport type IdType = NumberIdType | StringIdType | BigIntIdType;\n\ndeclare const entityIdBrand: unique symbol;\n\n/**\n * A string id a plain `string` cannot be assigned to, so passing a name, code or email where an id\n * belongs is a compile error. Opt a column in with `.$type<TEntityId>()`.\n *\n * IT VALIDATES NOTHING. `toEntityId` is a cast with a non-empty check; the value is making the\n * laundering VISIBLE at each boundary, not proving the string is a real id.\n *\n * The cost is not optional: Drizzle derives `$inferInsert` and `$inferSelect` from the same field,\n * so a branded column rejects every literal - `create({ data: { merchantId: 'M1' } })`, seeds,\n * fixtures, path params - until each converts. A union with `string` would restore those but makes\n * a plain `string` assignable again, which erases the whole guarantee. Measured, not assumed.\n */\nexport type TEntityId = string & { readonly [entityIdBrand]: never };\n\n/** Path-param id shape every entity family resolves to (`AbstractEntity.getIdType()`). */\nexport type TIdSchemaType = 'number' | 'string';\n"]}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../../../src/base/models/common/types/id.ts"],"names":[],"mappings":"","sourcesContent":["export type NumberIdType = number;\nexport type StringIdType = string;\nexport type BigIntIdType = bigint;\nexport type IdType = NumberIdType | StringIdType | BigIntIdType;\n\ndeclare const entityIdBrand: unique symbol;\n\n/**\n * A string id a plain `string` cannot be assigned to, so passing a name, code or email where an id\n * belongs is a compile error. Opt a column in with `.$type<TEntityId>()`.\n *\n * IT VALIDATES NOTHING. `toEntityId` is a cast with a non-empty check; the value is making the\n * laundering VISIBLE at each boundary, not proving the string is a real id.\n *\n * The cost is not optional: Drizzle derives `$inferInsert` and `$inferSelect` from the same field,\n * so a branded column rejects every literal - `create({ data: { merchantId: 'M1' } })`, seeds,\n * fixtures, path params - until each converts. A union with `string` would restore those but makes\n * a plain `string` assignable again, which erases the whole guarantee. Measured, not assumed.\n */\nexport type TEntityId = string & { readonly [entityIdBrand]: never };\n"]}