devflare 1.0.0-next.4 → 1.0.0-next.6

package/LLM.md

@@ -84,7 +84,7 @@ Use package subpaths intentionally.
 | Import | What it is for | What it exposes in practice |
 |---|---|---|
 | `devflare` | Main package entrypoint | `defineConfig`, config loading/compilation helpers, `ref()`, unified `env`, CLI helpers, bridge helpers, decorators, transform helpers, test helpers re-exported for convenience, `workerName` |
-| `devflare/runtime` | Worker-safe runtime utilities | middleware helpers like `sequence()`, `resolve()`, `pipe()`, validation helpers, decorators |
+| `devflare/runtime` | Worker-safe runtime utilities | request-scoped helpers like `env`, `ctx`, `event`, `locals`, `runWithContext`, plus middleware, validation helpers, and decorators |
 | `devflare/test` | Testing API | `createTestContext`, `cf`, `email`, `queue`, `scheduled`, `worker`, `tail`, mock helpers, remote skip helpers, bridge test context |
 | `devflare/vite` | Vite integration | `devflarePlugin`, plugin context helpers, config helpers, Vite-side types |
 | `devflare/sveltekit` | SvelteKit integration | `handle`, `createDevflarePlatform`, `createHandle`, dev/reset helpers, integration types |
@@ -95,7 +95,12 @@ Use package subpaths intentionally.
 
 `devflare/runtime` is intentionally **smaller** than the main package.
 
-Today it does **not** export the unified `env` proxy from the main `devflare` entrypoint. If you want `import { env } from 'devflare'`, import it from `devflare`, not `devflare/runtime`.
+It now exports the **worker-safe request-scoped runtime helpers** such as `env`, `ctx`, `event`, `locals`, and `runWithContext`.
+
+The main `devflare` entrypoint still exports the **unified** `env` proxy that can fall back to test or bridge contexts outside a live request. Use:
+
+- `import { env } from 'devflare/runtime'` for worker-only request-scoped runtime access
+- `import { env } from 'devflare'` when you specifically want the unified request/test/bridge-aware proxy
 
 ### Common main-package exports
 

package/README.md

@@ -119,7 +119,7 @@ Use subpaths intentionally.
 | Import | Use for |
 |---|---|
 | `devflare` | main package entrypoint: config helpers, `ref()`, unified `env`, CLI helpers, bridge helpers, decorators, test helpers, `workerName` |
-| `devflare/runtime` | worker-safe middleware/validation/decorator utilities |
+| `devflare/runtime` | worker-safe runtime helpers like `env`, `ctx`, `event`, `locals`, `runWithContext`, plus middleware/validation/decorator utilities |
 | `devflare/test` | `createTestContext`, `cf.*`, mock helpers, bridge test context, skip helpers |
 | `devflare/vite` | Vite integration |
 | `devflare/sveltekit` | SvelteKit integration |
@@ -128,7 +128,9 @@ Use subpaths intentionally.
 
 ### Important runtime note
 
-The published `devflare/runtime` subpath is intentionally smaller than the main package. If you want the unified `env` proxy, import it from `devflare`, not `devflare/runtime`.
+The published `devflare/runtime` subpath is intentionally smaller than the main package, but it now includes the worker-safe request-scoped runtime helpers such as `env`, `ctx`, `event`, `locals`, and `runWithContext`.
+
+Use `import { env } from 'devflare/runtime'` for request-scoped worker runtime access, or `import { env } from 'devflare'` when you specifically want the unified request/test/bridge-aware proxy.
 
 ---
 

package/dist/browser.d.ts

