@altertable/data-app 0.65.0 → 0.67.0

package/dist/chunks/{contract-txjy0en2.js → index-m6n8ctfc.js}

@@ -69,89 +69,81 @@ function normalizeAppearance2(value = {}) {
     }
   };
 }
-var palettes = {
-  neutral: {
-    light: ["#ffffff", "#ffffff", "#f6f7f7", "#202124", "#687078", "#e3e6e8"],
-    dark: ["#151719", "#202326", "#292d31", "#f2f3f4", "#aeb5bc", "#3b4248"]
-  },
-  slate: {
-    light: ["#f8fafc", "#ffffff", "#f1f5f9", "#17212f", "#607083", "#dce3ea"],
-    dark: ["#111820", "#1b2530", "#263340", "#f0f4f8", "#a8b5c3", "#3a4857"]
-  },
-  warm: {
-    light: ["#fbfaf8", "#ffffff", "#f5f2ed", "#292723", "#736e66", "#e8e2da"],
-    dark: ["#1b1916", "#25221e", "#302c27", "#f5f1eb", "#bcb3a8", "#494239"]
-  }
-};
-var spaces = {
-  compact: ["4px", "8px", "12px", "18px", "24px"],
-  comfortable: ["5px", "10px", "16px", "24px", "32px"],
-  spacious: ["6px", "12px", "20px", "30px", "40px"]
-};
-var radii = {
-  none: ["0px", "0px", "0px"],
-  small: ["4px", "7px", "9px"],
-  medium: ["7px", "12px", "16px"],
-  large: ["10px", "18px", "24px"]
-};
 function fontStack(family) {
   return family === "system" ? "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, ui-sans-serif, sans-serif" : `${JSON.stringify(family)}, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, ui-sans-serif, sans-serif`;
 }
