@venizia/ignis-kernel 0.4.2 → 0.4.4

package/dist/esm/helpers/inversion/common/types/model.d.ts

@@ -1,4 +1,4 @@
-import type { AbstractEntity } from '../../../../base/models/index.js';
+import type { AbstractEntity, TModelType } from '../../../../base/models/index.js';
 import type { ScopeFilters, TFilter, TScopeFilterMissingBehavior, TScopeWriteGuard, TWhere } from '../../../../base/repositories/index.js';
 import type { TClass, TNullable, TValueOrResolver } from '@venizia/ignis-helpers/common';
 import type { IArtifactRegistrationOptions } from './artifact.js';
@@ -62,19 +62,6 @@ export interface IModelAccessSettings {
     /** What a restricted caller may write to the scope columns. See {@link IModelAccessWriteSettings}. */
     write?: IModelAccessWriteSettings;
 }
-/**
- * The old, flat shape of {@link IModelAccessSettings}.
- *
- * @deprecated Use `settings.access` (`writeGuard` is `access.write.mode`, `sharedRows` is
- * `access.write.sharedRows`). Removed in 0.4.3.
- */
-export interface IScopeFilterSettings {
-    resolve: () => TNullable<TWhere> | typeof ScopeFilters.UNRESTRICTED;
-    onMissing?: TScopeFilterMissingBehavior;
-    writeGuard?: TScopeWriteGuard;
-    sharedRows?: boolean;
-    columns?: string[];
-}
 /** What a query runs with when it names nothing (`@model` settings.query). */
 export interface IModelQuerySettings {
     /** Default filter auto-applied to all repository operations. Bypassable via shouldSkipDefaultFilter. */
@@ -110,30 +97,19 @@ export interface IModelSettings {
     access?: IModelAccessSettings;
     /** Authorization settings for this model (principal name, etc.). */
     authorize?: IModelAuthorizeSettings;
-    /** @deprecated Use `query.filter`. Removed in 0.4.3. */
-    defaultFilter?: TFilter;
-    /** @deprecated Use `access`. Removed in 0.4.3. */
-    scopeFilter?: IScopeFilterSettings;
-    /** @deprecated Use `query.limit.default`. Removed in 0.4.3. */
-    defaultLimit?: number;
-    /** @deprecated Use `query.limit.max`. Removed in 0.4.3. */
-    maxLimit?: number;
 }
-/** One deprecated settings key a model still uses, and the key that replaces it. */
-export interface IDeprecatedModelSetting {
-    /** The old key, written as the model wrote it: `defaultFilter`, `scopeFilter.writeGuard`. */
-    key: string;
-    /** The key that replaces it: `query.filter`, `access.write.mode`. */
-    use: string;
+/** Whether tooling that reads the model registry should migrate this model (`@model({ migration })`). */
+export interface IModelMigrationSettings {
+    /** Default `true`. `false` marks the model as one a migration tool leaves alone. IGNIS generates no migrations itself. */
+    use?: boolean;
 }
 export interface IModelMetadata extends IArtifactRegistrationOptions {
-    type: 'entity' | 'view';
+    /** Optional: `ModelTypes.ENTITY` is the only value and the default. */
+    type?: TModelType;
     tableName?: string;
-    skipMigrate?: boolean;
-    /** As the `@model` decorator stores it: normalised to the new keys; the deprecated keys are gone. */
+    /** Migration marker for consumer tooling that reads the public registry. */
+    migration?: IModelMigrationSettings;
     settings?: IModelSettings;
-    /** Set by the decorator, read by the boot warning; not for application code. */
-    deprecatedSettings?: IDeprecatedModelSetting[];
 }
 export interface IEntityStatics {
     schema?: unknown;

package/dist/esm/helpers/inversion/common/types/model.d.ts.map

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

package/dist/esm/helpers/inversion/common/types/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport type {\n  ScopeFilters,\n  TFilter,\n  TScopeFilterMissingBehavior,\n  TScopeWriteGuard,\n  TWhere,\n} from '@/base/repositories';\nimport type { TClass, TNullable, TValueOrResolver } from '@venizia/ignis-helpers/common';\nimport type { IArtifactRegistrationOptions } from './artifact';\n\nexport interface IModelAuthorizeSettings {\n  /** The authorization principal name (resource/subject) for this model. */\n  principal: string;\n  /** Extensible - consumers can add any extra authorization metadata. */\n  [extra: string | symbol]: any;\n}\n\n/** What a restricted caller may write to the scope columns (`@model` settings.access.write). */\nexport interface IModelAccessWriteSettings {\n  /**\n   * What a create, createAll or an update payload that names a scope column does when its value\n   * disagrees with the resolved scope. `reject` (default) refuses the write and writes nothing - for\n   * `createAll` not even the valid rows. `assign` also fills a scope column that is ABSENT from a\n   * created row, when the scope is a single equality; a value that is present and disagrees is\n   * still refused.\n   *\n   * The scope's columns and allowed values are read from the resolved `where` (equality, `eq`, `inq`\n   * and arrays, `and`, and an `or` over one column). Any other shape cannot be checked, and the write\n   * is refused with its own message - never skipped. `ScopeFilters.UNRESTRICTED` bypasses the guard\n   * too, which is the deliberate way to write across scopes (system scope, an admin role).\n   *\n   * Not checked: an update that does not name the scope column (the row was already selected through\n   * the scoped `where`), and raw statements that bypass the repository.\n   */\n  mode?: TScopeWriteGuard;\n\n  /**\n   * `true` lets a restricted caller write `null` to a scope column, or leave it out on create: the\n   * row has no owner and is shared. Default `false`, so `null` is refused like any other value\n   * outside the scope, even when the resolved scope has a `null` branch (that branch lets the caller\n   * READ shared rows, a separate permission). Reads are scoped as before.\n   */\n  sharedRows?: boolean;\n}\n\n/**\n * Row access for `@model` settings.access - resolved per query, so it can depend on the current\n * request (tenant, org, membership). Framework-internal escape hatches aside, nothing short of\n * removing this setting from the model turns scoping off.\n */\nexport interface IModelAccessSettings {\n  /**\n   * Returns the scope `where`; `ScopeFilters.UNRESTRICTED` to apply no scope for THIS call (an\n   * internal operator, a caller the application has decided sees everything); or null/undefined\n   * when this caller's scope cannot be determined at all.\n   */\n  resolve: () => TNullable<TWhere> | typeof ScopeFilters.UNRESTRICTED;\n\n  /**\n   * What `applyScopeFilter` does when `resolve()` returns null/undefined - no request context, no\n   * tenant, a background job. Defaults to `deny`: an unresolved scope matches zero rows, never\n   * every row. `allow` is an explicit, reviewed opt-out for migrations and background jobs, declared\n   * per MODEL - it cannot express a per-USER bypass; use `ScopeFilters.UNRESTRICTED` for that.\n   */\n  onMissing?: TScopeFilterMissingBehavior;\n\n  /**\n   * The property names the write guard checks. Optional: with none declared the guard checks every\n   * column the resolved scope constrains. When declared, each name must exist on the model (checked\n   * at boot), and a resolved scope that constrains any other column is refused as unverifiable.\n   */\n  columns?: string[];\n\n  /** What a restricted caller may write to the scope columns. See {@link IModelAccessWriteSettings}. */\n  write?: IModelAccessWriteSettings;\n}\n\n/**\n * The old, flat shape of {@link IModelAccessSettings}.\n *\n * @deprecated Use `settings.access` (`writeGuard` is `access.write.mode`, `sharedRows` is\n * `access.write.sharedRows`). Removed in 0.4.3.\n */\nexport interface IScopeFilterSettings {\n  resolve: () => TNullable<TWhere> | typeof ScopeFilters.UNRESTRICTED;\n  onMissing?: TScopeFilterMissingBehavior;\n  writeGuard?: TScopeWriteGuard;\n  sharedRows?: boolean;\n  columns?: string[];\n}\n\n/** What a query runs with when it names nothing (`@model` settings.query). */\nexport interface IModelQuerySettings {\n  /** Default filter auto-applied to all repository operations. Bypassable via shouldSkipDefaultFilter. */\n  filter?: TFilter;\n\n  limit?: {\n    /** Default row limit when a query omits `limit`. Must be a positive integer. Falls back to DEFAULT_LIMIT (10). */\n    default?: number;\n\n    /**\n     * Largest `limit` a CALLER may ask for. Must be a positive integer. Falls back to\n     * DEFAULT_MAX_LIMIT (1000).\n     *\n     * Policy, not capacity - the engine's own ceiling sits far above it. The number is chosen so\n     * that reaching it means the caller is doing something unusual, and raising it is how a model\n     * says so deliberately.\n     */\n    max?: number;\n  };\n}\n\nexport interface IModelSettings {\n  /** Properties excluded from all query results at SQL level. */\n  hiddenProperties?: string[];\n\n  /** Default filter and limits of a query: `filter`, `limit.default`, `limit.max`. */\n  query?: IModelQuerySettings;\n\n  /**\n   * Row access: the scope ANDed into every read and write whose scope is expressible as a filter\n   * clause, NOT removable by `shouldSkipDefaultFilter`, and the guard that holds writes to it.\n   * Ownership resolved per row or through a polymorphic reference is NOT expressible here - that\n   * check is still the application's to perform.\n   *\n   * Relational repositories only - a search-backed model (Typesense, Meilisearch) never reads\n   * this setting, so mirroring a scoped entity into a search index needs its own query-time scope.\n   */\n  access?: IModelAccessSettings;\n\n  /** Authorization settings for this model (principal name, etc.). */\n  authorize?: IModelAuthorizeSettings;\n\n  /** @deprecated Use `query.filter`. Removed in 0.4.3. */\n  defaultFilter?: TFilter;\n\n  /** @deprecated Use `access`. Removed in 0.4.3. */\n  scopeFilter?: IScopeFilterSettings;\n\n  /** @deprecated Use `query.limit.default`. Removed in 0.4.3. */\n  defaultLimit?: number;\n\n  /** @deprecated Use `query.limit.max`. Removed in 0.4.3. */\n  maxLimit?: number;\n}\n\n/** One deprecated settings key a model still uses, and the key that replaces it. */\nexport interface IDeprecatedModelSetting {\n  /** The old key, written as the model wrote it: `defaultFilter`, `scopeFilter.writeGuard`. */\n  key: string;\n  /** The key that replaces it: `query.filter`, `access.write.mode`. */\n  use: string;\n}\n\nexport interface IModelMetadata extends IArtifactRegistrationOptions {\n  type: 'entity' | 'view';\n  tableName?: string;\n  skipMigrate?: boolean;\n\n  /** As the `@model` decorator stores it: normalised to the new keys; the deprecated keys are gone. */\n  settings?: IModelSettings;\n\n  /** Set by the decorator, read by the boot warning; not for application code. */\n  deprecatedSettings?: IDeprecatedModelSetting[];\n}\n\nexport interface IEntityStatics {\n  schema?: unknown;\n  relations?: TValueOrResolver<Array<unknown>>;\n}\n\nexport type TModelClass<Model extends AbstractEntity = AbstractEntity> = TClass<Model> &\n  IEntityStatics;\n\n/** Decorator target for model classes (supports both strongly typed and ClassDecorator patterns). */\nexport type TDecoratorModelTarget<Model extends AbstractEntity = AbstractEntity> =\n  | TModelClass<Model>\n  | (Function & IEntityStatics);\n\nexport interface IModelRegistryEntry<Model extends AbstractEntity = AbstractEntity> {\n  target: TValueOrResolver<TClass<Model>>;\n  metadata: IModelMetadata;\n  schema: unknown;\n\n  /** Lazy resolver to avoid circular deps. Resolved when DataSource builds schema. */\n  relationsResolver?: TValueOrResolver<Array<unknown>>;\n\n  /** Cache populated on first buildSchema() call. */\n  _builtRelations?: unknown;\n}\n"]}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/common/types/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { AbstractEntity, TModelType } from '@/base/models';\nimport type {\n  ScopeFilters,\n  TFilter,\n  TScopeFilterMissingBehavior,\n  TScopeWriteGuard,\n  TWhere,\n} from '@/base/repositories';\nimport type { TClass, TNullable, TValueOrResolver } from '@venizia/ignis-helpers/common';\nimport type { IArtifactRegistrationOptions } from './artifact';\n\nexport interface IModelAuthorizeSettings {\n  /** The authorization principal name (resource/subject) for this model. */\n  principal: string;\n  /** Extensible - consumers can add any extra authorization metadata. */\n  [extra: string | symbol]: any;\n}\n\n/** What a restricted caller may write to the scope columns (`@model` settings.access.write). */\nexport interface IModelAccessWriteSettings {\n  /**\n   * What a create, createAll or an update payload that names a scope column does when its value\n   * disagrees with the resolved scope. `reject` (default) refuses the write and writes nothing - for\n   * `createAll` not even the valid rows. `assign` also fills a scope column that is ABSENT from a\n   * created row, when the scope is a single equality; a value that is present and disagrees is\n   * still refused.\n   *\n   * The scope's columns and allowed values are read from the resolved `where` (equality, `eq`, `inq`\n   * and arrays, `and`, and an `or` over one column). Any other shape cannot be checked, and the write\n   * is refused with its own message - never skipped. `ScopeFilters.UNRESTRICTED` bypasses the guard\n   * too, which is the deliberate way to write across scopes (system scope, an admin role).\n   *\n   * Not checked: an update that does not name the scope column (the row was already selected through\n   * the scoped `where`), and raw statements that bypass the repository.\n   */\n  mode?: TScopeWriteGuard;\n\n  /**\n   * `true` lets a restricted caller write `null` to a scope column, or leave it out on create: the\n   * row has no owner and is shared. Default `false`, so `null` is refused like any other value\n   * outside the scope, even when the resolved scope has a `null` branch (that branch lets the caller\n   * READ shared rows, a separate permission). Reads are scoped as before.\n   */\n  sharedRows?: boolean;\n}\n\n/**\n * Row access for `@model` settings.access - resolved per query, so it can depend on the current\n * request (tenant, org, membership). Framework-internal escape hatches aside, nothing short of\n * removing this setting from the model turns scoping off.\n */\nexport interface IModelAccessSettings {\n  /**\n   * Returns the scope `where`; `ScopeFilters.UNRESTRICTED` to apply no scope for THIS call (an\n   * internal operator, a caller the application has decided sees everything); or null/undefined\n   * when this caller's scope cannot be determined at all.\n   */\n  resolve: () => TNullable<TWhere> | typeof ScopeFilters.UNRESTRICTED;\n\n  /**\n   * What `applyScopeFilter` does when `resolve()` returns null/undefined - no request context, no\n   * tenant, a background job. Defaults to `deny`: an unresolved scope matches zero rows, never\n   * every row. `allow` is an explicit, reviewed opt-out for migrations and background jobs, declared\n   * per MODEL - it cannot express a per-USER bypass; use `ScopeFilters.UNRESTRICTED` for that.\n   */\n  onMissing?: TScopeFilterMissingBehavior;\n\n  /**\n   * The property names the write guard checks. Optional: with none declared the guard checks every\n   * column the resolved scope constrains. When declared, each name must exist on the model (checked\n   * at boot), and a resolved scope that constrains any other column is refused as unverifiable.\n   */\n  columns?: string[];\n\n  /** What a restricted caller may write to the scope columns. See {@link IModelAccessWriteSettings}. */\n  write?: IModelAccessWriteSettings;\n}\n\n/** What a query runs with when it names nothing (`@model` settings.query). */\nexport interface IModelQuerySettings {\n  /** Default filter auto-applied to all repository operations. Bypassable via shouldSkipDefaultFilter. */\n  filter?: TFilter;\n\n  limit?: {\n    /** Default row limit when a query omits `limit`. Must be a positive integer. Falls back to DEFAULT_LIMIT (10). */\n    default?: number;\n\n    /**\n     * Largest `limit` a CALLER may ask for. Must be a positive integer. Falls back to\n     * DEFAULT_MAX_LIMIT (1000).\n     *\n     * Policy, not capacity - the engine's own ceiling sits far above it. The number is chosen so\n     * that reaching it means the caller is doing something unusual, and raising it is how a model\n     * says so deliberately.\n     */\n    max?: number;\n  };\n}\n\nexport interface IModelSettings {\n  /** Properties excluded from all query results at SQL level. */\n  hiddenProperties?: string[];\n\n  /** Default filter and limits of a query: `filter`, `limit.default`, `limit.max`. */\n  query?: IModelQuerySettings;\n\n  /**\n   * Row access: the scope ANDed into every read and write whose scope is expressible as a filter\n   * clause, NOT removable by `shouldSkipDefaultFilter`, and the guard that holds writes to it.\n   * Ownership resolved per row or through a polymorphic reference is NOT expressible here - that\n   * check is still the application's to perform.\n   *\n   * Relational repositories only - a search-backed model (Typesense, Meilisearch) never reads\n   * this setting, so mirroring a scoped entity into a search index needs its own query-time scope.\n   */\n  access?: IModelAccessSettings;\n\n  /** Authorization settings for this model (principal name, etc.). */\n  authorize?: IModelAuthorizeSettings;\n}\n\n/** Whether tooling that reads the model registry should migrate this model (`@model({ migration })`). */\nexport interface IModelMigrationSettings {\n  /** Default `true`. `false` marks the model as one a migration tool leaves alone. IGNIS generates no migrations itself. */\n  use?: boolean;\n}\n\nexport interface IModelMetadata extends IArtifactRegistrationOptions {\n  /** Optional: `ModelTypes.ENTITY` is the only value and the default. */\n  type?: TModelType;\n  tableName?: string;\n\n  /** Migration marker for consumer tooling that reads the public registry. */\n  migration?: IModelMigrationSettings;\n\n  settings?: IModelSettings;\n}\n\nexport interface IEntityStatics {\n  schema?: unknown;\n  relations?: TValueOrResolver<Array<unknown>>;\n}\n\nexport type TModelClass<Model extends AbstractEntity = AbstractEntity> = TClass<Model> &\n  IEntityStatics;\n\n/** Decorator target for model classes (supports both strongly typed and ClassDecorator patterns). */\nexport type TDecoratorModelTarget<Model extends AbstractEntity = AbstractEntity> =\n  | TModelClass<Model>\n  | (Function & IEntityStatics);\n\nexport interface IModelRegistryEntry<Model extends AbstractEntity = AbstractEntity> {\n  target: TValueOrResolver<TClass<Model>>;\n  metadata: IModelMetadata;\n  schema: unknown;\n\n  /** Lazy resolver to avoid circular deps. Resolved when DataSource builds schema. */\n  relationsResolver?: TValueOrResolver<Array<unknown>>;\n\n  /** Cache populated on first buildSchema() call. */\n  _builtRelations?: unknown;\n}\n"]}

package/dist/esm/helpers/inversion/mixins/artifact.mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/artifact.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,eAAO,MAAM,qBAAqB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACrF,WAAW,SAAS;;QAGlB,mNAAmN;6BAC9L,MAAM,EAAE;8BAEP,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI;kCAQ3D,aAAa,CAAC,MAAM,CAAC;QAI/C,4GAA4G;oCAChF,IAAI;4BAIZ,MAAM,SAAS,MAAM,WAAW,eAAe,kBAAkB;YACnF,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;SAC9C,GAAG,IAAI;4BAKY,MAAM,SAAS,MAAM,iBAAiB;YACxD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,iBAAiB,GAAG,SAAS;2BAId,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,gBAAgB,CAAC;SAC5B,GAAG,IAAI;2BAKW,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAFuB,CAAC;;;;;;;;aAMjD,CAAC"}
+{"version":3,"file":"artifact.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/artifact.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,eAAO,MAAM,qBAAqB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACrF,WAAW,SAAS;;QAGlB,mNAAmN;6BAC9L,MAAM,EAAE;8BAEP,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI;kCAQ3D,aAAa,CAAC,MAAM,CAAC;QAI/C,4GAA4G;oCAChF,IAAI;4BAIZ,MAAM,SAAS,MAAM,WAAW,eAAe,kBAAkB;YACnF,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;SAC9C,GAAG,IAAI;4BAKY,MAAM,SAAS,MAAM,iBAAiB;YACxD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,iBAAiB,GAAG,SAAS;2BAId,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,gBAAgB,CAAC;SAC5B,GAAG,IAAI;2BAKW,MAAM,SAAS,MAAM,iBAAiB;YACvD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAFgC,CAAC;;;;;;;;aAM1D,CAAC"}

package/dist/esm/helpers/inversion/mixins/controllers/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,mBAAmB,CAAC;SAC/B,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;kCAKT,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;kCAQb,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBASoM,CAAC;;;;;;;;aAD/O,CAAC"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,mBAAmB,CAAC;SAC/B,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;kCAKT,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;kCAQb,MAAM,SAAS,MAAM,iBAAiB;YAC9D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,uBAAuB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAS6M,CAAC;;;;;;;;aADxP,CAAC"}

