devflare 1.0.0-next.3 → 1.0.0-next.30

package/dist/sveltekit/index.js

@@ -1,40 +1,139 @@
-import"../index-m2q41jwa.js";
+import"../index-za0r01bx.js";
+import {
+  createLocalHyperdrive,
+  createLocalWorkerLoaderBinding,
+  extractBindingHints
+} from "../index-t9y0sve5.js";
+import {
+  createLocalImagesBinding,
+  createLocalMediaBinding
+} from "../index-dm9q84c7.js";
+import {
+  buildLocalSecretNodeBindings
+} from "../index-7zfv1g9m.js";
 import {
   createEnvProxy,
-  getClient
-} from "../index-pf5s73n9.js";
-import"../index-07q6yxyc.js";
-import"../index-67qcae0f.js";
+  createFetchEvent,
+  getClient,
+  runWithEventContext,
+  setBindingHints
+} from "../index-6sj0v0dk.js";
 import {
-  loadConfig
-} from "../index-hcex3rgh.js";
+  createLocalSendEmailBinding
+} from "../index-hpwa6vsw.js";
+import"../index-5yvpk954.js";
+import {
+  loadConfig,
+  normalizeHyperdriveBinding
+} from "../index-2sc756r1.js";
+import"../index-1d4jg11n.js";
+import"../index-mg8vwqxf.js";
+import"../index-c8p4njqy.js";
+import"../index-q8f4kawk.js";
 import"../index-37x76zdn.js";
+// src/sveltekit/local-bindings.ts
+function buildLocalHyperdriveBindings(config) {
+  const bindings = {};
+  for (const [name, binding] of Object.entries(config.bindings?.hyperdrive ?? {})) {
+    const normalized = normalizeHyperdriveBinding(binding);
+    if (normalized.localConnectionString) {
+      bindings[name] = createLocalHyperdrive(normalized.localConnectionString);
+    }
+  }
+  return bindings;
+}
+function buildSvelteKitLocalBindings(config, cwd) {
+  const bindings = {
+    ...config.vars ?? {},
+    ...buildLocalHyperdriveBindings(config),
+    ...buildLocalSecretNodeBindings(config, cwd)
+  };
+  for (const [name, binding] of Object.entries(config.bindings?.sendEmail ?? {})) {
+    bindings[name] = createLocalSendEmailBinding(binding);
+  }
+  for (const name of Object.keys(config.bindings?.workerLoaders ?? {})) {
+    bindings[name] = createLocalWorkerLoaderBinding();
+  }
+  for (const name of Object.keys(config.bindings?.images ?? {})) {
+    bindings[name] = createLocalImagesBinding();
+  }
+  for (const name of Object.keys(config.bindings?.media ?? {})) {
+    bindings[name] = createLocalMediaBinding();
+  }
+  return bindings;
+}
+function overlayLocalBindings(baseEnv, localBindings) {
+  if (Object.keys(localBindings).length === 0) {
+    return baseEnv;
+  }
+  return new Proxy(baseEnv, {
+    get(target, prop, receiver) {
+      if (typeof prop === "string" && prop in localBindings) {
+        return localBindings[prop];
+      }
+      return Reflect.get(target, prop, receiver);
+    },
+    has(target, prop) {
+      return typeof prop === "string" && prop in localBindings || Reflect.has(target, prop);
+    },
+    ownKeys(target) {
+      return Array.from(new Set([
+        ...Reflect.ownKeys(target),
+        ...Reflect.ownKeys(localBindings)
+      ]));
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      if (typeof prop === "string" && prop in localBindings) {
+        return {
+          configurable: true,
+          enumerable: true,
+          writable: false,
+          value: localBindings[prop]
+        };
+      }
+      return Reflect.getOwnPropertyDescriptor(target, prop);
+    }
+  });
+}
 
 // src/sveltekit/platform.ts
 var platformCache = null;
