workerstack 0.1.0-beta.0

package/dist/testing/email.d.ts

@@ -0,0 +1,15 @@
+import type { EmailAdapter, EmailMessage } from '../email.js';
+export type CapturedEmail = Omit<EmailMessage, 'to' | 'cc' | 'bcc'> & {
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+};
+export type TestEmail = {
+    readonly sent: readonly Readonly<CapturedEmail>[];
+};
+export declare function createTestEmail(): {
+    adapter: EmailAdapter;
+    email: TestEmail;
+};
+//# sourceMappingURL=email.d.ts.map

package/dist/testing/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/testing/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAA;CAClD,CAAA;AAKD,wBAAgB,eAAe,IAAI;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,SAAS,CAAA;CACjB,CAiCA"}

package/dist/testing/email.js

@@ -0,0 +1,32 @@
+const addresses = (value) => value === undefined ? undefined : Array.isArray(value) ? [...value] : [value];
+export function createTestEmail() {
+    const messages = [];
+    return {
+        adapter: {
+            async send(message) {
+                messages.push({
+                    ...message,
+                    to: addresses(message.to) ?? [],
+                    cc: addresses(message.cc),
+                    bcc: addresses(message.bcc),
+                });
+                return { id: `test-email-${messages.length}` };
+            },
+        },
+        email: {
+            get sent() {
+                return Object.freeze(messages.map((message) => Object.freeze({
+                    ...message,
+                    to: Object.freeze([...message.to]),
+                    cc: message.cc
+                        ? Object.freeze([...message.cc])
+                        : undefined,
+                    bcc: message.bcc
+                        ? Object.freeze([...message.bcc])
+                        : undefined,
+                })));
+            },
+        },
+    };
+}
+//# sourceMappingURL=email.js.map

package/dist/testing/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/testing/email.ts"],"names":[],"mappings":"AAaA,MAAM,SAAS,GAAG,CAAC,KAAoC,EAAE,EAAE,CACzD,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AAE/E,MAAM,UAAU,eAAe;IAI7B,MAAM,QAAQ,GAAoB,EAAE,CAAA;IACpC,OAAO;QACL,OAAO,EAAE;YACP,KAAK,CAAC,IAAI,CAAC,OAAO;gBAChB,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,OAAO;oBACV,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;oBAC/B,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzB,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;iBAC5B,CAAC,CAAA;gBACF,OAAO,EAAE,EAAE,EAAE,cAAc,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;YAChD,CAAC;SACF;QACD,KAAK,EAAE;YACL,IAAI,IAAI;gBACN,OAAO,MAAM,CAAC,MAAM,CAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,MAAM,CAAC,MAAM,CAAC;oBACZ,GAAG,OAAO;oBACV,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAwB;oBACzD,EAAE,EAAE,OAAO,CAAC,EAAE;wBACZ,CAAC,CAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAyB;wBACzD,CAAC,CAAC,SAAS;oBACb,GAAG,EAAE,OAAO,CAAC,GAAG;wBACd,CAAC,CAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAyB;wBAC1D,CAAC,CAAC,SAAS;iBACd,CAAC,CACH,CACF,CAAA;YACH,CAAC;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { EmailAdapter, EmailMessage } from '../email'\n\nexport type CapturedEmail = Omit<EmailMessage, 'to' | 'cc' | 'bcc'> & {\n  from: string\n  to: string[]\n  cc?: string[]\n  bcc?: string[]\n}\n\nexport type TestEmail = {\n  readonly sent: readonly Readonly<CapturedEmail>[]\n}\n\nconst addresses = (value: string | string[] | undefined) =>\n  value === undefined ? undefined : Array.isArray(value) ? [...value] : [value]\n\nexport function createTestEmail(): {\n  adapter: EmailAdapter\n  email: TestEmail\n} {\n  const messages: CapturedEmail[] = []\n  return {\n    adapter: {\n      async send(message) {\n        messages.push({\n          ...message,\n          to: addresses(message.to) ?? [],\n          cc: addresses(message.cc),\n          bcc: addresses(message.bcc),\n        })\n        return { id: `test-email-${messages.length}` }\n      },\n    },\n    email: {\n      get sent() {\n        return Object.freeze(\n          messages.map((message) =>\n            Object.freeze({\n              ...message,\n              to: Object.freeze([...message.to]) as unknown as string[],\n              cc: message.cc\n                ? (Object.freeze([...message.cc]) as unknown as string[])\n                : undefined,\n              bcc: message.bcc\n                ? (Object.freeze([...message.bcc]) as unknown as string[])\n                : undefined,\n            }),\n          ),\n        )\n      },\n    },\n  }\n}\n"]}

package/dist/testing/fixture.d.ts