package/dist/esm/helpers/inversion/mixins/controllers/grpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/grpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAC3F,WAAW,SAAS;;eAGX,MAAM,SAAS,MAAM,iBAAiB;YAC3C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;YAC5B,OAAO,EAAE,YAAY,CAAC;SACvB,GAAG,IAAI;gBAaA,MAAM,SAAS,MAAM,iBAAiB;YAC5C,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS;eAK3C,MAAM,SAAS,MAAM,iBAAiB;YAC3C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;SAC7B,GAAG,YAAY,GAAG,SAAS;gBAMpB,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAMwM,CAAC;;;;;;;;aADtR,CAAC"}
+{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/grpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAC3F,WAAW,SAAS;;eAGX,MAAM,SAAS,MAAM,iBAAiB;YAC3C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;YAC5B,OAAO,EAAE,YAAY,CAAC;SACvB,GAAG,IAAI;gBAaA,MAAM,SAAS,MAAM,iBAAiB;YAC5C,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS;eAK3C,MAAM,SAAS,MAAM,iBAAiB;YAC3C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;SAC7B,GAAG,YAAY,GAAG,SAAS;gBAMpB,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAMiN,CAAC;;;;;;;;aAD/R,CAAC"}

package/dist/esm/helpers/inversion/mixins/controllers/rest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAC3F,WAAW,SAAS;;kBAGR,MAAM,SAAS,MAAM,iBAAiB;YAC9C,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS;iBAK7C,MAAM,SAAS,MAAM,iBAAiB;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;SAC7B,GAAG,gBAAgB,GAAG,SAAS;kBAMtB,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO;iBAKnE,MAAM,SAAS,MAAM,iBAAiB;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;YAC5B,OAAO,EAAE,gBAAgB,CAAC;SAC3B,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAeiK,CAAC;;;;;;;;aAD7K,CAAC"}
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../../../../../src/helpers/inversion/mixins/controllers/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,eAAO,MAAM,2BAA2B,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAC3F,WAAW,SAAS;;kBAGR,MAAM,SAAS,MAAM,iBAAiB;YAC9C,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS;iBAK7C,MAAM,SAAS,MAAM,iBAAiB;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;SAC7B,GAAG,gBAAgB,GAAG,SAAS;kBAMtB,MAAM,SAAS,MAAM,iBAAiB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO;iBAKnE,MAAM,SAAS,MAAM,iBAAiB;YAC7C,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;YAC5B,OAAO,EAAE,gBAAgB,CAAC;SAC3B,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAe0K,CAAC;;;;;;;;aADtL,CAAC"}

package/dist/esm/helpers/inversion/mixins/datasource.mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datasource.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/datasource.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,mBAAmB,CAAC;SAChC,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAM6kC,CAAC;;;;;;;;aADpnC,CAAC"}
+{"version":3,"file":"datasource.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/datasource.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAO,MAAM,uBAAuB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EACvF,WAAW,SAAS;;8BAGI,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,mBAAmB,CAAC;SAChC,GAAG,IAAI;8BAUc,MAAM,SAAS,MAAM,iBAAiB;YAC1D,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,mBAAmB,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAMslC,CAAC;;;;;;;;aAD7nC,CAAC"}

package/dist/esm/helpers/inversion/mixins/model.mixin.d.ts

@@ -1,6 +1,7 @@
 import type { AbstractEntity } from '../../../base/models/index.js';
 import type { TMixinTarget } from '@venizia/ignis-helpers/common';
 import type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';
+import { AuthorizeModelFormats } from '../common/constants.js';
 import type { IModelAuthorizeSettings, IModelMetadata, IModelRegistryEntry, TDecoratorModelTarget } from '../common/types/index.js';
 export declare const ModelMetadataMixin: <BaseClass extends TMixinTarget<_MetadataRegistry>>(baseClass: BaseClass) => {
     new (...args: any[]): {
@@ -30,20 +31,20 @@ export declare const ModelMetadataMixin: <BaseClass extends TMixinTarget<_Metada
         }): IModelAuthorizeSettings | undefined;
         /** Authorization principals across all models that declare an authorize setting. */
         getAuthorizeModelPrincipals(opts: {
-            format: "array";
+            format: typeof AuthorizeModelFormats.ARRAY;
         }): string[];
         getAuthorizeModelPrincipals(opts: {
-            format: "record";
+            format: typeof AuthorizeModelFormats.RECORD;
         }): Record<string, string>;
         getAuthorizeModelSettings(opts: {
-            format: "array";
+            format: typeof AuthorizeModelFormats.ARRAY;
         }): Array<{
             name: string;
             authorize: IModelAuthorizeSettings;
             entry: IModelRegistryEntry;
         }>;
         getAuthorizeModelSettings(opts: {
-            format: "record";
+            format: typeof AuthorizeModelFormats.RECORD;
         }): Record<string, {
             authorize: IModelAuthorizeSettings;
             entry: IModelRegistryEntry;

package/dist/esm/helpers/inversion/mixins/model.mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AA0CzB,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAClF,WAAW,SAAS;;uBAGH,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;wBAC/B,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC;yBAEnC,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,cAAc,CAAC;SAC1B,GAAG,IAAI;yBAKS,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,cAAc,GAAG,SAAS;QAK9B,kLAAkL;sBACpK,KAAK,SAAS,cAAc;;sBAE9B,cAAc;;4BAqCN;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,mBAAmB,GAAG,SAAS;oCAI1C;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,mBAAmB,GAAG,SAAS;wBAIhE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;wCAIhB;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,uBAAuB,GAAG,SAAS;QAKtF,oFAAoF;0CAClD;YAAE,MAAM,EAAE,OAAO,CAAA;SAAE,GAAG,MAAM,EAAE;0CAC9B;YAAE,MAAM,EAAE,QAAQ,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;wCA4B/C;YAAE,MAAM,EAAE,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC;YAC1D,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,uBAAuB,CAAC;YACnC,KAAK,EAAE,mBAAmB,CAAC;SAC5B,CAAC;wCAC8B;YAC9B,MAAM,EAAE,QAAQ,CAAC;SAClB,GAAG,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,uBAAuB,CAAC;YAAC,KAAK,EAAE,mBAAmB,CAAA;SAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBArG9D,CAAC;;;;;;;;aAgI5B,CAAC"}
+{"version":3,"file":"model.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAA8B,MAAM,qBAAqB,CAAC;AAExF,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,iBAAiB,CAAC;AA0CzB,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,YAAY,CAAC,iBAAiB,CAAC,EAClF,WAAW,SAAS;;uBAGH,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;wBAC/B,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC;yBAEnC,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,cAAc,CAAC;SAC1B,GAAG,IAAI;yBAKS,MAAM,SAAS,MAAM,iBAAiB;YACrD,MAAM,EAAE,MAAM,CAAC;SAChB,GAAG,cAAc,GAAG,SAAS;QAK9B,kLAAkL;sBACpK,KAAK,SAAS,cAAc;;sBAE9B,cAAc;;4BAqCN;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,mBAAmB,GAAG,SAAS;oCAI1C;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,mBAAmB,GAAG,SAAS;wBAIhE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;wCAIhB;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,uBAAuB,GAAG,SAAS;QAKtF,oFAAoF;0CAClD;YAAE,MAAM,EAAE,OAAO,qBAAqB,CAAC,KAAK,CAAA;SAAE,GAAG,MAAM,EAAE;0CACzD;YAChC,MAAM,EAAE,OAAO,qBAAqB,CAAC,MAAM,CAAC;SAC7C,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;wCA4BM;YAAE,MAAM,EAAE,OAAO,qBAAqB,CAAC,KAAK,CAAA;SAAE,GAAG,KAAK,CAAC;YACrF,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,uBAAuB,CAAC;YACnC,KAAK,EAAE,mBAAmB,CAAC;SAC5B,CAAC;wCAC8B;YAC9B,MAAM,EAAE,OAAO,qBAAqB,CAAC,MAAM,CAAC;SAC7C,GAAG,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,uBAAuB,CAAC;YAAC,KAAK,EAAE,mBAAmB,CAAA;SAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA1GnE,CAAC;;;;;;;;aAqIvB,CAAC"}

package/dist/esm/helpers/inversion/mixins/model.mixin.js

@@ -1,4 +1,5 @@
 import { getError } from '@venizia/ignis-helpers/core';
+import { AuthorizeModelFormats } from '../common/constants.js';
 import { MetadataKeys } from '../common/keys.js';
 /** Registered models that declare an authorize setting, in registry order. */
 const collectAuthorizeEntries = (opts) => {
@@ -79,10 +80,10 @@ export const ModelMetadataMixin = (baseClass) => {
         }
         getAuthorizeModelPrincipals(opts) {
             switch (opts.format) {
-                case 'array': {
+                case AuthorizeModelFormats.ARRAY: {
                     return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map((item) => item.principal);
                 }
-                case 'record': {
+                case AuthorizeModelFormats.RECORD: {
                     const record = {};
                     const authorizePrincipals = collectAuthorizePrincipals({
                         modelRegistry: this.modelRegistry,
@@ -101,10 +102,10 @@ export const ModelMetadataMixin = (baseClass) => {
         }
         getAuthorizeModelSettings(opts) {
             switch (opts.format) {
-                case 'array': {
+                case AuthorizeModelFormats.ARRAY: {
                     return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });
                 }
-                case 'record': {
+                case AuthorizeModelFormats.RECORD: {
                     const record = {};
                     const authorizeEntries = collectAuthorizeEntries({ modelRegistry: this.modelRegistry });
                     for (const item of authorizeEntries) {

package/dist/esm/helpers/inversion/mixins/model.mixin.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport type { TMixinTarget } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';\nimport { MetadataKeys } from '../common/keys';\nimport type {\n  IModelAuthorizeSettings,\n  IModelMetadata,\n  IModelRegistryEntry,\n  TDecoratorModelTarget,\n  TModelClass,\n} from '../common/types';\n\n/** Registered models that declare an authorize setting, in registry order. */\nconst collectAuthorizeEntries = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }> => {\n  const result: Array<{\n    name: string;\n    authorize: IModelAuthorizeSettings;\n    entry: IModelRegistryEntry;\n  }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const authorize = entry.metadata.settings?.authorize;\n    if (!authorize) {\n      continue;\n    }\n\n    result.push({ name, authorize, entry });\n  }\n\n  return result;\n};\n\n/** Registered models that declare an authorize principal, in registry order. */\nconst collectAuthorizePrincipals = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; principal: string }> => {\n  const result: Array<{ name: string; principal: string }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const principal = entry.metadata.settings?.authorize?.principal;\n    if (!principal) {\n      continue;\n    }\n\n    result.push({ name, principal });\n  }\n\n  return result;\n};\n\nexport const ModelMetadataMixin = <BaseClass extends TMixinTarget<_MetadataRegistry>>(\n  baseClass: BaseClass,\n) => {\n  return class extends baseClass {\n    modelRegistry: Map<string, IModelRegistryEntry>;\n    modelsBySchema: WeakMap<object, IModelRegistryEntry>;\n\n    setModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n      metadata: IModelMetadata;\n    }): void {\n      const { target, metadata } = opts;\n      Reflect.defineMetadata(MetadataKeys.MODEL, metadata, target);\n    }\n\n    getModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n    }): IModelMetadata | undefined {\n      const { target } = opts;\n      return Reflect.getMetadata(MetadataKeys.MODEL, target);\n    }\n\n    /** Registers a model (called by @model) - relations are stored as a resolver, not resolved immediately, so circular references between models resolve lazily in buildSchema(). */\n    registerModel<Model extends AbstractEntity = AbstractEntity>(opts: {\n      target: TDecoratorModelTarget<Model>;\n      metadata: IModelMetadata;\n    }) {\n      const { target, metadata } = opts;\n\n      // Decorator target is always a class constructor at runtime\n      const modelClass = target as TModelClass<Model>;\n\n      // Table name precedence: explicit metadata > static TABLE_NAME > class name. TABLE_NAME is deliberately outside IEntityStatics (not part of the neutral contract) but still honored here via a local cast.\n      const tableName =\n        [metadata.tableName, (modelClass as { TABLE_NAME?: string }).TABLE_NAME].find(Boolean) ??\n        modelClass.name;\n\n      // Resolver, not resolved value - executed lazily in buildSchema() once all models are loaded\n      const relationsResolver = modelClass.relations;\n\n      const entry: IModelRegistryEntry = {\n        target: modelClass,\n        metadata,\n        schema: modelClass.schema,\n        relationsResolver,\n      };\n      this.modelRegistry.set(tableName, entry);\n\n      const { schema } = modelClass;\n      if (schema && typeof schema === 'object') {\n        const claimed = this.modelsBySchema.get(schema);\n        if (claimed && claimed.target !== modelClass) {\n          this.modelsBySchema.delete(schema);\n        } else {\n          this.modelsBySchema.set(schema, entry);\n        }\n      }\n\n      // Also mirrored via Reflect so plain metadata lookups (getModelMetadata) still see it\n      this.setModelMetadata({ target, metadata });\n    }\n\n    getModelEntry(opts: { name: string }): IModelRegistryEntry | undefined {\n      return this.modelRegistry.get(opts.name);\n    }\n\n    getModelEntryBySchema(opts: { schema: object }): IModelRegistryEntry | undefined {\n      return this.modelsBySchema.get(opts.schema);\n    }\n\n    getAllModels(): Map<string, IModelRegistryEntry> {\n      return this.modelRegistry;\n    }\n\n    getModelAuthorizeSettings(opts: { name: string }): IModelAuthorizeSettings | undefined {\n      const entry = this.getModelEntry(opts);\n      return entry?.metadata?.settings?.authorize;\n    }\n\n    /** Authorization principals across all models that declare an authorize setting. */\n    getAuthorizeModelPrincipals(opts: { format: 'array' }): string[];\n    getAuthorizeModelPrincipals(opts: { format: 'record' }): Record<string, string>;\n    getAuthorizeModelPrincipals(opts: { format: 'array' | 'record' }) {\n      switch (opts.format) {\n        case 'array': {\n          return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map(\n            (item) => item.principal,\n          );\n        }\n        case 'record': {\n          const record: Record<string, string> = {};\n\n          const authorizePrincipals = collectAuthorizePrincipals({\n            modelRegistry: this.modelRegistry,\n          });\n          for (const item of authorizePrincipals) {\n            record[item.name] = item.principal;\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelPrincipals] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n\n    getAuthorizeModelSettings(opts: { format: 'array' }): Array<{\n      name: string;\n      authorize: IModelAuthorizeSettings;\n      entry: IModelRegistryEntry;\n    }>;\n    getAuthorizeModelSettings(opts: {\n      format: 'record';\n    }): Record<string, { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }>;\n    getAuthorizeModelSettings(opts: { format: 'array' | 'record' }) {\n      switch (opts.format) {\n        case 'array': {\n          return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n        }\n        case 'record': {\n          const record: Record<\n            string,\n            { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }\n          > = {};\n\n          const authorizeEntries = collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n          for (const item of authorizeEntries) {\n            record[item.name] = { authorize: item.authorize, entry: item.entry };\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelSettings] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n  };\n};\n"]}
+{"version":3,"file":"model.mixin.js","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/model.mixin.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractEntity } from '@/base/models';\nimport type { TMixinTarget } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { MetadataRegistry as _MetadataRegistry } from '@venizia/ignis-inversion';\nimport { AuthorizeModelFormats, type TAuthorizeModelFormat } from '../common/constants';\nimport { MetadataKeys } from '../common/keys';\nimport type {\n  IModelAuthorizeSettings,\n  IModelMetadata,\n  IModelRegistryEntry,\n  TDecoratorModelTarget,\n  TModelClass,\n} from '../common/types';\n\n/** Registered models that declare an authorize setting, in registry order. */\nconst collectAuthorizeEntries = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }> => {\n  const result: Array<{\n    name: string;\n    authorize: IModelAuthorizeSettings;\n    entry: IModelRegistryEntry;\n  }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const authorize = entry.metadata.settings?.authorize;\n    if (!authorize) {\n      continue;\n    }\n\n    result.push({ name, authorize, entry });\n  }\n\n  return result;\n};\n\n/** Registered models that declare an authorize principal, in registry order. */\nconst collectAuthorizePrincipals = (opts: {\n  modelRegistry: Map<string, IModelRegistryEntry>;\n}): Array<{ name: string; principal: string }> => {\n  const result: Array<{ name: string; principal: string }> = [];\n\n  for (const [name, entry] of opts.modelRegistry) {\n    const principal = entry.metadata.settings?.authorize?.principal;\n    if (!principal) {\n      continue;\n    }\n\n    result.push({ name, principal });\n  }\n\n  return result;\n};\n\nexport const ModelMetadataMixin = <BaseClass extends TMixinTarget<_MetadataRegistry>>(\n  baseClass: BaseClass,\n) => {\n  return class extends baseClass {\n    modelRegistry: Map<string, IModelRegistryEntry>;\n    modelsBySchema: WeakMap<object, IModelRegistryEntry>;\n\n    setModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n      metadata: IModelMetadata;\n    }): void {\n      const { target, metadata } = opts;\n      Reflect.defineMetadata(MetadataKeys.MODEL, metadata, target);\n    }\n\n    getModelMetadata<Target extends object = object>(opts: {\n      target: Target;\n    }): IModelMetadata | undefined {\n      const { target } = opts;\n      return Reflect.getMetadata(MetadataKeys.MODEL, target);\n    }\n\n    /** Registers a model (called by @model) - relations are stored as a resolver, not resolved immediately, so circular references between models resolve lazily in buildSchema(). */\n    registerModel<Model extends AbstractEntity = AbstractEntity>(opts: {\n      target: TDecoratorModelTarget<Model>;\n      metadata: IModelMetadata;\n    }) {\n      const { target, metadata } = opts;\n\n      // Decorator target is always a class constructor at runtime\n      const modelClass = target as TModelClass<Model>;\n\n      // Table name precedence: explicit metadata > static TABLE_NAME > class name. TABLE_NAME is deliberately outside IEntityStatics (not part of the neutral contract) but still honored here via a local cast.\n      const tableName =\n        [metadata.tableName, (modelClass as { TABLE_NAME?: string }).TABLE_NAME].find(Boolean) ??\n        modelClass.name;\n\n      // Resolver, not resolved value - executed lazily in buildSchema() once all models are loaded\n      const relationsResolver = modelClass.relations;\n\n      const entry: IModelRegistryEntry = {\n        target: modelClass,\n        metadata,\n        schema: modelClass.schema,\n        relationsResolver,\n      };\n      this.modelRegistry.set(tableName, entry);\n\n      const { schema } = modelClass;\n      if (schema && typeof schema === 'object') {\n        const claimed = this.modelsBySchema.get(schema);\n        if (claimed && claimed.target !== modelClass) {\n          this.modelsBySchema.delete(schema);\n        } else {\n          this.modelsBySchema.set(schema, entry);\n        }\n      }\n\n      // Also mirrored via Reflect so plain metadata lookups (getModelMetadata) still see it\n      this.setModelMetadata({ target, metadata });\n    }\n\n    getModelEntry(opts: { name: string }): IModelRegistryEntry | undefined {\n      return this.modelRegistry.get(opts.name);\n    }\n\n    getModelEntryBySchema(opts: { schema: object }): IModelRegistryEntry | undefined {\n      return this.modelsBySchema.get(opts.schema);\n    }\n\n    getAllModels(): Map<string, IModelRegistryEntry> {\n      return this.modelRegistry;\n    }\n\n    getModelAuthorizeSettings(opts: { name: string }): IModelAuthorizeSettings | undefined {\n      const entry = this.getModelEntry(opts);\n      return entry?.metadata?.settings?.authorize;\n    }\n\n    /** Authorization principals across all models that declare an authorize setting. */\n    getAuthorizeModelPrincipals(opts: { format: typeof AuthorizeModelFormats.ARRAY }): string[];\n    getAuthorizeModelPrincipals(opts: {\n      format: typeof AuthorizeModelFormats.RECORD;\n    }): Record<string, string>;\n    getAuthorizeModelPrincipals(opts: { format: TAuthorizeModelFormat }) {\n      switch (opts.format) {\n        case AuthorizeModelFormats.ARRAY: {\n          return collectAuthorizePrincipals({ modelRegistry: this.modelRegistry }).map(\n            (item) => item.principal,\n          );\n        }\n        case AuthorizeModelFormats.RECORD: {\n          const record: Record<string, string> = {};\n\n          const authorizePrincipals = collectAuthorizePrincipals({\n            modelRegistry: this.modelRegistry,\n          });\n          for (const item of authorizePrincipals) {\n            record[item.name] = item.principal;\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelPrincipals] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n\n    getAuthorizeModelSettings(opts: { format: typeof AuthorizeModelFormats.ARRAY }): Array<{\n      name: string;\n      authorize: IModelAuthorizeSettings;\n      entry: IModelRegistryEntry;\n    }>;\n    getAuthorizeModelSettings(opts: {\n      format: typeof AuthorizeModelFormats.RECORD;\n    }): Record<string, { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }>;\n    getAuthorizeModelSettings(opts: { format: TAuthorizeModelFormat }) {\n      switch (opts.format) {\n        case AuthorizeModelFormats.ARRAY: {\n          return collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n        }\n        case AuthorizeModelFormats.RECORD: {\n          const record: Record<\n            string,\n            { authorize: IModelAuthorizeSettings; entry: IModelRegistryEntry }\n          > = {};\n\n          const authorizeEntries = collectAuthorizeEntries({ modelRegistry: this.modelRegistry });\n          for (const item of authorizeEntries) {\n            record[item.name] = { authorize: item.authorize, entry: item.entry };\n          }\n\n          return record;\n        }\n        default: {\n          throw getError({\n            message: `[getAuthorizeModelSettings] Invalid format | format: ${opts.format} | valid: array, record`,\n          });\n        }\n      }\n    }\n  };\n};\n"]}

package/dist/esm/helpers/inversion/mixins/repository.mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/repository.mixin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repository.mixin.d.ts","sourceRoot":"","sources":["../../../../../src/helpers/inversion/mixins/repository.mixin.ts"],"names":[],"mappings":"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"}

package/dist/esm/helpers/inversion/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAW9E,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAsCyS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;4BA9B3T,CAAC;AAEF,iHAAiH;AACjH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,uBAAuB;IAEzD,OAAO;IASP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,QAAQ,IAAI,IAAI;CAOjB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAW9E,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAsCkT,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAD,CAAC;;;;;;;;4BA9BpU,CAAC;AAEF,iHAAiH;AACjH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,uBAAuB;IAEzD,OAAO;IASP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,QAAQ,IAAI,IAAI;CAOjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-kernel",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Browser-pure kernel of the IGNIS framework: dependency injection, lifecycle, REST controllers, repository and datasource abstractions, and the authentication and authorization seams. No node builtin and no server-only peer, so the same kernel serves a Bun server and a browser Worker.",
   "keywords": [
     "authentication",
@@ -14,8 +14,6 @@
     "ioc",
     "isomorphic",
     "kernel",
-    "loopback",
-    "loopback4",
     "repository-pattern",
     "rest",
     "typescript",
@@ -44,30 +42,22 @@
     "!**/*.tsbuildinfo"
   ],
   "sideEffects": [
-    "./dist/cjs/index.js",
     "./dist/esm/index.js"
   ],
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/cjs/index.d.ts",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/cjs/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "default": "./dist/cjs/index.js"
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./metadata": {
-      "types": "./dist/cjs/metadata.d.ts",
-      "import": "./dist/esm/metadata.js",
-      "require": "./dist/cjs/metadata.js",
-      "default": "./dist/cjs/metadata.js"
+      "types": "./dist/esm/metadata.d.ts",
+      "default": "./dist/esm/metadata.js"
     },
     "./repository": {
-      "types": "./dist/cjs/repository.d.ts",
-      "import": "./dist/esm/repository.js",
-      "require": "./dist/cjs/repository.js",
-      "default": "./dist/cjs/repository.js"
+      "types": "./dist/esm/repository.d.ts",
+      "default": "./dist/esm/repository.js"
     },
     "./package.json": "./package.json"
   },
@@ -79,14 +69,14 @@
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ignis-filter": "0.4.2",
-    "@venizia/ignis-helpers": "0.4.2",
-    "@venizia/ignis-inversion": "0.4.2",
+    "@venizia/ignis-filter": "0.4.4",
+    "@venizia/ignis-helpers": "0.4.4",
+    "@venizia/ignis-inversion": "0.4.4",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
     "@types/bun": "^1.4.3",
-    "@venizia/dev-configs": "0.4.2",
+    "@venizia/dev-configs": "0.4.4",
     "casbin": "^5.51.1",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",

package/dist/cjs/base/applications/abstract.d.ts

@@ -1,43 +0,0 @@
-import { Container } from '../../helpers/inversion/container';
-import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
-import type { IApplicationConfigs, IApplicationInfo } from './common';
-export declare abstract class AbstractApplication extends Container {
-    protected configs: IApplicationConfigs;
-    protected projectRoot: string;
-    private postStartHooks;
-    private postStopHooks;
-    constructor(opts: {
-        scope: string;
-        config: IApplicationConfigs;
-    });
-    abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;
-    abstract preConfigure(): ValueOrPromise<void>;
-    /**
-     * Runs after every registration sweep (datasources, components, controllers) has already
-     * completed. Registering a new one here is not auto-registered and silently does nothing -
-     * call `configure()` manually instead.
-     */
-    abstract postConfigure(): ValueOrPromise<void>;
-    abstract staticConfigure(): void;
-    abstract setupMiddlewares(opts?: {
-        middlewares?: Record<string | symbol, any>;
-    }): ValueOrPromise<void>;
-    abstract initialize(): Promise<void>;
-    protected getDefaultAsyncContextEnabled(): boolean;
-    getProjectConfigs(): IApplicationConfigs;
-    getProjectRoot(): string;
-    registerPostStartHook(opts: {
-        identifier: string;
-        hook: () => ValueOrPromise<void>;
-    }): void;
-    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
-    protected executePostStartHooks(): Promise<void>;
-    registerPostStopHook(opts: {
-        identifier: string;
-        hook: () => ValueOrPromise<void>;
-    }): void;
-    protected executePostStopHooks(): Promise<void>;
-    protected registerCoreBindings(): void;
-    init(): void;
-}
-//# sourceMappingURL=abstract.d.ts.map

package/dist/cjs/base/applications/abstract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEtE,8BAAsB,mBAAoB,SAAQ,SAAS;IACzD,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,cAAc,CAAuE;IAC7F,OAAO,CAAC,aAAa,CAAuE;gBAEhF,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE;IAchE,QAAQ,CAAC,UAAU,IAAI,cAAc,CAAC,gBAAgB,CAAC;IACvD,QAAQ,CAAC,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC;IAE9C,QAAQ,CAAC,eAAe,IAAI,IAAI;IAEhC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;KAC5C,GAAG,cAAc,CAAC,IAAI,CAAC;IAExB,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC,SAAS,CAAC,6BAA6B,IAAI,OAAO;IAIlD,iBAAiB,IAAI,mBAAmB;IAIxC,cAAc,IAAI,MAAM;IAMxB,qBAAqB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAOpF,qMAAqM;cACrL,qBAAqB;IAwCrC,oBAAoB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;cAOnE,oBAAoB;IAWpC,SAAS,CAAC,oBAAoB;IAM9B,IAAI;CAGL"}

package/dist/cjs/base/applications/abstract.js

@@ -1,96 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractApplication = void 0;
-const bindings_1 = require("../../common/bindings");
-const container_1 = require("../../helpers/inversion/container");
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-class AbstractApplication extends container_1.Container {
-    constructor(opts) {
-        const { scope, config } = opts;
-        super({ scope });
-        this.postStartHooks = [];
-        this.postStopHooks = [];
-        this.configs = Object.assign({}, config, {
-            asyncContext: {
-                enable: config?.asyncContext?.enable ?? this.getDefaultAsyncContextEnabled(),
-            },
-        });
-        this.projectRoot = this.getProjectRoot();
-        this.logger.for('constructor').info('Project root: %s', this.projectRoot);
-    }
-    getDefaultAsyncContextEnabled() {
-        return false;
-    }
-    getProjectConfigs() {
-        return this.configs;
-    }
-    getProjectRoot() {
-        const projectRoot = '';
-        this.bind({ key: bindings_1.CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
-        return projectRoot;
-    }
-    registerPostStartHook(opts) {
-        this.postStartHooks.push(opts);
-        this.logger
-            .for(this.registerPostStartHook.name)
-            .debug('Registered post-start hook | identifier: %s', opts.identifier);
-    }
-    /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */
-    async executePostStartHooks() {
-        if (this.postStartHooks.length === 0) {
-            return;
-        }
-        const logger = this.logger.for(this.executePostStartHooks.name);
-        logger.info('Executing %s post-start hook(s)...', this.postStartHooks.length);
-        const failures = [];
-        for (const { identifier, hook } of this.postStartHooks) {
-            const t = performance.now();
-            try {
-                await hook();
-            }
-            catch (error) {
-                logger.error('Failed to execute hook | identifier: %s | error: %s', identifier, error);
-                failures.push({ identifier, error });
-                continue;
-            }
-            logger.info('Executed hook | identifier: %s | took: %s (ms)', identifier, performance.now() - t);
-        }
-        if (failures.length === 0) {
-            return;
-        }
-        throw (0, core_1.getError)({
-            statusCode: common_1.HTTP.ResultCodes.RS_5.InternalServerError,
-            message: `[executePostStartHooks] Failed post-start hook(s): ${failures
-                .map((failure) => `${failure.identifier} (${failure.error})`)
-                .join(', ')}`,
-        });
-    }
-    registerPostStopHook(opts) {
-        this.postStopHooks.push(opts);
-        this.logger
-            .for(this.registerPostStopHook.name)
-            .debug('Registered post-stop hook | identifier: %s', opts.identifier);
-    }
-    async executePostStopHooks() {
-        const logger = this.logger.for(this.executePostStopHooks.name);
-        for (const { identifier, hook } of this.postStopHooks) {
-            try {
-                await hook();
-            }
-            catch (error) {
-                logger.error('Post-stop hook failed | identifier: %s | error: %s', identifier, error);
-            }
-        }
-    }
-    registerCoreBindings() {
-        this.bind({
-            key: bindings_1.CoreBindings.APPLICATION_INSTANCE,
-        }).toProvider((_) => this);
-    }
-    init() {
-        this.registerCoreBindings();
-    }
-}
-exports.AbstractApplication = AbstractApplication;
-//# sourceMappingURL=abstract.js.map

package/dist/cjs/base/applications/abstract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/base/applications/abstract.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreBindings } from '@/common/bindings';\nimport { Container } from '@/helpers/inversion/container';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { IApplicationConfigs, IApplicationInfo } from './common';\n\nexport abstract class AbstractApplication extends Container {\n  protected configs: IApplicationConfigs;\n  protected projectRoot: string;\n\n  private postStartHooks: Array<{ identifier: string; hook: () => ValueOrPromise<void> }> = [];\n  private postStopHooks: Array<{ identifier: string; hook: () => ValueOrPromise<void> }> = [];\n\n  constructor(opts: { scope: string; config: IApplicationConfigs }) {\n    const { scope, config } = opts;\n    super({ scope });\n\n    this.configs = Object.assign({}, config, {\n      asyncContext: {\n        enable: config?.asyncContext?.enable ?? this.getDefaultAsyncContextEnabled(),\n      },\n    });\n\n    this.projectRoot = this.getProjectRoot();\n    this.logger.for('constructor').info('Project root: %s', this.projectRoot);\n  }\n\n  abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;\n  abstract preConfigure(): ValueOrPromise<void>;\n\n  /**\n   * Runs after every registration sweep (datasources, components, controllers) has already\n   * completed. Registering a new one here is not auto-registered and silently does nothing -\n   * call `configure()` manually instead.\n   */\n  abstract postConfigure(): ValueOrPromise<void>;\n\n  abstract staticConfigure(): void;\n\n  abstract setupMiddlewares(opts?: {\n    middlewares?: Record<string | symbol, any>;\n  }): ValueOrPromise<void>;\n\n  abstract initialize(): Promise<void>;\n\n  protected getDefaultAsyncContextEnabled(): boolean {\n    return false;\n  }\n\n  getProjectConfigs(): IApplicationConfigs {\n    return this.configs;\n  }\n\n  getProjectRoot(): string {\n    const projectRoot = '';\n    this.bind<string>({ key: CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);\n    return projectRoot;\n  }\n\n  registerPostStartHook(opts: { identifier: string; hook: () => ValueOrPromise<void> }) {\n    this.postStartHooks.push(opts);\n    this.logger\n      .for(this.registerPostStartHook.name)\n      .debug('Registered post-start hook | identifier: %s', opts.identifier);\n  }\n\n  /** Runs every post-start hook in isolation - the server is already listening, so a throwing hook must not cancel the ones behind it; failures are collected and reported as one error at the end. */\n  protected async executePostStartHooks() {\n    if (this.postStartHooks.length === 0) {\n      return;\n    }\n\n    const logger = this.logger.for(this.executePostStartHooks.name);\n    logger.info('Executing %s post-start hook(s)...', this.postStartHooks.length);\n\n    const failures: Array<{ identifier: string; error: unknown }> = [];\n\n    for (const { identifier, hook } of this.postStartHooks) {\n      const t = performance.now();\n\n      try {\n        await hook();\n      } catch (error) {\n        logger.error('Failed to execute hook | identifier: %s | error: %s', identifier, error);\n        failures.push({ identifier, error });\n        continue;\n      }\n\n      logger.info(\n        'Executed hook | identifier: %s | took: %s (ms)',\n        identifier,\n        performance.now() - t,\n      );\n    }\n\n    if (failures.length === 0) {\n      return;\n    }\n\n    throw getError({\n      statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n      message: `[executePostStartHooks] Failed post-start hook(s): ${failures\n        .map((failure) => `${failure.identifier} (${failure.error})`)\n        .join(', ')}`,\n    });\n  }\n\n  registerPostStopHook(opts: { identifier: string; hook: () => ValueOrPromise<void> }) {\n    this.postStopHooks.push(opts);\n    this.logger\n      .for(this.registerPostStopHook.name)\n      .debug('Registered post-stop hook | identifier: %s', opts.identifier);\n  }\n\n  protected async executePostStopHooks() {\n    const logger = this.logger.for(this.executePostStopHooks.name);\n    for (const { identifier, hook } of this.postStopHooks) {\n      try {\n        await hook();\n      } catch (error) {\n        logger.error('Post-stop hook failed | identifier: %s | error: %s', identifier, error);\n      }\n    }\n  }\n\n  protected registerCoreBindings() {\n    this.bind<typeof this>({\n      key: CoreBindings.APPLICATION_INSTANCE,\n    }).toProvider((_) => this);\n  }\n\n  init() {\n    this.registerCoreBindings();\n  }\n}\n"]}