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

package/dist/runtime/middleware.d.ts

@@ -1,82 +1,134 @@
+import { type FetchEvent } from './context.js';
+type AnyFunction = (...args: any[]) => any;
+type FetchModule = Record<string, unknown>;
 /**
- * A function that handles a request and returns a Response
- * Can return null to indicate "pass through" to next handler
+ * Promise-or-value helper used by worker-safe runtime APIs.
  */
-export type Handler = () => Promise<Response | null>;
+export type Awaitable<T> = T | Promise<T>;
 /**
- * Middleware function that wraps a handler
+ * Resolve the next request-wide middleware or module-local leaf handler.
  *
- * @param next - Call this to continue to the next middleware/handler
- * @returns Response from the middleware or the wrapped handler
+ * Passing a new event mirrors SvelteKit's `resolve(event)` pattern and lets
+ * middleware continue the chain with a modified request context.
+ */
+export type ResolveFetch<TEvent extends FetchEvent = FetchEvent> = (event?: TEvent) => Promise<Response>;
+/**
+ * Request-wide fetch middleware.
+ *
+ * These are intended for the single module-level fetch entry export such as:
+ * - `export const fetch = sequence(corsHandle, appFetch)`
+ * - `export const handle = sequence(corsHandle, appFetch)`
+ *
+ * `fetch` and `handle` are aliases for the same primary fetch entry, so a
+ * module should export one or the other, not both.
+ */
+export type FetchMiddleware<TEvent extends FetchEvent = FetchEvent> = (event: TEvent, resolve: ResolveFetch<TEvent>) => Awaitable<Response>;
+interface FetchResolveOptions<TEvent extends FetchEvent> {
+    fallbackResolve?: ResolveFetch<TEvent>;
+}
+/**
+ * Tag a handler as resolve-style: `(event, resolve) => Response`.
+ *
+ * Attaches `FETCH_RESOLVE_STYLE_SYMBOL` so detection survives minification
+ * (which rewrites parameter names and function source output).
+ */
+export declare function markResolveStyle<T extends AnyFunction>(handler: T): T;
+/**
+ * Tag a handler as worker-style: `(request, env)` or `(request, env, ctx)`.
  *
- * @example
- * ```ts
- * const authMiddleware: Middleware = async (next) => {
- *   const token = event.request?.headers.get('Authorization')
- *   if (!token) {
- *     return new Response('Unauthorized', { status: 401 })
- *   }
- *   locals.user = await validateToken(token)
- *   return next()
- * }
- * ```
- */
-export type Middleware = (next: () => Promise<Response>) => Promise<Response>;
-/**
- * Composes multiple middlewares into a single function
+ * Required for 2-argument worker-style handlers because devflare can no
+ * longer disambiguate `(event, resolve)` vs `(request, env)` from arity
+ * alone — the parameter-name fallback was removed in R1-strict.
+ */
+export declare function markWorkerStyle<T extends AnyFunction>(handler: T): T;
+/**
+ * Explicit escape hatch for declaring a handler's calling convention.
  *
- * Middlewares execute in the order provided:
- * - Before next(): runs on the way "in"
- * - After next(): runs on the way "out"
+ * - `options.style === 'resolve'` marks the handler so it is dispatched as
+ *   `(event, resolve) => Response`.
+ * - `options.style === 'worker'` marks the handler so it is dispatched as
+ *   `(request, env[, ctx]) => Response`.
  *
- * @param middlewares - Array of middleware functions to compose
- * @returns A function that accepts a handler and returns a composed handler
+ * The marker is required for 2-argument handlers; 1-arg `(event)` and
+ * 3-arg `(request, env, ctx)` handlers do not need to be wrapped.
+ */
+export declare function defineFetchHandler<T extends AnyFunction>(handler: T, options?: {
+    style?: 'resolve' | 'worker';
+}): T;
+/**
+ * Throw a clear error for ambiguous unmarked 2-argument fetch handlers.
  *
- * @example
- * ```ts
- * const handler = sequence(
- *   corsMiddleware,
- *   authMiddleware,
- *   loggingMiddleware
- * )(myHandler)
- * ```
- */
-export declare function sequence(...middlewares: Middleware[]): (handler: Handler) => Handler;
-/**
- * Chains multiple handlers, trying each until one returns a Response
+ * In R1-strict, devflare no longer guesses the calling convention from
+ * parameter names. 2-arg handlers must be marked with
+ * `defineFetchHandler(fn, { style: 'resolve' | 'worker' })` (or wrapped via
+ * `markResolveStyle` / `markWorkerStyle` / `sequence(...)`) so dispatch is
+ * unambiguous and minification-safe.
+ */
+export declare function assertExplicit2ArgStyle(handler: AnyFunction): void;
+/**
+ * Tag a queue handler as worker-style: `(batch, env)` or `(batch, env, ctx)`.
  *
- * Handlers are tried in order. The first handler to return a non-null
- * Response wins. If all handlers return null, resolve() returns null.
+ * Required for 2-argument worker-style queue handlers because devflare can
+ * no longer disambiguate `(event)` vs `(batch, env)` from arity alone in
+ * R1-strict.
+ */
+export declare function defineQueueHandler<T extends AnyFunction>(handler: T): T;
+/**
+ * Tag a scheduled handler as worker-style: `(controller, env)` or
+ * `(controller, env, ctx)`.
+ */
+export declare function defineScheduledHandler<T extends AnyFunction>(handler: T): T;
+/**
+ * Throw a clear error for ambiguous unmarked 2-argument queue handlers.
  *
- * @param handlers - Array of handler functions to try
- * @returns A combined handler
+ * Mirrors `assertExplicit2ArgStyle` for the queue surface. 2-arg handlers
+ * must be wrapped with `defineQueueHandler(fn)` so dispatch is unambiguous
+ * and minification-safe; 1-arg `(event)` and 3-arg `(batch, env, ctx)` do
+ * not require wrapping.
+ */
+export declare function assertExplicitQueueHandlerStyle(handler: AnyFunction): void;
+/**
+ * Throw a clear error for ambiguous unmarked 2-argument scheduled handlers.
+ */
+export declare function assertExplicitScheduledHandlerStyle(handler: AnyFunction): void;
+/**
+ * Compose request-wide middleware into a single fetch surface.
+ */
+export declare function sequence<TEvent extends FetchEvent = FetchEvent>(...middlewares: FetchMiddleware<TEvent>[]): FetchMiddleware<TEvent>;
+/**
+ * Resolve the primary fetch surface for a module.
  *
- * @example
- * ```ts
- * const handler = resolve(
- *   staticFileHandler,   // Returns null if not a static file
- *   apiHandler,          // Returns null if not an API route
- *   notFoundHandler      // Fallback - always returns Response
- * )
- * ```
- */
-export declare function resolve(...handlers: Handler[]): Handler;
-/**
- * Creates a handler that applies middleware before running resolve
+ * `fetch` and `handle` are treated as aliases for the same primary fetch
+ * entry. Exporting more than one primary entry from the same module is
+ * rejected as ambiguous.
+ */
+export declare function resolveFetchHandler(module: FetchModule): AnyFunction | null;
+/**
+ * Invoke a fetch entry handler with the supported calling conventions.
  *
- * Convenience function combining sequence() and resolve()
+ * This supports:
+ * - `fetch(request)`
+ * - `fetch(request, env)`
+ * - `fetch(request, env, ctx)`
+ * - `fetch(event)`
+ * - `fetch(event, resolve)` / `handle(event, resolve)`
+ */
+export declare function invokeFetchHandler<TEvent extends FetchEvent>(handler: unknown, event: TEvent, resolve?: ResolveFetch<TEvent>): Promise<Response>;
+/**
+ * Create a SvelteKit-style `resolve(event)` callback for a fetch module.
  *
- * @param middlewares - Middlewares to apply
- * @param handlers - Handlers to resolve
- * @returns A composed handler
+ * Resolution order is:
+ * - matching HTTP method export such as `GET()` / `POST()` / `ALL()`
+ * - 404 response
+ */
+export declare function createResolveFetch<TEvent extends FetchEvent>(module: FetchModule, _currentEntry: unknown, initialEvent: TEvent, options?: FetchResolveOptions<TEvent>): ResolveFetch<TEvent>;
+/**
+ * Invoke the resolved fetch surface for a module.
  *
- * @example
- * ```ts
- * const handler = pipe(
- *   [authMiddleware, loggingMiddleware],
- *   [apiHandler, staticHandler, fallbackHandler]
- * )
- * ```
- */
-export declare function pipe(middlewares: Middleware[], handlers: Handler[]): Handler;
+ * This lets runtime wrappers support a single request-wide `handle` or
+ * `fetch` export, default exports, and same-module method handlers such as
+ * `GET()`.
+ */
+export declare function invokeFetchModule<TEvent extends FetchEvent>(module: FetchModule, event: TEvent, fallbackResolve?: ResolveFetch<TEvent>): Promise<Response>;
+export {};
 //# sourceMappingURL=middleware.d.ts.map