@@ -0,0 +1,51 @@
+import type { WorkerstackBackend } from '../backend.js';
+import type { AnyWorkerstackApp, WorkerstackClient } from '../client/rpc-client.js';
+import type { TestDatabaseStrategy } from '../database/adapter.js';
+import type { TestSchemaMode } from '../provision-schema.js';
+import type { TestAuth, TestIdentity } from './auth.js';
+import type { TestLogs, TestLogMode } from './logs.js';
+import type { TestMessagingForApp } from './messaging.js';
+import type { TestStorage } from './storage.js';
+import { type TestJobs } from './jobs.js';
+export type TestOptions = {
+    env?: Record<string, string | undefined>;
+    database?: {
+        mode?: 'memory' | 'temporary';
+        schema?: TestSchemaMode;
+        strategy?: TestDatabaseStrategy;
+    };
+    logs?: TestLogMode;
+};
+export type TestCleanup = () => unknown | Promise<unknown>;
+export type TestSetup<TApp, TContext> = (fixture: TestFixture<TApp>) => TContext | Promise<TContext>;
+export type TestConfigureOptions<TApp, TContext> = TestOptions & {
+    setup?: TestSetup<TApp, TContext>;
+};
+export type TestFixture<TApp> = AsyncDisposable & {
+    readonly app: TApp;
+    readonly auth: TestAuth;
+    readonly messaging: TestMessagingForApp<TApp>;
+    readonly jobs: TestJobs;
+    readonly logs: TestLogs;
+    readonly storage: TestStorage;
+    defer(cleanup: TestCleanup): void;
+    client(identity?: TestIdentity): TApp extends AnyWorkerstackApp ? WorkerstackClient<TApp> : never;
+    close(): Promise<void>;
+};
+export type ConfiguredTestFixture<TApp, TContext> = TestFixture<TApp> & {
+    readonly context: TContext;
+};
+export type TestFactory<TApp, TContext> = (options?: TestOptions) => Promise<ConfiguredTestFixture<TApp, TContext>>;
+export type TestMethod<TApp> = {
+    (options?: TestOptions): Promise<TestFixture<TApp>>;
+    configure<TContext = undefined>(options: TestConfigureOptions<TApp, TContext>): TestFactory<TApp, TContext>;
+};
+type TestableApp = {
+    auth: unknown;
+    handler(request: Request): Promise<Response>;
+    close(): Promise<void>;
+};
+export declare function configureTestApp<TApp extends TestableApp, TContext = undefined>(backend: WorkerstackBackend<TApp>, options: TestConfigureOptions<TApp, TContext>): TestFactory<TApp, TContext>;
+export declare function createTestApp<TApp extends TestableApp>(backend: WorkerstackBackend<TApp>, options?: TestOptions): Promise<TestFixture<TApp>>;
+export {};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/testing/fixture.d.ts.map

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

package/dist/testing/fixture.js

