devflare 1.0.0-next.4 → 1.0.0-next.41

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"}