@altertable/data-app 0.63.0 → 0.65.0

package/AGENTS.md

@@ -3,5 +3,8 @@
 Build Altertable data apps with `@altertable/data-app`. They render in an iframe
 in Altertable, a chat app, or locally in a browser.
 
+Every analytical app includes CSV export and a story in the built-in toolbar,
+both derived from the displayed result. Setup and static screens may omit them.
+
 Follow [app authoring](docs/app-authoring.md) for the shared workflow, the data app
 and local data app paths, and task-specific documentation.

package/CONTRIBUTING.md

@@ -30,6 +30,10 @@ Use `@/src/...` imports in repository source and `@altertable/data-app/<entry>`
 in consumer tests and examples. Run `bun run lint:fix` and `bun run format` for
 style fixes.
 
+Compose the gallery from provided components, including layouts. Let primitives
+own sizing, spacing, and responsive behavior. Report missing primitives and keep
+fallbacks minimal.
+
 ## Verify changes
 
 Tests should tell the package's public usage stories: define an operation,

package/README.md

@@ -21,7 +21,7 @@ bun add @altertable/data-app
 ## Build an app
 
 Apps render in an iframe in Altertable, a chat app, or locally in a browser.
-Follow [app authoring](docs/app-authoring.md) to explore data and present findings.
+Follow [app authoring](docs/app-authoring.md) to explore data, export displayed results as CSV, and present findings.
 
 | App                                | Start here                               |
 | ---------------------------------- | ---------------------------------------- |

package/dist/chunks/{contract-tkc552ze.js → contract-a061yj6r.js}

