@sqlrooms/duckdb-core 0.26.1-rc.11

package/dist/duckdb-utils.js

@@ -0,0 +1,290 @@
+export function isQualifiedTableName(tableName) {
+    return typeof tableName === 'object' && 'toString' in tableName;
+}
+/**
+ * Get a qualified table name from a table name, schema, and database.
+ * @param table - The name of the table.
+ * @param schema - The schema of the table.
+ * @param database - The database of the table.
+ * @returns The qualified table name.
+ */
+export function makeQualifiedTableName({ database, schema, table, }) {
+    const qualifiedTableName = [database, schema, table]
+        .filter((id) => id !== undefined && id !== null)
+        .map((id) => escapeId(id))
+        .join('.');
+    return {
+        database,
+        schema,
+        table,
+        toString: () => qualifiedTableName,
+    };
+}
+/**
+ * Escapes a value for use in DuckDB SQL queries by wrapping it in single quotes
+ * and escaping any existing single quotes by doubling them.
+ *
+ * @param val - The value to escape. Will be converted to string if not already a string.
+ * @returns The escaped string value wrapped in single quotes.
+ * @example
+ * escapeVal("John's data") // Returns "'John''s data'"
+ */
+export const escapeVal = (val) => {
+    return `'${String(val).replace(/'/g, "''")}'`;
+};
+/**
+ * Escapes an identifier (like table or column names) for use in DuckDB SQL queries
+ * by wrapping it in double quotes and escaping any existing double quotes by doubling them.
+ * If the identifier is already properly quoted, returns it as is.
+ *
+ * @param id - The identifier string to escape
+ * @returns The escaped identifier wrapped in double quotes
+ * @example
+ * escapeId("my_table") // Returns '"my_table"'
+ * escapeId("my""table") // Returns '"my""""table"'
+ */
+export const escapeId = (id) => {
+    const str = String(id);
+    if (str.startsWith('"') && str.endsWith('"')) {
+        return str;
+    }
+    return `"${str.replace(/"/g, '""')}"`;
+};
+/**
+ * Checks if a DuckDB type string represents a numeric type.
+ * Includes INTEGER, DECIMAL, FLOAT, REAL, and DOUBLE types.
+ *
+ * @param type - The DuckDB type string to check
+ * @returns True if the type is numeric, false otherwise
+ * @example
+ * isNumericDuckType('INTEGER') // Returns true
+ * isNumericDuckType('VARCHAR') // Returns false
+ */
+export const isNumericDuckType = (type) => type.indexOf('INT') >= 0 ||
+    type.indexOf('DECIMAL') >= 0 ||
+    type.indexOf('FLOAT') >= 0 ||
+    type.indexOf('REAL') >= 0 ||
+    type.indexOf('DOUBLE') >= 0;
+/**
+ * Extracts a numeric value from an Arrow Table at the specified column and row index.
+ * Handles both column name and index-based access. Converts BigInt values to numbers.
+ *
+ * @param res - The Arrow Table containing the data
+ * @param column - The column name or index (0-based) to read from. Defaults to first column (0)
+ * @param index - The row index (0-based) to read from. Defaults to first row (0)
+ * @returns The numeric value at the specified position, or NaN if the value is null/undefined
+ * @example
+ * const value = getColValAsNumber(table, "amount", 0)
+ */
+export function getColValAsNumber(res, column = 0, index = 0) {
+    const v = (typeof column === 'number' ? res.getChildAt(column) : res.getChild(column))?.get(index);
+    if (v === undefined || v === null) {
+        return NaN;
+    }
+    // if it's an array (can be returned by duckdb as bigint)
+    return Number(v[0] ?? v);
+}
+/**
+ * Function given a query and position finds the line and column of the console.error();
+ *
+ * @param query - The query to parse
+ * @param position - The position of the error
+ * @returns The line and column of the error
+ */
+export const getSqlErrorWithPointer = (query, position) => {
+    // Clamp position to be within the string bounds
+    const safePos = Math.max(0, Math.min(position, query.length));
+    // Get the substring up to the error position
+    const upToPos = query.slice(0, safePos);
+    // Split by newlines
+    const lines = upToPos.split('\n');
+    const line = lines.length; // 1-based
+    // Defensive: lines[lines.length - 1] is always defined, but add fallback for linter
+    const lastLine = lines[lines.length - 1] ?? '';
+    const column = lastLine.length + 1; // 1-based
+    // Get the full line text from the original query
+    const queryLines = query.split('\n');
+    const lineText = queryLines[line - 1] ?? '';
+    // Pointer line: spaces up to column-1, then ^
+    const pointerLine = ' '.repeat(Math.max(0, column - 1)) + '^';
+    // Formatted output as requested
+    const formatted = `LINE ${line}: ${lineText}\n${' '.repeat(`LINE ${line}: `.length)}${pointerLine}`;
+    return { line, column, lineText, pointerLine, formatted };
+};
+//
+// const queries = splitSqlStatements(`
+//   SELECT * FROM users WHERE name = 'John;Doe';
+//   SELECT * FROM orders -- This comment; won't break;
+//   /*
+//      Multi-line comment;
+//      With semicolons;
+//   */
+//   SELECT "Quoted;identifier" FROM table;
+//`);
+// Returns:
+// [
+//   "SELECT * FROM users WHERE name = 'John;Doe'",
+//   "SELECT * FROM orders -- This comment; won't break",
+//   "SELECT \"Quoted;identifier\" FROM table"
+// ]
+/**
+ * Split a string with potentially multiple SQL queries (separated as usual by ';')
+ * into an array of queries.
+ * This implementation:
+ *  - Handles single and double quoted strings with proper escaping
+ *  - Removes all comments: line comments (--) and block comments (/* ... *\/)
+ *  - Ignores semicolons in quoted strings and comments
+ *  - Trims whitespace from queries
+ *  - Handles SQL-style escaped quotes ('' inside strings)
+ *  - Returns only non-empty queries
+ *
+ * @param input - The SQL string containing one or more statements
+ * @returns An array of SQL statements with all comments removed
+ */
+export function splitSqlStatements(input) {
+    const queries = [];
+    let currentQuery = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        if (inLineComment) {
+            if (char === '\n') {
+                inLineComment = false;
+                currentQuery += char; // preserve newlines for line numbers
+            }
+            // else: skip comment chars
+            continue;
+        }
+        if (inBlockComment) {
+            if (char === '*' && input[i + 1] === '/') {
+                inBlockComment = false;
+                i++; // skip '/'
+            }
+            // else: skip comment chars
+            continue;
+        }
+        if (inSingleQuote) {
+            currentQuery += char;
+            if (char === "'") {
+                // Handle escaped single quotes in SQL
+                if (i + 1 < input.length && input[i + 1] === "'") {
+                    currentQuery += input[++i];
+                }
+                else {
+                    inSingleQuote = false;
+                }
+            }
+            continue;
+        }
+        if (inDoubleQuote) {
+            currentQuery += char;
+            if (char === '"') {
+                // Handle escaped double quotes
+                if (i + 1 < input.length && input[i + 1] === '"') {
+                    currentQuery += input[++i];
+                }
+                else {
+                    inDoubleQuote = false;
+                }
+            }
+            continue;
+        }
+        // Check for comment starts
+        if (char === '-' && input[i + 1] === '-') {
+            inLineComment = true;
+            i++; // skip next '-'
+            continue;
+        }
+        if (char === '/' && input[i + 1] === '*') {
+            inBlockComment = true;
+            i++; // skip next '*'
+            continue;
+        }
+        // Check for quote starts
+        if (char === "'") {
+            inSingleQuote = true;
+            currentQuery += char;
+            continue;
+        }
+        if (char === '"') {
+            inDoubleQuote = true;
+            currentQuery += char;
+            continue;
+        }
+        // Handle query separator
+        if (char === ';') {
+            const trimmed = currentQuery.trim();
+            if (trimmed.length > 0) {
+                queries.push(trimmed);
+            }
+            currentQuery = '';
+            continue;
+        }
+        currentQuery += char;
+    }
+    // Add the final query
+    const trimmed = currentQuery.trim();
+    if (trimmed.length > 0) {
+        queries.push(trimmed);
+    }
+    return queries;
+}
+/**
+ * Sanitizes a SQL query by removing trailing semicolons, comments, and normalizing whitespace
+ */
+export function sanitizeQuery(query) {
+    return query
+        .trim() // Remove leading/trailing whitespace
+        .replace(/;+$/, '') // Remove all trailing semicolons
+        .replace(/--.*$/gm, '') // Remove single-line comments
+        .replace(/\/\*[\s\S]*?\*\//g, '') // Remove multi-line comments
+        .replace(/\s+/g, ' '); // Normalize whitespace to single spaces
+}
+/**
+ * Make a limit query from a query and a limit.
+ * @param query - The SELECT query to make limited.
+ * @param options - The options for the limit query.
+ * @param options.limit - The number of rows to limit the query to.
+ * @param options.offset - The number of rows to offset the query by.
+ * @param options.sanitize - Whether to sanitize the query.
+ * @returns The limited query.
+ */
+export function makeLimitQuery(query, { limit = 100, offset = 0, sanitize = true, } = {}) {
+    return `SELECT * FROM (
+    ${sanitize ? sanitizeQuery(query) : query}
+  ) LIMIT ${limit} OFFSET ${offset}`;
+}
+/**
+ * Separates a SQL query into preceding statements and the last statement.
+ * Useful when you need to execute multiple statements but handle the last one differently
+ * (e.g., wrap it in CREATE TABLE, add LIMIT, etc.).
+ *
+ * @param query - The SQL query string containing one or more statements
+ * @returns Object containing preceding statements and the last statement
+ * @throws Error if the query contains no statements
+ */
+export function separateLastStatement(query) {
+    const statements = splitSqlStatements(query);
+    if (statements.length === 0) {
+        throw new Error('Query must contain at least one statement');
+    }
+    return {
+        precedingStatements: statements.slice(0, -1),
+        lastStatement: statements[statements.length - 1],
+    };
+}
+/**
+ * Joins preceding statements with a (potentially modified) last statement into a single query.
+ * @param precedingStatements - Statements to execute before the last one
+ * @param lastStatement - The final statement (can be modified, e.g., wrapped in CREATE TABLE)
+ * @returns A single query string with all statements joined by semicolons
+ */
+export function joinStatements(precedingStatements, lastStatement) {
+    return precedingStatements.length > 0
+        ? [...precedingStatements, lastStatement].join(';\n')
+        : lastStatement;
+}
+//# sourceMappingURL=duckdb-utils.js.map

package/dist/duckdb-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-utils.js","sourceRoot":"","sources":["../src/duckdb-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import * as arrow from 'apache-arrow';\n\nexport type QualifiedTableName = {\n  database?: string;\n  schema?: string;\n  table: string;\n  toString: () => string;\n};\n\nexport function isQualifiedTableName(\n  tableName: string | QualifiedTableName,\n): tableName is QualifiedTableName {\n  return typeof tableName === 'object' && 'toString' in tableName;\n}\n\n/**\n * Get a qualified table name from a table name, schema, and database.\n * @param table - The name of the table.\n * @param schema - The schema of the table.\n * @param database - The database of the table.\n * @returns The qualified table name.\n */\nexport function makeQualifiedTableName({\n  database,\n  schema,\n  table,\n}: QualifiedTableName) {\n  const qualifiedTableName = [database, schema, table]\n    .filter((id) => id !== undefined && id !== null)\n    .map((id) => escapeId(id))\n    .join('.');\n  return {\n    database,\n    schema,\n    table,\n    toString: () => qualifiedTableName,\n  };\n}\n\n/**\n * Escapes a value for use in DuckDB SQL queries by wrapping it in single quotes\n * and escaping any existing single quotes by doubling them.\n *\n * @param val - The value to escape. Will be converted to string if not already a string.\n * @returns The escaped string value wrapped in single quotes.\n * @example\n * escapeVal(\"John's data\") // Returns \"'John''s data'\"\n */\nexport const escapeVal = (val: unknown) => {\n  return `'${String(val).replace(/'/g, \"''\")}'`;\n};\n\n/**\n * Escapes an identifier (like table or column names) for use in DuckDB SQL queries\n * by wrapping it in double quotes and escaping any existing double quotes by doubling them.\n * If the identifier is already properly quoted, returns it as is.\n *\n * @param id - The identifier string to escape\n * @returns The escaped identifier wrapped in double quotes\n * @example\n * escapeId(\"my_table\") // Returns '\"my_table\"'\n * escapeId(\"my\"\"table\") // Returns '\"my\"\"\"\"table\"'\n */\nexport const escapeId = (id: string) => {\n  const str = String(id);\n  if (str.startsWith('\"') && str.endsWith('\"')) {\n    return str;\n  }\n  return `\"${str.replace(/\"/g, '\"\"')}\"`;\n};\n\n/**\n * Checks if a DuckDB type string represents a numeric type.\n * Includes INTEGER, DECIMAL, FLOAT, REAL, and DOUBLE types.\n *\n * @param type - The DuckDB type string to check\n * @returns True if the type is numeric, false otherwise\n * @example\n * isNumericDuckType('INTEGER') // Returns true\n * isNumericDuckType('VARCHAR') // Returns false\n */\nexport const isNumericDuckType = (type: string) =>\n  type.indexOf('INT') >= 0 ||\n  type.indexOf('DECIMAL') >= 0 ||\n  type.indexOf('FLOAT') >= 0 ||\n  type.indexOf('REAL') >= 0 ||\n  type.indexOf('DOUBLE') >= 0;\n\n/**\n * Extracts a numeric value from an Arrow Table at the specified column and row index.\n * Handles both column name and index-based access. Converts BigInt values to numbers.\n *\n * @param res - The Arrow Table containing the data\n * @param column - The column name or index (0-based) to read from. Defaults to first column (0)\n * @param index - The row index (0-based) to read from. Defaults to first row (0)\n * @returns The numeric value at the specified position, or NaN if the value is null/undefined\n * @example\n * const value = getColValAsNumber(table, \"amount\", 0)\n */\nexport function getColValAsNumber(\n  res: arrow.Table,\n  column: string | number = 0,\n  index = 0,\n): number {\n  const v = (\n    typeof column === 'number' ? res.getChildAt(column) : res.getChild(column)\n  )?.get(index);\n  if (v === undefined || v === null) {\n    return NaN;\n  }\n  // if it's an array (can be returned by duckdb as bigint)\n  return Number(v[0] ?? v);\n}\n\n/**\n * Function given a query and position finds the line and column of the console.error();\n *\n * @param query - The query to parse\n * @param position - The position of the error\n * @returns The line and column of the error\n */\nexport const getSqlErrorWithPointer = (query: string, position: number) => {\n  // Clamp position to be within the string bounds\n  const safePos = Math.max(0, Math.min(position, query.length));\n  // Get the substring up to the error position\n  const upToPos = query.slice(0, safePos);\n  // Split by newlines\n  const lines = upToPos.split('\\n');\n  const line = lines.length; // 1-based\n  // Defensive: lines[lines.length - 1] is always defined, but add fallback for linter\n  const lastLine = lines[lines.length - 1] ?? '';\n  const column = lastLine.length + 1; // 1-based\n\n  // Get the full line text from the original query\n  const queryLines = query.split('\\n');\n  const lineText = queryLines[line - 1] ?? '';\n  // Pointer line: spaces up to column-1, then ^\n  const pointerLine = ' '.repeat(Math.max(0, column - 1)) + '^';\n\n  // Formatted output as requested\n  const formatted = `LINE ${line}: ${lineText}\\n${' '.repeat(`LINE ${line}: `.length)}${pointerLine}`;\n\n  return {line, column, lineText, pointerLine, formatted};\n};\n\n//\n// const queries = splitSqlStatements(`\n//   SELECT * FROM users WHERE name = 'John;Doe';\n//   SELECT * FROM orders -- This comment; won't break;\n//   /*\n//      Multi-line comment;\n//      With semicolons;\n//   */\n//   SELECT \"Quoted;identifier\" FROM table;\n//`);\n\n// Returns:\n// [\n//   \"SELECT * FROM users WHERE name = 'John;Doe'\",\n//   \"SELECT * FROM orders -- This comment; won't break\",\n//   \"SELECT \\\"Quoted;identifier\\\" FROM table\"\n// ]\n\n/**\n * Split a string with potentially multiple SQL queries (separated as usual by ';')\n * into an array of queries.\n * This implementation:\n *  - Handles single and double quoted strings with proper escaping\n *  - Removes all comments: line comments (--) and block comments (/* ... *\\/)\n *  - Ignores semicolons in quoted strings and comments\n *  - Trims whitespace from queries\n *  - Handles SQL-style escaped quotes ('' inside strings)\n *  - Returns only non-empty queries\n *\n * @param input - The SQL string containing one or more statements\n * @returns An array of SQL statements with all comments removed\n */\nexport function splitSqlStatements(input: string): string[] {\n  const queries: string[] = [];\n  let currentQuery = '';\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n  let inLineComment = false;\n  let inBlockComment = false;\n\n  for (let i = 0; i < input.length; i++) {\n    const char = input[i];\n\n    if (inLineComment) {\n      if (char === '\\n') {\n        inLineComment = false;\n        currentQuery += char; // preserve newlines for line numbers\n      }\n      // else: skip comment chars\n      continue;\n    }\n\n    if (inBlockComment) {\n      if (char === '*' && input[i + 1] === '/') {\n        inBlockComment = false;\n        i++; // skip '/'\n      }\n      // else: skip comment chars\n      continue;\n    }\n\n    if (inSingleQuote) {\n      currentQuery += char;\n      if (char === \"'\") {\n        // Handle escaped single quotes in SQL\n        if (i + 1 < input.length && input[i + 1] === \"'\") {\n          currentQuery += input[++i];\n        } else {\n          inSingleQuote = false;\n        }\n      }\n      continue;\n    }\n\n    if (inDoubleQuote) {\n      currentQuery += char;\n      if (char === '\"') {\n        // Handle escaped double quotes\n        if (i + 1 < input.length && input[i + 1] === '\"') {\n          currentQuery += input[++i];\n        } else {\n          inDoubleQuote = false;\n        }\n      }\n      continue;\n    }\n\n    // Check for comment starts\n    if (char === '-' && input[i + 1] === '-') {\n      inLineComment = true;\n      i++; // skip next '-'\n      continue;\n    }\n\n    if (char === '/' && input[i + 1] === '*') {\n      inBlockComment = true;\n      i++; // skip next '*'\n      continue;\n    }\n\n    // Check for quote starts\n    if (char === \"'\") {\n      inSingleQuote = true;\n      currentQuery += char;\n      continue;\n    }\n\n    if (char === '\"') {\n      inDoubleQuote = true;\n      currentQuery += char;\n      continue;\n    }\n\n    // Handle query separator\n    if (char === ';') {\n      const trimmed = currentQuery.trim();\n      if (trimmed.length > 0) {\n        queries.push(trimmed);\n      }\n      currentQuery = '';\n      continue;\n    }\n\n    currentQuery += char;\n  }\n\n  // Add the final query\n  const trimmed = currentQuery.trim();\n  if (trimmed.length > 0) {\n    queries.push(trimmed);\n  }\n\n  return queries;\n}\n\n/**\n * Sanitizes a SQL query by removing trailing semicolons, comments, and normalizing whitespace\n */\nexport function sanitizeQuery(query: string): string {\n  return query\n    .trim() // Remove leading/trailing whitespace\n    .replace(/;+$/, '') // Remove all trailing semicolons\n    .replace(/--.*$/gm, '') // Remove single-line comments\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // Remove multi-line comments\n    .replace(/\\s+/g, ' '); // Normalize whitespace to single spaces\n}\n\n/**\n * Make a limit query from a query and a limit.\n * @param query - The SELECT query to make limited.\n * @param options - The options for the limit query.\n * @param options.limit - The number of rows to limit the query to.\n * @param options.offset - The number of rows to offset the query by.\n * @param options.sanitize - Whether to sanitize the query.\n * @returns The limited query.\n */\nexport function makeLimitQuery(\n  query: string,\n  {\n    limit = 100,\n    offset = 0,\n    sanitize = true,\n  }: {\n    limit?: number;\n    offset?: number;\n    sanitize?: boolean;\n  } = {},\n) {\n  return `SELECT * FROM (\n    ${sanitize ? sanitizeQuery(query) : query}\n  ) LIMIT ${limit} OFFSET ${offset}`;\n}\n\n/**\n * Result of separating the last SQL statement from preceding ones.\n */\nexport type SeparatedStatements = {\n  /** All statements except the last one */\n  precedingStatements: string[];\n  /** The last statement */\n  lastStatement: string;\n};\n\n/**\n * Separates a SQL query into preceding statements and the last statement.\n * Useful when you need to execute multiple statements but handle the last one differently\n * (e.g., wrap it in CREATE TABLE, add LIMIT, etc.).\n *\n * @param query - The SQL query string containing one or more statements\n * @returns Object containing preceding statements and the last statement\n * @throws Error if the query contains no statements\n */\nexport function separateLastStatement(query: string): SeparatedStatements {\n  const statements = splitSqlStatements(query);\n  if (statements.length === 0) {\n    throw new Error('Query must contain at least one statement');\n  }\n  return {\n    precedingStatements: statements.slice(0, -1),\n    lastStatement: statements[statements.length - 1] as string,\n  };\n}\n\n/**\n * Joins preceding statements with a (potentially modified) last statement into a single query.\n * @param precedingStatements - Statements to execute before the last one\n * @param lastStatement - The final statement (can be modified, e.g., wrapped in CREATE TABLE)\n * @returns A single query string with all statements joined by semicolons\n */\nexport function joinStatements(\n  precedingStatements: string[],\n  lastStatement: string,\n): string {\n  return precedingStatements.length > 0\n    ? [...precedingStatements, lastStatement].join(';\\n')\n    : lastStatement;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createTypedRowAccessor } from './typedRowAccessor';
+export type { TypedRowAccessor } from './typedRowAccessor';
+export { createBaseDuckDbConnector, type BaseDuckDbConnectorOptions, type BaseDuckDbConnectorImpl, } from './BaseDuckDbConnector';
+export { literalToSQL, sqlFrom, load, loadCSV, loadJSON, loadParquet, loadSpatial, loadObjects, } from './load/load';
+export { type QueryOptions, type QueryHandle, type DuckDbConnector, } from './DuckDbConnector';
+export { arrowTableToJson } from './arrow-utils';
+export { isQualifiedTableName, makeQualifiedTableName, escapeVal, escapeId, isNumericDuckType, getColValAsNumber, getSqlErrorWithPointer, splitSqlStatements, sanitizeQuery, makeLimitQuery, separateLastStatement, joinStatements, type QualifiedTableName, type SeparatedStatements, } from './duckdb-utils';
+export { getDuckDbTypeCategory, getArrowColumnTypeCategory, type ColumnTypeCategory, } from './schema-tree/typeCategories';
+export { createDbSchemaTrees } from './schema-tree/schemaTree';
+export { type DbSchemaNode, type NodeObject, type ColumnNodeObject, type TableNodeObject, type SchemaNodeObject, type DatabaseNodeObject, } from './schema-tree/types';
+export { type TableColumn, type DataTable } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAC,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createTypedRowAccessor } from './typedRowAccessor';
+export { createBaseDuckDbConnector, } from './BaseDuckDbConnector';
+export { literalToSQL, sqlFrom, load, loadCSV, loadJSON, loadParquet, loadSpatial, loadObjects, } from './load/load';
+export { arrowTableToJson } from './arrow-utils';
+export { isQualifiedTableName, makeQualifiedTableName, escapeVal, escapeId, isNumericDuckType, getColValAsNumber, getSqlErrorWithPointer, splitSqlStatements, sanitizeQuery, makeLimitQuery, separateLastStatement, joinStatements, } from './duckdb-utils';
+export { getDuckDbTypeCategory, getArrowColumnTypeCategory, } from './schema-tree/typeCategories';
+export { createDbSchemaTrees } from './schema-tree/schemaTree';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,yBAAyB,GAG1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAQrB,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE/C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC","sourcesContent":["export {createTypedRowAccessor} from './typedRowAccessor';\nexport type {TypedRowAccessor} from './typedRowAccessor';\n\nexport {\n  createBaseDuckDbConnector,\n  type BaseDuckDbConnectorOptions,\n  type BaseDuckDbConnectorImpl,\n} from './BaseDuckDbConnector';\n\nexport {\n  literalToSQL,\n  sqlFrom,\n  load,\n  loadCSV,\n  loadJSON,\n  loadParquet,\n  loadSpatial,\n  loadObjects,\n} from './load/load';\n\nexport {\n  type QueryOptions,\n  type QueryHandle,\n  type DuckDbConnector,\n} from './DuckDbConnector';\n\nexport {arrowTableToJson} from './arrow-utils';\n\nexport {\n  isQualifiedTableName,\n  makeQualifiedTableName,\n  escapeVal,\n  escapeId,\n  isNumericDuckType,\n  getColValAsNumber,\n  getSqlErrorWithPointer,\n  splitSqlStatements,\n  sanitizeQuery,\n  makeLimitQuery,\n  separateLastStatement,\n  joinStatements,\n  type QualifiedTableName,\n  type SeparatedStatements,\n} from './duckdb-utils';\n\nexport {\n  getDuckDbTypeCategory,\n  getArrowColumnTypeCategory,\n  type ColumnTypeCategory,\n} from './schema-tree/typeCategories';\n\nexport {createDbSchemaTrees} from './schema-tree/schemaTree';\n\nexport {\n  type DbSchemaNode,\n  type NodeObject,\n  type ColumnNodeObject,\n  type TableNodeObject,\n  type SchemaNodeObject,\n  type DatabaseNodeObject,\n} from './schema-tree/types';\n\nexport {type TableColumn, type DataTable} from './types';\n"]}

package/dist/load/create.d.ts

@@ -0,0 +1,33 @@
+interface TableOptions {
+    /** Whether to replace existing table/view if it exists */
+    replace?: boolean;
+    /** Whether to create a temporary table/view */
+    temp?: boolean;
+    /** Whether to create a view instead of a table */
+    view?: boolean;
+}
+interface SchemaOptions {
+    /** Whether to enforce strict schema creation (no IF NOT EXISTS) */
+    strict?: boolean;
+}
+/**
+ * Creates a SQL query string to create a new table or view in DuckDB
+ * @param name - Name of the table or view to create
+ * @param query - SQL query whose results will populate the table/view
+ * @param options - Options for table/view creation
+ * @param options.replace - Whether to replace existing table/view if it exists (default: false)
+ * @param options.temp - Whether to create a temporary table/view (default: false)
+ * @param options.view - Whether to create a view instead of a table (default: false)
+ * @returns SQL query string to create the table/view
+ */
+export declare function createTable(name: string, query: string, { replace, temp, view }?: TableOptions): string;
+/**
+ * Creates a SQL query string to create a new schema in DuckDB
+ * @param name - Name of the schema to create
+ * @param options - Options for schema creation
+ * @param options.strict - Whether to enforce strict schema creation (no IF NOT EXISTS) (default: false)
+ * @returns SQL query string to create the schema
+ */
+export declare function createSchema(name: string, { strict }?: SchemaOptions): string;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/load/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/load/create.ts"],"names":[],"mappings":"AAGA,UAAU,YAAY;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,EAAC,OAAe,EAAE,IAAY,EAAE,IAAY,EAAC,GAAE,YAAiB,GAC/D,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,EAAC,MAAc,EAAC,GAAE,aAAkB,GACnC,MAAM,CAER"}

package/dist/load/create.js

@@ -0,0 +1,33 @@
+// Adapted from https://github.com/uwdata/mosaic/blob/main/packages/sql/src/load/
+// BSD 3-Clause License Copyright (c) 2023, UW Interactive Data Lab
+/**
+ * Creates a SQL query string to create a new table or view in DuckDB
+ * @param name - Name of the table or view to create
+ * @param query - SQL query whose results will populate the table/view
+ * @param options - Options for table/view creation
+ * @param options.replace - Whether to replace existing table/view if it exists (default: false)
+ * @param options.temp - Whether to create a temporary table/view (default: false)
+ * @param options.view - Whether to create a view instead of a table (default: false)
+ * @returns SQL query string to create the table/view
+ */
+export function createTable(name, query, { replace = false, temp = false, view = false } = {}) {
+    return ('CREATE' +
+        (replace ? ' OR REPLACE ' : ' ') +
+        (temp ? 'TEMP ' : '') +
+        (view ? 'VIEW' : 'TABLE') +
+        (replace ? ' ' : ' IF NOT EXISTS ') +
+        name +
+        ' AS ' +
+        query);
+}
+/**
+ * Creates a SQL query string to create a new schema in DuckDB
+ * @param name - Name of the schema to create
+ * @param options - Options for schema creation
+ * @param options.strict - Whether to enforce strict schema creation (no IF NOT EXISTS) (default: false)
+ * @returns SQL query string to create the schema
+ */
+export function createSchema(name, { strict = false } = {}) {
+    return 'CREATE SCHEMA ' + (strict ? '' : 'IF NOT EXISTS ') + name;
+}
+//# sourceMappingURL=create.js.map

package/dist/load/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/load/create.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,mEAAmE;AAgBnE;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,KAAa,EACb,EAAC,OAAO,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,KAAkB,EAAE;IAEhE,OAAO,CACL,QAAQ;QACR,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC;QAChC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACzB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACnC,IAAI;QACJ,MAAM;QACN,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,EAAC,MAAM,GAAG,KAAK,KAAmB,EAAE;IAEpC,OAAO,gBAAgB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;AACpE,CAAC","sourcesContent":["// Adapted from https://github.com/uwdata/mosaic/blob/main/packages/sql/src/load/\n// BSD 3-Clause License Copyright (c) 2023, UW Interactive Data Lab\n\ninterface TableOptions {\n  /** Whether to replace existing table/view if it exists */\n  replace?: boolean;\n  /** Whether to create a temporary table/view */\n  temp?: boolean;\n  /** Whether to create a view instead of a table */\n  view?: boolean;\n}\n\ninterface SchemaOptions {\n  /** Whether to enforce strict schema creation (no IF NOT EXISTS) */\n  strict?: boolean;\n}\n\n/**\n * Creates a SQL query string to create a new table or view in DuckDB\n * @param name - Name of the table or view to create\n * @param query - SQL query whose results will populate the table/view\n * @param options - Options for table/view creation\n * @param options.replace - Whether to replace existing table/view if it exists (default: false)\n * @param options.temp - Whether to create a temporary table/view (default: false)\n * @param options.view - Whether to create a view instead of a table (default: false)\n * @returns SQL query string to create the table/view\n */\nexport function createTable(\n  name: string,\n  query: string,\n  {replace = false, temp = false, view = false}: TableOptions = {},\n): string {\n  return (\n    'CREATE' +\n    (replace ? ' OR REPLACE ' : ' ') +\n    (temp ? 'TEMP ' : '') +\n    (view ? 'VIEW' : 'TABLE') +\n    (replace ? ' ' : ' IF NOT EXISTS ') +\n    name +\n    ' AS ' +\n    query\n  );\n}\n\n/**\n * Creates a SQL query string to create a new schema in DuckDB\n * @param name - Name of the schema to create\n * @param options - Options for schema creation\n * @param options.strict - Whether to enforce strict schema creation (no IF NOT EXISTS) (default: false)\n * @returns SQL query string to create the schema\n */\nexport function createSchema(\n  name: string,\n  {strict = false}: SchemaOptions = {},\n): string {\n  return 'CREATE SCHEMA ' + (strict ? '' : 'IF NOT EXISTS ') + name;\n}\n"]}

package/dist/load/load.d.ts

@@ -0,0 +1,57 @@
+import { LoadFile, SpatialLoadOptions, StandardLoadOptions } from '@sqlrooms/room-config';
+import { literalToSQL, sqlFrom } from './sql-from';
+export { literalToSQL, sqlFrom };
+/**
+ * Generic function to load data from a file into a DuckDB table
+ * @param method - The DuckDB read method to use (e.g., 'read_csv', 'read_json')
+ * @param tableName - Name of the table to create
+ * @param fileName - Path to the input file
+ * @param options - Load options including select, where, view, temp, replace and file-specific options
+ * @param defaults - Default options to merge with provided options
+ * @returns SQL query string to create the table
+ */
+export declare function load(method: LoadFile, tableName: string, fileName: string, options?: StandardLoadOptions, defaults?: Record<string, unknown>): string;
+/**
+ * Load data from a CSV file into a DuckDB table
+ * @param tableName - Name of the table to create
+ * @param fileName - Path to the CSV file
+ * @param options - Load options
+ * @returns SQL query string to create the table
+ */
+export declare function loadCSV(tableName: string, fileName: string, options?: StandardLoadOptions): string;
+/**
+ * Load data from a JSON file into a DuckDB table
+ * @param tableName - Name of the table to create
+ * @param fileName - Path to the JSON file
+ * @param options - Load options
+ * @returns SQL query string to create the table
+ */
+export declare function loadJSON(tableName: string, fileName: string, options?: StandardLoadOptions): string;
+/**
+ * Load data from a Parquet file into a DuckDB table
+ * @param tableName - Name of the table to create
+ * @param fileName - Path to the Parquet file
+ * @param options - Load options
+ * @returns SQL query string to create the table
+ */
+export declare function loadParquet(tableName: string, fileName: string, options?: StandardLoadOptions): string;
+/**
+ * Load geometry data within a spatial file format.
+ * This method requires that the DuckDB spatial extension is loaded.
+ * Supports GeoJSON, TopoJSON, and other common spatial formats.
+ * For TopoJSON, set the layer option to indicate the feature to extract.
+ * @param tableName - Name of the table to create
+ * @param fileName - Path to the spatial data file
+ * @param options - Load options including spatial-specific options
+ * @returns SQL query string to create the table
+ */
+export declare function loadSpatial(tableName: string, fileName: string, options?: SpatialLoadOptions): string;
+/**
+ * Load JavaScript objects directly into a DuckDB table
+ * @param tableName - Name of the table to create
+ * @param data - Array of objects to load
+ * @param options - Load options
+ * @returns SQL query string to create the table
+ */
+export declare function loadObjects(tableName: string, data: Record<string, unknown>[], options?: StandardLoadOptions): string;
+//# sourceMappingURL=load.d.ts.map

package/dist/load/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/load/load.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAC,YAAY,EAAE,OAAO,EAAC,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAC,YAAY,EAAE,OAAO,EAAC,CAAC;AAE/B;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAClB,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CA2BR;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAsBR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAQR"}