@stratal/testing 0.0.2 → 0.0.5

package/CHANGELOG.md

@@ -0,0 +1,117 @@
+# @stratal/testing
+
+## 0.0.5
+
+### Patch Changes
+
+- [#66](https://github.com/strataljs/stratal/pull/66) [`c8ea964`](https://github.com/strataljs/stratal/commit/c8ea964e272b09ebc6619843e77d2b51178f9423) Thanks [@adesege](https://github.com/adesege)! - Add `actingAs` auth test helper, `TestHttpRequest` builder, ZenStack language mock, and enhanced `TestingModule` utilities with new exports and types.
+
+- Updated dependencies [[`c8ea964`](https://github.com/strataljs/stratal/commit/c8ea964e272b09ebc6619843e77d2b51178f9423), [`c8ea964`](https://github.com/strataljs/stratal/commit/c8ea964e272b09ebc6619843e77d2b51178f9423)]:
+  - stratal@0.0.5
+  - @stratal/framework@0.0.5
+
+## 0.0.4
+
+### Patch Changes
+
+- **Build cleanup** — Removed redundant polyfills export and cleaned up the build configuration.
+- **Relaxed vitest version** — Loosened the vitest peer dependency version constraint.
+
+- Updated dependencies []:
+  - stratal@0.0.4
+
+## 0.0.3
+
+### Patch Changes
+
+- - **Build cleanup** — Removed redundant polyfills export and cleaned up the build configuration.
+  - **Relaxed vitest version** — Loosened the vitest peer dependency version constraint.
+- Updated dependencies []:
+  - stratal@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+#### `stratal` (core)
+
+##### Breaking Changes
+
+- **`withRoot`/`withRootAsync` renamed to `forRoot`/`forRootAsync`** — All dynamic module configuration methods have been renamed for consistency. Update every `SomeModule.withRoot(...)` call to `SomeModule.forRoot(...)` and `SomeModule.withRootAsync(...)` to `SomeModule.forRootAsync(...)`. ([`152913a`](https://github.com/strataljs/stratal/commit/152913a))
+
+- **Barrel export removed — use sub-path imports** — The top-level `stratal` barrel export has been removed. Consumers must now import from sub-paths (`stratal/di`, `stratal/router`, `stratal/cache`, `stratal/validation`, etc.). ([`af073d8`](https://github.com/strataljs/stratal/commit/af073d8))
+
+##### Features
+
+- **DOM polyfill for Cloudflare Workers** — Added a DOM polyfill to support AWS SDK v3 XML parsing in Cloudflare Workers environments. ([`f3b2cb9`](https://github.com/strataljs/stratal/commit/f3b2cb9))
+
+- **Benchmark suite** — Added benchmark functionality for measuring framework performa30438`](https://github.com/strataljs/stratal/commit/7230438))
+
+##### Security
+
+- **ConfigService blocks prototype pollution** — `ConfigService` now rejects dangerous keys (`__proto__`, `constructor`, `prototype`) to prevent prototype pollution attacks. ([`567139c`](https://github.com/strataljs/stratal/commit/567139c), [`e64b4e7`](https://github.com/strataljs/stratal/commit/e64b4e7))
+
+##### Bug Fixes
+
+- **`reflect-metadata` import moved to vitest setup** — Removed unused `reflect-metadata` imports from example files and centralized the import in `vitest.setup.ts`. ([`f3b2cb9`](https://github.com/strataljs/stratal/commit/f3b2cb9))
+
+---
+
+#### `@stratal/testing`
+
+##### Breaking Changes
+
+- **Import paths updated** — Import paths updated to match the new core sub-path exports (e.g. `stratal/di` instead of the barrel `stratal`). ([`af073d8`](https://github.com/strataljs/stratal/commit/af073d8))
+
+- Updated dependencies []:
+  - @stratal/testing@0.0.2
+
+## 0.0.1
+
+### Patch Changes
+
+- Initial release of the Stratal framework — a modular Cloudflare Workers framework built on Hono and tsyringe.
+
+  **Core Infrastructure**
+
+  - NestJS-style module system with `@Module()` decorator, dynamic modules (`forRoot`, `forRootAsync`), and lifecycle hooks (`OnInitialize`, `OnShutdown`)
+  - Two-tier dependency injection container (global singletons + request-scoped) powered by tsyringe with conditional registration and service decoration
+  - `StratalWorker` entry point extending Cloudflare's `WorkerEntrypoint` for HTTP fetch, queue batches, and scheduled cron triggers
+
+  **Routing & API**
+
+  - Hono-based routing with `@Controller()` and `@Route()` decorators, automatic controller discovery, and route guards via `@UseGuards()`
+  - OpenAPI schema generation with `@hono/zod-openapi` and Scalar API reference integration
+  - NestJS-like middleware configuration with route-specific application and exclusion
+
+  **Background Processing**
+
+  - Queue consumerfor Cloudflare Queues with `@Consumer()` and `@QueueJob()` decorators and batch processing
+  - Cron job scheduling via `CronManager` integrated with Cloudflare's scheduled events
+
+  **Services & Integrations**
+
+  - Email module with pluggable providers (Nodemailer, Resend) and queue-based sending
+  - Storage module with AWS S3 / Cloudflare R2 support, multipart uploads, presigned URLs, and TUS resumable uploads
+  - Internationalization (i18n) module with locale detection, message compilation, and request-scoped translations
+  - Cache module with pluggable providers and Cloudflare KV integration
+  - Configuration module with `registerAs()` namespaces and Zod-based validation
+  - Structured logging with JSON and pretty formatters
+
+  **Developer Experience**
+
+  - Zod-powered request/response validation with type inference
+  - Custom `ApplicationError` class with HTTP status mapping
+  - ESM-only with full TypeScript decorator support (`emitDecoratorMetadata`)
+  - Sub-path exports for tree-shakeable imports (`stratal/di`, `stratal/router`, `stratal/cache`, etc.)
+
+  - `TestingModule` and `TestingModuleBuilder` for bootstrapping isolated module environments in tests
+  - `TestHttpClient` with request builder and response wrapper for integration testing
+  - `FetchMock` for mocking HTTP fetch calls
+  - `FakeStorageService` for in-memory storage testing without S3/R2
+  - `ProviderOverrideBuilder` for replacing providers with test doubles
+  - Nodemailer mock for email testing
+  - Test environment utilities via `getTestEnv()`
+
+- Updated dependencies []:
+  - stratal@0.0.1

package/dist/auth/acting-as.d.ts

@@ -0,0 +1,21 @@
+import type { AuthService } from '@stratal/framework/auth';
+/**
+ * ActingAs
+ *
+ * Creates authentication sessions for testing.
+ * Uses Better Auth's internalAdapter to create real database sessions.
+ *
+ * @example
+ * ```typescript
+ * const actingAs = new ActingAs(authService)
+ * const headers = await actingAs.createSessionForUser({ id: 'user-123' })
+ * ```
+ */
+export declare class ActingAs {
+    private readonly authService;
+    constructor(authService: AuthService);
+    createSessionForUser(user: {
+        id: string;
+    }): Promise<Headers>;
+}
+//# sourceMappingURL=acting-as.d.ts.map

package/dist/auth/acting-as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acting-as.d.ts","sourceRoot":"","sources":["../../src/auth/acting-as.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAwB1D;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE/C,oBAAoB,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAkCnE"}

package/dist/auth/acting-as.js

@@ -0,0 +1,68 @@
+import { setSessionCookie } from 'better-auth/cookies';
+import { convertSetCookieToCookie } from 'better-auth/test';
+async function makeSignature(value, secret) {
+    const algorithm = { name: 'HMAC', hash: 'SHA-256' };
+    const secretBuf = new TextEncoder().encode(secret);
+    const key = await crypto.subtle.importKey('raw', secretBuf, algorithm, false, ['sign']);
+    const signature = await crypto.subtle.sign(algorithm.name, key, new TextEncoder().encode(value));
+    return btoa(String.fromCharCode(...new Uint8Array(signature)));
+}
+function buildCookieString(name, value, options = {}) {
+    const encodedValue = encodeURIComponent(value);
+    let str = `${name}=${encodedValue}`;
+    if (options.path)
+        str += `; Path=${options.path}`;
+    if (options.httpOnly)
+        str += '; HttpOnly';
+    if (options.secure)
+        str += '; Secure';
+    if (options.sameSite)
+        str += `; SameSite=${options.sameSite}`;
+    if (options.maxAge !== undefined)
+        str += `; Max-Age=${Math.floor(options.maxAge)}`;
+    return str;
+}
+/**
+ * ActingAs
+ *
+ * Creates authentication sessions for testing.
+ * Uses Better Auth's internalAdapter to create real database sessions.
+ *
+ * @example
+ * ```typescript
+ * const actingAs = new ActingAs(authService)
+ * const headers = await actingAs.createSessionForUser({ id: 'user-123' })
+ * ```
+ */
+export class ActingAs {
+    authService;
+    constructor(authService) {
+        this.authService = authService;
+    }
+    async createSessionForUser(user) {
+        const auth = this.authService.auth;
+        const ctx = await auth.$context;
+        const secret = ctx.secret;
+        const session = await ctx.internalAdapter.createSession(user.id, undefined, { ipAddress: '127.0.0.1', userAgent: 'test-client' });
+        const dbUser = await ctx.internalAdapter.findUserById(user.id);
+        if (!dbUser) {
+            throw new Error(`User not found: ${user.id}`);
+        }
+        const responseHeaders = new Headers();
+        const mockCtx = {
+            context: ctx,
+            getSignedCookie: () => null,
+            setSignedCookie: async (name, value, _secret, options = {}) => {
+                const signature = await makeSignature(value, secret);
+                const signedValue = `${value}.${signature}`;
+                responseHeaders.append('Set-Cookie', buildCookieString(name, signedValue, options));
+            },
+            setCookie: (name, value, options = {}) => {
+                responseHeaders.append('Set-Cookie', buildCookieString(name, value, options));
+            },
+        };
+        await setSessionCookie(mockCtx, { session, user: dbUser }, false);
+        return convertSetCookieToCookie(responseHeaders);
+    }
+}
+//# sourceMappingURL=acting-as.js.map

package/dist/auth/acting-as.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acting-as.js","sourceRoot":"","sources":["../../src/auth/acting-as.ts"],"names":[],"mappings":"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"}

package/dist/auth/index.d.ts

@@ -0,0 +1,2 @@
+export { ActingAs } from './acting-as';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/auth/index.js

@@ -0,0 +1,2 @@
+export { ActingAs } from './acting-as';
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

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

package/dist/core/env/index.d.ts

@@ -0,0 +1,2 @@
+export { getTestEnv } from './test-env';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/env/index.js

@@ -0,0 +1,2 @@
+export { getTestEnv } from './test-env';
+//# sourceMappingURL=index.js.map

package/dist/core/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/env/test-env.d.ts

@@ -0,0 +1,9 @@
+import { type StratalEnv } from 'stratal';
+/**
+ * Get test environment with optional overrides
+ *
+ * @param overrides - Optional partial env to merge with cloudflare:test env
+ * @returns Complete Env object for testing
+ */
+export declare function getTestEnv(overrides?: Partial<StratalEnv>): StratalEnv;
+//# sourceMappingURL=test-env.d.ts.map

package/dist/core/env/test-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-env.d.ts","sourceRoot":"","sources":["../../../src/core/env/test-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AAGzC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAKtE"}

package/dist/core/env/test-env.js

@@ -0,0 +1,14 @@
+import { env as cloudflareEnv } from 'cloudflare:test';
+/**
+ * Get test environment with optional overrides
+ *
+ * @param overrides - Optional partial env to merge with cloudflare:test env
+ * @returns Complete Env object for testing
+ */
+export function getTestEnv(overrides) {
+    return {
+        ...cloudflareEnv,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=test-env.js.map

package/dist/core/env/test-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-env.js","sourceRoot":"","sources":["../../../src/core/env/test-env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,SAA+B;IACxD,OAAO;QACL,GAAG,aAAa;QAChB,GAAG,SAAS;KACC,CAAA;AACjB,CAAC"}

package/dist/core/http/fetch-mock.d.ts

@@ -0,0 +1,236 @@
+import type { MockJsonOptions, MockErrorOptions } from './fetch-mock.types';
+/**
+ * Wrapper around Cloudflare's fetchMock for declarative fetch mocking in tests
+ *
+ * Based on undici's MockAgent, fetchMock.get(origin) returns a MockPool for that origin.
+ * The MockPool's intercept() method is used to define which requests to mock.
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ *
+ * it('should mock external API', async () => {
+ *   // Using helper method
+ *   mock.mockJsonResponse('https://api.example.com/data', { success: true })
+ *
+ *   // Or using direct API
+ *   mock.get('https://api.example.com')
+ *     .intercept({ path: '/users', method: 'POST' })
+ *     .reply(201, JSON.stringify({ created: true }))
+ *
+ *   const response = await fetch('https://api.example.com/data')
+ *   const json = await response.json()
+ *
+ *   expect(json.success).toBe(true)
+ *   mock.assertNoPendingInterceptors()
+ * })
+ * ```
+ */
+export declare class FetchMock {
+    /**
+     * Get a MockPool for the specified origin
+     *
+     * This is the underlying fetchMock.get() method that returns a MockPool
+     * for mocking requests to the specified origin.
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @returns MockPool for chaining .intercept() and .reply()
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.get('https://api.example.com')
+     *   .intercept({ path: '/users', method: 'GET' })
+     *   .reply(200, JSON.stringify({ users: [] }))
+     *
+     * // Mock a POST request with body matching
+     * mock.get('https://api.example.com')
+     *   .intercept({
+     *     path: '/users',
+     *     method: 'POST',
+     *     body: (body) => body.includes('test')
+     *   })
+     *   .reply(201, JSON.stringify({ created: true }))
+     * ```
+     */
+    get(origin: string): import("cloudflare:test").Interceptable;
+    /**
+     * Activate fetch mocking for the current test
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     * })
+     * ```
+     */
+    activate(): void;
+    /**
+     * Deactivate fetch mocking
+     */
+    deactivate(): void;
+    /**
+     * Disable all network connections, forcing all requests to use mocks
+     *
+     * @example
+     * ```typescript
+     * beforeEach(() => {
+     *   mock.activate()
+     *   mock.disableNetConnect() // Ensure all requests are mocked
+     * })
+     * ```
+     */
+    disableNetConnect(): void;
+    /**
+     * Enable network connections for specific hosts
+     *
+     * @example
+     * ```typescript
+     * mock.enableNetConnect('localhost')
+     * mock.enableNetConnect(/^https:\/\/trusted\.com/)
+     * ```
+     */
+    enableNetConnect(host?: string | RegExp): void;
+    /**
+     * Assert that all defined interceptors were called
+     *
+     * @throws {Error} If there are pending interceptors that weren't matched
+     *
+     * @example
+     * ```typescript
+     * it('should call all mocked endpoints', async () => {
+     *   mock.mockJsonResponse('https://api.example.com/data', { data: [] })
+     *
+     *   await fetch('https://api.example.com/data')
+     *
+     *   mock.assertNoPendingInterceptors() // Pass
+     * })
+     * ```
+     */
+    assertNoPendingInterceptors(): void;
+    /**
+     * Reset all mocks and interceptors
+     *
+     * @example
+     * ```typescript
+     * afterEach(() => {
+     *   mock.reset()
+     * })
+     * ```
+     */
+    reset(): void;
+    /**
+     * Helper method to mock JSON responses
+     *
+     * Automatically parses the URL into origin and path, and sets up the mock.
+     *
+     * @param url - Full URL to mock (e.g., 'https://api.example.com/users')
+     * @param data - JSON data to return
+     * @param options - Additional options for the mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a GET request
+     * mock.mockJsonResponse('https://api.example.com/users', { users: [] })
+     *
+     * // Mock a POST request
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { created: true },
+     *   { method: 'POST', status: 201 }
+     * )
+     *
+     * // With custom headers and delay
+     * mock.mockJsonResponse(
+     *   'https://api.example.com/users',
+     *   { users: [] },
+     *   {
+     *     status: 200,
+     *     method: 'GET',
+     *     headers: { 'X-Custom': 'value' },
+     *     delay: 100
+     *   }
+     * )
+     * ```
+     */
+    mockJsonResponse(url: string, data: unknown, options?: MockJsonOptions): import("cloudflare:test").MockScope<object>;
+    /**
+     * Helper method to mock error responses
+     *
+     * @param url - Full URL to mock
+     * @param status - HTTP error status code
+     * @param message - Optional error message
+     * @param options - Additional options for the error mock
+     *
+     * @example
+     * ```typescript
+     * // Mock a 401 error
+     * mock.mockError('https://api.example.com/fail', 401, 'Unauthorized')
+     *
+     * // Mock a 500 error with custom method
+     * mock.mockError(
+     *   'https://api.example.com/fail',
+     *   500,
+     *   'Server Error',
+     *   { method: 'POST' }
+     * )
+     * ```
+     */
+    mockError(url: string, status: number, message?: string, options?: MockErrorOptions): import("cloudflare:test").MockScope<object>;
+    /**
+     * Generic helper to mock any HTTP request
+     *
+     * @param origin - The origin URL (e.g., 'https://api.example.com')
+     * @param options - Request matching and response options
+     *
+     * @example
+     * ```typescript
+     * mock.mockRequest('https://api.example.com', {
+     *   path: '/users',
+     *   method: 'PUT',
+     *   status: 200,
+     *   body: { updated: true }
+     * })
+     * ```
+     */
+    mockRequest(origin: string, options: {
+        path: string;
+        method?: string;
+        status?: number;
+        body?: unknown;
+    }): import("cloudflare:test").MockScope<object>;
+}
+/**
+ * Factory function to create a new FetchMock instance
+ *
+ * @returns A new FetchMock instance
+ *
+ * @example
+ * ```typescript
+ * import { createFetchMock } from '@stratal/testing'
+ *
+ * const mock = createFetchMock()
+ *
+ * beforeEach(() => {
+ *   mock.activate()
+ *   mock.disableNetConnect()
+ * })
+ *
+ * afterEach(() => {
+ *   mock.reset()
+ * })
+ * ```
+ */
+export declare function createFetchMock(): FetchMock;
+//# sourceMappingURL=fetch-mock.d.ts.map

package/dist/core/http/fetch-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-mock.d.ts","sourceRoot":"","sources":["../../../src/core/http/fetch-mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,SAAS;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM;IAIlB;;;;;;;;;OASG;IACH,QAAQ;IAIR;;OAEG;IACH,UAAU;IAIV;;;;;;;;;;OAUG;IACH,iBAAiB;IAIjB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAOvC;;;;;;;;;;;;;;;OAeG;IACH,2BAA2B;IAI3B;;;;;;;;;OASG;IACH,KAAK;IAKL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB;IAwB1E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAkBvF;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAS5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}