@altertable/data-app 0.59.1

package/dist/chunks/contract-nt819swq.js

@@ -0,0 +1,321 @@
+import {
+  formatDateRange2
+} from "./contract-mev09s5v.js";
+import {
+  invariant
+} from "./contract-8q35dcyh.js";
+
+// src/core/contract.ts
+import { parseDate, today } from "@internationalized/date";
+
+// src/core/dimension.ts
+var allSelection = { kind: "all" };
+function dimensionMemberKey(member) {
+  return member.kind === "missing" ? "missing" : `value:${typeof member.value}:${member.value}`;
+}
+function dimensionFilter2(config) {
+  const { key, label, selection, valueType } = config;
+  const options = config.options ?? [];
+  invariant(!!config.options !== !!config.facet, "Choose fixed options or one facet operation.");
+  const optionKeys = options.map((option) => dimensionMemberKey({ kind: "value", value: option.value }));
+  invariant(!!key && options.length <= 200 && new Set(optionKeys).size === options.length, "Dimension options need a key, at most 200 distinct values.");
+  invariant(options.every((option) => typeof option.value === valueType && !!option.label.trim() && (option.count === undefined || Number.isSafeInteger(option.count) && option.count >= 0)), "Dimension options need typed values, labels, and nonnegative counts.");
+  const allowed = new Set(optionKeys);
+  const maxSelected = config.maxSelected ?? (selection === "single" ? 1 : 20);
+  invariant(Number.isInteger(maxSelected) && maxSelected >= 1 && maxSelected <= 50 && (selection !== "single" || maxSelected === 1), "Dimension selection limit is invalid.");
+  const allowMissing = config.allowMissing ?? false;
+  const defaultValue = allSelection;
+  function validMember(member) {
+    if (member.kind === "missing")
+      return allowMissing;
+    if (member.kind !== "value" || typeof member.value !== valueType)
+      return false;
+    if (!config.facet)
+      return allowed.has(dimensionMemberKey(member));
+    return typeof member.value === "number" ? Number.isFinite(member.value) : member.value.length <= 100;
+  }
+  function valid(value) {
+    if (!value || typeof value !== "object")
+      return false;
+    if (value.kind === "all")
+      return true;
+    if (value.kind !== "include" || !Array.isArray(value.members) || !value.members.length || value.members.length > maxSelected)
+      return false;
+    const ids = value.members.map(dimensionMemberKey);
+    return new Set(ids).size === ids.length && value.members.every(validMember);
+  }
+  function encode(value) {
+    return value.kind === "all" ? null : JSON.stringify(value.members.map((member) => member.kind === "missing" ? ["m"] : ["v", member.value]));
+  }
+  function parse(raw) {
+    if (raw === null)
+      return defaultValue;
+    if (raw.length > 4096)
+      return defaultValue;
+    try {
+      const tokens = JSON.parse(raw);
+      if (!Array.isArray(tokens))
+        return defaultValue;
+      const value = {
+        kind: "include",
+        members: tokens.map((token) => Array.isArray(token) && token.length === 1 && token[0] === "m" ? { kind: "missing" } : Array.isArray(token) && token.length === 2 && token[0] === "v" ? { kind: "value", value: token[1] } : { kind: "invalid" })
+      };
+      return valid(value) ? value : defaultValue;
+    } catch {
+      return defaultValue;
+    }
+  }
+  return {
+    kind: "dimension",
+    label,
+    valueType,
+    selection,
+    options,
+    facet: config.facet,
+    allowMissing,
+    maxSelected,
+    urlKeys: [key],
+    defaultValue,
+    history: config.history ?? "push",
+    valid,
+    same(left, right) {
+      return encode(left) === encode(right);
+    },
+    read(params) {
+      return parse(params.get(key));
+    },
+    write(value) {
+      return { [key]: encode(value) };
+    },
+    describe(value) {
+      return value.kind === "all" ? `All ${label.toLocaleLowerCase()}` : value.members.map((member) => member.kind === "missing" ? "Missing" : options.find((option) => option.value === member.value)?.label ?? String(member.value)).join(", ");
+    }
+  };
+}
+function parseDimensionSelection2(value, filter) {
+  invariant(filter.valid(value), `Invalid ${filter.label} selection.`);
+  return value;
+}
+function parseFacetOptions2(value, filter) {
+  invariant(Array.isArray(value) && value.length <= 200, "Facet options exceed their bound.");
+  const options = [];
+  const seen = new Set;
+  for (const item of value) {
+    invariant(item && typeof item === "object", "Invalid facet option.");
+    const option = item;
+    invariant(typeof option.value === filter.valueType && filter.valid({
+      kind: "include",
+      members: [{ kind: "value", value: option.value }]
+    }) && typeof option.label === "string" && !!option.label.trim() && option.label.length <= 100 && (option.count === undefined || Number.isSafeInteger(option.count) && option.count >= 0), "Invalid facet option.");
+    const id = dimensionMemberKey({ kind: "value", value: option.value });
+    invariant(!seen.has(id), "Duplicate facet option.");
+    seen.add(id);
+    options.push(option);
+  }
+  return options;
+}
+function dimensionPredicate2(column, selection, allowedColumns) {
+  invariant(allowedColumns.includes(column) && /^[A-Za-z_][A-Za-z_0-9]*(?:\.[A-Za-z_][A-Za-z_0-9]*)*$/.test(column), "Invalid dimension column.");
+  if (selection.kind === "all")
+    return "";
+  invariant(selection.members.length > 0, "Empty dimension inclusion is invalid.");
+  const values = selection.members.filter((member) => member.kind === "value");
+  const missing = selection.members.some((member) => member.kind === "missing");
+  const literals = values.map(({ value }) => {
+    if (typeof value === "number") {
+      invariant(Number.isFinite(value), "Invalid numeric dimension value.");
+      return String(value);
+    }
+    const text = value;
+    for (let index = 0;index < text.length; index++)
+      invariant(text.charCodeAt(index) >= 32 && text.charCodeAt(index) !== 127, "Invalid control character in dimension value.");
+    return `'${text.replaceAll("'", "''")}'`;
+  });
+  const clauses = [
+    ...literals.length ? [`${column} IN (${literals.join(", ")})`] : [],
+    ...missing ? [`${column} IS NULL`] : []
+  ];
+  return `(${clauses.join(" OR ")})`;
+}
+
+// src/core/contract.ts
+function parseEmptyInput2(value) {
+  invariant(typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 0, "This operation takes no inputs.");
+  return {};
+}
+function parseTrue2(value) {
+  invariant(value === true, "Expected a successful check.");
+  return true;
+}
+function previousDateRange2({
+  start,
+  end
+}) {
+  const first = parseDate(start);
+  const last = parseDate(end);
+  const days = (last.toDate("UTC").getTime() - first.toDate("UTC").getTime()) / 86400000 + 1;
+  invariant(days >= 1, "Date range must start before it ends.");
+  const previousEnd = first.subtract({ days: 1 });
+  return {
+    start: previousEnd.subtract({ days: days - 1 }).toString(),
+    end: previousEnd.toString()
+  };
+}
+function defineDateRangeContract2(options) {
+  invariant(Number.isInteger(options.maxRangeDays) && options.maxRangeDays > 0, "Date range needs a positive maxRangeDays.");
+  if (options.minDate)
+    parseDate(options.minDate);
+  if (typeof options.maxDate === "string")
+    parseDate(options.maxDate);
+  today(options.timeZone);
+  function bounds() {
+    const latest = today(options.timeZone).subtract({
+      days: options.completeDays === false ? 0 : 1
+    });
+    const sourceMax = typeof options.maxDate === "function" ? options.maxDate() : options.maxDate;
+    const maxDate = sourceMax && parseDate(sourceMax).compare(latest) < 0 ? parseDate(sourceMax).toString() : latest.toString();
+    return {
+      minDate: options.minDate,
+      maxDate,
+      maxRangeDays: options.maxRangeDays,
+      timeZone: options.timeZone
+    };
+  }
+  function period({ start, end }) {
+    return {
+      kind: "calendar",
+      start,
+      end,
+      timeZone: options.timeZone
+    };
+  }
+  function describeInput(input) {
+    return `${formatDateRange2(input)} ${options.timeZone}`;
+  }
+  function comparison(input) {
+    const previous = previousDateRange2(input);
+    return options.minDate && previous.start < options.minDate ? null : previous;
+  }
+  function request(value, compare = false) {
+    const range = parseDateRangeInput2(value, bounds());
+    const previous = compare ? comparison(range) : null;
+    invariant(!compare || previous, "Comparison is outside available source coverage.");
+    return { range, comparison: previous };
+  }
+  function parseRequest(value) {
+    invariant(value && typeof value === "object", "Choose a date range.");
+    const input = value;
+    const parsed = request(input.range, input.comparison != null);
+    if (input.comparison != null) {
+      const supplied = parseDateRangeInput2(input.comparison, bounds());
+      invariant(supplied.start === parsed.comparison?.start && supplied.end === parsed.comparison?.end, "Comparison must be the preceding equal-length range.");
+    }
+    return parsed;
+  }
+  return {
+    request,
+    parseRequest,
+    bounds,
+    parse(value) {
+      return parseDateRangeInput2(value, bounds());
+    },
+    period,
+    comparison,
+    describeInput,
+    view: { period, describeInput }
+  };
+}
+function parseDateRangeInput2(value, {
+  minDate,
+  maxDate,
+  maxRangeDays
+}) {
+  invariant(value && typeof value === "object" && !Array.isArray(value), "Choose a date range.");
+  const { start, end } = value;
+  function day(input) {
+    invariant(typeof input === "string" && /^\d{4}-\d{2}-\d{2}$/.test(input), "Dates must be YYYY-MM-DD.");
+    const timestamp = Date.parse(`${input}T00:00:00Z`);
+    invariant(Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 10) === input, "Choose valid calendar dates.");
+    return timestamp;
+  }
+  const first = day(start);
+  const last = day(end);
+  invariant(Number.isInteger(maxRangeDays) && maxRangeDays > 0, "Maximum range days must be positive.");
+  invariant(first <= last && (last - first) / 86400000 < maxRangeDays && (minDate === undefined || first >= day(minDate)) && (maxDate === undefined || last <= day(maxDate)), `Choose up to ${maxRangeDays} days within the available range.`);
+  return { start, end };
+}
+function parseCount2(value) {
+  const number = typeof value === "number" || typeof value === "string" ? Number(value) : NaN;
+  invariant(Number.isSafeInteger(number) && number >= 0 && (typeof value !== "string" || !!value.trim()), "Invalid count in query result.");
+  return number;
+}
+function parseLabel2(value, maxLength = 100) {
+  invariant(typeof value === "string" && !!value && value.length <= maxLength, "Invalid label in query result.");
+  return value;
+}
+function rowsAsRecords2(result, requiredColumns) {
+  const names = result.columns.map((column) => column.name);
+  invariant(new Set(names).size === names.length && requiredColumns.every((name) => names.includes(name)), "Query result columns do not match the expected shape.");
+  return result.rows.map((row) => {
+    invariant(row.length === names.length, "Query result row has the wrong width.");
+    return Object.fromEntries(names.map((name, index) => [name, row[index]]));
+  });
+}
+function defineQueryNames2(names) {
+  const values = Object.values(names);
+  invariant(values.every((name) => !!name.trim()) && new Set(values).size === values.length, "Query names must be nonempty and unique.");
+  return names;
+}
+
+class DataSourceError2 extends Error {
+  reason;
+  status;
+  queryName;
+  constructor(reason, status) {
+    super(`Data source ${reason}${status ? ` (${status})` : ""}.`);
+    this.reason = reason;
+    this.status = status;
+    this.name = "DataSourceError";
+  }
+}
+function defineOperation2(operation) {
+  invariant(Array.isArray(operation.checks) && operation.checks.length > 0 && Number.isInteger(operation.policy.maxQueryRows) && operation.policy.maxQueryRows > 0 && Number.isInteger(operation.policy.maxDurationMs) && operation.policy.maxDurationMs > 0 && (operation.policy.maxResponseBytes === undefined || Number.isInteger(operation.policy.maxResponseBytes) && operation.policy.maxResponseBytes > 0), "Each data operation needs check inputs and positive row and duration limits.");
+  if (operation.queryNames)
+    defineQueryNames2(operation.queryNames);
+  for (const input of operation.checks)
+    operation.input(input);
+  return {
+    ...operation,
+    run(context, input) {
+      function query(name, statement, options) {
+        invariant(operation.queryNames && Object.values(operation.queryNames).includes(name), `Unknown query name: ${name}.`);
+        return context.lakehouse.queryAll(statement, {
+          name,
+          limit: options?.limit ?? operation.policy.maxQueryRows,
+          signal: context.signal
+        });
+      }
+      return operation.run({ ...context, query }, input);
+    }
+  };
+}
+var connectionQueryNames2 = defineQueryNames2({
+  connection: "connection-check"
+});
+function connectionCheck2() {
+  return defineOperation2({
+    input: parseEmptyInput2,
+    output: parseTrue2,
+    checks: [{}],
+    queryNames: connectionQueryNames2,
+    policy: { maxQueryRows: 1, maxDurationMs: 15000, exposeSql: true },
+    async run({ query }) {
+      await query(connectionQueryNames2.connection, "SELECT 1 AS connection_check");
+      return true;
+    }
+  });
+}
+
+export { dimensionMemberKey, dimensionFilter2, parseDimensionSelection2, parseFacetOptions2, dimensionPredicate2, parseEmptyInput2, parseTrue2, previousDateRange2, defineDateRangeContract2, parseDateRangeInput2, parseCount2, parseLabel2, rowsAsRecords2, defineQueryNames2, DataSourceError2, defineOperation2, connectionQueryNames2, connectionCheck2 };
+
+//# debugId=65216D55145AC13D64756E2164756E21

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

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/contract.ts", "../src/core/dimension.ts"],
+  "sourcesContent": [
+    "/**\n * Shared operation contracts and input/output validation for browser and server.\n * @module @altertable/data-app/contract\n * @see https://github.com/altertable-ai/data-app/blob/main/docs/contract.md\n */\nimport { parseDate, today } from '@internationalized/date';\nimport { formatDateRange } from '@/src/core/format';\nimport { invariant } from '@/src/core/invariant';\n\nexport type QueryResult = {\n  columns: { name: string; type?: string }[];\n  rows: unknown[][];\n  queryId?: string;\n};\n\nexport function parseEmptyInput(value: unknown): Record<string, never> {\n  invariant(\n    typeof value === 'object' &&\n      value !== null &&\n      !Array.isArray(value) &&\n      Object.keys(value).length === 0,\n    'This operation takes no inputs.'\n  );\n\n  return {};\n}\n\nexport function parseTrue(value: unknown): true {\n  invariant(value === true, 'Expected a successful check.');\n\n  return true;\n}\n\nexport type DateRangeInput = { start: string; end: string };\nexport type DateRangeRequest = {\n  range: DateRangeInput;\n  comparison: DateRangeInput | null;\n};\n\n/** The immediately preceding, equally long set of calendar days. */\nexport function previousDateRange({\n  start,\n  end,\n}: DateRangeInput): DateRangeInput {\n  const first = parseDate(start);\n  const last = parseDate(end);\n  const days =\n    (last.toDate('UTC').getTime() - first.toDate('UTC').getTime()) /\n      86_400_000 +\n    1;\n  invariant(days >= 1, 'Date range must start before it ends.');\n  const previousEnd = first.subtract({ days: 1 });\n\n  return {\n    start: previousEnd.subtract({ days: days - 1 }).toString(),\n    end: previousEnd.toString(),\n  };\n}\n\nexport type ReportingPeriod =\n  | { kind: 'rolling'; amount: number; unit: 'hour' | 'day'; end: string }\n  | { kind: 'calendar'; start: string; end: string; timeZone: string };\n\nexport type DateRangeContractOptions = {\n  minDate?: string;\n  maxDate?: string | (() => string);\n  maxRangeDays: number;\n  timeZone: string;\n  completeDays?: boolean;\n};\n\n/** One source policy for the server parser, URL variable, and displayed reporting period. */\nexport function defineDateRangeContract(options: DateRangeContractOptions) {\n  invariant(\n    Number.isInteger(options.maxRangeDays) && options.maxRangeDays > 0,\n    'Date range needs a positive maxRangeDays.'\n  );\n  if (options.minDate) parseDate(options.minDate);\n  if (typeof options.maxDate === 'string') parseDate(options.maxDate);\n  today(options.timeZone);\n\n  function bounds() {\n    const latest = today(options.timeZone).subtract({\n      days: options.completeDays === false ? 0 : 1,\n    });\n    const sourceMax =\n      typeof options.maxDate === 'function'\n        ? options.maxDate()\n        : options.maxDate;\n    const maxDate =\n      sourceMax && parseDate(sourceMax).compare(latest) < 0\n        ? parseDate(sourceMax).toString()\n        : latest.toString();\n\n    return {\n      minDate: options.minDate,\n      maxDate,\n      maxRangeDays: options.maxRangeDays,\n      timeZone: options.timeZone,\n    };\n  }\n\n  function period({ start, end }: DateRangeInput): ReportingPeriod {\n    return {\n      kind: 'calendar',\n      start,\n      end,\n      timeZone: options.timeZone,\n    };\n  }\n\n  function describeInput(input: DateRangeInput) {\n    return `${formatDateRange(input)} ${options.timeZone}`;\n  }\n\n  function comparison(input: DateRangeInput): DateRangeInput | null {\n    const previous = previousDateRange(input);\n\n    return options.minDate && previous.start < options.minDate\n      ? null\n      : previous;\n  }\n\n  function request(value: unknown, compare = false): DateRangeRequest {\n    const range = parseDateRangeInput(value, bounds());\n    const previous = compare ? comparison(range) : null;\n    invariant(\n      !compare || previous,\n      'Comparison is outside available source coverage.'\n    );\n\n    return { range, comparison: previous };\n  }\n\n  function parseRequest(value: unknown): DateRangeRequest {\n    invariant(value && typeof value === 'object', 'Choose a date range.');\n    const input = value as Record<string, unknown>;\n    const parsed = request(input.range, input.comparison != null);\n    if (input.comparison != null) {\n      const supplied = parseDateRangeInput(input.comparison, bounds());\n      invariant(\n        supplied.start === parsed.comparison?.start &&\n          supplied.end === parsed.comparison?.end,\n        'Comparison must be the preceding equal-length range.'\n      );\n    }\n\n    return parsed;\n  }\n\n  return {\n    request,\n    parseRequest,\n    bounds,\n    parse(value: unknown) {\n      return parseDateRangeInput(value, bounds());\n    },\n    period,\n    comparison,\n    describeInput,\n    view: { period, describeInput },\n  };\n}\n\nexport type DateRangeContract = ReturnType<typeof defineDateRangeContract>;\n\n/** Validate calendar dates and a bounded inclusive range on the server. */\nexport function parseDateRangeInput(\n  value: unknown,\n  {\n    minDate,\n    maxDate,\n    maxRangeDays,\n  }: { minDate?: string; maxDate?: string; maxRangeDays: number }\n): DateRangeInput {\n  invariant(\n    value && typeof value === 'object' && !Array.isArray(value),\n    'Choose a date range.'\n  );\n  const { start, end } = value as Record<string, unknown>;\n\n  function day(input: unknown): number {\n    invariant(\n      typeof input === 'string' && /^\\d{4}-\\d{2}-\\d{2}$/.test(input),\n      'Dates must be YYYY-MM-DD.'\n    );\n    const timestamp = Date.parse(`${input}T00:00:00Z`);\n    invariant(\n      Number.isFinite(timestamp) &&\n        new Date(timestamp).toISOString().slice(0, 10) === input,\n      'Choose valid calendar dates.'\n    );\n\n    return timestamp;\n  }\n  const first = day(start);\n  const last = day(end);\n  invariant(\n    Number.isInteger(maxRangeDays) && maxRangeDays > 0,\n    'Maximum range days must be positive.'\n  );\n  invariant(\n    first <= last &&\n      (last - first) / 86_400_000 < maxRangeDays &&\n      (minDate === undefined || first >= day(minDate)) &&\n      (maxDate === undefined || last <= day(maxDate)),\n    `Choose up to ${maxRangeDays} days within the available range.`\n  );\n\n  return { start: start as string, end: end as string };\n}\n\n/** Accepts numeric strings from DuckDB; rejects negative, fractional, and unsafe integers. */\nexport function parseCount(value: unknown): number {\n  const number =\n    typeof value === 'number' || typeof value === 'string'\n      ? Number(value)\n      : NaN;\n  invariant(\n    Number.isSafeInteger(number) &&\n      number >= 0 &&\n      (typeof value !== 'string' || !!value.trim()),\n    'Invalid count in query result.'\n  );\n\n  return number;\n}\n\nexport function parseLabel(value: unknown, maxLength = 100): string {\n  invariant(\n    typeof value === 'string' && !!value && value.length <= maxLength,\n    'Invalid label in query result.'\n  );\n\n  return value;\n}\n\n/** Rejects missing or duplicate columns and rows whose width differs from the column list. */\nexport function rowsAsRecords(\n  result: QueryResult,\n  requiredColumns: readonly string[]\n): Record<string, unknown>[] {\n  const names = result.columns.map(column => column.name);\n  invariant(\n    new Set(names).size === names.length &&\n      requiredColumns.every(name => names.includes(name)),\n    'Query result columns do not match the expected shape.'\n  );\n\n  return result.rows.map(row => {\n    invariant(\n      row.length === names.length,\n      'Query result row has the wrong width.'\n    );\n\n    return Object.fromEntries(names.map((name, index) => [name, row[index]]));\n  });\n}\n\n/** One named statement an operation ran. Returned only when SQL disclosure is allowed. */\nexport type DisclosedQuery = {\n  name: string;\n  statement: string;\n  queryId?: string;\n};\n\nexport function defineQueryNames<const Names extends Record<string, string>>(\n  names: Names\n): Names {\n  const values = Object.values(names);\n  invariant(\n    values.every(name => !!name.trim()) &&\n      new Set(values).size === values.length,\n    'Query names must be nonempty and unique.'\n  );\n\n  return names;\n}\n\nexport class DataSourceError extends Error {\n  queryName?: string;\n\n  constructor(\n    public readonly reason:\n      | 'unauthorized'\n      | 'forbidden'\n      | 'rate_limited'\n      | 'query_rejected'\n      | 'unavailable',\n    public readonly status?: number\n  ) {\n    super(`Data source ${reason}${status ? ` (${status})` : ''}.`);\n    this.name = 'DataSourceError';\n  }\n}\n\n/** Server-only query interface supplied by a local or hosted adapter. */\nexport type Lakehouse = {\n  queryAll(\n    statement: string,\n    options: { limit: number; signal: AbortSignal; name?: string }\n  ): Promise<QueryResult>;\n};\n\nexport type OperationContext = { lakehouse: Lakehouse; signal: AbortSignal };\n\n/**\n * Both parsers run on the server before results cross the JSON boundary. Schema libraries can be\n * used inside either parser.\n */\nexport type DataOperation<Input, Output> = {\n  input: (value: unknown) => Input;\n  output: (value: unknown) => Output;\n  run: (context: OperationContext, input: Input) => Promise<Output>;\n  checks: readonly Input[];\n  queryNames?: Readonly<Record<string, string>>;\n  policy: {\n    maxQueryRows: number;\n    maxDurationMs: number;\n    maxResponseBytes?: number;\n    exposeSql?: boolean;\n  };\n};\n\nexport type OperationQuery<Names extends Readonly<Record<string, string>>> = (\n  name: Names[keyof Names],\n  statement: string,\n  options?: { limit?: number }\n) => Promise<QueryResult>;\n\nexport function defineOperation<\n  Input,\n  Output,\n  const Names extends Readonly<Record<string, string>> = Record<string, never>,\n>(\n  operation: Omit<DataOperation<Input, Output>, 'run' | 'queryNames'> & {\n    queryNames?: Names;\n    run: (\n      context: OperationContext & { query: OperationQuery<NoInfer<Names>> },\n      input: Input\n    ) => Promise<Output>;\n  }\n): DataOperation<Input, Output> & { queryNames?: Names } {\n  invariant(\n    Array.isArray(operation.checks) &&\n      operation.checks.length > 0 &&\n      Number.isInteger(operation.policy.maxQueryRows) &&\n      operation.policy.maxQueryRows > 0 &&\n      Number.isInteger(operation.policy.maxDurationMs) &&\n      operation.policy.maxDurationMs > 0 &&\n      (operation.policy.maxResponseBytes === undefined ||\n        (Number.isInteger(operation.policy.maxResponseBytes) &&\n          operation.policy.maxResponseBytes > 0)),\n    'Each data operation needs check inputs and positive row and duration limits.'\n  );\n  if (operation.queryNames) defineQueryNames(operation.queryNames);\n  for (const input of operation.checks) operation.input(input);\n\n  return {\n    ...operation,\n    run(context, input) {\n      function query(\n        name: Names[keyof Names],\n        statement: string,\n        options?: { limit?: number }\n      ): Promise<QueryResult> {\n        invariant(\n          operation.queryNames &&\n            Object.values(operation.queryNames).includes(name),\n          `Unknown query name: ${name}.`\n        );\n\n        return context.lakehouse.queryAll(statement, {\n          name,\n          limit: options?.limit ?? operation.policy.maxQueryRows,\n          signal: context.signal,\n        });\n      }\n\n      return operation.run({ ...context, query }, input);\n    },\n  };\n}\n\nexport const connectionQueryNames = defineQueryNames({\n  connection: 'connection-check',\n});\n\n/** Success requires a bounded SQL query; it does not establish access to a particular dataset. */\nexport function connectionCheck(): DataOperation<Record<string, never>, true> {\n  return defineOperation({\n    input: parseEmptyInput,\n    output: parseTrue,\n    checks: [{}],\n    queryNames: connectionQueryNames,\n    policy: { maxQueryRows: 1, maxDurationMs: 15_000, exposeSql: true },\n    async run({ query }): Promise<true> {\n      await query(\n        connectionQueryNames.connection,\n        'SELECT 1 AS connection_check'\n      );\n\n      return true;\n    },\n  });\n}\n\nexport type DataOperations = Record<\n  string,\n  {\n    input: (value: unknown) => unknown;\n    output: (value: unknown) => unknown;\n    run: (context: OperationContext, input: never) => Promise<unknown>;\n    checks: readonly unknown[];\n    queryNames?: Readonly<Record<string, string>>;\n    policy: DataOperation<never, unknown>['policy'];\n  }\n>;\nexport {\n  dimensionFilter,\n  parseDimensionSelection,\n  parseFacetOptions,\n  dimensionPredicate,\n} from '@/src/core/dimension';\nexport type {\n  DimensionSelection,\n  DimensionMember,\n  DimensionOption,\n  DimensionVariable,\n  DimensionFilterOptions,\n} from '@/src/core/dimension';\n\nexport * from '@/src/core/messages';\nexport type { TransportResponse } from '@/src/core/bridge';\n",
+    "import type { AppVariable, HistoryMode } from '@/src/core/variables';\nimport { invariant } from '@/src/core/invariant';\n\nexport type DimensionValue = string | number;\nexport type DimensionMember<T extends DimensionValue = DimensionValue> =\n  | { kind: 'value'; value: T }\n  | { kind: 'missing' };\nexport type DimensionSelection<T extends DimensionValue = DimensionValue> =\n  | { kind: 'all' }\n  | { kind: 'include'; members: readonly DimensionMember<T>[] };\nexport type DimensionOption<T extends DimensionValue = DimensionValue> = {\n  value: T;\n  label: string;\n  count?: number;\n};\nexport type DimensionVariable<T extends DimensionValue = DimensionValue> = Omit<\n  AppVariable<DimensionSelection<T>, 'dimension'>,\n  'options'\n> & {\n  label: string;\n  selection: 'single' | 'multiple';\n  valueType: 'string' | 'number';\n  allowMissing: boolean;\n  maxSelected: number;\n  options: readonly DimensionOption<T>[];\n  facet?: {\n    operation: string;\n    input: (values: Record<string, unknown>) => unknown;\n  };\n  describe: (selection: DimensionSelection<T>) => string;\n};\n\nconst allSelection: DimensionSelection<never> = { kind: 'all' };\n\nexport function dimensionMemberKey(member: DimensionMember) {\n  return member.kind === 'missing'\n    ? 'missing'\n    : `value:${typeof member.value}:${member.value}`;\n}\n\nexport type DimensionFilterOptions<T extends DimensionValue> = {\n  key: string;\n  label: string;\n  valueType: T extends number ? 'number' : 'string';\n  selection: 'single' | 'multiple';\n  allowMissing?: boolean;\n  maxSelected?: number;\n  history?: HistoryMode;\n} & (\n  | { options: readonly DimensionOption<T>[]; facet?: never }\n  | {\n      /** A bounded operation supplies options and counts; input chooses other filters affecting counts. */\n      facet: {\n        operation: string;\n        input: (values: Record<string, unknown>) => unknown;\n      };\n      options?: never;\n    }\n);\n\n/** A bounded categorical filter. URL tags distinguish missing from literal \"null\". */\nexport function dimensionFilter<const T extends DimensionValue>(\n  config: DimensionFilterOptions<T>\n): DimensionVariable<T> {\n  const { key, label, selection, valueType } = config;\n  const options = config.options ?? [];\n  invariant(\n    !!config.options !== !!config.facet,\n    'Choose fixed options or one facet operation.'\n  );\n  const optionKeys = options.map(option =>\n    dimensionMemberKey({ kind: 'value', value: option.value })\n  );\n  invariant(\n    !!key &&\n      options.length <= 200 &&\n      new Set(optionKeys).size === options.length,\n    'Dimension options need a key, at most 200 distinct values.'\n  );\n  invariant(\n    options.every(\n      option =>\n        typeof option.value === valueType &&\n        !!option.label.trim() &&\n        (option.count === undefined ||\n          (Number.isSafeInteger(option.count) && option.count >= 0))\n    ),\n    'Dimension options need typed values, labels, and nonnegative counts.'\n  );\n  const allowed = new Set(optionKeys);\n  const maxSelected = config.maxSelected ?? (selection === 'single' ? 1 : 20);\n  invariant(\n    Number.isInteger(maxSelected) &&\n      maxSelected >= 1 &&\n      maxSelected <= 50 &&\n      (selection !== 'single' || maxSelected === 1),\n    'Dimension selection limit is invalid.'\n  );\n  const allowMissing = config.allowMissing ?? false;\n  const defaultValue = allSelection;\n\n  function validMember(member: DimensionMember<T>): boolean {\n    if (member.kind === 'missing') return allowMissing;\n    if (member.kind !== 'value' || typeof member.value !== valueType)\n      return false;\n    if (!config.facet) return allowed.has(dimensionMemberKey(member));\n\n    return typeof member.value === 'number'\n      ? Number.isFinite(member.value)\n      : member.value.length <= 100;\n  }\n\n  function valid(value: DimensionSelection<T>): boolean {\n    if (!value || typeof value !== 'object') return false;\n    if (value.kind === 'all') return true;\n    if (\n      value.kind !== 'include' ||\n      !Array.isArray(value.members) ||\n      !value.members.length ||\n      value.members.length > maxSelected\n    )\n      return false;\n    const ids = value.members.map(dimensionMemberKey);\n\n    return new Set(ids).size === ids.length && value.members.every(validMember);\n  }\n\n  function encode(value: DimensionSelection<T>) {\n    return value.kind === 'all'\n      ? null\n      : JSON.stringify(\n          value.members.map(member =>\n            member.kind === 'missing' ? ['m'] : ['v', member.value]\n          )\n        );\n  }\n\n  function parse(raw: string | null): DimensionSelection<T> {\n    if (raw === null) return defaultValue;\n    if (raw.length > 4096) return defaultValue;\n    try {\n      const tokens = JSON.parse(raw);\n      if (!Array.isArray(tokens)) return defaultValue;\n      const value = {\n        kind: 'include' as const,\n        members: tokens.map(token =>\n          Array.isArray(token) && token.length === 1 && token[0] === 'm'\n            ? { kind: 'missing' as const }\n            : Array.isArray(token) && token.length === 2 && token[0] === 'v'\n              ? { kind: 'value' as const, value: token[1] as T }\n              : { kind: 'invalid' as const }\n        ),\n      };\n\n      return valid(value as DimensionSelection<T>)\n        ? (value as DimensionSelection<T>)\n        : defaultValue;\n    } catch {\n      return defaultValue;\n    }\n  }\n\n  return {\n    kind: 'dimension',\n    label,\n    valueType,\n    selection,\n    options,\n    facet: config.facet,\n    allowMissing,\n    maxSelected,\n    urlKeys: [key],\n    defaultValue,\n    history: config.history ?? 'push',\n    valid,\n    same(left, right) {\n      return encode(left) === encode(right);\n    },\n    read(params) {\n      return parse(params.get(key));\n    },\n    write(value) {\n      return { [key]: encode(value) };\n    },\n    describe(value) {\n      return value.kind === 'all'\n        ? `All ${label.toLocaleLowerCase()}`\n        : value.members\n            .map(member =>\n              member.kind === 'missing'\n                ? 'Missing'\n                : (options.find(option => option.value === member.value)\n                    ?.label ?? String(member.value))\n            )\n            .join(', ');\n    },\n  };\n}\n\n/** Server-side parser; call from the operation input parser before building SQL. */\nexport function parseDimensionSelection<T extends DimensionValue>(\n  value: unknown,\n  filter: DimensionVariable<T>\n): DimensionSelection<T> {\n  invariant(\n    filter.valid(value as DimensionSelection<T>),\n    `Invalid ${filter.label} selection.`\n  );\n\n  return value as DimensionSelection<T>;\n}\n\n/** Validate bounded facet results before showing them in a picker. */\nexport function parseFacetOptions<T extends DimensionValue>(\n  value: unknown,\n  filter: DimensionVariable<T>\n): DimensionOption<T>[] {\n  invariant(\n    Array.isArray(value) && value.length <= 200,\n    'Facet options exceed their bound.'\n  );\n  const options: DimensionOption<T>[] = [];\n  const seen = new Set<string>();\n  for (const item of value) {\n    invariant(item && typeof item === 'object', 'Invalid facet option.');\n    const option = item as DimensionOption<T>;\n    invariant(\n      typeof option.value === filter.valueType &&\n        filter.valid({\n          kind: 'include',\n          members: [{ kind: 'value', value: option.value }],\n        }) &&\n        typeof option.label === 'string' &&\n        !!option.label.trim() &&\n        option.label.length <= 100 &&\n        (option.count === undefined ||\n          (Number.isSafeInteger(option.count) && option.count >= 0)),\n      'Invalid facet option.'\n    );\n    const id = dimensionMemberKey({ kind: 'value', value: option.value });\n    invariant(!seen.has(id), 'Duplicate facet option.');\n    seen.add(id);\n    options.push(option);\n  }\n\n  return options;\n}\n\n/** Central SQL literal encoding for transports without bound parameters. Column is an allowlisted identifier. */\nexport function dimensionPredicate<\n  T extends DimensionValue,\n  const Columns extends readonly string[],\n>(\n  column: Columns[number],\n  selection: DimensionSelection<T>,\n  allowedColumns: Columns\n): string {\n  invariant(\n    allowedColumns.includes(column) &&\n      /^[A-Za-z_][A-Za-z_0-9]*(?:\\.[A-Za-z_][A-Za-z_0-9]*)*$/.test(column),\n    'Invalid dimension column.'\n  );\n  if (selection.kind === 'all') return '';\n  invariant(\n    selection.members.length > 0,\n    'Empty dimension inclusion is invalid.'\n  );\n  const values = selection.members.filter(\n    (member): member is Extract<DimensionMember<T>, { kind: 'value' }> =>\n      member.kind === 'value'\n  );\n  const missing = selection.members.some(member => member.kind === 'missing');\n  const literals = values.map(({ value }) => {\n    if (typeof value === 'number') {\n      invariant(Number.isFinite(value), 'Invalid numeric dimension value.');\n\n      return String(value);\n    }\n    const text = value as string;\n    for (let index = 0; index < text.length; index++)\n      invariant(\n        text.charCodeAt(index) >= 32 && text.charCodeAt(index) !== 127,\n        'Invalid control character in dimension value.'\n      );\n\n    return `'${text.replaceAll(\"'\", \"''\")}'`;\n  });\n  const clauses = [\n    ...(literals.length ? [`${column} IN (${literals.join(', ')})`] : []),\n    ...(missing ? [`${column} IS NULL`] : []),\n  ];\n\n  return `(${clauses.join(' OR ')})`;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "65216D55145AC13D64756E2164756E21",
+  "names": []
+}

