devflare 1.0.0-next.5 → 1.0.0-next.50

package/dist/test/alarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm.d.ts","sourceRoot":"","sources":["../../src/test/alarm.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;IACvC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,GAAG,CAAC,EAAE,kBAAkB,CAAA;IACxB,GAAG,CAAC,EAAE,OAAO,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IACnC;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;CACb;AAED,MAAM,WAAW,kBAAkB;IAClC,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAe,OAAO,CACrB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAMD,eAAO,MAAM,KAAK;;CAEjB,CAAA"}

package/dist/test/binding-hints.d.ts

@@ -0,0 +1,10 @@
+import type { BindingHints } from '../bridge/proxy.js';
+import type { DevflareConfig } from '../config/index.js';
+/**
+ * Derive `BindingHints` from a resolved Devflare config.
+ *
+ * Shared by the test-context surface (`createTestContext` / simple-context) so
+ * the mapping between config sections and hint kinds lives in one place.
+ */
+export declare function extractBindingHints(config: DevflareConfig): BindingHints;
+//# sourceMappingURL=binding-hints.d.ts.map

package/dist/test/binding-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-hints.d.ts","sourceRoot":"","sources":["../../src/test/binding-hints.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAqDxE"}

package/dist/test/cf.d.ts

@@ -1,25 +1,32 @@
-export { email } from './email';
-export { queue } from './queue';
-export { scheduled } from './scheduled';
-export { worker } from './worker';
-export { tail } from './tail';
-export type { EmailSendOptions, ReceivedEmail, EmailReceiveCallback } from './email';
-export type { QueueMessageOptions, QueueTriggerResult } from './queue';
-export type { ScheduledTriggerOptions, ScheduledTriggerResult } from './scheduled';
-export type { WorkerFetchOptions } from './worker';
-export type { TraceItemOptions, TailTriggerResult } from './tail';
+export { alarm } from './alarm.js';
+export { email } from './email.js';
+export { queue } from './queue.js';
+export { scheduled } from './scheduled.js';
+export { worker } from './worker.js';
+export { tail } from './tail.js';
+export type { AlarmTriggerTarget, AlarmTriggerOptions, AlarmTriggerResult } from './alarm.js';
+export type { EmailSendOptions, ReceivedEmail, EmailReceiveCallback } from './email.js';
+export type { QueueMessageOptions, QueueTriggerResult } from './queue.js';
+export type { ScheduledTriggerOptions, ScheduledTriggerResult } from './scheduled.js';
+export type { WorkerFetchOptions } from './worker.js';
+export type { TraceItemOptions, TailTriggerResult } from './tail.js';
 /**
  * Unified Cloudflare test helpers.
  *
- * Provides a consistent API for triggering all Cloudflare Worker handler types:
- * - `cf.email` — Email handler testing
+ * Provides a consistent API for triggering the main Cloudflare Worker handler surfaces:
+ * - `cf.email` — Email helper surface with a direct-handler path and a best-effort local endpoint fallback
  * - `cf.queue` — Queue consumer testing
  * - `cf.scheduled` — Cron/scheduled handler testing
  * - `cf.worker` — Fetch handler testing
- * - `cf.tail` — Tail worker testing
+ * - `cf.tail` — Tail helper surface (uses `files.tail`, or auto-detects `src/tail.ts` when present)
+ * - `cf.alarm` — Durable Object alarm handler testing (fires a DO instance's `alarm()`)
  *
- * All handlers use **real Miniflare bindings** from `createTestContext()`.
- * No mocks — your tests run against actual KV, D1, R2, DO, etc.
+ * The helpers use the real Miniflare-backed bindings created by `createTestContext()`,
+ * but several helper surfaces still synthesize event/controller objects around those
+ * bindings rather than replaying the full Cloudflare runtime dispatch path.
+ * They still install the active Devflare event into AsyncLocalStorage before
+ * invoking user code, so getters such as `getFetchEvent()` and `getQueueEvent()`
+ * work inside the triggered handler.
  *
  * @example
  * ```ts
@@ -60,17 +67,21 @@ export type { TraceItemOptions, TailTriggerResult } from './tail';
  */
 export declare const cf: {
     /**
-     * Email handler testing.
+     * Email helper surface.
      *
-     * - `cf.email.send(options)` — Send email to your handler
-     * - `cf.email.onReceive(callback)` — Listen for outgoing emails
-     * - `cf.email.getSentEmails()` — Get all sent emails
-     * - `cf.email.clearSentEmails()` — Clear sent email history
+     * - `cf.email.send(options)` — Send a raw email through the helper
+     * - `cf.email.onReceive(callback)` — Observe outgoing emails when runtime wiring records them
+     * - `cf.email.getSentEmails()` — Read recorded outgoing emails
+     * - `cf.email.clearSentEmails()` — Clear recorded outgoing email history
+     *
+     * When `createTestContext()` has configured an email handler, this invokes it directly.
+     * Otherwise it attempts the local `/cdn-cgi/handler/email` endpoint when the
+     * runtime exposes it.
      */
     email: {
-        send: (options: import("./email").EmailSendOptions) => Promise<Response>;
-        onReceive: (callback: import("./email").EmailReceiveCallback) => () => void;
-        getSentEmails: () => import("./email").ReceivedEmail[];
+        send: (options: import("./email.js").EmailSendOptions) => Promise<Response>;
+        onReceive: (callback: import("./email.js").EmailReceiveCallback) => () => void;
+        getSentEmails: () => import("./email.js").ReceivedEmail[];
         clearSentEmails: () => void;
     };
     /**
@@ -82,8 +93,8 @@ export declare const cf: {
      * Returns result with `acked`, `retried`, `failed` message IDs.
      */
     queue: {
-        trigger: <T = unknown>(messages: (T | import("./queue").QueueMessageOptions<T>)[]) => Promise<import("./queue").QueueTriggerResult>;
-        send: <T = unknown>(message: T | import("./queue").QueueMessageOptions<T>) => Promise<import("./queue").QueueTriggerResult>;
+        trigger: <T = unknown>(messages: Array<import("./queue.js").QueueMessageOptions<T> | T>) => Promise<import("./queue.js").QueueTriggerResult>;
+        send: <T = unknown>(message: import("./queue.js").QueueMessageOptions<T> | T) => Promise<import("./queue.js").QueueTriggerResult>;
     };
     /**
      * Scheduled (cron) handler testing.
@@ -96,7 +107,7 @@ export declare const cf: {
      * await cf.scheduled.trigger('0 0 * * 1')    // Weekly Monday
      */
     scheduled: {
-        trigger: (cronOrOptions?: string | import("./scheduled").ScheduledTriggerOptions | undefined) => Promise<import("./scheduled").ScheduledTriggerResult>;
+        trigger: (cronOrOptions?: string | import("./scheduled.js").ScheduledTriggerOptions) => Promise<import("./scheduled.js").ScheduledTriggerResult>;
     };
     /**
      * Fetch (HTTP) handler testing.
@@ -107,24 +118,49 @@ export declare const cf: {
      * - `cf.worker.put(path, body, headers)` — PUT shorthand
      * - `cf.worker.patch(path, body, headers)` — PATCH shorthand
      * - `cf.worker.delete(path, headers)` — DELETE shorthand
+     *
+     * `cf.worker` dispatches through both `src/fetch.ts` and built-in
+     * `src/routes/**` file routes when they are present.
      */
     worker: {
-        fetch: (request: string | Request<unknown, CfProperties<unknown>>, options?: import("./worker").WorkerFetchOptions | undefined) => Promise<Response>;
-        get: (path: string, headers?: Record<string, string> | undefined) => Promise<Response>;
-        post: (path: string, body?: unknown, headers?: Record<string, string> | undefined) => Promise<Response>;
-        put: (path: string, body?: unknown, headers?: Record<string, string> | undefined) => Promise<Response>;
-        delete: (path: string, headers?: Record<string, string> | undefined) => Promise<Response>;
-        patch: (path: string, body?: unknown, headers?: Record<string, string> | undefined) => Promise<Response>;
+        fetch: (request: Request | string, options?: import("./worker.js").WorkerFetchOptions) => Promise<Response>;
+        get: (path: string, headers?: Record<string, string>) => Promise<Response>;
+        post: (path: string, body?: unknown, headers?: Record<string, string>) => Promise<Response>;
+        put: (path: string, body?: unknown, headers?: Record<string, string>) => Promise<Response>;
+        delete: (path: string, headers?: Record<string, string>) => Promise<Response>;
+        patch: (path: string, body?: unknown, headers?: Record<string, string>) => Promise<Response>;
     };
     /**
-     * Tail worker testing.
+     * Tail helper surface.
      *
      * - `cf.tail.trigger(events)` — Trigger tail handler with trace items
      * - `cf.tail.create(options)` — Create a TraceItem with defaults
+     *
+     * When `createTestContext()` finds `files.tail` or `src/tail.ts`,
+     * `cf.tail.trigger()` is wired automatically.
      */
     tail: {
-        trigger: (items: (import("@cloudflare/workers-types").TraceItem | import("./tail").TraceItemOptions)[]) => Promise<import("./tail").TailTriggerResult>;
-        create: (options?: import("./tail").TraceItemOptions) => import("@cloudflare/workers-types").TraceItem;
+        trigger: (items: Array<import("@cloudflare/workers-types").TraceItem | import("./tail.js").TraceItemOptions>) => Promise<import("./tail.js").TailTriggerResult>;
+        create: (options?: import("./tail.js").TraceItemOptions) => import("@cloudflare/workers-types").TraceItem;
+    };
+    /**
+     * Durable Object alarm handler testing.
+     *
+     * - `cf.alarm.trigger(instance, options?)` — Fire a DO instance's `alarm()`
+     *   handler under a `durable-object-alarm` event context and assert effects.
+     *
+     * Unlike the other surfaces this operates directly on a Durable Object
+     * instance you construct in the test (it does not resolve a handler file),
+     * mirroring how the Devflare DO wrapper invokes `alarm()` at runtime.
+     *
+     * @example
+     * const counter = new Counter(state, env)
+     * await counter.scheduleAlarm()
+     * const result = await cf.alarm.trigger(counter)
+     * expect(result.success).toBe(true)
+     */
+    alarm: {
+        trigger: (target: import("./alarm.js").AlarmTriggerTarget, options?: import("./alarm.js").AlarmTriggerOptions) => Promise<import("./alarm.js").AlarmTriggerResult>;
     };
 };
 //# sourceMappingURL=cf.d.ts.map

