devflare 0.0.0 → 1.0.0-next.0

package/dist/test/index.d.ts

@@ -0,0 +1,22 @@
+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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/test/index.js

@@ -0,0 +1,71 @@
+import {
+  cf,
+  clearBundleCache,
+  createBridgeTestContext,
+  createEntrypointScript,
+  createMockD1,
+  createMockEnv,
+  createMockKV,
+  createMockQueue,
+  createMockR2,
+  createMockTestContext,
+  createMultiWorkerContext,
+  createTestContext,
+  email,
+  env,
+  getBridgeTestContext,
+  hasCrossWorkerDOs,
+  hasServiceBindings,
+  isRemoteModeEnabled,
+  queue,
+  resolveDOBindings,
+  resolveServiceBindings,
+  scheduled,
+  shouldSkip,
+  stopBridgeTestContext,
+  tail,
+  testEnv,
+  withTestContext,
+  worker
+} from "../index-ep3445yc.js";
+import"../index-z14anrqp.js";
+import"../index-tk6ej9dj.js";
+import"../index-d8bdkx2h.js";
+import"../index-rbht7m9r.js";
+import"../index-gz1gndna.js";
+import"../index-pf5s73n9.js";
+import"../index-07q6yxyc.js";
+import"../index-67qcae0f.js";
+import"../index-hcex3rgh.js";
+import"../index-tfyxa77h.js";
+import"../index-37x76zdn.js";
+export {
+  worker,
+  withTestContext,
+  testEnv,
+  tail,
+  stopBridgeTestContext,
+  shouldSkip,
+  scheduled,
+  resolveServiceBindings,
+  resolveDOBindings,
+  queue,
+  isRemoteModeEnabled,
+  hasServiceBindings,
+  hasCrossWorkerDOs,
+  getBridgeTestContext,
+  env,
+  email,
+  createTestContext,
+  createMultiWorkerContext,
+  createMockTestContext,
+  createMockR2,
+  createMockQueue,
+  createMockKV,
+  createMockEnv,
+  createMockD1,
+  createEntrypointScript,
+  createBridgeTestContext,
+  clearBundleCache,
+  cf
+};

package/dist/test/multi-worker-context.d.ts