package/dist/runtime/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CA+BpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAUvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CACnB,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,OAAO,EAAE,GACjB,OAAO,CAET"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAuB,MAAM,WAAW,CAAA;AAEhE,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;AAC1C,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAQ1C;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,IAAI,CAClE,KAAK,CAAC,EAAE,MAAM,KACV,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,IAAI,CACrE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,KACzB,SAAS,CAAC,QAAQ,CAAC,CAAA;AAExB,UAAU,mBAAmB,CAAC,MAAM,SAAS,UAAU;IACtD,eAAe,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;CACtC;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CASrE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CASpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACvD,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,GACxC,CAAC,CAUH;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgBlE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CASvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAS3E;AAYD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAc1E;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAc9E;AA2ED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,EAC9D,GAAG,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,GACvC,eAAe,CAAC,MAAM,CAAC,CAWzB;AAuID;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAI3E;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,SAAS,UAAU,EACjE,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAY,CAAC,MAAM,CAAwC,GAClE,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,UAAU,EAC3D,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,mBAAmB,CAAC,MAAM,CAAM,GACvC,YAAY,CAAC,MAAM,CAAC,CAsBtB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,SAAS,UAAU,EAChE,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GACpC,OAAO,CAAC,QAAQ,CAAC,CAYnB"}