@@ -0,0 +1,50 @@
+export { defineConfig } from './config/define';
+export { ref, resolveRef, serviceBinding } from './config/ref';
+export { workerName } from './workerName';
+export { env } from './env';
+export { setBindingHints, createEnvProxy, initEnv, } from './bridge/proxy';
+export type { EnvProxyOptions, BindingHints } from './bridge/proxy';
+export { BridgeClient, getClient } from './bridge/client';
+export type { BridgeClientOptions } from './bridge/client';
+export { durableObject, getDurableObjectOptions, type DurableObjectOptions } from './decorators';
+export declare function loadConfig(..._args: any[]): Promise<never>;
+export declare const compileConfig: (...args: any[]) => any;
+export declare const stringifyConfig: (...args: any[]) => any;
+export declare const configSchema: Record<string, unknown>;
+export declare class ConfigNotFoundError extends Error {
+    readonly code = "CONFIG_NOT_FOUND";
+    constructor(..._args: any[]);
+}
+export declare class ConfigValidationError extends Error {
+    readonly code = "CONFIG_VALIDATION_ERROR";
+    constructor(..._args: any[]);
+}
+export declare const runCli: (...args: any[]) => any;
+export declare const parseArgs: (...args: any[]) => any;
+export declare const findDurableObjectClasses: (...args: any[]) => any;
+export declare const findDurableObjectClassesDetailed: (...args: any[]) => any;
+export declare const generateWrapper: (...args: any[]) => any;
+export declare const transformDurableObject: (...args: any[]) => any;
+export declare const transformWorkerEntrypoint: (...args: any[]) => any;
+export declare const findExportedFunctions: (...args: any[]) => any;
+export declare const shouldTransformWorker: (...args: any[]) => any;
+export declare const generateRpcInterface: (...args: any[]) => any;
+export declare const startMiniflare: (...args: any[]) => any;
+export declare const startMiniflareFromConfig: (...args: any[]) => any;
+export declare const getMiniflare: (...args: any[]) => any;
+export declare const stopMiniflare: (...args: any[]) => any;
+export declare const gateway: Record<string, unknown>;
+export declare const createTestContext: (...args: any[]) => any;
+export declare const createMockTestContext: (...args: any[]) => any;
+export declare const createMockKV: (...args: any[]) => any;
+export declare const createMockD1: (...args: any[]) => any;
+export declare const createMockR2: (...args: any[]) => any;
+export declare const createMockQueue: (...args: any[]) => any;
+export declare const createMockEnv: (...args: any[]) => any;
+export declare const withTestContext: (...args: any[]) => any;
+export declare const createBridgeTestContext: (...args: any[]) => any;
+export declare const stopBridgeTestContext: (...args: any[]) => any;
+export declare const getBridgeTestContext: (...args: any[]) => any;
+export declare const testEnv: Record<string, unknown>;
+export { defineConfig as default } from './config/define';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAG9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAG3B,OAAO,EACN,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D,OAAO,EACN,aAAa,EACb,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,MAAM,cAAc,CAAA;AAgCrB,wBAAsB,UAAU,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAEhE;AAED,eAAO,MAAM,aAAa,yBAAuC,CAAA;AACjE,eAAO,MAAM,eAAe,yBAAyC,CAAA;AACrE,eAAO,MAAM,YAAY,yBAAmE,CAAA;AAE5F,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,sBAAqB;IAElC,YAAY,GAAG,KAAK,EAAE,GAAG,EAAE,EAG1B;CACD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,6BAA4B;IAEzC,YAAY,GAAG,KAAK,EAAE,GAAG,EAAE,EAG1B;CACD;AAED,eAAO,MAAM,MAAM,yBAAgC,CAAA;AACnD,eAAO,MAAM,SAAS,yBAAmC,CAAA;AAEzD,eAAO,MAAM,wBAAwB,yBAAkD,CAAA;AACvF,eAAO,MAAM,gCAAgC,yBAA0D,CAAA;AACvG,eAAO,MAAM,eAAe,yBAAyC,CAAA;AACrE,eAAO,MAAM,sBAAsB,yBAAgD,CAAA;AACnF,eAAO,MAAM,yBAAyB,yBAAmD,CAAA;AACzF,eAAO,MAAM,qBAAqB,yBAA+C,CAAA;AACjF,eAAO,MAAM,qBAAqB,yBAA+C,CAAA;AACjF,eAAO,MAAM,oBAAoB,yBAA8C,CAAA;AAE/E,eAAO,MAAM,cAAc,yBAAwC,CAAA;AACnE,eAAO,MAAM,wBAAwB,yBAAkD,CAAA;AACvF,eAAO,MAAM,YAAY,yBAAsC,CAAA;AAC/D,eAAO,MAAM,aAAa,yBAAuC,CAAA;AACjE,eAAO,MAAM,OAAO,yBAA8D,CAAA;AAElF,eAAO,MAAM,iBAAiB,yBAA2C,CAAA;AACzE,eAAO,MAAM,qBAAqB,yBAA+C,CAAA;AACjF,eAAO,MAAM,YAAY,yBAAsC,CAAA;AAC/D,eAAO,MAAM,YAAY,yBAAsC,CAAA;AAC/D,eAAO,MAAM,YAAY,yBAAsC,CAAA;AAC/D,eAAO,MAAM,eAAe,yBAAyC,CAAA;AACrE,eAAO,MAAM,aAAa,yBAAuC,CAAA;AACjE,eAAO,MAAM,eAAe,yBAAyC,CAAA;AACrE,eAAO,MAAM,uBAAuB,yBAAiD,CAAA;AACrF,eAAO,MAAM,qBAAqB,yBAA+C,CAAA;AACjF,eAAO,MAAM,oBAAoB,yBAA8C,CAAA;AAC/E,eAAO,MAAM,OAAO,yBAA8D,CAAA;AAElF,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/browser.js

