stratal 0.0.1

package/dist/storage/storage.module.js

@@ -0,0 +1,81 @@
+/**
+ * Storage Module
+ * Provides file storage capabilities using AWS S3
+ * Supports multiple disk configurations with tenant-aware path templates
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var StorageModule_1;
+import { Module } from '../module';
+import { StorageManagerService } from './services/storage-manager.service';
+import { StorageService } from './services/storage.service';
+import { STORAGE_TOKENS } from './storage.tokens';
+let StorageModule = StorageModule_1 = class StorageModule {
+    /**
+     * Configure StorageModule with static options
+     *
+     * @param options - Storage configuration options
+     * @returns Dynamic module with storage infrastructure
+     *
+     * @example
+     * ```typescript
+     * StorageModule.forRoot({
+     *   storage: [{ disk: 'uploads', provider: 's3', ... }],
+     *   defaultStorageDisk: 'uploads',
+     *   presignedUrl: { defaultExpiry: 3600, maxExpiry: 86400 }
+     * })
+     * ```
+     */
+    static forRoot(options) {
+        return {
+            module: StorageModule_1,
+            providers: [
+                { provide: STORAGE_TOKENS.Options, useValue: options },
+            ],
+        };
+    }
+    /**
+     * Configure StorageModule with async factory
+     *
+     * Use when configuration depends on other services.
+     *
+     * @param options - Async configuration with factory and inject tokens
+     * @returns Dynamic module with storage infrastructure
+     *
+     * @example
+     * ```typescript
+     * StorageModule.forRootAsync({
+     *   inject: [storageConfig.KEY],
+     *   useFactory: (storage) => ({
+     *     storage: storage.storage,
+     *     defaultStorageDisk: storage.defaultStorageDisk,
+     *     presignedUrl: storage.presignedUrl
+     *   })
+     * })
+     * ```
+     */
+    static forRootAsync(options) {
+        return {
+            module: StorageModule_1,
+            providers: [
+                {
+                    provide: STORAGE_TOKENS.Options,
+                    useFactory: options.useFactory,
+                    inject: options.inject,
+                },
+            ],
+        };
+    }
+};
+StorageModule = StorageModule_1 = __decorate([
+    Module({
+        providers: [{ provide: STORAGE_TOKENS.StorageManager, useClass: StorageManagerService },
+            { provide: STORAGE_TOKENS.StorageService, useClass: StorageService },],
+    })
+], StorageModule);
+export { StorageModule };
+//# sourceMappingURL=storage.module.js.map

package/dist/storage/storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.js","sourceRoot":"","sources":["../../src/storage/storage.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAa1C,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,OAA6B;QAC1C,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE;aACvD;SACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAiD;QACnE,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,cAAc,CAAC,OAAO;oBAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;aACF;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAzDY,aAAa;IAJzB,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,qBAAqB,EAAE;YACvF,EAAE,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE;KACvE,CAAC;GACW,aAAa,CAyDzB"}

package/dist/storage/storage.tokens.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Dependency injection tokens for the Storage module
+ * Using Symbol-based tokens to avoid magic strings
+ */
+export declare const STORAGE_TOKENS: {
+    readonly Options: symbol;
+    readonly StorageService: symbol;
+    readonly StorageManager: symbol;
+};
+//# sourceMappingURL=storage.tokens.d.ts.map

package/dist/storage/storage.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.tokens.d.ts","sourceRoot":"","sources":["../../src/storage/storage.tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAA"}

package/dist/storage/storage.tokens.js

@@ -0,0 +1,10 @@
+/**
+ * Dependency injection tokens for the Storage module
+ * Using Symbol-based tokens to avoid magic strings
+ */
+export const STORAGE_TOKENS = {
+    Options: Symbol.for('StorageModuleOptions'),
+    StorageService: Symbol.for('StorageService'),
+    StorageManager: Symbol.for('StorageManager'),
+};
+//# sourceMappingURL=storage.tokens.js.map

