@sqlrooms/cells 0.29.0-rc.1 → 0.29.0-rc.11

package/dist/helpers.js

@@ -1,36 +1,40 @@
-import { getSheetSchemaName } from './utils';
+import { getArtifactSchemaName } from './utils';
+/**
+ * Normalizes the result of `findDependencies` to a `CellDependencies` object.
+ * Accepts either the legacy `string[]` (cell IDs only) or the new `CellDependencies` shape.
+ */
+export function normalizeCellDependencies(result) {
+    if (Array.isArray(result)) {
+        return { cellIds: result };
+    }
+    return result;
+}
 /**
  * Helper to resolve dependencies using the registry's async AST-based resolver.
  */
-export async function resolveDependencies(cell, cells, sheetId, registry, sqlSelectToJson) {
+export async function resolveDependencies(cell, cells, artifactId, registry, sqlSelectToJson) {
     const item = registry[cell.type];
     if (!item)
-        return [];
-    return item.findDependencies({ cell, cells, sheetId, sqlSelectToJson });
+        return { cellIds: [] };
+    const raw = await item.findDependencies({
+        cell,
+        cells,
+        artifactId,
+        sqlSelectToJson,
+    });
+    return normalizeCellDependencies(raw);
 }
 /**
- * Finds the sheet ID that contains the given cell ID.
+ * Finds the artifact ID that contains the given cell ID.
  */
-export function findSheetIdForCell(state, cellId) {
-    for (const [id, sheet] of Object.entries(state.cells.config.sheets)) {
-        if (sheet.cellIds.includes(cellId)) {
-            return id;
+export function findArtifactIdForCell(state, cellId) {
+    for (const [artifactId, artifact] of Object.entries(state.cells.config.artifacts)) {
+        if (artifact.cellIds.includes(cellId)) {
+            return artifactId;
         }
     }
     return undefined;
 }
-/**
- * Gets all sheets of a specific type.
- */
-export function getSheetsByType(state, type) {
-    const sheets = {};
-    for (const [id, sheet] of Object.entries(state.cells.config.sheets)) {
-        if (sheet.type === type) {
-            sheets[id] = sheet;
-        }
-    }
-    return sheets;
-}
 /**
  * Required accessor for SQL AST parser used in dependency derivation.
  */
@@ -42,83 +46,66 @@ export function getRequiredSqlSelectToJson(state) {
     return parser;
 }
 /**
- * Normalizes structural sheet fields in a partial cells config.
+ * Normalizes artifact runtime entries in a partial cells config.
  *
  * This enforces internal invariants before the config is applied:
- * - `sheets` always contains at least one entry (falls back to defaults).
- * - `sheetOrder` only contains existing sheet ids and includes every sheet.
- * - `currentSheetId` always points to an existing sheet.
- *
- * Non-structural fields are preserved by the caller when merging.
+ * - `artifacts` always has stable ids that match the record keys.
  */
-export function normalizeCellsConfigStructure(config, defaultConfig) {
-    const sheets = config.sheets && Object.keys(config.sheets).length > 0
-        ? config.sheets
-        : defaultConfig.sheets;
-    const sheetIds = Object.keys(sheets);
-    const normalizedSheetOrder = config.sheetOrder?.filter((id) => id in sheets) ?? [];
-    const missingSheetIds = sheetIds.filter((id) => !normalizedSheetOrder.includes(id));
-    const sheetOrder = normalizedSheetOrder.length > 0
-        ? [...normalizedSheetOrder, ...missingSheetIds]
-        : sheetIds;
-    const currentSheetId = (config.currentSheetId && config.currentSheetId in sheets
-        ? config.currentSheetId
-        : sheetOrder[0]) ?? sheetIds[0];
-    return { sheets, sheetOrder, currentSheetId };
+export function normalizeCellsConfigStructure(config) {
+    const artifacts = Object.fromEntries(Object.entries(config.artifacts ?? {}).map(([artifactId, artifact]) => [
+        artifactId,
+        {
+            ...artifact,
+            id: artifactId,
+            cellIds: artifact.cellIds ?? [],
+            edges: artifact.edges ?? [],
+        },
+    ]));
+    return { artifacts };
 }
+export { getUnqualifiedSqlIdentifier } from '@sqlrooms/duckdb';
 /**
- * Returns the final identifier segment from a possibly-qualified SQL name.
- *
- * The parser is quote-aware: dots inside double-quoted identifiers are treated
- * as part of the identifier rather than as qualification separators.
- *
- * Examples:
- * - `schema.table` -> `table`
- * - `db.schema.table` -> `table`
- * - `schema."my.funny.table"` -> `my.funny.table`
+ * Resolves the schema name for an artifact runtime, falling back to a stable id-based name.
  */
-export function getUnqualifiedSqlIdentifier(qualifiedName) {
-    if (!qualifiedName)
-        return undefined;
-    const input = qualifiedName.trim();
-    if (!input)
-        return undefined;
-    const parts = [];
-    let current = '';
-    let inQuotes = false;
-    for (let i = 0; i < input.length; i += 1) {
-        const ch = input[i];
-        if (ch === '"') {
-            // In SQL identifiers, escaped quotes inside quoted identifiers are doubled.
-            if (inQuotes && input[i + 1] === '"') {
-                current += '"';
-                i += 1;
-                continue;
-            }
-            inQuotes = !inQuotes;
-            current += ch;
-            continue;
-        }
-        if (ch === '.' && !inQuotes) {
-            parts.push(current);
-            current = '';
-            continue;
-        }
-        current += ch;
+export function resolveArtifactSchemaName(artifact) {
+    return artifact.schemaName || getArtifactSchemaName(artifact.id);
+}
+const DATA_SOURCE_CELL_PREFIX = 'cell:';
+const DATA_SOURCE_TABLE_PREFIX = 'table:';
+export function toDataSourceCell(cell) {
+    const id = typeof cell === 'string' ? cell : cell.id;
+    return `${DATA_SOURCE_CELL_PREFIX}${id}`;
+}
+export function toDataSourceTable(table) {
+    if (typeof table === 'string') {
+        return `${DATA_SOURCE_TABLE_PREFIX}${table}`;
     }
-    parts.push(current);
-    const last = parts[parts.length - 1]?.trim();
-    if (!last)
-        return undefined;
-    if (last.startsWith('"') && last.endsWith('"') && last.length >= 2) {
-        return last.slice(1, -1).replaceAll('""', '"');
+    // Escape each identifier segment: double any internal quotes, then wrap in quotes
+    const escapeIdentifier = (id) => `"${id.replace(/"/g, '""')}"`;
+    const qualifiedName = [
+        table.schema ? escapeIdentifier(table.schema) : null,
+        escapeIdentifier(table.table),
+    ]
+        .filter(Boolean)
+        .join('.');
+    return `${DATA_SOURCE_TABLE_PREFIX}${qualifiedName}`;
+}
+export function isDataSourceCell(value) {
+    return value.startsWith(DATA_SOURCE_CELL_PREFIX);
+}
+export function isDataSourceTable(value) {
+    return value.startsWith(DATA_SOURCE_TABLE_PREFIX);
+}
+export function fromDataSourceCell(value) {
+    if (isDataSourceCell(value)) {
+        return value.slice(DATA_SOURCE_CELL_PREFIX.length);
     }
-    return last;
+    return undefined;
 }
-/**
- * Resolves the schema name for a sheet, falling back to a stable id-based name.
- */
-export function resolveSheetSchemaName(sheet) {
-    return sheet.schemaName || getSheetSchemaName(sheet.id);
+export function fromDataSourceTable(value) {
+    if (isDataSourceTable(value)) {
+        return value.slice(DATA_SOURCE_TABLE_PREFIX.length);
+    }
+    return undefined;
 }
 //# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Cell,\n  CellRegistry,\n  CellsRootState,\n  CellsSliceConfig,\n  Sheet,\n  SheetType,\n  SqlSelectToJsonFn,\n} from './types';\nimport {getSheetSchemaName} from './utils';\n\n/**\n * Helper to resolve dependencies using the registry's async AST-based resolver.\n */\nexport async function resolveDependencies(\n  cell: Cell,\n  cells: Record<string, Cell>,\n  sheetId: string,\n  registry: CellRegistry,\n  sqlSelectToJson: SqlSelectToJsonFn,\n): Promise<string[]> {\n  const item = registry[cell.type];\n  if (!item) return [];\n  return item.findDependencies({cell, cells, sheetId, sqlSelectToJson});\n}\n\n/**\n * Finds the sheet ID that contains the given cell ID.\n */\nexport function findSheetIdForCell(\n  state: CellsRootState,\n  cellId: string,\n): string | undefined {\n  for (const [id, sheet] of Object.entries(state.cells.config.sheets)) {\n    if (sheet.cellIds.includes(cellId)) {\n      return id;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Gets all sheets of a specific type.\n */\nexport function getSheetsByType(\n  state: CellsRootState,\n  type: SheetType,\n): Record<string, Sheet> {\n  const sheets: Record<string, Sheet> = {};\n  for (const [id, sheet] of Object.entries(state.cells.config.sheets)) {\n    if (sheet.type === type) {\n      sheets[id] = sheet;\n    }\n  }\n  return sheets;\n}\n\n/**\n * Required accessor for SQL AST parser used in dependency derivation.\n */\nexport function getRequiredSqlSelectToJson(\n  state: CellsRootState,\n): SqlSelectToJsonFn {\n  const parser = state.db?.sqlSelectToJson;\n  if (!parser) {\n    throw new Error(\n      'cells dependency derivation requires db.sqlSelectToJson. Ensure the DuckDB slice is mounted and initialized before running cell dependency operations.',\n    );\n  }\n  return parser;\n}\n\n/**\n * Normalizes structural sheet fields in a partial cells config.\n *\n * This enforces internal invariants before the config is applied:\n * - `sheets` always contains at least one entry (falls back to defaults).\n * - `sheetOrder` only contains existing sheet ids and includes every sheet.\n * - `currentSheetId` always points to an existing sheet.\n *\n * Non-structural fields are preserved by the caller when merging.\n */\nexport function normalizeCellsConfigStructure(\n  config: Partial<CellsSliceConfig>,\n  defaultConfig: CellsSliceConfig,\n): Pick<CellsSliceConfig, 'sheets' | 'sheetOrder' | 'currentSheetId'> {\n  const sheets =\n    config.sheets && Object.keys(config.sheets).length > 0\n      ? config.sheets\n      : defaultConfig.sheets;\n  const sheetIds = Object.keys(sheets);\n  const normalizedSheetOrder =\n    config.sheetOrder?.filter((id) => id in sheets) ?? [];\n  const missingSheetIds = sheetIds.filter(\n    (id) => !normalizedSheetOrder.includes(id),\n  );\n  const sheetOrder =\n    normalizedSheetOrder.length > 0\n      ? [...normalizedSheetOrder, ...missingSheetIds]\n      : sheetIds;\n  const currentSheetId =\n    (config.currentSheetId && config.currentSheetId in sheets\n      ? config.currentSheetId\n      : sheetOrder[0]) ?? sheetIds[0];\n\n  return {sheets, sheetOrder, currentSheetId};\n}\n\n/**\n * Returns the final identifier segment from a possibly-qualified SQL name.\n *\n * The parser is quote-aware: dots inside double-quoted identifiers are treated\n * as part of the identifier rather than as qualification separators.\n *\n * Examples:\n * - `schema.table` -> `table`\n * - `db.schema.table` -> `table`\n * - `schema.\"my.funny.table\"` -> `my.funny.table`\n */\nexport function getUnqualifiedSqlIdentifier(\n  qualifiedName: string | undefined,\n): string | undefined {\n  if (!qualifiedName) return undefined;\n  const input = qualifiedName.trim();\n  if (!input) return undefined;\n\n  const parts: string[] = [];\n  let current = '';\n  let inQuotes = false;\n\n  for (let i = 0; i < input.length; i += 1) {\n    const ch = input[i];\n    if (ch === '\"') {\n      // In SQL identifiers, escaped quotes inside quoted identifiers are doubled.\n      if (inQuotes && input[i + 1] === '\"') {\n        current += '\"';\n        i += 1;\n        continue;\n      }\n      inQuotes = !inQuotes;\n      current += ch;\n      continue;\n    }\n\n    if (ch === '.' && !inQuotes) {\n      parts.push(current);\n      current = '';\n      continue;\n    }\n\n    current += ch;\n  }\n  parts.push(current);\n\n  const last = parts[parts.length - 1]?.trim();\n  if (!last) return undefined;\n  if (last.startsWith('\"') && last.endsWith('\"') && last.length >= 2) {\n    return last.slice(1, -1).replaceAll('\"\"', '\"');\n  }\n  return last;\n}\n\n/**\n * Resolves the schema name for a sheet, falling back to a stable id-based name.\n */\nexport function resolveSheetSchemaName(\n  sheet: Pick<Sheet, 'id' | 'schemaName'>,\n) {\n  return sheet.schemaName || getSheetSchemaName(sheet.id);\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {QualifiedTableName} from '@sqlrooms/db';\nimport {\n  Cell,\n  CellDependencies,\n  CellRegistry,\n  CellsRootState,\n  CellsSliceConfig,\n  SqlCell,\n  SqlSelectToJsonFn,\n  CellArtifactRuntime,\n} from './types';\nimport {getArtifactSchemaName} from './utils';\n\n/**\n * Normalizes the result of `findDependencies` to a `CellDependencies` object.\n * Accepts either the legacy `string[]` (cell IDs only) or the new `CellDependencies` shape.\n */\nexport function normalizeCellDependencies(\n  result: string[] | CellDependencies,\n): CellDependencies {\n  if (Array.isArray(result)) {\n    return {cellIds: result};\n  }\n  return result;\n}\n\n/**\n * Helper to resolve dependencies using the registry's async AST-based resolver.\n */\nexport async function resolveDependencies(\n  cell: Cell,\n  cells: Record<string, Cell>,\n  artifactId: string,\n  registry: CellRegistry,\n  sqlSelectToJson: SqlSelectToJsonFn,\n): Promise<CellDependencies> {\n  const item = registry[cell.type];\n  if (!item) return {cellIds: []};\n  const raw = await item.findDependencies({\n    cell,\n    cells,\n    artifactId,\n    sqlSelectToJson,\n  });\n  return normalizeCellDependencies(raw);\n}\n\n/**\n * Finds the artifact ID that contains the given cell ID.\n */\nexport function findArtifactIdForCell(\n  state: Pick<CellsRootState, 'cells'>,\n  cellId: string,\n): string | undefined {\n  for (const [artifactId, artifact] of Object.entries(\n    state.cells.config.artifacts,\n  )) {\n    if (artifact.cellIds.includes(cellId)) {\n      return artifactId;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Required accessor for SQL AST parser used in dependency derivation.\n */\nexport function getRequiredSqlSelectToJson(\n  state: CellsRootState,\n): SqlSelectToJsonFn {\n  const parser = state.db?.sqlSelectToJson;\n  if (!parser) {\n    throw new Error(\n      'cells dependency derivation requires db.sqlSelectToJson. Ensure the DuckDB slice is mounted and initialized before running cell dependency operations.',\n    );\n  }\n  return parser;\n}\n\n/**\n * Normalizes artifact runtime entries in a partial cells config.\n *\n * This enforces internal invariants before the config is applied:\n * - `artifacts` always has stable ids that match the record keys.\n */\nexport function normalizeCellsConfigStructure(\n  config: Partial<CellsSliceConfig>,\n): Pick<CellsSliceConfig, 'artifacts'> {\n  const artifacts = Object.fromEntries(\n    Object.entries(config.artifacts ?? {}).map(([artifactId, artifact]) => [\n      artifactId,\n      {\n        ...artifact,\n        id: artifactId,\n        cellIds: artifact.cellIds ?? [],\n        edges: artifact.edges ?? [],\n      },\n    ]),\n  ) as Record<string, CellArtifactRuntime>;\n\n  return {artifacts};\n}\n\nexport {getUnqualifiedSqlIdentifier} from '@sqlrooms/duckdb';\n\n/**\n * Resolves the schema name for an artifact runtime, falling back to a stable id-based name.\n */\nexport function resolveArtifactSchemaName(\n  artifact: Pick<CellArtifactRuntime, 'id' | 'schemaName'>,\n) {\n  return artifact.schemaName || getArtifactSchemaName(artifact.id);\n}\n\nconst DATA_SOURCE_CELL_PREFIX = 'cell:';\nconst DATA_SOURCE_TABLE_PREFIX = 'table:';\n\nexport function toDataSourceCell(cell: SqlCell | string): string {\n  const id = typeof cell === 'string' ? cell : cell.id;\n\n  return `${DATA_SOURCE_CELL_PREFIX}${id}`;\n}\n\nexport function toDataSourceTable(table: QualifiedTableName | string): string {\n  if (typeof table === 'string') {\n    return `${DATA_SOURCE_TABLE_PREFIX}${table}`;\n  }\n\n  // Escape each identifier segment: double any internal quotes, then wrap in quotes\n  const escapeIdentifier = (id: string) => `\"${id.replace(/\"/g, '\"\"')}\"`;\n\n  const qualifiedName = [\n    table.schema ? escapeIdentifier(table.schema) : null,\n    escapeIdentifier(table.table),\n  ]\n    .filter(Boolean)\n    .join('.');\n\n  return `${DATA_SOURCE_TABLE_PREFIX}${qualifiedName}`;\n}\n\nexport function isDataSourceCell(value: string): boolean {\n  return value.startsWith(DATA_SOURCE_CELL_PREFIX);\n}\n\nexport function isDataSourceTable(value: string): boolean {\n  return value.startsWith(DATA_SOURCE_TABLE_PREFIX);\n}\n\nexport function fromDataSourceCell(value: string): string | undefined {\n  if (isDataSourceCell(value)) {\n    return value.slice(DATA_SOURCE_CELL_PREFIX.length);\n  }\n  return undefined;\n}\n\nexport function fromDataSourceTable(value: string): string | undefined {\n  if (isDataSourceTable(value)) {\n    return value.slice(DATA_SOURCE_TABLE_PREFIX.length);\n  }\n  return undefined;\n}\n"]}

package/dist/hooks/useVegaCellDataSource.d.ts

@@ -0,0 +1,18 @@
+import type { VegaCell, CellStatus } from '../types';
+export type VegaCellDataSource = {
+    selectedSqlId: string | undefined;
+    selectedTableRef: string | undefined;
+    selectedSqlStatus: CellStatus | undefined;
+    baseSqlQuery: string;
+    lastRunTime: number | undefined;
+    hasDataSource: boolean;
+};
+/**
+ * Resolves the data source for a Vega cell and builds the base SQL query.
+ * Handles three data source types:
+ * 1. Direct table reference (tableRef)
+ * 2. Result view from another SQL cell (sqlId with resultView)
+ * 3. Raw SQL from another cell (sqlId with sql)
+ */
+export declare function useVegaCellDataSource(cell: VegaCell): VegaCellDataSource;
+//# sourceMappingURL=useVegaCellDataSource.d.ts.map

package/dist/hooks/useVegaCellDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVegaCellDataSource.d.ts","sourceRoot":"","sources":["../../src/hooks/useVegaCellDataSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,EAAE,UAAU,GAAG,SAAS,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CAwCxE"}

package/dist/hooks/useVegaCellDataSource.js

@@ -0,0 +1,40 @@
+import { useCellsStore } from '../hooks';
+import { isSqlCell, isSqlCellStatus } from '../types';
+/**
+ * Resolves the data source for a Vega cell and builds the base SQL query.
+ * Handles three data source types:
+ * 1. Direct table reference (tableRef)
+ * 2. Result view from another SQL cell (sqlId with resultView)
+ * 3. Raw SQL from another cell (sqlId with sql)
+ */
+export function useVegaCellDataSource(cell) {
+    const cellsData = useCellsStore((s) => s.cells.config.data);
+    const cellsStatus = useCellsStore((s) => s.cells.status);
+    const selectedSqlId = cell.data.sqlId;
+    const selectedTableRef = cell.data.tableRef;
+    const selectedSqlStatus = selectedSqlId
+        ? cellsStatus[selectedSqlId]
+        : undefined;
+    const hasDataSource = !!(selectedSqlId || selectedTableRef);
+    const selectedCell = selectedSqlId ? cellsData[selectedSqlId] : null;
+    const selectedCellSql = selectedCell && isSqlCell(selectedCell) ? selectedCell.data.sql : '';
+    const selectedResultView = isSqlCellStatus(selectedSqlStatus)
+        ? selectedSqlStatus.resultView
+        : undefined;
+    const baseTable = selectedTableRef || selectedResultView;
+    const baseSqlQuery = baseTable
+        ? `SELECT * FROM ${baseTable}`
+        : selectedCellSql;
+    const lastRunTime = isSqlCellStatus(selectedSqlStatus)
+        ? selectedSqlStatus.lastRunTime
+        : undefined;
+    return {
+        selectedSqlId,
+        selectedTableRef,
+        selectedSqlStatus,
+        baseSqlQuery,
+        lastRunTime,
+        hasDataSource,
+    };
+}
+//# sourceMappingURL=useVegaCellDataSource.js.map

package/dist/hooks/useVegaCellDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVegaCellDataSource.js","sourceRoot":"","sources":["../../src/hooks/useVegaCellDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AAYpD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACtC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAE5C,MAAM,iBAAiB,GAAG,aAAa;QACrC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;QAC5B,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,aAAa,IAAI,gBAAgB,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,MAAM,eAAe,GACnB,YAAY,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,kBAAkB,GAAG,eAAe,CAAC,iBAAiB,CAAC;QAC3D,CAAC,CAAC,iBAAiB,CAAC,UAAU;QAC9B,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,SAAS,GAAG,gBAAgB,IAAI,kBAAkB,CAAC;IAEzD,MAAM,YAAY,GAAG,SAAS;QAC5B,CAAC,CAAC,iBAAiB,SAAS,EAAE;QAC9B,CAAC,CAAC,eAAe,CAAC;IAEpB,MAAM,WAAW,GAAG,eAAe,CAAC,iBAAiB,CAAC;QACpD,CAAC,CAAC,iBAAiB,CAAC,WAAW;QAC/B,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,aAAa;QACb,gBAAgB;QAChB,iBAAiB;QACjB,YAAY;QACZ,WAAW;QACX,aAAa;KACd,CAAC;AACJ,CAAC","sourcesContent":["import {useCellsStore} from '../hooks';\nimport {isSqlCell, isSqlCellStatus} from '../types';\nimport type {VegaCell, CellStatus} from '../types';\n\nexport type VegaCellDataSource = {\n  selectedSqlId: string | undefined;\n  selectedTableRef: string | undefined;\n  selectedSqlStatus: CellStatus | undefined;\n  baseSqlQuery: string;\n  lastRunTime: number | undefined;\n  hasDataSource: boolean;\n};\n\n/**\n * Resolves the data source for a Vega cell and builds the base SQL query.\n * Handles three data source types:\n * 1. Direct table reference (tableRef)\n * 2. Result view from another SQL cell (sqlId with resultView)\n * 3. Raw SQL from another cell (sqlId with sql)\n */\nexport function useVegaCellDataSource(cell: VegaCell): VegaCellDataSource {\n  const cellsData = useCellsStore((s) => s.cells.config.data);\n  const cellsStatus = useCellsStore((s) => s.cells.status);\n\n  const selectedSqlId = cell.data.sqlId;\n  const selectedTableRef = cell.data.tableRef;\n\n  const selectedSqlStatus = selectedSqlId\n    ? cellsStatus[selectedSqlId]\n    : undefined;\n\n  const hasDataSource = !!(selectedSqlId || selectedTableRef);\n\n  const selectedCell = selectedSqlId ? cellsData[selectedSqlId] : null;\n\n  const selectedCellSql =\n    selectedCell && isSqlCell(selectedCell) ? selectedCell.data.sql : '';\n\n  const selectedResultView = isSqlCellStatus(selectedSqlStatus)\n    ? selectedSqlStatus.resultView\n    : undefined;\n\n  const baseTable = selectedTableRef || selectedResultView;\n\n  const baseSqlQuery = baseTable\n    ? `SELECT * FROM ${baseTable}`\n    : selectedCellSql;\n\n  const lastRunTime = isSqlCellStatus(selectedSqlStatus)\n    ? selectedSqlStatus.lastRunTime\n    : undefined;\n\n  return {\n    selectedSqlId,\n    selectedTableRef,\n    selectedSqlStatus,\n    baseSqlQuery,\n    lastRunTime,\n    hasDataSource,\n  };\n}\n"]}

package/dist/hooks/useVegaCellQuery.d.ts

@@ -0,0 +1,12 @@
+export type VegaCellQuery = {
+    selectedSqlQuery: string;
+};
+/**
+ * Builds the final SQL query for a Vega cell with optional cross-filter predicates.
+ * If cross-filtering is enabled and active, wraps the base query as a subquery
+ * and applies the WHERE clause to avoid breaking raw SQL with existing clauses.
+ */
+export declare function useVegaCellQuery(params: {
+    baseSqlQuery: string;
+}): VegaCellQuery;
+//# sourceMappingURL=useVegaCellQuery.d.ts.map

package/dist/hooks/useVegaCellQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVegaCellQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useVegaCellQuery.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,aAAa,CAMhB"}

package/dist/hooks/useVegaCellQuery.js

@@ -0,0 +1,12 @@
+/**
+ * Builds the final SQL query for a Vega cell with optional cross-filter predicates.
+ * If cross-filtering is enabled and active, wraps the base query as a subquery
+ * and applies the WHERE clause to avoid breaking raw SQL with existing clauses.
+ */
+export function useVegaCellQuery(params) {
+    const { baseSqlQuery } = params;
+    return {
+        selectedSqlQuery: baseSqlQuery,
+    };
+}
+//# sourceMappingURL=useVegaCellQuery.js.map

package/dist/hooks/useVegaCellQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVegaCellQuery.js","sourceRoot":"","sources":["../../src/hooks/useVegaCellQuery.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAEhC;IACC,MAAM,EAAC,YAAY,EAAC,GAAG,MAAM,CAAC;IAE9B,OAAO;QACL,gBAAgB,EAAE,YAAY;KAC/B,CAAC;AACJ,CAAC","sourcesContent":["export type VegaCellQuery = {\n  selectedSqlQuery: string;\n};\n\n/**\n * Builds the final SQL query for a Vega cell with optional cross-filter predicates.\n * If cross-filtering is enabled and active, wraps the base query as a subquery\n * and applies the WHERE clause to avoid breaking raw SQL with existing clauses.\n */\nexport function useVegaCellQuery(params: {\n  baseSqlQuery: string;\n}): VegaCellQuery {\n  const {baseSqlQuery} = params;\n\n  return {\n    selectedSqlQuery: baseSqlQuery,\n  };\n}\n"]}

package/dist/index.d.ts

@@ -8,18 +8,17 @@ export { createCellsSlice } from './cellsSlice';
 export type { CellsRootState } from './types';
 export { initializeInput } from './components/Input/helpers';
 export { InputCellContent } from './components/InputCellContent';
-export { SheetsTabBar } from './components/SheetsTabBar';
 export { SqlCellContentComponent as SqlCellContent };
 export { SqlCellRunButtonComponent as SqlCellRunButton };
 export { TextCellContent } from './components/TextCellContent';
 export { VegaCellContent } from './components/VegaCellContent';
+export { CellSourceSelector } from './components/CellSourceSelector';
 export { createDefaultCellRegistry } from './defaultCellRegistry';
 export { getRenderableDependencyEdges } from './dagUtils';
-export { findSheetIdForCell, getSheetsByType } from './helpers';
+export { findArtifactIdForCell, getUnqualifiedSqlIdentifier, normalizeCellDependencies, resolveArtifactSchemaName, toDataSourceCell, toDataSourceTable, isDataSourceCell, isDataSourceTable, fromDataSourceCell, fromDataSourceTable, } from './helpers';
 export { useCellsStore } from './hooks';
 export { findSqlDependencies, findSqlDependenciesFromAst, renderSqlWithInputs, runSqlWithCallbacks, } from './sqlHelpers';
 export * from './types';
-export { getEffectiveResultName, isValidSqlIdentifier } from './utils';
 export declare const SqlCell: {
     RunButton: typeof SqlCellRunButtonComponent;
     Content: import("react").FC<import("./components/SqlCellContent").SqlCellContentProps>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,cAAc,IAAI,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAC,gBAAgB,IAAI,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE5F,OAAO,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAC,uBAAuB,IAAI,cAAc,EAAC,CAAC;AACnD,OAAO,EAAC,yBAAyB,IAAI,gBAAgB,EAAC,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,yBAAyB,EAAC,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAC,4BAA4B,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,kBAAkB,EAAE,eAAe,EAAC,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAC,sBAAsB,EAAE,oBAAoB,EAAC,MAAM,SAAS,CAAC;AAErE,eAAO,MAAM,OAAO;;;CAGnB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,cAAc,IAAI,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAC,gBAAgB,IAAI,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE5F,OAAO,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,uBAAuB,IAAI,cAAc,EAAC,CAAC;AACnD,OAAO,EAAC,yBAAyB,IAAI,gBAAgB,EAAC,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAC,yBAAyB,EAAC,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAC,4BAA4B,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,cAAc,SAAS,CAAC;AAExB,eAAO,MAAM,OAAO;;;CAGnB,CAAC"}

package/dist/index.js

@@ -7,18 +7,17 @@ import { SqlCellRunButton as SqlCellRunButtonComponent } from './components/SqlC
 export { createCellsSlice } from './cellsSlice';
 export { initializeInput } from './components/Input/helpers';
 export { InputCellContent } from './components/InputCellContent';
-export { SheetsTabBar } from './components/SheetsTabBar';
 export { SqlCellContentComponent as SqlCellContent };
 export { SqlCellRunButtonComponent as SqlCellRunButton };
 export { TextCellContent } from './components/TextCellContent';
 export { VegaCellContent } from './components/VegaCellContent';
+export { CellSourceSelector } from './components/CellSourceSelector';
 export { createDefaultCellRegistry } from './defaultCellRegistry';
 export { getRenderableDependencyEdges } from './dagUtils';
-export { findSheetIdForCell, getSheetsByType } from './helpers';
+export { findArtifactIdForCell, getUnqualifiedSqlIdentifier, normalizeCellDependencies, resolveArtifactSchemaName, toDataSourceCell, toDataSourceTable, isDataSourceCell, isDataSourceTable, fromDataSourceCell, fromDataSourceTable, } from './helpers';
 export { useCellsStore } from './hooks';
 export { findSqlDependencies, findSqlDependenciesFromAst, renderSqlWithInputs, runSqlWithCallbacks, } from './sqlHelpers';
 export * from './types';
-export { getEffectiveResultName, isValidSqlIdentifier } from './utils';
 export const SqlCell = {
     RunButton: SqlCellRunButtonComponent,
     Content: SqlCellContentComponent,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,cAAc,IAAI,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAC,gBAAgB,IAAI,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE5F,OAAO,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAC,uBAAuB,IAAI,cAAc,EAAC,CAAC;AACnD,OAAO,EAAC,yBAAyB,IAAI,gBAAgB,EAAC,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,yBAAyB,EAAC,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAC,4BAA4B,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EAAC,kBAAkB,EAAE,eAAe,EAAC,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAC,sBAAsB,EAAE,oBAAoB,EAAC,MAAM,SAAS,CAAC;AAErE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,yBAAyB;IACpC,OAAO,EAAE,uBAAuB;CACjC,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nimport {SqlCellContent as SqlCellContentComponent} from './components/SqlCellContent';\nimport {SqlCellRunButton as SqlCellRunButtonComponent} from './components/SqlCellRunButton';\n\nexport {createCellsSlice} from './cellsSlice';\nexport type {CellsRootState} from './types';\nexport {initializeInput} from './components/Input/helpers';\nexport {InputCellContent} from './components/InputCellContent';\nexport {SheetsTabBar} from './components/SheetsTabBar';\nexport {SqlCellContentComponent as SqlCellContent};\nexport {SqlCellRunButtonComponent as SqlCellRunButton};\nexport {TextCellContent} from './components/TextCellContent';\nexport {VegaCellContent} from './components/VegaCellContent';\nexport {createDefaultCellRegistry} from './defaultCellRegistry';\nexport {getRenderableDependencyEdges} from './dagUtils';\nexport {findSheetIdForCell, getSheetsByType} from './helpers';\nexport {useCellsStore} from './hooks';\nexport {\n  findSqlDependencies,\n  findSqlDependenciesFromAst,\n  renderSqlWithInputs,\n  runSqlWithCallbacks,\n} from './sqlHelpers';\nexport * from './types';\nexport {getEffectiveResultName, isValidSqlIdentifier} from './utils';\n\nexport const SqlCell = {\n  RunButton: SqlCellRunButtonComponent,\n  Content: SqlCellContentComponent,\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,cAAc,IAAI,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAC,gBAAgB,IAAI,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE5F,OAAO,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,uBAAuB,IAAI,cAAc,EAAC,CAAC;AACnD,OAAO,EAAC,yBAAyB,IAAI,gBAAgB,EAAC,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAC,yBAAyB,EAAC,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAC,4BAA4B,EAAC,MAAM,YAAY,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,cAAc,SAAS,CAAC;AAExB,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,yBAAyB;IACpC,OAAO,EAAE,uBAAuB;CACjC,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nimport {SqlCellContent as SqlCellContentComponent} from './components/SqlCellContent';\nimport {SqlCellRunButton as SqlCellRunButtonComponent} from './components/SqlCellRunButton';\n\nexport {createCellsSlice} from './cellsSlice';\nexport type {CellsRootState} from './types';\nexport {initializeInput} from './components/Input/helpers';\nexport {InputCellContent} from './components/InputCellContent';\nexport {SqlCellContentComponent as SqlCellContent};\nexport {SqlCellRunButtonComponent as SqlCellRunButton};\nexport {TextCellContent} from './components/TextCellContent';\nexport {VegaCellContent} from './components/VegaCellContent';\nexport {CellSourceSelector} from './components/CellSourceSelector';\nexport {createDefaultCellRegistry} from './defaultCellRegistry';\nexport {getRenderableDependencyEdges} from './dagUtils';\nexport {\n  findArtifactIdForCell,\n  getUnqualifiedSqlIdentifier,\n  normalizeCellDependencies,\n  resolveArtifactSchemaName,\n  toDataSourceCell,\n  toDataSourceTable,\n  isDataSourceCell,\n  isDataSourceTable,\n  fromDataSourceCell,\n  fromDataSourceTable,\n} from './helpers';\nexport {useCellsStore} from './hooks';\nexport {\n  findSqlDependencies,\n  findSqlDependenciesFromAst,\n  renderSqlWithInputs,\n  runSqlWithCallbacks,\n} from './sqlHelpers';\nexport * from './types';\n\nexport const SqlCell = {\n  RunButton: SqlCellRunButtonComponent,\n  Content: SqlCellContentComponent,\n};\n"]}

package/dist/resultRelationPolicy.d.ts

@@ -1,4 +1,4 @@
-import type { QualifiedTableName } from '@sqlrooms/duckdb';
+import { type QualifiedTableName, type RawSqlTableReference } from '@sqlrooms/duckdb';
 /**
  * Centralized policy for persisting SQL cell query results.
  *
@@ -13,7 +13,7 @@ import type { QualifiedTableName } from '@sqlrooms/duckdb';
  * migrations may have created either form for the same logical result name.
  */
 export type ResultRelationType = 'view' | 'table';
-export type ResultRelationName = string | QualifiedTableName;
+export type ResultRelationName = string | QualifiedTableName | RawSqlTableReference;
 type SqlConnectorLike = {
     query: (sql: string, options?: {
         signal?: AbortSignal;

package/dist/resultRelationPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resultRelationPolicy.d.ts","sourceRoot":"","sources":["../src/resultRelationPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE7D,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAC,KAC7B,WAAW,CAAC,OAAO,CAAC,CAAC;CAC3B,CAAC;AAMF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;IAC1C,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,kBAAkB,CAIrB;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE;IACxD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,kBAAkB,CAAC;IACjC,YAAY,EAAE,kBAAkB,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,iBAeA;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,iBAMA;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,kBAAkB,CAAC;IACpC,eAAe,EAAE,kBAAkB,CAAC;IACpC,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,iBAkBA"}
+{"version":3,"file":"resultRelationPolicy.d.ts","sourceRoot":"","sources":["../src/resultRelationPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,CACL,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAC,KAC7B,WAAW,CAAC,OAAO,CAAC,CAAC;CAC3B,CAAC;AAeF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;IAC1C,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,kBAAkB,CAIrB;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE;IACxD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,kBAAkB,CAAC;IACjC,YAAY,EAAE,kBAAkB,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,iBAeA;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,iBAMA;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,kBAAkB,CAAC;IACpC,eAAe,EAAE,kBAAkB,CAAC;IACpC,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,iBAkBA"}

package/dist/resultRelationPolicy.js

@@ -1,5 +1,13 @@
+import { getRawSqlTableReference, quoteParsedRawSqlTableReference, } from '@sqlrooms/duckdb';
 function toRelationSqlName(relationName) {
-    return relationName.toString();
+    const relationReference = typeof relationName === 'string'
+        ? relationName
+        : getRawSqlTableReference(relationName);
+    const rawSqlTableReference = quoteParsedRawSqlTableReference(relationReference);
+    if (!rawSqlTableReference) {
+        throw new Error(`Invalid SQL cell result relation "${relationReference}".`);
+    }
+    return rawSqlTableReference;
 }
 /**
  * Chooses whether a SQL cell result should be stored as a logical view or a

package/dist/resultRelationPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"resultRelationPolicy.js","sourceRoot":"","sources":["../src/resultRelationPolicy.ts"],"names":[],"mappings":"AAyBA,SAAS,iBAAiB,CAAC,YAAgC;IACzD,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAG1C;IACC,MAAM,EAAC,oBAAoB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC;IACnD,IAAI,oBAAoB;QAAE,OAAO,oBAAoB,CAAC;IACtD,OAAO,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,IAMnD;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC;IAClE,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,2BAA2B,eAAe,OAAO,GAAG,EAAE,EACtD;YACE,MAAM;SACP,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,SAAS,CAAC,KAAK,CAAC,0BAA0B,eAAe,OAAO,GAAG,EAAE,EAAE;QAC3E,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAGxC;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAC,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,KAAK,CAAC,uBAAuB,eAAe,EAAE,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,KAAK,CAAC,wBAAwB,eAAe,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAM1C;IACC,MAAM,EAAC,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAC,GACxE,IAAI,CAAC;IACP,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE9D,yDAAyD;IACzD,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;IAExE,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,gBAAgB,kBAAkB,qBAAqB,kBAAkB,EAAE,CAC5E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,kBAAkB,OAAO,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import type {QualifiedTableName} from '@sqlrooms/duckdb';\n\n/**\n * Centralized policy for persisting SQL cell query results.\n *\n * This module implements an adaptive strategy:\n * - first run chooses `table` when downstream dependencies exist, otherwise\n *   `view`;\n * - subsequent runs preserve the previously chosen relation type.\n *\n * The policy is shared by execution, rename, and cleanup paths so behavior\n * stays consistent across cross-cutting lifecycle events. Cleanup intentionally\n * drops both relation variants (`VIEW` and `TABLE`) because historical runs or\n * migrations may have created either form for the same logical result name.\n */\nexport type ResultRelationType = 'view' | 'table';\nexport type ResultRelationName = string | QualifiedTableName;\n\ntype SqlConnectorLike = {\n  query: (\n    sql: string,\n    options?: {signal?: AbortSignal},\n  ) => PromiseLike<unknown>;\n};\n\nfunction toRelationSqlName(relationName: ResultRelationName): string {\n  return relationName.toString();\n}\n\n/**\n * Chooses whether a SQL cell result should be stored as a logical view or a\n * materialized table.\n *\n * The policy is sticky: once a relation type has been selected for a cell,\n * later executions preserve that choice. On first execution, downstream usage\n * is used as a proxy for reuse.\n */\nexport function chooseAdaptiveRelationType(args: {\n  previousRelationType?: ResultRelationType;\n  hasDownstream: boolean;\n}): ResultRelationType {\n  const {previousRelationType, hasDownstream} = args;\n  if (previousRelationType) return previousRelationType;\n  return hasDownstream ? 'table' : 'view';\n}\n\n/**\n * Creates or replaces the relation that backs a SQL cell result.\n *\n * - `table`: materializes data for stable repeated reads.\n * - `view`: stores query definition for lightweight freshness.\n */\nexport async function createOrReplaceResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName: ResultRelationName;\n  relationType: ResultRelationType;\n  sql: string;\n  signal?: AbortSignal;\n}) {\n  const {connector, relationName, relationType, sql, signal} = args;\n  const relationSqlName = toRelationSqlName(relationName);\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE OR REPLACE TABLE ${relationSqlName} AS ${sql}`,\n      {\n        signal,\n      },\n    );\n    return;\n  }\n  await connector.query(`CREATE OR REPLACE VIEW ${relationSqlName} AS ${sql}`, {\n    signal,\n  });\n}\n\n/**\n * Drops both view and table variants for a relation name.\n *\n * This is intentionally defensive because different runs may have used\n * different relation modes.\n */\nexport async function dropResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName?: ResultRelationName;\n}) {\n  const {connector, relationName} = args;\n  if (!relationName) return;\n  const relationSqlName = toRelationSqlName(relationName);\n  await connector.query(`DROP VIEW IF EXISTS ${relationSqlName}`);\n  await connector.query(`DROP TABLE IF EXISTS ${relationSqlName}`);\n}\n\n/**\n * Renames a saved SQL cell result relation while preserving its mode.\n *\n * - `table`: copies current relation data into the new name.\n * - `view`: recreates the view definition under the new name.\n *\n * Any existing destination relation is removed first, and the old source name\n * is cleaned up after the new relation is created.\n */\nexport async function renameResultRelation(args: {\n  connector: SqlConnectorLike;\n  oldRelationName: ResultRelationName;\n  newRelationName: ResultRelationName;\n  relationType: ResultRelationType;\n  viewSql: string;\n}) {\n  const {connector, oldRelationName, newRelationName, relationType, viewSql} =\n    args;\n  const oldRelationSqlName = toRelationSqlName(oldRelationName);\n  const newRelationSqlName = toRelationSqlName(newRelationName);\n\n  // Clear destination first in case a stale object exists.\n  await dropResultRelation({connector, relationName: newRelationSqlName});\n\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE TABLE ${newRelationSqlName} AS SELECT * FROM ${oldRelationSqlName}`,\n    );\n  } else {\n    await connector.query(`CREATE VIEW ${newRelationSqlName} AS ${viewSql}`);\n  }\n\n  await dropResultRelation({connector, relationName: oldRelationSqlName});\n}\n"]}
+{"version":3,"file":"resultRelationPolicy.js","sourceRoot":"","sources":["../src/resultRelationPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,+BAA+B,GAGhC,MAAM,kBAAkB,CAAC;AA4B1B,SAAS,iBAAiB,CAAC,YAAgC;IACzD,MAAM,iBAAiB,GACrB,OAAO,YAAY,KAAK,QAAQ;QAC9B,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,oBAAoB,GACxB,+BAA+B,CAAC,iBAAiB,CAAC,CAAC;IACrD,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qCAAqC,iBAAiB,IAAI,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAG1C;IACC,MAAM,EAAC,oBAAoB,EAAE,aAAa,EAAC,GAAG,IAAI,CAAC;IACnD,IAAI,oBAAoB;QAAE,OAAO,oBAAoB,CAAC;IACtD,OAAO,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,IAMnD;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAC,GAAG,IAAI,CAAC;IAClE,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,2BAA2B,eAAe,OAAO,GAAG,EAAE,EACtD;YACE,MAAM;SACP,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,SAAS,CAAC,KAAK,CAAC,0BAA0B,eAAe,OAAO,GAAG,EAAE,EAAE;QAC3E,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAGxC;IACC,MAAM,EAAC,SAAS,EAAE,YAAY,EAAC,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,YAAY;QAAE,OAAO;IAC1B,MAAM,eAAe,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,KAAK,CAAC,uBAAuB,eAAe,EAAE,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,KAAK,CAAC,wBAAwB,eAAe,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAM1C;IACC,MAAM,EAAC,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAC,GACxE,IAAI,CAAC;IACP,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE9D,yDAAyD;IACzD,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;IAExE,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,gBAAgB,kBAAkB,qBAAqB,kBAAkB,EAAE,CAC5E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,kBAAkB,OAAO,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,kBAAkB,CAAC,EAAC,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAC,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["import {\n  getRawSqlTableReference,\n  quoteParsedRawSqlTableReference,\n  type QualifiedTableName,\n  type RawSqlTableReference,\n} from '@sqlrooms/duckdb';\n\n/**\n * Centralized policy for persisting SQL cell query results.\n *\n * This module implements an adaptive strategy:\n * - first run chooses `table` when downstream dependencies exist, otherwise\n *   `view`;\n * - subsequent runs preserve the previously chosen relation type.\n *\n * The policy is shared by execution, rename, and cleanup paths so behavior\n * stays consistent across cross-cutting lifecycle events. Cleanup intentionally\n * drops both relation variants (`VIEW` and `TABLE`) because historical runs or\n * migrations may have created either form for the same logical result name.\n */\nexport type ResultRelationType = 'view' | 'table';\nexport type ResultRelationName =\n  | string\n  | QualifiedTableName\n  | RawSqlTableReference;\n\ntype SqlConnectorLike = {\n  query: (\n    sql: string,\n    options?: {signal?: AbortSignal},\n  ) => PromiseLike<unknown>;\n};\n\nfunction toRelationSqlName(relationName: ResultRelationName): string {\n  const relationReference =\n    typeof relationName === 'string'\n      ? relationName\n      : getRawSqlTableReference(relationName);\n  const rawSqlTableReference =\n    quoteParsedRawSqlTableReference(relationReference);\n  if (!rawSqlTableReference) {\n    throw new Error(`Invalid SQL cell result relation \"${relationReference}\".`);\n  }\n  return rawSqlTableReference;\n}\n\n/**\n * Chooses whether a SQL cell result should be stored as a logical view or a\n * materialized table.\n *\n * The policy is sticky: once a relation type has been selected for a cell,\n * later executions preserve that choice. On first execution, downstream usage\n * is used as a proxy for reuse.\n */\nexport function chooseAdaptiveRelationType(args: {\n  previousRelationType?: ResultRelationType;\n  hasDownstream: boolean;\n}): ResultRelationType {\n  const {previousRelationType, hasDownstream} = args;\n  if (previousRelationType) return previousRelationType;\n  return hasDownstream ? 'table' : 'view';\n}\n\n/**\n * Creates or replaces the relation that backs a SQL cell result.\n *\n * - `table`: materializes data for stable repeated reads.\n * - `view`: stores query definition for lightweight freshness.\n */\nexport async function createOrReplaceResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName: ResultRelationName;\n  relationType: ResultRelationType;\n  sql: string;\n  signal?: AbortSignal;\n}) {\n  const {connector, relationName, relationType, sql, signal} = args;\n  const relationSqlName = toRelationSqlName(relationName);\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE OR REPLACE TABLE ${relationSqlName} AS ${sql}`,\n      {\n        signal,\n      },\n    );\n    return;\n  }\n  await connector.query(`CREATE OR REPLACE VIEW ${relationSqlName} AS ${sql}`, {\n    signal,\n  });\n}\n\n/**\n * Drops both view and table variants for a relation name.\n *\n * This is intentionally defensive because different runs may have used\n * different relation modes.\n */\nexport async function dropResultRelation(args: {\n  connector: SqlConnectorLike;\n  relationName?: ResultRelationName;\n}) {\n  const {connector, relationName} = args;\n  if (!relationName) return;\n  const relationSqlName = toRelationSqlName(relationName);\n  await connector.query(`DROP VIEW IF EXISTS ${relationSqlName}`);\n  await connector.query(`DROP TABLE IF EXISTS ${relationSqlName}`);\n}\n\n/**\n * Renames a saved SQL cell result relation while preserving its mode.\n *\n * - `table`: copies current relation data into the new name.\n * - `view`: recreates the view definition under the new name.\n *\n * Any existing destination relation is removed first, and the old source name\n * is cleaned up after the new relation is created.\n */\nexport async function renameResultRelation(args: {\n  connector: SqlConnectorLike;\n  oldRelationName: ResultRelationName;\n  newRelationName: ResultRelationName;\n  relationType: ResultRelationType;\n  viewSql: string;\n}) {\n  const {connector, oldRelationName, newRelationName, relationType, viewSql} =\n    args;\n  const oldRelationSqlName = toRelationSqlName(oldRelationName);\n  const newRelationSqlName = toRelationSqlName(newRelationName);\n\n  // Clear destination first in case a stale object exists.\n  await dropResultRelation({connector, relationName: newRelationSqlName});\n\n  if (relationType === 'table') {\n    await connector.query(\n      `CREATE TABLE ${newRelationSqlName} AS SELECT * FROM ${oldRelationSqlName}`,\n    );\n  } else {\n    await connector.query(`CREATE VIEW ${newRelationSqlName} AS ${viewSql}`);\n  }\n\n  await dropResultRelation({connector, relationName: oldRelationSqlName});\n}\n"]}

package/dist/sqlHelpers.d.ts

@@ -1,4 +1,4 @@
-import type { Cell, Edge, SqlDependencyOptions, SqlRenderInput, SqlRunCallbacks, SqlRunResult } from './types';
+import type { Cell, CellDependencies, Edge, SqlDependencyOptions, SqlRenderInput, SqlRunCallbacks, SqlRunResult } from './types';
 export declare function deriveEdgesFromSql(cellId: string, sql: string, allCells: Record<string, Cell>): Edge[];
 export declare function renderSqlWithInputs(rawSql: string, inputs: SqlRenderInput[]): string;
 export declare function findSqlDependencies<TCell extends {
@@ -15,7 +15,7 @@ export declare function findSqlDependencies<TCell extends {
 export declare function runSqlWithCallbacks(run: () => Promise<SqlRunResult>, callbacks?: SqlRunCallbacks): Promise<void>;
 /**
  * Find SQL cell dependencies using AST-based parsing.
- * This provides more accurate detection than text-based matching.
+ * Returns cell dependencies and unmatched table references.
  */
 export declare function findSqlDependenciesFromAst(opts: {
     sql: string;
@@ -24,17 +24,17 @@ export declare function findSqlDependenciesFromAst(opts: {
         error: boolean;
         statements?: unknown[];
     }>;
-}): Promise<string[]>;
+}): Promise<CellDependencies>;
 /**
- * Rewrites unqualified references to known sheet-local result names as
+ * Rewrites unqualified references to known artifact-local result names as
  * schema-qualified references. This keeps SQL ergonomic without mutable
  * connector-level current schema state.
  */
-export declare function qualifySheetLocalResultNames(opts: {
+export declare function qualifyArtifactLocalResultNames(opts: {
     sql: string;
-    sheetSchema: string;
-    sheetDatabase?: string;
-    sheetCellIds: string[];
+    artifactSchema: string;
+    artifactDatabase?: string;
+    artifactCellIds: string[];
     cells: Record<string, Cell>;
     getSqlResultName: (cellId: string) => string | undefined;
 }): string;

package/dist/sqlHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlHelpers.d.ts","sourceRoot":"","sources":["../src/sqlHelpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,IAAI,EAEJ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAC7B,IAAI,EAAE,CA2BR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EAAE,GACvB,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,SAAS;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EACxC,IAAI,EAAE;IACN,UAAU,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,eAAe,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,GAAG,MAAM,EAAE,CAyCX;AAeD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAChC,SAAS,GAAE,eAAoB,iBAYhC;AAsCD;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QACxC,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;KACxB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkCpB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1D,GAAG,MAAM,CAqCT"}
+{"version":3,"file":"sqlHelpers.d.ts","sourceRoot":"","sources":["../src/sqlHelpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,IAAI,EAEJ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAC7B,IAAI,EAAE,CA2BR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EAAE,GACvB,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,SAAS;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,EACxC,IAAI,EAAE;IACN,UAAU,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,eAAe,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,GAAG,MAAM,EAAE,CAyCX;AAeD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAChC,SAAS,GAAE,eAAoB,iBAYhC;AAsCD;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QACxC,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;KACxB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwC5B;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC1D,GAAG,MAAM,CAqCT"}