@xeno-js/core 0.1.10 → 0.1.11

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.

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.

package/dist/index.js

@@ -3011,12 +3011,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;
@@ -4522,6 +4526,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() {