devflare 1.0.0-next.2 → 1.0.0-next.21

package/dist/index-tknbyxzn.js

@@ -0,0 +1,2202 @@
+import {
+  wrapEnvSendEmailBindings
+} from "./index-hpwa6vsw.js";
+
+// src/runtime/validation.ts
+class ContextAccessError extends Error {
+  contextName;
+  propertyName;
+  constructor(contextName, propertyName) {
+    super(`Cannot access ${contextName}.${propertyName} outside of an active Devflare handler trail.
+
+` + `This typically happens when:
+` + `  1. Accessing ${contextName} at module top-level (during import)
+` + `  2. Accessing ${contextName} in a callback that runs after the handler ends
+` + `  3. Accessing ${contextName} in a setTimeout/setInterval callback
+
+` + `Move the access inside your handler function or middleware.`);
+    this.name = "ContextAccessError";
+    this.contextName = contextName;
+    this.propertyName = propertyName;
+  }
+}
+function createContextProxy(getter, name, options = {}) {
+  const mutable = options.mutable ?? true;
+  return new Proxy({}, {
+    get(_target, prop) {
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        throw new ContextAccessError(name, String(prop));
+      }
+      return ctx[prop];
+    },
+    set(_target, prop, value) {
+      if (!mutable) {
+        throw new TypeError(`Cannot assign to '${String(prop)}' on '${name}' because it is read-only.
+` + `Use 'locals' for mutable request-scoped data.`);
+      }
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        throw new ContextAccessError(name, String(prop));
+      }
+      ctx[prop] = value;
+      return true;
+    },
+    deleteProperty(_target, prop) {
+      if (!mutable) {
+        throw new TypeError(`Cannot delete property '${String(prop)}' from '${name}' because it is read-only.`);
+      }
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        return true;
+      }
+      return Reflect.deleteProperty(ctx, prop);
+    },
+    has(_target, prop) {
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        return false;
+      }
+      return prop in ctx;
+    },
+    ownKeys(_target) {
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        return [];
+      }
+      return Reflect.ownKeys(ctx);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+      const ctx = getter();
+      if (ctx === undefined || ctx === null) {
+        return;
+      }
+      const descriptor = Reflect.getOwnPropertyDescriptor(ctx, prop);
+      if (!descriptor) {
+        return;
+      }
+      if (!mutable) {
+        return { ...descriptor, writable: false };
+      }
+      return descriptor;
+    }
+  });
+}
+
+// src/runtime/context-events.ts
+function createLocals(locals) {
+  return locals ?? {};
+}
+function prepareEventShell(env, options = {}) {
+  return {
+    env: wrapEnvSendEmailBindings(env),
+    locals: createLocals(options.locals)
+  };
+}
+function createAugmentedTarget(target, extra) {
+  return new Proxy(target, {
+    get(target2, prop) {
+      if (prop in extra) {
+        return extra[prop];
+      }
+      const value = Reflect.get(target2, prop, target2);
+      return typeof value === "function" ? value.bind(target2) : value;
+    },
+    has(target2, prop) {
+      return prop in extra || prop in target2;
+    },
+    ownKeys(target2) {
+      return Array.from(new Set([
+        ...Reflect.ownKeys(target2),
+        ...Reflect.ownKeys(extra)
+      ]));
+    },
+    getOwnPropertyDescriptor(target2, prop) {
+      if (prop in extra) {
+        return {
+          configurable: true,
+          enumerable: true,
+          writable: false,
+          value: extra[prop]
+        };
+      }
+      return Reflect.getOwnPropertyDescriptor(target2, prop);
+    }
+  });
+}
+function createBaseEvent(type, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return {
+    type,
+    ctx,
+    ...shell,
+    request: options.request ?? null,
+    params: options.params
+  };
+}
+function createFetchEvent(request, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(request, {
+    type: "fetch",
+    ctx,
+    ...shell,
+    url: new URL(request.url),
+    request,
+    params: options.params ?? {}
+  });
+}
+function createQueueEvent(batch, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(batch, {
+    type: "queue",
+    ctx,
+    ...shell,
+    batch
+  });
+}
+function createScheduledEvent(controller, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(controller, {
+    type: "scheduled",
+    ctx,
+    ...shell,
+    controller
+  });
+}
+function createEmailEvent(message, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(message, {
+    type: "email",
+    ctx,
+    ...shell,
+    message
+  });
+}
+function createTailEvent(events, env, ctx, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(events, {
+    type: "tail",
+    ctx,
+    ...shell,
+    events
+  });
+}
+function createDurableObjectFetchEvent(request, env, state, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(request, {
+    type: "durable-object-fetch",
+    ctx: state,
+    state,
+    ...shell,
+    request
+  });
+}
+function createDurableObjectAlarmEvent(env, state, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return {
+    type: "durable-object-alarm",
+    ctx: state,
+    state,
+    ...shell
+  };
+}
+function createDurableObjectWebSocketMessageEvent(ws, message, env, state, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(ws, {
+    type: "durable-object-websocket-message",
+    ctx: state,
+    state,
+    ...shell,
+    ws,
+    message
+  });
+}
+function createDurableObjectWebSocketCloseEvent(ws, code, reason, wasClean, env, state, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(ws, {
+    type: "durable-object-websocket-close",
+    ctx: state,
+    state,
+    ...shell,
+    ws,
+    code,
+    reason,
+    wasClean
+  });
+}
+function createDurableObjectWebSocketErrorEvent(ws, error, env, state, options = {}) {
+  const shell = prepareEventShell(env, { locals: options.locals });
+  return createAugmentedTarget(ws, {
+    type: "durable-object-websocket-error",
+    ctx: state,
+    state,
+    ...shell,
+    ws,
+    error
+  });
+}
+function createDefaultEvent(env, ctx, request, type, locals) {
+  switch (type) {
+    case "fetch": {
+      if (request && ctx) {
+        return createFetchEvent(request, env, ctx, { locals });
+      }
+      return createBaseEvent(type, env, ctx, { locals, request });
+    }
+    case "durable-object-fetch": {
+      if (request && ctx) {
+        return createDurableObjectFetchEvent(request, env, ctx, { locals });
+      }
+      return createBaseEvent(type, env, ctx, { locals, request });
+    }
+    case "durable-object-alarm": {
+      if (ctx) {
+        return createDurableObjectAlarmEvent(env, ctx, { locals });
+      }
+      return createBaseEvent(type, env, ctx, { locals });
+    }
+    case "queue":
+    case "scheduled":
+    case "email":
+    case "tail":
+    case "durable-object-websocket-message":
+    case "durable-object-websocket-close":
+    case "durable-object-websocket-error":
+      return createBaseEvent(type, env, ctx, { locals, request });
+    default: {
+      const exhaustive = type;
+      throw new Error(`createDefaultEvent: unknown event type ${String(exhaustive)}`);
+    }
+  }
+}
+
+// src/runtime/context.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var storage = new AsyncLocalStorage;
+function createLocals2() {
+  return {};
+}
+function runWithContext(env, ctx, request, fn, type = "fetch") {
+  const locals = createLocals2();
+  const event = createDefaultEvent(env, ctx, request, type, locals);
+  return runWithEventContext(event, fn);
+}
+function runWithEventContext(event, fn) {
+  const context = {
+    env: event.env,
+    ctx: event.ctx,
+    request: event.request ?? null,
+    locals: event.locals,
+    type: event.type,
+    event
+  };
+  return storage.run(context, fn);
+}
+function getContext() {
+  const context = storage.getStore();
+  if (!context) {
+    throw new ContextUnavailableError;
+  }
+  return context;
+}
+function getContextOrNull() {
+  const context = storage.getStore();
+  return context ?? null;
+}
+function getEventContext() {
+  return getContext().event;
+}
+function getEventContextOrNull() {
+  return getContextOrNull()?.event ?? null;
+}
+function hasContext() {
+  return storage.getStore() !== undefined;
+}
+function createEventAccessor(name, matcher) {
+  const accessor = () => {
+    const currentEvent = getEventContextOrNull();
+    if (!currentEvent) {
+      throw new ContextUnavailableError;
+    }
+    if (!matcher(currentEvent)) {
+      throw new ContextUnavailableError(`${name} is not available in the current '${currentEvent.type}' context.
+
+Devflare stores event objects in AsyncLocalStorage so helpers called within a handler can reach the active event.
+Use ${name}.safe() to return null instead of throwing, or call the getter that matches the active surface.`);
+    }
+    return currentEvent;
+  };
+  accessor.safe = () => {
+    const currentEvent = getEventContextOrNull();
+    return currentEvent && matcher(currentEvent) ? currentEvent : null;
+  };
+  return accessor;
+}
+function isFetchEvent(event) {
+  return event.type === "fetch" && event.request instanceof Request;
+}
+function isQueueEvent(event) {
+  return event.type === "queue" && "batch" in event;
+}
+function isScheduledEvent(event) {
+  return event.type === "scheduled" && "controller" in event;
+}
+function isEmailEvent(event) {
+  return event.type === "email" && "message" in event;
+}
+function isTailEvent(event) {
+  return event.type === "tail" && Array.isArray(event) && "events" in event;
+}
+function isDurableObjectEvent(event) {
+  return event.type.startsWith("durable-object-") && "state" in event;
+}
+function isDurableObjectFetchEvent(event) {
+  return event.type === "durable-object-fetch" && event.request instanceof Request;
+}
+function isDurableObjectAlarmEvent(event) {
+  return event.type === "durable-object-alarm" && "state" in event;
+}
+function isDurableObjectWebSocketMessageEvent(event) {
+  return event.type === "durable-object-websocket-message" && "ws" in event && "message" in event;
+}
+function isDurableObjectWebSocketCloseEvent(event) {
+  return event.type === "durable-object-websocket-close" && "ws" in event && "code" in event;
+}
+function isDurableObjectWebSocketErrorEvent(event) {
+  return event.type === "durable-object-websocket-error" && "ws" in event && "error" in event;
+}
+var getFetchEvent = createEventAccessor("getFetchEvent()", isFetchEvent);
+var getQueueEvent = createEventAccessor("getQueueEvent()", isQueueEvent);
+var getScheduledEvent = createEventAccessor("getScheduledEvent()", isScheduledEvent);
+var getEmailEvent = createEventAccessor("getEmailEvent()", isEmailEvent);
+var getTailEvent = createEventAccessor("getTailEvent()", isTailEvent);
+var getDurableObjectEvent = createEventAccessor("getDurableObjectEvent()", isDurableObjectEvent);
+var getDurableObjectFetchEvent = createEventAccessor("getDurableObjectFetchEvent()", isDurableObjectFetchEvent);
+var getDurableObjectAlarmEvent = createEventAccessor("getDurableObjectAlarmEvent()", isDurableObjectAlarmEvent);
+var getDurableObjectWebSocketMessageEvent = createEventAccessor("getDurableObjectWebSocketMessageEvent()", isDurableObjectWebSocketMessageEvent);
+var getDurableObjectWebSocketCloseEvent = createEventAccessor("getDurableObjectWebSocketCloseEvent()", isDurableObjectWebSocketCloseEvent);
+var getDurableObjectWebSocketErrorEvent = createEventAccessor("getDurableObjectWebSocketErrorEvent()", isDurableObjectWebSocketErrorEvent);
+
+class ContextUnavailableError extends ContextAccessError {
+  code = "CONTEXT_UNAVAILABLE";
+  constructor(message) {
+    super("context", "<unavailable>");
+    if (message !== undefined) {
+      this.message = message;
+    } else {
+      this.message = `Context not available. Devflare uses AsyncLocalStorage to carry the active event through fetch, queue, scheduled, email, tail, and Durable Object handler call chains.
+
+` + `This usually means one of:
+
+` + `1. Accessing context at module top-level (runs at cold start, not per-request)
+` + `2. Accessing context in setTimeout/setInterval callbacks
+` + `3. Missing 'nodejs_compat' compatibility flag in your worker config
+
+` + `Fix: Move the access inside your handler, middleware, or a helper called from that handler trail.
+` + `Learn more: https://devflare.dev/docs/context-errors`;
+    }
+    this.name = "ContextUnavailableError";
+  }
+}
+
+// src/bridge/v2/wire.ts
+var BinaryKind = {
+  StreamChunk: 1,
+  WsData: 2
+};
+var BinaryFlags = {
+  FIN: 1,
+  TEXT: 2
+};
+var BINARY_HEADER_SIZE = 10;
+function encodeBinaryFrame(kind, id, seq, flags, payload) {
+  const frame = new Uint8Array(BINARY_HEADER_SIZE + payload.byteLength);
+  const view = new DataView(frame.buffer);
+  view.setUint8(0, kind);
+  view.setUint32(1, id, true);
+  view.setUint32(5, seq, true);
+  view.setUint8(9, flags);
+  frame.set(payload, BINARY_HEADER_SIZE);
+  return frame;
+}
+function parseJsonMsg(data) {
+  const msg = JSON.parse(data);
+  if (typeof msg !== "object" || msg === null || !("t" in msg)) {
+    throw new Error("Invalid message: missing type field");
+  }
+  return msg;
+}
+function stringifyJsonMsg(msg) {
+  return JSON.stringify(msg);
+}
+var streamIdCounter = 0;
+var wsIdCounter = 0;
+function nextStreamId() {
+  return ++streamIdCounter;
+}
+function nextWsId() {
+  return ++wsIdCounter;
+}
+var DEFAULT_CHUNK_SIZE = 256 * 1024;
+var HTTP_TRANSFER_THRESHOLD = 512 * 1024;
+var DEFAULT_BRIDGE_PORT = 8686;
+
+// src/bridge/v2/value-serialization.ts
+async function serializeRequest(request, options) {
+  const streams = [];
+  const threshold = options?.httpThreshold ?? 10 * 1024 * 1024;
+  const headers = [];
+  request.headers.forEach((value, key) => {
+    headers.push([key, value]);
+  });
+  let body = null;
+  if (request.body) {
+    const bytes = await request.arrayBuffer();
+    if (bytes.byteLength > threshold) {
+      throw new Error("http body transfer not implemented; caller should use inline or binary transfer");
+    } else if (bytes.byteLength > 0) {
+      body = { type: "bytes", data: base64Encode(new Uint8Array(bytes)) };
+    }
+  }
+  return {
+    serialized: {
+      url: request.url,
+      method: request.method,
+      headers,
+      body,
+      redirect: request.redirect
+    },
+    streams
+  };
+}
+function deserializeRequest(serialized, getStream) {
+  let body = null;
+  if (serialized.body) {
+    switch (serialized.body.type) {
+      case "bytes":
+        body = base64Decode(serialized.body.data);
+        break;
+      case "stream":
+        if (getStream) {
+          body = getStream(serialized.body.sid) ?? null;
+        }
+        break;
+    }
+  }
+  return new Request(serialized.url, {
+    method: serialized.method,
+    headers: serialized.headers,
+    body,
+    redirect: serialized.redirect
+  });
+}
+async function serializeResponse(response, options) {
+  const streams = [];
+  const threshold = options?.httpThreshold ?? 10 * 1024 * 1024;
+  const headers = [];
+  response.headers.forEach((value, key) => {
+    headers.push([key, value]);
+  });
+  let body = null;
+  if (response.body) {
+    const bytes = await response.arrayBuffer();
+    if (bytes.byteLength > threshold) {
+      throw new Error("http body transfer not implemented; caller should use inline or binary transfer");
+    } else if (bytes.byteLength > 0) {
+      body = { type: "bytes", data: base64Encode(new Uint8Array(bytes)) };
+    }
+  }
+  return {
+    serialized: {
+      status: response.status,
+      statusText: response.statusText,
+      headers,
+      body
+    },
+    streams
+  };
+}
+function deserializeResponse(serialized, getStream) {
+  let body = null;
+  if (serialized.body) {
+    switch (serialized.body.type) {
+      case "bytes":
+        body = base64Decode(serialized.body.data);
+        break;
+      case "stream":
+        if (getStream) {
+          body = getStream(serialized.body.sid) ?? null;
+        }
+        break;
+    }
+  }
+  return new Response(body, {
+    status: serialized.status,
+    statusText: serialized.statusText,
+    headers: serialized.headers
+  });
+}
+async function serializeValue(value) {
+  const streams = [];
+  const result = await serializeValueInternal(value, streams);
+  return { value: result, streams };
+}
+async function serializeValueInternal(value, streams) {
+  if (value === null || value === undefined) {
+    return value;
+  }
+  if (value instanceof Request) {
+    const { serialized, streams: reqStreams } = await serializeRequest(value);
+    streams.push(...reqStreams);
+    return { __type: "Request", ...serialized };
+  }
+  if (value instanceof Response) {
+    const { serialized, streams: resStreams } = await serializeResponse(value);
+    streams.push(...resStreams);
+    return { __type: "Response", ...serialized };
+  }
+  if (value instanceof ReadableStream) {
+    const sid = nextStreamId();
+    streams.push({ sid, stream: value });
+    return { __type: "ReadableStream", sid };
+  }
+  if (value instanceof Uint8Array) {
+    return { __type: "Uint8Array", data: base64Encode(value) };
+  }
+  if (value instanceof ArrayBuffer) {
+    return { __type: "ArrayBuffer", data: base64Encode(new Uint8Array(value)) };
+  }
+  if (value instanceof Date) {
+    return { __devflare: "date", iso: value.toISOString() };
+  }
+  if (value instanceof URL) {
+    return { __devflare: "url", href: value.href };
+  }
+  if (value instanceof Error) {
+    const encoded = {
+      __devflare: "error",
+      name: value.name,
+      message: value.message
+    };
+    if (value.stack)
+      encoded.stack = value.stack;
+    return encoded;
+  }
+  if (value instanceof Map) {
+    const entries = [];
+    for (const [k, v] of value.entries()) {
+      entries.push([
+        await serializeValueInternal(k, streams),
+        await serializeValueInternal(v, streams)
+      ]);
+    }
+    return { __devflare: "map", entries };
+  }
+  if (value instanceof Set) {
+    const values = [];
+    for (const v of value.values()) {
+      values.push(await serializeValueInternal(v, streams));
+    }
+    return { __devflare: "set", values };
+  }
+  if (Array.isArray(value)) {
+    return Promise.all(value.map((v) => serializeValueInternal(v, streams)));
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = await serializeValueInternal(v, streams);
+    }
+    return result;
+  }
+  return value;
+}
+function deserializeValue(value, getStream) {
+  if (value === null || value === undefined) {
+    return value;
+  }
+  if (typeof value === "object" && value !== null) {
+    const obj = value;
+    if (typeof obj.__devflare === "string") {
+      switch (obj.__devflare) {
+        case "date":
+          return new Date(obj.iso);
+        case "url":
+          return new URL(obj.href);
+        case "error": {
+          const err = new Error(obj.message);
+          if (typeof obj.name === "string")
+            err.name = obj.name;
+          if (typeof obj.stack === "string")
+            err.stack = obj.stack;
+          return err;
+        }
+        case "map": {
+          const entries = obj.entries ?? [];
+          const map = new Map;
+          for (const [k, v] of entries) {
+            map.set(deserializeValue(k, getStream), deserializeValue(v, getStream));
+          }
+          return map;
+        }
+        case "set": {
+          const values = obj.values ?? [];
+          const set = new Set;
+          for (const v of values) {
+            set.add(deserializeValue(v, getStream));
+          }
+          return set;
+        }
+      }
+    }
+    if (obj.__type === "Request") {
+      return deserializeRequest(obj, getStream);
+    }
+    if (obj.__type === "Response") {
+      return deserializeResponse(obj, getStream);
+    }
+    if (obj.__type === "ReadableStream") {
+      const sid = obj.sid;
+      return getStream?.(sid) ?? null;
+    }
+    if (obj.__type === "Uint8Array") {
+      return base64Decode(obj.data);
+    }
+    if (obj.__type === "ArrayBuffer") {
+      return base64Decode(obj.data).buffer;
+    }
+    if (obj.__type === "R2Object") {
+      return deserializeR2Object(obj);
+    }
+    if (obj.__type === "R2ObjectBody") {
+      return deserializeR2ObjectBody(obj);
+    }
+    if (Array.isArray(value)) {
+      return value.map((v) => deserializeValue(v, getStream));
+    }
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+      result[k] = deserializeValue(v, getStream);
+    }
+    return result;
+  }
+  return value;
+}
+function applySerializedHttpMetadata(headers, httpMetadata) {
+  if (httpMetadata?.contentType) {
+    headers.set("Content-Type", httpMetadata.contentType);
+  }
+  if (httpMetadata?.contentLanguage) {
+    headers.set("Content-Language", httpMetadata.contentLanguage);
+  }
+  if (httpMetadata?.contentDisposition) {
+    headers.set("Content-Disposition", httpMetadata.contentDisposition);
+  }
+  if (httpMetadata?.contentEncoding) {
+    headers.set("Content-Encoding", httpMetadata.contentEncoding);
+  }
+  if (httpMetadata?.cacheControl) {
+    headers.set("Cache-Control", httpMetadata.cacheControl);
+  }
+  if (httpMetadata?.cacheExpiry) {
+    headers.set("Expires", new Date(httpMetadata.cacheExpiry).toUTCString());
+  }
+}
+function createSerializedR2Metadata(serialized) {
+  return {
+    key: serialized.key,
+    version: serialized.version,
+    size: serialized.size,
+    etag: serialized.etag,
+    httpEtag: serialized.httpEtag,
+    checksums: serialized.checksums,
+    uploaded: serialized.uploaded ? new Date(serialized.uploaded) : new Date,
+    httpMetadata: serialized.httpMetadata,
+    customMetadata: serialized.customMetadata,
+    range: serialized.range,
+    storageClass: serialized.storageClass,
+    writeHttpMetadata(headers) {
+      applySerializedHttpMetadata(headers, serialized.httpMetadata);
+    }
+  };
+}
+function deserializeR2Object(obj) {
+  const serialized = obj;
+  return {
+    ...createSerializedR2Metadata(serialized)
+  };
+}
+function deserializeR2ObjectBody(obj) {
+  const serialized = obj;
+  const bodyBytes = serialized.bodyData ? base64Decode(serialized.bodyData) : new Uint8Array(0);
+  const r2ObjectBody = {
+    ...createSerializedR2Metadata(serialized),
+    body: new ReadableStream({
+      start(controller) {
+        controller.enqueue(bodyBytes);
+        controller.close();
+      }
+    }),
+    bodyUsed: false,
+    async arrayBuffer() {
+      const copy = new Uint8Array(bodyBytes.byteLength);
+      copy.set(bodyBytes);
+      return copy.buffer;
+    },
+    async text() {
+      return new TextDecoder().decode(bodyBytes);
+    },
+    async json() {
+      const text = new TextDecoder().decode(bodyBytes);
+      return JSON.parse(text);
+    },
+    async blob() {
+      const contentType = serialized.httpMetadata?.contentType || "application/octet-stream";
+      const buffer = bodyBytes.buffer.slice(bodyBytes.byteOffset, bodyBytes.byteOffset + bodyBytes.byteLength);
+      return new Blob([buffer], { type: contentType });
+    }
+  };
+  return r2ObjectBody;
+}
+function base64Encode(bytes) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let binary = "";
+  for (let i = 0;i < bytes.byteLength; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+function base64Decode(str) {
+  if (typeof Buffer !== "undefined") {
+    return new Uint8Array(Buffer.from(str, "base64"));
+  }
+  const binary = atob(str);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0;i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+
+// src/bridge/v2/frames.ts
+var TRANSPORT_V2_PROTOCOL_VERSION = 2;
+var TRANSPORT_V2_UNSUPPORTED_VERSION_CLOSE_CODE = 4001;
+var TransportV2BinaryKind = {
+  StreamChunk: 1,
+  WsData: 2,
+  BodyChunk: 3
+};
+var TransportV2BinaryFlags = {
+  FIN: 1,
+  TEXT: 2,
+  ABORT: 4
+};
+var TRANSPORT_V2_BINARY_HEADER_SIZE = 10;
+function decodeTransportV2BinaryFrame(frame) {
+  if (frame.byteLength < TRANSPORT_V2_BINARY_HEADER_SIZE) {
+    throw new Error(`Invalid transport v2 binary frame: too short (${frame.byteLength} bytes, need at least ${TRANSPORT_V2_BINARY_HEADER_SIZE})`);
+  }
+  const view = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);
+  const kind = view.getUint8(0);
+  if (kind !== TransportV2BinaryKind.StreamChunk && kind !== TransportV2BinaryKind.WsData && kind !== TransportV2BinaryKind.BodyChunk) {
+    throw new Error(`Invalid transport v2 binary frame: unknown kind ${kind}`);
+  }
+  return {
+    kind,
+    id: view.getUint32(1, true),
+    seq: view.getUint32(5, true),
+    flags: view.getUint8(9),
+    payload: frame.subarray(TRANSPORT_V2_BINARY_HEADER_SIZE)
+  };
+}
+function transportV2IsFin(flags) {
+  return (flags & TransportV2BinaryFlags.FIN) !== 0;
+}
+function transportV2IsAbort(flags) {
+  return (flags & TransportV2BinaryFlags.ABORT) !== 0;
+}
+var KNOWN_V2_CONTROL_TYPES = new Set([
+  "hello",
+  "welcome",
+  "body.open",
+  "body.end",
+  "body.abort"
+]);
+function parseTransportV2ControlMsg(data) {
+  const msg = JSON.parse(data);
+  if (typeof msg !== "object" || msg === null || !("t" in msg)) {
+    throw new Error("Invalid transport v2 control message: missing type field");
+  }
+  if (!KNOWN_V2_CONTROL_TYPES.has(msg.t)) {
+    throw new Error(`Invalid transport v2 control message: unknown type "${msg.t}"`);
+  }
+  if (msg.t === "hello" || msg.t === "welcome") {
+    if (msg.protocolVersion !== TRANSPORT_V2_PROTOCOL_VERSION) {
+      throw new Error(`Invalid transport v2 ${msg.t}: protocolVersion ${msg.protocolVersion} != ${TRANSPORT_V2_PROTOCOL_VERSION}`);
+    }
+    if (!Array.isArray(msg.capabilities)) {
+      throw new Error(`Invalid transport v2 ${msg.t}: capabilities must be an array`);
+    }
+  }
+  return msg;
+}
+function stringifyTransportV2ControlMsg(msg) {
+  return JSON.stringify(msg);
+}
+function negotiateTransportV2Capabilities(supported, advertised) {
+  const supportedSet = new Set(supported);
+  const intersection = advertised.filter((cap) => supportedSet.has(cap));
+  return [...new Set(intersection)].sort();
+}
+
+// src/bridge/v2/body-streams.ts
+var TRANSPORT_V2_DEFAULT_BODY_CHUNK_SIZE = 256 * 1024;
+class TransportV2BodyReaderRegistry {
+  #streams = new Map;
+  getOrOpen(bid) {
+    const existing = this.#streams.get(bid);
+    if (existing !== undefined)
+      return existing.stream;
+    return this.open(bid);
+  }
+  open(bid) {
+    if (this.#streams.has(bid)) {
+      throw new Error(`v2 body reader already registered for bid ${bid}`);
+    }
+    const state = {
+      controller: null,
+      stream: null,
+      closed: false
+    };
+    state.stream = new ReadableStream({
+      start: (controller) => {
+        state.controller = controller;
+      },
+      cancel: () => {
+        state.closed = true;
+        this.#streams.delete(bid);
+      }
+    });
+    this.#streams.set(bid, state);
+    return state.stream;
+  }
+  pushChunk(frame) {
+    if (frame.kind !== TransportV2BinaryKind.BodyChunk) {
+      throw new Error(`v2 body reader received non-BodyChunk frame (kind=${frame.kind})`);
+    }
+    const state = this.#streams.get(frame.id);
+    if (state === undefined || state.closed)
+      return;
+    const isFin = transportV2IsFin(frame.flags);
+    const isAbort = transportV2IsAbort(frame.flags);
+    if (isAbort) {
+      state.closed = true;
+      state.controller?.error(new Error(`v2 body stream ${frame.id} aborted by writer`));
+      this.#streams.delete(frame.id);
+      return;
+    }
+    if (frame.payload.byteLength > 0) {
+      state.controller?.enqueue(new Uint8Array(frame.payload));
+    }
+    if (isFin) {
+      state.closed = true;
+      state.controller?.close();
+      this.#streams.delete(frame.id);
+    }
+  }
+  end(bid) {
+    const state = this.#streams.get(bid);
+    if (state === undefined || state.closed)
+      return;
+    state.closed = true;
+    state.controller?.close();
+    this.#streams.delete(bid);
+  }
+  abort(bid, reason) {
+    const state = this.#streams.get(bid);
+    if (state === undefined || state.closed)
+      return;
+    state.closed = true;
+    state.controller?.error(new Error(reason ?? `v2 body stream ${bid} aborted`));
+    this.#streams.delete(bid);
+  }
+  get size() {
+    return this.#streams.size;
+  }
+}
+
+// src/bridge/v2/codec.ts
+class TransportV2Codec {
+  bodyReaders = new TransportV2BodyReaderRegistry;
+  #socket;
+  #capabilities;
+  #options;
+  #handshakeResolver = null;
+  #handshakePromise;
+  #sentHello = false;
+  #receivedHello = false;
+  #receivedWelcome = false;
+  #negotiated = null;
+  #pendingRpc = new Map;
+  #nextBid = 1;
+  #nextRpcId = 1;
+  #closed = false;
+  constructor(socket, options = {}) {
+    this.#socket = socket;
+    this.#capabilities = options.capabilities ?? [];
+    this.#options = options;
+    this.#handshakePromise = new Promise((resolve, reject) => {
+      this.#handshakeResolver = { resolve, reject };
+    });
+    socket.onmessage = (event) => this.#onMessage(event);
+    socket.onclose = () => this.#onClose();
+    socket.onerror = (event) => this.#onError(event.error);
+  }
+  allocateBid() {
+    return this.#nextBid++;
+  }
+  allocateRpcId() {
+    return `v2_rpc_${this.#nextRpcId++}`;
+  }
+  sendHello() {
+    if (this.#sentHello)
+      return;
+    this.#sentHello = true;
+    const hello = {
+      t: "hello",
+      protocolVersion: TRANSPORT_V2_PROTOCOL_VERSION,
+      capabilities: [...this.#capabilities]
+    };
+    this.#socket.send(stringifyTransportV2ControlMsg(hello));
+  }
+  get handshake() {
+    return this.#handshakePromise;
+  }
+  get negotiated() {
+    return this.#negotiated;
+  }
+  sendText(message) {
+    if (this.#closed) {
+      throw new Error("cannot send on a closed v2 codec");
+    }
+    this.#socket.send(message);
+  }
+  sendBinary(frame) {
+    if (this.#closed) {
+      throw new Error("cannot send on a closed v2 codec");
+    }
+    this.#socket.send(frame);
+  }
+  call(method, params = []) {
+    const id = this.allocateRpcId();
+    const call = { t: "rpc.call", id, method, params };
+    const promise = new Promise((resolve, reject) => {
+      this.#pendingRpc.set(id, { resolve, reject });
+    });
+    this.sendText(JSON.stringify(call));
+    return promise;
+  }
+  respondOk(id, result) {
+    const reply = { t: "rpc.ok", id, result };
+    this.sendText(JSON.stringify(reply));
+  }
+  respondErr(id, error) {
+    const reply = { t: "rpc.err", id, error };
+    this.sendText(JSON.stringify(reply));
+  }
+  sendWireError(err) {
+    const frame = { t: "error", ...err };
+    this.sendText(JSON.stringify(frame));
+  }
+  openBodyReader(bid) {
+    return this.bodyReaders.getOrOpen(bid);
+  }
+  setRpcCallHandler(handler) {
+    this.#options = { ...this.#options, onRpcCall: handler };
+  }
+  close(code, reason) {
+    if (this.#closed)
+      return;
+    this.#closed = true;
+    this.#failPending(new Error("v2 transport closed"));
+    this.#socket.close(code, reason);
+  }
+  get isClosed() {
+    return this.#closed;
+  }
+  #onMessage(event) {
+    const { data } = event;
+    if (typeof data === "string") {
+      this.#onText(data);
+    } else if (data instanceof Uint8Array) {
+      this.#onBinary(data);
+    } else if (data instanceof ArrayBuffer) {
+      this.#onBinary(new Uint8Array(data));
+    }
+  }
+  #onText(data) {
+    let msg;
+    try {
+      msg = parseTransportV2ControlMsg(data);
+    } catch {
+      const rpc = tryParseRpcMsg(data);
+      if (rpc !== null) {
+        this.#onRpcMessage(rpc);
+        return;
+      }
+      const wireErr = tryParseWireError(data);
+      if (wireErr !== null) {
+        this.#options.onWireError?.(wireErr);
+        return;
+      }
+      this.#options.onUnknownControl?.(data);
+      return;
+    }
+    switch (msg.t) {
+      case "hello":
+        this.#onHello(msg);
+        break;
+      case "welcome":
+        this.#onWelcome(msg);
+        break;
+      case "body.open":
+        this.bodyReaders.getOrOpen(msg.bid);
+        break;
+      case "body.end":
+        this.bodyReaders.end(msg.bid);
+        break;
+      case "body.abort":
+        this.bodyReaders.abort(msg.bid, msg.error);
+        break;
+    }
+  }
+  #onBinary(data) {
+    let frame;
+    try {
+      frame = decodeTransportV2BinaryFrame(data);
+    } catch {
+      return;
+    }
+    if (frame.kind === TransportV2BinaryKind.BodyChunk) {
+      this.bodyReaders.pushChunk(frame);
+      return;
+    }
+    this.#options.onUnknownBinary?.(frame);
+  }
+  #onRpcMessage(msg) {
+    switch (msg.t) {
+      case "rpc.call":
+        this.#options.onRpcCall?.(msg);
+        break;
+      case "rpc.ok": {
+        const pending = this.#pendingRpc.get(msg.id);
+        if (pending !== undefined) {
+          this.#pendingRpc.delete(msg.id);
+          pending.resolve(msg.result);
+        }
+        break;
+      }
+      case "rpc.err": {
+        const pending = this.#pendingRpc.get(msg.id);
+        if (pending !== undefined) {
+          this.#pendingRpc.delete(msg.id);
+          const err = new Error(msg.error.message);
+          Object.assign(err, { code: msg.error.code, details: msg.error.details });
+          pending.reject(err);
+        }
+        break;
+      }
+    }
+  }
+  #onHello(msg) {
+    if (this.#receivedHello) {
+      this.close(TRANSPORT_V2_UNSUPPORTED_VERSION_CLOSE_CODE, "duplicate hello");
+      return;
+    }
+    this.#receivedHello = true;
+    const negotiated = negotiateTransportV2Capabilities(this.#capabilities, msg.capabilities);
+    const welcome = {
+      t: "welcome",
+      protocolVersion: TRANSPORT_V2_PROTOCOL_VERSION,
+      capabilities: negotiated
+    };
+    this.#socket.send(stringifyTransportV2ControlMsg(welcome));
+    this.#completeHandshake({ protocolVersion: TRANSPORT_V2_PROTOCOL_VERSION, capabilities: negotiated });
+  }
+  #onWelcome(msg) {
+    if (this.#receivedWelcome)
+      return;
+    this.#receivedWelcome = true;
+    this.#completeHandshake({
+      protocolVersion: TRANSPORT_V2_PROTOCOL_VERSION,
+      capabilities: msg.capabilities
+    });
+  }
+  #completeHandshake(result) {
+    if (this.#negotiated !== null)
+      return;
+    this.#negotiated = result;
+    this.#handshakeResolver?.resolve(result);
+    this.#handshakeResolver = null;
+  }
+  #onClose() {
+    if (this.#closed) {
+      return;
+    }
+    this.#closed = true;
+    this.#failPending(new Error("v2 transport closed"));
+  }
+  #onError(error) {
+    const wrapped = error instanceof Error ? error : new Error(String(error));
+    this.#failPending(wrapped);
+  }
+  #failPending(error) {
+    const resolver = this.#handshakeResolver;
+    if (resolver !== null) {
+      this.#handshakeResolver = null;
+      resolver.reject(error);
+    }
+    for (const pending of this.#pendingRpc.values()) {
+      pending.reject(error);
+    }
+    this.#pendingRpc.clear();
+  }
+}
+function tryParseRpcMsg(data) {
+  let parsed;
+  try {
+    parsed = JSON.parse(data);
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null || !("t" in parsed))
+    return null;
+  const t = parsed.t;
+  if (t === "rpc.call" || t === "rpc.ok" || t === "rpc.err") {
+    return parsed;
+  }
+  return null;
+}
+function tryParseWireError(data) {
+  let parsed;
+  try {
+    parsed = JSON.parse(data);
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null || !("t" in parsed))
+    return null;
+  const candidate = parsed;
+  if (candidate.t !== "error")
+    return null;
+  const scope = candidate.scope;
+  if (scope !== "transport" && scope !== "rpc" && scope !== "stream" && scope !== "ws")
+    return null;
+  const err = candidate.error;
+  if (!err || typeof err.code !== "string" || typeof err.message !== "string")
+    return null;
+  return parsed;
+}
+
+// src/bridge/log.ts
+var isDebugEnabled = () => {
+  try {
+    const env = globalThis.process?.env;
+    return Boolean(env?.DEVFLARE_DEBUG_BRIDGE);
+  } catch {
+    return false;
+  }
+};
+var bridgeLog = {
+  warn(message, error) {
+    if (!isDebugEnabled())
+      return;
+    console.warn(`[devflare:bridge] ${message}`, error);
+  },
+  debug(message, error) {
+    if (!isDebugEnabled())
+      return;
+    console.debug(`[devflare:bridge] ${message}`, error);
+  }
+};
+
+// src/bridge/client.ts
+class BridgeWsAdapter {
+  onmessage = null;
+  onclose = null;
+  onerror = null;
+  #ws;
+  constructor(ws) {
+    this.#ws = ws;
+  }
+  send(data) {
+    this.#ws.send(data);
+  }
+  close(code, reason) {
+    this.#ws.close(code, reason);
+  }
+}
+var BRIDGE_CLIENT_CAPABILITIES = ["streams", "ws-relay", "http-transfer"];
+var wsPackageConstructorPromise = null;
+async function importWsPackageConstructor() {
+  if (!wsPackageConstructorPromise) {
+    wsPackageConstructorPromise = (async () => {
+      const dynamicImport = new Function("specifier", ["return ", "import", "(specifier)"].join(""));
+      const wsModule = await dynamicImport("ws");
+      const defaultExport = wsModule.default;
+      const constructor = wsModule.WebSocket ?? (typeof defaultExport === "object" && defaultExport !== null ? defaultExport.WebSocket : undefined) ?? defaultExport;
+      if (typeof constructor !== "function") {
+        throw new Error("Could not load a WebSocket client implementation from the ws package");
+      }
+      return constructor;
+    })();
+  }
+  return wsPackageConstructorPromise;
+}
+function getRuntimeWebSocketConstructor(runtimeWebSocket = globalThis.WebSocket) {
+  if (typeof runtimeWebSocket === "function") {
+    return runtimeWebSocket;
+  }
+  return null;
+}
+class BridgeClient {
+  ws = null;
+  codec = null;
+  adapter = null;
+  url;
+  autoReconnect;
+  reconnectDelay;
+  connectTimeout;
+  activeStreams = new Map;
+  wsProxies = new Map;
+  pendingWsOpens = new Map;
+  outgoingStreams = new Map;
+  connectPromise = null;
+  isConnected = false;
+  constructor(options = {}) {
+    this.url = options.url ?? `ws://localhost:${DEFAULT_BRIDGE_PORT}`;
+    this.autoReconnect = options.autoReconnect ?? true;
+    this.reconnectDelay = options.reconnectDelay ?? 1000;
+    this.connectTimeout = options.connectTimeout ?? 5000;
+  }
+  getUrl() {
+    return this.url;
+  }
+  getHttpUrl() {
+    return this.url.replace(/^ws:\/\//, "http://").replace(/^wss:\/\//, "https://");
+  }
+  async connect() {
+    if (this.isConnected)
+      return;
+    if (this.connectPromise)
+      return this.connectPromise;
+    const WebSocketCtor = getRuntimeWebSocketConstructor();
+    const promise = WebSocketCtor ? this.openConnection(WebSocketCtor) : this.openConnectionWithPackageFallback();
+    this.connectPromise = promise;
+    promise.catch(() => {
+      if (this.connectPromise === promise) {
+        this.connectPromise = null;
+      }
+    });
+    return promise;
+  }
+  async openConnectionWithPackageFallback() {
+    const WebSocketCtor = await importWsPackageConstructor();
+    return this.openConnection(WebSocketCtor);
+  }
+  openConnection(WebSocketCtor) {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error(`Connection timeout: ${this.url}`));
+        this.ws?.close();
+      }, this.connectTimeout);
+      try {
+        this.ws = new WebSocketCtor(this.url);
+        this.ws.binaryType = "arraybuffer";
+        const adapter = new BridgeWsAdapter(this.ws);
+        this.adapter = adapter;
+        this.ws.onopen = () => {
+          clearTimeout(timeout);
+          this.codec = new TransportV2Codec(adapter, {
+            capabilities: [...BRIDGE_CLIENT_CAPABILITIES],
+            onUnknownControl: (data) => this.handleJsonMessage(data),
+            onUnknownBinary: (frame) => this.handleV2BinaryFrame(frame)
+          });
+          this.codec.sendHello();
+          this.codec.handshake.catch(() => {});
+          this.isConnected = true;
+          this.connectPromise = null;
+          resolve();
+        };
+        this.ws.onerror = (event) => {
+          clearTimeout(timeout);
+          this.connectPromise = null;
+          adapter.onerror?.({ error: event.error });
+          reject(new Error("WebSocket connection failed"));
+        };
+        this.ws.onclose = (event) => {
+          adapter.onclose?.({
+            code: event?.code ?? 1006,
+            reason: event?.reason ?? ""
+          });
+          this.handleDisconnect();
+        };
+        this.ws.onmessage = (event) => {
+          adapter.onmessage?.({ data: event.data });
+        };
+      } catch (error) {
+        clearTimeout(timeout);
+        this.connectPromise = null;
+        reject(error);
+      }
+    });
+  }
+  disconnect() {
+    this.autoReconnect = false;
+    this.codec?.close();
+    this.codec = null;
+    this.adapter = null;
+    this.ws?.close();
+    this.ws = null;
+    this.isConnected = false;
+    this.cleanupPending(new Error("Bridge disconnected"));
+  }
+  close() {
+    this.disconnect();
+  }
+  get connected() {
+    return this.isConnected;
+  }
+  handleDisconnect() {
+    this.isConnected = false;
+    this.codec?.close();
+    this.codec = null;
+    this.adapter = null;
+    this.ws = null;
+    this.cleanupPending(new Error("Bridge disconnected"));
+    if (this.autoReconnect) {
+      setTimeout(() => {
+        this.connect().catch((error) => {
+          bridgeLog.warn("auto-reconnect attempt failed", error);
+        });
+      }, this.reconnectDelay);
+    }
+  }
+  cleanupPending(error) {
+    for (const pending of this.pendingWsOpens.values()) {
+      pending.reject(error);
+    }
+    this.pendingWsOpens.clear();
+    for (const stream of this.activeStreams.values()) {
+      stream.closed = true;
+      if (stream.pendingPull) {
+        stream.pendingPull.reject(error);
+        stream.pendingPull = null;
+      }
+      try {
+        stream.controller.error(error);
+      } catch {}
+    }
+    this.activeStreams.clear();
+    for (const proxy of this.wsProxies.values()) {
+      try {
+        proxy.onClose(1006, error.message);
+      } catch {}
+    }
+    this.wsProxies.clear();
+    this.outgoingStreams.clear();
+  }
+  async call(method, params, timeoutMs = 30000) {
+    await this.ensureConnected();
+    const codec = this.codec;
+    if (!codec) {
+      throw new Error("Bridge disconnected");
+    }
+    const { value: serializedParams, streams } = await serializeValue(params);
+    for (const streamRef of streams) {
+      this.outgoingStreams.set(streamRef.sid, streamRef);
+    }
+    const callPromise = codec.call(method, serializedParams);
+    let timeoutHandle = null;
+    const timeoutPromise = new Promise((_, reject) => {
+      timeoutHandle = setTimeout(() => {
+        reject(new Error(`RPC timeout: ${method}`));
+      }, timeoutMs);
+    });
+    try {
+      const rawResult = await Promise.race([callPromise, timeoutPromise]);
+      return deserializeValue(rawResult, (sid) => this.createReadableStream(sid));
+    } catch (error) {
+      if (!this.isConnected && error instanceof Error && /v2 transport closed|transport/.test(error.message)) {
+        throw new Error("Bridge disconnected");
+      }
+      throw error;
+    } finally {
+      if (timeoutHandle !== null)
+        clearTimeout(timeoutHandle);
+    }
+  }
+  async createWsProxy(binding, id, url, headers) {
+    await this.ensureConnected();
+    const wid = nextWsId();
+    const proxy = {
+      clientWs: null,
+      onMessage: () => {},
+      onClose: () => {}
+    };
+    this.wsProxies.set(wid, proxy);
+    const openedPromise = new Promise((resolve, reject) => {
+      this.pendingWsOpens.set(wid, { resolve, reject });
+    });
+    const msg = {
+      t: "ws.open",
+      wid,
+      target: { binding, id, url, headers }
+    };
+    this.send(msg);
+    try {
+      await openedPromise;
+    } catch (error) {
+      this.wsProxies.delete(wid);
+      throw error;
+    }
+    return {
+      wid,
+      send: (data) => {
+        const payload = typeof data === "string" ? new TextEncoder().encode(data) : data;
+        const flags = typeof data === "string" ? BinaryFlags.TEXT : 0;
+        const frame = encodeBinaryFrame(BinaryKind.WsData, wid, 0, flags, payload);
+        this.sendBinary(frame);
+      },
+      close: (code, reason) => {
+        const closeMsg = { t: "ws.close", wid, code, reason };
+        this.send(closeMsg);
+        this.wsProxies.delete(wid);
+      },
+      onMessage: (handler) => {
+        proxy.onMessage = handler;
+      },
+      onClose: (handler) => {
+        proxy.onClose = handler;
+      }
+    };
+  }
+  createReadableStream(sid) {
+    return new ReadableStream({
+      start: (controller) => {
+        this.activeStreams.set(sid, {
+          controller,
+          buffer: [],
+          creditRemaining: 0,
+          pendingPull: null,
+          ended: false,
+          closed: false
+        });
+      },
+      pull: async (controller) => {
+        const stream = this.activeStreams.get(sid);
+        if (!stream || stream.closed)
+          return;
+        if (stream.buffer.length > 0) {
+          const chunk = stream.buffer.shift();
+          controller.enqueue(chunk);
+          return;
+        }
+        if (stream.ended) {
+          controller.close();
+          this.activeStreams.delete(sid);
+          return;
+        }
+        const pullMsg = {
+          t: "stream.pull",
+          sid,
+          creditBytes: DEFAULT_CHUNK_SIZE * 4
+        };
+        this.send(pullMsg);
+        await new Promise((resolve, reject) => {
+          stream.pendingPull = { resolve, reject };
+        });
+        stream.pendingPull = null;
+        if (stream.closed)
+          return;
+        if (stream.buffer.length > 0) {
+          const chunk = stream.buffer.shift();
+          controller.enqueue(chunk);
+          return;
+        }
+        if (stream.ended) {
+          controller.close();
+          this.activeStreams.delete(sid);
+        }
+      },
+      cancel: () => {
+        const stream = this.activeStreams.get(sid);
+        if (stream) {
+          stream.closed = true;
+          if (stream.pendingPull) {
+            stream.pendingPull.reject(new Error("Stream cancelled"));
+            stream.pendingPull = null;
+          }
+        }
+        this.activeStreams.delete(sid);
+      }
+    });
+  }
+  handleJsonMessage(data) {
+    try {
+      const msg = parseJsonMsg(data);
+      switch (msg.t) {
+        case "event":
+          this.handleEvent(msg);
+          break;
+        case "stream.pull":
+          this.handleStreamPull(msg);
+          break;
+        case "stream.end":
+          this.handleStreamEnd(msg);
+          break;
+        case "stream.abort":
+          this.handleStreamAbort(msg);
+          break;
+        case "ws.opened":
+          this.handleWsOpened(msg);
+          break;
+        case "ws.close":
+          this.handleWsClose(msg);
+          break;
+      }
+    } catch (error) {
+      console.error("[devflare bridge client] parse error:", data, error);
+    }
+  }
+  handleV2BinaryFrame(frame) {
+    switch (frame.kind) {
+      case BinaryKind.StreamChunk:
+        this.handleStreamChunk(frame);
+        break;
+      case BinaryKind.WsData:
+        this.handleWsData(frame);
+        break;
+    }
+  }
+  handleEvent(_msg) {}
+  handleStreamPull(msg) {
+    const streamRef = this.outgoingStreams.get(msg.sid);
+    if (!streamRef)
+      return;
+    this.pumpStream(streamRef, msg.creditBytes);
+  }
+  async pumpStream(streamRef, creditBytes) {
+    const reader = streamRef.stream.getReader();
+    let sent = 0;
+    let seq = 0;
+    try {
+      while (sent < creditBytes) {
+        const { done, value } = await reader.read();
+        if (done) {
+          this.send({ t: "stream.end", sid: streamRef.sid });
+          this.outgoingStreams.delete(streamRef.sid);
+          break;
+        }
+        if (value) {
+          const frame = encodeBinaryFrame(BinaryKind.StreamChunk, streamRef.sid, seq++, 0, value);
+          this.sendBinary(frame);
+          sent += value.byteLength;
+        }
+      }
+    } catch (error) {
+      this.send({
+        t: "stream.abort",
+        sid: streamRef.sid,
+        error: String(error)
+      });
+      this.outgoingStreams.delete(streamRef.sid);
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  handleStreamChunk(decoded) {
+    const stream = this.activeStreams.get(decoded.id);
+    if (!stream || stream.closed)
+      return;
+    stream.buffer.push(decoded.payload);
+    if (stream.pendingPull) {
+      const pending = stream.pendingPull;
+      stream.pendingPull = null;
+      pending.resolve();
+    }
+  }
+  handleStreamEnd(msg) {
+    const stream = this.activeStreams.get(msg.sid);
+    if (!stream)
+      return;
+    stream.ended = true;
+    if (stream.pendingPull) {
+      const pending = stream.pendingPull;
+      stream.pendingPull = null;
+      pending.resolve();
+    }
+  }
+  handleStreamAbort(msg) {
+    const stream = this.activeStreams.get(msg.sid);
+    if (!stream)
+      return;
+    const err = new Error(msg.error ?? "Stream aborted");
+    stream.closed = true;
+    if (stream.pendingPull) {
+      const pending = stream.pendingPull;
+      stream.pendingPull = null;
+      pending.reject(err);
+    }
+    try {
+      stream.controller.error(err);
+    } catch {}
+    this.activeStreams.delete(msg.sid);
+  }
+  handleWsData(decoded) {
+    const proxy = this.wsProxies.get(decoded.id);
+    if (!proxy)
+      return;
+    const isText = (decoded.flags & BinaryFlags.TEXT) !== 0;
+    const data = isText ? new TextDecoder().decode(decoded.payload) : decoded.payload;
+    proxy.onMessage(data);
+  }
+  handleWsClose(msg) {
+    const proxy = this.wsProxies.get(msg.wid);
+    if (!proxy)
+      return;
+    proxy.onClose(msg.code, msg.reason);
+    this.wsProxies.delete(msg.wid);
+  }
+  handleWsOpened(msg) {
+    const pending = this.pendingWsOpens.get(msg.wid);
+    if (!pending)
+      return;
+    this.pendingWsOpens.delete(msg.wid);
+    pending.resolve();
+  }
+  async ensureConnected() {
+    if (!this.isConnected) {
+      await this.connect();
+    }
+  }
+  send(msg) {
+    const codec = this.codec;
+    if (!codec || !this.isConnected) {
+      throw new Error("Not connected to bridge");
+    }
+    codec.sendText(stringifyJsonMsg(msg));
+  }
+  sendBinary(frame) {
+    const codec = this.codec;
+    if (!codec || !this.isConnected) {
+      throw new Error("Not connected to bridge");
+    }
+    codec.sendBinary(frame);
+  }
+}
+var defaultClient = null;
+function getClient(options) {
+  if (!defaultClient) {
+    defaultClient = new BridgeClient(options);
+  }
+  return defaultClient;
+}
+
+// src/bridge/proxy.ts
+function createKVProxy(client, bindingName) {
+  return {
+    async get(key, options) {
+      return client.call(`${bindingName}.kv.get`, [key, options]);
+    },
+    async put(key, value, options) {
+      await client.call(`${bindingName}.kv.put`, [key, value, options]);
+    },
+    async delete(key) {
+      await client.call(`${bindingName}.kv.delete`, [key]);
+    },
+    async list(options) {
+      return client.call(`${bindingName}.kv.list`, [options]);
+    },
+    async getWithMetadata(key, options) {
+      return client.call(`${bindingName}.kv.getWithMetadata`, [key, options]);
+    }
+  };
+}
+function createR2Proxy(client, bindingName) {
+  return {
+    async head(key) {
+      return client.call(`${bindingName}.r2.head`, [key]);
+    },
+    async get(key, options) {
+      return client.call(`${bindingName}.r2.get`, [key, options]);
+    },
+    async put(key, value, options) {
+      const size = getValueSize(value);
+      if (size > HTTP_TRANSFER_THRESHOLD) {
+        const transferId = `${bindingName}:${key}`;
+        const httpUrl = client.getHttpUrl();
+        const transferUrl = httpUrl.replace(/\/$/, "") + `/_devflare/transfer/${encodeURIComponent(transferId)}`;
+        const response = await fetch(transferUrl, {
+          method: "PUT",
+          body: value,
+          headers: {
+            ...options?.httpMetadata?.contentType ? { "Content-Type": options.httpMetadata.contentType } : {}
+          }
+        });
+        if (!response.ok) {
+          const error = await response.text();
+          throw new Error(`HTTP transfer failed: ${error}`);
+        }
+        const serialized = await response.json();
+        return deserializeValue(serialized);
+      }
+      return client.call(`${bindingName}.r2.put`, [key, value, options]);
+    },
+    async delete(keys) {
+      await client.call(`${bindingName}.r2.delete`, [keys]);
+    },
+    async list(options) {
+      return client.call(`${bindingName}.r2.list`, [options]);
+    },
+    async createMultipartUpload(key, options) {
+      return client.call(`${bindingName}.r2.createMultipartUpload`, [key, options]);
+    },
+    async resumeMultipartUpload(key, uploadId) {
+      return client.call(`${bindingName}.r2.resumeMultipartUpload`, [key, uploadId]);
+    }
+  };
+}
+function getValueSize(value) {
+  if (value instanceof Blob)
+    return value.size;
+  if (value instanceof ArrayBuffer)
+    return value.byteLength;
+  if (value instanceof Uint8Array)
+    return value.byteLength;
+  if (typeof value === "string")
+    return new TextEncoder().encode(value).byteLength;
+  if (value instanceof ReadableStream)
+    return Infinity;
+  return 0;
+}
+function createD1Proxy(client, bindingName) {
+  return {
+    prepare(sql) {
+      return createD1StatementProxy(client, bindingName, sql, []);
+    },
+    async batch(statements) {
+      const serialized = statements.map((stmt) => {
+        const s = stmt;
+        return { sql: s._sql, bindings: s._bindings };
+      });
+      return client.call(`${bindingName}.d1.batch`, [serialized]);
+    },
+    async exec(sql) {
+      return client.call(`${bindingName}.d1.exec`, [sql]);
+    },
+    async dump() {
+      return client.call(`${bindingName}.d1.dump`, []);
+    }
+  };
+}
+function createD1StatementProxy(client, bindingName, sql, bindings) {
+  const stmt = {
+    _sql: sql,
+    _bindings: bindings,
+    bind(...values) {
+      return createD1StatementProxy(client, bindingName, sql, values);
+    },
+    async first(column) {
+      return client.call(`${bindingName}.d1.stmt.first`, [sql, ...bindings, column]);
+    },
+    async all() {
+      return client.call(`${bindingName}.d1.stmt.all`, [sql, ...bindings]);
+    },
+    async run() {
+      return client.call(`${bindingName}.d1.stmt.run`, [sql, ...bindings]);
+    },
+    async raw(options) {
+      return client.call(`${bindingName}.d1.stmt.raw`, [sql, ...bindings, options]);
+    }
+  };
+  return stmt;
+}
+function createDOProxy(client, bindingName, proxyOptions = {}) {
+  return {
+    idFromName(name) {
+      return createDOIdProxy(client, bindingName, { type: "name", value: name });
+    },
+    idFromString(hexId) {
+      return createDOIdProxy(client, bindingName, { type: "hex", value: hexId });
+    },
+    newUniqueId(options) {
+      const tempId = crypto.randomUUID().replace(/-/g, "");
+      return createDOIdProxy(client, bindingName, { type: "unique", value: tempId, options });
+    },
+    get(id) {
+      const idProxy = id;
+      return createDOStubProxy(client, bindingName, idProxy._idInfo, proxyOptions);
+    },
+    getByName(name) {
+      const id = this.idFromName(name);
+      return this.get(id);
+    },
+    jurisdiction(jurisdiction) {
+      return createDOProxy(client, bindingName, proxyOptions);
+    }
+  };
+}
+function createDOIdProxy(client, bindingName, idInfo) {
+  return {
+    _idInfo: idInfo,
+    toString() {
+      if (idInfo.type === "hex")
+        return idInfo.value;
+      return `${idInfo.type}:${idInfo.value}`;
+    },
+    equals(other) {
+      return this.toString() === other.toString();
+    }
+  };
+}
+function createDOStubProxy(client, bindingName, idInfo, proxyOptions = {}) {
+  const { transformResult } = proxyOptions;
+  let resolvedId = null;
+  const resolveId = async () => {
+    if (resolvedId)
+      return resolvedId;
+    switch (idInfo.type) {
+      case "name":
+        resolvedId = await client.call(`${bindingName}.do.idFromName`, [idInfo.value]);
+        break;
+      case "hex":
+        resolvedId = { __type: "DOId", hex: idInfo.value };
+        break;
+      case "unique":
+        resolvedId = await client.call(`${bindingName}.do.newUniqueId`, [idInfo.options]);
+        break;
+    }
+    return resolvedId;
+  };
+  const stubBase = {
+    async fetch(input, init) {
+      const id = await resolveId();
+      const request = input instanceof Request ? input : new Request(input, init);
+      const { serialized } = await serializeRequest(request);
+      const result = await client.call(`${bindingName}.do.fetch`, [bindingName, id, serialized]);
+      return deserializeResponse(result);
+    },
+    async connect(url, options) {
+      const id = await resolveId();
+      const headersList = [];
+      if (options?.headers) {
+        const headers = new Headers(options.headers);
+        headers.forEach((value, key) => {
+          headersList.push([key, value]);
+        });
+      }
+      const wsProxy = await client.createWsProxy(bindingName, id.hex, url, headersList);
+      let readController = null;
+      const readable = new ReadableStream({
+        start(controller) {
+          readController = controller;
+        },
+        cancel() {
+          wsProxy.close();
+        }
+      });
+      wsProxy.onMessage((data) => {
+        if (readController) {
+          const chunk = typeof data === "string" ? new TextEncoder().encode(data) : data;
+          readController.enqueue(chunk);
+        }
+      });
+      wsProxy.onClose((code, reason) => {
+        if (readController) {
+          readController.close();
+        }
+      });
+      const writable = new WritableStream({
+        write(chunk) {
+          wsProxy.send(chunk);
+        },
+        close() {
+          wsProxy.close(1000, "Normal closure");
+        },
+        abort(reason) {
+          wsProxy.close(1001, reason?.toString() ?? "Aborted");
+        }
+      });
+      return {
+        readable,
+        writable,
+        get opened() {
+          return Promise.resolve({
+            remoteAddress: "127.0.0.1",
+            localAddress: "127.0.0.1"
+          });
+        },
+        get closed() {
+          return new Promise((resolve) => {
+            wsProxy.onClose(() => resolve());
+          });
+        },
+        close() {
+          wsProxy.close(1000, "Normal closure");
+          return Promise.resolve();
+        },
+        startTls() {
+          throw new Error("startTls not supported on DO WebSocket proxy");
+        }
+      };
+    },
+    get id() {
+      return createDOIdProxy(client, bindingName, idInfo);
+    },
+    get name() {
+      return idInfo.type === "name" ? idInfo.value : undefined;
+    }
+  };
+  return new Proxy(stubBase, {
+    get(target, prop) {
+      if (prop in target) {
+        return target[prop];
+      }
+      if (typeof prop === "symbol") {
+        return;
+      }
+      if (prop === "then" || prop === "catch" || prop === "finally") {
+        return;
+      }
+      return async (...args) => {
+        const id = await resolveId();
+        let result = await client.call(`${bindingName}.do.rpc`, [
+          bindingName,
+          id,
+          prop,
+          args
+        ]);
+        if (transformResult) {
+          result = transformResult(result);
+        }
+        return result;
+      };
+    }
+  });
+}
+var EMPTY_QUEUE_METRICS = {
+  backlogCount: 0,
+  backlogBytes: 0
+};
+function createQueueResponse() {
+  return { metadata: { metrics: EMPTY_QUEUE_METRICS } };
+}
+function createQueueProxy(client, bindingName) {
+  return {
+    async metrics() {
+      return EMPTY_QUEUE_METRICS;
+    },
+    async send(message, options) {
+      await client.call(`${bindingName}.queue.send`, [message, options]);
+      return createQueueResponse();
+    },
+    async sendBatch(messages, options) {
+      await client.call(`${bindingName}.queue.sendBatch`, [messages, options]);
+      return createQueueResponse();
+    }
+  };
+}
+function createAIProxy(client, bindingName) {
+  return {
+    async run(model, inputs, options) {
+      return client.call(`${bindingName}.ai.run`, [model, inputs, options]);
+    }
+  };
+}
+function createSendEmailProxy(client, bindingName) {
+  return {
+    async send(message) {
+      return client.call(`${bindingName}.email.send`, [message]);
+    }
+  };
+}
+function createWorkflowInstanceProxy(client, bindingName, id) {
+  return {
+    id,
+    async pause() {
+      await client.call(`${bindingName}.workflow.pause`, [id]);
+    },
+    async resume() {
+      await client.call(`${bindingName}.workflow.resume`, [id]);
+    },
+    async terminate() {
+      await client.call(`${bindingName}.workflow.terminate`, [id]);
+    },
+    async restart() {
+      await client.call(`${bindingName}.workflow.restart`, [id]);
+    },
+    async status() {
+      return client.call(`${bindingName}.workflow.status`, [id]);
+    },
+    async sendEvent(event) {
+      await client.call(`${bindingName}.workflow.sendEvent`, [id, event]);
+    }
+  };
+}
+function createWorkflowProxy(client, bindingName) {
+  const toInstance = (value) => {
+    const id = value?.id;
+    if (typeof id !== "string") {
+      throw new Error(`Workflow ${bindingName} returned an instance without a string id.`);
+    }
+    return createWorkflowInstanceProxy(client, bindingName, id);
+  };
+  return {
+    async create(options) {
+      return toInstance(await client.call(`${bindingName}.workflow.create`, [options]));
+    },
+    async get(id) {
+      return toInstance(await client.call(`${bindingName}.workflow.get`, [id]));
+    }
+  };
+}
+var globalBindingHints = {};
+function createEnvProxy(options = {}) {
+  const client = options.client ?? getClient();
+  const bindingProxies = new Map;
+  const doProxyOptions = { transformResult: options.transformResult };
+  const hints = { ...globalBindingHints, ...options.hints };
+  return new Proxy({}, {
+    get(target, prop) {
+      if (typeof prop !== "string")
+        return;
+      if (bindingProxies.has(prop)) {
+        return bindingProxies.get(prop);
+      }
+      const hint = hints[prop];
+      let proxy;
+      switch (hint) {
+        case "kv":
+          proxy = createKVProxy(client, prop);
+          break;
+        case "r2":
+          proxy = createR2Proxy(client, prop);
+          break;
+        case "d1":
+          proxy = createD1Proxy(client, prop);
+          break;
+        case "do":
+          proxy = createDOProxy(client, prop, doProxyOptions);
+          break;
+        case "queue":
+          proxy = createQueueProxy(client, prop);
+          break;
+        case "ai":
+          proxy = createAIProxy(client, prop);
+          break;
+        case "sendEmail":
+          proxy = createSendEmailProxy(client, prop);
+          break;
+        case "workflow":
+          proxy = createWorkflowProxy(client, prop);
+          break;
+        case "secret":
+        case "var":
+          proxy = createSimpleBindingProxy(client, prop);
+          break;
+        default:
+          proxy = createGenericBindingProxy(client, prop);
+      }
+      bindingProxies.set(prop, proxy);
+      return proxy;
+    },
+    has(target, prop) {
+      return typeof prop === "string";
+    },
+    ownKeys() {
+      return Object.keys(hints);
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      if (typeof prop === "string") {
+        return { configurable: true, enumerable: true, writable: false };
+      }
+      return;
+    }
+  });
+}
+function createGenericBindingProxy(client, bindingName) {
+  return new Proxy({}, {
+    get(target, prop) {
+      if (typeof prop !== "string")
+        return;
+      if (["get", "put", "delete", "list", "getWithMetadata"].includes(prop)) {
+        return createKVProxy(client, bindingName)[prop];
+      }
+      if (["idFromName", "idFromString", "newUniqueId", "get"].includes(prop)) {
+        return createDOProxy(client, bindingName)[prop];
+      }
+      if (["prepare", "batch", "exec", "dump"].includes(prop)) {
+        return createD1Proxy(client, bindingName)[prop];
+      }
+      if (["head"].includes(prop)) {
+        return createR2Proxy(client, bindingName)[prop];
+      }
+      return async (...args) => {
+        return client.call(`${bindingName}.${prop}`, args);
+      };
+    }
+  });
+}
+function createSimpleBindingProxy(client, bindingName) {
+  let cachedValue;
+  let fetched = false;
+  let pendingValue = null;
+  const loadValue = () => {
+    if (fetched) {
+      return Promise.resolve(cachedValue);
+    }
+    if (!pendingValue) {
+      pendingValue = client.call(`${bindingName}.var.value`, []).then((value) => {
+        cachedValue = value;
+        fetched = true;
+        return value;
+      }).catch((error) => {
+        pendingValue = null;
+        throw error;
+      });
+    }
+    return pendingValue;
+  };
+  return {
+    then(resolve, reject) {
+      return loadValue().then(resolve ?? undefined, reject ?? undefined);
+    },
+    toString() {
+      if (!fetched)
+        throw new Error(`Binding ${bindingName} not yet fetched. Use await.`);
+      return String(cachedValue);
+    }
+  };
+}
+var globalEnvProxy = null;
+var bridgeEnv = new Proxy({}, {
+  get(target, prop) {
+    if (!globalEnvProxy) {
+      globalEnvProxy = createEnvProxy({ lazy: true });
+    }
+    return globalEnvProxy[prop];
+  }
+});
+function initEnv(options = {}) {
+  globalEnvProxy = createEnvProxy(options);
+  return globalEnvProxy;
+}
+function setBindingHints(hints) {
+  globalBindingHints = { ...globalBindingHints, ...hints };
+  globalEnvProxy = null;
+}
+
+export { ContextAccessError, createContextProxy, createFetchEvent, createQueueEvent, createScheduledEvent, createEmailEvent, createTailEvent, createDurableObjectFetchEvent, createDurableObjectAlarmEvent, createDurableObjectWebSocketMessageEvent, createDurableObjectWebSocketCloseEvent, createDurableObjectWebSocketErrorEvent, runWithContext, runWithEventContext, getContext, getContextOrNull, getEventContext, getEventContextOrNull, hasContext, getFetchEvent, getQueueEvent, getScheduledEvent, getEmailEvent, getTailEvent, getDurableObjectEvent, getDurableObjectFetchEvent, getDurableObjectAlarmEvent, getDurableObjectWebSocketMessageEvent, getDurableObjectWebSocketCloseEvent, getDurableObjectWebSocketErrorEvent, ContextUnavailableError, BridgeClient, getClient, createEnvProxy, bridgeEnv, initEnv, setBindingHints };