@@ -6,10 +6,10 @@ import {
   getDataAppTransport2,
   executeDataOperation,
   toDataOperationFailure
-} from "./contract-8wdybxj7.js";
+} from "./contract-sm7j7k95.js";
 import {
   PARENT_PARAM
-} from "./contract-cxr9t12b.js";
+} from "./contract-awa2d5b1.js";
 import {
   validLocation,
   MessageRoutingError2,

package/dist/chunks/contract-awa2d5b1.js

@@ -0,0 +1,272 @@
+// src/core/logger.ts
+function isLogEntry(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const entry = value;
+  return (entry.method === "log" || entry.method === "info" || entry.method === "warn" || entry.method === "error") && Array.isArray(entry.args) && entry.args.length <= 128;
+}
+
+// src/core/bridge.ts
+var BRIDGE = "altertable:data-app";
+var PARENT_PARAM = "__altertable_parent";
+var MAX_PENDING = 128;
+var REQUEST_TIMEOUT_MS = 60000;
+function validId(value) {
+  return typeof value === "string" && /^[a-zA-Z0-9_-]{1,128}$/.test(value);
+}
+function event({
+  wire,
+  from,
+  session,
+  parse
+}) {
+  return { wire, from, session, parse };
+}
+function id(fields) {
+  if (!validId(fields.id))
+    throw new Error("Invalid request ID.");
+  return fields.id;
+}
+function string(fields, key) {
+  const value = fields[key];
+  if (typeof value !== "string")
+    throw new Error(`Invalid ${key}.`);
+  return value;
+}
+function empty() {
+  return {};
+}
+var bridgeProtocol = {
+  channel: BRIDGE,
+  version: 1,
+  events: {
+    connect: event({
+      wire: "bridge:connect",
+      from: "host",
+      session: "none",
+      parse: empty
+    }),
+    ready: event({
+      wire: "bridge:ready",
+      from: "app",
+      session: "none",
+      parse: empty
+    }),
+    initialize: event({
+      wire: "bridge:initialize",
+      from: "host",
+      session: "establish",
+      parse: (fields) => ({ state: fields.state })
+    }),
+    request: event({
+      wire: "bridge:request",
+      from: "app",
+      session: "current",
+      parse: (fields) => {
+        const route = string(fields, "route");
+        if (!route || route.length > 256)
+          throw new Error("Invalid message route.");
+        return { id: id(fields), route, payload: fields.payload };
+      }
+    }),
+    result: event({
+      wire: "bridge:result",
+      from: "host",
+      session: "current",
+      parse: (fields) => {
+        if (!Object.hasOwn(fields, "response"))
+          throw new Error("Missing response.");
+        return { id: id(fields), response: fields.response };
+      }
+    }),
+    error: event({
+      wire: "bridge:error",
+      from: "host",
+      session: "current",
+      parse: (fields) => {
+        if (fields.requestId !== undefined && typeof fields.requestId !== "string")
+          throw new Error("Invalid requestId.");
+        return {
+          id: id(fields),
+          code: string(fields, "code"),
+          message: string(fields, "message"),
+          ...fields.requestId === undefined ? {} : { requestId: fields.requestId }
+        };
+      }
+    }),
+    cancel: event({
+      wire: "bridge:cancel",
+      from: "app",
+      session: "current",
+      parse: (fields) => ({ id: id(fields) })
+    }),
+    disconnect: event({
+      wire: "bridge:disconnect",
+      from: "app",
+      session: "current",
+      parse: empty
+    }),
+    scriptLoad: event({
+      wire: "script:load",
+      from: "host",
+      session: "current",
+      parse: (fields) => ({ javascript: string(fields, "javascript") })
+    }),
+    stateUpdate: event({
+      wire: "state:update",
+      from: "host",
+      session: "current",
+      parse: (fields) => ({ state: fields.state })
+    }),
+    runtimeLog: event({
+      wire: "runtime:log",
+      from: "app",
+      session: "current",
+      parse: (fields) => {
+        if (!isLogEntry(fields.payload))
+          throw new Error("Invalid log entry.");
+        return { payload: fields.payload };
+      }
+    }),
+    runtimeReady: event({
+      wire: "runtime:ready",
+      from: "app",
+      session: "current",
+      parse: empty
+    }),
+    runtimeError: event({
+      wire: "runtime:error",
+      from: "app",
+      session: "current",
+      parse: empty
+    })
+  }
+};
+var byWire = new Map;
+for (const name of Object.keys(bridgeProtocol.events)) {
+  const wire = bridgeProtocol.events[name].wire;
+  if (byWire.has(wire))
+    throw new Error(`Duplicate bridge event: ${wire}`);
+  byWire.set(wire, name);
+}
+function bridgeEventName(wire) {
+  return byWire.get(wire);
+}
+function parseBridgeEnvelope(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const fields = value;
+  if (fields.channel !== BRIDGE || fields.version !== bridgeProtocol.version || typeof fields.type !== "string" || typeof fields.documentId !== "string" || !fields.documentId || fields.documentId.length > 128 || fields.sessionId !== undefined && !validId(fields.sessionId) || fields.token !== undefined && typeof fields.token !== "string")
+    return;
+  return fields;
+}
+function parseBridgePayload(envelope, definition) {
+  try {
+    return {
+      channel: BRIDGE,
+      version: bridgeProtocol.version,
+      documentId: envelope.documentId,
+      ...envelope.sessionId === undefined ? {} : { sessionId: envelope.sessionId },
+      ...envelope.token === undefined ? {} : { token: envelope.token },
+      type: definition.wire,
+      ...definition.parse(envelope)
+    };
+  } catch {
+    return;
+  }
+}
+function parseBridgeMessage(value) {
+  const envelope = parseBridgeEnvelope(value);
+  if (!envelope)
+    return;
+  const name = bridgeEventName(envelope.type);
+  if (!name)
+    return;
+  const definition = bridgeProtocol.events[name];
+  if (definition.session !== "none" && envelope.sessionId === undefined)
+    return;
+  return parseBridgePayload(envelope, definition);
+}
+
+// src/core/bridge-endpoint.ts
+function createBridgeEndpoint({
+  role,
+  origin,
+  source,
+  opaque,
+  context,
+  post,
+  diagnostic,
+  invalidRequest,
+  handlers
+}) {
+  let disposed = false;
+  function send(name, payload) {
+    if (disposed)
+      throw new Error("The bridge endpoint has closed.");
+    const definition = bridgeProtocol.events[name];
+    const current = context();
+    const message = parseBridgeMessage({
+      ...payload,
+      channel: bridgeProtocol.channel,
+      version: bridgeProtocol.version,
+      type: definition.wire,
+      documentId: name === "connect" ? "host" : current.documentId,
+      sessionId: current.sessionId,
+      token: opaque ? current.token : undefined
+    });
+    if (!message || opaque && !validId(current.token))
+      throw new Error("The bridge is not ready to send this event.");
+    diagnostic?.("send", definition.wire);
+    if (disposed)
+      return;
+    post(message);
+  }
+  function receive(event) {
+    const peer = source();
+    if (disposed || !peer || event.origin !== origin || event.source !== peer)
+      return;
+    const envelope = parseBridgeEnvelope(event.data);
+    if (!envelope)
+      return;
+    const current = context();
+    const connecting = role === "app" && envelope.type === bridgeProtocol.events.connect.wire;
+    if (opaque && (connecting ? !validId(envelope.token) : !current.token || envelope.token !== current.token))
+      return;
+    const name = bridgeEventName(envelope.type);
+    if (!name)
+      return;
+    const definition = bridgeProtocol.events[name];
+    if (definition.from === role)
+      return;
+    if (definition.session === "establish") {
+      if (envelope.documentId !== current.documentId || envelope.sessionId === undefined)
+        return;
+    } else if (definition.session === "current") {
+      if (!current.sessionId || envelope.sessionId !== current.sessionId || envelope.documentId !== current.documentId)
+        return;
+    }
+    const message = parseBridgePayload(envelope, definition);
+    if (!message) {
+      if (role === "host" && name === "request" && validId(envelope.id))
+        invalidRequest?.(envelope.id);
+      return;
+    }
+    diagnostic?.("receive", definition.wire);
+    if (disposed)
+      return;
+    const handler = handlers[name];
+    handler(message);
+  }
+  return {
+    send,
+    receive,
+    dispose() {
+      disposed = true;
+    }
+  };
+}
+
+export { PARENT_PARAM, MAX_PENDING, REQUEST_TIMEOUT_MS, validId, createBridgeEndpoint };
+
+//# debugId=856B2CD0C55C1CE964756E2164756E21

package/dist/chunks/contract-awa2d5b1.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/core/logger.ts", "../src/core/bridge.ts", "../src/core/bridge-endpoint.ts"],
+  "sourcesContent": [
+    "/** Host-owned log sink; compatible with console and frontend createLogger(). */\nexport type DataAppLogger = {\n  log: (...args: unknown[]) => void;\n  info: (...args: unknown[]) => void;\n  warn: (...args: unknown[]) => void;\n  error: (...args: unknown[]) => void;\n};\n\nexport type LogEntry = {\n  method: keyof DataAppLogger;\n  args: unknown[];\n};\n\nexport function isLogEntry(value: unknown): value is LogEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as Record<string, unknown>;\n  return (\n    (entry.method === 'log' ||\n      entry.method === 'info' ||\n      entry.method === 'warn' ||\n      entry.method === 'error') &&\n    Array.isArray(entry.args) &&\n    entry.args.length <= 128\n  );\n}\n",
+    "import { isLogEntry } from '@/src/core/logger';\n\n/** Data app delivery protocol. IDs identify a document, a shell session, and an individual call. */\nexport const BRIDGE = 'altertable:data-app';\nexport const PARENT_PARAM = '__altertable_parent';\n/** Bound pending requests in the client and host independently.\n * The host enforces its own limit because frames can send messages directly. */\nexport const MAX_PENDING = 128;\nexport const REQUEST_TIMEOUT_MS = 60_000;\nexport type { TransportResponse } from '@/src/core/operation-types';\n\nexport function validId(value: unknown): value is string {\n  return typeof value === 'string' && /^[a-zA-Z0-9_-]{1,128}$/.test(value);\n}\n\ntype Fields = Record<string, unknown>;\nexport type BridgeRole = 'host' | 'app';\ntype SessionRule = 'none' | 'establish' | 'current';\n\nfunction event<\n  const Wire extends string,\n  const Role extends BridgeRole,\n  const Session extends SessionRule,\n  Payload,\n>({\n  wire,\n  from,\n  session,\n  parse,\n}: {\n  wire: Wire;\n  from: Role;\n  session: Session;\n  parse: (fields: Fields) => Payload;\n}) {\n  return { wire, from, session, parse };\n}\n\nfunction id(fields: Fields) {\n  if (!validId(fields.id)) throw new Error('Invalid request ID.');\n  return fields.id;\n}\n\nfunction string(fields: Fields, key: string) {\n  const value = fields[key];\n  if (typeof value !== 'string') throw new Error(`Invalid ${key}.`);\n  return value;\n}\n\nfunction empty() {\n  return {};\n}\n\n/** Parsers project known fields; opaque values are validated by their owning route or adapter. */\nexport const bridgeProtocol = {\n  channel: BRIDGE,\n  version: 1,\n  events: {\n    connect: event({\n      wire: 'bridge:connect',\n      from: 'host',\n      session: 'none',\n      parse: empty,\n    }),\n    ready: event({\n      wire: 'bridge:ready',\n      from: 'app',\n      session: 'none',\n      parse: empty,\n    }),\n    initialize: event({\n      wire: 'bridge:initialize',\n      from: 'host',\n      session: 'establish',\n      parse: fields => ({ state: fields.state }),\n    }),\n    request: event({\n      wire: 'bridge:request',\n      from: 'app',\n      session: 'current',\n      parse: fields => {\n        const route = string(fields, 'route');\n        if (!route || route.length > 256)\n          throw new Error('Invalid message route.');\n        return { id: id(fields), route, payload: fields.payload };\n      },\n    }),\n    result: event({\n      wire: 'bridge:result',\n      from: 'host',\n      session: 'current',\n      parse: fields => {\n        if (!Object.hasOwn(fields, 'response'))\n          throw new Error('Missing response.');\n        return { id: id(fields), response: fields.response };\n      },\n    }),\n    error: event({\n      wire: 'bridge:error',\n      from: 'host',\n      session: 'current',\n      parse: fields => {\n        if (\n          fields.requestId !== undefined &&\n          typeof fields.requestId !== 'string'\n        )\n          throw new Error('Invalid requestId.');\n        return {\n          id: id(fields),\n          code: string(fields, 'code'),\n          message: string(fields, 'message'),\n          ...(fields.requestId === undefined\n            ? {}\n            : { requestId: fields.requestId }),\n        };\n      },\n    }),\n    cancel: event({\n      wire: 'bridge:cancel',\n      from: 'app',\n      session: 'current',\n      parse: fields => ({ id: id(fields) }),\n    }),\n    disconnect: event({\n      wire: 'bridge:disconnect',\n      from: 'app',\n      session: 'current',\n      parse: empty,\n    }),\n    scriptLoad: event({\n      wire: 'script:load',\n      from: 'host',\n      session: 'current',\n      parse: fields => ({ javascript: string(fields, 'javascript') }),\n    }),\n    stateUpdate: event({\n      wire: 'state:update',\n      from: 'host',\n      session: 'current',\n      parse: fields => ({ state: fields.state }),\n    }),\n    runtimeLog: event({\n      wire: 'runtime:log',\n      from: 'app',\n      session: 'current',\n      parse: fields => {\n        if (!isLogEntry(fields.payload)) throw new Error('Invalid log entry.');\n        return { payload: fields.payload };\n      },\n    }),\n    runtimeReady: event({\n      wire: 'runtime:ready',\n      from: 'app',\n      session: 'current',\n      parse: empty,\n    }),\n    runtimeError: event({\n      wire: 'runtime:error',\n      from: 'app',\n      session: 'current',\n      parse: empty,\n    }),\n  },\n} as const;\n\ntype Events = typeof bridgeProtocol.events;\nexport type BridgeEventName = keyof Events;\nexport type BridgePayload<Name extends BridgeEventName> = ReturnType<\n  Events[Name]['parse']\n>;\nexport type BridgeEnvelope = {\n  channel: typeof BRIDGE;\n  version: typeof bridgeProtocol.version;\n  documentId: string;\n  sessionId?: string;\n  token?: string;\n};\nexport type BridgeEventMessage<Name extends BridgeEventName> =\n  Name extends BridgeEventName\n    ? BridgeEnvelope & {\n        type: Events[Name]['wire'];\n      } & (Events[Name]['session'] extends 'none'\n          ? {}\n          : { sessionId: string }) &\n        BridgePayload<Name>\n    : never;\nexport type BridgeMessage = {\n  [Name in BridgeEventName]: BridgeEventMessage<Name>;\n}[BridgeEventName];\nexport type BridgeEventsFrom<Role extends BridgeRole> = {\n  [Name in BridgeEventName]: Events[Name]['from'] extends Role ? Name : never;\n}[BridgeEventName];\nexport type BridgeHandlers<Role extends BridgeRole> = {\n  [Name in BridgeEventsFrom<Role extends 'host' ? 'app' : 'host'>]: (\n    message: BridgeEventMessage<Name>\n  ) => void;\n};\n\nconst byWire = new Map<string, BridgeEventName>();\nfor (const name of Object.keys(bridgeProtocol.events) as BridgeEventName[]) {\n  const wire = bridgeProtocol.events[name].wire;\n  if (byWire.has(wire)) throw new Error(`Duplicate bridge event: ${wire}`);\n  byWire.set(wire, name);\n}\n\nexport function bridgeEventName(wire: string) {\n  return byWire.get(wire);\n}\n\n/** Envelope parsing precedes authentication; event-specific fields remain untrusted. */\nexport function parseBridgeEnvelope(\n  value: unknown\n): (BridgeEnvelope & Fields & { type: string }) | undefined {\n  if (!value || typeof value !== 'object') return;\n  const fields = value as Fields;\n  if (\n    fields.channel !== BRIDGE ||\n    fields.version !== bridgeProtocol.version ||\n    typeof fields.type !== 'string' ||\n    typeof fields.documentId !== 'string' ||\n    !fields.documentId ||\n    fields.documentId.length > 128 ||\n    (fields.sessionId !== undefined && !validId(fields.sessionId)) ||\n    (fields.token !== undefined && typeof fields.token !== 'string')\n  )\n    return;\n  return fields as BridgeEnvelope & Fields & { type: string };\n}\n\n/** Project event fields after the caller has checked envelope eligibility. */\nexport function parseBridgePayload(\n  envelope: NonNullable<ReturnType<typeof parseBridgeEnvelope>>,\n  definition: Events[BridgeEventName]\n): BridgeMessage | undefined {\n  try {\n    return {\n      channel: BRIDGE,\n      version: bridgeProtocol.version,\n      documentId: envelope.documentId,\n      ...(envelope.sessionId === undefined\n        ? {}\n        : { sessionId: envelope.sessionId }),\n      ...(envelope.token === undefined ? {} : { token: envelope.token }),\n      type: definition.wire,\n      ...definition.parse(envelope),\n    } as BridgeMessage;\n  } catch {\n    return;\n  }\n}\n\nexport function parseBridgeMessage(value: unknown): BridgeMessage | undefined {\n  const envelope = parseBridgeEnvelope(value);\n  if (!envelope) return;\n  const name = bridgeEventName(envelope.type);\n  if (!name) return;\n  const definition = bridgeProtocol.events[name];\n  if (definition.session !== 'none' && envelope.sessionId === undefined) return;\n  return parseBridgePayload(envelope, definition);\n}\n",
+    "import {\n  bridgeProtocol,\n  bridgeEventName,\n  parseBridgeEnvelope,\n  parseBridgeMessage,\n  parseBridgePayload,\n  validId,\n  type BridgeMessage,\n  type BridgeRole,\n  type BridgeEventsFrom,\n  type BridgePayload,\n  type BridgeEnvelope,\n  type BridgeHandlers,\n} from '@/src/core/bridge';\n\ntype ConnectionContext = Pick<BridgeEnvelope, 'sessionId' | 'token'> & {\n  documentId?: string;\n};\n\n/** The connection owns IDs and token rotation; callers can only supply event payloads. */\nexport function createBridgeEndpoint<const Role extends BridgeRole>({\n  role,\n  origin,\n  source,\n  opaque,\n  context,\n  post,\n  diagnostic,\n  invalidRequest,\n  handlers,\n}: {\n  role: Role;\n  handlers: BridgeHandlers<NoInfer<Role>>;\n  origin: string;\n  source: () => MessageEventSource | null;\n  opaque: boolean;\n  context: () => ConnectionContext;\n  post: (message: BridgeMessage) => void;\n  diagnostic?: (\n    direction: 'send' | 'receive',\n    type: BridgeMessage['type']\n  ) => void;\n  invalidRequest?: (id: string) => void;\n}) {\n  let disposed = false;\n\n  function send<\n    Name extends BridgeEventsFrom<Role>,\n    const Payload extends BridgePayload<NoInfer<Name>>,\n  >(\n    name: Name,\n    payload: Payload &\n      Record<Exclude<keyof Payload, keyof BridgePayload<NoInfer<Name>>>, never>\n  ) {\n    if (disposed) throw new Error('The bridge endpoint has closed.');\n    const definition = bridgeProtocol.events[name];\n    const current = context();\n    const message = parseBridgeMessage({\n      ...payload,\n      channel: bridgeProtocol.channel,\n      version: bridgeProtocol.version,\n      type: definition.wire,\n      documentId: name === 'connect' ? 'host' : current.documentId,\n      sessionId: current.sessionId,\n      token: opaque ? current.token : undefined,\n    });\n    if (!message || (opaque && !validId(current.token)))\n      throw new Error('The bridge is not ready to send this event.');\n    diagnostic?.('send', definition.wire);\n    if (disposed) return;\n    post(message);\n  }\n\n  function receive(event: MessageEvent) {\n    const peer = source();\n    if (disposed || !peer || event.origin !== origin || event.source !== peer)\n      return;\n    const envelope = parseBridgeEnvelope(event.data);\n    if (!envelope) return;\n    const current = context();\n    // The app learns its opaque token from a trusted host connect message.\n    const connecting =\n      role === 'app' && envelope.type === bridgeProtocol.events.connect.wire;\n    if (\n      opaque &&\n      (connecting\n        ? !validId(envelope.token)\n        : !current.token || envelope.token !== current.token)\n    )\n      return;\n    const name = bridgeEventName(envelope.type);\n    if (!name) return;\n    const definition = bridgeProtocol.events[name];\n    if (definition.from === role) return;\n    if (definition.session === 'establish') {\n      if (\n        envelope.documentId !== current.documentId ||\n        envelope.sessionId === undefined\n      )\n        return;\n    } else if (definition.session === 'current') {\n      if (\n        !current.sessionId ||\n        envelope.sessionId !== current.sessionId ||\n        envelope.documentId !== current.documentId\n      )\n        return;\n    }\n    const message = parseBridgePayload(envelope, definition);\n    if (!message) {\n      if (role === 'host' && name === 'request' && validId(envelope.id))\n        invalidRequest?.(envelope.id);\n      return;\n    }\n    diagnostic?.('receive', definition.wire);\n    if (disposed) return;\n    // The catalog lookup correlates the key and parsed discriminated message.\n    const handler = (handlers as Record<string, (message: unknown) => void>)[\n      name\n    ]!;\n    handler(message);\n  }\n\n  return {\n    send,\n    receive,\n    dispose() {\n      disposed = true;\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "856B2CD0C55C1CE964756E2164756E21",
+  "names": []
+}

package/dist/chunks/{contract-zr3jd7mr.js → contract-g6hky7x6.js}

@@ -1,11 +1,10 @@
 import {
-  BRIDGE,
   PARENT_PARAM,
   MAX_PENDING,
   REQUEST_TIMEOUT_MS,
-  isBridgeMessage,
-  validId
-} from "./contract-cxr9t12b.js";
+  validId,
+  createBridgeEndpoint
+} from "./contract-awa2d5b1.js";
 import {
   MessageRoutingError2
 } from "./contract-tf8c3qpv.js";