package/dist/runtime/router/index.d.ts

@@ -0,0 +1,7 @@
+import { type FetchEvent } from '../context.js';
+import { type ResolveFetch } from '../middleware.js';
+import type { RouteMatchResult, RouteModuleDefinition } from './types.js';
+export declare function matchFetchRoute(routes: readonly RouteModuleDefinition[], input: Request | URL | string): RouteMatchResult | null;
+export declare function invokeRouteModules<TEvent extends FetchEvent>(routes: readonly RouteModuleDefinition[], event: TEvent): Promise<Response>;
+export declare function createRouteResolve<TEvent extends FetchEvent>(routes: readonly RouteModuleDefinition[], initialEvent: TEvent): ResolveFetch<TEvent>;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/router/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAyC,MAAM,YAAY,CAAA;AACnF,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,eAAe,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAgB,MAAM,SAAS,CAAA;AAsGpF,wBAAgB,eAAe,CAC9B,MAAM,EAAE,SAAS,qBAAqB,EAAE,EACxC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,MAAM,GAC3B,gBAAgB,GAAG,IAAI,CAczB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,SAAS,UAAU,EACjE,MAAM,EAAE,SAAS,qBAAqB,EAAE,EACxC,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,UAAU,EAC3D,MAAM,EAAE,SAAS,qBAAqB,EAAE,EACxC,YAAY,EAAE,MAAM,GAClB,YAAY,CAAC,MAAM,CAAC,CAItB"}

package/dist/runtime/router/types.d.ts