package/dist/chunks/contract-ryyf6dme.js

@@ -0,0 +1,21 @@
+// src/core/bridge.ts
+var BRIDGE = "altertable:data-app";
+var PARENT_PARAM = "__altertable_parent";
+var MAX_PENDING = 128;
+var REQUEST_TIMEOUT_MS = 60000;
+function isBridgeMessage(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const message = value;
+  return message.channel === BRIDGE && message.version === 1 && typeof message.type === "string" && typeof message.documentId === "string" && message.documentId.length > 0 && message.documentId.length <= 128;
+}
+function validId(value) {
+  return typeof value === "string" && /^[a-zA-Z0-9_-]{1,128}$/.test(value);
+}
+function validLocation(message) {
+  return typeof message.search === "string" && message.search.length <= 16384 && (message.search === "" || message.search.startsWith("?")) && typeof message.hash === "string" && message.hash.length <= 4096 && (message.hash === "" || message.hash.startsWith("#"));
+}
+
+export { BRIDGE, PARENT_PARAM, MAX_PENDING, REQUEST_TIMEOUT_MS, isBridgeMessage, validId, validLocation };
+
+//# debugId=0094FE477158BED064756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/bridge.ts"],
+  "sourcesContent": [
+    "/** Data app delivery protocol. IDs identify a document, a shell session, and an individual call. */\nexport const BRIDGE = 'altertable:data-app';\nexport const PARENT_PARAM = '__altertable_parent';\n/** Bound pending requests in the client and host independently.\n * The host enforces its own limit because frames can send messages directly. */\nexport const MAX_PENDING = 128;\nexport const REQUEST_TIMEOUT_MS = 60_000;\nexport type TransportResponse = { status: number; body: unknown };\nexport type BridgeMessage = {\n  channel: typeof BRIDGE;\n  version: 1;\n  type: string;\n  documentId: string;\n  sessionId?: string;\n  id?: string;\n  route?: string;\n  payload?: unknown;\n  response?: unknown;\n  code?: string;\n  message?: string;\n  /** Opaque host context, interpreted by optional app adapters. */\n  state?: unknown;\n  requestId?: string;\n  token?: string;\n  javascript?: string;\n};\n\nexport function isBridgeMessage(value: unknown): value is BridgeMessage {\n  if (!value || typeof value !== 'object') return false;\n  const message = value as BridgeMessage;\n\n  return (\n    message.channel === BRIDGE &&\n    message.version === 1 &&\n    typeof message.type === 'string' &&\n    typeof message.documentId === 'string' &&\n    message.documentId.length > 0 &&\n    message.documentId.length <= 128\n  );\n}\n\nexport function validId(value: unknown): value is string {\n  return typeof value === 'string' && /^[a-zA-Z0-9_-]{1,128}$/.test(value);\n}\n\nexport function validLocation(message: {\n  search?: unknown;\n  hash?: unknown;\n}): boolean {\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"
+  ],
+  "mappings": ";AACO,IAAM,SAAS;AACf,IAAM,eAAe;AAGrB,IAAM,cAAc;AACpB,IAAM,qBAAqB;AAqB3B,SAAS,eAAe,CAAC,OAAwC;AAAA,EACtE,IAAI,CAAC,SAAS,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EAChD,MAAM,UAAU;AAAA,EAEhB,OACE,QAAQ,YAAY,UACpB,QAAQ,YAAY,KACpB,OAAO,QAAQ,SAAS,YACxB,OAAO,QAAQ,eAAe,YAC9B,QAAQ,WAAW,SAAS,KAC5B,QAAQ,WAAW,UAAU;AAAA;AAI1B,SAAS,OAAO,CAAC,OAAiC;AAAA,EACvD,OAAO,OAAO,UAAU,YAAY,yBAAyB,KAAK,KAAK;AAAA;AAGlE,SAAS,aAAa,CAAC,SAGlB;AAAA,EACV,OACE,OAAO,QAAQ,WAAW,YAC1B,QAAQ,OAAO,UAAU,UACxB,QAAQ,WAAW,MAAM,QAAQ,OAAO,WAAW,GAAG,MACvD,OAAO,QAAQ,SAAS,YACxB,QAAQ,KAAK,UAAU,SACtB,QAAQ,SAAS,MAAM,QAAQ,KAAK,WAAW,GAAG;AAAA;",
+  "debugId": "0094FE477158BED064756E2164756E21",
+  "names": []
+}

