stratal 0.0.12 → 0.0.14

package/dist/websocket/index.d.mts

@@ -0,0 +1,168 @@
+import { Et as ControllerOptions, Nt as RouterEnv, Tt as RouterContext, s as ApplicationError, wt as ContextQueryResult } from "../index-C9bIk5tt.mjs";
+import { t as Constructor } from "../types-JUIHSW_a.mjs";
+import { Context } from "hono";
+import { WSContext, WSContext as WSContext$1, WSEvents, WSMessageReceive, WSReadyState, WSReadyState as WSReadyState$1 } from "hono/ws";
+
+//#region src/websocket/types.d.ts
+/**
+ * Gateway options for @Gateway() decorator
+ * Subset of ControllerOptions relevant to WebSocket gateways (no OpenAPI-specific fields)
+ */
+type GatewayOptions = Pick<ControllerOptions, 'version'>;
+//#endregion
+//#region src/websocket/decorators/gateway.decorator.d.ts
+/**
+ * Gateway decorator for WebSocket route registration
+ *
+ * Marks a class as a WebSocket gateway and stores route metadata.
+ * Reuses the same metadata key as @Controller for middleware compatibility —
+ * `getControllerRoute()`, `forRoutes()`, and the entire middleware system work
+ * with zero changes.
+ *
+ * @param route - WebSocket route path (e.g., '/ws/chat')
+ *
+ * @example
+ * ```typescript
+ * import { type GatewayContext, Gateway, OnMessage, OnClose } from 'stratal/websocket'
+ *
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnMessage()
+ *   handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *     ctx.send('ack')
+ *   }
+ *
+ *   @OnClose()
+ *   handleClose(evt: CloseEvent, ctx: GatewayContext) {
+ *     console.log('closed')
+ *   }
+ * }
+ * ```
+ */
+declare function Gateway(route: string, options?: GatewayOptions): <T extends Constructor>(target: T) => T;
+/**
+ * Check if a class is a WebSocket gateway
+ *
+ * @param target - Class constructor or instance
+ * @returns true if the class is decorated with @Gateway
+ */
+declare function isGateway(target: object): boolean;
+//#endregion
+//#region src/websocket/decorators/ws-event.decorator.d.ts
+/**
+ * Marks a method as the WebSocket message handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnMessage()
+ *   handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *     ctx.send(evt.data)
+ *   }
+ * }
+ * ```
+ */
+declare function OnMessage(): MethodDecorator;
+/**
+ * Marks a method as the WebSocket close handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnClose()
+ *   handleClose(evt: CloseEvent, ctx: GatewayContext) {
+ *     console.log('closed')
+ *   }
+ * }
+ * ```
+ */
+declare function OnClose(): MethodDecorator;
+/**
+ * Marks a method as the WebSocket error handler
+ *
+ * @example
+ * ```typescript
+ * @Gateway('/ws/chat')
+ * class ChatGateway {
+ *   @OnError()
+ *   handleError(evt: Event, ctx: GatewayContext) {
+ *     console.error('WebSocket error', evt)
+ *   }
+ * }
+ * ```
+ */
+declare function OnError(): MethodDecorator;
+/**
+ * Get the method name decorated with @OnMessage
+ */
+declare function getWsOnMessageMethod(target: Constructor): string | undefined;
+/**
+ * Get the method name decorated with @OnClose
+ */
+declare function getWsOnCloseMethod(target: Constructor): string | undefined;
+/**
+ * Get the method name decorated with @OnError
+ */
+declare function getWsOnErrorMethod(target: Constructor): string | undefined;
+//#endregion
+//#region src/websocket/errors/websocket-body-not-available.error.d.ts
+declare class WebSocketBodyNotAvailableError extends ApplicationError {
+  constructor();
+}
+//#endregion
+//#region src/websocket/errors/websocket-duplicate-event-handler.error.d.ts
+declare class WebSocketDuplicateEventHandlerError extends ApplicationError {
+  constructor(decorator: string, existingMethod: string);
+}
+//#endregion
+//#region src/websocket/gateway-context.d.ts
+/**
+ * WebSocket gateway context
+ *
+ * Extends RouterContext with WebSocket-specific methods.
+ * Inherits `getContainer()`, `param()`, `query()`, `header()`, `getLocale()`
+ * from RouterContext. HTTP response methods (`json()`, `redirect()`, etc.) are
+ * inherited but harmless post-upgrade.
+ *
+ * @example
+ * ```typescript
+ * @OnMessage()
+ * handleMessage(evt: MessageEvent, ctx: GatewayContext) {
+ *   ctx.send('ack')           // convenience method
+ *   ctx.header('Authorization') // upgrade request headers
+ * }
+ * ```
+ */
+declare class GatewayContext extends RouterContext {
+  readonly ws: WSContext$1;
+  constructor(c: Context<RouterEnv>, ws: WSContext$1);
+  /** Send data through the WebSocket connection */
+  send(data: string | ArrayBuffer | Uint8Array<ArrayBuffer>): void;
+  /** Close the WebSocket connection */
+  close(code?: number, reason?: string): void;
+  /** Current WebSocket ready state */
+  get readyState(): WSReadyState$1;
+  /**
+   * Get route parameter value from the raw request (no OpenAPI validation)
+   *
+   * @param key - Parameter name (e.g., 'id' for /ws/chat/:id)
+   */
+  param(key: string): string;
+  /**
+   * Get query parameter value from the raw request (no OpenAPI validation)
+   *
+   * @param key - Query parameter name
+   */
+  query<R extends Record<string, unknown> | undefined = undefined, K extends string | undefined = undefined>(key?: K): ContextQueryResult<R, K>;
+  /**
+   * Request body is not available in WebSocket gateways
+   *
+   * @throws WebSocketBodyNotAvailableError always — WebSocket upgrade requests do not have a body
+   */
+  body<T>(): Promise<T>;
+}
+//#endregion
+export { Gateway, GatewayContext, type GatewayOptions, OnClose, OnError, OnMessage, type WSContext, type WSEvents, type WSMessageReceive, type WSReadyState, WebSocketBodyNotAvailableError, WebSocketDuplicateEventHandlerError, getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, isGateway };
+//# sourceMappingURL=index.d.mts.map