package/dist/test/cf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cf.d.ts","sourceRoot":"","sources":["../../src/test/cf.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACpF,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAClF,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,EAAE;IACd;;;;;;;OAOG;;;;;;;IAGH;;;;;;;OAOG;;;;;IAGH;;;;;;;;;OASG;;;;IAGH;;;;;;;;;OASG;;;;;;;;;IAGH;;;;;OAKG;;;;;CAEH,CAAA"}
+{"version":3,"file":"cf.d.ts","sourceRoot":"","sources":["../../src/test/cf.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC1F,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACpF,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAClF,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,EAAE;IACd;;;;;;;;;;;OAWG;;;;;;;IAGH;;;;;;;OAOG;;;;;IAGH;;;;;;;;;OASG;;;;IAGH;;;;;;;;;;;;OAYG;;;;;;;;;IAGH;;;;;;;;OAQG;;;;;IAGH;;;;;;;;;;;;;;;OAeG;;;;CAEH,CAAA"}

package/dist/test/containers.d.ts

@@ -0,0 +1,87 @@
+export type ContainerEngineName = 'docker' | 'podman';
+export type ContainerEnginePreference = ContainerEngineName | 'auto';
+export interface ContainerCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface ContainerCommandRunner {
+    exec(command: string, args: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string | undefined>;
+        timeoutMs?: number;
+    }): Promise<ContainerCommandResult>;
+}
+export interface ContainerEngineCheck {
+    engine: ContainerEngineName;
+    available: boolean;
+    reason?: string;
+}
+export type ContainerEngineStatus = {
+    available: true;
+    engine: ContainerEngineName;
+    checked: ContainerEngineCheck[];
+} | {
+    available: false;
+    reason: string;
+    checked: ContainerEngineCheck[];
+};
+export interface DetectContainerEngineOptions {
+    engine?: ContainerEnginePreference;
+    runner?: ContainerCommandRunner;
+}
+export interface ContainerSkipReasonOptions extends DetectContainerEngineOptions {
+    env?: Record<string, string | undefined>;
+}
+export interface ContainerManagerOptions extends DetectContainerEngineOptions {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    allocatePort?: () => Promise<number>;
+    waitForPort?: (host: string, port: number, timeoutMs: number) => Promise<void>;
+    fetch?: typeof fetch;
+}
+export interface StartContainerOptions {
+    image?: string;
+    configPath?: string;
+    port: number;
+    hostPort?: number;
+    host?: string;
+    instance?: string;
+    envVars?: Record<string, string>;
+    entrypoint?: string[];
+    command?: string[];
+    offline?: boolean;
+    waitForReady?: boolean;
+    readyTimeoutMs?: number;
+}
+export interface LocalContainerState {
+    status: string;
+    running: boolean;
+    exitCode?: number;
+}
+export interface DevflareContainerInstance {
+    readonly name: string;
+    readonly id: string;
+    readonly className: string;
+    readonly engine: ContainerEngineName;
+    readonly host: string;
+    readonly hostPort: number;
+    readonly port: number;
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    logs(): Promise<string>;
+    getState(): Promise<LocalContainerState>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+}
+export interface ContainerManager {
+    detectEngine(options?: DetectContainerEngineOptions): Promise<ContainerEngineStatus>;
+    start(className: string, options: StartContainerOptions): Promise<DevflareContainerInstance>;
+    stopAll(): Promise<void>;
+}
+export declare const realContainerCommandRunner: ContainerCommandRunner;
+export declare function detectContainerEngine(options?: DetectContainerEngineOptions): Promise<ContainerEngineStatus>;
+export declare function getContainerSkipReason(options?: ContainerSkipReasonOptions): Promise<string | null>;
+export declare function createContainerManager(options?: ContainerManagerOptions): ContainerManager;
+export declare const containers: ContainerManager;
+export declare function stopActiveContainers(): Promise<void>;
+//# sourceMappingURL=containers.d.ts.map

