@venizia/ignis 0.0.7-8 → 0.0.7

package/dist/base/datasources/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base/datasources/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AACtC,OAAO,EACL,WAAW,EAEX,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAGlB,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IAE7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IAErB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpF,WAAW;IAIX,YAAY;IAIZ,SAAS,IAAI,MAAM;CAQpB;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,cAAc,CAClC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IACjE;;;;OAIG;gBACS,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE;;OAEG;IACM,SAAS,IAAI,MAAM;IAO5B;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,MAAM;IA0BlC,qBAAqB,IAAI,OAAO;IAQ1B,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;CAuDlF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base/datasources/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AACtC,OAAO,EACL,WAAW,EAEX,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EAEpB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAElB,8BAAsB,kBAAkB,CACtC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,UACR,YAAW,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IAE7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IAErB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC,IAAI,CAAC;IACpE,QAAQ,CAAC,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpF,WAAW;IAIX,YAAY;IAIZ,SAAS,IAAI,MAAM;CAQpB;AAED,+EAA+E;AAC/E,8BAAsB,cAAc,CAClC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;gBACrD,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAWrE,wEAAwE;IAC/D,SAAS,IAAI,MAAM;IAO5B,SAAS,CAAC,cAAc,IAAI,MAAM;IA0BlC,qBAAqB,IAAI,OAAO;IAK1B,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;CAoDlF"}

package/dist/base/datasources/base.js

@@ -5,7 +5,6 @@ const inversion_1 = require("../../helpers/inversion");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const node_postgres_1 = require("drizzle-orm/node-postgres");
 const common_1 = require("./common");
