@altertable/data-app 0.59.1

package/dist/chunks/contract-mb5nfzwg.js

@@ -0,0 +1,375 @@
+import {
+  MessageRoutingError2,
+  defineDataQueryRoute2
+} from "./contract-jksbmt5q.js";
+import {
+  BRIDGE,
+  PARENT_PARAM,
+  MAX_PENDING,
+  REQUEST_TIMEOUT_MS,
+  isBridgeMessage,
+  validId
+} from "./contract-ryyf6dme.js";
+
+// src/client/transport.ts
+var errorBrand = Symbol.for("@altertable/data-app/DataAppError");
+
+class DataAppError2 extends Error {
+  code;
+  requestId;
+  [errorBrand] = true;
+  static [Symbol.hasInstance](value) {
+    return value instanceof Error && value[errorBrand] === true;
+  }
+  constructor(message, code, requestId) {
+    super(message);
+    this.code = code;
+    this.requestId = requestId;
+    this.name = "DataAppError";
+  }
+}
+function createHttpTransport2({
+  endpoint = "/api/data",
+  fetch: request = globalThis.fetch
+} = {}) {
+  async function requestData(operation, input, signal) {
+    const response = await request(`${endpoint.replace(/\/$/, "")}/${encodeURIComponent(operation)}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(input),
+      signal
+    });
+    try {
+      return { status: response.status, body: await response.json() };
+    } catch (error) {
+      if (signal?.aborted)
+        throw error;
+      throw new DataAppError2(response.ok ? "The data response was invalid." : "Could not load data.", response.ok ? "invalid_response" : "request_failed");
+    }
+  }
+  return requestData;
+}
+
+// src/client/messages.ts
+function createMessageClient2(routes, transport) {
+  return {
+    async request(route, payload, { signal } = {}) {
+      signal?.throwIfAborted();
+      if (!Object.hasOwn(routes, route))
+        throw new MessageRoutingError2("unknown_route", "Unknown message route.");
+      const contract = routes[route];
+      let input;
+      try {
+        input = contract.input(payload);
+      } catch {
+        throw new MessageRoutingError2("invalid_payload", "Invalid message payload.");
+      }
+      const response = await transport({ route, payload: input }, signal);
+      signal?.throwIfAborted();
+      try {
+        return contract.output(response, input);
+      } catch (error) {
+        if (error instanceof MessageRoutingError2)
+          throw error;
+        throw new MessageRoutingError2("invalid_response", "Invalid message response.");
+      }
+    }
+  };
+}
+
+// src/client/iframe.ts
+function createIframeTransport2({
+  parentOrigin,
+  window: frame = window,
+  timeoutMs = REQUEST_TIMEOUT_MS,
+  mode = "url",
+  loadScript
+}) {
+  if (new URL(parentOrigin).origin !== parentOrigin)
+    throw new Error("Expected an exact parent origin.");
+  const documentId = crypto.randomUUID();
+  let token;
+  let sessionId;
+  let disposed = false;
+  const pending = new Map;
+  let hostState;
+  const stateListeners = new Set;
+  function send(message) {
+    frame.parent.postMessage({ channel: BRIDGE, version: 1, documentId, sessionId, token, ...message }, parentOrigin);
+  }
+  function receiveState(state) {
+    hostState = state;
+    for (const listener of stateListeners)
+      listener(state);
+  }
+  function receive(event) {
+    if (event.origin !== parentOrigin || event.source !== frame.parent || !isBridgeMessage(event.data))
+      return;
+    const message = event.data;
+    if (message.type === "connect") {
+      if (mode === "bundle") {
+        if (!validId(message.token))
+          return;
+        token = message.token;
+      }
+      send({ type: "ready" });
+      return;
+    }
+    if (mode === "bundle" && (!token || message.token !== token))
+      return;
+    if (message.documentId !== documentId)
+      return;
+    if (message.type === "initialize" && validId(message.sessionId)) {
+      if (sessionId && sessionId !== message.sessionId) {
+        for (const entry of pending.values())
+          entry.reject(new DataAppError2("The preview reconnected. Retry the request.", "bridge_reset"));
+      }
+      const first = !sessionId;
+      sessionId = message.sessionId;
+      if (first)
+        for (const entry of pending.values())
+          entry.start();
+      receiveState(message.state);
+      if (mode === "url")
+        send({ type: "runtime.ready" });
+      return;
+    }
+    if (!sessionId || message.sessionId !== sessionId)
+      return;
+    if (message.type === "state") {
+      receiveState(message.state);
+      return;
+    }
+    if (message.type === "script.load" && mode === "bundle" && typeof message.javascript === "string") {
+      loadScript?.(message.javascript);
+      return;
+    }
+    if (typeof message.id !== "string")
+      return;
+    const entry = pending.get(message.id);
+    if (!entry)
+      return;
+    if (message.type === "result" && "response" in message) {
+      entry.resolve(message.response);
+    } else if (message.type === "error" && typeof message.code === "string" && typeof message.message === "string") {
+      entry.reject(new MessageRoutingError2(message.code, message.message, typeof message.requestId === "string" ? message.requestId : undefined));
+    }
+  }
+  frame.addEventListener("message", receive);
+  function requestMessage(message, signal) {
+    return new Promise((resolve, reject) => {
+      if (disposed)
+        return reject(new DataAppError2("The preview has closed.", "bridge_closed"));
+      if (signal?.aborted)
+        return reject(signal.reason);
+      if (pending.size >= MAX_PENDING)
+        return reject(new DataAppError2("Too many pending data requests.", "bridge_busy"));
+      const id = crypto.randomUUID();
+      let sent = false;
+      function cleanup() {
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", abort);
+        pending.delete(id);
+      }
+      function abort() {
+        if (sent)
+          send({ type: "cancel", id });
+        cleanup();
+        reject(signal?.reason);
+      }
+      const timer = setTimeout(() => {
+        if (sent)
+          send({ type: "cancel", id });
+        cleanup();
+        reject(new DataAppError2(sessionId ? "The data request timed out." : "The preview shell is unavailable. Reload the preview.", sessionId ? "timeout" : "bridge_unavailable"));
+      }, timeoutMs);
+      const entry = {
+        start() {
+          if (sent)
+            return;
+          try {
+            send({
+              type: "request",
+              id,
+              route: message.route,
+              payload: message.payload
+            });
+            sent = true;
+          } catch {
+            cleanup();
+            reject(new DataAppError2("The message payload could not be sent.", "invalid_payload"));
+          }
+        },
+        resolve(value) {
+          cleanup();
+          resolve(value);
+        },
+        reject(error) {
+          cleanup();
+          reject(error);
+        }
+      };
+      pending.set(id, entry);
+      signal?.addEventListener("abort", abort, { once: true });
+      if (sessionId)
+        entry.start();
+      else
+        send({ type: "ready" });
+    });
+  }
+  const messages = createMessageClient2({ "data.query": defineDataQueryRoute2() }, requestMessage);
+  async function queryData(operation, input, signal) {
+    try {
+      return await messages.request("data.query", { operation, input }, { signal });
+    } catch (error) {
+      if (error instanceof MessageRoutingError2)
+        throw new DataAppError2(error.message, error.code, error.requestId);
+      throw error;
+    }
+  }
+  function disconnect() {
+    send({ type: "disconnect" });
+    sessionId = undefined;
+    for (const entry of pending.values())
+      entry.reject(new DataAppError2("The preview has closed.", "bridge_closed"));
+  }
+  function resume(event) {
+    if (event.persisted)
+      send({ type: "ready" });
+  }
+  function dispose() {
+    if (disposed)
+      return;
+    disconnect();
+    disposed = true;
+    frame.removeEventListener("message", receive);
+    frame.removeEventListener("pagehide", disconnect);
+    frame.removeEventListener("pageshow", resume);
+    stateListeners.clear();
+  }
+  frame.addEventListener("pagehide", disconnect);
+  frame.addEventListener("pageshow", resume);
+  if (mode === "url")
+    send({ type: "ready" });
+  return {
+    request: requestMessage,
+    transport: queryData,
+    dispose,
+    mode,
+    snapshot() {
+      return hostState;
+    },
+    subscribe(listener) {
+      stateListeners.add(listener);
+      return () => {
+        stateListeners.delete(listener);
+      };
+    },
+    ready() {
+      send({ type: "runtime.ready" });
+    },
+    fail() {
+      send({ type: "runtime.error" });
+    }
+  };
+}
+var bridgeKey = Symbol.for("altertable.localFrameBridge");
+var installedKey = Symbol.for("altertable.installedTransport");
+function localFrameBridge(window2) {
+  const activeWindow = window2 ?? (typeof globalThis.window === "undefined" ? undefined : globalThis.window);
+  if (!activeWindow)
+    return;
+  const frame = activeWindow;
+  if (frame[bridgeKey])
+    return frame[bridgeKey];
+  const parentOrigin = new URL(frame.location.href).searchParams.get(PARENT_PARAM) ?? "";
+  if (!parentOrigin)
+    return;
+  async function connect(parentOrigin) {
+    try {
+      const response = await frame.fetch("/__altertable/parent", {
+        signal: AbortSignal.timeout(5000)
+      });
+      const config = await response.json();
+      if (!response.ok || config.origin !== parentOrigin || frame.parent === frame)
+        throw new Error("Invalid local parent configuration.");
+      if (frame[installedKey])
+        return frame[installedKey];
+      if (frame[bridgeKey] !== proxy)
+        throw new Error("Preview transport owner changed.");
+      const bridge = createIframeTransport2({ parentOrigin, window: frame });
+      frame[bridgeKey] = bridge;
+      frame[installedKey] = bridge;
+      return bridge;
+    } catch {
+      throw new DataAppError2("The preview shell could not be verified. Open the URL printed by altertable app dev.", "bridge_unavailable");
+    }
+  }
+  let connection;
+  function getConnection() {
+    const installed = frame[installedKey];
+    if (installed)
+      return Promise.resolve(installed);
+    if (!connection) {
+      const attempt = connect(parentOrigin);
+      connection = attempt;
+      attempt.catch(() => {
+        if (connection === attempt)
+          connection = undefined;
+      });
+    }
+    return connection;
+  }
+  const proxy = {
+    async transport(operation, input, signal) {
+      signal?.throwIfAborted();
+      const attempt = getConnection();
+      let abort;
+      try {
+        const bridge = signal ? await Promise.race([
+          attempt,
+          new Promise((_, reject) => {
+            const requestSignal = signal;
+            function handleAbort() {
+              reject(requestSignal.reason);
+            }
+            abort = handleAbort;
+            requestSignal.addEventListener("abort", handleAbort, {
+              once: true
+            });
+          })
+        ]) : await attempt;
+        signal?.throwIfAborted();
+        return bridge.transport(operation, input, signal);
+      } finally {
+        if (abort)
+          signal?.removeEventListener("abort", abort);
+      }
+    },
+    connect: getConnection
+  };
+  frame[bridgeKey] = proxy;
+  getConnection().catch(() => {});
+  return proxy;
+}
+function installDataAppTransport2(bridge, frame = window) {
+  const target = frame;
+  if (target[installedKey])
+    throw new Error("A data app transport is already installed.");
+  target[bridgeKey] = bridge;
+  target[installedKey] = bridge;
+  return () => {
+    if (target[bridgeKey] === bridge)
+      delete target[bridgeKey];
+    if (target[installedKey] === bridge)
+      delete target[installedKey];
+    bridge.dispose();
+  };
+}
+function getDataAppTransport2(frame = window) {
+  return frame[installedKey];
+}
+
+export { DataAppError2, createHttpTransport2, createMessageClient2, createIframeTransport2, localFrameBridge, installDataAppTransport2, getDataAppTransport2 };
+
+//# debugId=CBF217D545192BD464756E2164756E21

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

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/client/transport.ts", "../src/client/messages.ts", "../src/client/iframe.ts"],
+  "sourcesContent": [
+    "import type { TransportResponse } from '@/src/core/bridge';\n\nexport type DataTransport = (\n  operation: string,\n  input: unknown,\n  signal?: AbortSignal\n) => Promise<TransportResponse>;\n\n// A bootstrap and its app may bundle independent copies in the same window.\nconst errorBrand = Symbol.for('@altertable/data-app/DataAppError');\n\nexport class DataAppError extends Error {\n  readonly [errorBrand] = true;\n\n  static [Symbol.hasInstance](value: unknown): boolean {\n    return (\n      value instanceof Error &&\n      (value as { [errorBrand]?: unknown })[errorBrand] === true\n    );\n  }\n\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly requestId?: string\n  ) {\n    super(message);\n    this.name = 'DataAppError';\n  }\n}\n\nexport function createHttpTransport({\n  endpoint = '/api/data',\n  fetch: request = globalThis.fetch,\n}: {\n  endpoint?: string;\n  fetch?: typeof fetch;\n} = {}): DataTransport {\n  async function requestData(\n    operation: string,\n    input: unknown,\n    signal?: AbortSignal\n  ): Promise<TransportResponse> {\n    const response = await request(\n      `${endpoint.replace(/\\/$/, '')}/${encodeURIComponent(operation)}`,\n      {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify(input),\n        signal,\n      }\n    );\n    try {\n      return { status: response.status, body: await response.json() };\n    } catch (error) {\n      if (signal?.aborted) throw error;\n      throw new DataAppError(\n        response.ok ? 'The data response was invalid.' : 'Could not load data.',\n        response.ok ? 'invalid_response' : 'request_failed'\n      );\n    }\n  }\n\n  return requestData;\n}\n",
+    "import {\n  MessageRoutingError,\n  type MessageInput,\n  type MessageOutput,\n  type MessageRoutes,\n  type MessageTransport,\n} from '@/src/core/messages';\n\n/** Both ends validate using the same contracts; the transport owns delivery and cancellation. */\nexport function createMessageClient<const Routes extends MessageRoutes>(\n  routes: Routes,\n  transport: MessageTransport\n) {\n  return {\n    async request<\n      Name extends keyof Routes & string,\n      const Input extends MessageInput<NoInfer<Routes[Name]>>,\n    >(\n      route: Name,\n      payload: Input,\n      { signal }: { signal?: AbortSignal } = {}\n    ): Promise<MessageOutput<Routes[Name], Input>> {\n      signal?.throwIfAborted();\n      if (!Object.hasOwn(routes, route))\n        throw new MessageRoutingError(\n          'unknown_route',\n          'Unknown message route.'\n        );\n      const contract = routes[route]!;\n      let input: unknown;\n      try {\n        input = contract.input(payload);\n      } catch {\n        throw new MessageRoutingError(\n          'invalid_payload',\n          'Invalid message payload.'\n        );\n      }\n      const response = await transport({ route, payload: input }, signal);\n      signal?.throwIfAborted();\n      try {\n        return contract.output(response, input as never) as MessageOutput<\n          Routes[Name],\n          Input\n        >;\n      } catch (error) {\n        if (error instanceof MessageRoutingError) throw error;\n        throw new MessageRoutingError(\n          'invalid_response',\n          'Invalid message response.'\n        );\n      }\n    },\n  };\n}\n",
+    "import {\n  BRIDGE,\n  PARENT_PARAM,\n  MAX_PENDING,\n  REQUEST_TIMEOUT_MS,\n  isBridgeMessage,\n  validId,\n  type BridgeMessage,\n  type TransportResponse,\n} from '@/src/core/bridge';\nimport {\n  defineDataQueryRoute,\n  MessageRoutingError,\n  type RoutedMessage,\n} from '@/src/core/messages';\nimport { createMessageClient } from '@/src/client/messages';\nimport { DataAppError } from '@/src/client/transport';\n\ntype Pending = {\n  start: () => void;\n  reject: (error: unknown) => void;\n  resolve: (value: unknown) => void;\n};\n\n/** One bridge per document, shared by all clients and retained across module hot replacement. */\nexport function createIframeTransport({\n  parentOrigin,\n  window: frame = window,\n  timeoutMs = REQUEST_TIMEOUT_MS,\n  mode = 'url',\n  loadScript,\n}: {\n  parentOrigin: string;\n  window?: Window;\n  timeoutMs?: number;\n  mode?: 'url' | 'bundle';\n  loadScript?: (javascript: string) => void;\n}) {\n  if (new URL(parentOrigin).origin !== parentOrigin)\n    throw new Error('Expected an exact parent origin.');\n  const documentId = crypto.randomUUID();\n  let token: string | undefined;\n  let sessionId: string | undefined;\n  let disposed = false;\n  const pending = new Map<string, Pending>();\n  let hostState: unknown;\n  const stateListeners = new Set<(state: unknown) => void>();\n\n  function send(message: Partial<BridgeMessage>) {\n    frame.parent.postMessage(\n      { channel: BRIDGE, version: 1, documentId, sessionId, token, ...message },\n      parentOrigin\n    );\n  }\n\n  function receiveState(state: unknown) {\n    hostState = state;\n    for (const listener of stateListeners) listener(state);\n  }\n\n  function receive(event: MessageEvent) {\n    if (\n      event.origin !== parentOrigin ||\n      event.source !== frame.parent ||\n      !isBridgeMessage(event.data)\n    )\n      return;\n    const message = event.data;\n    if (message.type === 'connect') {\n      if (mode === 'bundle') {\n        if (!validId(message.token)) return;\n        token = message.token;\n      }\n      send({ type: 'ready' });\n\n      return;\n    }\n    if (mode === 'bundle' && (!token || message.token !== token)) return;\n    if (message.documentId !== documentId) return;\n    if (message.type === 'initialize' && validId(message.sessionId)) {\n      if (sessionId && sessionId !== message.sessionId) {\n        for (const entry of pending.values())\n          entry.reject(\n            new DataAppError(\n              'The preview reconnected. Retry the request.',\n              'bridge_reset'\n            )\n          );\n      }\n      const first = !sessionId;\n      sessionId = message.sessionId;\n      if (first) for (const entry of pending.values()) entry.start();\n      receiveState(message.state);\n      if (mode === 'url') send({ type: 'runtime.ready' });\n\n      return;\n    }\n    if (!sessionId || message.sessionId !== sessionId) return;\n    if (message.type === 'state') {\n      receiveState(message.state);\n\n      return;\n    }\n    if (\n      message.type === 'script.load' &&\n      mode === 'bundle' &&\n      typeof message.javascript === 'string'\n    ) {\n      loadScript?.(message.javascript);\n\n      return;\n    }\n    if (typeof message.id !== 'string') return;\n    const entry = pending.get(message.id);\n    if (!entry) return;\n    if (message.type === 'result' && 'response' in message) {\n      entry.resolve(message.response);\n    } else if (\n      message.type === 'error' &&\n      typeof message.code === 'string' &&\n      typeof message.message === 'string'\n    ) {\n      entry.reject(\n        new MessageRoutingError(\n          message.code,\n          message.message,\n          typeof message.requestId === 'string' ? message.requestId : undefined\n        )\n      );\n    }\n  }\n\n  frame.addEventListener('message', receive);\n\n  function requestMessage(\n    message: RoutedMessage,\n    signal?: AbortSignal\n  ): Promise<unknown> {\n    return new Promise((resolve, reject) => {\n      if (disposed)\n        return reject(\n          new DataAppError('The preview has closed.', 'bridge_closed')\n        );\n      if (signal?.aborted) return reject(signal.reason);\n      if (pending.size >= MAX_PENDING)\n        return reject(\n          new DataAppError('Too many pending data requests.', 'bridge_busy')\n        );\n      const id = crypto.randomUUID();\n      let sent = false;\n\n      function cleanup() {\n        clearTimeout(timer);\n        signal?.removeEventListener('abort', abort);\n        pending.delete(id);\n      }\n\n      function abort() {\n        if (sent) send({ type: 'cancel', id });\n        cleanup();\n        reject(signal?.reason);\n      }\n\n      const timer = setTimeout(() => {\n        if (sent) send({ type: 'cancel', id });\n        cleanup();\n        reject(\n          new DataAppError(\n            sessionId\n              ? 'The data request timed out.'\n              : 'The preview shell is unavailable. Reload the preview.',\n            sessionId ? 'timeout' : 'bridge_unavailable'\n          )\n        );\n      }, timeoutMs);\n      const entry: Pending = {\n        start() {\n          if (sent) return;\n          try {\n            send({\n              type: 'request',\n              id,\n              route: message.route,\n              payload: message.payload,\n            });\n            sent = true;\n          } catch {\n            cleanup();\n            reject(\n              new DataAppError(\n                'The message payload could not be sent.',\n                'invalid_payload'\n              )\n            );\n          }\n        },\n        resolve(value) {\n          cleanup();\n          resolve(value);\n        },\n        reject(error) {\n          cleanup();\n          reject(error);\n        },\n      };\n      pending.set(id, entry);\n      signal?.addEventListener('abort', abort, { once: true });\n      if (sessionId) entry.start();\n      else send({ type: 'ready' });\n    });\n  }\n\n  const messages = createMessageClient(\n    { 'data.query': defineDataQueryRoute() },\n    requestMessage\n  );\n\n  async function queryData(\n    operation: string,\n    input: unknown,\n    signal?: AbortSignal\n  ): Promise<TransportResponse> {\n    try {\n      return await messages.request(\n        'data.query',\n        { operation, input },\n        { signal }\n      );\n    } catch (error) {\n      if (error instanceof MessageRoutingError)\n        throw new DataAppError(error.message, error.code, error.requestId);\n      throw error;\n    }\n  }\n\n  function disconnect() {\n    send({ type: 'disconnect' });\n    sessionId = undefined;\n    for (const entry of pending.values())\n      entry.reject(\n        new DataAppError('The preview has closed.', 'bridge_closed')\n      );\n  }\n\n  function resume(event: PageTransitionEvent) {\n    if (event.persisted) send({ type: 'ready' });\n  }\n\n  function dispose() {\n    if (disposed) return;\n    disconnect();\n    disposed = true;\n    frame.removeEventListener('message', receive);\n    frame.removeEventListener('pagehide', disconnect);\n    frame.removeEventListener('pageshow', resume);\n    stateListeners.clear();\n  }\n\n  frame.addEventListener('pagehide', disconnect);\n  frame.addEventListener('pageshow', resume);\n  if (mode === 'url') send({ type: 'ready' });\n\n  return {\n    request: requestMessage,\n    transport: queryData,\n    dispose,\n    mode,\n    snapshot() {\n      return hostState;\n    },\n    subscribe(listener: (state: unknown) => void) {\n      stateListeners.add(listener);\n\n      return () => {\n        stateListeners.delete(listener);\n      };\n    },\n    ready() {\n      send({ type: 'runtime.ready' });\n    },\n    fail() {\n      send({ type: 'runtime.error' });\n    },\n  };\n}\n\nexport type IframeTransport = ReturnType<typeof createIframeTransport>;\n\nconst bridgeKey = Symbol.for('altertable.localFrameBridge');\nconst installedKey = Symbol.for('altertable.installedTransport');\ntype LocalBridge = Pick<\n  ReturnType<typeof createIframeTransport>,\n  'transport'\n> & { connect?: () => Promise<ReturnType<typeof createIframeTransport>> };\ntype FrameWindow = Window & {\n  [bridgeKey]?: LocalBridge;\n  [installedKey]?: ReturnType<typeof createIframeTransport>;\n};\n\n/** The URL opts into local preview; only same-origin server configuration establishes trust. */\nexport function localFrameBridge(window?: Window): LocalBridge | undefined {\n  const activeWindow =\n    window ??\n    (typeof globalThis.window === 'undefined' ? undefined : globalThis.window);\n  if (!activeWindow) return undefined;\n  const frame = activeWindow as FrameWindow;\n  if (frame[bridgeKey]) return frame[bridgeKey];\n  const parentOrigin =\n    new URL(frame.location.href).searchParams.get(PARENT_PARAM) ?? '';\n  if (!parentOrigin) return undefined;\n\n  async function connect(parentOrigin: string) {\n    try {\n      const response = await frame.fetch('/__altertable/parent', {\n        signal: AbortSignal.timeout(5000),\n      });\n      const config = (await response.json()) as { origin?: unknown };\n      if (\n        !response.ok ||\n        config.origin !== parentOrigin ||\n        frame.parent === frame\n      )\n        throw new Error('Invalid local parent configuration.');\n      // Another owner can install a trusted bridge while configuration is pending.\n      if (frame[installedKey]) return frame[installedKey];\n      if (frame[bridgeKey] !== proxy)\n        throw new Error('Preview transport owner changed.');\n      const bridge = createIframeTransport({ parentOrigin, window: frame });\n      frame[bridgeKey] = bridge;\n      frame[installedKey] = bridge;\n\n      return bridge;\n    } catch {\n      throw new DataAppError(\n        'The preview shell could not be verified. Open the URL printed by altertable app dev.',\n        'bridge_unavailable'\n      );\n    }\n  }\n\n  let connection: Promise<ReturnType<typeof createIframeTransport>> | undefined;\n\n  function getConnection() {\n    const installed = frame[installedKey];\n    if (installed) return Promise.resolve(installed);\n    if (!connection) {\n      const attempt = connect(parentOrigin);\n      connection = attempt;\n      // Clear only this failed attempt; retained proxy references can explicitly retry.\n      void attempt.catch(() => {\n        if (connection === attempt) connection = undefined;\n      });\n    }\n\n    return connection;\n  }\n\n  const proxy: LocalBridge = {\n    async transport(operation, input, signal) {\n      signal?.throwIfAborted();\n      const attempt = getConnection();\n      let abort: (() => void) | undefined;\n      try {\n        const bridge = signal\n          ? await Promise.race([\n              attempt,\n              new Promise<never>((_, reject) => {\n                const requestSignal = signal;\n\n                function handleAbort() {\n                  reject(requestSignal.reason);\n                }\n\n                abort = handleAbort;\n                requestSignal.addEventListener('abort', handleAbort, {\n                  once: true,\n                });\n              }),\n            ])\n          : await attempt;\n        signal?.throwIfAborted();\n\n        return bridge.transport(operation, input, signal);\n      } finally {\n        if (abort) signal?.removeEventListener('abort', abort);\n      }\n    },\n    connect: getConnection,\n  };\n  frame[bridgeKey] = proxy;\n  // Static mounting still verifies eagerly, without an unhandled rejection.\n  void getConnection().catch(() => {});\n\n  return proxy;\n}\n\n/** Install an explicitly trusted transport for hosted apps and their URL-backed controls. */\nexport function installDataAppTransport(\n  bridge: ReturnType<typeof createIframeTransport>,\n  frame: Window = window\n) {\n  const target = frame as FrameWindow;\n  if (target[installedKey])\n    throw new Error('A data app transport is already installed.');\n  target[bridgeKey] = bridge;\n  target[installedKey] = bridge;\n\n  return () => {\n    if (target[bridgeKey] === bridge) delete target[bridgeKey];\n    if (target[installedKey] === bridge) delete target[installedKey];\n    bridge.dispose();\n  };\n}\n\n/** The bootstrap installs this before executing app code. URL apps can install an explicit connection. */\nexport function getDataAppTransport(frame: Window = window) {\n  return (frame as FrameWindow)[installedKey];\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "CBF217D545192BD464756E2164756E21",
+  "names": []
+}

package/dist/chunks/contract-mev09s5v.js

@@ -0,0 +1,77 @@
+// src/core/format.ts
+function formatDateRange2({
+  start,
+  end
+}) {
+  const first = new Date(`${start}T00:00:00Z`);
+  const last = new Date(`${end}T00:00:00Z`);
+  function format(date, options) {
+    return new Intl.DateTimeFormat("en-US", {
+      ...options,
+      timeZone: "UTC"
+    }).format(date);
+  }
+  function formatFullDate(date) {
+    return format(date, { month: "short", day: "numeric", year: "numeric" });
+  }
+  if (start === end)
+    return formatFullDate(first);
+  if (first.getUTCFullYear() !== last.getUTCFullYear())
+    return `${formatFullDate(first)}–${formatFullDate(last)}`;
+  const firstMonth = format(first, { month: "short" });
+  const lastMonth = format(last, { month: "short" });
+  const firstDay = first.getUTCDate();
+  const lastDay = last.getUTCDate();
+  return firstMonth === lastMonth ? `${firstMonth} ${firstDay}–${lastDay}, ${last.getUTCFullYear()}` : `${firstMonth} ${firstDay}–${lastMonth} ${lastDay}, ${last.getUTCFullYear()}`;
+}
+function formatMetric2(value, format) {
+  if (format.kind === "count")
+    return formatCount2(value, format);
+  if (format.kind === "ratio")
+    return formatPercent2(value, format);
+  return formatNumber2(value, {
+    style: "currency",
+    currency: format.currency,
+    locale: format.locale
+  });
+}
+function formatNumber2(value, options = {}) {
+  const { locale = "en-US", missing = "—", ...numberOptions } = options;
+  return value === null || value === undefined || !Number.isFinite(value) ? missing : new Intl.NumberFormat(locale, numberOptions).format(Object.is(value, -0) ? 0 : value);
+}
+function formatCount2(value, options = {}) {
+  const { compact = false, ...common } = options;
+  if (value !== null && value !== undefined && (!Number.isInteger(value) || value < 0)) {
+    return common.missing ?? "—";
+  }
+  return formatNumber2(value, {
+    ...common,
+    notation: compact ? "compact" : "standard",
+    maximumFractionDigits: compact ? 1 : 0
+  });
+}
+var pluralRules = new Intl.PluralRules;
+function pluralize2(count, singular, plural = `${singular}s`) {
+  return pluralRules.select(count) === "one" ? singular : plural;
+}
+function formatPercent2(ratio, options = {}) {
+  if (ratio === null || ratio === undefined || !Number.isFinite(ratio)) {
+    return options.missing ?? "—";
+  }
+  const digits = options.maximumFractionDigits ?? (Math.abs(ratio) < 0.01 ? 2 : 1);
+  const percentOptions = {
+    locale: options.locale,
+    style: "percent",
+    maximumFractionDigits: digits
+  };
+  const smallestVisibleRatio = 10 ** -digits / 100;
+  if (ratio !== 0 && Math.round(Math.abs(ratio) / smallestVisibleRatio) === 0) {
+    const boundary = formatNumber2(smallestVisibleRatio, percentOptions);
+    return ratio > 0 ? `<${boundary}` : `>−${boundary}`;
+  }
+  return formatNumber2(ratio, percentOptions);
+}
+
+export { formatDateRange2, formatMetric2, formatNumber2, formatCount2, pluralize2, formatPercent2 };
+
+//# debugId=01AB707F92225BAC64756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/format.ts"],
+  "sourcesContent": [
+    "/**\n * Date and number formatting with explicit units and missing-value behavior.\n * @module @altertable/data-app/format\n * @see https://github.com/altertable-ai/data-app/blob/main/docs/format.md\n */\ntype CommonOptions = { locale?: string; missing?: string };\n\n/** Compact, unambiguous calendar dates for labels and request status. */\nexport function formatDateRange({\n  start,\n  end,\n}: {\n  start: string;\n  end: string;\n}): string {\n  const first = new Date(`${start}T00:00:00Z`);\n  const last = new Date(`${end}T00:00:00Z`);\n\n  function format(date: Date, options: Intl.DateTimeFormatOptions) {\n    return new Intl.DateTimeFormat('en-US', {\n      ...options,\n      timeZone: 'UTC',\n    }).format(date);\n  }\n\n  function formatFullDate(date: Date) {\n    return format(date, { month: 'short', day: 'numeric', year: 'numeric' });\n  }\n\n  if (start === end) return formatFullDate(first);\n  if (first.getUTCFullYear() !== last.getUTCFullYear())\n    return `${formatFullDate(first)}–${formatFullDate(last)}`;\n  const firstMonth = format(first, { month: 'short' });\n  const lastMonth = format(last, { month: 'short' });\n  const firstDay = first.getUTCDate();\n  const lastDay = last.getUTCDate();\n\n  return firstMonth === lastMonth\n    ? `${firstMonth} ${firstDay}–${lastDay}, ${last.getUTCFullYear()}`\n    : `${firstMonth} ${firstDay}–${lastMonth} ${lastDay}, ${last.getUTCFullYear()}`;\n}\n\nexport type MetricFormat =\n  | { kind: 'count'; compact?: boolean; locale?: string }\n  | { kind: 'ratio'; maximumFractionDigits?: number; locale?: string }\n  | { kind: 'currency'; currency: string; locale?: string };\n\nexport function formatMetric(value: number, format: MetricFormat): string {\n  if (format.kind === 'count') return formatCount(value, format);\n  if (format.kind === 'ratio') return formatPercent(value, format);\n\n  return formatNumber(value, {\n    style: 'currency',\n    currency: format.currency,\n    locale: format.locale,\n  });\n}\n\n/** Missing and non-finite values use the `missing` label; negative zero renders as zero. */\nexport function formatNumber(\n  value: number | null | undefined,\n  options: CommonOptions & Intl.NumberFormatOptions = {}\n): string {\n  const { locale = 'en-US', missing = '—', ...numberOptions } = options;\n\n  return value === null || value === undefined || !Number.isFinite(value)\n    ? missing\n    : new Intl.NumberFormat(locale, numberOptions).format(\n        Object.is(value, -0) ? 0 : value\n      );\n}\n\n/** Negative and fractional counts render as missing. Compact notation is opt-in. */\nexport function formatCount(\n  value: number | null | undefined,\n  options: CommonOptions & { compact?: boolean } = {}\n): string {\n  const { compact = false, ...common } = options;\n  if (\n    value !== null &&\n    value !== undefined &&\n    (!Number.isInteger(value) || value < 0)\n  ) {\n    return common.missing ?? '—';\n  }\n\n  return formatNumber(value, {\n    ...common,\n    notation: compact ? 'compact' : 'standard',\n    maximumFractionDigits: compact ? 1 : 0,\n  });\n}\n\nconst pluralRules = new Intl.PluralRules();\n\nexport function pluralize(\n  count: number,\n  singular: string,\n  plural = `${singular}s`\n): string {\n  return pluralRules.select(count) === 'one' ? singular : plural;\n}\n\n/** Accepts a ratio (0.116), not a percentage (11.6). */\nexport function formatPercent(\n  ratio: number | null | undefined,\n  options: CommonOptions & { maximumFractionDigits?: number } = {}\n): string {\n  if (ratio === null || ratio === undefined || !Number.isFinite(ratio)) {\n    return options.missing ?? '—';\n  }\n  const digits =\n    options.maximumFractionDigits ?? (Math.abs(ratio) < 0.01 ? 2 : 1);\n  const percentOptions = {\n    locale: options.locale,\n    style: 'percent' as const,\n    maximumFractionDigits: digits,\n  };\n  const smallestVisibleRatio = 10 ** -digits / 100;\n  if (ratio !== 0 && Math.round(Math.abs(ratio) / smallestVisibleRatio) === 0) {\n    const boundary = formatNumber(smallestVisibleRatio, percentOptions);\n\n    return ratio > 0 ? `<${boundary}` : `>−${boundary}`;\n  }\n\n  return formatNumber(ratio, percentOptions);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "01AB707F92225BAC64756E2164756E21",
+  "names": []
+}