package/dist/test/containers.d.ts.map

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

package/dist/test/email.d.ts

@@ -35,29 +35,38 @@ export type EmailReceiveCallback = (email: ReceivedEmail) => void;
  */
 export declare function configureEmail(options?: {
     port?: number;
+    handlerPath?: string | null;
+    configDir?: string;
+    getEnv?: () => Record<string, unknown>;
 }): void;
 /**
- * Send an email to the worker's email() handler
- * This simulates an incoming email being received by your worker
+ * Send an incoming email through the email test helper.
+ *
+ * When `createTestContext()` has configured an email handler, this imports and
+ * invokes that handler directly and waits for queued `waitUntil()` work.
+ * Otherwise it attempts the local `/cdn-cgi/handler/email` endpoint exposed by
+ * compatible local runtimes.
  */
 declare function send(options: EmailSendOptions): Promise<Response>;
 /**
- * Register a callback for outgoing emails
- * Called when the worker uses env.EMAIL.send(), message.forward(), or message.reply()
+ * Register a callback for outgoing emails.
+ *
+ * This only fires when the surrounding runtime wiring records outgoing emails.
  * @returns Unsubscribe function
  */
 declare function onReceive(callback: EmailReceiveCallback): () => void;
 /**
- * Get all sent emails since test context was created
+ * Get all recorded outgoing emails since test context was created
  */
 declare function getSentEmails(): ReceivedEmail[];
 /**
- * Clear sent emails history
+ * Clear recorded outgoing email history
  */
 declare function clearSentEmails(): void;
 /**
  * Add a sent email to the history
- * @internal Called by the gateway worker when email is sent
+ * @internal Called by helper paths that explicitly record outgoing email
+ * (currently direct `forward()`/`reply()` test flows).
  */
 export declare function recordSentEmail(email: ReceivedEmail): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/test/email.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,gBAAgB;IAChC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAClC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAA;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAcjE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAIpE;AA6CD;;;GAGG;AACH,iBAAe,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgBhE;AAED;;;;GAIG;AACH,iBAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAK7D;AAED;;GAEG;AACH,iBAAS,aAAa,IAAI,aAAa,EAAE,CAExC;AAED;;GAEG;AACH,iBAAS,eAAe,IAAI,IAAI,CAE/B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAS1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAMD,eAAO,MAAM,KAAK;;;;;CAKjB,CAAA"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/test/email.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,gBAAgB;IAChC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAClC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAA;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAiBjE;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,OAAO,GAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,GACJ,IAAI,CAQN;AAwGD;;;;;;;GAOG;AACH,iBAAe,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+EhE;AAED;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAK7D;AAED;;GAEG;AACH,iBAAS,aAAa,IAAI,aAAa,EAAE,CAExC;AAED;;GAEG;AACH,iBAAS,eAAe,IAAI,IAAI,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAS1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAOtC;AAMD,eAAO,MAAM,KAAK;;;;;CAKjB,CAAA"}