package/dist/websocket/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/websocket/types.ts","../../src/websocket/decorators/gateway.decorator.ts","../../src/websocket/decorators/ws-event.decorator.ts","../../src/websocket/errors/websocket-body-not-available.error.ts","../../src/websocket/errors/websocket-duplicate-event-handler.error.ts","../../src/websocket/gateway-context.ts"],"mappings":";;;;;;;;;;KAMY,cAAA,GAAiB,IAAA,CAAK,iBAAA;;;;;;;;AAAlC;;;;;;;;AC+BA;;;;;;;;;;;;;;;iBAAgB,OAAA,CAAQ,KAAA,UAAe,OAAA,GAAU,cAAA,cACpB,WAAA,EAAa,MAAA,EAAQ,CAAA,KAAC,CAAA;;;;AAiBnD;;;iBAAgB,SAAA,CAAU,MAAA;;;;;;;;;ADjD1B;;;;;;;;iBE4BgB,SAAA,CAAA,GAAa,eAAA;;;;;;;;;;;;;;;iBAsBb,OAAA,CAAA,GAAW,eAAA;;;;ADD3B;;;;;;;;ACrBA;;;iBA0CgB,OAAA,CAAA,GAAW,eAAA;;AApB3B;;iBA6BgB,oBAAA,CAAqB,MAAA,EAAQ,WAAA;;;AAT7C;iBAgBgB,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;;iBAO3B,kBAAA,CAAmB,MAAA,EAAQ,WAAA;;;cCjG9B,8BAAA,SAAuC,gBAAA;EAAA,WAAA,CAAA;AAAA;;;cCAvC,mCAAA,SAA4C,gBAAA;cAC3C,SAAA,UAAmB,cAAA;AAAA;;;;;AJGjC;;;;;;;;AC+BA;;;;;;;cIba,cAAA,SAAuB,aAAA;EAAA,SACiB,EAAA,EAAI,WAAA;cAA3C,CAAA,EAAG,OAAA,CAAQ,SAAA,GAA4B,EAAA,EAAI,WAAA;EJYR;EIP/C,IAAA,CAAK,IAAA,WAAe,WAAA,GAAc,UAAA,CAAW,WAAA;EJQ5B;EIHjB,KAAA,CAAM,IAAA,WAAe,MAAA;EJG2B;EAAA,IIE5C,UAAA,CAAA,GAAc,cAAA;EJF+B;;;AAiBnD;;EINW,KAAA,CAAM,GAAA;EJMS;;;;;EIGf,KAAA,WAAgB,MAAA,oFAAA,CAA2F,GAAA,GAAM,CAAA,GAAI,kBAAA,CAAmB,CAAA,EAAG,CAAA;EHxB7H;;;;AAsBzB;EGcW,IAAA,GAAA,CAAA,GAAW,OAAA,CAAQ,CAAA;AAAA"}

