@nshiab/simple-data-analysis-core 2.1.12 → 2.1.13

package/script/helpers/publishPreparedColumns.js

@@ -1,103 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = publishPreparedColumns;
-const foldIdentifier_js_1 = __importDefault(require("./foldIdentifier.js"));
-const mergeOptions_js_1 = __importDefault(require("./mergeOptions.js"));
-const queryDB_js_1 = __importDefault(require("./queryDB.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-/**
- * Publishes validated algorithm outputs from a prepared numeric
- * feature snapshot. New outputs are appended, while replacements retain the
- * source column's position. Existing native DuckDB indexes are recreated after
- * table replacement because CREATE OR REPLACE drops them.
- *
- * Output expressions are trusted internal SQL. They may reference `p`, the
- * prepared relation alias, and `r` when a result relation is supplied. The
- * consumer must fully compute and validate one result row per prepared row
- * before calling this helper, and remains responsible for scratch cleanup.
- */
-async function publishPreparedColumns(table, prepared, options) {
-    validateOutputs(prepared.sourceColumns, options.outputs);
-    const connection = table.connection;
-    const q = quoteIdentifier_js_1.default;
-    const source = q(table.name);
-    const tableDetails = (await connection.runAndReadAll(`SELECT table_oid FROM duckdb_tables()
-     WHERE translate(table_name, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz') = $1
-       AND schema_name = current_schema()
-       AND database_name IN (current_database(), 'temp')
-       AND temporary = $2
-     LIMIT 1`, [(0, foldIdentifier_js_1.default)(table.name), prepared.sourceTemporary])).getRowsJS()[0];
-    if (tableDetails === undefined) {
-        throw new Error(`${options.method} requires a materialized source table.`);
-    }
-    const tableOid = tableDetails[0];
-    if (typeof tableOid !== "number" && typeof tableOid !== "bigint") {
-        throw new Error(`${options.method} could not identify the source table.`);
-    }
-    const indexes = (await connection.runAndReadAll("SELECT sql FROM duckdb_indexes() WHERE table_oid = $1 ORDER BY index_name", [tableOid])).getRowsJS().map((row) => String(row[0]));
-    const replacements = new Map(options.outputs.filter((output) => output.replace !== undefined).map((output) => [(0, foldIdentifier_js_1.default)(output.replace), output]));
-    const select = prepared.sourceColumns.map((column) => {
-        const replacement = replacements.get((0, foldIdentifier_js_1.default)(column));
-        return replacement === undefined
-            ? `p.${q(column)}`
-            : `${replacement.expression} AS ${q(column)}`;
-    });
-    for (const output of options.outputs) {
-        if (output.replace === undefined) {
-            select.push(`${output.expression} AS ${q(output.name)}`);
-        }
-    }
-    const resultJoin = options.result === undefined
-        ? ""
-        : ` JOIN ${q(options.result.relation)} r
-      ON p.${q(prepared.rowIdColumn)} = r.${q(options.result.rowIdColumn)}`;
-    await (0, queryDB_js_1.default)(table, `CREATE OR REPLACE ${prepared.sourceTemporary ? "TEMP " : ""}TABLE ${source} AS
-     SELECT ${select.join(", ")}
-     FROM ${q(prepared.relation)} p${resultJoin}
-     ORDER BY p.${q(prepared.rowIdColumn)}`, (0, mergeOptions_js_1.default)(table, {
-        table: table.name,
-        method: options.method,
-        parameters: options.parameters,
-        noClean: true,
-    }));
-    for (const sql of indexes) {
-        try {
-            await connection.run(sql);
-        }
-        catch (error) {
-            const detail = error instanceof Error ? ` ${error.message}` : "";
-            throw new Error(`${options.method} could not restore an existing DuckDB index while publishing its output. Remove or rebuild indexes that do not support the output column types.${detail}`, { cause: error });
-        }
-    }
-}
-function validateOutputs(sourceColumns, outputs) {
-    const outputNames = new Set();
-    const replacements = new Set();
-    for (const output of outputs) {
-        const outputName = (0, foldIdentifier_js_1.default)(output.name);
-        if (outputNames.has(outputName)) {
-            throw new Error(`Internal publication received duplicate output column ${(0, quoteIdentifier_js_1.default)(output.name)}.`);
-        }
-        outputNames.add(outputName);
-        if (output.replace === undefined) {
-            if (sourceColumns.some((column) => (0, foldIdentifier_js_1.default)(column) === outputName)) {
-                throw new Error(`Internal publication cannot append existing column ${(0, quoteIdentifier_js_1.default)(output.name)}.`);
-            }
-            continue;
-        }
-        const replacement = (0, foldIdentifier_js_1.default)(output.replace);
-        if (outputName !== replacement) {
-            throw new Error(`Internal publication output ${(0, quoteIdentifier_js_1.default)(output.name)} must match its replacement column ${(0, quoteIdentifier_js_1.default)(output.replace)}.`);
-        }
-        if (!sourceColumns.some((column) => (0, foldIdentifier_js_1.default)(column) === replacement)) {
-            throw new Error(`Internal publication cannot replace missing column ${(0, quoteIdentifier_js_1.default)(output.replace)}.`);
-        }
-        if (replacements.has(replacement)) {
-            throw new Error(`Internal publication received duplicate replacement column ${(0, quoteIdentifier_js_1.default)(output.replace)}.`);
-        }
-        replacements.add(replacement);
-    }
-}

package/script/helpers/queryDB.d.ts

@@ -1,65 +0,0 @@
-import type { DuckDBValue as NativeDuckDBValue } from "@duckdb/node-api";
-import SimpleTable from "../class/SimpleTable.js";
-import SimpleDB from "../class/SimpleDB.js";
-/** @internal DuckDB owns this type; retain its exact binding contract without re-exporting it. */
-type DuckDBValue = NativeDuckDBValue;
-/**
- * Executes SQL for a table or database after flushing all queued operations.
- * Starts the database on first use and applies its SQL logging settings.
- * Extension authors can construct `options` with `mergeOptions()`.
- *
- * @example
- * ```ts
- * import { mergeOptions, queryDB, quoteIdentifier } from "@nshiab/simple-data-analysis-core/helpers";
- *
- * await table.loadArray([{ answer: 0 }]).run();
- * const query = `UPDATE ${quoteIdentifier(table.name)} SET answer = ?`;
- * await queryDB(table, query, mergeOptions(table, {
- *   table: table.name,
- *   method: "example()",
- *   parameters: null,
- *   values: [42],
- * }));
- * await table.log();
- * ```
- *
- * @param simple - The table or database that owns the query.
- *
- * @param query - The SQL statement to execute.
- *
- * @param options - Query execution and diagnostic settings.
- *
- * @param options.table - The table name used for diagnostics, or `null`.
- *
- * @param options.method - The calling method used for diagnostics, or `null`.
- *
- * @param options.parameters - Arguments included in error diagnostics, or `null`.
- *
- * @param options.rowsToLog - The caller's row-display limit, retained for compatibility.
- *
- * @param options.charsToLog - The caller's per-cell display limit, retained for compatibility.
- *
- * @param options.returnData - Whether to convert and return the result rows.
- *
- * @param options.values - DuckDB-native values bound to SQL placeholders, in order.
- *
- * @param options.noClean - Whether to preserve the SQL text without cleaning it.
- *
- * @returns Converted rows when `returnData` is true, otherwise `null`.
- */
-export default function queryDB(simple: SimpleTable | SimpleDB, query: string, options: {
-    table: string | null;
-    method: string | null;
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    rowsToLog: number;
-    charsToLog: number | undefined;
-    returnData: boolean;
-    values?: DuckDBValue[];
-    noClean?: boolean;
-}): Promise<{
-    [key: string]: unknown;
-}[] | null>;
-export {};
-//# sourceMappingURL=queryDB.d.ts.map

package/script/helpers/queryDB.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queryDB.d.ts","sourceRoot":"","sources":["../../src/helpers/queryDB.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAClD,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAK5C,kGAAkG;AAClG,KAAK,WAAW,GAAG,iBAAiB,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAA8B,OAAO,CACnC,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,OAAO,CACN;IACA,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,EAAE,GACD,IAAI,CACP,CAuDA"}

package/script/helpers/queryDB.js

@@ -1,98 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = queryDB;
-const SimpleTable_js_1 = __importDefault(require("../class/SimpleTable.js"));
-const SimpleDB_js_1 = __importDefault(require("../class/SimpleDB.js"));
-const cleanSQL_js_1 = __importDefault(require("./cleanSQL.js"));
-const flushAllTables_js_1 = __importDefault(require("./flushAllTables.js"));
-const cacheTableDependencies_js_1 = require("./cacheTableDependencies.js");
-/**
- * Executes SQL for a table or database after flushing all queued operations.
- * Starts the database on first use and applies its SQL logging settings.
- * Extension authors can construct `options` with `mergeOptions()`.
- *
- * @example
- * ```ts
- * import { mergeOptions, queryDB, quoteIdentifier } from "@nshiab/simple-data-analysis-core/helpers";
- *
- * await table.loadArray([{ answer: 0 }]).run();
- * const query = `UPDATE ${quoteIdentifier(table.name)} SET answer = ?`;
- * await queryDB(table, query, mergeOptions(table, {
- *   table: table.name,
- *   method: "example()",
- *   parameters: null,
- *   values: [42],
- * }));
- * await table.log();
- * ```
- *
- * @param simple - The table or database that owns the query.
- *
- * @param query - The SQL statement to execute.
- *
- * @param options - Query execution and diagnostic settings.
- *
- * @param options.table - The table name used for diagnostics, or `null`.
- *
- * @param options.method - The calling method used for diagnostics, or `null`.
- *
- * @param options.parameters - Arguments included in error diagnostics, or `null`.
- *
- * @param options.rowsToLog - The caller's row-display limit, retained for compatibility.
- *
- * @param options.charsToLog - The caller's per-cell display limit, retained for compatibility.
- *
- * @param options.returnData - Whether to convert and return the result rows.
- *
- * @param options.values - DuckDB-native values bound to SQL placeholders, in order.
- *
- * @param options.noClean - Whether to preserve the SQL text without cleaning it.
- *
- * @returns Converted rows when `returnData` is true, otherwise `null`.
- */
-async function queryDB(simple, query, options) {
-    if (simple instanceof SimpleTable_js_1.default) {
-        (0, cacheTableDependencies_js_1.recordCacheTableAccess)(simple);
-    }
-    const sdb = simple instanceof SimpleTable_js_1.default ? simple.sdb : simple;
-    if (sdb.lifecycleState === "closed") {
-        throw new Error(`${options.method ?? "The query"} cannot run because its SimpleDB is closed.`);
-    }
-    if (simple instanceof SimpleDB_js_1.default && simple.connection === undefined) {
-        await simple.start();
-    }
-    else if (simple instanceof SimpleTable_js_1.default &&
-        simple.connection === undefined) {
-        await simple.sdb.start();
-        simple.db = simple.sdb.db;
-        simple.connection = simple.sdb.connection;
-    }
-    if (simple.connection === undefined) {
-        throw new Error("simple.connection is undefined");
-    }
-    // Observing executes: any query touching the database first flushes the
-    // operations queued by sync builder methods, preserving program order.
-    await (0, flushAllTables_js_1.default)(simple instanceof SimpleTable_js_1.default ? simple.sdb : simple);
-    if (options.noClean !== true) {
-        query = (0, cleanSQL_js_1.default)(query, sdb.expressionSyntax);
-    }
-    const executionOptions = {
-        ...options,
-        logSQL: sdb.logSQL,
-        explainSQL: sdb.explainSQL,
-    };
-    if (options.returnData) {
-        const data = await simple.runQuery(query, simple.connection, true, executionOptions);
-        if (data === null) {
-            throw new Error("data is null");
-        }
-        return data;
-    }
-    else {
-        await simple.runQuery(query, simple.connection, false, executionOptions);
-        return null;
-    }
-}

package/script/helpers/queryDbFile.d.ts

@@ -1,8 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-/** Executes generated database-file SQL without rewriting paths or metadata. */
-export default function queryDbFile(sdb: SimpleDB, sql: string, options?: {
-    returnData?: boolean;
-}): Promise<{
-    [key: string]: unknown;
-}[] | null>;
-//# sourceMappingURL=queryDbFile.d.ts.map

package/script/helpers/queryDbFile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queryDbFile.d.ts","sourceRoot":"","sources":["../../src/helpers/queryDbFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAIjD,gFAAgF;AAChF,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO;;YAavC"}

package/script/helpers/queryDbFile.js

@@ -1,18 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = queryDbFile;
-const queryDB_js_1 = __importDefault(require("./queryDB.js"));
-const mergeOptions_js_1 = __importDefault(require("./mergeOptions.js"));
-/** Executes generated database-file SQL without rewriting paths or metadata. */
-function queryDbFile(sdb, sql, options = {}) {
-    return (0, queryDB_js_1.default)(sdb, sql, (0, mergeOptions_js_1.default)(sdb, {
-        table: null,
-        method: "database file operation",
-        parameters: null,
-        returnData: options.returnData,
-        noClean: true,
-    }));
-}

package/script/helpers/queueAsyncBarrier.d.ts

@@ -1,56 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Queues asynchronous extension work as one ordered table-builder step.
- * Builder operations queued by `execute` are scoped to the barrier and drain
- * before its observer queries and before later chained operations.
- *
- * `execute` must await all asynchronous work that can queue table operations.
- * Detached work is outside the barrier's program-order scope.
- *
- * If `execute` rejects, captured builder operations that have not already
- * drained are discarded. Operations drained by an observer inside `execute`
- * remain applied; an asynchronous barrier does not provide database rollback.
- *
- * This differs from a failure while executing queued builders: during replay,
- * the failing table's remaining chain is aborted, but unexecuted work for other
- * tables is requeued for their next observation.
- *
- * @example
- * ```ts
- * import type { SimpleTable } from "@nshiab/simple-data-analysis-core";
- * import { queueAsyncBarrier } from "@nshiab/simple-data-analysis-core/helpers";
- *
- * function loadRemote(table: SimpleTable, url: string): SimpleTable {
- *   queueAsyncBarrier(table, {
- *     method: "loadRemote()",
- *     parameters: { url },
- *     execute: async () => {
- *       const rows = await fetch(url).then((response) => response.json()) as
- *         { [key: string]: unknown }[];
- *       table.loadArray(rows);
- *     },
- *   });
- *   return table;
- * }
- * ```
- *
- * @param simpleTable - The table whose chain owns the asynchronous work.
- *
- * @param operation - The asynchronous extension operation to queue.
- *
- * @param operation.method - The public method name used for diagnostics.
- *
- * @param operation.parameters - A snapshot of the public method parameters used for diagnostics.
- *
- * @param operation.execute - The asynchronous work to run at the barrier's position in the chain.
- *
- * @returns Nothing. The public builder should return its target table.
- */
-export default function queueAsyncBarrier(simpleTable: SimpleTable, operation: {
-    method: string;
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    execute: () => Promise<void>;
-}): void;
-//# sourceMappingURL=queueAsyncBarrier.d.ts.map

package/script/helpers/queueAsyncBarrier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queueAsyncBarrier.d.ts","sourceRoot":"","sources":["../../src/helpers/queueAsyncBarrier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE;IACT,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,GACA,IAAI,CAKN"}

package/script/helpers/queueAsyncBarrier.js

@@ -1,60 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = queueAsyncBarrier;
-const queueOp_js_1 = __importDefault(require("./queueOp.js"));
-/**
- * Queues asynchronous extension work as one ordered table-builder step.
- * Builder operations queued by `execute` are scoped to the barrier and drain
- * before its observer queries and before later chained operations.
- *
- * `execute` must await all asynchronous work that can queue table operations.
- * Detached work is outside the barrier's program-order scope.
- *
- * If `execute` rejects, captured builder operations that have not already
- * drained are discarded. Operations drained by an observer inside `execute`
- * remain applied; an asynchronous barrier does not provide database rollback.
- *
- * This differs from a failure while executing queued builders: during replay,
- * the failing table's remaining chain is aborted, but unexecuted work for other
- * tables is requeued for their next observation.
- *
- * @example
- * ```ts
- * import type { SimpleTable } from "@nshiab/simple-data-analysis-core";
- * import { queueAsyncBarrier } from "@nshiab/simple-data-analysis-core/helpers";
- *
- * function loadRemote(table: SimpleTable, url: string): SimpleTable {
- *   queueAsyncBarrier(table, {
- *     method: "loadRemote()",
- *     parameters: { url },
- *     execute: async () => {
- *       const rows = await fetch(url).then((response) => response.json()) as
- *         { [key: string]: unknown }[];
- *       table.loadArray(rows);
- *     },
- *   });
- *   return table;
- * }
- * ```
- *
- * @param simpleTable - The table whose chain owns the asynchronous work.
- *
- * @param operation - The asynchronous extension operation to queue.
- *
- * @param operation.method - The public method name used for diagnostics.
- *
- * @param operation.parameters - A snapshot of the public method parameters used for diagnostics.
- *
- * @param operation.execute - The asynchronous work to run at the barrier's position in the chain.
- *
- * @returns Nothing. The public builder should return its target table.
- */
-function queueAsyncBarrier(simpleTable, operation) {
-    (0, queueOp_js_1.default)(simpleTable, {
-        kind: "asyncBarrier",
-        ...operation,
-    });
-}

package/script/helpers/queueGraphResult.d.ts

@@ -1,18 +0,0 @@
-import type { DuckDBValue } from "@duckdb/node-api";
-import type SimpleTable from "../class/SimpleTable.js";
-import type { TableSchema } from "./pendingOps.js";
-type GraphResult = {
-    buildSelect: (input: string, schema: TableSchema) => string;
-    method: string;
-    outputSchema: (schema: TableSchema) => TableSchema;
-    outputTable?: string | boolean;
-    parameters: {
-        [key: string]: unknown;
-    };
-    preflight?: (input: SimpleTable) => Promise<void>;
-    values: (schema: TableSchema) => DuckDBValue[];
-};
-/** Queues a graph SELECT for overwrite or a source-preserving output table. */
-export default function queueGraphResult(simpleTable: SimpleTable, result: GraphResult): SimpleTable;
-export {};
-//# sourceMappingURL=queueGraphResult.d.ts.map

package/script/helpers/queueGraphResult.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queueGraphResult.d.ts","sourceRoot":"","sources":["../../src/helpers/queueGraphResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;CAChD,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW,GAClB,WAAW,CAqCb"}

package/script/helpers/queueGraphResult.js

@@ -1,45 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = queueGraphResult;
-const queueOp_js_1 = __importDefault(require("./queueOp.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const resolveOutputTable_js_1 = __importDefault(require("./resolveOutputTable.js"));
-/** Queues a graph SELECT for overwrite or a source-preserving output table. */
-function queueGraphResult(simpleTable, result) {
-    const resolvedOutput = (0, resolveOutputTable_js_1.default)(simpleTable, result.outputTable);
-    const outputTable = typeof resolvedOutput === "string"
-        ? simpleTable.sdb.newTable(resolvedOutput)
-        : simpleTable;
-    if (outputTable !== simpleTable) {
-        (0, queueOp_js_1.default)(outputTable, {
-            kind: "source",
-            method: result.method,
-            parameters: result.parameters,
-            rawSQL: [(0, quoteIdentifier_js_1.default)(simpleTable.name)],
-            buildSelect: () => `SELECT * FROM ${(0, quoteIdentifier_js_1.default)(simpleTable.name)}`,
-        });
-    }
-    // A separate barrier keeps invalid-event checks observable after LIMIT 0.
-    const preflight = result.preflight;
-    if (preflight !== undefined) {
-        (0, queueOp_js_1.default)(outputTable, {
-            kind: "barrier",
-            method: result.method,
-            parameters: result.parameters,
-            execute: () => preflight(outputTable),
-        });
-    }
-    (0, queueOp_js_1.default)(outputTable, {
-        kind: "fusable",
-        method: result.method,
-        parameters: result.parameters,
-        needsSchema: true,
-        values: result.values,
-        buildSelect: result.buildSelect,
-        outputSchema: result.outputSchema,
-    });
-    return outputTable;
-}

package/script/helpers/queueOp.d.ts

@@ -1,18 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-import type SimpleTable from "../class/SimpleTable.js";
-import type { PendingOpInput } from "./pendingOps.js";
-/**
- * Queues an internal relational operation, barrier, or asynchronous barrier.
- *
- * @internal
- */
-export default function queueOp(simpleTable: SimpleTable, op: PendingOpInput): void;
-/**
- * Empties every table's pending queue without executing it and returns what
- * was dropped, so close() can report forgotten work after cleaning up.
- */
-export declare function discardAllPending(sdb: SimpleDB): {
-    table: SimpleTable;
-    methods: string[];
-}[];
-//# sourceMappingURL=queueOp.d.ts.map

package/script/helpers/queueOp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queueOp.d.ts","sourceRoot":"","sources":["../../src/helpers/queueOp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWtD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,WAAW,EAAE,WAAW,EACxB,EAAE,EAAE,cAAc,GACjB,IAAI,CAgDN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAa7C"}

package/script/helpers/queueOp.js

@@ -1,76 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = queueOp;
-exports.discardAllPending = discardAllPending;
-const tableRegistry_js_1 = require("./tableRegistry.js");
-const tableGeneration_js_1 = require("./tableGeneration.js");
-const cacheTableDependencies_js_1 = require("./cacheTableDependencies.js");
-const asyncOperationContext_js_1 = require("./asyncOperationContext.js");
-/**
- * Queues an internal relational operation, barrier, or asynchronous barrier.
- *
- * @internal
- */
-function queueOp(simpleTable, op) {
-    (0, cacheTableDependencies_js_1.assertCacheTableMutation)(simpleTable);
-    const sdb = simpleTable.sdb;
-    if (sdb.lifecycleState !== "open") {
-        throw new Error(`${op.method} cannot queue work because its SimpleDB is ${sdb.lifecycleState}.`);
-    }
-    let capturedOp = (0, cacheTableDependencies_js_1.captureCacheTableOperation)({
-        ...op,
-        parameters: op.parameters === null ? null : structuredClone(op.parameters),
-    });
-    if (capturedOp.kind === "fusable" || capturedOp.kind === "source") {
-        capturedOp = {
-            ...capturedOp,
-            rawSQL: capturedOp.rawSQL === undefined
-                ? undefined
-                : [...capturedOp.rawSQL],
-        };
-        if (capturedOp.rawSQL !== undefined) {
-            (0, cacheTableDependencies_js_1.recordCacheTableReferences)(simpleTable, capturedOp.rawSQL);
-        }
-    }
-    if (capturedOp.kind === "fusable" &&
-        capturedOp.values !== undefined &&
-        typeof capturedOp.values !== "function") {
-        capturedOp = {
-            ...capturedOp,
-            values: [...capturedOp.values],
-        };
-    }
-    // A table de-registered by removeTable()/removeTables()/selectTables() that
-    // queues new work comes back under the flush's responsibility, like v1
-    // methods recreating a removed table.
-    (0, tableRegistry_js_1.ensureTableRegistered)(sdb, simpleTable);
-    (0, tableGeneration_js_1.markTableChanged)(simpleTable);
-    const queuedOp = {
-        ...capturedOp,
-        sequence: sdb.opSequence++,
-    };
-    (0, cacheTableDependencies_js_1.recordCacheTableOperation)(simpleTable, queuedOp);
-    if ((0, asyncOperationContext_js_1.captureAsyncOperation)(sdb, { table: simpleTable, op: queuedOp })) {
-        return;
-    }
-    simpleTable.pendingOps.push(queuedOp);
-    sdb.pendingCount++;
-}
-/**
- * Empties every table's pending queue without executing it and returns what
- * was dropped, so close() can report forgotten work after cleaning up.
- */
-function discardAllPending(sdb) {
-    const discarded = [];
-    for (const table of (0, tableRegistry_js_1.getRegisteredTables)(sdb)) {
-        if (table.pendingOps.length > 0) {
-            discarded.push({
-                table,
-                methods: table.pendingOps.map((op) => op.method),
-            });
-            sdb.pendingCount -= table.pendingOps.length;
-            table.pendingOps.length = 0;
-        }
-    }
-    return discarded;
-}

package/script/helpers/quoteIdentifier.d.ts

@@ -1,17 +0,0 @@
-/**
- * Quotes one SQL identifier and escapes embedded double quotes.
- * Use this for library-generated table, column, schema, database, and alias
- * names. User-authored SQL expressions must remain unmodified.
- *
- * @example
- * ```ts
- * quoteIdentifier('people "archive"');
- * // '"people ""archive"""'
- * ```
- *
- * @param identifier - The identifier to quote.
- *
- * @returns The identifier wrapped in double quotes with embedded quotes doubled.
- */
-export default function quoteIdentifier(identifier: string): string;
-//# sourceMappingURL=quoteIdentifier.d.ts.map

package/script/helpers/quoteIdentifier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"quoteIdentifier.d.ts","sourceRoot":"","sources":["../../src/helpers/quoteIdentifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/script/helpers/quoteIdentifier.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = quoteIdentifier;
-/**
- * Quotes one SQL identifier and escapes embedded double quotes.
- * Use this for library-generated table, column, schema, database, and alias
- * names. User-authored SQL expressions must remain unmodified.
- *
- * @example
- * ```ts
- * quoteIdentifier('people "archive"');
- * // '"people ""archive"""'
- * ```
- *
- * @param identifier - The identifier to quote.
- *
- * @returns The identifier wrapped in double quotes with embedded quotes doubled.
- */
-function quoteIdentifier(identifier) {
-    return `"${identifier.replaceAll('"', '""')}"`;
-}

package/script/helpers/quoteQualifiedIdentifier.d.ts

@@ -1,20 +0,0 @@
-/**
- * Quotes a SQL identifier together with the relation that owns it.
- *
- * Qualifying column references prevents DuckDB from resolving a relation name
- * as its row struct when a missing column has the same name as the relation.
- *
- * @example
- * ```ts
- * quoteQualifiedIdentifier("people", "full name");
- * // '"people"."full name"'
- * ```
- *
- * @param relation - The table or relation containing the identifier.
- *
- * @param identifier - The identifier to qualify.
- *
- * @returns The separately quoted relation and identifier joined by a period.
- */
-export default function quoteQualifiedIdentifier(relation: string, identifier: string): string;
-//# sourceMappingURL=quoteQualifiedIdentifier.d.ts.map

package/script/helpers/quoteQualifiedIdentifier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"quoteQualifiedIdentifier.d.ts","sourceRoot":"","sources":["../../src/helpers/quoteQualifiedIdentifier.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}