@xeno-js/core 0.1.10 → 0.1.12

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ICache, Optional, IExtendendAuthService, IBaseAuthService, ICacheKeyBuilder, IPipelineBehavior, ICommand, IConcurrencyService, IConfigurationService, ILogger, IMediator, IMiddleware, HttpHeaders, IQuery, RequestContext, IServiceResilience, IServiceExtractor, Metadata, IUnitOfWork, IDisposable, IValidatorService, IIdentityAccessor, IContextAccessor, INetworkContextAccessor, IFactory, UserContext, Factory, IBaseAccessor, Identity, HttpMethod, AuthConfig, CookieOptions, SetupAction, HttpClientConfig, LogLevel, ILoggerClient, Dictionary, AuthPolicy, IStrategy, IRequest, ResponseDto, IHandler, ResultType, ISpecification, CacheConfig, DbConfig, IReadDao, IReadDataSource, IMapper, IRepository, IWriteDataSource, IController, AppError } from '@xeno-js/shared';
+import { ICache, Optional, IExtendendAuthService, IBaseAuthService, ICacheKeyBuilder, IPipelineBehavior, ICommand, IConcurrencyService, IConfigurationService, ILogger, IMediator, IMiddleware, HttpHeaders, IQuery, RequestContext, IServiceResilience, IServiceExtractor, Metadata, IUnitOfWork, IDisposable, IValidatorService, IIdentityAccessor, IContextAccessor, INetworkContextAccessor, IFactory, UserContext, ITransactionState, Factory, IBaseAccessor, Identity, HttpMethod, AuthConfig, CookieOptions, SetupAction, HttpClientConfig, LogLevel, ILoggerClient, Dictionary, AuthPolicy, IStrategy, IRequest, ResponseDto, IHandler, ResultType, ISpecification, CacheConfig, DbConfig, IReadDao, IReadDataSource, IMapper, IRepository, IWriteDataSource, IController, AppError } from '@xeno-js/shared';
 export * from '@xeno-js/shared';
 export { Query as BaseQuery } from '@xeno-js/shared';
 import { SupabaseClientOptions } from '@supabase/supabase-js';
