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

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"}

package/script/helpers/quoteQualifiedIdentifier.js

@@ -1,28 +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 = quoteQualifiedIdentifier;
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-/**
- * 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.
- */
-function quoteQualifiedIdentifier(relation, identifier) {
-    return `${(0, quoteIdentifier_js_1.default)(relation)}.${(0, quoteIdentifier_js_1.default)(identifier)}`;
-}

package/script/helpers/readDbMetadata.d.ts

@@ -1,5 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-import type { IndexDefinition } from "./indexDefinitions.js";
-/** Reads embedded SDA metadata when present. */
-export default function readDbMetadata(sdb: SimpleDB, database: string): Promise<Record<string, IndexDefinition[]>>;
-//# sourceMappingURL=readDbMetadata.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"readDbMetadata.d.ts","sourceRoot":"","sources":["../../src/helpers/readDbMetadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,gDAAgD;AAChD,wBAA8B,cAAc,CAC1C,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CA0B5C"}

package/script/helpers/readDbMetadata.js

@@ -1,61 +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 = readDbMetadata;
-const queryDbFile_js_1 = __importDefault(require("./queryDbFile.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const parseValue_js_1 = __importDefault(require("./parseValue.js"));
-/** Reads embedded SDA metadata when present. */
-async function readDbMetadata(sdb, database) {
-    const schemas = await (0, queryDbFile_js_1.default)(sdb, `SELECT schema_name FROM duckdb_schemas()
-     WHERE database_name = ${(0, parseValue_js_1.default)(database)} AND schema_name = '__sda';`, { returnData: true });
-    if (schemas.length > 0) {
-        const rows = await (0, queryDbFile_js_1.default)(sdb, `SELECT version, indexes FROM ${(0, quoteIdentifier_js_1.default)(database)}.__sda.metadata;`, { returnData: true });
-        if (rows.length !== 1 || rows[0].version !== 1 ||
-            typeof rows[0].indexes !== "string") {
-            throw new Error("Unsupported SDA database metadata in the reserved __sda schema.");
-        }
-        return validateIndexes(JSON.parse(rows[0].indexes));
-    }
-    return {};
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function validateIndexes(value) {
-    if (!isRecord(value))
-        throw new Error("Invalid SDA index metadata.");
-    for (const definitions of Object.values(value)) {
-        if (!Array.isArray(definitions)) {
-            throw new Error("Invalid SDA index metadata.");
-        }
-        for (const definition of definitions) {
-            if (!isRecord(definition) || typeof definition.name !== "string" ||
-                !isRecord(definition.options)) {
-                throw new Error("Invalid SDA index definition.");
-            }
-            const options = definition.options;
-            if (definition.kind === "fts") {
-                if (typeof definition.idColumn !== "string" ||
-                    typeof definition.textColumn !== "string" ||
-                    ["stemmer", "stopwords", "ignore"].some((key) => options[key] !== undefined && typeof options[key] !== "string") ||
-                    ["stripAccents", "lower"].some((key) => options[key] !== undefined && typeof options[key] !== "boolean")) {
-                    throw new Error("Invalid SDA FTS index definition.");
-                }
-            }
-            else if (definition.kind === "vss") {
-                if (typeof definition.column !== "string" ||
-                    ["efConstruction", "efSearch", "M"].some((key) => options[key] !== undefined &&
-                        (typeof options[key] !== "number" || !Number.isFinite(options[key])))) {
-                    throw new Error("Invalid SDA VSS index definition.");
-                }
-            }
-            else {
-                throw new Error("Unsupported SDA index definition.");
-            }
-        }
-    }
-    return value;
-}

package/script/helpers/readMutationRows.d.ts

@@ -1,9 +0,0 @@
-import { type DuckDBConnection, type DuckDBType, type DuckDBValue } from "@duckdb/node-api";
-/** Reads mutation values, optionally keeping a pagination cursor out of rows. */
-export default function readMutationRows(connection: DuckDBConnection, query: string, cursorColumn?: string): Promise<{
-    rows: Record<string, unknown>[];
-    types: Map<string, DuckDBType>;
-    lastCursorValue: DuckDBValue | undefined;
-    toNative: (value: unknown, type: DuckDBType) => DuckDBValue;
-}>;
-//# sourceMappingURL=readMutationRows.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"readMutationRows.d.ts","sourceRoot":"","sources":["../../src/helpers/readMutationRows.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAKrB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,wBAA8B,gBAAgB,CAC5C,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM;;;;sBAwDI,OAAO,QAAQ,UAAU,KAAG,WAAW;GA0DjE"}

package/script/helpers/readMutationRows.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = readMutationRows;
-const node_api_1 = require("@duckdb/node-api");
-/** Reads mutation values, optionally keeping a pagination cursor out of rows. */
-async function readMutationRows(connection, query, cursorColumn) {
-    const result = await connection.run(query);
-    const names = result.deduplicatedColumnNames();
-    const types = result.columnTypes();
-    const cursorIndex = cursorColumn === undefined
-        ? -1
-        : names.indexOf(cursorColumn);
-    let lastCursorValue;
-    const dates = new WeakMap();
-    const convert = (value) => {
-        if (value instanceof node_api_1.DuckDBDateValue || value instanceof node_api_1.DuckDBTimestampValue) {
-            const millis = value instanceof node_api_1.DuckDBDateValue
-                ? value.days * 86400000
-                : Number(value.micros >= 0n
-                    ? value.micros / 1000n
-                    : (value.micros - 999n) / 1000n);
-            const date = new Date(millis);
-            // Infinite/out-of-range dates retain their native representation.
-            if (!Number.isFinite(date.getTime()))
-                return value;
-            dates.set(date, { millis, value });
-            return date;
-        }
-        if (value instanceof node_api_1.DuckDBArrayValue || value instanceof node_api_1.DuckDBListValue) {
-            return value.items.map(convert);
-        }
-        if (value instanceof node_api_1.DuckDBStructValue) {
-            return Object.fromEntries(Object.entries(value.entries).map(([key, item]) => [key, convert(item)]));
-        }
-        // In particular, decimals and high-resolution temporal values stay native.
-        return value;
-    };
-    const rows = [];
-    while (true) {
-        const chunk = await result.fetchChunk();
-        if (!chunk || chunk.rowCount === 0)
-            break;
-        const offset = rows.length;
-        for (let i = 0; i < chunk.rowCount; i++)
-            rows.push({});
-        for (let i = 0; i < names.length; i++) {
-            if (i === cursorIndex) {
-                lastCursorValue = chunk.getColumnVector(i).getItem(chunk.rowCount - 1);
-                continue;
-            }
-            chunk.visitColumnValues(i, (value, row) => {
-                rows[offset + row][names[i]] = convert(value);
-            });
-        }
-    }
-    const toNative = (value, type) => {
-        if (value === null || value === undefined)
-            return null;
-        if (value instanceof Date) {
-            const original = dates.get(value);
-            if (original && value.getTime() === original.millis &&
-                type.toString() ===
-                    (original.value instanceof node_api_1.DuckDBDateValue ? "DATE" : "TIMESTAMP")) {
-                return original.value;
-            }
-            if (type.toString() === "DATE") {
-                if (value.getTime() % 86400000 !== 0) {
-                    throw new Error("DATE values must represent midnight UTC.");
-                }
-                return new node_api_1.DuckDBDateValue(value.getTime() / 86400000);
-            }
-            return new node_api_1.DuckDBTimestampValue(BigInt(value.getTime()) * 1000n);
-        }
-        if (Array.isArray(value) && "valueType" in type) {
-            if ("length" in type && value.length !== type.length) {
-                throw new Error(`Expected ${type.length} array elements for ${type}.`);
-            }
-            const items = value.map((item) => toNative(item, type.valueType));
-            return "length" in type
-                ? new node_api_1.DuckDBArrayValue(items)
-                : new node_api_1.DuckDBListValue(items);
-        }
-        if (typeof value === "object" && "entryNames" in type && "entryTypes" in type) {
-            return new node_api_1.DuckDBStructValue(Object.fromEntries(type.entryNames.map((name, i) => [
-                name,
-                toNative(value[name], type.entryTypes[i]),
-            ])));
-        }
-        return value;
-    };
-    return {
-        rows,
-        types: new Map(names.flatMap((name, i) => i === cursorIndex ? [] : [[name, types[i]]])),
-        lastCursorValue,
-        toNative,
-    };
-}

package/script/helpers/readScalarNumber.d.ts

@@ -1,3 +0,0 @@
-import type { DuckDBConnection } from "@duckdb/node-api";
-export default function readScalarNumber(connection: DuckDBConnection, sql: string): Promise<number>;
-//# sourceMappingURL=readScalarNumber.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"readScalarNumber.d.ts","sourceRoot":"","sources":["../../src/helpers/readScalarNumber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,wBAA8B,gBAAgB,CAC5C,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,MAAM,mBAGZ"}

package/script/helpers/readScalarNumber.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = readScalarNumber;
-// For internal queries returning a single numeric value, such as row counts.
-async function readScalarNumber(connection, sql) {
-    return Number((await connection.runAndReadAll(sql)).getRowsJS()[0][0]);
-}

package/script/helpers/referencedTables.d.ts

@@ -1,9 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Finds registered table identifiers in SQL, excluding literals and comments.
- * Matching is conservative: column names and aliases also count as references.
- * DuckDB folds ASCII letters in both quoted and unquoted identifiers.
- */
-export default function referencedTables(sql: readonly string[], sdb: SimpleDB): SimpleTable[];
-//# sourceMappingURL=referencedTables.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"referencedTables.d.ts","sourceRoot":"","sources":["../../src/helpers/referencedTables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAKvD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,GAAG,EAAE,QAAQ,GACZ,WAAW,EAAE,CAkBf"}

package/script/helpers/referencedTables.js

@@ -1,28 +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 = referencedTables;
-const scanSQL_js_1 = __importDefault(require("./scanSQL.js"));
-const foldIdentifier_js_1 = __importDefault(require("./foldIdentifier.js"));
-const tableRegistry_js_1 = require("./tableRegistry.js");
-/**
- * Finds registered table identifiers in SQL, excluding literals and comments.
- * Matching is conservative: column names and aliases also count as references.
- * DuckDB folds ASCII letters in both quoted and unquoted identifiers.
- */
-function referencedTables(sql, sdb) {
-    const identifiers = new Set();
-    for (const fragment of sql) {
-        for (const token of (0, scanSQL_js_1.default)(fragment)) {
-            if (token.kind === "quoted" && token.text.startsWith('"')) {
-                identifiers.add((0, foldIdentifier_js_1.default)(token.text.slice(1, -1).replaceAll('""', '"')));
-            }
-            else if (token.kind === "sql" && /^[\p{L}_][\p{L}\p{N}_$]*$/u.test(token.text)) {
-                identifiers.add((0, foldIdentifier_js_1.default)(token.text));
-            }
-        }
-    }
-    return (0, tableRegistry_js_1.getRegisteredTables)(sdb).filter((table) => identifiers.has((0, foldIdentifier_js_1.default)(table.name)));
-}

package/script/helpers/removeColumnsNow.d.ts

@@ -1,8 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Drops columns immediately, without queueing. For use inside a barrier's
- * execute, which runs during a flush: a sync builder method called there
- * would queue an operation for the next flush instead of running now.
- */
-export default function removeColumnsNow(simpleTable: SimpleTable, columns: string[], method: string): Promise<void>;
-//# sourceMappingURL=removeColumnsNow.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"removeColumnsNow.d.ts","sourceRoot":"","sources":["../../src/helpers/removeColumnsNow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD;;;;GAIG;AACH,wBAA8B,gBAAgB,CAC5C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/script/helpers/removeColumnsNow.js

@@ -1,21 +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 = removeColumnsNow;
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const mergeOptions_js_1 = __importDefault(require("./mergeOptions.js"));
-const queryDB_js_1 = __importDefault(require("./queryDB.js"));
-/**
- * Drops columns immediately, without queueing. For use inside a barrier's
- * execute, which runs during a flush: a sync builder method called there
- * would queue an operation for the next flush instead of running now.
- */
-async function removeColumnsNow(simpleTable, columns, method) {
-    await (0, queryDB_js_1.default)(simpleTable, columns.map((d) => `ALTER TABLE ${(0, quoteIdentifier_js_1.default)(simpleTable.name)} DROP ${(0, quoteIdentifier_js_1.default)(d)};`).join("\n"), (0, mergeOptions_js_1.default)(simpleTable, {
-        table: simpleTable.name,
-        method,
-        parameters: { columns },
-    }));
-}

package/script/helpers/resolveOutputTable.d.ts

@@ -1,9 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Resolves `outputTable: true` into an auto-generated table name
- * ("table0", "table1", ...), incrementing the database's shared counter so
- * concurrent auto-named tables never collide. A string, `false`, or
- * `undefined` value passes through unchanged.
- */
-export default function resolveOutputTable(simpleTable: SimpleTable, outputTable: string | boolean | undefined): string | boolean | undefined;
-//# sourceMappingURL=resolveOutputTable.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resolveOutputTable.d.ts","sourceRoot":"","sources":["../../src/helpers/resolveOutputTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GACxC,MAAM,GAAG,OAAO,GAAG,SAAS,CAO9B"}

package/script/helpers/resolveOutputTable.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = resolveOutputTable;
-/**
- * Resolves `outputTable: true` into an auto-generated table name
- * ("table0", "table1", ...), incrementing the database's shared counter so
- * concurrent auto-named tables never collide. A string, `false`, or
- * `undefined` value passes through unchanged.
- */
-function resolveOutputTable(simpleTable, outputTable) {
-    if (outputTable === true) {
-        const name = `table${simpleTable.sdb.tableIncrement}`;
-        simpleTable.sdb.tableIncrement += 1;
-        return name;
-    }
-    return outputTable;
-}

package/script/helpers/rewind.d.ts

@@ -1,3 +0,0 @@
-declare function rewind(object2: any): any;
-export { rewind as default };
-//# sourceMappingURL=rewind.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rewind.d.ts","sourceRoot":"","sources":["../../src/helpers/rewind.ts"],"names":[],"mappings":"AA0mCA,iBAAS,MAAM,CAAC,OAAO,KAAA,OAiBtB;AAiHD,OAAO,EACL,MAAM,IAAI,OAAO,EAClB,CAAC"}