package/dist/chunks/contract-tkkc28tg.js

@@ -0,0 +1,213 @@
+import {
+  DataAppError2,
+  createHttpTransport2,
+  createMessageClient2,
+  localFrameBridge,
+  getDataAppTransport2
+} from "./contract-mb5nfzwg.js";
+import {
+  navigationUpdateRoute2
+} from "./contract-jksbmt5q.js";
+import {
+  PARENT_PARAM,
+  validLocation
+} from "./contract-ryyf6dme.js";
+// src/client/location.ts
+function createAppLocation(frame, virtual, publish) {
+  let state = { search: "", hash: "" };
+  let disposed = false;
+  const listeners = new Set;
+  function notify() {
+    for (const listener of listeners)
+      listener();
+  }
+  function snapshot() {
+    if (virtual)
+      return state;
+    const url = new URL(frame.location.href);
+    url.searchParams.delete(PARENT_PARAM);
+    if (state.search !== url.search || state.hash !== url.hash)
+      state = { search: url.search, hash: url.hash };
+    return state;
+  }
+  function apply(next) {
+    const previous = snapshot();
+    if (previous.search === next.search && previous.hash === next.hash)
+      return;
+    if (virtual)
+      state = next;
+    else {
+      const url = new URL(frame.location.href);
+      const parent = url.searchParams.get(PARENT_PARAM);
+      url.search = next.search;
+      if (parent)
+        url.searchParams.set(PARENT_PARAM, parent);
+      url.hash = next.hash;
+      frame.history.replaceState(null, "", url);
+      frame.dispatchEvent(new Event("popstate"));
+    }
+    if (virtual)
+      notify();
+  }
+  const location = {
+    snapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      if (!virtual)
+        frame.addEventListener("popstate", listener);
+      return () => {
+        listeners.delete(listener);
+        frame.removeEventListener("popstate", listener);
+      };
+    },
+    update(next, mode = "replace") {
+      if (disposed)
+        return;
+      if (!validLocation(next))
+        throw new Error("Invalid app location.");
+      const before = snapshot();
+      if (before.search === next.search && before.hash === next.hash)
+        return;
+      apply(next);
+      publish(next, mode);
+    }
+  };
+  function dispose() {
+    disposed = true;
+    for (const listener of listeners)
+      frame.removeEventListener("popstate", listener);
+    listeners.clear();
+  }
+  return { location, apply, dispose };
+}
+
+// src/client/navigation.ts
+function createDataAppNavigation2({
+  bridge,
+  window: frame = window
+}) {
+  return attachNavigation(frame, bridge.mode === "bundle", bridge).navigation;
+}
+function attachNavigation(frame, virtual, connection) {
+  let disposed = false;
+  let unsubscribe;
+  let send;
+  let pendingUpdate;
+  const { location, apply, dispose } = createAppLocation(frame, virtual, publish);
+  function publish(location, mode) {
+    const update = { ...location, mode, title: frame.document.title };
+    if (send)
+      send(update);
+    else
+      pendingUpdate = update;
+  }
+  function attach(bridge) {
+    if (disposed)
+      return;
+    unsubscribe?.();
+    const messages = createMessageClient2({ "navigation.update": navigationUpdateRoute2 }, bridge.request);
+    function sendUpdate(update) {
+      messages.request("navigation.update", update).catch(() => {});
+    }
+    function receiveState(state) {
+      if (!state || typeof state !== "object" || !validLocation(state))
+        return;
+      pendingUpdate = undefined;
+      apply(state);
+    }
+    send = sendUpdate;
+    unsubscribe = bridge.subscribe(receiveState);
+    receiveState(bridge.snapshot());
+    if (pendingUpdate) {
+      sendUpdate(pendingUpdate);
+      pendingUpdate = undefined;
+    }
+  }
+  if ("then" in connection)
+    connection.then(attach).catch(() => {});
+  else
+    attach(connection);
+  const navigation = {
+    ...location,
+    publish(mode = "replace") {
+      if (!disposed)
+        publish(location.snapshot(), mode);
+    },
+    dispose() {
+      disposed = true;
+      unsubscribe?.();
+      dispose();
+      send = undefined;
+      pendingUpdate = undefined;
+    }
+  };
+  return {
+    navigation,
+    attach,
+    isDisposed() {
+      return disposed;
+    }
+  };
+}
+var navigationKey = Symbol.for("altertable.appNavigation");
+function getDataAppNavigation2(frame = window) {
+  const target = frame;
+  const bridge = getDataAppTransport2(frame);
+  const cached = target[navigationKey]?.isDisposed() ? undefined : target[navigationKey];
+  if (cached) {
+    if (bridge && cached.bridge !== bridge) {
+      cached.attach(bridge);
+      cached.bridge = bridge;
+    }
+    return cached.navigation;
+  }
+  if (bridge) {
+    const adapter = attachNavigation(frame, bridge.mode === "bundle", bridge);
+    target[navigationKey] = { bridge, ...adapter };
+    return adapter.navigation;
+  }
+  const preview = localFrameBridge(frame);
+  if (!preview?.connect)
+    return;
+  const connection = preview.connect();
+  const adapter = attachNavigation(frame, false, connection);
+  const entry = {
+    ...adapter,
+    bridge: undefined
+  };
+  target[navigationKey] = entry;
+  connection.then((bridge) => {
+    entry.bridge = bridge;
+  }).catch(() => {});
+  return adapter.navigation;
+}
+
+// src/client/index.ts
+function createDataClient2(options = {}) {
+  const http = createHttpTransport2(options);
+  return {
+    async query(name, input, { signal } = {}) {
+      const transport = options.transport ?? (options.endpoint !== undefined || options.fetch !== undefined ? http : localFrameBridge()?.transport ?? http);
+      const response = await transport(name, input, signal);
+      const ok = response.status >= 200 && response.status < 300;
+      let body;
+      try {
+        const parsed = response.body;
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+          throw new Error("Invalid response envelope.");
+        body = parsed;
+      } catch (error) {
+        if (signal?.aborted)
+          throw error;
+        throw new DataAppError2(ok ? "The data response was invalid." : "Could not load data.", ok ? "invalid_response" : "request_failed");
+      }
+      if (!ok)
+        throw new DataAppError2(body.error?.message ?? "Could not load data.", body.error?.code ?? "request_failed", body.error?.requestId);
+      return { ...body, input };
+    }
+  };
+}
+
+export { createDataAppNavigation2, getDataAppNavigation2, createDataClient2 };
+
+//# debugId=235551129B40A86C64756E2164756E21