package/dist/websocket/index.mjs

@@ -0,0 +1,5 @@
+import "../errors-BRJgVd5-.mjs";
+import "../logger-Bg-CuidS.mjs";
+import "../router-context-DlTxpJUG.mjs";
+import { a as OnMessage, c as getWsOnMessageMethod, d as isGateway, i as OnError, l as WebSocketDuplicateEventHandlerError, n as WebSocketBodyNotAvailableError, o as getWsOnCloseMethod, r as OnClose, s as getWsOnErrorMethod, t as GatewayContext, u as Gateway } from "../gateway-context-D7TFPLi5.mjs";
+export { Gateway, GatewayContext, OnClose, OnError, OnMessage, WebSocketBodyNotAvailableError, WebSocketDuplicateEventHandlerError, getWsOnCloseMethod, getWsOnErrorMethod, getWsOnMessageMethod, isGateway };

package/dist/workers/index.d.mts

@@ -0,0 +1,90 @@
+import { $t as Container, Ht as StratalEnv } from "../index-C9bIk5tt.mjs";
+import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
+
+//#region src/workers/run-in-scope.d.ts
+/**
+ * Shared helper that creates a request-scoped DI container by accessing the
+ * Stratal Application via the static singleton.
+ *
+ * Works with Durable Objects, Workflows, and WorkerEntrypoints.
+ */
+declare function runInScope<T>(callback: (container: Container) => T | Promise<T>): Promise<T>;
+//#endregion
+//#region src/workers/stratal-durable-object.d.ts
+/**
+ * Base class for Durable Objects with full DI access.
+ *
+ * Extends Cloudflare's `DurableObject` and provides a `runInScope()` helper
+ * that creates a request-scoped container with `DurableObjectState` and
+ * `DurableObjectId` tokens registered.
+ *
+ * @example
+ * ```typescript
+ * import { StratalDurableObject } from 'stratal/workers'
+ *
+ * export class Counter extends StratalDurableObject {
+ *   async increment() {
+ *     return this.runInScope(async (container) => {
+ *       const svc = container.resolve(CounterService)
+ *       return svc.increment()
+ *     })
+ *   }
+ * }
+ * ```
+ */
+declare abstract class StratalDurableObject<Env extends StratalEnv = StratalEnv> extends DurableObject<Env> {
+  protected runInScope<T>(callback: (container: Container) => T | Promise<T>): Promise<T>;
+}
+//#endregion
+//#region src/workers/stratal-worker-entrypoint.d.ts
+/**
+ * Base class for Cloudflare WorkerEntrypoints (Service Bindings / RPC) with full DI access.
+ *
+ * Extends Cloudflare's `WorkerEntrypoint` and provides a `runInScope()` helper
+ * that creates a request-scoped DI container.
+ *
+ * @example
+ * ```typescript
+ * import { StratalWorkerEntrypoint } from 'stratal/workers'
+ *
+ * export class AuthRpc extends StratalWorkerEntrypoint {
+ *   async verifyToken(token: string) {
+ *     return this.runInScope(async (container) => {
+ *       const auth = container.resolve(AuthService)
+ *       return auth.verify(token)
+ *     })
+ *   }
+ * }
+ * ```
+ */
+declare abstract class StratalWorkerEntrypoint<Env extends StratalEnv = StratalEnv> extends WorkerEntrypoint<Env> {
+  protected runInScope<T>(callback: (container: Container) => T | Promise<T>): Promise<T>;
+}
+//#endregion
+//#region src/workers/stratal-workflow.d.ts
+/**
+ * Base class for Cloudflare Workflows with full DI access.
+ *
+ * Extends Cloudflare's `WorkflowEntrypoint` and provides a `runInScope()` helper
+ * that creates a request-scoped DI container.
+ *
+ * @example
+ * ```typescript
+ * import { StratalWorkflow } from 'stratal/workers'
+ *
+ * export class MyWorkflow extends StratalWorkflow<Env, { userId: string }> {
+ *   async run(event: WorkflowEvent<{ userId: string }>, step: WorkflowStep) {
+ *     await this.runInScope(async (container) => {
+ *       const svc = container.resolve(UserService)
+ *       await svc.process(event.payload.userId)
+ *     })
+ *   }
+ * }
+ * ```
+ */
+declare abstract class StratalWorkflow<Env extends StratalEnv = StratalEnv, Params = unknown> extends WorkflowEntrypoint<Env, Params> {
+  protected runInScope<T>(callback: (container: Container) => T | Promise<T>): Promise<T>;
+}
+//#endregion
+export { StratalDurableObject, StratalWorkerEntrypoint, StratalWorkflow, runInScope };
+//# sourceMappingURL=index.d.mts.map