@@ -16,6 +15,7 @@ function attachDataAppConnection({
   connection,
   javascript,
   presentation,
+  logger,
   onStatusChange,
   onDiagnostic,
   onMessage,
@@ -37,45 +37,100 @@ function attachDataAppConnection({
     return {
       search: host.location.search,
       hash: host.location.hash,
-      ...currentPresentation ? { presentation: currentPresentation } : {}
+      ...currentPresentation ? { presentation: currentPresentation } : {},
+      logging: logger !== undefined
     };
   }
+  function setLogger(value) {
+    if (disposed || value === logger)
+      return;
+    const wasEnabled = logger !== undefined;
+    logger = value;
+    if (wasEnabled !== (logger !== undefined))
+      publishState();
+  }
   function setPresentation(value) {
     if (disposed)
       return;
     if (value?.surface === currentPresentation?.surface && value?.theme === currentPresentation?.theme)
       return;
     currentPresentation = value && { ...value };
-    if (sessionId)
-      publishState();
+    publishState();
   }
   function cancelAll() {
     for (const controller of pending.values())
       controller.abort();
     pending.clear();
   }
-  function send(message) {
-    onDiagnostic?.({ direction: "send", type: message.type ?? "unknown" });
-    iframe.contentWindow?.postMessage({
-      channel: BRIDGE,
-      version: 1,
-      documentId,
-      sessionId,
-      ...connection.type === "opaque" ? { token } : {},
-      ...message
-    }, targetOrigin);
-  }
+  const endpoint = createBridgeEndpoint({
+    role: "host",
+    origin: frameOrigin,
+    source: () => iframe.contentWindow,
+    opaque: connection.type === "opaque",
+    context: () => ({ documentId, sessionId, token }),
+    post: (message) => iframe.contentWindow?.postMessage(message, targetOrigin),
+    diagnostic: (direction, type) => onDiagnostic?.({ direction, type }),
+    invalidRequest: (id) => {
+      if (pending.has(id))
+        return;
+      if (pending.size >= MAX_PENDING)
+        error(id, "bridge_busy", "Too many pending data requests.");
+      else
+        error(id, "invalid_message", "Invalid message route.");
+    },
+    handlers: {
+      ready(message) {
+        if (message.documentId !== documentId) {
+          cancelAll();
+          documentId = message.documentId;
+          sessionId = crypto.randomUUID();
+        }
+        onStatusChange?.("connected");
+        if (disposed)
+          return;
+        send("initialize", { state: hostState() });
+        if (disposed)
+          return;
+        if (javascript !== undefined)
+          send("scriptLoad", { javascript });
+      },
+      runtimeLog({ payload }) {
+        try {
+          logger?.[payload.method](...payload.args);
+        } catch {}
+      },
+      runtimeReady() {
+        onStatusChange?.("ready");
+      },
+      runtimeError() {
+        onStatusChange?.("failed");
+      },
+      request(message) {
+        request(message);
+      },
+      cancel(message) {
+        pending.get(message.id)?.abort();
+        pending.delete(message.id);
+      },
+      disconnect() {
+        cancelAll();
+        documentId = undefined;
+        sessionId = undefined;
+        onStatusChange?.("disconnected");
+      }
+    }
+  });
+  const send = endpoint.send;
+  const receive = endpoint.receive;
   function error(id, code, message, requestId) {
-    send({ type: "bridge:error", id, code, message, requestId });
+    send("error", { id, code, message, requestId });
   }
   async function request(message) {
     const id = message.id;
-    if (!validId(id) || pending.has(id))
+    if (pending.has(id))
       return;
     if (pending.size >= MAX_PENDING)
       return error(id, "bridge_busy", "Too many pending data requests.");
-    if (typeof message.route !== "string" || !message.route || message.route.length > 256)
-      return error(id, "invalid_message", "Invalid message route.");
     try {
       const body = JSON.stringify(message.payload);
       if (message.payload !== undefined && (typeof body !== "string" || body.length > 16384))
@@ -98,7 +153,7 @@ function attachDataAppConnection({
     try {
       const response = await onMessage({ route: message.route, payload: message.payload }, { signal: controller.signal });
       if (pending.get(id) === controller)
-        send({ type: "bridge:result", id, response });
+        send("result", { id, response });
     } catch (failure) {
       if (pending.get(id) === controller) {
         if (failure instanceof MessageRoutingError2)
@@ -112,51 +167,10 @@ function attachDataAppConnection({
         pending.delete(id);
     }
   }
-  function receive(event) {
-    if (event.origin !== frameOrigin || event.source !== iframe.contentWindow || !isBridgeMessage(event.data))
-      return;
-    const message = event.data;
-    if (connection.type === "opaque" && message.token !== token)
-      return;
-    onDiagnostic?.({ direction: "receive", type: message.type });
-    if (message.type === "bridge:ready") {
-      if (message.documentId !== documentId) {
-        cancelAll();
-        documentId = message.documentId;
-        sessionId = crypto.randomUUID();
-      }
-      onStatusChange?.("connected");
-      send({
-        type: "bridge:initialize",
-        state: hostState()
-      });
-      if (javascript !== undefined)
-        send({ type: "script:load", javascript });
-      return;
-    }
-    if (!sessionId || message.sessionId !== sessionId || message.documentId !== documentId)
-      return;
-    if (message.type === "runtime:ready")
-      onStatusChange?.("ready");
-    else if (message.type === "runtime:error")
-      onStatusChange?.("failed");
-    else if (message.type === "bridge:request")
-      request(message);
-    else if (message.type === "bridge:cancel" && validId(message.id)) {
-      pending.get(message.id)?.abort();
-      pending.delete(message.id);
-    } else if (message.type === "bridge:disconnect") {
-      cancelAll();
-      documentId = undefined;
-      sessionId = undefined;
-      onStatusChange?.("disconnected");
-    }
-  }
   function publishState() {
-    send({
-      type: "state:update",
-      state: hostState()
-    });
+    if (disposed || !sessionId)
+      return;
+    send("stateUpdate", { state: hostState() });
   }
   function load() {
     if (connection.type === "opaque")
@@ -165,10 +179,11 @@ function attachDataAppConnection({
     documentId = undefined;
     sessionId = undefined;
     onStatusChange?.("connecting");
-    send({ type: "bridge:connect", documentId: "host" });
+    send("connect", {});
   }
   function dispose() {
     disposed = true;
+    endpoint.dispose();
     cancelAll();
     iframe.removeEventListener("load", load);
     host.removeEventListener("message", receive);
@@ -181,8 +196,8 @@ function attachDataAppConnection({
   host.addEventListener("popstate", publishState);
   host.addEventListener("pagehide", cancelAll);
   onStatusChange?.("connecting");
-  send({ type: "bridge:connect", documentId: "host" });
-  return { dispose, setPresentation };
+  send("connect", {});
+  return { dispose, setPresentation, setLogger };
 }
 
 // src/embed/source.ts
@@ -190,6 +205,7 @@ function attachDataAppSource({
   iframe,
   source,
   presentation,
+  logger,
   onMessage,
   onStatusChange,
   onDiagnostic,
@@ -233,6 +249,7 @@ function attachDataAppSource({
     connection: opaque ? { type: "opaque", token: crypto.randomUUID() } : { type: "origin", origin: url.origin },
     javascript: opaque ? source.javascript : undefined,
     presentation,
+    logger,
     onMessage,
     onStatusChange: status,
     onDiagnostic,
@@ -248,7 +265,11 @@ function attachDataAppSource({
     iframe.removeEventListener("error", error);
     bridge.dispose();
   }
-  return { dispose, setPresentation: bridge.setPresentation };
+  return {
+    dispose,
+    setPresentation: bridge.setPresentation,
+    setLogger: bridge.setLogger
+  };
 }
 
 // src/embed/bridge.ts
@@ -258,4 +279,4 @@ function attachDataAppBridge2(options) {
 
 export { attachDataAppBridge2 };
 
-//# debugId=F23BB728E5A0F78664756E2164756E21
+//# debugId=5826F4790D0666BF64756E2164756E21