package/dist/test/index.d.ts

@@ -1,22 +1,21 @@
-export { createTestContext, env, type DevflareEnv, type TestEnv } from './simple-context';
-export { cf } from './cf';
-export { email } from './email';
-export { queue } from './queue';
-export { scheduled } from './scheduled';
-export { worker } from './worker';
-export { tail } from './tail';
-export type { EmailSendOptions, ReceivedEmail, EmailReceiveCallback } from './email';
-export type { QueueMessageOptions, QueueTriggerResult } from './queue';
-export type { ScheduledTriggerOptions, ScheduledTriggerResult } from './scheduled';
-export type { WorkerFetchOptions } from './worker';
-export type { TraceItemOptions, TailTriggerResult } from './tail';
-export { hasServiceBindings, resolveServiceBindings, hasCrossWorkerDOs, resolveDOBindings, clearBundleCache, type ResolvedWorker, type ServiceBindingResolution, type DOBindingResolution } from './resolve-service-bindings';
-export { 
-/** @deprecated Use createTestContext() instead */
-createMultiWorkerContext, 
-/** @deprecated Use worker.ts pattern instead */
-createEntrypointScript, type WorkerConfig, type MultiWorkerContextOptions, type MultiWorkerContext } from './multi-worker-context';
-export { shouldSkip, isRemoteModeEnabled } from './should-skip';
-export { createMockTestContext, createMockKV, createMockD1, createMockR2, createMockQueue, createMockEnv, withTestContext, type TestContext, type TestContextOptions, type MockEnvOptions } from './utilities';
-export { createBridgeTestContext, stopBridgeTestContext, getBridgeTestContext, testEnv, type BridgeTestContext, type BridgeTestContextOptions } from './bridge-context';
+export { createTestContext, env, type DevflareEnv, type TestEnv } from './simple-context.js';
+export { cf } from './cf.js';
+export { alarm } from './alarm.js';
+export { email } from './email.js';
+export { queue } from './queue.js';
+export { scheduled } from './scheduled.js';
+export { worker } from './worker.js';
+export { tail } from './tail.js';
+export type { AlarmTriggerTarget, AlarmTriggerOptions, AlarmTriggerResult } from './alarm.js';
+export type { EmailSendOptions, ReceivedEmail, EmailReceiveCallback } from './email.js';
+export type { QueueMessageOptions, QueueTriggerResult } from './queue.js';
+export type { ScheduledTriggerOptions, ScheduledTriggerResult } from './scheduled.js';
+export type { WorkerFetchOptions } from './worker.js';
+export type { TraceItemOptions, TailTriggerResult } from './tail.js';
+export { hasServiceBindings, resolveServiceBindings, hasCrossWorkerDOs, resolveDOBindings, clearBundleCache, type ResolvedWorker, type ServiceBindingResolution, type DOBindingResolution } from './resolve-service-bindings.js';
+export { shouldSkip } from './should-skip.js';
+export { containers, createContainerManager, detectContainerEngine, getContainerSkipReason, stopActiveContainers, type ContainerCommandResult, type ContainerCommandRunner, type ContainerEngineCheck, type ContainerEngineName, type ContainerEnginePreference, type ContainerEngineStatus, type ContainerManager, type ContainerManagerOptions, type DevflareContainerInstance, type LocalContainerState, type StartContainerOptions } from './containers.js';
+export { createOfflineBindings, createOfflineEnv, describeOfflineSupport, getOfflineSupportMatrix, type OfflineBindingFixtures, type OfflineBindingsResult, type OfflineMissingFixture, type OfflineRemoteBoundary, type OfflineSupportEntry, type OfflineSupportTier } from './offline-bindings.js';
+export { createMockAISearchInstance, createMockAISearchNamespace, type MockAISearchInstance, type MockAISearchInstanceOptions, type MockAISearchItemFixture, type MockAISearchNamespace, type MockAISearchNamespaceOptions } from './ai-search.js';
+export { createMockTestContext, createMockKV, createMockD1, createMockR2, createMockQueue, createMockRateLimit, createMockVersionMetadata, createMockHyperdrive, createMockWorkerLoader, createMockMTLSCertificate, createMockDispatchNamespace, createMockWorkflow, createMockPipeline, createMockImagesBinding, createMockMediaBinding, createMockStreamBinding, createMockFlagshipBinding, createMockArtifacts, createMockVectorize, createMockAnalyticsEngine, createMockSecretsStoreSecret, createMockEnv, withTestContext, type TestContext, type TestContextOptions, type MockEnvOptions, type MockRateLimitOptions, type MockWorkerLoaderOptions, type MockFetchInput, type MockFetcherHandler, type MockDispatchNamespaceOptions, type MockWorkflowOptions, type MockWorkflowInstanceOptions, type MockPipeline, type MockImagesBindingOptions, type MockMediaBindingOptions, type MockStreamBindingOptions, type MockFlagshipBindingOptions, type MockArtifactsOptions, type MockVectorizeOptions, type MockVectorizeIndex, type MockAnalyticsEngineDataset } from './utilities.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,iBAAiB,EACjB,GAAG,EACH,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAA;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AACpF,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAClF,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAGjE,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,MAAM,4BAA4B,CAAA;AAInC,OAAO;AACN,kDAAkD;AAClD,wBAAwB;AACxB,gDAAgD;AAChD,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAG/D,OAAO,EACN,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,OAAO,EACP,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"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"}