@@ -0,0 +1,114 @@
+import type { Miniflare } from 'miniflare';
+/**
+ * Configuration for a worker in a multi-worker test
+ */
+export interface WorkerConfig {
+    /** Worker name (used for service binding references) */
+    name: string;
+    /** Worker script code as string */
+    script: string;
+    /** Whether the script uses ES modules (default: true) */
+    modules?: boolean;
+    /** Compatibility date (default: '2025-01-01') */
+    compatibilityDate?: string;
+    /**
+     * Service bindings to other workers
+     * Key: binding name, Value: worker name or { name, entrypoint }
+     */
+    serviceBindings?: Record<string, string | {
+        name: string;
+        entrypoint: string;
+    }>;
+}
+/**
+ * Options for creating a multi-worker test context
+ */
+export interface MultiWorkerContextOptions {
+    /** Array of worker configurations */
+    workers: WorkerConfig[];
+    /**
+     * Name of the primary worker (receives HTTP requests)
+     * Defaults to first worker in the array
+     */
+    primary?: string;
+}
+/**
+ * Result of creating a multi-worker test context
+ */
+export interface MultiWorkerContext<TEnv = Record<string, unknown>> {
+    /** Miniflare instance */
+    mf: Miniflare;
+    /** Environment bindings from the primary worker */
+    env: TEnv;
+    /** Dispatch a fetch request to the primary worker */
+    fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    /** Dispose of the context (cleanup) */
+    dispose: () => Promise<void>;
+}
+/**
+ * @deprecated Use `createTestContext()` instead. It now automatically detects service bindings
+ * from `ref()` metadata in your devflare.config.ts and sets up multi-worker Miniflare.
+ *
+ * Create a multi-worker test context for testing RPC between workers.
+ *
+ * @example
+ * ```ts
+ * const gatewayScript = `
+ * export default {
+ *   async fetch(request, env) {
+ *     const sum = await env.MATH.add(1, 2)
+ *     return Response.json({ sum })
+ *   }
+ * }
+ * `
+ *
+ * const mathScript = `
+ * import { WorkerEntrypoint } from 'cloudflare:workers'
+ * export class MathService extends WorkerEntrypoint {
+ *   add(a, b) { return a + b }
+ * }
+ * `
+ *
+ * const ctx = await createMultiWorkerContext({
+ *   workers: [
+ *     { name: 'gateway', script: gatewayScript, serviceBindings: { MATH: { name: 'math', entrypoint: 'MathService' } } },
+ *     { name: 'math', script: mathScript }
+ *   ],
+ *   primary: 'gateway'
+ * })
+ *
+ * // Direct RPC test
+ * const sum = await ctx.env.MATH.add(1, 2)
+ * expect(sum).toBe(3)
+ *
+ * // HTTP test (gateway using RPC internally)
+ * const response = await ctx.fetch('http://localhost/')
+ * const data = await response.json()
+ * expect(data.sum).toBe(3)
+ *
+ * await ctx.dispose()
+ * ```
+ */
+export declare function createMultiWorkerContext<TEnv = Record<string, unknown>>(options: MultiWorkerContextOptions): Promise<MultiWorkerContext<TEnv>>;
+/**
+ * @deprecated Use `worker.ts` files with exported functions instead. devflare automatically
+ * transforms these into WorkerEntrypoint classes during bundling.
+ *
+ * Helper to create a WorkerEntrypoint class script from exported functions.
+ * Use this when you want to test against the transformed version of a worker.ts file.
+ *
+ * @example
+ * ```ts
+ * const script = createEntrypointScript('MathService', {
+ *   add: '(a, b) { return a + b }',
+ *   multiply: '(a, b) { return a * b }'
+ * })
+ * // Result: import { WorkerEntrypoint } from 'cloudflare:workers'
+ * //         export class MathService extends WorkerEntrypoint {
+ * //           add(a, b) { return a + b }
+ * //           multiply(a, b) { return a * b }
+ * //         }
+ * ```
+ */
+export declare function createEntrypointScript(className: string, methods: Record<string, string>): string;
+//# sourceMappingURL=multi-worker-context.d.ts.map

package/dist/test/multi-worker-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-worker-context.d.ts","sourceRoot":"","sources":["../../src/test/multi-worker-context.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAM1C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IAEZ,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IAEd,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,qCAAqC;IACrC,OAAO,EAAE,YAAY,EAAE,CAAA;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,yBAAyB;IACzB,EAAE,EAAE,SAAS,CAAA;IAEb,mDAAmD;IACnD,GAAG,EAAE,IAAI,CAAA;IAET,qDAAqD;IACrD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE/E,uCAAuC;IACvC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAiEnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAWR"}

package/dist/test/queue.d.ts

