@xeno-js/core 0.1.11 → 0.1.13

package/README.md

@@ -111,9 +111,9 @@ Request-scoped dependencies are resolved inside an explicit application scope,
 while request metadata can be carried through asynchronous execution using
 `AsyncLocalStorage`.
 
-Database transaction state is scoped to the same application boundary,
-allowing `UnitOfWork` and `DbContext` to operate against the transaction
-associated with the current scope.
+Database transaction state is scoped to the same application boundary, allowing
+`UnitOfWork` and `DbContext` to operate against the transaction associated with
+the current scope.
 
 ### 05 — Infrastructure Stays Outside the Domain
 
@@ -198,9 +198,11 @@ npm install zod pino cockatiel drizzle-orm
 The composition root is explicit:
 
 ```typescript
+// src/bootstrap.ts
 import { AppBuilder } from '@xeno-js/core'
 
-const app = new AppBuilder().addServices((services) => {
+const app = new AppBuilder()
+.addServices((services) => {
   services.addScoped('USER_REPOSITORY', (container) => {
     return new UserRepository(container.resolve('USER_DATA_SOURCE'))
   })
@@ -210,31 +212,49 @@ const app = new AppBuilder().addServices((services) => {
   })
 
   services.addTransient('FIND_USER_CONTROLLER', (c) => {
-    return new FindUserHandler(c.resolve(TOKENS.REQUEST_CONTEXT), c.resolve(TOKENS.MEDIATOR))
+    return new FindUserController(
+      c.resolve(TOKENS.REQUEST_CONTEXT),
+      c.resolve(TOKENS.MEDIATOR),
+    )
   })
 })
+
+await app.build()
 ```
 
 The transport remains outside the application composition:
 
-> ⚠️ **Implementation note: Example using Fastify**
-> The following snippet uses **Fastify** solely for demonstration purposes to illustrate the transport layer. Thanks to the framework's agnostic architecture, the underlying logic (`container` and `handler`) remains unchanged regardless of the chosen HTTP system (e.g., Express, Koa) or interface (CLI, gRPC).
+> ⚠️ **Implementation note: Example using Fastify** The following snippet uses
+> **Fastify** solely for demonstration purposes to illustrate the transport
+> layer. Thanks to the framework's agnostic architecture, the underlying logic
+> (`container` and `handler`) remains unchanged regardless of the chosen HTTP
+> system (e.g., Express, Koa) or interface (CLI, gRPC).
 
 ```typescript
-import Fastify from 'fastify';
-import { builder } from './bootstrap';
+import Fastify from 'fastify'
+import { app } from './bootstrap'
 
-const app = Fastify({ logger: true });
+const fastify = Fastify({ logger: true })
 
-app.get('/users/:id', async (req, reply) => {
+fastify.get('/users/:id', async (req, reply) => {
   const endpoint = req.url
-  const container = await builder.build();
+
   const action = async () => {
-      const controller = ContainerUtils.resolveServiceScoped('FIND_USER_CONTROLLER', container)
-      return await controller.handle()
+    const controller = ContainerUtils.resolveServiceScoped(
+      'FIND_USER_CONTROLLER',
+      app,
+    )
+    return await controller.handle()
   }
 
-  const result = await ContainerUtils.runExecute(endpoint, req.method, req.headers, { reply, req }, container, action)
+  const result = await ContainerUtils.runExecute(
+    endpoint,
+    req.method,
+    req.headers,
+    { reply, req },
+    app,
+    action,
+  )
 
   return reply.send(result)
 })
@@ -319,13 +339,13 @@ The documentation hub contains the architecture and integration guides:
 Recommended starting points:
 
 - [Introduction](https://www.xeno-js.it/introduction)
-- [Architecture](https://www.xeno-js.it/architecture)
-- [Dependency Injection](https://www.xeno-js.it/architecture/dependency-injection)
-- [CQRS](https://www.xeno-js.it/architecture/cqrs)
-- [Pipelines](https://www.xeno-js.it/architecture/pipelines)
-- [Request Lifecycle](https://www.xeno-js.it/architecture/request-lifecycle)
-- [Modules](https://www.xeno-js.it/architecture/modules)
-- [CLI](https://www.xeno-js.it/cli/overview)
+- [Fundamentals](https://www.xeno-js.it/docs/core/overview)
+- [Dependency Injection](https://www.xeno-js.it/docs/core/fundamentals/app-builder)
+- [CQRS](https://www.xeno-js.it/docs/core/fundamentals/command-query)
+- [Pipelines](https://www.xeno-js.it/docs/core/cqrs/overview)
+- [Request Lifecycle](https://www.xeno-js.it/docs/core/fundamentals/service-container)
+- [Middleware](https://www.xeno-js.it/docs/core/fundamentals/middleware)
+- [CLI](https://www.xeno-js.it/docs/cli/overview)
 
 ---
 
@@ -426,7 +446,7 @@ npm run check
 If Xeno is useful to you, you can support the project through the community and
 sponsorship channels documented on the website:
 
-**[Support Xeno](https://www.xeno-js.it/support-us)**
+**[Support Xeno](https://www.xeno-js.it/docs/support-us)**
 
 ---
 

package/dist/index.cjs

@@ -2419,9 +2419,7 @@ var init_cockatiel_resilience_factory = __esm({
           }
         }
         if (isNetworkError) return true;
-        if (import_shared53.Guards.isDefined(status)) {
-          return status === 408 || status === 429 || status >= 500 && status < 600;
-        }
+        if (import_shared53.Guards.isDefined(status)) return status === 408 || status >= 500 && status < 600;
         return false;
       }
       isTransientAndIdempotent(error) {
@@ -3324,8 +3322,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);
@@ -3875,7 +3873,7 @@ var init_rate_limiter_middleware = __esm({
               error: {
                 code: import_shared69.ERROR_CODES.TOO_MANY_REQUESTS,
                 message: import_shared69.ERROR_CODE_MESSAGES[import_shared69.ERROR_CODES.TOO_MANY_REQUESTS],
-                details: `Rate limit exceeded. Key ${cacheKey} throttled.`,
+                details: `Rate limit exceeded.`,
                 path: req.path
               },
               correlationId: tracing?.correlationId ?? import_shared69.GuidHelper.generate(),
@@ -4598,6 +4596,7 @@ var isDisposable = Object.freeze({
 var AppBuilder = class {
   _container = new ServiceContainer();
   _configuration;
+  _isBuilded = false;
   constructor(container) {
     this._container = container ?? new ServiceContainer();
     this._container.addSingleton(
@@ -4965,6 +4964,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) {
@@ -4985,6 +4985,7 @@ var AppBuilder = class {
       }
     }
     console.info("\u2705 Application modules bootstrapped successfully.");
+    this._isBuilded = true;
     return this._container;
   }
   // ─────────────────────────────────────────────────────────────────────────────