@@ -0,0 +1,149 @@
+import {
+  workerName
+} from "./index-62b3gt2g.js";
+import {
+  env
+} from "./index-9ats0s83.js";
+import"./index-npc1c8jx.js";
+import {
+  BridgeClient,
+  createEnvProxy,
+  getClient,
+  initEnv,
+  setBindingHints
+} from "./index-ccrh4w3t.js";
+import {
+  defineConfig,
+  ref,
+  resolveRef,
+  serviceBinding
+} from "./index-v8vvsn9x.js";
+import {
+  durableObject,
+  getDurableObjectOptions
+} from "./index-a855bdsx.js";
+import"./index-37x76zdn.js";
+
+// src/browser.ts
+function createUnsupportedApiError(name) {
+  return new Error(`${name} is not available in worker/browser bundles. ` + `Import it from the Node-side devflare package entry instead.`);
+}
+function unsupportedFunction(name) {
+  return (..._args) => {
+    throw createUnsupportedApiError(name);
+  };
+}
+function createUnsupportedObject(name) {
+  return new Proxy({}, {
+    get() {
+      throw createUnsupportedApiError(name);
+    },
+    has() {
+      return false;
+    },
+    ownKeys() {
+      return [];
+    },
+    getOwnPropertyDescriptor() {
+      return;
+    }
+  });
+}
+async function loadConfig(..._args) {
+  throw createUnsupportedApiError("loadConfig");
+}
+var compileConfig = unsupportedFunction("compileConfig");
+var stringifyConfig = unsupportedFunction("stringifyConfig");
+var configSchema = createUnsupportedObject("configSchema");
+
+class ConfigNotFoundError extends Error {
+  code = "CONFIG_NOT_FOUND";
+  constructor(..._args) {
+    super(createUnsupportedApiError("ConfigNotFoundError").message);
+    this.name = "ConfigNotFoundError";
+  }
+}
+
+class ConfigValidationError extends Error {
+  code = "CONFIG_VALIDATION_ERROR";
+  constructor(..._args) {
+    super(createUnsupportedApiError("ConfigValidationError").message);
+    this.name = "ConfigValidationError";
+  }
+}
+var runCli = unsupportedFunction("runCli");
+var parseArgs = unsupportedFunction("parseArgs");
+var findDurableObjectClasses = unsupportedFunction("findDurableObjectClasses");
+var findDurableObjectClassesDetailed = unsupportedFunction("findDurableObjectClassesDetailed");
+var generateWrapper = unsupportedFunction("generateWrapper");
+var transformDurableObject = unsupportedFunction("transformDurableObject");
+var transformWorkerEntrypoint = unsupportedFunction("transformWorkerEntrypoint");
+var findExportedFunctions = unsupportedFunction("findExportedFunctions");
+var shouldTransformWorker = unsupportedFunction("shouldTransformWorker");
+var generateRpcInterface = unsupportedFunction("generateRpcInterface");
+var startMiniflare = unsupportedFunction("startMiniflare");
+var startMiniflareFromConfig = unsupportedFunction("startMiniflareFromConfig");
+var getMiniflare = unsupportedFunction("getMiniflare");
+var stopMiniflare = unsupportedFunction("stopMiniflare");
+var gateway = createUnsupportedObject("gateway");
+var createTestContext = unsupportedFunction("createTestContext");
+var createMockTestContext = unsupportedFunction("createMockTestContext");
+var createMockKV = unsupportedFunction("createMockKV");
+var createMockD1 = unsupportedFunction("createMockD1");
+var createMockR2 = unsupportedFunction("createMockR2");
+var createMockQueue = unsupportedFunction("createMockQueue");
+var createMockEnv = unsupportedFunction("createMockEnv");
+var withTestContext = unsupportedFunction("withTestContext");
+var createBridgeTestContext = unsupportedFunction("createBridgeTestContext");
+var stopBridgeTestContext = unsupportedFunction("stopBridgeTestContext");
+var getBridgeTestContext = unsupportedFunction("getBridgeTestContext");
+var testEnv = createUnsupportedObject("testEnv");
+export {
+  workerName,
+  withTestContext,
+  transformWorkerEntrypoint,
+  transformDurableObject,
+  testEnv,
+  stringifyConfig,
+  stopMiniflare,
+  stopBridgeTestContext,
+  startMiniflareFromConfig,
+  startMiniflare,
+  shouldTransformWorker,
+  setBindingHints,
+  serviceBinding,
+  runCli,
+  resolveRef,
+  ref,
+  parseArgs,
+  loadConfig,
+  initEnv,
+  getMiniflare,
+  getDurableObjectOptions,
+  getClient,
+  getBridgeTestContext,
+  generateWrapper,
+  generateRpcInterface,
+  gateway,
+  findExportedFunctions,
+  findDurableObjectClassesDetailed,
+  findDurableObjectClasses,
+  env,
+  durableObject,
+  defineConfig,
+  defineConfig as default,
+  createTestContext,
+  createMockTestContext,
+  createMockR2,
+  createMockQueue,
+  createMockKV,
+  createMockEnv,
+  createMockD1,
+  createEnvProxy,
+  createBridgeTestContext,
+  configSchema,
+  compileConfig,
+  ConfigValidationError,
+  ConfigNotFoundError,
+  BridgeClient
+};