@@ -0,0 +1,74 @@
+export interface QueueMessageOptions<T = unknown> {
+    /** Unique message ID (auto-generated if not provided) */
+    id?: string;
+    /** Message body */
+    body: T;
+    /** Timestamp when message was enqueued (defaults to now) */
+    timestamp?: Date;
+    /** Number of times this message has been retried */
+    attempts?: number;
+}
+export interface QueueTriggerResult {
+    /** Messages that were acknowledged */
+    acked: string[];
+    /** Messages that were retried */
+    retried: string[];
+    /** Messages that were explicitly failed with noRetry */
+    failed: string[];
+    /** Total messages processed */
+    total: number;
+}
+/**
+ * Configure the queue test helper
+ * @internal Called by createTestContext to set up handler path and env
+ */
+export declare function configureQueue(options: {
+    handlerPath: string | null;
+    configDir: string;
+    getEnv: () => Record<string, unknown>;
+}): void;
+/**
+ * Reset queue helper state
+ * @internal Called when test context is disposed
+ */
+export declare function resetQueueState(): void;
+/**
+ * Trigger the queue handler with a batch of messages.
+ * This directly invokes the queue handler function from your config.
+ *
+ * @param messages - Array of message options or bodies
+ * @returns Result object with acked/retried/failed message IDs
+ *
+ * @example
+ * ```ts
+ * // Trigger with message bodies (IDs auto-generated)
+ * const result = await cf.queue.trigger([
+ *   { type: 'process', data: { x: 1 } },
+ *   { type: 'cleanup', data: {} }
+ * ])
+ *
+ * // Trigger with full message options
+ * const result = await cf.queue.trigger([
+ *   { id: 'msg-1', body: { type: 'process' }, attempts: 2 }
+ * ])
+ * ```
+ */
+declare function trigger<T = unknown>(messages: Array<QueueMessageOptions<T> | T>): Promise<QueueTriggerResult>;
+/**
+ * Convenience method to trigger the queue handler with a single message.
+ *
+ * @param message - Message body or options
+ * @returns Result object
+ *
+ * @example
+ * ```ts
+ * await cf.queue.send({ type: 'process', data: { x: 1 } })
+ * ```
+ */
+declare function send<T = unknown>(message: QueueMessageOptions<T> | T): Promise<QueueTriggerResult>;
+export declare const queue: {
+    trigger: typeof trigger;
+    send: typeof send;
+};
+export {};
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/test/queue.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC/C,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,mBAAmB;IACnB,IAAI,EAAE,CAAC,CAAA;IACP,4DAA4D;IAC5D,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;CACb;AAcD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,GAAG,IAAI,CAIP;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AA+DD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAe,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GACzC,OAAO,CAAC,kBAAkB,CAAC,CAuF7B;AAED;;;;;;;;;;GAUG;AACH,iBAAe,IAAI,CAAC,CAAC,GAAG,OAAO,EAC9B,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAMD,eAAO,MAAM,KAAK;;;CAGjB,CAAA"}

package/dist/test/remote-ai.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a remote AI binding that calls Cloudflare's REST API.
+ * Matches the Workers AI binding interface.
+ */
+export declare function createRemoteAI(accountId?: string): Ai;
+//# sourceMappingURL=remote-ai.d.ts.map

package/dist/test/remote-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-ai.d.ts","sourceRoot":"","sources":["../../src/test/remote-ai.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,EAAE,CAqErD"}

package/dist/test/remote-vectorize.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a remote Vectorize binding that calls Cloudflare's REST API.
+ * Matches the Workers Vectorize binding interface.
+ */
+export declare function createRemoteVectorize(indexName: string, accountId?: string): VectorizeIndex;
+//# sourceMappingURL=remote-vectorize.d.ts.map

package/dist/test/remote-vectorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-vectorize.d.ts","sourceRoot":"","sources":["../../src/test/remote-vectorize.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAyJ3F"}

package/dist/test/resolve-service-bindings.d.ts