@@ -54,7 +54,7 @@ interface IRateLimitKeyBuilder {
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface ApplicationRegistry<T = unknown> {
+interface ApplicationRegistry<T = unknown, Ttx = unknown> {
     /** @description Token used to register and resolve the Extended AuthService instance in the dependency injection container.
      *
      * @author Xeno
@@ -255,6 +255,14 @@ interface ApplicationRegistry<T = unknown> {
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly USER_CONTEXT_FACTORY: IFactory<void, UserContext>;
+    /** @description Token used to register and resolve the TransactionState instance in the dependency injection container.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly TRANSACTION_STATE: ITransactionState<Ttx>;
 }
 
 /**
@@ -1581,7 +1589,7 @@ type DbTransaction = Parameters<Parameters<DbContext['transaction']>[0]>[0];
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object> = ApplicationRegistry<DbContext<TSchema>> & Readonly<Omit<TExtensions, keyof ApplicationRegistry<DbContext<TSchema>>>>;
+type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object> = ApplicationRegistry<DbContext<TSchema>, DbTransaction> & Readonly<Omit<TExtensions, keyof ApplicationRegistry<DbContext<TSchema>, DbTransaction>>>;
 
 /**
  * @description The AppBuilder class provides a fluent, .NET-style API for configuring and bootstrapping the application.
@@ -1596,6 +1604,7 @@ type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object>
 declare class AppBuilder<TRegistry extends XenoRegistry = XenoRegistry> {
     private readonly _container;
     private readonly _configuration;
+    private _isBuilded;
     constructor(container?: IServiceContainer<TRegistry>);
     private readonly _modules;
     private _pipelineConfig;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ICache, Optional, IExtendendAuthService, IBaseAuthService, ICacheKeyBuilder, IPipelineBehavior, ICommand, IConcurrencyService, IConfigurationService, ILogger, IMediator, IMiddleware, HttpHeaders, IQuery, RequestContext, IServiceResilience, IServiceExtractor, Metadata, IUnitOfWork, IDisposable, IValidatorService, IIdentityAccessor, IContextAccessor, INetworkContextAccessor, IFactory, UserContext, Factory, IBaseAccessor, Identity, HttpMethod, AuthConfig, CookieOptions, SetupAction, HttpClientConfig, LogLevel, ILoggerClient, Dictionary, AuthPolicy, IStrategy, IRequest, ResponseDto, IHandler, ResultType, ISpecification, CacheConfig, DbConfig, IReadDao, IReadDataSource, IMapper, IRepository, IWriteDataSource, IController, AppError } from '@xeno-js/shared';
+import { ICache, Optional, IExtendendAuthService, IBaseAuthService, ICacheKeyBuilder, IPipelineBehavior, ICommand, IConcurrencyService, IConfigurationService, ILogger, IMediator, IMiddleware, HttpHeaders, IQuery, RequestContext, IServiceResilience, IServiceExtractor, Metadata, IUnitOfWork, IDisposable, IValidatorService, IIdentityAccessor, IContextAccessor, INetworkContextAccessor, IFactory, UserContext, ITransactionState, Factory, IBaseAccessor, Identity, HttpMethod, AuthConfig, CookieOptions, SetupAction, HttpClientConfig, LogLevel, ILoggerClient, Dictionary, AuthPolicy, IStrategy, IRequest, ResponseDto, IHandler, ResultType, ISpecification, CacheConfig, DbConfig, IReadDao, IReadDataSource, IMapper, IRepository, IWriteDataSource, IController, AppError } from '@xeno-js/shared';
 export * from '@xeno-js/shared';
 export { Query as BaseQuery } from '@xeno-js/shared';
 import { SupabaseClientOptions } from '@supabase/supabase-js';
@@ -54,7 +54,7 @@ interface IRateLimitKeyBuilder {
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface ApplicationRegistry<T = unknown> {
+interface ApplicationRegistry<T = unknown, Ttx = unknown> {
     /** @description Token used to register and resolve the Extended AuthService instance in the dependency injection container.
      *
      * @author Xeno
@@ -255,6 +255,14 @@ interface ApplicationRegistry<T = unknown> {
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly USER_CONTEXT_FACTORY: IFactory<void, UserContext>;
+    /** @description Token used to register and resolve the TransactionState instance in the dependency injection container.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly TRANSACTION_STATE: ITransactionState<Ttx>;
 }
 
 /**
@@ -1581,7 +1589,7 @@ type DbTransaction = Parameters<Parameters<DbContext['transaction']>[0]>[0];
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object> = ApplicationRegistry<DbContext<TSchema>> & Readonly<Omit<TExtensions, keyof ApplicationRegistry<DbContext<TSchema>>>>;
+type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object> = ApplicationRegistry<DbContext<TSchema>, DbTransaction> & Readonly<Omit<TExtensions, keyof ApplicationRegistry<DbContext<TSchema>, DbTransaction>>>;
 
 /**
  * @description The AppBuilder class provides a fluent, .NET-style API for configuring and bootstrapping the application.
@@ -1596,6 +1604,7 @@ type XenoRegistry<TSchema extends Dictionary = Dictionary, TExtensions = object>
 declare class AppBuilder<TRegistry extends XenoRegistry = XenoRegistry> {
     private readonly _container;
     private readonly _configuration;
+    private _isBuilded;
     constructor(container?: IServiceContainer<TRegistry>);
     private readonly _modules;
     private _pipelineConfig;

package/dist/index.js

@@ -2435,9 +2435,7 @@ var init_cockatiel_resilience_factory = __esm({
           }
         }
         if (isNetworkError) return true;
-        if (Guards31.isDefined(status)) {
-          return status === 408 || status === 429 || status >= 500 && status < 600;
-        }
+        if (Guards31.isDefined(status)) return status === 408 || status >= 500 && status < 600;
         return false;
       }
       isTransientAndIdempotent(error) {
@@ -3011,12 +3009,16 @@ var init_db_module = __esm({
         const { DbUtils: DbUtils2 } = await Promise.resolve().then(() => (init_db_utils(), db_utils_exports));
         const db = opts.enableSqlLite ? await DbUtils2.addSqlLite(opts) : await DbUtils2.addDbClient(opts);
         const { TransactionState: TransactionState2 } = await Promise.resolve().then(() => (init_transaction_state(), transaction_state_exports));
-        const ttx = new TransactionState2();
+        container.addScoped("TRANSACTION_STATE", () => {
+          return new TransactionState2();
+        });
         const { UnitOfWork: UnitOfWork2 } = await Promise.resolve().then(() => (init_unit_of_work(), unit_of_work_exports));
-        container.addScoped(TOKENS4.UNIT_OF_WORK, () => {
+        container.addScoped(TOKENS4.UNIT_OF_WORK, (c) => {
+          const ttx = c.resolve("TRANSACTION_STATE");
           return new UnitOfWork2(db, ttx);
         });
-        container.addScoped(TOKENS4.DB_CONTEXT, () => {
+        container.addScoped(TOKENS4.DB_CONTEXT, (c) => {
+          const ttx = c.resolve("TRANSACTION_STATE");
           return new Proxy(db, {
             get(_target, prop, receiver) {
               const activeState = ttx.state;
@@ -3341,8 +3343,8 @@ var init_cqrs_module = __esm({
           );
           if (Guards46.isDefined(validationPipelines)) pipelines.push(validationPipelines);
         }
-        const commandPipelines = pipelines;
-        const queryPipelines = pipelines;
+        const commandPipelines = [...pipelines];
+        const queryPipelines = [...pipelines];
         if (Guards46.isDefined(opts.commandBus.idempotency) || Guards46.isDefined(opts.commandBus.concurrency)) {
           const { PipelineUtils: PipelineUtils2 } = await Promise.resolve().then(() => (init_pipeline_utils(), pipeline_utils_exports));
           const newCommandPipelines = await PipelineUtils2.addCommand(container, opts.commandBus);
@@ -4522,6 +4524,12 @@ var ServiceContainer = class {
     this.registrations.set(token, { token, lifetime, factory });
   }
   resolve(token) {
+    const registration = this.registrations.get(token);
+    if (registration?.lifetime === "scoped") {
+      throw new Error(
+        `[DI Container Error]: Scoped service '${String(token)}' requires an active scope.`
+      );
+    }
     return this.internalExecuteInContext(() => this.rootScope.resolve(token));
   }
   createScope() {
@@ -4641,6 +4649,7 @@ var isDisposable = Object.freeze({
 var AppBuilder = class {
   _container = new ServiceContainer();
   _configuration;
+  _isBuilded = false;
   constructor(container) {
     this._container = container ?? new ServiceContainer();
     this._container.addSingleton(
@@ -5008,6 +5017,7 @@ var AppBuilder = class {
    * @link https://github.com/xeno-js/xeno-js 
    */
   async build() {
+    if (this._isBuilded) return this._container;
     console.info("\u2699\uFE0F Bootstrapping application modules...");
     const sortedModules = this._modules.sort((a, b) => a.priority - b.priority);
     for (const queued of sortedModules) {
@@ -5028,6 +5038,7 @@ var AppBuilder = class {
       }
     }
     console.info("\u2705 Application modules bootstrapped successfully.");
+    this._isBuilded = true;
     return this._container;
   }
   // ─────────────────────────────────────────────────────────────────────────────