+function accentForeground(settings, dark) {
+  const accent = getComputedStyle(document.documentElement).getPropertyValue("--atbl-accent") || (dark ? settings.darkAccentColor ?? `color-mix(in srgb, ${settings.accentColor} 50%, white)` : settings.accentColor);
+  const canvas = document.createElement("canvas");
+  canvas.width = canvas.height = 1;
+  const context = canvas.getContext("2d");
+  context.fillStyle = accent;
+  context.fillRect(0, 0, 1, 1);
+  const channels = [...context.getImageData(0, 0, 1, 1).data].slice(0, 3).map((value) => {
+    const channel = value / 255;
+    return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
+  });
+  const luminance = channels[0] * 0.2126 + channels[1] * 0.7152 + channels[2] * 0.0722;
+  return (luminance + 0.05) / 0.05 > 1.05 / (luminance + 0.05) ? "#000000" : "#ffffff";
+}
 function applyAppearance2(value) {
   const settings = normalizeAppearance2(value);
   const root = document.documentElement;
   const preference = window.matchMedia("(prefers-color-scheme: dark)");
-  const [xs, sm, md, lg, xl] = spaces[settings.density];
-  const [control, surface, overlay] = radii[settings.cornerRadius];
-  const tokens = {
-    "--at-font": fontStack(settings.typography.body),
-    "--at-font-heading": fontStack(settings.typography.heading),
-    "--at-space-xs": xs,
-    "--at-space-sm": sm,
-    "--at-space-md": md,
-    "--at-space-lg": lg,
-    "--at-space-xl": xl,
-    "--at-layout-gap": `clamp(${md}, 2.5vw, ${lg})`,
-    "--at-radius-control": control,
-    "--at-radius-surface": surface,
-    "--at-radius-overlay": overlay,
-    "--at-shadow-overlay": settings.elevation === "flat" ? "none" : settings.elevation === "raised" ? "0 24px 72px rgb(0 0 0 / 24%)" : "0 18px 50px rgb(0 0 0 / 16%)",
-    "--at-shadow-surface": settings.elevation === "flat" ? "none" : settings.elevation === "raised" ? "0 8px 28px rgb(20 28 40 / 10%)" : "0 3px 16px rgb(20 28 40 / 5%)"
+  const attributes = {
+    "data-atbl-appearance": "",
+    "data-atbl-base-color": settings.baseColor,
+    "data-atbl-density": settings.density,
+    "data-atbl-radius": settings.cornerRadius,
+    "data-atbl-elevation": settings.elevation,
+    "data-atbl-theme": ""
   };
-  function applyColors() {
-    const dark = settings.theme === "dark" || settings.theme === "system" && preference.matches;
-    const [background, surfaceColor, subtle, text, muted, border] = palettes[settings.baseColor][dark ? "dark" : "light"];
-    const accent = dark ? settings.darkAccentColor ?? `color-mix(in srgb, ${settings.accentColor} 50%, white)` : settings.accentColor;
-    settings.chartColors.forEach((chartColor, index) => {
-      tokens[`--at-chart-${index + 1}`] = dark ? `color-mix(in srgb, ${chartColor} 60%, white)` : chartColor;
-    });
-    Object.assign(tokens, {
-      "--at-background": background,
-      "--at-surface": surfaceColor,
-      "--at-subtle": subtle,
-      "--at-text": text,
-      "--at-muted": muted,
-      "--at-border": border,
-      "--at-accent": accent,
-      "--at-focus-color": muted,
-      "--at-control-hover-border": `color-mix(in srgb, ${muted} 45%, ${border})`,
-      "--at-accent-hover": `color-mix(in srgb, ${accent} 80%, ${dark ? "white" : "black"})`,
-      "--at-accent-subtle": `color-mix(in srgb, ${accent} ${dark ? 22 : 12}%, ${surfaceColor})`,
-      "--at-on-accent": dark ? background : "#ffffff",
-      "--at-danger": dark ? "#f97066" : "#b42318",
-      "--at-backdrop": dark ? "rgb(0 0 0 / 55%)" : "rgb(15 23 30 / 22%)",
-      "--at-code-surface": dark ? "#242a31" : "#f4f6f9",
-      "--at-code-text": dark ? "#e5e9ef" : "#273242"
-    });
-    root.style.colorScheme = dark ? "dark" : "light";
-    for (const [name, token] of Object.entries(tokens))
+  const inputs = {
+    "--atbl-input-font": fontStack(settings.typography.body),
+    "--atbl-input-font-heading": fontStack(settings.typography.heading),
+    "--atbl-input-accent": settings.accentColor,
+    "--atbl-input-dark-accent": settings.darkAccentColor ?? "",
+    "--atbl-input-on-accent": ""
+  };
+  const chartColors = settings.chartColors.length ? settings.chartColors : defaults.chartColors;
+  for (let index = 0;index < 8; index++)
+    inputs[`--atbl-input-chart-${index + 1}`] = chartColors[index % chartColors.length];
+  const previousAttributes = Object.keys(attributes).map((name) => [name, root.getAttribute(name)]);
+  const previousInputs = Object.keys(inputs).map((name) => [
+    name,
+    root.style.getPropertyValue(name),
+    root.style.getPropertyPriority(name)
+  ]);
+  for (const [name, token] of Object.entries(inputs)) {
+    if (token)
       root.style.setProperty(name, token);
+    else
+      root.style.removeProperty(name);
+  }
+  for (const [name, attribute] of Object.entries(attributes))
+    root.setAttribute(name, attribute);
+  function applyTheme() {
+    const dark = settings.theme === "dark" || settings.theme === "system" && preference.matches;
+    root.setAttribute("data-atbl-theme", dark ? "dark" : "light");
+    root.style.setProperty("--atbl-input-on-accent", accentForeground(settings, dark));
   }
-  applyColors();
+  applyTheme();
   if (settings.theme === "system")
-    preference.addEventListener("change", applyColors);
+    preference.addEventListener("change", applyTheme);
   return () => {
-    preference.removeEventListener("change", applyColors);
+    preference.removeEventListener("change", applyTheme);
+    for (const [name, attribute] of previousAttributes) {
+      if (attribute === null)
+        root.removeAttribute(name);
+      else
+        root.setAttribute(name, attribute);
+    }
+    for (const [name, token, priority] of previousInputs) {
+      if (token)
+        root.style.setProperty(name, token, priority);
+      else
+        root.style.removeProperty(name);
+    }
   };
 }
 function createThemeController2(initialTheme = "light") {
@@ -185,4 +177,4 @@ function createThemeController2(initialTheme = "light") {
 
 export { parseAppearance2, normalizeAppearance2, applyAppearance2, createThemeController2 };
 
-//# debugId=E968EAFDC43C9C1764756E2164756E21
+//# debugId=312AAB5702AE519564756E2164756E21

package/dist/chunks/index-m6n8ctfc.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/appearance.ts"],
+  "sourcesContent": [
+    "/**\n * Brand settings; parsing is portable, while theme application requires the browser.\n * @module @altertable/data-app/appearance\n */\nexport type Theme = 'light' | 'dark';\nexport type ThemePreference = Theme | 'system';\n\nexport type AppearanceSettings = {\n  theme: ThemePreference;\n  baseColor: 'neutral' | 'slate' | 'warm';\n  accentColor: string;\n  darkAccentColor?: string;\n  chartColors: string[];\n  density: 'compact' | 'comfortable' | 'spacious';\n  cornerRadius: 'none' | 'small' | 'medium' | 'large';\n  elevation: 'flat' | 'subtle' | 'raised';\n  typography: { body: string; heading: string };\n};\n\n/** App-authored overrides; omitted fields use the package defaults. */\nexport type AppearanceOptions = Partial<\n  Omit<AppearanceSettings, 'typography'>\n> & { typography?: Partial<AppearanceSettings['typography']> };\n\nexport type ThemeController = {\n  getTheme: () => ThemePreference;\n  setTheme: (theme: ThemePreference) => void;\n  subscribe: (listener: () => void) => () => void;\n};\n\nconst defaults: AppearanceSettings = {\n  theme: 'light',\n  baseColor: 'neutral',\n  accentColor: '#405d47',\n  darkAccentColor: '#a6c4ad',\n  chartColors: [\n    '#285fc0',\n    '#a95319',\n    '#147862',\n    '#7243aa',\n    '#aa3958',\n    '#475569',\n  ],\n  density: 'comfortable',\n  cornerRadius: 'medium',\n  elevation: 'subtle',\n  typography: { body: 'system', heading: 'system' },\n};\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction oneOf<T extends string>(\n  value: unknown,\n  options: readonly T[]\n): value is T {\n  return typeof value === 'string' && options.includes(value as T);\n}\n\nfunction color(value: unknown): value is string {\n  return typeof value === 'string' && /^#[0-9a-fA-F]{6}$/.test(value);\n}\n\nfunction font(value: unknown): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= 120 &&\n    !/[;{}()]/.test(value)\n  );\n}\n\n/** Preserve supported external settings and use defaults for invalid fields. */\nexport function parseAppearance(value: unknown): AppearanceSettings {\n  if (!record(value)) return normalizeAppearance();\n  const typography = record(value.typography) ? value.typography : {};\n\n  return normalizeAppearance({\n    theme: oneOf(value.theme, ['light', 'dark', 'system'])\n      ? value.theme\n      : undefined,\n    baseColor: oneOf(value.baseColor, ['neutral', 'slate', 'warm'])\n      ? value.baseColor\n      : undefined,\n    accentColor: color(value.accentColor) ? value.accentColor : undefined,\n    darkAccentColor: color(value.darkAccentColor)\n      ? value.darkAccentColor\n      : undefined,\n    chartColors:\n      Array.isArray(value.chartColors) &&\n      value.chartColors.length >= 1 &&\n      value.chartColors.length <= 8 &&\n      value.chartColors.every(color)\n        ? value.chartColors\n        : undefined,\n    density: oneOf(value.density, ['compact', 'comfortable', 'spacious'])\n      ? value.density\n      : undefined,\n    cornerRadius: oneOf(value.cornerRadius, [\n      'none',\n      'small',\n      'medium',\n      'large',\n    ])\n      ? value.cornerRadius\n      : undefined,\n    elevation: oneOf(value.elevation, ['flat', 'subtle', 'raised'])\n      ? value.elevation\n      : undefined,\n    typography: {\n      body: font(typography.body) ? typography.body : undefined,\n      heading: font(typography.heading) ? typography.heading : undefined,\n    },\n  });\n}\n\n/** Resolve typed app settings without repeating authoring checks at runtime. */\nexport function normalizeAppearance(\n  value: AppearanceOptions = {}\n): AppearanceSettings {\n  return {\n    theme: value.theme ?? defaults.theme,\n    baseColor: value.baseColor ?? defaults.baseColor,\n    accentColor: value.accentColor ?? defaults.accentColor,\n    density: value.density ?? defaults.density,\n    cornerRadius: value.cornerRadius ?? defaults.cornerRadius,\n    elevation: value.elevation ?? defaults.elevation,\n    darkAccentColor:\n      value.darkAccentColor ??\n      (value.accentColor === undefined ? defaults.darkAccentColor : undefined),\n    chartColors: [...(value.chartColors ?? defaults.chartColors)],\n    typography: {\n      body: value.typography?.body ?? defaults.typography.body,\n      heading: value.typography?.heading ?? defaults.typography.heading,\n    },\n  };\n}\n\nfunction fontStack(family: string): string {\n  return family === 'system'\n    ? \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, ui-sans-serif, sans-serif\"\n    : `${JSON.stringify(family)}, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, ui-sans-serif, sans-serif`;\n}\n\n/** Choose a foreground after the browser resolves the configured CSS color. */\nfunction accentForeground(settings: AppearanceSettings, dark: boolean): string {\n  const accent =\n    getComputedStyle(document.documentElement).getPropertyValue(\n      '--atbl-accent'\n    ) ||\n    (dark\n      ? (settings.darkAccentColor ??\n        `color-mix(in srgb, ${settings.accentColor} 50%, white)`)\n      : settings.accentColor);\n  const canvas = document.createElement('canvas');\n  canvas.width = canvas.height = 1;\n  const context = canvas.getContext('2d')!;\n  context.fillStyle = accent;\n  context.fillRect(0, 0, 1, 1);\n  const channels = [...context.getImageData(0, 0, 1, 1).data]\n    .slice(0, 3)\n    .map(value => {\n      const channel = value / 255;\n      return channel <= 0.04045\n        ? channel / 12.92\n        : ((channel + 0.055) / 1.055) ** 2.4;\n    });\n  const luminance =\n    channels[0]! * 0.2126 + channels[1]! * 0.7152 + channels[2]! * 0.0722;\n  return (luminance + 0.05) / 0.05 > 1.05 / (luminance + 0.05)\n    ? '#000000'\n    : '#ffffff';\n}\n\n/**\n * Select document-owned appearance presets and brand inputs. Public CSS tokens remain\n * overridable in stylesheets. Cleanup restores the previous document appearance.\n */\nexport function applyAppearance(value?: AppearanceOptions): () => void {\n  const settings = normalizeAppearance(value);\n  const root = document.documentElement;\n  const preference = window.matchMedia('(prefers-color-scheme: dark)');\n  const attributes: Record<string, string> = {\n    'data-atbl-appearance': '',\n    'data-atbl-base-color': settings.baseColor,\n    'data-atbl-density': settings.density,\n    'data-atbl-radius': settings.cornerRadius,\n    'data-atbl-elevation': settings.elevation,\n    'data-atbl-theme': '',\n  };\n  const inputs: Record<string, string> = {\n    '--atbl-input-font': fontStack(settings.typography.body),\n    '--atbl-input-font-heading': fontStack(settings.typography.heading),\n    '--atbl-input-accent': settings.accentColor,\n    '--atbl-input-dark-accent': settings.darkAccentColor ?? '',\n    '--atbl-input-on-accent': '',\n  };\n  const chartColors = settings.chartColors.length\n    ? settings.chartColors\n    : defaults.chartColors;\n  // Every categorical slot is defined, including after shrinking a custom palette.\n  for (let index = 0; index < 8; index++)\n    inputs[`--atbl-input-chart-${index + 1}`] =\n      chartColors[index % chartColors.length]!;\n\n  const previousAttributes = Object.keys(attributes).map(\n    name => [name, root.getAttribute(name)] as const\n  );\n  const previousInputs = Object.keys(inputs).map(\n    name =>\n      [\n        name,\n        root.style.getPropertyValue(name),\n        root.style.getPropertyPriority(name),\n      ] as const\n  );\n  for (const [name, token] of Object.entries(inputs)) {\n    if (token) root.style.setProperty(name, token);\n    else root.style.removeProperty(name);\n  }\n  for (const [name, attribute] of Object.entries(attributes))\n    root.setAttribute(name, attribute);\n\n  function applyTheme(): void {\n    const dark =\n      settings.theme === 'dark' ||\n      (settings.theme === 'system' && preference.matches);\n    root.setAttribute('data-atbl-theme', dark ? 'dark' : 'light');\n    root.style.setProperty(\n      '--atbl-input-on-accent',\n      accentForeground(settings, dark)\n    );\n  }\n  applyTheme();\n  if (settings.theme === 'system')\n    preference.addEventListener('change', applyTheme);\n\n  return () => {\n    preference.removeEventListener('change', applyTheme);\n    for (const [name, attribute] of previousAttributes) {\n      if (attribute === null) root.removeAttribute(name);\n      else root.setAttribute(name, attribute);\n    }\n    for (const [name, token, priority] of previousInputs) {\n      if (token) root.style.setProperty(name, token, priority);\n      else root.style.removeProperty(name);\n    }\n  };\n}\n\n/** Persist a viewer theme preference. Applying appearance belongs to the UI owner. */\nexport function createThemeController(\n  initialTheme: ThemePreference = 'light'\n): ThemeController {\n  const storageKey = 'altertable.data-app.theme';\n  let theme = initialTheme;\n  try {\n    const saved = window.localStorage.getItem(storageKey);\n    if (oneOf(saved, ['light', 'dark', 'system'])) theme = saved;\n  } catch {\n    // Storage can be unavailable in private browsing or embedded contexts.\n  }\n  const listeners = new Set<() => void>();\n\n  return {\n    getTheme() {\n      return theme;\n    },\n    setTheme(nextTheme) {\n      if (nextTheme === theme) return;\n      theme = nextTheme;\n      try {\n        window.localStorage.setItem(storageKey, theme);\n      } catch {\n        // The selection still applies to this page.\n      }\n      listeners.forEach(listener => listener());\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n\n      return () => listeners.delete(listener);\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "312AAB5702AE519564756E2164756E21",
+  "names": []
+}

package/dist/chunks/index-mt93ff2b.js

@@ -0,0 +1,28 @@
+import {
+  defineOperation2
+} from "./index-ag0cgnvq.js";
+import {
+  snapshotQueries
+} from "./index-qd5xgx6y.js";
+
+// src/core/config.ts
+function defineDataApp2(config) {
+  const queries = snapshotQueries(config.queries);
+  return Object.freeze({
+    ...config,
+    queries,
+    defineOperation(operation) {
+      return defineOperation2({
+        ...operation,
+        queries
+      });
+    }
+  });
+}
+function dataAppTitle2(config) {
+  return `${config.title} • ${config.scope.organization}/${config.scope.environment} • Altertable app`;
+}
+
+export { defineDataApp2, dataAppTitle2 };
+
+//# debugId=BF0300C757D4413D64756E2164756E21

package/dist/chunks/index-mt93ff2b.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/config.ts"],
+  "sourcesContent": [
+    "/**\n * App configuration shared by browser and server.\n * @module @altertable/data-app\n */\nimport { defineOperation } from '@/src/core/contract';\nimport type { AppearanceOptions } from '@/src/core/appearance';\nimport { snapshotQueries, type QueryDefinitions } from '@/src/core/queries';\nexport type { QueryDefinitions, QueryParameterValue } from '@/src/core/queries';\n\nexport type DataAppConfig<Queries extends QueryDefinitions = QueryDefinitions> =\n  {\n    title: string;\n    /** Display labels; scope does not grant data access. */\n    scope: { organization: string; environment: string };\n    /** Explain what the app helps readers explore. */\n    description: string;\n    /** Omit to use the standard appearance. */\n    appearance?: AppearanceOptions;\n    /** Named SQL statements and parameter defaults used by app operations. */\n    queries: Queries;\n  };\n\ntype ImmutableQueries<Queries extends QueryDefinitions> = {\n  readonly [Name in keyof Queries]: {\n    readonly statement: Queries[Name]['statement'];\n    readonly params: {\n      readonly [Param in keyof Queries[Name]['params']]: Readonly<\n        Queries[Name]['params'][Param]\n      >;\n    };\n  };\n};\n\n/** An app declaration with operations bound to its query registry. */\nexport type DataAppDefinition<\n  Queries extends QueryDefinitions = QueryDefinitions,\n> = Readonly<Omit<DataAppConfig<Queries>, 'queries'>> & {\n  readonly queries: ImmutableQueries<Queries>;\n  defineOperation<Input, Output>(\n    operation: Omit<\n      Parameters<typeof defineOperation<Input, Output, Queries>>[0],\n      'queries'\n    >\n  ): ReturnType<typeof defineOperation<Input, Output, Queries>>;\n};\n\n/**\n * Define the app's query source of truth while preserving exact query and parameter names.\n * Use `app.defineOperation()` to bind operations to these queries. Pass the app once\n * to `mountDataApp({ app, component })` or `<DataAppProvider app={app}>`.\n * The app owns an immutable snapshot of its registry; later input mutations do not change it.\n * This declaration does not execute queries or mount UI. Static apps use `queries: {}`.\n *\n * Declare exactly one module-level const initialized with `defineDataApp({ ... })` in the app's\n * declaration source. For the future backend extractor, the argument is read before bundling\n * by resolving the named `defineDataApp` import from `@altertable/data-app`, including aliases.\n * Variable name is arbitrary;\n * export only for imports by other modules. The argument must be a direct object literal\n * containing schema-valid objects, arrays, strings (including templates without interpolation),\n * finite signed numbers, booleans, and null. No spreads, computed keys, references, calls,\n * or callbacks inside it. Extraction must validate data without evaluating app code.\n * TypeScript checks the shape, not AST syntax. Keep executable composition outside the call.\n *\n * SQL passes unchanged to the backend, which interprets placeholders such as `$orgId`.\n * Declare every parameter with `{ defaultValue: value }` or `{}` for a required value.\n * Values are finite numbers, strings, booleans, or null, never SQL fragments or identifiers.\n * Caller values override defaults; trusted server `queryParams` cannot be overridden.\n */\nexport function defineDataApp<const Queries extends QueryDefinitions>(\n  config: DataAppConfig<Queries>\n): DataAppDefinition<Queries> {\n  const queries = snapshotQueries(config.queries) as Queries &\n    ImmutableQueries<Queries>;\n  return Object.freeze({\n    ...config,\n    queries,\n    defineOperation<Input, Output>(\n      operation: Omit<\n        Parameters<typeof defineOperation<Input, Output, Queries>>[0],\n        'queries'\n      >\n    ) {\n      return defineOperation<Input, Output, Queries>({\n        ...operation,\n        queries,\n      });\n    },\n  });\n}\n\nexport function dataAppTitle(\n  config: Pick<DataAppConfig, 'title' | 'scope'>\n): string {\n  return `${config.title} • ${config.scope.organization}/${config.scope.environment} • Altertable app`;\n}\n"
+  ],
+  "mappings": ";;;;;;;;AAoEO,SAAS,cAAqD,CACnE,QAC4B;AAAA,EAC5B,MAAM,UAAU,gBAAgB,OAAO,OAAO;AAAA,EAE9C,OAAO,OAAO,OAAO;AAAA,OAChB;AAAA,IACH;AAAA,IACA,eAA8B,CAC5B,WAIA;AAAA,MACA,OAAO,iBAAwC;AAAA,WAC1C;AAAA,QACH;AAAA,MACF,CAAC;AAAA;AAAA,EAEL,CAAC;AAAA;AAGI,SAAS,aAAY,CAC1B,QACQ;AAAA,EACR,OAAO,GAAG,OAAO,WAAW,OAAO,MAAM,gBAAgB,OAAO,MAAM;AAAA;",
+  "debugId": "BF0300C757D4413D64756E2164756E21",
+  "names": []
+}

package/dist/chunks/{contract-tf8c3qpv.js → index-qd5xgx6y.js}

@@ -1,3 +1,40 @@
+// src/core/invariant.ts
+function invariant(condition, message) {
+  if (!condition)
+    throw new Error(`Invariant failed: ${message}`);
+}
+
+// src/core/queries.ts
+function isQueryParameterValue(value) {
+  return value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value);
+}
+function isQueryParameters(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && Object.values(value).every(isQueryParameterValue);
+}
+function snapshotQueries(definitions) {
+  return Object.freeze(Object.fromEntries(Object.entries(definitions).map(([name, query]) => {
+    invariant(!!name.trim() && !!query.statement.trim(), "Queries need a name and SQL statement.");
+    const params = Object.freeze(Object.fromEntries(Object.entries(query.params).map(([key, declaration]) => {
+      invariant(!Object.hasOwn(declaration, "defaultValue") || isQueryParameterValue(declaration.defaultValue), `Invalid default for parameter ${key} in query ${name}.`);
+      return [key, Object.freeze({ ...declaration })];
+    })));
+    return [name, Object.freeze({ statement: query.statement, params })];
+  })));
+}
+function resolveQueryParameters(declarations, values, context) {
+  invariant(values && typeof values === "object" && !Array.isArray(values), "Supply query parameter values as an object.");
+  for (const key of Object.keys(values)) {
+    invariant(Object.hasOwn(declarations, key), `Unknown parameter ${key}.`);
+    invariant(!Object.hasOwn(context, key), `Cannot override context parameter ${key}.`);
+  }
+  return Object.fromEntries(Object.entries(declarations).map(([key, declaration]) => {
+    const value = Object.hasOwn(context, key) ? context[key] : Object.hasOwn(values, key) ? values[key] : declaration.defaultValue;
+    invariant(value !== undefined, `Missing parameter ${key}.`);
+    invariant(isQueryParameterValue(value), `Parameter ${key} must be a scalar value.`);
+    return [key, value];
+  }));
+}
+
 // src/core/navigation.ts
 function validLocation(value) {
   if (!value || typeof value !== "object")
@@ -98,7 +135,7 @@ function defineDataQueryRoute2(operations) {
       }
       if (!("data" in body) || typeof body.requestId !== "string" || typeof body.queriedAt !== "string" || !Array.isArray(body.queryIds) || !body.queryIds.every((id) => typeof id === "string"))
         throw new Error("Invalid data envelope.");
-      if (body.queries !== undefined && (!Array.isArray(body.queries) || !body.queries.every((query) => query && typeof query === "object" && typeof query.name === "string" && typeof query.statement === "string" && (query.queryId === undefined || typeof query.queryId === "string"))))
+      if (body.queries !== undefined && (!Array.isArray(body.queries) || !body.queries.every((query) => query && typeof query === "object" && typeof query.name === "string" && typeof query.statement === "string" && (query.params === undefined || isQueryParameters(query.params)) && (query.queryId === undefined || typeof query.queryId === "string"))))
         throw new Error("Invalid query evidence.");
       const operation = operations?.[input.operation];
       return {
@@ -136,9 +173,13 @@ var sqlQueryRoute2 = defineMessageRoute2({
     if (!value || typeof value !== "object")
       throw new Error("Invalid SQL query.");
     const query = value;
-    if (typeof query.statement !== "string" || !query.statement.trim() || typeof query.limit !== "number" || !Number.isSafeInteger(query.limit) || query.limit < 1)
+    if (typeof query.statement !== "string" || !query.statement.trim() || typeof query.limit !== "number" || !Number.isSafeInteger(query.limit) || query.limit < 1 || query.params !== undefined && !isQueryParameters(query.params))
       throw new Error("Invalid SQL query.");
-    return { statement: query.statement, limit: query.limit };
+    return {
+      statement: query.statement,
+      limit: query.limit,
+      ...query.params === undefined ? {} : { params: query.params }
+    };
   },
   output(value, input) {
     if (!value || typeof value !== "object")
@@ -158,6 +199,6 @@ var dataAppRoutes2 = {
   "navigation:update": navigationUpdateRoute2
 };
 
-export { validLocation, MessageRoutingError2, defineMessageRoute2, createMessageRouter2, defineDataQueryRoute2, navigationUpdateRoute2, sqlQueryRoute2, dataAppRoutes2 };
+export { invariant, snapshotQueries, resolveQueryParameters, validLocation, MessageRoutingError2, defineMessageRoute2, createMessageRouter2, defineDataQueryRoute2, navigationUpdateRoute2, sqlQueryRoute2, dataAppRoutes2 };
 
-//# debugId=7AD0B2977AA9174364756E2164756E21
+//# debugId=6D70F2841935946464756E2164756E21

package/dist/chunks/index-qd5xgx6y.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/core/invariant.ts", "../src/core/queries.ts", "../src/core/navigation.ts", "../src/core/messages.ts"],
+  "sourcesContent": [
+    "/** Assert an author or data contract while preserving a useful failure message. */\nexport function invariant(\n  condition: unknown,\n  message: string\n): asserts condition {\n  if (!condition) throw new Error(`Invariant failed: ${message}`);\n}\n",
+    "import { invariant } from '@/src/core/invariant';\n\nexport type QueryParameterValue = string | number | boolean | null;\ntype QueryDefinition = {\n  statement: string;\n  params: Readonly<Record<string, { defaultValue?: QueryParameterValue }>>;\n};\nexport type QueryDefinitions = Readonly<Record<string, QueryDefinition>>;\n\n/** Parameters are scalar SQL values, never identifiers or SQL fragments. */\nexport type QueryParameters = Readonly<Record<string, QueryParameterValue>>;\n\nfunction isQueryParameterValue(value: unknown): value is QueryParameterValue {\n  return (\n    value === null ||\n    typeof value === 'string' ||\n    typeof value === 'boolean' ||\n    (typeof value === 'number' && Number.isFinite(value))\n  );\n}\n\nexport function isQueryParameters(value: unknown): value is QueryParameters {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    Object.values(value).every(isQueryParameterValue)\n  );\n}\n\n/** Retain authored statements and defaults, rejecting empty SQL and invalid scalar defaults. */\nexport function snapshotQueries(\n  definitions: QueryDefinitions\n): QueryDefinitions {\n  return Object.freeze(\n    Object.fromEntries(\n      Object.entries(definitions).map(([name, query]) => {\n        invariant(\n          !!name.trim() && !!query.statement.trim(),\n          'Queries need a name and SQL statement.'\n        );\n        const params = Object.freeze(\n          Object.fromEntries(\n            Object.entries(query.params).map(([key, declaration]) => {\n              invariant(\n                !Object.hasOwn(declaration, 'defaultValue') ||\n                  isQueryParameterValue(declaration.defaultValue),\n                `Invalid default for parameter ${key} in query ${name}.`\n              );\n              return [key, Object.freeze({ ...declaration })];\n            })\n          )\n        );\n        return [name, Object.freeze({ statement: query.statement, params })];\n      })\n    )\n  );\n}\n\n/** Context owns protected values; callers supply filters; defaults fill remaining declarations. */\nexport function resolveQueryParameters(\n  declarations: QueryDefinition['params'],\n  values: Partial<QueryParameters>,\n  context: QueryParameters\n): QueryParameters {\n  invariant(\n    values && typeof values === 'object' && !Array.isArray(values),\n    'Supply query parameter values as an object.'\n  );\n  for (const key of Object.keys(values)) {\n    invariant(Object.hasOwn(declarations, key), `Unknown parameter ${key}.`);\n    invariant(\n      !Object.hasOwn(context, key),\n      `Cannot override context parameter ${key}.`\n    );\n  }\n  return Object.fromEntries(\n    Object.entries(declarations).map(([key, declaration]) => {\n      const value = Object.hasOwn(context, key)\n        ? context[key]\n        : Object.hasOwn(values, key)\n          ? values[key]\n          : declaration.defaultValue;\n      invariant(value !== undefined, `Missing parameter ${key}.`);\n      invariant(\n        isQueryParameterValue(value),\n        `Parameter ${key} must be a scalar value.`\n      );\n      return [key, value];\n    })\n  );\n}\n",
+    "/** App-owned URL state shared by controls, frame adapters, and host navigation. */\nexport type AppLocation = { search: string; hash: string };\nexport type HistoryMode = 'push' | 'replace';\nexport type NavigationUpdate = AppLocation & {\n  mode: HistoryMode;\n  title?: string;\n};\n\nexport function validLocation(value: unknown): value is AppLocation {\n  if (!value || typeof value !== 'object') return false;\n  const message = value as { search?: unknown; hash?: unknown };\n  return (\n    typeof message.search === 'string' &&\n    message.search.length <= 16_384 &&\n    (message.search === '' || message.search.startsWith('?')) &&\n    typeof message.hash === 'string' &&\n    message.hash.length <= 4096 &&\n    (message.hash === '' || message.hash.startsWith('#'))\n  );\n}\n",
+    "import { isQueryParameters, type QueryParameters } from '@/src/core/queries';\nimport type {\n  TransportResponse,\n  QueryResult,\n  OperationContracts,\n  DataQueryInput,\n  DataQueryBody,\n  OutputOf,\n} from '@/src/core/operation-types';\nexport type {\n  OperationContracts,\n  DataQueryInput,\n  DataQueryBody,\n} from '@/src/core/operation-types';\nimport { validLocation, type NavigationUpdate } from '@/src/core/navigation';\nexport type { NavigationUpdate } from '@/src/core/navigation';\n\nexport type MessageContext = { signal: AbortSignal };\nexport type RoutedMessage = { route: string; payload: unknown };\nexport type MessageDispatcher = (\n  message: unknown,\n  context: MessageContext\n) => Promise<unknown>;\nexport type MessageTransport = (\n  message: RoutedMessage,\n  signal?: AbortSignal\n) => Promise<unknown>;\nexport type MessageRoute<Input, Output> = {\n  input: (value: unknown) => Input;\n  output: (value: unknown, input: Input) => Output;\n};\nexport type MessageRoutes = Record<\n  string,\n  {\n    input: (value: unknown) => unknown;\n    output: (value: unknown, input: never) => unknown;\n  }\n>;\nexport type MessageInput<Route extends MessageRoutes[string]> = ReturnType<\n  Route['input']\n>;\nexport type MessageHandlers<Routes extends MessageRoutes> = {\n  [Name in keyof Routes]: (\n    payload: MessageInput<Routes[Name]>,\n    context: MessageContext\n  ) =>\n    | ReturnType<Routes[Name]['output']>\n    | Promise<ReturnType<Routes[Name]['output']>>;\n};\n\n// A bootstrap and its app may bundle independent copies in the same window.\nconst errorBrand = Symbol.for('@altertable/data-app/MessageRoutingError');\n\n/** Only these deliberate, public failures cross the message boundary. Other errors stay private. */\nexport class MessageRoutingError 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    public readonly code: string,\n    message: string,\n    public readonly requestId?: string\n  ) {\n    super(message);\n    this.name = 'MessageRoutingError';\n  }\n}\n\nexport function defineMessageRoute<Input, Output>(\n  route: MessageRoute<Input, Output>\n): MessageRoute<Input, Output> {\n  return route;\n}\n\n/** Contracts are shared; handlers are supplied by the host and never belong in the app bundle. */\nexport function createMessageRouter<const Routes extends MessageRoutes>(\n  routes: Routes,\n  handlers: MessageHandlers<NoInfer<Routes>>\n) {\n  const registered = new Map(\n    Object.entries(routes).map(([name, contract]) => {\n      const handler = handlers[name];\n      if (!name || name.length > 256 || typeof handler !== 'function')\n        throw new Error(\n          'Each message route requires a handler and a bounded name.'\n        );\n\n      return [name, { contract, handler }] as const;\n    })\n  );\n\n  async function dispatch(\n    value: unknown,\n    context: MessageContext\n  ): Promise<unknown> {\n    if (\n      !value ||\n      typeof value !== 'object' ||\n      typeof (value as RoutedMessage).route !== 'string'\n    )\n      throw new MessageRoutingError(\n        'invalid_message',\n        'Invalid routed message.'\n      );\n    const message = value as RoutedMessage;\n    const entry = registered.get(message.route);\n    if (!entry)\n      throw new MessageRoutingError('unknown_route', 'Unknown message route.');\n    let payload: unknown;\n    try {\n      payload = entry.contract.input(message.payload);\n    } catch {\n      throw new MessageRoutingError(\n        'invalid_payload',\n        'Invalid message payload.'\n      );\n    }\n    context.signal.throwIfAborted();\n    let result: unknown;\n    try {\n      result = await entry.handler(payload as never, context);\n    } catch (error) {\n      if (context.signal.aborted) throw context.signal.reason;\n      if (error instanceof MessageRoutingError) throw error;\n      throw new MessageRoutingError(\n        'request_failed',\n        'The message request failed. Retry the request.'\n      );\n    }\n    context.signal.throwIfAborted();\n    try {\n      return entry.contract.output(result, payload as never);\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  return { dispatch };\n}\n\nexport type DataQueryRoute<Operations extends OperationContracts> =\n  MessageRoute<DataQueryInput<Operations>, TransportResponse> & {\n    operations: Operations | undefined;\n  };\nexport type MessageOutput<Route extends MessageRoutes[string], Input> =\n  Route extends DataQueryRoute<infer Operations>\n    ? Input extends { operation: infer Name extends keyof Operations }\n      ? TransportResponse<DataQueryBody<OutputOf<Operations[Name]>>>\n      : never\n    : ReturnType<Route['output']>;\n\n/** Omit contracts only in generic hosts such as the CLI shell, where Bun validates operations. */\nexport function defineDataQueryRoute<\n  Operations extends OperationContracts = OperationContracts,\n>(operations?: Operations): DataQueryRoute<Operations> {\n  return {\n    operations,\n    input(value) {\n      if (!value || typeof value !== 'object')\n        throw new Error('Invalid query.');\n      const request = value as { operation?: unknown; input?: unknown };\n      if (\n        typeof request.operation !== 'string' ||\n        !request.operation ||\n        request.operation.length > 256 ||\n        request.operation.includes('/')\n      )\n        throw new Error('Invalid operation.');\n      const operation =\n        operations && Object.hasOwn(operations, request.operation)\n          ? operations[request.operation]\n          : undefined;\n      if (operations && !operation) throw new Error('Unknown operation.');\n\n      return {\n        operation: request.operation,\n        input: operation ? operation.input(request.input) : request.input,\n      } as DataQueryInput<Operations>;\n    },\n    output(value, input) {\n      if (!value || typeof value !== 'object')\n        throw new Error('Invalid data response.');\n      const response = value as TransportResponse;\n      if (\n        !Number.isInteger(response.status) ||\n        response.status < 100 ||\n        response.status > 599 ||\n        !response.body ||\n        typeof response.body !== 'object' ||\n        Array.isArray(response.body)\n      )\n        throw new Error('Invalid data response.');\n      const body = response.body as DataQueryBody<unknown> & {\n        error?: { code?: unknown; message?: unknown; requestId?: unknown };\n      };\n      if (response.status < 200 || response.status >= 300) {\n        const failure = body.error;\n        throw new MessageRoutingError(\n          typeof failure?.code === 'string' ? failure.code : 'request_failed',\n          typeof failure?.message === 'string'\n            ? failure.message\n            : 'Could not load data.',\n          typeof failure?.requestId === 'string' ? failure.requestId : undefined\n        );\n      }\n      if (\n        !('data' in body) ||\n        typeof body.requestId !== 'string' ||\n        typeof body.queriedAt !== 'string' ||\n        !Array.isArray(body.queryIds) ||\n        !body.queryIds.every(id => typeof id === 'string')\n      )\n        throw new Error('Invalid data envelope.');\n      if (\n        body.queries !== undefined &&\n        (!Array.isArray(body.queries) ||\n          !body.queries.every(\n            query =>\n              query &&\n              typeof query === 'object' &&\n              typeof query.name === 'string' &&\n              typeof query.statement === 'string' &&\n              (query.params === undefined || isQueryParameters(query.params)) &&\n              (query.queryId === undefined || typeof query.queryId === 'string')\n          ))\n      )\n        throw new Error('Invalid query evidence.');\n      const operation = operations?.[input.operation];\n\n      return {\n        status: response.status,\n        body: {\n          ...body,\n          data: operation ? operation.output(body.data) : body.data,\n        },\n      };\n    },\n  };\n}\n\nexport const navigationUpdateRoute = /* @__PURE__ */ defineMessageRoute({\n  input(value: unknown): NavigationUpdate {\n    if (!value || typeof value !== 'object')\n      throw new Error('Invalid navigation.');\n    const input = value as NavigationUpdate;\n    if (\n      !validLocation(input) ||\n      (input.mode !== 'push' && input.mode !== 'replace') ||\n      (input.title !== undefined &&\n        (typeof input.title !== 'string' || input.title.length > 512))\n    )\n      throw new Error('Invalid navigation.');\n\n    return {\n      search: input.search,\n      hash: input.hash,\n      mode: input.mode,\n      ...(input.title === undefined ? {} : { title: input.title }),\n    };\n  },\n  output(value: unknown): null {\n    if (value !== null) throw new Error('Invalid navigation response.');\n\n    return null;\n  },\n});\nexport type SqlQueryInput = {\n  statement: string;\n  limit: number;\n  params?: QueryParameters;\n};\n\n/** SQL delivery for browser-owned operations. Hosts must enforce backend access and resource limits. */\nexport const sqlQueryRoute = defineMessageRoute({\n  input(value: unknown): SqlQueryInput {\n    if (!value || typeof value !== 'object')\n      throw new Error('Invalid SQL query.');\n    const query = value as {\n      statement?: unknown;\n      limit?: unknown;\n      params?: unknown;\n    };\n    if (\n      typeof query.statement !== 'string' ||\n      !query.statement.trim() ||\n      typeof query.limit !== 'number' ||\n      !Number.isSafeInteger(query.limit) ||\n      query.limit < 1 ||\n      (query.params !== undefined && !isQueryParameters(query.params))\n    )\n      throw new Error('Invalid SQL query.');\n\n    return {\n      statement: query.statement,\n      limit: query.limit,\n      ...(query.params === undefined\n        ? {}\n        : { params: query.params as QueryParameters }),\n    };\n  },\n  output(value: unknown, input: SqlQueryInput): QueryResult {\n    if (!value || typeof value !== 'object')\n      throw new Error('Invalid query result.');\n    const result = value as QueryResult;\n    if (\n      !Array.isArray(result.columns) ||\n      !result.columns.every(\n        column =>\n          column &&\n          typeof column.name === 'string' &&\n          (column.type === undefined || typeof column.type === 'string')\n      ) ||\n      !Array.isArray(result.rows) ||\n      result.rows.length > input.limit ||\n      !result.rows.every(\n        row => Array.isArray(row) && row.length === result.columns.length\n      ) ||\n      (result.queryId !== undefined && typeof result.queryId !== 'string')\n    )\n      throw new Error('Invalid query result.');\n\n    return {\n      columns: result.columns,\n      rows: result.rows,\n      ...(result.queryId === undefined ? {} : { queryId: result.queryId }),\n    };\n  },\n});\n\nexport const dataAppRoutes = {\n  'data:query': /* @__PURE__ */ defineDataQueryRoute(),\n  'navigation:update': navigationUpdateRoute,\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "6D70F2841935946464756E2164756E21",
+  "names": []
+}

package/dist/chunks/index-x69p7cv7.js

@@ -0,0 +1,149 @@
+import {
+  DataSourceError2
+} from "./index-ag0cgnvq.js";
+
+// src/core/operation.ts
+async function executeDataOperation(operation, value, {
+  operationName,
+  lakehouse,
+  signal: requestSignal,
+  requestId,
+  queryParams
+}) {
+  requestSignal.throwIfAborted();
+  let input;
+  try {
+    input = operation.input(value);
+  } catch {
+    throw new OperationInputError;
+  }
+  const signal = AbortSignal.any([
+    requestSignal,
+    AbortSignal.timeout(operation.policy.maxDurationMs)
+  ]);
+  const execution = createOperationLakehouse(operation, lakehouse, signal, operationName);
+  try {
+    const output = await runOperation(operation, input, {
+      lakehouse: execution.lakehouse,
+      signal,
+      queryParams
+    });
+    const body = {
+      data: operation.output(output),
+      requestId,
+      queriedAt: new Date().toISOString(),
+      queryIds: execution.queryIds,
+      queries: execution.queries
+    };
+    const serializedBody = JSON.stringify(body);
+    const responseBytes = new TextEncoder().encode(serializedBody).byteLength;
+    if (responseBytes > (operation.policy.maxResponseBytes ?? 1e6))
+      throw new Error("Response exceeds byte limit.");
+    return { body, serializedBody };
+  } catch (error) {
+    if (signal.aborted && !(error instanceof DataSourceError2))
+      throw new OperationTimeoutError;
+    throw error;
+  }
+}
+function createOperationLakehouse(operation, source, signal, operationName) {
+  const queryIds = [];
+  const queries = [];
+  const lakehouse = {
+    async queryAll(statement, options) {
+      if (!Number.isInteger(options.limit) || options.limit < 1)
+        throw new Error("Query needs a positive row limit.");
+      if (operation.queryNames && !Object.values(operation.queryNames).includes(options.name ?? ""))
+        throw new Error(`Query name is not registered for operation ${operationName}.`);
+      const query = {
+        name: options.name ?? `Query ${queries.length + 1}`,
+        statement,
+        ...options.params === undefined ? {} : { params: options.params }
+      };
+      queries.push(query);
+      const limit = Math.min(options.limit, operation.policy.maxQueryRows);
+      let result;
+      try {
+        result = await source.queryAll(statement, {
+          limit,
+          ...options.params === undefined ? {} : { params: options.params },
+          signal: AbortSignal.any([signal, options.signal])
+        });
+      } catch (error) {
+        if (error instanceof DataSourceError2)
+          error.queryName = query.name;
+        throw error;
+      }
+      if (result.rows.length > limit)
+        throw new Error("Result exceeds row limit.");
+      if (result.queryId) {
+        query.queryId = result.queryId;
+        queryIds.push(result.queryId);
+      }
+      return result;
+    }
+  };
+  return { lakehouse, queries, queryIds };
+}
+async function runOperation(operation, input, { lakehouse, signal, queryParams }) {
+  let abort;
+  try {
+    signal.throwIfAborted();
+    const cancelled = new Promise((_, reject) => {
+      function rejectAborted() {
+        reject(new Error("Request aborted."));
+      }
+      abort = rejectAborted;
+      signal.addEventListener("abort", rejectAborted, { once: true });
+      if (signal.aborted)
+        rejectAborted();
+    });
+    return await Promise.race([
+      cancelled,
+      Promise.resolve().then(() => {
+        signal.throwIfAborted();
+        return operation.run({ lakehouse, signal, queryParams }, input);
+      })
+    ]);
+  } finally {
+    if (abort)
+      signal.removeEventListener("abort", abort);
+  }
+}
+
+class OperationTimeoutError extends Error {
+}
+
+class OperationInputError extends Error {
+}
+var sourceErrorMessages = {
+  unauthorized: "This app could not authenticate its data connection. Contact the app owner.",
+  forbidden: "This app cannot access the requested data. Contact the app owner.",
+  rate_limited: "The lakehouse is busy. Wait a moment and retry.",
+  query_rejected: "A lakehouse query was rejected. Check the app's data operation.",
+  unavailable: "The lakehouse is unavailable. Check the connection and retry."
+};
+function toDataOperationFailure(error, aborted = false) {
+  if (error instanceof OperationInputError)
+    return {
+      status: 400,
+      code: "invalid_input",
+      message: "Check this operation's inputs."
+    };
+  if (error instanceof DataSourceError2)
+    return {
+      status: error.reason === "rate_limited" ? 429 : 502,
+      code: `source_${error.reason}`,
+      message: sourceErrorMessages[error.reason]
+    };
+  const timedOut = aborted || error instanceof OperationTimeoutError;
+  return {
+    status: timedOut ? 504 : 502,
+    code: timedOut ? "timeout" : "query_failed",
+    message: timedOut ? "The data request timed out." : "The data request failed."
+  };
+}
+
+export { executeDataOperation, toDataOperationFailure };
+
+//# debugId=9709B0C78964A4A864756E2164756E21

package/dist/chunks/index-x69p7cv7.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/operation.ts"],
+  "sourcesContent": [
+    "import { DataSourceError } from '@/src/core/contract';\nimport type {\n  DataOperations,\n  DisclosedQuery,\n  Lakehouse,\n  OperationContext,\n  DataQueryBody,\n} from '@/src/core/operation-types';\n\ntype Operation = DataOperations[string];\ntype OperationExecutionOptions = {\n  operationName: string;\n  lakehouse: Lakehouse;\n  signal: AbortSignal;\n  requestId: string;\n  queryParams?: OperationContext['queryParams'];\n};\n\n/** Shared operation execution. Adapters own authorization, delivery, and public errors. */\nexport async function executeDataOperation(\n  operation: Operation,\n  value: unknown,\n  {\n    operationName,\n    lakehouse,\n    signal: requestSignal,\n    requestId,\n    queryParams,\n  }: OperationExecutionOptions\n) {\n  requestSignal.throwIfAborted();\n  let input: unknown;\n  try {\n    input = operation.input(value);\n  } catch {\n    throw new OperationInputError();\n  }\n\n  const signal = AbortSignal.any([\n    requestSignal,\n    AbortSignal.timeout(operation.policy.maxDurationMs),\n  ]);\n  const execution = createOperationLakehouse(\n    operation,\n    lakehouse,\n    signal,\n    operationName\n  );\n  try {\n    const output = await runOperation(operation, input, {\n      lakehouse: execution.lakehouse,\n      signal,\n      queryParams,\n    });\n    const body: DataQueryBody<unknown> = {\n      data: operation.output(output),\n      requestId,\n      queriedAt: new Date().toISOString(),\n      queryIds: execution.queryIds,\n      queries: execution.queries,\n    };\n    const serializedBody = JSON.stringify(body);\n    const responseBytes = new TextEncoder().encode(serializedBody).byteLength;\n    if (responseBytes > (operation.policy.maxResponseBytes ?? 1_000_000))\n      throw new Error('Response exceeds byte limit.');\n\n    return { body, serializedBody };\n  } catch (error) {\n    if (signal.aborted && !(error instanceof DataSourceError))\n      throw new OperationTimeoutError();\n    throw error;\n  }\n}\n\n/** Query evidence follows statement invocation order; query IDs retain completion order. */\nfunction createOperationLakehouse(\n  operation: Operation,\n  source: Lakehouse,\n  signal: AbortSignal,\n  operationName: string\n) {\n  const queryIds: string[] = [];\n  const queries: DisclosedQuery[] = [];\n  const lakehouse: Lakehouse = {\n    async queryAll(statement, options) {\n      if (!Number.isInteger(options.limit) || options.limit < 1)\n        throw new Error('Query needs a positive row limit.');\n      if (\n        operation.queryNames &&\n        !Object.values(operation.queryNames).includes(options.name ?? '')\n      )\n        throw new Error(\n          `Query name is not registered for operation ${operationName}.`\n        );\n      const query: DisclosedQuery = {\n        name: options.name ?? `Query ${queries.length + 1}`,\n        statement,\n        ...(options.params === undefined ? {} : { params: options.params }),\n      };\n      queries.push(query);\n      const limit = Math.min(options.limit, operation.policy.maxQueryRows);\n      let result;\n      try {\n        result = await source.queryAll(statement, {\n          limit,\n          ...(options.params === undefined ? {} : { params: options.params }),\n          signal: AbortSignal.any([signal, options.signal]),\n        });\n      } catch (error) {\n        if (error instanceof DataSourceError) error.queryName = query.name;\n        throw error;\n      }\n      if (result.rows.length > limit)\n        throw new Error('Result exceeds row limit.');\n      if (result.queryId) {\n        query.queryId = result.queryId;\n        queryIds.push(result.queryId);\n      }\n\n      return result;\n    },\n  };\n\n  return { lakehouse, queries, queryIds };\n}\n\n/** Settle cancellation even when operation code or its lakehouse ignores the signal. */\nasync function runOperation(\n  operation: Operation,\n  input: unknown,\n  { lakehouse, signal, queryParams }: OperationContext\n) {\n  let abort: (() => void) | undefined;\n  try {\n    signal.throwIfAborted();\n    const cancelled = new Promise<never>((_, reject) => {\n      function rejectAborted() {\n        reject(new Error('Request aborted.'));\n      }\n      abort = rejectAborted;\n      signal.addEventListener('abort', rejectAborted, { once: true });\n      if (signal.aborted) rejectAborted();\n    });\n\n    return await Promise.race([\n      cancelled,\n      Promise.resolve().then(() => {\n        signal.throwIfAborted();\n\n        return operation.run(\n          { lakehouse, signal, queryParams },\n          input as never\n        );\n      }),\n    ]);\n  } finally {\n    if (abort) signal.removeEventListener('abort', abort);\n  }\n}\n\nclass OperationTimeoutError extends Error {}\n\nclass OperationInputError extends Error {}\n\nconst sourceErrorMessages = {\n  unauthorized:\n    'This app could not authenticate its data connection. Contact the app owner.',\n  forbidden:\n    'This app cannot access the requested data. Contact the app owner.',\n  rate_limited: 'The lakehouse is busy. Wait a moment and retry.',\n  query_rejected:\n    \"A lakehouse query was rejected. Check the app's data operation.\",\n  unavailable: 'The lakehouse is unavailable. Check the connection and retry.',\n};\n\nexport function toDataOperationFailure(error: unknown, aborted = false) {\n  if (error instanceof OperationInputError)\n    return {\n      status: 400,\n      code: 'invalid_input',\n      message: \"Check this operation's inputs.\",\n    };\n  if (error instanceof DataSourceError)\n    return {\n      status: error.reason === 'rate_limited' ? 429 : 502,\n      code: `source_${error.reason}`,\n      message: sourceErrorMessages[error.reason],\n    };\n  const timedOut = aborted || error instanceof OperationTimeoutError;\n  return {\n    status: timedOut ? 504 : 502,\n    code: timedOut ? 'timeout' : 'query_failed',\n    message: timedOut\n      ? 'The data request timed out.'\n      : 'The data request failed.',\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "9709B0C78964A4A864756E2164756E21",
+  "names": []
+}

package/dist/client/index.js

@@ -1,10 +1,14 @@
-import"../chunks/contract-mev09s5v.js";
-import"../chunks/contract-yxbjea23.js";
+import"../chunks/index-mev09s5v.js";
+import"../chunks/index-ag0cgnvq.js";
+import {
+  createDataClient2
+} from "../chunks/index-23dktynd.js";
+import"../chunks/index-x69p7cv7.js";
 import {
-  createDataClient2,
   createDataAppNavigation2,
-  getDataAppNavigation2
-} from "../chunks/contract-a061yj6r.js";
+  getDataAppNavigation2,
+  createAnnotationClient2
+} from "../chunks/index-ev2b5aaf.js";
 import {
   DataAppError2,
   createHttpTransport2,
@@ -12,9 +16,10 @@ import {
   createIframeTransport2,
   installDataAppTransport2,
   getDataAppTransport2
-} from "../chunks/contract-sm7j7k95.js";
+} from "../chunks/index-ktmvs916.js";
 export {
   DataAppError2 as DataAppError,
+  createAnnotationClient2 as createAnnotationClient,
   createDataAppNavigation2 as createDataAppNavigation,
   createDataClient2 as createDataClient,
   createHttpTransport2 as createHttpTransport,
@@ -25,4 +30,4 @@ export {
   installDataAppTransport2 as installDataAppTransport
 };
 
-//# debugId=88DF02CCA4F0E63864756E2164756E21
+//# debugId=51C8B2874175323464756E2164756E21

package/dist/client/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "88DF02CCA4F0E63864756E2164756E21",
+  "debugId": "51C8B2874175323464756E2164756E21",
   "names": []
 }

package/dist/core/appearance.js

@@ -3,7 +3,7 @@ import {
   normalizeAppearance2,
   applyAppearance2,
   createThemeController2
-} from "../chunks/contract-txjy0en2.js";
+} from "../chunks/index-m6n8ctfc.js";
 export {
   applyAppearance2 as applyAppearance,
   createThemeController2 as createThemeController,