-function getPlatformCacheKey(bridgeUrl) {
-  return bridgeUrl;
+function fingerprintHints(hints) {
+  const entries = Object.keys(hints).sort().map((name) => [name, hints[name]]);
+  return JSON.stringify(entries);
+}
+function getPlatformCacheKey(bridgeUrl, hints) {
+  return `${bridgeUrl}\x00${fingerprintHints(hints)}`;
+}
+function shouldUseCachedPlatform(localBindings) {
+  return Object.keys(localBindings).length === 0;
+}
+function createDevExecutionContext(pendingErrors) {
+  return {
+    waitUntil: (promise) => {
+      promise.catch((err) => {
+        console.error("[devflare] waitUntil error:", err);
+        pendingErrors.push(err);
+      });
+    },
+    passThroughOnException: () => {}
+  };
 }
 async function createDevflarePlatform(options = {}) {
   const {
     bridgeUrl = `ws://localhost:${process.env.DEVFLARE_BRIDGE_PORT ?? 8787}`,
-    hints = {}
+    hints = {},
+    localBindings = {}
   } = options;
-  const cacheKey = getPlatformCacheKey(bridgeUrl);
-  if (platformCache?.key === cacheKey) {
+  const cacheKey = getPlatformCacheKey(bridgeUrl, hints);
+  if (shouldUseCachedPlatform(localBindings) && platformCache?.key === cacheKey) {
     return platformCache.platform;
   }
   const client = getClient({ url: bridgeUrl });
   await client.connect();
-  const env = createEnvProxy({ client, hints });
-  const context = {
-    waitUntil: (promise) => {
-      promise.catch((err) => {
-        console.error("[devflare] waitUntil error:", err);
-      });
-    },
-    passThroughOnException: () => {}
-  };
+  const env = overlayLocalBindings(createEnvProxy({ client, hints, strict: true }), localBindings);
+  const pendingErrors = [];
+  const context = createDevExecutionContext(pendingErrors);
   const caches = {
     default: createMockCache(),
     open: async (cacheName) => createMockCache()
@@ -52,8 +151,10 @@ async function createDevflarePlatform(options = {}) {
     asn: 0,
     asOrganization: "Devflare Dev"
   };
-  const platform = { env, context, caches, cf };
-  platformCache = { key: cacheKey, platform };
+  const platform = { env, context, caches, cf, pendingErrors };
+  if (shouldUseCachedPlatform(localBindings)) {
+    platformCache = { key: cacheKey, platform };
+  }
   return platform;
 }
 function createMockCache() {
@@ -86,61 +187,57 @@ function getBridgePort() {
   return parseInt(process.env.DEVFLARE_BRIDGE_PORT ?? "8787", 10);
 }
 var configCache = null;
-function extractHintsFromConfig(config) {
-  const hints = {};
-  const bindings = config.bindings;
-  if (!bindings)
-    return hints;
-  if (bindings.kv) {
-    for (const name of Object.keys(bindings.kv)) {
-      hints[name] = "kv";
-    }
-  }
-  if (bindings.d1) {
-    for (const name of Object.keys(bindings.d1)) {
-      hints[name] = "d1";
-    }
-  }
-  if (bindings.r2) {
-    for (const name of Object.keys(bindings.r2)) {
-      hints[name] = "r2";
-    }
-  }
-  if (bindings.durableObjects) {
-    for (const name of Object.keys(bindings.durableObjects)) {
-      hints[name] = "do";
-    }
-  }
-  if (bindings.queues?.producers) {
-    for (const name of Object.keys(bindings.queues.producers)) {
-      hints[name] = "queue";
-    }
-  }
-  if (bindings.services) {
-    for (const name of Object.keys(bindings.services)) {
-      hints[name] = "service";
-    }
-  }
-  if (bindings.ai?.binding) {
-    hints[bindings.ai.binding] = "ai";
-  }
-  return hints;
+function getConfigFileFromEnv() {
+  return process.env.DEVFLARE_CONFIG_PATH;
 }
-async function loadHintsFromConfig() {
+async function loadConfigFromCurrentCwd() {
   const cwd = process.cwd();
-  if (configCache?.cwd === cwd) {
-    const config2 = await configCache.promise;
-    return config2 ? extractHintsFromConfig(config2) : {};
+  const configFile = getConfigFileFromEnv();
+  if (configCache?.cwd === cwd && configCache.configFile === configFile) {
+    return configCache.promise;
   }
-  const promise = loadConfig({ cwd }).catch((err) => {
+  const promise = loadConfig({ cwd, configFile }).catch((err) => {
     if (process.env.DEVFLARE_DEBUG) {
       console.warn("[devflare] Failed to load config for hints:", err.message);
     }
     return null;
   });
-  configCache = { cwd, promise };
-  const config = await promise;
-  return config ? extractHintsFromConfig(config) : {};
+  configCache = { cwd, configFile, promise };
+  return promise;
+}
+async function loadPlatformOptionsFromConfig() {
+  const cwd = process.cwd();
+  const config = await loadConfigFromCurrentCwd();
+  if (!config) {
+    return { hints: {}, localBindings: {} };
+  }
+  return {
+    hints: extractBindingHints(config),
+    localBindings: buildSvelteKitLocalBindings(config, cwd)
+  };
+}
+function resolveWithPlatformContext(event, resolve, platform) {
+  if (!(event.request instanceof Request)) {
+    return resolve(event);
+  }
+  const fetchEvent = createFetchEvent(event.request, platform.env, platform.context);
+  return runWithEventContext(fetchEvent, () => resolve(event));
+}
+async function createPlatformWithRequestContext(event, resolve, options) {
+  const platform = await createDevflarePlatform(options);
+  event.platform = platform;
+  return resolveWithPlatformContext(event, resolve, platform);
+}
+async function getAutoPlatformOptions() {
+  const options = await loadPlatformOptionsFromConfig();
+  setBindingHints(options.hints ?? {});
+  return options;
+}
+async function getCustomPlatformOptions(options) {
+  if (options.hints) {
+    setBindingHints(options.hints);
+  }
+  return options;
 }
 function createHandle(options = {}) {
   const { shouldEnable, ...platformOptions } = options;
@@ -148,8 +245,7 @@ function createHandle(options = {}) {
     const enabled = shouldEnable ? shouldEnable() : process.env.DEVFLARE_DEV === "true";
     if (enabled) {
       try {
-        const platform = await createDevflarePlatform(platformOptions);
-        event.platform = platform;
+        return await createPlatformWithRequestContext(event, resolve, await getCustomPlatformOptions(platformOptions));
       } catch (error) {
         console.error("[devflare] Failed to create platform:", error);
       }
@@ -162,9 +258,7 @@ var handle = async (input) => {
   const enabled = process.env.DEVFLARE_DEV === "true";
   if (enabled) {
     try {
-      const hints = await loadHintsFromConfig();
-      const platform = await createDevflarePlatform({ hints });
-      event.platform = platform;
+      return await createPlatformWithRequestContext(event, resolve, await getAutoPlatformOptions());
     } catch (error) {
       console.error("[devflare] Failed to create platform:", error);
     }

package/dist/sveltekit/local-bindings.d.ts

@@ -0,0 +1,4 @@
+import { type DevflareConfig } from '../config';
+export declare function buildSvelteKitLocalBindings(config: DevflareConfig, cwd: string): Record<string, unknown>;
+export declare function overlayLocalBindings(baseEnv: Record<string, unknown>, localBindings: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=local-bindings.d.ts.map

package/dist/sveltekit/local-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-bindings.d.ts","sourceRoot":"","sources":["../../src/sveltekit/local-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,WAAW,CAAA;AAuBlB,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB"}

package/dist/sveltekit/platform.d.ts

@@ -7,6 +7,11 @@ export interface Platform {
     context: ExecutionContext;
     caches: CacheStorage;
     cf: Record<string, unknown>;
+    /**
+     * Errors captured from `ctx.waitUntil()` rejections in dev mode.
+     * Drain via `drainWaitUntilErrors(platform)`.
+     */
+    pendingErrors?: unknown[];
 }
 export interface DevflarePlatformOptions {
     /**
@@ -19,7 +24,18 @@ export interface DevflarePlatformOptions {
      * Keys are binding names, values are binding types
      */
     hints?: BindingHints;
+    /**
+     * Local Node-side binding shims to prefer over the bridge-backed env.
+     * Used by the SvelteKit handle for bindings whose local API exposes
+     * synchronous properties or rich transformation objects.
+     */
+    localBindings?: Record<string, unknown>;
 }
+/**
+ * Drain errors captured from `ctx.waitUntil()` calls on a dev platform.
+ * Returns a snapshot of the pending errors and clears the buffer.
+ */
+export declare function drainWaitUntilErrors(platform: Platform): unknown[];
 /**
  * Create a platform object that routes bindings through the bridge
  *
@@ -107,6 +123,7 @@ export interface CreateHandleOptions extends DevflarePlatformOptions {
 export declare function createHandle<T extends {
     event: {
         platform?: unknown;
+        request?: Request;
     };
     resolve: (event: unknown) => Response | Promise<Response>;
 }>(options?: CreateHandleOptions): (input: T) => Promise<Response>;
@@ -135,7 +152,8 @@ export declare function createHandle<T extends {
 export declare const handle: <T extends {
     event: {
         platform?: unknown;
+        request?: Request;
     };
-    resolve: (event: unknown) => Promise<Response> | Response;
+    resolve: (event: unknown) => Response | Promise<Response>;
 }>(input: T) => Promise<Response>;
 //# sourceMappingURL=platform.d.ts.map

package/dist/sveltekit/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/sveltekit/platform.ts"],"names":[],"mappings":"AAQA,OAAO,EAA6B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAMxE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,YAAY,CAAA;IACpB,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;CACpB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,QAAQ,CAAC,CA2DnB;AAyBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAoGD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IACnE;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,EAClI,OAAO,GAAE,mBAAwB,GAC/B,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAqBjC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM,GAAU,CAAC;;;;;iCAqB7B,CAAA"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/sveltekit/platform.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8C,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AASzF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,YAAY,CAAA;IACpB,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAA;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAgDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE,CAQlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,QAAQ,CAAC,CAqDnB;AAyBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAsGD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IACnE;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,EACrJ,OAAO,GAAE,mBAAwB,GAC/B,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAwBjC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM,GAAU,CAAC,SAAS;IAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,SAC9I,CAAC,KACN,OAAO,CAAC,QAAQ,CAoBlB,CAAA"}

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

@@ -0,0 +1,39 @@
+type AISearchChunk = AiSearchSearchResponse['chunks'][number];
+export interface MockAISearchItemFixture {
+    id?: string;
+    key: string;
+    content?: string;
+    contentType?: string;
+    metadata?: Record<string, unknown>;
+    status?: AiSearchItemInfo['status'];
+    chunks?: string[];
+}
+export interface MockAISearchInstanceOptions {
+    id?: string;
+    namespace?: string;
+    info?: Partial<AiSearchInstanceInfo>;
+    items?: MockAISearchItemFixture[];
+    chatMessage?: string | ((chunks: AISearchChunk[], request: AiSearchChatCompletionsRequest) => string);
+}
+export interface MockAISearchNamespaceOptions {
+    namespace?: string;
+    instances?: Record<string, MockAISearchInstanceOptions | AiSearchInstance>;
+}
+export type MockAISearchInstance = AiSearchInstance & {
+    _getSearches(): AiSearchSearchRequest[];
+    _getItems(): AiSearchItemInfo[];
+    _getJobs(): AiSearchJobInfo[];
+};
+export type MockAISearchNamespace = AiSearchNamespace & {
+    _getInstances(): string[];
+};
+/**
+ * Creates a deterministic AI Search instance binding for pure unit tests.
+ */
+export declare function createMockAISearchInstance(options?: MockAISearchInstanceOptions): MockAISearchInstance;
+/**
+ * Creates a deterministic AI Search namespace binding for pure unit tests.
+ */
+export declare function createMockAISearchNamespace(options?: MockAISearchNamespaceOptions): MockAISearchNamespace;
+export {};
+//# sourceMappingURL=ai-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-search.d.ts","sourceRoot":"","sources":["../../src/test/ai-search.ts"],"names":[],"mappings":"AAQA,KAAK,aAAa,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAG7D,MAAM,WAAW,uBAAuB;IACvC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACpC,KAAK,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACjC,WAAW,CAAC,EACT,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,8BAA8B,KAAK,MAAM,CAAC,CAAA;CACjF;AAED,MAAM,WAAW,4BAA4B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,GAAG,gBAAgB,CAAC,CAAA;CAC1E;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACrD,YAAY,IAAI,qBAAqB,EAAE,CAAA;IACvC,SAAS,IAAI,gBAAgB,EAAE,CAAA;IAC/B,QAAQ,IAAI,eAAe,EAAE,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACvD,aAAa,IAAI,MAAM,EAAE,CAAA;CACzB,CAAA;AAqJD;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,GAAE,2BAAgC,GACvC,oBAAoB,CAiXtB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,GAAE,4BAAiC,GACxC,qBAAqB,CA2IvB"}

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

@@ -0,0 +1,11 @@
+import type { DevflareConfig } from '../config';
+import type { BindingHints } from '../bridge/proxy';
+/**
+ * Derive `BindingHints` from a resolved Devflare config.
+ *
+ * Used by both `createTestContext` (simple-context) and `createBridgeTestContext`
+ * (bridge-context) to avoid duplicating the mapping between config sections and
+ * hint kinds.
+ */
+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,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAqDxE"}

package/dist/test/cf.d.ts

@@ -11,15 +11,19 @@ export type { TraceItemOptions, TailTriggerResult } from './tail';
 /**
  * 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)
  *
- * 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,12 +64,16 @@ 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>;
@@ -82,8 +90,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").QueueMessageOptions<T> | T>) => Promise<import("./queue").QueueTriggerResult>;
+        send: <T = unknown>(message: import("./queue").QueueMessageOptions<T> | T) => Promise<import("./queue").QueueTriggerResult>;
     };
     /**
      * Scheduled (cron) handler testing.
@@ -96,7 +104,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").ScheduledTriggerOptions) => Promise<import("./scheduled").ScheduledTriggerResult>;
     };
     /**
      * Fetch (HTTP) handler testing.
@@ -107,23 +115,29 @@ 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").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>;
+        trigger: (items: Array<import("@cloudflare/workers-types").TraceItem | import("./tail").TraceItemOptions>) => Promise<import("./tail").TailTriggerResult>;
         create: (options?: import("./tail").TraceItemOptions) => import("@cloudflare/workers-types").TraceItem;
     };
 };

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":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,EAAE;IACd;;;;;;;;;;;OAWG;;;;;;;IAGH;;;;;;;OAOG;;;;;IAGH;;;;;;;;;OASG;;;;IAGH;;;;;;;;;;;;OAYG;;;;;;;;;IAGH;;;;;;;;OAQG;;;;;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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"}