package/dist/workers/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"mappings":";;;;;;;;AASA;;iBAAsB,UAAA,GAAA,CACpB,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;;;;;AAFX;;;;;;;;;;;;;;;;;;;uBCkBsB,oBAAA,aACR,UAAA,GAAa,UAAA,UACjB,aAAA,CAAc,GAAA;EAAA,UACN,UAAA,GAAA,CACd,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;;ADvBb;;;;;;;;;;;;;;;;;;uBEgBsB,uBAAA,aACR,UAAA,GAAa,UAAA,UACjB,gBAAA,CAAiB,GAAA;EAAA,UACf,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA;;;;;AFrBb;;;;;;;;;;;;;;;;;;uBGgBsB,eAAA,aACR,UAAA,GAAa,UAAA,4BAEjB,kBAAA,CAAmB,GAAA,EAAK,MAAA;EAAA,UACtB,UAAA,GAAA,CACR,QAAA,GAAW,SAAA,EAAW,SAAA,KAAc,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC/C,OAAA,CAAQ,CAAA;AAAA"}

package/dist/workers/index.mjs

@@ -0,0 +1,116 @@
+import "../errors-BRJgVd5-.mjs";
+import { g as DI_TOKENS } from "../logger-Bg-CuidS.mjs";
+import "../module-Dvzm4dhS.mjs";
+import "../events-CQyvSyrQ.mjs";
+import "../middleware-B3tx1u1K.mjs";
+import "../router-context-DlTxpJUG.mjs";
+import "../cron-manager-CpS_hrDD.mjs";
+import "../validation-DA5nptIp.mjs";
+import "../i18n.module-C9wQr_2k.mjs";
+import "../guards-B5o618bL.mjs";
+import "../gateway-context-D7TFPLi5.mjs";
+import "../queue.module-ZqaZ2iY0.mjs";
+import { t as Stratal } from "../stratal-D4MS_7pI.mjs";
+import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
+//#region src/workers/run-in-scope.ts
+/**
+* Shared helper that creates a request-scoped DI container by accessing the
+* Stratal Application via the static singleton.
+*
+* Works with Durable Objects, Workflows, and WorkerEntrypoints.
+*/
+async function runInScope(callback) {
+	const app = await Stratal.resolveApplication();
+	const mockCtx = app.createMockRouterContext("en");
+	return app.container.runInRequestScope(mockCtx, callback);
+}
+//#endregion
+//#region src/workers/stratal-durable-object.ts
+/**
+* Base class for Durable Objects with full DI access.
+*
+* Extends Cloudflare's `DurableObject` and provides a `runInScope()` helper
+* that creates a request-scoped container with `DurableObjectState` and
+* `DurableObjectId` tokens registered.
+*
+* @example
+* ```typescript
+* import { StratalDurableObject } from 'stratal/workers'
+*
+* export class Counter extends StratalDurableObject {
+*   async increment() {
+*     return this.runInScope(async (container) => {
+*       const svc = container.resolve(CounterService)
+*       return svc.increment()
+*     })
+*   }
+* }
+* ```
+*/
+var StratalDurableObject = class extends DurableObject {
+	async runInScope(callback) {
+		return runInScope(async (requestContainer) => {
+			requestContainer.registerValue(DI_TOKENS.DurableObjectState, this.ctx);
+			requestContainer.registerValue(DI_TOKENS.DurableObjectId, this.ctx.id);
+			return callback(requestContainer);
+		});
+	}
+};
+//#endregion
+//#region src/workers/stratal-worker-entrypoint.ts
+/**
+* Base class for Cloudflare WorkerEntrypoints (Service Bindings / RPC) with full DI access.
+*
+* Extends Cloudflare's `WorkerEntrypoint` and provides a `runInScope()` helper
+* that creates a request-scoped DI container.
+*
+* @example
+* ```typescript
+* import { StratalWorkerEntrypoint } from 'stratal/workers'
+*
+* export class AuthRpc extends StratalWorkerEntrypoint {
+*   async verifyToken(token: string) {
+*     return this.runInScope(async (container) => {
+*       const auth = container.resolve(AuthService)
+*       return auth.verify(token)
+*     })
+*   }
+* }
+* ```
+*/
+var StratalWorkerEntrypoint = class extends WorkerEntrypoint {
+	runInScope(callback) {
+		return runInScope(callback);
+	}
+};
+//#endregion
+//#region src/workers/stratal-workflow.ts
+/**
+* Base class for Cloudflare Workflows with full DI access.
+*
+* Extends Cloudflare's `WorkflowEntrypoint` and provides a `runInScope()` helper
+* that creates a request-scoped DI container.
+*
+* @example
+* ```typescript
+* import { StratalWorkflow } from 'stratal/workers'
+*
+* export class MyWorkflow extends StratalWorkflow<Env, { userId: string }> {
+*   async run(event: WorkflowEvent<{ userId: string }>, step: WorkflowStep) {
+*     await this.runInScope(async (container) => {
+*       const svc = container.resolve(UserService)
+*       await svc.process(event.payload.userId)
+*     })
+*   }
+* }
+* ```
+*/
+var StratalWorkflow = class extends WorkflowEntrypoint {
+	runInScope(callback) {
+		return runInScope(callback);
+	}
+};
+//#endregion
+export { StratalDurableObject, StratalWorkerEntrypoint, StratalWorkflow, runInScope };
+
+//# sourceMappingURL=index.mjs.map

