devflare 1.0.0-next.39 → 1.0.0-next.40

package/dist/sveltekit/index.js

@@ -1,10 +1,328 @@
-import"../index-37x76zdn.js";
-export {
-  resetPlatform,
-  resetConfigCache,
-  isDevflareDev,
-  handle,
-  getBridgePort,
-  createHandle,
-  createDevflarePlatform
+import { r as loadConfig } from "../_chunks/loader-DLXO60RO.js";
+import { c as normalizeHyperdriveBinding } from "../_chunks/schema-normalization-DWVleVxo.js";
+import { D as createFetchEvent, I as getClient, M as createEnvProxy, P as setBindingHints, v as runWithEventContext } from "../_chunks/context-CX50Y2Kb.js";
+import { createLocalSendEmailBinding } from "../utils/send-email.js";
+import { i as extractBindingHints, n as createLocalWorkerLoaderBinding, t as createLocalHyperdrive } from "../_chunks/local-hyperdrive-CJ90j46O.js";
+import { t as buildLocalSecretNodeBindings } from "../_chunks/local-secrets-DMmEOygL.js";
+import { n as createLocalImagesBinding, r as createLocalMediaBinding } from "../_chunks/local-media-bindings-DsAW4AMF.js";
+//#region 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);
+		}
+	});
+}
+//#endregion
+//#region src/sveltekit/platform.ts
+/** Cached platform keyed by bridgeUrl + binding hint fingerprint */
+let platformCache = null;
+/**
+* Generate a stable fingerprint for binding hints so cached platforms are not
+* shared across configs with differing hint sets.
+*/
+function fingerprintHints(hints) {
+	const entries = Object.keys(hints).sort().map((name) => [name, hints[name]]);
+	return JSON.stringify(entries);
+}
+/**
+* Generate cache key from options
+*/
+function getPlatformCacheKey(bridgeUrl, hints) {
+	return `${bridgeUrl}\u0000${fingerprintHints(hints)}`;
+}
+function shouldUseCachedPlatform(localBindings) {
+	return Object.keys(localBindings).length === 0;
+}
+/**
+* Build a dev-mode ExecutionContext that records `waitUntil()` rejections on
+* the provided `pendingErrors` array. The original console.error log is kept
+* for parity with existing behavior.
+*/
+function createDevExecutionContext(pendingErrors) {
+	return {
+		waitUntil: (promise) => {
+			promise.catch((err) => {
+				console.error("[devflare] waitUntil error:", err);
+				pendingErrors.push(err);
+			});
+		},
+		passThroughOnException: () => {}
+	};
+}
+/**
+* Create a platform object that routes bindings through the bridge
+*
+* Use this in dev mode to get access to Miniflare bindings via WebSocket RPC.
+*
+* @example
+* ```ts
+* // src/hooks.server.ts
+* import { dev } from '$app/environment'
+* import { createDevflarePlatform } from 'devflare/sveltekit'
+*
+* export async function handle({ event, resolve }) {
+*   if (dev && process.env.DEVFLARE_DEV) {
+*     // Override platform with bridge-connected proxy
+*     event.platform = await createDevflarePlatform({
+*       hints: {
+*         MY_KV: 'kv',
+*         MY_DO: 'do',
+*         MY_D1: 'd1',
+*         MY_R2: 'r2'
+*       }
+*     })
+*   }
+*   return resolve(event)
+* }
+* ```
+*/
+async function createDevflarePlatform(options = {}) {
+	const { bridgeUrl = `ws://localhost:${process.env.DEVFLARE_BRIDGE_PORT ?? 8787}`, hints = {}, localBindings = {} } = options;
+	const cacheKey = getPlatformCacheKey(bridgeUrl, hints);
+	if (shouldUseCachedPlatform(localBindings) && platformCache?.key === cacheKey) return platformCache.platform;
+	const client = getClient({ url: bridgeUrl });
+	await client.connect();
+	const env = overlayLocalBindings(createEnvProxy({
+		client,
+		hints,
+		strict: true
+	}), localBindings);
+	const pendingErrors = [];
+	const platform = {
+		env,
+		context: createDevExecutionContext(pendingErrors),
+		caches: {
+			default: createMockCache(),
+			open: async (cacheName) => createMockCache()
+		},
+		cf: {
+			colo: "DEV",
+			country: "XX",
+			city: "Development",
+			continent: "XX",
+			latitude: "0",
+			longitude: "0",
+			timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+			region: "Development",
+			regionCode: "DEV",
+			asn: 0,
+			asOrganization: "Devflare Dev"
+		},
+		pendingErrors
+	};
+	if (shouldUseCachedPlatform(localBindings)) platformCache = {
+		key: cacheKey,
+		platform
+	};
+	return platform;
+}
+/**
+* Create a simple mock cache for dev mode
+* Note: Cloudflare's Cache interface differs from browser Cache API
+*/
+function createMockCache() {
+	const store = /* @__PURE__ */ new Map();
+	return {
+		async match(request) {
+			const key = typeof request === "string" ? request : request instanceof URL ? request.href : request.url;
+			return store.get(key)?.clone();
+		},
+		async put(request, response) {
+			const key = typeof request === "string" ? request : request instanceof URL ? request.href : request.url;
+			store.set(key, response.clone());
+		},
+		async delete(request) {
+			const key = typeof request === "string" ? request : request instanceof URL ? request.href : request.url;
+			return store.delete(key);
+		}
+	};
+}
+/**
+* Reset the cached platform (for testing)
+*/
+function resetPlatform() {
+	platformCache = null;
+}
+/**
+* Reset the cached config (for testing)
+*/
+function resetConfigCache() {
+	configCache = null;
+}
+/**
+* Check if running in devflare dev mode
+*/
+function isDevflareDev() {
+	return process.env.DEVFLARE_DEV === "true";
+}
+/**
+* Get the bridge port from environment
+*/
+function getBridgePort() {
+	return Number.parseInt(process.env.DEVFLARE_BRIDGE_PORT ?? "8787", 10);
+}
+/** Cached config promise keyed by cwd + explicit config path */
+let configCache = null;
+function getConfigFileFromEnv() {
+	return process.env.DEVFLARE_CONFIG_PATH;
+}
+async function loadConfigFromCurrentCwd() {
+	const cwd = process.cwd();
+	const configFile = getConfigFileFromEnv();
+	if (configCache?.cwd === cwd && configCache.configFile === configFile) return configCache.promise;
+	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,
+		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);
+	return runWithEventContext(createFetchEvent(event.request, platform.env, platform.context), () => 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;
+}
+/**
+* Create a SvelteKit handle that automatically injects the devflare platform
+* in development mode. This eliminates the need for boilerplate in hooks.server.ts.
+*
+* @example
+* ```ts
+* // src/hooks.server.ts
+* import { createHandle } from 'devflare/sveltekit'
+*
+* export const handle = createHandle({
+*   hints: {
+*     MY_KV: 'kv',
+*     MY_DO: 'do',
+*     MY_D1: 'd1',
+*     MY_R2: 'r2'
+*   }
+* })
+* ```
+*
+* @example Composing with other handles using SvelteKit's sequence
+* ```ts
+* import { sequence } from '@sveltejs/kit/hooks'
+* import { createHandle } from 'devflare/sveltekit'
+*
+* const devflareHandle = createHandle({ hints: { ... } })
+* const authHandle: Handle = async ({ event, resolve }) => { ... }
+*
+* export const handle = sequence(devflareHandle, authHandle)
+* ```
+*/
+function createHandle(options = {}) {
+	const { shouldEnable, ...platformOptions } = options;
+	return async ({ event, resolve }) => {
+		if (shouldEnable ? shouldEnable() : process.env.NODE_ENV !== "production" && process.env.DEVFLARE_DEV === "true") try {
+			return await createPlatformWithRequestContext(event, resolve, await getCustomPlatformOptions(platformOptions));
+		} catch (error) {
+			console.error("[devflare] Failed to create platform:", error);
+		}
+		return resolve(event);
+	};
+}
+/**
+* Pre-configured SvelteKit handle that auto-loads binding hints from devflare.config.ts.
+*
+* This is the simplest way to integrate devflare with SvelteKit:
+*
+* @example Simplest usage — just re-export
+* ```ts
+* // src/hooks.server.ts
+* export { handle } from 'devflare/sveltekit'
+* ```
+*
+* @example With other handles
+* ```ts
+* // src/hooks.server.ts
+* import { sequence } from '@sveltejs/kit/hooks'
+* import { handle as devflareHandle } from 'devflare/sveltekit'
+*
+* const authHandle: Handle = async ({ event, resolve }) => { ... }
+*
+* export const handle = sequence(devflareHandle, authHandle)
+* ```
+*/
+const handle = async (input) => {
+	const { event, resolve } = input;
+	if (process.env.NODE_ENV !== "production" && process.env.DEVFLARE_DEV === "true") try {
+		return await createPlatformWithRequestContext(event, resolve, await getAutoPlatformOptions());
+	} catch (error) {
+		console.error("[devflare] Failed to create platform:", error);
+	}
+	return resolve(event);
 };