package/dist/storage/storage.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.tokens.js","sourceRoot":"","sources":["../../src/storage/storage.tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;CACpC,CAAA"}

package/dist/storage/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Storage entry configuration
+ * Represents a single storage disk with its credentials
+ */
+export interface StorageEntry {
+    disk: string;
+    provider: 's3' | 'gcs';
+    endpoint: string;
+    bucket: string;
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    root: string;
+    visibility: 'public' | 'private';
+}
+/**
+ * Presigned URL configuration
+ */
+export interface PresignedUrlConfig {
+    defaultExpiry: number;
+    maxExpiry: number;
+}
+/**
+ * Storage configuration used by framework
+ */
+export interface StorageConfig {
+    storage: StorageEntry[];
+    defaultStorageDisk: string;
+    presignedUrl: PresignedUrlConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,kBAAkB,CAAA;CAChC"}

package/dist/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic type for class constructors
+ *
+ * Represents a class that can be instantiated with any arguments.
+ * Useful for dependency injection and dynamic class resolution.
+ *
+ * @example
+ * ```typescript
+ * const controllers: Constructor<Controller>[] = [
+ *   UsersController,
+ *   ProductsController
+ * ]
+ * ```
+ */
+export type Constructor<T extends object = object> = new (...args: any[]) => T;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/worker/index.d.ts

@@ -0,0 +1,2 @@
+export { StratalWorker } from './stratal-worker';
+//# sourceMappingURL=index.d.ts.map

package/dist/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/worker/index.js

@@ -0,0 +1,2 @@
+export { StratalWorker } from './stratal-worker';
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/worker/module-worker.d.ts

@@ -0,0 +1,48 @@
+import { WorkerEntrypoint } from 'cloudflare:workers';
+import type { StratalEnv } from '../env';
+import { Application, type ApplicationConfig } from '../application';
+/**
+ * Base class for Cloudflare Workers using the modules framework.
+ * Handles Application singleton management and provides default handlers.
+ *
+ * @example
+ * ```typescript
+ * export default class Backend extends ModuleWorker<Cloudflare.Env> {
+ *   protected configure() {
+ *     return {
+ *       module: AppModule,
+ *       logging: { level: LogLevel.INFO },
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ModuleWorker<Env extends StratalEnv = StratalEnv> extends WorkerEntrypoint<Env> {
+    /**
+     * Configure the Application.
+     * Access `this.env` and `this.ctx` for environment-dependent config.
+     */
+    protected abstract configure(): ApplicationConfig;
+    /**
+     * Get or initialize the Application singleton.
+     * Handles concurrent initialization guards automatically.
+     */
+    protected getApp(): Promise<Application>;
+    private initializeApp;
+    /**
+     * Handle HTTP requests via RouterService.
+     * Override for custom request handling.
+     */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Handle queue batches.
+     * Override for custom queue handling.
+     */
+    queue(batch: MessageBatch): Promise<void>;
+    /**
+     * Handle scheduled cron triggers.
+     * Override for custom scheduled handling.
+     */
+    scheduled(controller: ScheduledController): Promise<void>;
+}
+//# sourceMappingURL=module-worker.d.ts.map

package/dist/worker/module-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-worker.d.ts","sourceRoot":"","sources":["../../src/worker/module-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAapE;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,YAAY,CACjC,GAAG,SAAS,UAAU,GAAG,UAAU,CAClC,SAAQ,gBAAgB,CAAC,GAAG,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,iBAAiB;IAEjD;;;OAGG;cACa,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;YA8BhC,aAAa;IAO3B;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMhD;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;OAGG;IACG,SAAS,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/D"}

package/dist/worker/module-worker.js