@@ -0,0 +1,68 @@
+import { type DevflareConfig } from '../config';
+/**
+ * Clear the bundle cache (useful between test suites)
+ */
+export declare function clearBundleCache(): void;
+/**
+ * Resolved worker configuration for Miniflare
+ */
+export interface ResolvedWorker {
+    /** Worker name */
+    name: string;
+    /** Bundled script code */
+    script: string;
+    /** Whether the script uses ES modules */
+    modules: boolean;
+    /** Compatibility date */
+    compatibilityDate: string;
+    /** Service bindings to other workers */
+    serviceBindings?: Record<string, {
+        name: string;
+        entrypoint?: string;
+    }>;
+    /** Durable Object bindings (className → wrapperClassName) */
+    durableObjects?: Record<string, string>;
+}
+/**
+ * Result of resolving service bindings
+ */
+export interface ServiceBindingResolution {
+    /** All resolved workers (including primary) */
+    workers: ResolvedWorker[];
+    /** Service bindings for the primary worker */
+    primaryServiceBindings: Record<string, {
+        name: string;
+        entrypoint?: string;
+    }>;
+}
+/**
+ * Check if a config has service bindings that need multi-worker setup
+ */
+export declare function hasServiceBindings(config: DevflareConfig): boolean;
+/**
+ * Resolve service bindings from a config
+ * Returns the workers array and service bindings for Miniflare setup
+ */
+export declare function resolveServiceBindings(config: DevflareConfig, configDir: string): Promise<ServiceBindingResolution>;
+/**
+ * Result of resolving cross-worker DO bindings
+ */
+export interface DOBindingResolution {
+    /** Workers that host cross-worker DOs */
+    workers: ResolvedWorker[];
+    /** DO bindings for the primary worker (pointing to cross-worker DO hosting workers) */
+    crossWorkerDOBindings: Record<string, {
+        className: string;
+        scriptName: string;
+    }>;
+}
+/**
+ * Check if a config has cross-worker DO bindings
+ */
+export declare function hasCrossWorkerDOs(config: DevflareConfig): boolean;
+/**
+ * Resolve cross-worker DO bindings
+ * Returns workers to set up and DO bindings for the primary worker
+ */
+export declare function resolveDOBindings(config: DevflareConfig, configDir: string): Promise<DOBindingResolution>;
+//# sourceMappingURL=resolve-service-bindings.d.ts.map

package/dist/test/resolve-service-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-service-bindings.d.ts","sourceRoot":"","sources":["../../src/test/resolve-service-bindings.ts"],"names":[],"mappings":"AASA,OAAO,EAAsB,KAAK,cAAc,EAAgD,MAAM,WAAW,CAAA;AAgFjH;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvE,+DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,8CAA8C;IAC9C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7E;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAIlE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CAkDnC;AAwLD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,uFAAuF;IACvF,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAQjE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAgD9B"}

package/dist/test/scheduled.d.ts

@@ -0,0 +1,58 @@
+export interface ScheduledTriggerOptions {
+    /** Cron expression that triggered this event */
+    cron?: string;
+    /** Scheduled time (defaults to now) */
+    scheduledTime?: number | Date;
+}
+export interface ScheduledTriggerResult {
+    /** Whether the handler completed successfully */
+    success: boolean;
+    /** Error message if handler threw */
+    error?: string;
+    /** Cron expression used */
+    cron: string;
+    /** Scheduled time */
+    scheduledTime: number;
+}
+/**
+ * Configure the scheduled test helper
+ * @internal Called by createTestContext to set up handler path and env
+ */
+export declare function configureScheduled(options: {
+    handlerPath: string | null;
+    configDir: string;
+    getEnv: () => Record<string, unknown>;
+}): void;
+/**
+ * Reset scheduled helper state
+ * @internal Called when test context is disposed
+ */
+export declare function resetScheduledState(): void;
+/**
+ * Trigger the scheduled handler.
+ * This directly invokes the scheduled handler function from your config.
+ *
+ * @param cronOrOptions - Cron expression string or options object
+ * @returns Result object with success status
+ *
+ * @example
+ * // Trigger with specific cron expression (every 6 hours)
+ * await cf.scheduled.trigger('0 0,6,12,18 * * *')
+ *
+ * @example
+ * // Trigger with options (Weekly Monday at midnight)
+ * await cf.scheduled.trigger({
+ *   cron: '0 0 * * 1',
+ *   scheduledTime: new Date('2026-01-13T00:00:00Z')
+ * })
+ *
+ * @example
+ * // Trigger without cron (just scheduled time)
+ * await cf.scheduled.trigger()
+ */
+declare function trigger(cronOrOptions?: string | ScheduledTriggerOptions): Promise<ScheduledTriggerResult>;
+export declare const scheduled: {
+    trigger: typeof trigger;
+};
+export {};
+//# sourceMappingURL=scheduled.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled.d.ts","sourceRoot":"","sources":["../../src/test/scheduled.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,uBAAuB;IACvC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACtC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;CACrB;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,GAAG,IAAI,CAIP;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAe,OAAO,CACrB,aAAa,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAC9C,OAAO,CAAC,sBAAsB,CAAC,CAkFjC;AAMD,eAAO,MAAM,SAAS;;CAErB,CAAA"}