@@ -0,0 +1,24 @@
+export type RouteSegment = {
+    readonly type: 'static';
+    readonly value: string;
+} | {
+    readonly type: 'param';
+    readonly name: string;
+} | {
+    readonly type: 'rest';
+    readonly name: string;
+} | {
+    readonly type: 'optional-rest';
+    readonly name: string;
+};
+export interface RouteModuleDefinition {
+    readonly filePath: string;
+    readonly routePath: string;
+    readonly segments: readonly RouteSegment[];
+    readonly module: Record<string, unknown>;
+}
+export interface RouteMatchResult {
+    readonly route: RouteModuleDefinition;
+    readonly params: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/router/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/router/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GACrB;IACA,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACrB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACpB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACpB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACpB,CAAA;AAEJ,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC"}

package/dist/runtime/validation.d.ts

@@ -1,10 +1,16 @@
 /**
- * Error thrown when accessing context properties outside of request handler
+ * Error thrown when accessing context properties outside an active handler trail
  */
 export declare class ContextAccessError extends Error {
     readonly contextName: string;
     readonly propertyName: string;
-    constructor(contextName: string, propertyName: string);
+    constructor(contextName: string, propertyName: string, message?: string);
+    /**
+     * Builds a `ContextAccessError` for the "no active handler trail" failure mode
+     * (no AsyncLocalStorage store), with guidance toward the most common causes.
+     * Pass `message` to override the default `nodejs_compat`-mentioning guidance.
+     */
+    static contextUnavailable(message?: string): ContextAccessError;
 }
 /**
  * Creates a proxy that validates context is available before access
@@ -15,7 +21,7 @@ export declare class ContextAccessError extends Error {
  *
  * @example
  * ```ts
- * import { getContextOrNull } from './context'
+ * import { getContextOrNull } from './context.js'
  *
  * export const env = createContextProxy(
  *   () => getContextOrNull()?.env,
@@ -33,5 +39,13 @@ export declare class ContextAccessError extends Error {
  * const db = env.DB // ❌ ContextAccessError with guidance
  * ```
  */
-export declare function createContextProxy<T extends object>(getter: () => T | undefined, name: string): T;
+export interface CreateContextProxyOptions {
+    /**
+     * When `false`, the proxy throws a `TypeError` on `set` / `deleteProperty`
+     * (read-only semantics) and reports descriptors as non-writable. Defaults
+     * to `true` (mutable; mutations forwarded to the underlying object).
+     */
+    mutable?: boolean;
+}
+export declare function createContextProxy<T extends object>(getter: () => T | null | undefined, name: string, options?: CreateContextProxyOptions): T;
 //# sourceMappingURL=validation.d.ts.map

package/dist/runtime/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/runtime/validation.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,SAAgB,WAAW,EAAE,MAAM,CAAA;IACnC,SAAgB,YAAY,EAAE,MAAM,CAAA;IAEpC,YAAY,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAYpD;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACV,CAAC,CA2CH"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/runtime/validation.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,SAAgB,WAAW,EAAE,MAAM,CAAA;IACnC,SAAgB,YAAY,EAAE,MAAM,CAAA;IAEpC,YAAY,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAatE;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAa9D;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,yBAAyB;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACrC,CAAC,CAsEH"}

package/dist/secrets/local-secrets.d.ts

@@ -0,0 +1,46 @@
+import { type DevflareConfig } from '../config/index.js';
+export declare const LOCAL_SECRETS_PATH: string;
+export interface LocalSecretReference {
+    cwd: string;
+    storeId: string;
+    name: string;
+}
+export interface LocalSecretWrite extends LocalSecretReference {
+    value: string;
+}
+export interface LocalSecretListOptions {
+    cwd: string;
+    storeId?: string;
+}
+export interface LocalSecretListItem {
+    storeId: string;
+    name: string;
+    hasValue: boolean;
+    updatedAt: string;
+}
+export interface LocalSecretWrappedBindingConfig {
+    localBindingNames: string[];
+    wrappedBindings: Record<string, {
+        scriptName: string;
+        bindings: {
+            value: string;
+        };
+    }>;
+    workers: Array<{
+        name: string;
+        modules: true;
+        script: string;
+    }>;
+}
+export interface LocalSecretsStoreSecretBinding {
+    get(): Promise<string>;
+}
+export declare function writeLocalSecret({ cwd, storeId, name, value }: LocalSecretWrite): void;
+export declare function readLocalSecret({ cwd, storeId, name }: LocalSecretReference): string | undefined;
+export declare function deleteLocalSecret({ cwd, storeId, name }: LocalSecretReference): boolean;
+export declare function listLocalSecrets({ cwd, storeId }: LocalSecretListOptions): LocalSecretListItem[];
+export declare function resolveLocalSecretValuesForBindings(config: Pick<DevflareConfig, 'bindings' | 'secretsStoreId'>, cwd: string): Record<string, string>;
+export declare function buildLocalSecretWrappedBindingConfig(config: Pick<DevflareConfig, 'bindings' | 'secretsStoreId'>, cwd: string): LocalSecretWrappedBindingConfig;
+export declare function buildLocalSecretNodeBindings(config: Pick<DevflareConfig, 'bindings' | 'secretsStoreId'>, cwd: string): Record<string, LocalSecretsStoreSecretBinding>;
+export declare function seedMiniflareLocalSecrets(miniflare: unknown, config: Pick<DevflareConfig, 'bindings' | 'secretsStoreId'>, cwd: string): Promise<void>;
+//# sourceMappingURL=local-secrets.d.ts.map