-// --------------------------------------------------------------------------------------
 class AbstractDataSource extends ignis_helpers_1.BaseHelper {
     getSettings() {
         return this.settings;
@@ -23,33 +22,8 @@ class AbstractDataSource extends ignis_helpers_1.BaseHelper {
     }
 }
 exports.AbstractDataSource = AbstractDataSource;
-// --------------------------------------------------------------------------------------
-/**
- * Base DataSource with auto-discovery support.
- *
- * Features:
- * - Schema auto-discovered from registered repositories
- *
- * Usage:
- * ```typescript
- * @datasource({})
- * export class PostgresDataSource extends BaseDataSource<IDbConfig> {
- *   constructor() {
- *     super({
- *       name: PostgresDataSource.name,
- *       config: { host: '...', port: 5432, ... },
- *       // schema auto-discovered from repositories
- *     });
- *   }
- * }
- * ```
- */
+/** Base DataSource with schema auto-discovery from registered repositories. */
 class BaseDataSource extends AbstractDataSource {
-    /**
-     * @param opts.name - DataSource name (usually class name)
-     * @param opts.config - Database connection settings
-     * @param opts.schema - Optional, auto-discovered from repositories if not provided
-     */
     constructor(opts) {
         super({ scope: opts.name });
         this.name = opts.name;
@@ -58,18 +32,13 @@ class BaseDataSource extends AbstractDataSource {
             this.schema = opts.schema;
         }
     }
-    /**
-     * Get the schema - auto-discovers if not manually provided.
-     */
+    /** Auto-discovers schema from repositories if not manually provided. */
     getSchema() {
         if (!this.schema) {
             this.schema = this.discoverSchema();
         }
         return this.schema;
     }
-    /**
-     * Build schema from registered repositories that reference this datasource.
-     */
     discoverSchema() {
         const registry = inversion_1.MetadataRegistry.getInstance();
         const metadata = registry.getDataSourceMetadata({ target: this.constructor });
@@ -90,9 +59,6 @@ class BaseDataSource extends AbstractDataSource {
         const registry = inversion_1.MetadataRegistry.getInstance();
         return registry.hasModels({ dataSource: this.constructor });
     }
-    // ---------------------------------------------------------------------------
-    // Transaction Support
-    // ---------------------------------------------------------------------------
     async beginTransaction(opts) {
         if (!this.pool) {
             throw (0, ignis_helpers_1.getError)({
@@ -106,11 +72,9 @@ class BaseDataSource extends AbstractDataSource {
         return {
             isolationLevel,
             connector: (0, node_postgres_1.drizzle)({ client, schema: this.schema }),
-            // On-demand check transaction state
             get isActive() {
                 return isActive;
             },
-            // COMMIT Action
             commit: async () => {
                 if (!isActive) {
                     throw (0, ignis_helpers_1.getError)({ message: '[Transaction][commit] Transaction already ended' });
@@ -126,7 +90,6 @@ class BaseDataSource extends AbstractDataSource {
                     client.release();
                 }
             },
-            // ROLLBACK Action
             rollback: async () => {
                 if (!isActive) {
                     throw (0, ignis_helpers_1.getError)({ message: '[Transaction][rollback] Transaction already ended' });

package/dist/base/datasources/base.js.map

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

package/dist/base/datasources/common/types.d.ts

@@ -9,12 +9,10 @@ export declare class DataSourceDrivers {
 export type TDataSourceDriver = TConstValue<typeof DataSourceDrivers>;
 export type TAnyDataSourceSchema = Record<string, any>;
 export type TNodePostgresConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema, Client extends NodePgClient = NodePgClient> = ReturnType<typeof nodePostgresConnector<DataSourceSchema, Client>>;
+/** Uses PoolClient specifically for transaction isolation. */
 export type TNodePostgresTransactionConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = ReturnType<typeof nodePostgresConnector<DataSourceSchema, PoolClient>>;
 export type TAnyConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = TNodePostgresConnector<DataSourceSchema> | TNodePostgresTransactionConnector<DataSourceSchema>;
-/**
- * PostgreSQL transaction isolation levels.
- * Uses static class pattern per code-style-standards.md
- */
+/** PostgreSQL transaction isolation levels. */
 export declare class IsolationLevels {
     static readonly READ_COMMITTED = "READ COMMITTED";
     static readonly REPEATABLE_READ = "REPEATABLE READ";

package/dist/base/datasources/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAIrC,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAEhD,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiC;IAE3D,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGvD,MAAM,MAAM,sBAAsB,CAChC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,EACpE,MAAM,SAAS,YAAY,GAAG,YAAY,IACxC,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAGvE,MAAM,MAAM,iCAAiC,CAC3C,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAClE,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;AAG3E,MAAM,MAAM,aAAa,CAAC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAC1F,sBAAsB,CAAC,gBAAgB,CAAC,GACxC,iCAAiC,CAAC,gBAAgB,CAAC,CAAC;AAMxD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAE9C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAIvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB;IACtF,SAAS,EAAE,iCAAiC,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,eAAe,CAAC;IAEhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAKD,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,IAAI,QAAQ,CAAC;IACxB,YAAY,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,SAAS,IAAI,MAAM,CAAC;IACpB,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,KAAK,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACrC,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAEhD,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiC;IAE3D,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvD,MAAM,MAAM,sBAAsB,CAChC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,EACpE,MAAM,SAAS,YAAY,GAAG,YAAY,IACxC,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,iCAAiC,CAC3C,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAClE,UAAU,CAAC,OAAO,qBAAqB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3E,MAAM,MAAM,aAAa,CAAC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAC1F,sBAAsB,CAAC,gBAAgB,CAAC,GACxC,iCAAiC,CAAC,gBAAgB,CAAC,CAAC;AACxD,+CAA+C;AAC/C,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAE9C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAIvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB;IACtF,SAAS,EAAE,iCAAiC,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,eAAe,CAAC;IAEhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CACvC,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,IAAI,QAAQ,CAAC;IACxB,YAAY,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,SAAS,IAAI,MAAM,CAAC;IACpB,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7E"}

package/dist/base/datasources/common/types.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IsolationLevels = exports.DataSourceDrivers = void 0;
-// ----------------------------------------------------------------------------------------------------------------------------------------
 class DataSourceDrivers {
     static { this.NODE_POSTGRES = 'node-postgres'; }
     static { this.SCHEME_SET = new Set([this.NODE_POSTGRES]); }
@@ -10,13 +9,7 @@ class DataSourceDrivers {
     }
 }
 exports.DataSourceDrivers = DataSourceDrivers;
-// ----------------------------------------------------------------------------------------------------------------------------------------
-// Transaction Support
-// ----------------------------------------------------------------------------------------------------------------------------------------
-/**
- * PostgreSQL transaction isolation levels.
- * Uses static class pattern per code-style-standards.md
- */
+/** PostgreSQL transaction isolation levels. */
 class IsolationLevels {
     static { this.READ_COMMITTED = 'READ COMMITTED'; }
     static { this.REPEATABLE_READ = 'REPEATABLE READ'; }

package/dist/base/datasources/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":";;;AAIA,2IAA2I;AAE3I,MAAa,iBAAiB;aACZ,kBAAa,GAAG,eAAe,CAAC;aAEhC,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAE3D,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAPH,8CAQC;AAqBD,2IAA2I;AAC3I,sBAAsB;AACtB,2IAA2I;AAE3I;;;GAGG;AACH,MAAa,eAAe;aACV,mBAAc,GAAG,gBAAgB,CAAC;aAClC,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,YAAY;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAbH,0CAcC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/base/datasources/common/types.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;aACZ,kBAAa,GAAG,eAAe,CAAC;aAEhC,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAE3D,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAPH,8CAQC;AAkBD,+CAA+C;AAC/C,MAAa,eAAe;aACV,mBAAc,GAAG,gBAAgB,CAAC;aAClC,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,eAAe;QACpB,IAAI,CAAC,YAAY;KAClB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAbH,0CAcC"}

package/dist/base/metadata/injectors.d.ts

@@ -1,35 +1,6 @@
 import { IInjectableMetadata } from '../../helpers/inversion';
 export declare const injectable: (metadata: IInjectableMetadata) => ClassDecorator;
-/**
- * @inject decorator - Marks a property or constructor parameter for dependency injection
- *
- * Usage examples:
- *
- * 1. Property injection:
- * ```typescript
- * class UserService {
- *   @inject({ key: 'UserRepository' })
- *   userRepository: UserRepository;
- * }
- * ```
- *
- * 2. Constructor parameter injection:
- * ```typescript
- * class UserService {
- *   constructor(
- *     @inject({ key: 'UserRepository' })
- *     private userRepository: UserRepository,
- *
- *     @inject({ key: 'Logger', optional: true })
- *     private logger?: Logger
- *   ) {}
- * }
- * ```
- *
- * @param opts - Injection options
- * @param opts.key - The binding key to inject (can be string or symbol)
- * @param opts.optional - Whether the dependency is optional (defaults to false)
- */
+/** Marks a property or constructor parameter for dependency injection. */
 export declare const inject: (opts: {
     key: string | symbol;
     isOptional?: boolean;

package/dist/base/metadata/injectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injectors.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAG5E,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAE1D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM;IAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,8FAE1E,CAAC"}
+{"version":3,"file":"injectors.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAG5E,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAE1D,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,MAAM,GAAI,MAAM;IAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,8FAE1E,CAAC"}

package/dist/base/metadata/injectors.js

@@ -7,36 +7,7 @@ const injectable = (metadata) => {
     return (0, ignis_inversion_1.injectable)(metadata, inversion_1.MetadataRegistry.getInstance());
 };
 exports.injectable = injectable;
-/**
- * @inject decorator - Marks a property or constructor parameter for dependency injection
- *
- * Usage examples:
- *
- * 1. Property injection:
- * ```typescript
- * class UserService {
- *   @inject({ key: 'UserRepository' })
- *   userRepository: UserRepository;
- * }
- * ```
- *
- * 2. Constructor parameter injection:
- * ```typescript
- * class UserService {
- *   constructor(
- *     @inject({ key: 'UserRepository' })
- *     private userRepository: UserRepository,
- *
- *     @inject({ key: 'Logger', optional: true })
- *     private logger?: Logger
- *   ) {}
- * }
- * ```
- *
- * @param opts - Injection options
- * @param opts.key - The binding key to inject (can be string or symbol)
- * @param opts.optional - Whether the dependency is optional (defaults to false)
- */
+/** Marks a property or constructor parameter for dependency injection. */
 const inject = (opts) => {
     return (0, ignis_inversion_1.inject)({ ...opts, registry: inversion_1.MetadataRegistry.getInstance() });
 };

package/dist/base/metadata/injectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectors.js","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":";;;AAAA,mDAA4E;AAC5E,8DAA8F;AAEvF,MAAM,UAAU,GAAG,CAAC,QAA6B,EAAkB,EAAE;IAC1E,OAAO,IAAA,4BAAc,EAAC,QAAQ,EAAE,4BAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACI,MAAM,MAAM,GAAG,CAAC,IAAoD,EAAE,EAAE;IAC7E,OAAO,IAAA,wBAAU,EAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,4BAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB"}
+{"version":3,"file":"injectors.js","sourceRoot":"","sources":["../../../src/base/metadata/injectors.ts"],"names":[],"mappings":";;;AAAA,mDAA4E;AAC5E,8DAA8F;AAEvF,MAAM,UAAU,GAAG,CAAC,QAA6B,EAAkB,EAAE;IAC1E,OAAO,IAAA,4BAAc,EAAC,QAAQ,EAAE,4BAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEF,0EAA0E;AACnE,MAAM,MAAM,GAAG,CAAC,IAAoD,EAAE,EAAE;IAC7E,OAAO,IAAA,wBAAU,EAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,4BAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB"}

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

@@ -2,70 +2,10 @@ import { IDataSourceMetadata, IModelMetadata, IRepositoryMetadata } from '../../
 import { IDataSource } from '../datasources';
 import { BaseEntity } from '../models';
 import { TTableSchemaWithId } from '../models/common';
-/**
- * @model decorator - Registers a model class with its static schema and relations.
- *
- * Usage with static schema (Option A - Power Users):
- * ```typescript
- * @model({ type: 'entity' })
- * export class User extends BaseEntity {
- *   static schema = pgTable('User', { ... });
- *   static relations = () => ({ ... });
- * }
- * ```
- */
+/** Registers a model class with its static schema and relations. */
 export declare const model: (metadata: IModelMetadata) => ClassDecorator;
-/**
- * @datasource decorator - Registers a datasource with driver and auto-discovery.
- *
- * The driver is automatically read by BaseDataSource from this decorator,
- * so you don't need to pass it in the constructor.
- *
- * Usage:
- * ```typescript
- * @datasource({ driver: 'node-postgres' })
- * export class PostgresDataSource extends BaseDataSource<TNodePostgresConnector, IDbConfig> {
- *   constructor() {
- *     super({
- *       name: PostgresDataSource.name,
- *       config: { host: '...', port: 5432, ... },
- *       // driver read from decorator - no need to pass here!
- *       // schema auto-discovered from repositories
- *     });
- *   }
- * }
- * ```
- */
+/** Registers a datasource with driver and auto-discovery settings. */
 export declare const datasource: (metadata: IDataSourceMetadata) => ClassDecorator;
-/**
- * @repository decorator - Binds a repository to a model and datasource.
- *
- * IMPORTANT: Both `model` AND `dataSource` are required for schema auto-discovery.
- * Without both, the model won't be registered and relational queries will fail.
- *
- * Supports these injection patterns:
- *
- * 1. Zero boilerplate - dataSource auto-injected from metadata:
- * ```typescript
- * @repository({ model: User, dataSource: PostgresDataSource })
- * export class UserRepository extends PersistableRepository<typeof User.schema> {
- *   // No constructor needed - datasource auto-injected at param index 0
- * }
- * ```
- *
- * 2. Explicit @inject with @repository - when you need constructor control:
- * ```typescript
- * @repository({ model: User, dataSource: PostgresDataSource })
- * export class UserRepository extends PersistableRepository<typeof User.schema> {
- *   constructor(
- *     @inject({ key: 'datasources.PostgresDataSource' })
- *     ds: PostgresDataSource,
- *   ) {
- *     super(ds, { entityClass: User });
- *   }
- * }
- * ```
- * Note: When @inject is at param index 0, auto-injection is skipped (your @inject takes precedence).
- */
+/** Binds a repository to a model and datasource for schema auto-discovery. */
 export declare const repository: <Schema extends TTableSchemaWithId = TTableSchemaWithId, Model extends BaseEntity<Schema> = BaseEntity<Schema>, DataSource extends IDataSource = IDataSource>(metadata: IRepositoryMetadata<Schema, Model, DataSource>) => ClassDecorator;
 //# sourceMappingURL=persistents.d.ts.map

package/dist/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,EAEL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EAGpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAsB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cAMhD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC;AAgJF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,EACtD,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EACrD,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KACvD,cAaF,CAAC"}
+{"version":3,"file":"persistents.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/persistents.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EAGpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAsB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,UAAU,cAAc,KAAG,cAUhD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC;AA6HF,8EAA8E;AAC9E,eAAO,MAAM,UAAU,GACrB,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,EACtD,KAAK,SAAS,UAAU,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EACrD,UAAU,SAAS,WAAW,GAAG,WAAW,EAE5C,UAAU,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KACvD,cAYF,CAAC"}

package/dist/base/metadata/persistents.js

@@ -5,56 +5,26 @@ const bindings_1 = require("../../common/bindings");
 const inversion_1 = require("../../helpers/inversion");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const datasources_1 = require("../datasources");
-/**
- * @model decorator - Registers a model class with its static schema and relations.
- *
- * Usage with static schema (Option A - Power Users):
- * ```typescript
- * @model({ type: 'entity' })
- * export class User extends BaseEntity {
- *   static schema = pgTable('User', { ... });
- *   static relations = () => ({ ... });
- * }
- * ```
- */
+/** Registers a model class with its static schema and relations. */
 const model = (metadata) => {
     return target => {
-        // Use registerModel which extracts static schema/relations and stores in registry
-        // target is Function from ClassDecorator, which matches the union type in registerModel
+        // Auto-populate AUTHORIZATION_SUBJECT from authorize.principal if not already set
+        const principal = metadata.settings?.authorize?.principal;
+        if (principal && !Object.hasOwn(target, 'AUTHORIZATION_SUBJECT')) {
+            target.AUTHORIZATION_SUBJECT = principal;
+        }
         inversion_1.MetadataRegistry.getInstance().registerModel({ target, metadata });
     };
 };
 exports.model = model;
-/**
- * @datasource decorator - Registers a datasource with driver and auto-discovery.
- *
- * The driver is automatically read by BaseDataSource from this decorator,
- * so you don't need to pass it in the constructor.
- *
- * Usage:
- * ```typescript
- * @datasource({ driver: 'node-postgres' })
- * export class PostgresDataSource extends BaseDataSource<TNodePostgresConnector, IDbConfig> {
- *   constructor() {
- *     super({
- *       name: PostgresDataSource.name,
- *       config: { host: '...', port: 5432, ... },
- *       // driver read from decorator - no need to pass here!
- *       // schema auto-discovered from repositories
- *     });
- *   }
- * }
- * ```
- */
+/** Registers a datasource with driver and auto-discovery settings. */
 const datasource = (metadata) => {
     return target => {
         inversion_1.MetadataRegistry.getInstance().setDataSourceMetadata({ target, metadata });
     };
 };
 exports.datasource = datasource;
-/**
- * Validate repository metadata - both model and dataSource must be provided together.
- */
+/** Validates that both model and dataSource are provided together. */
 const validateRepositoryMetadata = (opts) => {
     const { metadata, target } = opts;
     if (!metadata.model) {
@@ -68,18 +38,12 @@ const validateRepositoryMetadata = (opts) => {
         });
     }
 };
-/**
- * Register dataSource injection metadata if not already explicitly defined.
- * Validates that first constructor param is a DataSource.
- */
+/** Auto-injects dataSource at constructor param[0] unless explicit @inject exists. */
 const registerDataSourceInjection = (opts) => {
     const { target, registry, resolvedDataSource } = opts;
-    // 1. Get constructor parameter types using reflection metadata
     const paramTypes = Reflect.getMetadata('design:paramtypes', target);
     const firstParamType = paramTypes?.[0];
-    // 2. Validate first parameter type must satisfy IDataSource (extend AbstractDataSource)
     if (firstParamType) {
-        // Check if firstParamType extends AbstractDataSource
         const isDataSourceType = firstParamType === datasources_1.AbstractDataSource ||
             firstParamType.prototype instanceof datasources_1.AbstractDataSource;
         if (!isDataSourceType) {
@@ -87,7 +51,6 @@ const registerDataSourceInjection = (opts) => {
                 message: `[@repository][${target.name}] Invalid constructor | First parameter must extend AbstractDataSource | Received: '${firstParamType.name}'`,
             });
         }
-        // Additionally validate that resolvedDataSource is compatible with firstParamType
         if (typeof resolvedDataSource === 'function') {
             const isCompatible = firstParamType === resolvedDataSource ||
                 resolvedDataSource.prototype instanceof firstParamType;
@@ -98,11 +61,9 @@ const registerDataSourceInjection = (opts) => {
             }
         }
     }
-    // Check if user already has explicit @inject for param 0
     const existingInjects = registry.getInjectMetadata({ target });
     const injectAtIndex0 = existingInjects?.find(m => m.index === 0);
     if (injectAtIndex0) {
-        // Validate that the explicit @inject at param 0 is a DataSource
         const injectKey = injectAtIndex0.key;
         const isDataSourceKey = typeof injectKey === 'string' && injectKey.startsWith(`${bindings_1.BindingNamespaces.DATASOURCE}.`);
         if (!isDataSourceKey) {
@@ -110,10 +71,8 @@ const registerDataSourceInjection = (opts) => {
                 message: `[@repository][${target.name}] Invalid constructor | First parameter must be a DataSource | Found @inject with key: '${injectKey.toString()}' | Expected key starting with '${bindings_1.BindingNamespaces.DATASOURCE}.'`,
             });
         }
-        // User has valid explicit @inject for DataSource, skip auto-injection
         return;
     }
-    // Build binding key and register injection metadata
     const dsName = typeof resolvedDataSource === 'string' ? resolvedDataSource : resolvedDataSource.name;
     const dsBindingKey = inversion_1.BindingKeys.build({ namespace: bindings_1.BindingNamespaces.DATASOURCE, key: dsName });
     registry.setInjectMetadata({
@@ -122,26 +81,20 @@ const registerDataSourceInjection = (opts) => {
         metadata: { key: dsBindingKey, index: 0, isOptional: false },
     });
 };
-/**
- * Resolve repository metadata and register bindings if model and dataSource are provided.
- */
+/** Resolves repository metadata and registers bindings for schema auto-discovery. */
 const resolveRepositoryMetadata = (opts) => {
     const { metadata, target, registry } = opts;
-    // Validate metadata - throws if invalid
     validateRepositoryMetadata({ metadata, target });
-    // Early return if neither model nor dataSource provided (valid case)
     if (!metadata.model || !metadata.dataSource) {
         return undefined;
     }
     const resolvedModel = (0, ignis_helpers_1.resolveValue)(metadata.model);
     const resolvedDataSource = (0, ignis_helpers_1.resolveClass)(metadata.dataSource);
-    // Register the binding for auto-discovery
     registry.registerRepositoryBinding({
         repository: target,
         model: resolvedModel,
         dataSource: resolvedDataSource,
     });
-    // Auto-inject dataSource at constructor parameter index 0
     registerDataSourceInjection({ target, registry, resolvedDataSource });
     return {
         model: resolvedModel,
@@ -149,41 +102,11 @@ const resolveRepositoryMetadata = (opts) => {
         operationScope: metadata.operationScope,
     };
 };
-/**
- * @repository decorator - Binds a repository to a model and datasource.
- *
- * IMPORTANT: Both `model` AND `dataSource` are required for schema auto-discovery.
- * Without both, the model won't be registered and relational queries will fail.
- *
- * Supports these injection patterns:
- *
- * 1. Zero boilerplate - dataSource auto-injected from metadata:
- * ```typescript
- * @repository({ model: User, dataSource: PostgresDataSource })
- * export class UserRepository extends PersistableRepository<typeof User.schema> {
- *   // No constructor needed - datasource auto-injected at param index 0
- * }
- * ```
- *
- * 2. Explicit @inject with @repository - when you need constructor control:
- * ```typescript
- * @repository({ model: User, dataSource: PostgresDataSource })
- * export class UserRepository extends PersistableRepository<typeof User.schema> {
- *   constructor(
- *     @inject({ key: 'datasources.PostgresDataSource' })
- *     ds: PostgresDataSource,
- *   ) {
- *     super(ds, { entityClass: User });
- *   }
- * }
- * ```
- * Note: When @inject is at param index 0, auto-injection is skipped (your @inject takes precedence).
- */
+/** Binds a repository to a model and datasource for schema auto-discovery. */
 const repository = (metadata) => {
     return target => {
         const registry = inversion_1.MetadataRegistry.getInstance();
         const resolved = resolveRepositoryMetadata({ metadata, target, registry });
-        // Store metadata with resolved references
         registry.setRepositoryMetadata({
             target,
             metadata: { ...metadata, _resolved: resolved },

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

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

package/dist/base/metadata/routes.d.ts

@@ -1,30 +1,7 @@
 import { IControllerMetadata } from '../../helpers/inversion';
 import { IAuthRouteConfig as IAuthRouteConfig } from '../controllers';
 export declare const controller: (metadata: IControllerMetadata) => ClassDecorator;
-/**
- * Decorator for defining API routes.
- *
- * Registers the route configuration with the metadata registry.
- * Use `valid<T>('target')` for explicit typing of validated request data.
- *
- * @example
- * ```typescript
- * const config = {
- *   path: '/ping',
- *   method: 'post',
- *   request: { body: jsonContent({ schema: z.object({ message: z.string() }) }) },
- *   responses: { 200: jsonContent({ schema: z.object({ reply: z.string() }) }) }
- * } as const;
- *
- * class MyController extends BaseController {
- *   @api({ configs: config })
- *   pingPong(context: TTypedContext) {
- *     const { message } = context.req.valid<{ message: string }>('json');
- *     return context.json({ reply: message }, 200);
- *   }
- * }
- * ```
- */
+/** Generic route decorator. Registers route config in metadata registry. */
 export declare const api: <RouteConfig extends IAuthRouteConfig>(opts: {
     configs: RouteConfig;
 }) => (target: any, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;

package/dist/base/metadata/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGtE,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,gBAAgB,EAAE,MAAM;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,MAEpF,QAAQ,GAAG,EACX,aAAa,MAAM,GAAG,MAAM,EAC5B,aAAa,kBAAkB,KAC9B,IAOJ,CAAC;AAGF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cAhBW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAmBJ,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,IAAI,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC/E,OAAO,EAAE,WAAW,CAAC;CACtB,cA3BW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA8BJ,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cAtCW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAyCJ,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,KAAK,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAChF,OAAO,EAAE,WAAW,CAAC;CACtB,cAjDW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAoDJ,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cA5DW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA+DJ,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/base/metadata/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,eAAO,MAAM,UAAU,GAAI,UAAU,mBAAmB,KAAG,cAI1D,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,gBAAgB,EAAE,MAAM;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,MAEpF,QAAQ,GAAG,EACX,aAAa,MAAM,GAAG,MAAM,EAC5B,aAAa,kBAAkB,KAC9B,IAOJ,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cAfW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAkBJ,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,IAAI,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC/E,OAAO,EAAE,WAAW,CAAC;CACtB,cA1BW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA6BJ,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cArCW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAwCJ,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,KAAK,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAChF,OAAO,EAAE,WAAW,CAAC;CACtB,cAhDW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IAmDJ,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,GAAG,GAAI,WAAW,SAAS,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM;IAC9E,OAAO,EAAE,WAAW,CAAC;CACtB,cA3DW,GAAG,eACE,MAAM,GAAG,MAAM,eACf,kBAAkB,KAC9B,IA8DJ,CAAC"}

package/dist/base/metadata/routes.js

@@ -3,38 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.del = exports.patch = exports.put = exports.post = exports.get = exports.api = exports.controller = void 0;
 const inversion_1 = require("../../helpers/inversion");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-// --------------------------------------------------------------------------------------------
 const controller = (metadata) => {
     return target => {
         inversion_1.MetadataRegistry.getInstance().setControllerMetadata({ target, metadata });
     };
 };
 exports.controller = controller;
-// --------------------------------------------------------------------------------------------
-/**
- * Decorator for defining API routes.
- *
- * Registers the route configuration with the metadata registry.
- * Use `valid<T>('target')` for explicit typing of validated request data.
- *
- * @example
- * ```typescript
- * const config = {
- *   path: '/ping',
- *   method: 'post',
- *   request: { body: jsonContent({ schema: z.object({ message: z.string() }) }) },
- *   responses: { 200: jsonContent({ schema: z.object({ reply: z.string() }) }) }
- * } as const;
- *
- * class MyController extends BaseController {
- *   @api({ configs: config })
- *   pingPong(context: TTypedContext) {
- *     const { message } = context.req.valid<{ message: string }>('json');
- *     return context.json({ reply: message }, 200);
- *   }
- * }
- * ```
- */
+/** Generic route decorator. Registers route config in metadata registry. */
 const api = (opts) => {
     return function (target, propertyKey, _descriptor) {
         inversion_1.MetadataRegistry.getInstance().addRoute({
@@ -45,7 +20,6 @@ const api = (opts) => {
     };
 };
 exports.api = api;
-// --------------------------------------------------------------------------------------------
 /** GET route decorator. Equivalent to @api but automatically sets method to 'get'. */
 const get = (opts) => {
     return (0, exports.api)({