@@ -0,0 +1,88 @@
+import { WorkerEntrypoint } from 'cloudflare:workers';
+import { Application } from '../application';
+import { ROUTER_TOKENS } from '../router';
+/**
+ * Per-class singleton registry
+ * Key: Worker class constructor
+ * Value: { app, promise } for singleton + concurrent init guard
+ */
+const registry = new Map();
+/**
+ * Base class for Cloudflare Workers using the modules framework.
+ * Handles Application singleton management and provides default handlers.
+ *
+ * @example
+ * ```typescript
+ * export default class Backend extends ModuleWorker<Cloudflare.Env> {
+ *   protected configure() {
+ *     return {
+ *       module: AppModule,
+ *       logging: { level: LogLevel.INFO },
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class ModuleWorker extends WorkerEntrypoint {
+    /**
+     * Get or initialize the Application singleton.
+     * Handles concurrent initialization guards automatically.
+     */
+    async getApp() {
+        const key = this.constructor;
+        let state = registry.get(key);
+        if (!state) {
+            state = { app: null, promise: null };
+            registry.set(key, state);
+        }
+        // Fast path: already initialized
+        if (state.app) {
+            return state.app;
+        }
+        // Concurrent initialization guard
+        if (state.promise) {
+            return state.promise;
+        }
+        // Start initialization
+        state.promise = this.initializeApp();
+        try {
+            state.app = await state.promise;
+            return state.app;
+        }
+        finally {
+            state.promise = null;
+        }
+    }
+    async initializeApp() {
+        const config = this.configure();
+        const app = new Application(this.env, this.ctx, config);
+        await app.initialize();
+        return app;
+    }
+    /**
+     * Handle HTTP requests via RouterService.
+     * Override for custom request handling.
+     */
+    async fetch(request) {
+        const app = await this.getApp();
+        const router = app.resolve(ROUTER_TOKENS.RouterService);
+        return router.fetch(request, this.env, this.ctx);
+    }
+    /**
+     * Handle queue batches.
+     * Override for custom queue handling.
+     */
+    async queue(batch) {
+        const app = await this.getApp();
+        return app.handleQueue(batch, batch.queue);
+    }
+    /**
+     * Handle scheduled cron triggers.
+     * Override for custom scheduled handling.
+     */
+    async scheduled(controller) {
+        const app = await this.getApp();
+        return app.handleScheduled(controller);
+    }
+}
+//# sourceMappingURL=module-worker.js.map

package/dist/worker/module-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-worker.js","sourceRoot":"","sources":["../../src/worker/module-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAA;AAE7D;;;;GAIG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAA;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAgB,YAEpB,SAAQ,gBAAqB;IAO9B;;;OAGG;IACO,KAAK,CAAC,MAAM;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAA;QAC5B,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;QAED,iCAAiC;QACjC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,GAAG,CAAA;QACjB,CAAC;QAED,kCAAkC;QAClC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,OAAO,CAAA;QACrB,CAAC;QAED,uBAAuB;QACvB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QAEpC,IAAI,CAAC;YACJ,KAAK,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAA;YAC/B,OAAO,KAAK,CAAC,GAAG,CAAA;QACjB,CAAC;gBAAS,CAAC;YACV,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACrB,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,aAAa;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACvD,MAAM,GAAG,CAAC,UAAU,EAAE,CAAA;QACtB,OAAO,GAAG,CAAA;IACX,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAgB,aAAa,CAAC,aAAa,CAAC,CAAA;QACtE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,KAAmB;QAC9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,UAA+B;QAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,OAAO,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;IACvC,CAAC;CACD"}

package/dist/worker/stratal-worker.d.ts