@@ -0,0 +1,177 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BACKEND_INTERNALS, } from '../backend-internals.js';
+import { provisionForTest } from '../provision-schema.js';
+import { createTestAuth, createTestSessionRegistry } from './auth.js';
+import { testClient } from './client.js';
+import { createTestDatabaseTarget } from './database.js';
+import { createTestJobs } from './jobs.js';
+import { createTestLogs } from './logs.js';
+import { createTestMessaging } from './messaging.js';
+import { createTestStorage, resolveTestBuckets } from './storage.js';
+const defaultTestEnv = {
+    NODE_ENV: 'test',
+    AUTH_SECRET: 'workerstack-test-secret',
+};
+function mergeTestOptions(defaults, overrides) {
+    return {
+        ...defaults,
+        ...overrides,
+        env: defaults.env || overrides.env
+            ? { ...defaults.env, ...overrides.env }
+            : undefined,
+        database: defaults.database || overrides.database
+            ? { ...defaults.database, ...overrides.database }
+            : undefined,
+    };
+}
+export function configureTestApp(backend, options) {
+    const { setup, ...defaults } = options;
+    return async (overrides = {}) => {
+        const fixture = await createTestApp(backend, mergeTestOptions(defaults, overrides));
+        try {
+            const context = setup ? await setup(fixture) : undefined;
+            return Object.assign(fixture, { context });
+        }
+        catch (cause) {
+            try {
+                await fixture.close();
+            }
+            catch (cleanupCause) {
+                throw new AggregateError([cause, cleanupCause], '[workerstack] test fixture setup and cleanup failed');
+            }
+            throw cause;
+        }
+    };
+}
+export async function createTestApp(backend, options = {}) {
+    const internals = backend[BACKEND_INTERNALS];
+    const source = { ...defaultTestEnv, ...options.env };
+    const inspected = internals.inspect(source);
+    const storageRoot = await mkdtemp(join(tmpdir(), 'workerstack-storage-'));
+    const resolvedStorage = resolveTestBuckets(inspected.config.storage, storageRoot);
+    const testMessaging = createTestMessaging(inspected.config.messaging);
+    const storage = createTestStorage(resolvedStorage);
+    const sessions = createTestSessionRegistry();
+    const { logger, logs } = createTestLogs(options.logs);
+    let target;
+    try {
+        target = await createTestDatabaseTarget(inspected.config.database.adapter, {
+            mode: options.database?.mode ?? 'memory',
+            strategy: options.database?.strategy,
+        });
+    }
+    catch (cause) {
+        await rm(storageRoot, { recursive: true, force: true });
+        throw cause;
+    }
+    let app;
+    let testingHandle;
+    try {
+        app = await internals.start(source, {
+            database: target.connection,
+            resolvedStorage,
+            messagingAdapters: testMessaging.adapters,
+            authResolver: sessions.resolver,
+            logger,
+            captureTestingHandle: (handle) => {
+                testingHandle = handle;
+            },
+        }, inspected);
+        await provisionForTest(app, options.database?.schema ?? 'auto');
+    }
+    catch (cause) {
+        const cleanupErrors = [];
+        if (app) {
+            try {
+                await app.close();
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        try {
+            await target[Symbol.asyncDispose]();
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+        try {
+            await rm(storageRoot, { recursive: true, force: true });
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+        if (cleanupErrors.length > 0) {
+            throw new AggregateError([cause, ...cleanupErrors], '[workerstack] test fixture setup and cleanup failed');
+        }
+        throw cause;
+    }
+    if (!testingHandle) {
+        await app.close();
+        await target[Symbol.asyncDispose]();
+        await rm(storageRoot, { recursive: true, force: true });
+        throw new Error('[workerstack] runtime did not provide test controls');
+    }
+    const auth = createTestAuth(app, testMessaging.authEmail, sessions);
+    const jobs = createTestJobs(testingHandle);
+    const deferred = [];
+    let closePromise;
+    const defer = (cleanup) => {
+        if (closePromise) {
+            throw new Error('[workerstack] cannot defer cleanup after fixture close');
+        }
+        deferred.push(cleanup);
+    };
+    const close = () => {
+        closePromise ??= (async () => {
+            const errors = [];
+            for (const cleanup of deferred.reverse()) {
+                try {
+                    await cleanup();
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+            try {
+                await app.close();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            try {
+                await target[Symbol.asyncDispose]();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            try {
+                await rm(storageRoot, { recursive: true, force: true });
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1) {
+                throw new AggregateError(errors, '[workerstack] fixture cleanup failed');
+            }
+        })();
+        return closePromise;
+    };
+    return {
+        app,
+        auth,
+        messaging: testMessaging.messaging,
+        jobs,
+        logs,
+        storage,
+        defer,
+        client: (identity) => testClient(app, identity),
+        close,
+        [Symbol.asyncDispose]: close,
+    };
+}
+//# sourceMappingURL=fixture.js.map

package/dist/testing/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/testing/fixture.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtemp, rm } from 'node:fs/promises'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\n\nimport type { WorkerstackBackend } from '../backend'\nimport type { AnyWorkerstackApp, WorkerstackClient } from '../client/rpc-client'\nimport type { TestDatabaseStrategy } from '../database/adapter'\nimport type { TestSchemaMode } from '../provision-schema'\nimport type { TestAuth, TestIdentity } from './auth'\nimport type { TestLogs, TestLogMode } from './logs'\nimport type { TestMessagingForApp } from './messaging'\nimport type { TestStorage } from './storage'\n\nimport {\n  BACKEND_INTERNALS,\n  type RuntimeTestingHandle,\n} from '../backend-internals'\nimport { provisionForTest } from '../provision-schema'\nimport { createTestAuth, createTestSessionRegistry } from './auth'\nimport { testClient } from './client'\nimport { createTestDatabaseTarget } from './database'\nimport { createTestJobs, type TestJobs } from './jobs'\nimport { createTestLogs } from './logs'\nimport { createTestMessaging } from './messaging'\nimport { createTestStorage, resolveTestBuckets } from './storage'\n\nexport type TestOptions = {\n  env?: Record<string, string | undefined>\n  database?: {\n    mode?: 'memory' | 'temporary'\n    schema?: TestSchemaMode\n    strategy?: TestDatabaseStrategy\n  }\n  logs?: TestLogMode\n}\n\nexport type TestCleanup = () => unknown | Promise<unknown>\n\nexport type TestSetup<TApp, TContext> = (\n  fixture: TestFixture<TApp>,\n) => TContext | Promise<TContext>\n\nexport type TestConfigureOptions<TApp, TContext> = TestOptions & {\n  setup?: TestSetup<TApp, TContext>\n}\n\nexport type TestFixture<TApp> = AsyncDisposable & {\n  readonly app: TApp\n  readonly auth: TestAuth\n  readonly messaging: TestMessagingForApp<TApp>\n  readonly jobs: TestJobs\n  readonly logs: TestLogs\n  readonly storage: TestStorage\n  defer(cleanup: TestCleanup): void\n  client(\n    identity?: TestIdentity,\n  ): TApp extends AnyWorkerstackApp ? WorkerstackClient<TApp> : never\n  close(): Promise<void>\n}\n\nexport type ConfiguredTestFixture<TApp, TContext> = TestFixture<TApp> & {\n  readonly context: TContext\n}\n\nexport type TestFactory<TApp, TContext> = (\n  options?: TestOptions,\n) => Promise<ConfiguredTestFixture<TApp, TContext>>\n\nexport type TestMethod<TApp> = {\n  (options?: TestOptions): Promise<TestFixture<TApp>>\n  configure<TContext = undefined>(\n    options: TestConfigureOptions<TApp, TContext>,\n  ): TestFactory<TApp, TContext>\n}\n\ntype TestableApp = {\n  auth: unknown\n  handler(request: Request): Promise<Response>\n  close(): Promise<void>\n}\n\nconst defaultTestEnv = {\n  NODE_ENV: 'test',\n  AUTH_SECRET: 'workerstack-test-secret',\n} satisfies Record<string, string | undefined>\n\nfunction mergeTestOptions(\n  defaults: TestOptions,\n  overrides: TestOptions,\n): TestOptions {\n  return {\n    ...defaults,\n    ...overrides,\n    env:\n      defaults.env || overrides.env\n        ? { ...defaults.env, ...overrides.env }\n        : undefined,\n    database:\n      defaults.database || overrides.database\n        ? { ...defaults.database, ...overrides.database }\n        : undefined,\n  }\n}\n\nexport function configureTestApp<\n  TApp extends TestableApp,\n  TContext = undefined,\n>(\n  backend: WorkerstackBackend<TApp>,\n  options: TestConfigureOptions<TApp, TContext>,\n): TestFactory<TApp, TContext> {\n  const { setup, ...defaults } = options\n  return async (overrides = {}) => {\n    const fixture = await createTestApp(\n      backend,\n      mergeTestOptions(defaults, overrides),\n    )\n    try {\n      const context = setup ? await setup(fixture) : (undefined as TContext)\n      return Object.assign(fixture, { context })\n    } catch (cause) {\n      try {\n        await fixture.close()\n      } catch (cleanupCause) {\n        throw new AggregateError(\n          [cause, cleanupCause],\n          '[workerstack] test fixture setup and cleanup failed',\n        )\n      }\n      throw cause\n    }\n  }\n}\n\nexport async function createTestApp<TApp extends TestableApp>(\n  backend: WorkerstackBackend<TApp>,\n  options: TestOptions = {},\n): Promise<TestFixture<TApp>> {\n  const internals = backend[BACKEND_INTERNALS]\n  const source = { ...defaultTestEnv, ...options.env }\n  const inspected = internals.inspect(source)\n  const storageRoot = await mkdtemp(join(tmpdir(), 'workerstack-storage-'))\n  const resolvedStorage = resolveTestBuckets(\n    inspected.config.storage,\n    storageRoot,\n  )\n  const testMessaging = createTestMessaging(inspected.config.messaging)\n  const storage = createTestStorage(resolvedStorage)\n  const sessions = createTestSessionRegistry()\n  const { logger, logs } = createTestLogs(options.logs)\n\n  let target\n  try {\n    target = await createTestDatabaseTarget(inspected.config.database.adapter, {\n      mode: options.database?.mode ?? 'memory',\n      strategy: options.database?.strategy,\n    })\n  } catch (cause) {\n    await rm(storageRoot, { recursive: true, force: true })\n    throw cause\n  }\n\n  let app: TApp | undefined\n  let testingHandle: RuntimeTestingHandle | undefined\n  try {\n    app = await internals.start(\n      source,\n      {\n        database: target.connection,\n        resolvedStorage,\n        messagingAdapters: testMessaging.adapters,\n        authResolver: sessions.resolver,\n        logger,\n        captureTestingHandle: (handle) => {\n          testingHandle = handle\n        },\n      },\n      inspected,\n    )\n    await provisionForTest(app as object, options.database?.schema ?? 'auto')\n  } catch (cause) {\n    const cleanupErrors: unknown[] = []\n    if (app) {\n      try {\n        await app.close()\n      } catch (error) {\n        cleanupErrors.push(error)\n      }\n    }\n    try {\n      await target[Symbol.asyncDispose]()\n    } catch (error) {\n      cleanupErrors.push(error)\n    }\n    try {\n      await rm(storageRoot, { recursive: true, force: true })\n    } catch (error) {\n      cleanupErrors.push(error)\n    }\n    if (cleanupErrors.length > 0) {\n      throw new AggregateError(\n        [cause, ...cleanupErrors],\n        '[workerstack] test fixture setup and cleanup failed',\n      )\n    }\n    throw cause\n  }\n\n  if (!testingHandle) {\n    await app.close()\n    await target[Symbol.asyncDispose]()\n    await rm(storageRoot, { recursive: true, force: true })\n    throw new Error('[workerstack] runtime did not provide test controls')\n  }\n\n  const auth = createTestAuth(app, testMessaging.authEmail, sessions)\n  const jobs = createTestJobs(testingHandle)\n  const deferred: TestCleanup[] = []\n  let closePromise: Promise<void> | undefined\n  const defer = (cleanup: TestCleanup) => {\n    if (closePromise) {\n      throw new Error('[workerstack] cannot defer cleanup after fixture close')\n    }\n    deferred.push(cleanup)\n  }\n  const close = () => {\n    closePromise ??= (async () => {\n      const errors: unknown[] = []\n      for (const cleanup of deferred.reverse()) {\n        try {\n          await cleanup()\n        } catch (error) {\n          errors.push(error)\n        }\n      }\n      try {\n        await app.close()\n      } catch (error) {\n        errors.push(error)\n      }\n      try {\n        await target[Symbol.asyncDispose]()\n      } catch (error) {\n        errors.push(error)\n      }\n      try {\n        await rm(storageRoot, { recursive: true, force: true })\n      } catch (error) {\n        errors.push(error)\n      }\n      if (errors.length === 1) throw errors[0]\n      if (errors.length > 1) {\n        throw new AggregateError(errors, '[workerstack] fixture cleanup failed')\n      }\n    })()\n    return closePromise\n  }\n\n  return {\n    app,\n    auth,\n    messaging: testMessaging.messaging as TestMessagingForApp<TApp>,\n    jobs,\n    logs,\n    storage,\n    defer,\n    client: (identity) => testClient(app as never, identity) as never,\n    close,\n    [Symbol.asyncDispose]: close,\n  }\n}\n"]}

package/dist/testing/jobs.d.ts

@@ -0,0 +1,40 @@
+import type { RuntimeJobFailure, RuntimeTestJob, RuntimeTestingHandle } from '../backend-internals.js';
+export type JobRunReport = {
+    ticks: number;
+    claimed: number;
+    ran: number;
+    failed: number;
+    remainingRunnable: number;
+};
+export type RunNextOptions = {
+    now?: Date | number;
+};
+export type RunUntilIdleOptions = RunNextOptions & {
+    maxTicks?: number;
+    failOnJobError?: boolean;
+};
+export type TestJob = Readonly<RuntimeTestJob>;
+export type TestJobFilter = {
+    name?: string;
+    dedupeKey?: string;
+};
+export declare class TestJobsError extends Error {
+    readonly report: JobRunReport;
+    readonly failures: RuntimeJobFailure[];
+    readonly name = "TestJobsError";
+    constructor(report: JobRunReport, failures: RuntimeJobFailure[]);
+}
+export declare class TestJobsConvergenceError extends Error {
+    readonly report: JobRunReport;
+    readonly name = "TestJobsConvergenceError";
+    constructor(report: JobRunReport);
+}
+export type TestJobs = {
+    runNext(options?: RunNextOptions): Promise<JobRunReport>;
+    runUntilIdle(options?: RunUntilIdleOptions): Promise<JobRunReport>;
+    inspect(filter?: TestJobFilter): Promise<readonly TestJob[]>;
+    pending(filter?: TestJobFilter): Promise<readonly TestJob[]>;
+    failed(filter?: TestJobFilter): Promise<readonly TestJob[]>;
+};
+export declare function createTestJobs(handle: RuntimeTestingHandle): TestJobs;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/testing/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/testing/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAA;AAEpD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,qBAAa,aAAc,SAAQ,KAAK;IAIpC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE;IAJxC,SAAkB,IAAI,mBAAkB;gBAG7B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,iBAAiB,EAAE;CAMzC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAFzC,SAAkB,IAAI,8BAA6B;gBAE9B,MAAM,EAAE,YAAY;CAK1C;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxD,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAClE,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAC5D,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAC5D,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;CAC5D,CAAA;AAMD,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAoErE"}

package/dist/testing/jobs.js

@@ -0,0 +1,76 @@
+export class TestJobsError extends Error {
+    report;
+    failures;
+    name = 'TestJobsError';
+    constructor(report, failures) {
+        super(`[workerstack] ${failures.length} background job${failures.length === 1 ? '' : 's'} failed: ${failures.map((failure) => `${failure.name}: ${failure.lastError ?? 'unknown error'}`).join('; ')}`);
+        this.report = report;
+        this.failures = failures;
+    }
+}
+export class TestJobsConvergenceError extends Error {
+    report;
+    name = 'TestJobsConvergenceError';
+    constructor(report) {
+        super(`[workerstack] background jobs did not become idle after ${report.ticks} ticks (${report.remainingRunnable} still runnable)`);
+        this.report = report;
+    }
+}
+function timestamp(value) {
+    return value === undefined ? Date.now() : new Date(value).getTime();
+}
+export function createTestJobs(handle) {
+    const list = async (filter = {}, status) => {
+        const { jobs } = await handle.inspect(Date.now());
+        return Object.freeze(jobs.filter((job) => (!status || job.status === status) &&
+            (!filter.name || job.name === filter.name) &&
+            (!filter.dedupeKey || job.dedupeKey === filter.dedupeKey)));
+    };
+    return {
+        inspect: (filter) => list(filter),
+        pending: (filter) => list(filter, 'pending'),
+        failed: (filter) => list(filter, 'failed'),
+        async runNext(options = {}) {
+            const now = timestamp(options.now);
+            const tick = await handle.tick(now);
+            const inspection = await handle.inspect(now);
+            return {
+                ticks: 1,
+                ...tick,
+                remainingRunnable: inspection.runnable,
+            };
+        },
+        async runUntilIdle(options = {}) {
+            const now = timestamp(options.now);
+            const maxTicks = options.maxTicks ?? 100;
+            if (!Number.isInteger(maxTicks) || maxTicks <= 0) {
+                throw new TypeError('[workerstack] maxTicks must be a positive integer');
+            }
+            const report = {
+                ticks: 0,
+                claimed: 0,
+                ran: 0,
+                failed: 0,
+                remainingRunnable: 0,
+            };
+            let inspection;
+            do {
+                const tick = await handle.tick(now);
+                report.ticks++;
+                report.claimed += tick.claimed;
+                report.ran += tick.ran;
+                report.failed += tick.failed;
+                inspection = await handle.inspect(now);
+                report.remainingRunnable = inspection.runnable;
+                if (inspection.runnable > 0 && report.ticks >= maxTicks) {
+                    throw new TestJobsConvergenceError(report);
+                }
+            } while (inspection.runnable > 0);
+            if ((options.failOnJobError ?? true) && inspection.failed.length > 0) {
+                throw new TestJobsError(report, inspection.failed);
+            }
+            return report;
+        },
+    };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/testing/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/testing/jobs.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RuntimeJobFailure,\n  RuntimeTestJob,\n  RuntimeTestingHandle,\n} from '../backend-internals'\n\nexport type JobRunReport = {\n  ticks: number\n  claimed: number\n  ran: number\n  failed: number\n  remainingRunnable: number\n}\n\nexport type RunNextOptions = { now?: Date | number }\n\nexport type RunUntilIdleOptions = RunNextOptions & {\n  maxTicks?: number\n  failOnJobError?: boolean\n}\n\nexport type TestJob = Readonly<RuntimeTestJob>\n\nexport type TestJobFilter = {\n  name?: string\n  dedupeKey?: string\n}\n\nexport class TestJobsError extends Error {\n  override readonly name = 'TestJobsError'\n\n  constructor(\n    readonly report: JobRunReport,\n    readonly failures: RuntimeJobFailure[],\n  ) {\n    super(\n      `[workerstack] ${failures.length} background job${failures.length === 1 ? '' : 's'} failed: ${failures.map((failure) => `${failure.name}: ${failure.lastError ?? 'unknown error'}`).join('; ')}`,\n    )\n  }\n}\n\nexport class TestJobsConvergenceError extends Error {\n  override readonly name = 'TestJobsConvergenceError'\n\n  constructor(readonly report: JobRunReport) {\n    super(\n      `[workerstack] background jobs did not become idle after ${report.ticks} ticks (${report.remainingRunnable} still runnable)`,\n    )\n  }\n}\n\nexport type TestJobs = {\n  runNext(options?: RunNextOptions): Promise<JobRunReport>\n  runUntilIdle(options?: RunUntilIdleOptions): Promise<JobRunReport>\n  inspect(filter?: TestJobFilter): Promise<readonly TestJob[]>\n  pending(filter?: TestJobFilter): Promise<readonly TestJob[]>\n  failed(filter?: TestJobFilter): Promise<readonly TestJob[]>\n}\n\nfunction timestamp(value: Date | number | undefined): number {\n  return value === undefined ? Date.now() : new Date(value).getTime()\n}\n\nexport function createTestJobs(handle: RuntimeTestingHandle): TestJobs {\n  const list = async (\n    filter: TestJobFilter = {},\n    status?: TestJob['status'],\n  ) => {\n    const { jobs } = await handle.inspect(Date.now())\n    return Object.freeze(\n      jobs.filter(\n        (job) =>\n          (!status || job.status === status) &&\n          (!filter.name || job.name === filter.name) &&\n          (!filter.dedupeKey || job.dedupeKey === filter.dedupeKey),\n      ),\n    )\n  }\n\n  return {\n    inspect: (filter) => list(filter),\n    pending: (filter) => list(filter, 'pending'),\n    failed: (filter) => list(filter, 'failed'),\n\n    async runNext(options = {}) {\n      const now = timestamp(options.now)\n      const tick = await handle.tick(now)\n      const inspection = await handle.inspect(now)\n      return {\n        ticks: 1,\n        ...tick,\n        remainingRunnable: inspection.runnable,\n      }\n    },\n\n    async runUntilIdle(options = {}) {\n      const now = timestamp(options.now)\n      const maxTicks = options.maxTicks ?? 100\n      if (!Number.isInteger(maxTicks) || maxTicks <= 0) {\n        throw new TypeError('[workerstack] maxTicks must be a positive integer')\n      }\n\n      const report: JobRunReport = {\n        ticks: 0,\n        claimed: 0,\n        ran: 0,\n        failed: 0,\n        remainingRunnable: 0,\n      }\n      let inspection: Awaited<ReturnType<RuntimeTestingHandle['inspect']>>\n\n      do {\n        const tick = await handle.tick(now)\n        report.ticks++\n        report.claimed += tick.claimed\n        report.ran += tick.ran\n        report.failed += tick.failed\n        inspection = await handle.inspect(now)\n        report.remainingRunnable = inspection.runnable\n\n        if (inspection.runnable > 0 && report.ticks >= maxTicks) {\n          throw new TestJobsConvergenceError(report)\n        }\n      } while (inspection.runnable > 0)\n\n      if ((options.failOnJobError ?? true) && inspection.failed.length > 0) {\n        throw new TestJobsError(report, inspection.failed)\n      }\n      return report\n    },\n  }\n}\n"]}

package/dist/testing/logs.d.ts

@@ -0,0 +1,18 @@
+import type { WorkerstackLogger, WorkerstackLogLevel } from '../logging.js';
+export type TestLogMode = 'capture' | 'inherit' | 'silent';
+export type TestLogEntry = {
+    readonly level: WorkerstackLogLevel;
+    readonly message: string;
+    readonly args: readonly unknown[];
+};
+export type TestLogs = {
+    readonly entries: readonly Readonly<TestLogEntry>[];
+    readonly errors: readonly Readonly<TestLogEntry>[];
+    readonly warnings: readonly Readonly<TestLogEntry>[];
+    clear(): void;
+};
+export declare function createTestLogs(mode?: TestLogMode): {
+    logger: WorkerstackLogger;
+    logs: TestLogs;
+};
+//# sourceMappingURL=logs.d.ts.map

package/dist/testing/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/testing/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAA;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAA;IACpD,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAcD,wBAAgB,cAAc,CAAC,IAAI,GAAE,WAAuB,GAAG;IAC7D,MAAM,EAAE,iBAAiB,CAAA;IACzB,IAAI,EAAE,QAAQ,CAAA;CACf,CAuCA"}

package/dist/testing/logs.js

@@ -0,0 +1,53 @@
+function render(value) {
+    if (value instanceof Error)
+        return `${value.name}: ${value.message}`;
+    if (typeof value === 'string')
+        return value;
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+export function createTestLogs(mode = 'capture') {
+    const entries = [];
+    const write = (level, args) => {
+        if (mode !== 'silent') {
+            entries.push(Object.freeze({
+                level,
+                message: args.map(render).join(' '),
+                args: Object.freeze([...args]),
+            }));
+        }
+        if (mode === 'inherit')
+            console[level](...args);
+    };
+    const snapshot = (level) => Object.freeze(entries.filter((entry) => !level || entry.level === level).slice());
+    return {
+        logger: {
+            info: (...args) => write('info', args),
+            warn: (...args) => write('warn', args),
+            error: (...args) => write('error', args),
+        },
+        logs: {
+            get entries() {
+                return snapshot();
+            },
+            get errors() {
+                return snapshot('error');
+            },
+            get warnings() {
+                return snapshot('warn');
+            },
+            clear() {
+                entries.length = 0;
+            },
+        },
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/testing/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/testing/logs.ts"],"names":[],"mappings":"AAiBA,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAA;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAoB,SAAS;IAI1D,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,CAAC,KAA0B,EAAE,IAAe,EAAE,EAAE;QAC5D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CACV,MAAM,CAAC,MAAM,CAAC;gBACZ,KAAK;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACnC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;aAC/B,CAAC,CACH,CAAA;QACH,CAAC;QACD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,CAAC,KAA2B,EAAE,EAAE,CAC/C,MAAM,CAAC,MAAM,CACX,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CACnE,CAAA;IACH,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;YACtC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;YACtC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;SACzC;QACD,IAAI,EAAE;YACJ,IAAI,OAAO;gBACT,OAAO,QAAQ,EAAE,CAAA;YACnB,CAAC;YACD,IAAI,MAAM;gBACR,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC;YACD,IAAI,QAAQ;gBACV,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;YACzB,CAAC;YACD,KAAK;gBACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;YACpB,CAAC;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { WorkerstackLogger, WorkerstackLogLevel } from '../logging'\n\nexport type TestLogMode = 'capture' | 'inherit' | 'silent'\n\nexport type TestLogEntry = {\n  readonly level: WorkerstackLogLevel\n  readonly message: string\n  readonly args: readonly unknown[]\n}\n\nexport type TestLogs = {\n  readonly entries: readonly Readonly<TestLogEntry>[]\n  readonly errors: readonly Readonly<TestLogEntry>[]\n  readonly warnings: readonly Readonly<TestLogEntry>[]\n  clear(): void\n}\n\nfunction render(value: unknown): string {\n  if (value instanceof Error) return `${value.name}: ${value.message}`\n  if (typeof value === 'string') return value\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  try {\n    return JSON.stringify(value)\n  } catch {\n    return String(value)\n  }\n}\n\nexport function createTestLogs(mode: TestLogMode = 'capture'): {\n  logger: WorkerstackLogger\n  logs: TestLogs\n} {\n  const entries: TestLogEntry[] = []\n  const write = (level: WorkerstackLogLevel, args: unknown[]) => {\n    if (mode !== 'silent') {\n      entries.push(\n        Object.freeze({\n          level,\n          message: args.map(render).join(' '),\n          args: Object.freeze([...args]),\n        }),\n      )\n    }\n    if (mode === 'inherit') console[level](...args)\n  }\n  const snapshot = (level?: WorkerstackLogLevel) =>\n    Object.freeze(\n      entries.filter((entry) => !level || entry.level === level).slice(),\n    )\n  return {\n    logger: {\n      info: (...args) => write('info', args),\n      warn: (...args) => write('warn', args),\n      error: (...args) => write('error', args),\n    },\n    logs: {\n      get entries() {\n        return snapshot()\n      },\n      get errors() {\n        return snapshot('error')\n      },\n      get warnings() {\n        return snapshot('warn')\n      },\n      clear() {\n        entries.length = 0\n      },\n    },\n  }\n}\n"]}

package/dist/testing/messaging.d.ts

@@ -0,0 +1,21 @@
+import type { MessagingConfig } from '../messaging/index.js';
+import type { MessagingAdapter } from '../messaging/runtime.js';
+import type { TestEmail } from './email.js';
+export type TestMessagingChannel<TInput = unknown> = {
+    readonly sent: readonly Readonly<TInput>[];
+};
+type SendInput<T> = T extends {
+    send(input: infer TInput): unknown;
+} ? TInput : never;
+export type TestMessagingForApp<TApp> = TApp extends {
+    messaging: infer TMessaging extends Record<string, unknown>;
+} ? {
+    readonly [K in keyof TMessaging]: TestMessagingChannel<SendInput<TMessaging[K]>>;
+} : Record<never, never>;
+export declare function createTestMessaging(config: MessagingConfig | undefined): {
+    adapters: Record<string, MessagingAdapter>;
+    messaging: Record<string, TestMessagingChannel>;
+    authEmail: TestEmail;
+};
+export {};
+//# sourceMappingURL=messaging.d.ts.map

package/dist/testing/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/testing/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC,MAAM,MAAM,oBAAoB,CAAC,MAAM,GAAG,OAAO,IAAI;IACnD,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAA;CAC3C,CAAA;AAED,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,CAAC,KAAK,EAAE,MAAM,MAAM,GAAG,OAAO,CAAA;CAAE,GAChE,MAAM,GACN,KAAK,CAAA;AAET,MAAM,MAAM,mBAAmB,CAAC,IAAI,IAAI,IAAI,SAAS;IACnD,SAAS,EAAE,MAAM,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5D,GACG;IACE,QAAQ,EAAE,CAAC,IAAI,MAAM,UAAU,GAAG,oBAAoB,CACpD,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACzB;CACF,GACD,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAExB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG;IACxE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAC/C,SAAS,EAAE,SAAS,CAAA;CACrB,CAkCA"}

package/dist/testing/messaging.js

@@ -0,0 +1,34 @@
+import { createTestEmail } from './email.js';
+export function createTestMessaging(config) {
+    const adapters = {};
+    const messaging = {};
+    let authEmail;
+    for (const [channel, descriptor] of Object.entries(config ?? {})) {
+        if (descriptor.kind === 'email') {
+            const capture = createTestEmail();
+            adapters[channel] = capture.adapter;
+            messaging[channel] = capture.email;
+            if (channel === 'email')
+                authEmail = capture.email;
+            continue;
+        }
+        const messages = [];
+        adapters[channel] = {
+            async send(input) {
+                messages.push(structuredClone(input));
+                return { id: `test-${channel}-${messages.length}` };
+            },
+        };
+        messaging[channel] = {
+            get sent() {
+                return Object.freeze(messages.map((message) => Object.freeze(structuredClone(message))));
+            },
+        };
+    }
+    return {
+        adapters,
+        messaging,
+        authEmail: authEmail ?? createTestEmail().email,
+    };
+}
+//# sourceMappingURL=messaging.js.map

package/dist/testing/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../src/testing/messaging.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAoBzC,MAAM,UAAU,mBAAmB,CAAC,MAAmC;IAKrE,MAAM,QAAQ,GAAqC,EAAE,CAAA;IACrD,MAAM,SAAS,GAAyC,EAAE,CAAA;IAC1D,IAAI,SAAgC,CAAA;IAEpC,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAA;YACjC,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAA;YACnC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAA;YAClC,IAAI,OAAO,KAAK,OAAO;gBAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAA;YAClD,SAAQ;QACV,CAAC;QACD,MAAM,QAAQ,GAAc,EAAE,CAAA;QAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG;YAClB,KAAK,CAAC,IAAI,CAAC,KAAK;gBACd,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;gBACrC,OAAO,EAAE,EAAE,EAAE,QAAQ,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;YACrD,CAAC;SACF,CAAA;QACD,SAAS,CAAC,OAAO,CAAC,GAAG;YACnB,IAAI,IAAI;gBACN,OAAO,MAAM,CAAC,MAAM,CAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CACnE,CAAA;YACH,CAAC;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,SAAS,EAAE,SAAS,IAAI,eAAe,EAAE,CAAC,KAAK;KAChD,CAAA;AACH,CAAC","sourcesContent":["import type { MessagingConfig } from '../messaging'\nimport type { MessagingAdapter } from '../messaging/runtime'\nimport type { TestEmail } from './email'\n\nimport { createTestEmail } from './email'\n\nexport type TestMessagingChannel<TInput = unknown> = {\n  readonly sent: readonly Readonly<TInput>[]\n}\n\ntype SendInput<T> = T extends { send(input: infer TInput): unknown }\n  ? TInput\n  : never\n\nexport type TestMessagingForApp<TApp> = TApp extends {\n  messaging: infer TMessaging extends Record<string, unknown>\n}\n  ? {\n      readonly [K in keyof TMessaging]: TestMessagingChannel<\n        SendInput<TMessaging[K]>\n      >\n    }\n  : Record<never, never>\n\nexport function createTestMessaging(config: MessagingConfig | undefined): {\n  adapters: Record<string, MessagingAdapter>\n  messaging: Record<string, TestMessagingChannel>\n  authEmail: TestEmail\n} {\n  const adapters: Record<string, MessagingAdapter> = {}\n  const messaging: Record<string, TestMessagingChannel> = {}\n  let authEmail: TestEmail | undefined\n\n  for (const [channel, descriptor] of Object.entries(config ?? {})) {\n    if (descriptor.kind === 'email') {\n      const capture = createTestEmail()\n      adapters[channel] = capture.adapter\n      messaging[channel] = capture.email\n      if (channel === 'email') authEmail = capture.email\n      continue\n    }\n    const messages: unknown[] = []\n    adapters[channel] = {\n      async send(input) {\n        messages.push(structuredClone(input))\n        return { id: `test-${channel}-${messages.length}` }\n      },\n    }\n    messaging[channel] = {\n      get sent() {\n        return Object.freeze(\n          messages.map((message) => Object.freeze(structuredClone(message))),\n        )\n      },\n    }\n  }\n\n  return {\n    adapters,\n    messaging,\n    authEmail: authEmail ?? createTestEmail().email,\n  }\n}\n"]}

package/dist/testing/storage.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedStorageBuckets, StorageConfigInput } from '../storage/buckets.js';
+export type TestStorage = {
+    read(key: string): Promise<Uint8Array>;
+};
+export declare function resolveTestBuckets(input: StorageConfigInput | undefined, root: string): ResolvedStorageBuckets;
+export declare function createTestStorage(resolved: ResolvedStorageBuckets): TestStorage;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/testing/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAK3B,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACvC,CAAA;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,IAAI,EAAE,MAAM,GACX,sBAAsB,CAWxB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,sBAAsB,GAC/B,WAAW,CAcb"}