package/dist/workers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/workers/run-in-scope.ts","../../src/workers/stratal-durable-object.ts","../../src/workers/stratal-worker-entrypoint.ts","../../src/workers/stratal-workflow.ts"],"sourcesContent":["import type { Container } from '../di/container'\nimport { Stratal } from '../stratal'\n\n/**\n * Shared helper that creates a request-scoped DI container by accessing the\n * Stratal Application via the static singleton.\n *\n * Works with Durable Objects, Workflows, and WorkerEntrypoints.\n */\nexport async function runInScope<T>(\n  callback: (container: Container) => T | Promise<T>\n): Promise<T> {\n  const app = await Stratal.resolveApplication()\n  const mockCtx = app.createMockRouterContext('en')\n  return app.container.runInRequestScope(mockCtx, callback)\n}\n","import { DurableObject } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Durable Objects with full DI access.\n *\n * Extends Cloudflare's `DurableObject` and provides a `runInScope()` helper\n * that creates a request-scoped container with `DurableObjectState` and\n * `DurableObjectId` tokens registered.\n *\n * @example\n * ```typescript\n * import { StratalDurableObject } from 'stratal/workers'\n *\n * export class Counter extends StratalDurableObject {\n *   async increment() {\n *     return this.runInScope(async (container) => {\n *       const svc = container.resolve(CounterService)\n *       return svc.increment()\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalDurableObject<\n  Env extends StratalEnv = StratalEnv\n> extends DurableObject<Env> {\n  protected async runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(async (requestContainer) => {\n      requestContainer.registerValue(DI_TOKENS.DurableObjectState, this.ctx)\n      requestContainer.registerValue(DI_TOKENS.DurableObjectId, this.ctx.id)\n      return callback(requestContainer)\n    })\n  }\n}\n","import { WorkerEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare WorkerEntrypoints (Service Bindings / RPC) with full DI access.\n *\n * Extends Cloudflare's `WorkerEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkerEntrypoint } from 'stratal/workers'\n *\n * export class AuthRpc extends StratalWorkerEntrypoint {\n *   async verifyToken(token: string) {\n *     return this.runInScope(async (container) => {\n *       const auth = container.resolve(AuthService)\n *       return auth.verify(token)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkerEntrypoint<\n  Env extends StratalEnv = StratalEnv\n> extends WorkerEntrypoint<Env> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n","import { WorkflowEntrypoint } from 'cloudflare:workers'\nimport type { Container } from '../di/container'\nimport type { StratalEnv } from '../env'\nimport { runInScope } from './run-in-scope'\n\n/**\n * Base class for Cloudflare Workflows with full DI access.\n *\n * Extends Cloudflare's `WorkflowEntrypoint` and provides a `runInScope()` helper\n * that creates a request-scoped DI container.\n *\n * @example\n * ```typescript\n * import { StratalWorkflow } from 'stratal/workers'\n *\n * export class MyWorkflow extends StratalWorkflow<Env, { userId: string }> {\n *   async run(event: WorkflowEvent<{ userId: string }>, step: WorkflowStep) {\n *     await this.runInScope(async (container) => {\n *       const svc = container.resolve(UserService)\n *       await svc.process(event.payload.userId)\n *     })\n *   }\n * }\n * ```\n */\nexport abstract class StratalWorkflow<\n  Env extends StratalEnv = StratalEnv,\n  Params = unknown\n> extends WorkflowEntrypoint<Env, Params> {\n  protected runInScope<T>(\n    callback: (container: Container) => T | Promise<T>\n  ): Promise<T> {\n    return runInScope(callback)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AASA,eAAsB,WACpB,UACY;CACZ,MAAM,MAAM,MAAM,QAAQ,oBAAoB;CAC9C,MAAM,UAAU,IAAI,wBAAwB,KAAK;AACjD,QAAO,IAAI,UAAU,kBAAkB,SAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACa3D,IAAsB,uBAAtB,cAEU,cAAmB;CAC3B,MAAgB,WACd,UACY;AACZ,SAAO,WAAW,OAAO,qBAAqB;AAC5C,oBAAiB,cAAc,UAAU,oBAAoB,KAAK,IAAI;AACtE,oBAAiB,cAAc,UAAU,iBAAiB,KAAK,IAAI,GAAG;AACtE,UAAO,SAAS,iBAAiB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;ACZN,IAAsB,0BAAtB,cAEU,iBAAsB;CAC9B,WACE,UACY;AACZ,SAAO,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACN/B,IAAsB,kBAAtB,cAGU,mBAAgC;CACxC,WACE,UACY;AACZ,SAAO,WAAW,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratal",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration",
   "type": "module",
   "license": "MIT",
@@ -39,34 +39,93 @@
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.mts",
+      "import": "./dist/cache/index.mjs"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.mts",
+      "import": "./dist/config/index.mjs"
+    },
+    "./cron": {
+      "types": "./dist/cron/index.d.mts",
+      "import": "./dist/cron/index.mjs"
+    },
+    "./di": {
+      "types": "./dist/di/index.d.mts",
+      "import": "./dist/di/index.mjs"
+    },
+    "./email": {
+      "types": "./dist/email/index.d.mts",
+      "import": "./dist/email/index.mjs"
     },
     "./errors": {
-      "types": "./dist/errors/index.d.ts",
-      "import": "./dist/errors/index.js"
+      "types": "./dist/errors/index.d.mts",
+      "import": "./dist/errors/index.mjs"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.mts",
+      "import": "./dist/events/index.mjs"
+    },
+    "./guards": {
+      "types": "./dist/guards/index.d.mts",
+      "import": "./dist/guards/index.mjs"
     },
     "./i18n": {
-      "types": "./dist/i18n/index.d.ts",
-      "import": "./dist/i18n/index.js"
+      "types": "./dist/i18n/index.d.mts",
+      "import": "./dist/i18n/index.mjs"
     },
     "./i18n/messages/en": {
-      "types": "./dist/i18n/messages/en/index.d.ts",
-      "import": "./dist/i18n/messages/en/index.js"
+      "types": "./dist/i18n/messages/en/index.d.mts",
+      "import": "./dist/i18n/messages/en/index.mjs"
     },
-    "./validation": {
-      "types": "./dist/i18n/validation/index.d.ts",
-      "import": "./dist/i18n/validation/index.js"
+    "./logger": {
+      "types": "./dist/logger/index.d.mts",
+      "import": "./dist/logger/index.mjs"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.mts",
+      "import": "./dist/middleware/index.mjs"
     },
-    "./*": {
-      "types": "./dist/*/index.d.ts",
-      "import": "./dist/*/index.js"
+    "./module": {
+      "types": "./dist/module/index.d.mts",
+      "import": "./dist/module/index.mjs"
+    },
+    "./openapi": {
+      "types": "./dist/openapi/index.d.mts",
+      "import": "./dist/openapi/index.mjs"
+    },
+    "./queue": {
+      "types": "./dist/queue/index.d.mts",
+      "import": "./dist/queue/index.mjs"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.mts",
+      "import": "./dist/router/index.mjs"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.mts",
+      "import": "./dist/storage/index.mjs"
+    },
+    "./websocket": {
+      "types": "./dist/websocket/index.d.mts",
+      "import": "./dist/websocket/index.mjs"
+    },
+    "./workers": {
+      "types": "./dist/workers/index.d.mts",
+      "import": "./dist/workers/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./validation": {
+      "types": "./dist/i18n/validation/index.d.mts",
+      "import": "./dist/i18n/validation/index.mjs"
     }
   },
   "scripts": {
-    "build": "yarn prebuild && tsc -p tsconfig.build.json",
-    "clean": "rm -rf dist",
-    "prebuild": "yarn clean",
+    "build": "tsdown",
     "typecheck": "yarn tsc --noEmit",
     "bench": "vitest bench --run",
     "bench:unit": "vitest bench --run --project unit",
@@ -80,10 +139,10 @@
     "lint:fix": "npx eslint --fix ."
   },
   "dependencies": {
+    "@hono/swagger-ui": "^0.6.1",
     "@hono/zod-openapi": "^1.2.2",
     "@intlify/core-base": "^11.3.0",
     "@intlify/message-compiler": "^11.3.0",
-    "@scalar/hono-api-reference": "^0.10.3",
     "@xmldom/xmldom": "^0.8.11",
     "hono": "^4.12.8",
     "reflect-metadata": "^0.2.2",
@@ -131,12 +190,12 @@
     }
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "3.1009.0",
-    "@aws-sdk/lib-storage": "^3.1009.0",
-    "@aws-sdk/s3-request-presigner": "3.1009.0",
-    "@cloudflare/vitest-pool-workers": "patch:@cloudflare/vitest-pool-workers@npm%3A0.13.0#~/.yarn/patches/@cloudflare-vitest-pool-workers-npm-0.13.0-47105599c6.patch",
-    "@cloudflare/workers-types": "4.20260313.1",
-    "@react-email/components": "^1.0.9",
+    "@aws-sdk/client-s3": "3.1011.0",
+    "@aws-sdk/lib-storage": "^3.1011.0",
+    "@aws-sdk/s3-request-presigner": "3.1011.0",
+    "@cloudflare/vitest-pool-workers": "^0.13.2",
+    "@cloudflare/workers-types": "4.20260317.1",
+    "@react-email/components": "^1.0.10",
     "@stratal/testing": "workspace:*",
     "@tus/server": "^2.3.0",
     "@types/node": "^25.5.0",
@@ -149,7 +208,8 @@
     "nodemailer": "^8.0.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "resend": "^6.9.3",
+    "resend": "^6.9.4",
+    "tsdown": "^0.21.4",
     "typescript": "^5.9.3",
     "vitest": "~4.1.0"
   }

package/dist/application.d.ts

@@ -1,101 +0,0 @@
-import { Container } from './di/container';
-import { type StratalEnv } from './env';
-import type { StratalExecutionContext } from './execution-context';
-import { LogLevel } from './logger';
-import type { DynamicModule, ModuleClass } from './module/types';
-import { type RouterContext } from './router';
-import { HonoApp } from './router/hono-app';
-import type { VersioningOptions } from './router/types';
-export interface ApplicationConfig {
-    /** Root application module */
-    module: ModuleClass | DynamicModule;
-    /** Logging configuration. Defaults: level=INFO, formatter='json' */
-    logging?: {
-        level?: LogLevel;
-        formatter?: 'json' | 'pretty';
-    };
-    /**
-     * API versioning configuration.
-     * When provided, enables URI-based versioning for controllers.
-     */
-    versioning?: VersioningOptions;
-}
-export interface ApplicationOptions extends ApplicationConfig {
-    env: StratalEnv;
-    ctx: StratalExecutionContext;
-}
-/**
- * Application
- *
- * Main application class managing the two-tier container hierarchy:
- * - Global Container: All services (singletons via tsyringe native)
- * - Request Container: Child of global, context-enriched instances per request
- *
- * @example
- * ```typescript
- * const app = new Application({ module: AppModule, env, ctx })
- * await app.initialize()
- *
- * // Access container via getter
- * const service = app.container.resolve(MY_TOKEN)
- *
- * // Handle HTTP request (via HonoApp)
- * // Handle queue batch
- * await app.handleQueue(batch, 'my-queue')
- * ```
- */
-export declare class Application {
-    /**
-     * Unified Container - manages all DI operations
-     */
-    private _container;
-    private honoApp;
-    private moduleRegistry;
-    private consumerRegistry;
-    private cronManager;
-    private initialized;
-    readonly env: StratalEnv;
-    private readonly appConfig;
-    constructor({ env, ctx, ...config }: ApplicationOptions);
-    /**
-     * Get the Container instance
-     */
-    get container(): Container;
-    /**
-     * Get the HonoApp instance
-     */
-    get hono(): HonoApp;
-    initialize(): Promise<void>;
-    /**
-     * Resolve a service from the container
-     */
-    resolve<T>(token: symbol): T;
-    /**
-     * Handle queue batch processing
-     */
-    handleQueue(batch: MessageBatch, queueName: string): Promise<void>;
-    /**
-     * Handle scheduled cron trigger
-     */
-    handleScheduled(controller: ScheduledController): Promise<void>;
-    /**
-     * Create mock RouterContext for queue/cron/seeder processing
-     */
-    createMockRouterContext(locale?: string): RouterContext;
-    shutdown(): Promise<void>;
-    private registerQueueConsumers;
-    private registerCronJobs;
-    /**
-     * Auto-wire `@Listener()` classes with the EventRegistry.
-     */
-    private registerEventListeners;
-    /**
-     * Register LoggerService and dependencies
-     */
-    private registerLoggerService;
-    /**
-     * Register core services with explicit scope
-     */
-    private registerCoreServices;
-}
-//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAA;AAIvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAiE,QAAQ,EAAmB,MAAM,UAAU,CAAA;AAEnH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAMhE,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,MAAM,EAAE,WAAW,GAAG,aAAa,CAAA;IACnC,oEAAoE;IACpE,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,QAAQ,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAC9B,CAAA;IACD;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,GAAG,EAAE,UAAU,CAAA;IACf,GAAG,EAAE,uBAAuB,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,UAAU,CAAW;IAE7B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAQ;IAE3B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,kBAAkB;IA4BvD;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CAElB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCjC;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC;IAU5B;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE;;OAEG;IACH,uBAAuB,CAAC,MAAM,SAAO,GAAG,aAAa;IAQ/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAK7B"}