@@ -0,0 +1,48 @@
+import { WorkerEntrypoint } from 'cloudflare:workers';
+import type { StratalEnv } from '../env';
+import { Application, type ApplicationConfig } from '../application';
+/**
+ * Base class for Cloudflare Workers using the modules framework.
+ * Handles Application singleton management and provides default handlers.
+ *
+ * @example
+ * ```typescript
+ * export default class Backend extends StratalWorker<Cloudflare.Env> {
+ *   protected configure() {
+ *     return {
+ *       module: AppModule,
+ *       logging: { level: LogLevel.INFO },
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class StratalWorker<Env extends StratalEnv = StratalEnv> extends WorkerEntrypoint<Env> {
+    /**
+     * Configure the Application.
+     * Access `this.env` and `this.ctx` for environment-dependent config.
+     */
+    protected abstract configure(): ApplicationConfig;
+    /**
+     * Get or initialize the Application singleton.
+     * Handles concurrent initialization guards automatically.
+     */
+    protected getApp(): Promise<Application>;
+    private initializeApp;
+    /**
+     * Handle HTTP requests via RouterService.
+     * Override for custom request handling.
+     */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Handle queue batches.
+     * Override for custom queue handling.
+     */
+    queue(batch: MessageBatch): Promise<void>;
+    /**
+     * Handle scheduled cron triggers.
+     * Override for custom scheduled handling.
+     */
+    scheduled(controller: ScheduledController): Promise<void>;
+}
+//# sourceMappingURL=stratal-worker.d.ts.map

package/dist/worker/stratal-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stratal-worker.d.ts","sourceRoot":"","sources":["../../src/worker/stratal-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAapE;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,aAAa,CAClC,GAAG,SAAS,UAAU,GAAG,UAAU,CAClC,SAAQ,gBAAgB,CAAC,GAAG,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,iBAAiB;IAEjD;;;OAGG;cACa,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;YA8BhC,aAAa;IAO3B;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMhD;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;OAGG;IACG,SAAS,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/D"}

package/dist/worker/stratal-worker.js

@@ -0,0 +1,88 @@
+import { WorkerEntrypoint } from 'cloudflare:workers';
+import { Application } from '../application';
+import { ROUTER_TOKENS } from '../router';
+/**
+ * Per-class singleton registry
+ * Key: Worker class constructor
+ * Value: { app, promise } for singleton + concurrent init guard
+ */
+const registry = new Map();
+/**
+ * Base class for Cloudflare Workers using the modules framework.
+ * Handles Application singleton management and provides default handlers.
+ *
+ * @example
+ * ```typescript
+ * export default class Backend extends StratalWorker<Cloudflare.Env> {
+ *   protected configure() {
+ *     return {
+ *       module: AppModule,
+ *       logging: { level: LogLevel.INFO },
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class StratalWorker extends WorkerEntrypoint {
+    /**
+     * Get or initialize the Application singleton.
+     * Handles concurrent initialization guards automatically.
+     */
+    async getApp() {
+        const key = this.constructor;
+        let state = registry.get(key);
+        if (!state) {
+            state = { app: null, promise: null };
+            registry.set(key, state);
+        }
+        // Fast path: already initialized
+        if (state.app) {
+            return state.app;
+        }
+        // Concurrent initialization guard
+        if (state.promise) {
+            return state.promise;
+        }
+        // Start initialization
+        state.promise = this.initializeApp();
+        try {
+            state.app = await state.promise;
+            return state.app;
+        }
+        finally {
+            state.promise = null;
+        }
+    }
+    async initializeApp() {
+        const config = this.configure();
+        const app = new Application(this.env, this.ctx, config);
+        await app.initialize();
+        return app;
+    }
+    /**
+     * Handle HTTP requests via RouterService.
+     * Override for custom request handling.
+     */
+    async fetch(request) {
+        const app = await this.getApp();
+        const router = app.resolve(ROUTER_TOKENS.RouterService);
+        return router.fetch(request, this.env, this.ctx);
+    }
+    /**
+     * Handle queue batches.
+     * Override for custom queue handling.
+     */
+    async queue(batch) {
+        const app = await this.getApp();
+        return app.handleQueue(batch, batch.queue);
+    }
+    /**
+     * Handle scheduled cron triggers.
+     * Override for custom scheduled handling.
+     */
+    async scheduled(controller) {
+        const app = await this.getApp();
+        return app.handleScheduled(controller);
+    }
+}
+//# sourceMappingURL=stratal-worker.js.map