package/dist/test/should-skip.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Check if remote mode is explicitly enabled via environment variable.
+ * Supports DEVFLARE_REMOTE=1, true, yes
+ *
+ * @deprecated Use isRemoteModeActive() instead, which also checks stored config.
+ *
+ * @example
+ * ```ts
+ * import { isRemoteModeEnabled } from 'devflare/test'
+ *
+ * if (isRemoteModeEnabled()) {
+ *   // Use real remote bindings
+ * } else {
+ *   // Use local emulation or skip
+ * }
+ * ```
+ */
+export declare function isRemoteModeEnabled(): boolean;
+/**
+ * Skip helper with property-based access for each service.
+ * Each property returns a Promise<boolean> where true = SKIP the tests.
+ *
+ * Usage:
+ * ```ts
+ * import { shouldSkip } from 'devflare/test'
+ *
+ * describe.skipIf(shouldSkip.ai)('AI tests', () => {
+ *   // These tests only run when authenticated and within limits
+ * })
+ * ```
+ */
+export declare const shouldSkip: {
+    /** Skip AI tests if not authenticated or over limits */
+    readonly ai: Promise<boolean>;
+    /** Skip Vectorize tests if not authenticated or over limits */
+    readonly vectorize: Promise<boolean>;
+    /** Skip Workers tests if not authenticated or over limits */
+    readonly workers: Promise<boolean>;
+    /** Skip KV tests if not authenticated or over limits */
+    readonly kv: Promise<boolean>;
+    /** Skip D1 tests if not authenticated or over limits */
+    readonly d1: Promise<boolean>;
+    /** Skip R2 tests if not authenticated or over limits */
+    readonly r2: Promise<boolean>;
+    /** Skip Queues tests if not authenticated or over limits */
+    readonly queues: Promise<boolean>;
+    /** Skip Durable Objects tests if not authenticated or over limits */
+    readonly durableObjects: Promise<boolean>;
+};
+//# sourceMappingURL=should-skip.d.ts.map

package/dist/test/should-skip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-skip.d.ts","sourceRoot":"","sources":["../../src/test/should-skip.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAmID;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU;IACtB,wDAAwD;;IAKxD,+DAA+D;;IAK/D,6DAA6D;;IAK7D,wDAAwD;;IAKxD,wDAAwD;;IAKxD,wDAAwD;;IAKxD,4DAA4D;;IAK5D,qEAAqE;;CAI5D,CAAA"}

package/dist/test/simple-context.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create a test context from a devflare config file.
+ * This starts Miniflare with the configured bindings and sets up the bridge.
+ *
+ * @param configPath - Optional path to config file. If not provided, searches
+ *                     upward from the test file for devflare.config.ts.
+ *                     If provided, path is resolved relative to the test file.
+ */
+export declare function createTestContext(configPath?: string): Promise<void>;
+/**
+ * Test environment interface - extend this in your project's env.d.ts
+ * The generated env.d.ts declares `interface Env { ... }` in global scope
+ */
+export interface TestEnv {
+    dispose(): Promise<void>;
+}
+/**
+ * Base environment type - augmented by user's env.d.ts via module augmentation.
+ * Projects should run `devflare types` to generate env.d.ts which extends
+ * this interface with proper binding types.
+ *
+ * @example Generated env.d.ts:
+ * ```ts
+ * declare global {
+ *   interface DevflareEnv {
+ *     COUNTER: DurableObjectNamespace
+ *   }
+ * }
+ * ```
+ */
+export interface DevflareEnv {
+}
+/**
+ * @deprecated Use `import { env } from 'devflare'` instead.
+ * This export is kept for backwards compatibility.
+ *
+ * The unified env from 'devflare' works everywhere:
+ * - Inside request handlers (uses request context)
+ * - In tests (after createTestContext())
+ * - In dev mode scripts (uses bridge)
+ */
+export { env } from '../env';
+//# sourceMappingURL=simple-context.d.ts.map