+//#endregion
+export { createDevflarePlatform, createHandle, getBridgePort, handle, isDevflareDev, resetConfigCache, resetPlatform };

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

@@ -1,4 +1,4 @@
-import { type DevflareConfig } from '../config';
+import { type DevflareConfig } from '../config/index.js';
 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/platform.d.ts

@@ -1,4 +1,4 @@
-import { type BindingHints } from '../bridge';
+import { type BindingHints } from '../bridge/index.js';
 /**
  * SvelteKit platform object shape
  */

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

@@ -1,5 +1,5 @@
-import type { BindingHints } from '../bridge/proxy';
-import type { DevflareConfig } from '../config';
+import type { BindingHints } from '../bridge/proxy.js';
+import type { DevflareConfig } from '../config/index.js';
 /**
  * Derive `BindingHints` from a resolved Devflare config.
  *

package/dist/test/cf.d.ts

@@ -1,13 +1,13 @@
-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 { 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 { 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.
  *
@@ -76,9 +76,9 @@ export declare const cf: {
      * 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;
     };
     /**
@@ -90,8 +90,8 @@ export declare const cf: {
      * Returns result with `acked`, `retried`, `failed` message IDs.
      */
     queue: {
-        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>;
+        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.
@@ -104,7 +104,7 @@ export declare const cf: {
      * await cf.scheduled.trigger('0 0 * * 1')    // Weekly Monday
      */
     scheduled: {
-        trigger: (cronOrOptions?: string | import("./scheduled").ScheduledTriggerOptions) => Promise<import("./scheduled").ScheduledTriggerResult>;
+        trigger: (cronOrOptions?: string | import("./scheduled.js").ScheduledTriggerOptions) => Promise<import("./scheduled.js").ScheduledTriggerResult>;
     };
     /**
      * Fetch (HTTP) handler testing.
@@ -120,7 +120,7 @@ export declare const cf: {
      * `src/routes/**` file routes when they are present.
      */
     worker: {
-        fetch: (request: Request | string, options?: import("./worker").WorkerFetchOptions) => 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>;
@@ -137,8 +137,8 @@ export declare const cf: {
      * `cf.tail.trigger()` is wired automatically.
      */
     tail: {
-        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;
+        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;
     };
 };
 //# sourceMappingURL=cf.d.ts.map

package/dist/test/index.d.ts

@@ -1,19 +1,19 @@
-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 { shouldSkip } from './should-skip';
-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';
-export { createOfflineBindings, createOfflineEnv, describeOfflineSupport, getOfflineSupportMatrix, type OfflineBindingFixtures, type OfflineBindingsResult, type OfflineMissingFixture, type OfflineRemoteBoundary, type OfflineSupportEntry, type OfflineSupportTier } from './offline-bindings';
-export { createMockAISearchInstance, createMockAISearchNamespace, type MockAISearchInstance, type MockAISearchInstanceOptions, type MockAISearchItemFixture, type MockAISearchNamespace, type MockAISearchNamespaceOptions } from './ai-search';
-export { createMockTestContext, createMockKV, createMockD1, createMockR2, createMockQueue, createMockRateLimit, createMockVersionMetadata, createMockHyperdrive, createMockWorkerLoader, createMockMTLSCertificate, createMockDispatchNamespace, createMockWorkflow, createMockPipeline, createMockImagesBinding, createMockMediaBinding, createMockArtifacts, 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 MockArtifactsOptions } from './utilities';
+export { createTestContext, env, type DevflareEnv, type TestEnv } from './simple-context.js';
+export { cf } from './cf.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 { 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, createMockArtifacts, 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 MockArtifactsOptions } from './utilities.js';
 //# sourceMappingURL=index.d.ts.map