package/dist/worker/stratal-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stratal-worker.js","sourceRoot":"","sources":["../../src/worker/stratal-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAA;AAE7D;;;;GAIG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAA;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAgB,aAEpB,SAAQ,gBAAqB;IAO9B;;;OAGG;IACO,KAAK,CAAC,MAAM;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAA;QAC5B,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,CAAC;QAED,iCAAiC;QACjC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,GAAG,CAAA;QACjB,CAAC;QAED,kCAAkC;QAClC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,OAAO,CAAA;QACrB,CAAC;QAED,uBAAuB;QACvB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QAEpC,IAAI,CAAC;YACJ,KAAK,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAA;YAC/B,OAAO,KAAK,CAAC,GAAG,CAAA;QACjB,CAAC;gBAAS,CAAC;YACV,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;QACrB,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,aAAa;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACvD,MAAM,GAAG,CAAC,UAAU,EAAE,CAAA;QACtB,OAAO,GAAG,CAAA;IACX,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAgB,aAAa,CAAC,aAAa,CAAC,CAAA;QACtE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,KAAmB;QAC9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,UAA+B;QAC9C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/B,OAAO,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;IACvC,CAAC;CACD"}

package/package.json

@@ -0,0 +1,148 @@
+{
+  "name": "stratal",
+  "version": "0.0.1",
+  "description": "A modular Cloudflare Workers framework with dependency injection, queue-based events, and type-safe configuration",
+  "type": "module",
+  "license": "MIT",
+  "author": "Temitayo Fadojutimi",
+  "homepage": "https://stratal.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/strataljs/stratal.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/strataljs/stratal/issues"
+  },
+  "keywords": [
+    "cloudflare-workers",
+    "framework",
+    "dependency-injection",
+    "modules",
+    "hono",
+    "queue",
+    "cron",
+    "i18n",
+    "openapi",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.js"
+    },
+    "./i18n/messages/en": {
+      "types": "./dist/i18n/messages/en/index.d.ts",
+      "import": "./dist/i18n/messages/en/index.js"
+    },
+    "./validation": {
+      "types": "./dist/i18n/validation/index.d.ts",
+      "import": "./dist/i18n/validation/index.js"
+    },
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "import": "./dist/*/index.js"
+    },
+    "./polyfills": {
+      "types": "./dist/polyfills/index.d.ts",
+      "import": "./dist/polyfills/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prebuild": "yarn clean",
+    "typecheck": "yarn tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "npx eslint .",
+    "lint:fix": "npx eslint --fix ."
+  },
+  "dependencies": {
+    "@hono/zod-openapi": "^1.1.4",
+    "@intlify/core-base": "^11.1.12",
+    "@intlify/message-compiler": "^11.1.12",
+    "@scalar/hono-api-reference": "^0.9.23",
+    "@xmldom/xmldom": "^0.8.11",
+    "hono": "^4.10.4",
+    "tsyringe": "^4.10.0",
+    "zod": "^4.1.12"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/lib-storage": "^3.700.0",
+    "@aws-sdk/s3-request-presigner": "^3.700.0",
+    "@react-email/components": "^1.0.0",
+    "@tus/server": "^2.0.0",
+    "nodemailer": "^7.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "resend": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/lib-storage": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "@react-email/components": {
+      "optional": true
+    },
+    "@tus/server": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "resend": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "3.726.0",
+    "@aws-sdk/lib-storage": "^3.948.0",
+    "@aws-sdk/s3-request-presigner": "3.726.0",
+    "@cloudflare/workers-types": "^4.20251014.0",
+    "@react-email/components": "^1.0.1",
+    "@stratal/testing": "workspace:*",
+    "@tus/server": "^2.3.0",
+    "@types/node": "^24.10.0",
+    "@types/nodemailer": "^7.0.3",
+    "@types/react": "^19.2.6",
+    "@types/react-dom": "^19",
+    "@vitest/coverage-v8": "^3.2.4",
+    "nodemailer": "^7.0.10",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "reflect-metadata": "^0.2.2",
+    "resend": "^6.4.1",
+    "typescript": "^5.9.3",
+    "vitest": "~3.2.0"
+  }
+}