package/dist/test/simple-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-context.d.ts","sourceRoot":"","sources":["../../src/test/simple-context.ts"],"names":[],"mappings":"AAiKA;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAse1E;AA+BD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;CAAI;AAEhC;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA"}

package/dist/test/tail.d.ts

@@ -0,0 +1,86 @@
+import type { TraceItem, TraceLog, TraceException } from '@cloudflare/workers-types';
+export interface TraceItemOptions {
+    /** Name of the worker that produced this trace */
+    scriptName?: string;
+    /** Outcome of the event */
+    outcome?: 'ok' | 'exception' | 'exceededCpu' | 'exceededMemory' | 'unknown';
+    /** Timestamp of the event */
+    eventTimestamp?: number;
+    /** Logs produced during the event */
+    logs?: TraceLog[];
+    /** Exceptions thrown during the event */
+    exceptions?: TraceException[];
+    /** Event details (request, scheduled, etc.) */
+    event?: TraceItem['event'];
+    /** Script version info */
+    scriptVersion?: {
+        id: string;
+    };
+    /** Dispatch namespace (for namespaced workers) */
+    dispatchNamespace?: string;
+    /** Script tags */
+    scriptTags?: string[];
+    /** Diagnostics channel events */
+    diagnosticsChannelEvents?: unknown[];
+}
+export interface TailTriggerResult {
+    /** Whether the handler completed successfully */
+    success: boolean;
+    /** Error message if handler threw */
+    error?: string;
+    /** Number of trace items processed */
+    itemCount: number;
+}
+/**
+ * Configure the tail test helper
+ * @internal Called by createTestContext to set up handler path and env
+ */
+export declare function configureTail(options: {
+    handlerPath: string | null;
+    configDir: string;
+    getEnv: () => Record<string, unknown>;
+}): void;
+/**
+ * Reset tail helper state
+ * @internal Called when test context is disposed
+ */
+export declare function resetTailState(): void;
+/**
+ * Trigger the tail handler with trace items.
+ * This directly invokes the tail handler function from your config.
+ *
+ * @param items - Array of trace items or trace item options
+ * @returns Result object with success status
+ *
+ * @example
+ * ```ts
+ * // Trigger with full trace items
+ * await cf.tail.trigger([
+ *   {
+ *     scriptName: 'my-worker',
+ *     outcome: 'ok',
+ *     logs: [{ level: 'log', message: ['Request processed'], timestamp: Date.now() }]
+ *   }
+ * ])
+ *
+ * // Trigger with minimal options (defaults applied)
+ * await cf.tail.trigger([
+ *   { logs: [{ level: 'error', message: ['Something failed'], timestamp: Date.now() }] }
+ * ])
+ * ```
+ */
+declare function trigger(items: Array<TraceItem | TraceItemOptions>): Promise<TailTriggerResult>;
+/**
+ * Create a TraceItem with sensible defaults.
+ * Useful for building test data.
+ *
+ * @param options - Partial trace item options
+ * @returns Complete TraceItem
+ */
+declare function create(options?: TraceItemOptions): TraceItem;
+export declare const tail: {
+    trigger: typeof trigger;
+    create: typeof create;
+};
+export {};
+//# sourceMappingURL=tail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/test/tail.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAOpF,MAAM,WAAW,gBAAgB;IAChC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAAA;IAC3E,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qCAAqC;IACrC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;IAC7B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IAC1B,0BAA0B;IAC1B,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,iCAAiC;IACjC,wBAAwB,CAAC,EAAE,OAAO,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,iBAAiB;IACjC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;CACjB;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC,GAAG,IAAI,CAIP;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAiCD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAe,OAAO,CACrB,KAAK,EAAE,KAAK,CAAC,SAAS,GAAG,gBAAgB,CAAC,GACxC,OAAO,CAAC,iBAAiB,CAAC,CAoE5B;AAED;;;;;;GAMG;AACH,iBAAS,MAAM,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAEzD;AAMD,eAAO,MAAM,IAAI;;;CAGhB,CAAA"}