package/dist/secrets/local-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-secrets.d.ts","sourceRoot":"","sources":["../../src/secrets/local-secrets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAgC,MAAM,WAAW,CAAA;AAE7E,eAAO,MAAM,kBAAkB,QAA0C,CAAA;AAYzE,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC7D,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB;AAeD,MAAM,WAAW,+BAA+B;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;IACpF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,8BAA8B;IAC9C,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACtB;AA2DD,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAQtF;AAED,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAavF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,sBAAsB,GAAG,mBAAmB,EAAE,CAYhG;AAED,wBAAgB,mCAAmC,CAClD,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,gBAAgB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxB;AAYD,wBAAgB,oCAAoC,CACnD,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,gBAAgB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACT,+BAA+B,CAwBjC;AAED,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,gBAAgB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAahD;AA6BD,wBAAsB,yBAAyB,CAC9C,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,gBAAgB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/shims/local-hyperdrive.d.ts

@@ -0,0 +1,12 @@
+export declare const HYPERDRIVE_CONNECT_MESSAGE: string;
+/**
+ * Creates a Hyperdrive binding around a local database connection string.
+ *
+ * The connection fields are real and usable with any Node database client. The
+ * Cloudflare `connect()` raw socket is intentionally not implemented — it would
+ * require faithfully reproducing `cloudflare:sockets` semantics (TLS, startTls(),
+ * half-open, SocketInfo) over node:net, which is exactly the kind of fake that
+ * fails silently. It throws a clear, actionable error instead.
+ */
+export declare function createLocalHyperdrive(connectionString: string): Hyperdrive;
+//# sourceMappingURL=local-hyperdrive.d.ts.map

package/dist/shims/local-hyperdrive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-hyperdrive.d.ts","sourceRoot":"","sources":["../../src/shims/local-hyperdrive.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,0BAA0B,QAIiD,CAAA;AAUxF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAc1E"}

package/dist/shims/local-media-bindings.d.ts

@@ -0,0 +1,19 @@
+import type { DevflareConfig } from '../config/index.js';
+export declare function createLocalImagesBinding(): ImagesBinding;
+export declare function createLocalMediaBinding(): MediaBinding;
+export interface LocalBindingShimServiceConfig {
+    localBindingNames: string[];
+    serviceBindings: Record<string, {
+        name: string;
+        entrypoint: string;
+    }>;
+    workers: Array<{
+        name: string;
+        modules: true;
+        script: string;
+        compatibilityDate: string;
+        compatibilityFlags?: string[];
+    }>;
+}
+export declare function buildLocalBindingShimServiceConfig(config: Pick<DevflareConfig, 'bindings' | 'compatibilityDate' | 'compatibilityFlags'>): LocalBindingShimServiceConfig;
+//# sourceMappingURL=local-media-bindings.d.ts.map

package/dist/shims/local-media-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-media-bindings.d.ts","sourceRoot":"","sources":["../../src/shims/local-media-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AA+F/C,wBAAgB,wBAAwB,IAAI,aAAa,CAgBxD;AAuCD,wBAAgB,uBAAuB,IAAI,YAAY,CAMtD;AAED,MAAM,WAAW,6BAA6B;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrE,OAAO,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,IAAI,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,iBAAiB,EAAE,MAAM,CAAA;QACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;KAC7B,CAAC,CAAA;CACF;AA8MD,wBAAgB,kCAAkC,CACjD,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,GACnF,6BAA6B,CAkC/B"}

package/dist/shims/local-worker-loader.d.ts

@@ -0,0 +1,3 @@
+export declare function createLocalWorkerLoaderBinding(): WorkerLoader;
+export declare function disposeLocalWorkerLoaderBindings(): Promise<void>;
+//# sourceMappingURL=local-worker-loader.d.ts.map

package/dist/shims/local-worker-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-worker-loader.d.ts","sourceRoot":"","sources":["../../src/shims/local-worker-loader.ts"],"names":[],"mappings":"AAkFA,wBAAgB,8BAA8B,IAAI,YAAY,CAY7D;AAED,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAStE"}

package/dist/sveltekit/index.d.ts

@@ -1,2 +1,2 @@
-export { handle, createDevflarePlatform, createHandle, resetPlatform, resetConfigCache, isDevflareDev, getBridgePort, type Platform, type DevflarePlatformOptions, type CreateHandleOptions } from './platform';
+export { handle, createDevflarePlatform, createHandle, resetPlatform, resetConfigCache, isDevflareDev, getBridgePort, type Platform, type DevflarePlatformOptions, type CreateHandleOptions } from './platform.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,MAAM,EAGN,sBAAsB,EACtB,YAAY,EAGZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EAGb,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,MAAM,EAEN,sBAAsB,EACtB,YAAY,EAEZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EAEb,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,MAAM,YAAY,CAAA"}