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

package/esm/helpers/statCanCache.js

@@ -1,38 +0,0 @@
-import fileCache, { createFileCacheId } from "./fileCache.js";
-import mergeOptions from "./mergeOptions.js";
-import parseValue from "./parseValue.js";
-import queryDB from "./queryDB.js";
-import quoteIdentifier from "./quoteIdentifier.js";
-const CACHE_DIRECTORY = ".sda-cache/statcan";
-const CACHE_FORMAT_VERSION = "statcan-parquet-v1";
-export function createStatCanCacheId(pid, lang) {
-    return createFileCacheId("statcan", [CACHE_FORMAT_VERSION, pid, lang]);
-}
-export async function useStatCanCache(table, id, enabled, ttl, parameters, compute) {
-    await fileCache(table, {
-        directory: CACHE_DIRECTORY,
-        enabled,
-        extension: "parquet",
-        formatVersion: CACHE_FORMAT_VERSION,
-        id,
-        method: "loadStatCanData()",
-        ttl,
-        load: async (file) => {
-            await queryDB(table, `CREATE OR REPLACE TABLE ${quoteIdentifier(table.name)} AS
-        SELECT * FROM read_parquet(${parseValue(file)});`, mergeOptions(table, {
-                table: table.name,
-                method: "loadStatCanData()",
-                parameters,
-            }));
-        },
-        compute,
-        write: async (file) => {
-            await queryDB(table, `COPY ${quoteIdentifier(table.name)} TO ${parseValue(file)}
-        WITH (FORMAT PARQUET);`, mergeOptions(table, {
-                table: table.name,
-                method: "loadStatCanData()",
-                parameters,
-            }));
-        },
-    });
-}

package/esm/helpers/stringToArray.d.ts

@@ -1,17 +0,0 @@
-/**
- * Normalizes a string or array of strings to a new array.
- * Existing arrays are copied so callers can change the result independently.
- *
- * @example
- * ```ts
- * import { stringToArray } from "@nshiab/simple-data-analysis-core/helpers";
- * console.log(stringToArray("name")); // ["name"]
- * console.log(stringToArray(["name", "age"])); // ["name", "age"]
- * ```
- *
- * @param argument - One string or an array of strings.
- *
- * @returns A new array containing the supplied strings.
- */
-export default function stringToArray(argument: string | string[]): string[];
-//# sourceMappingURL=stringToArray.d.ts.map

package/esm/helpers/stringToArray.d.ts.map

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

package/esm/helpers/stringToArray.js

@@ -1,26 +0,0 @@
-/**
- * Normalizes a string or array of strings to a new array.
- * Existing arrays are copied so callers can change the result independently.
- *
- * @example
- * ```ts
- * import { stringToArray } from "@nshiab/simple-data-analysis-core/helpers";
- * console.log(stringToArray("name")); // ["name"]
- * console.log(stringToArray(["name", "age"])); // ["name", "age"]
- * ```
- *
- * @param argument - One string or an array of strings.
- *
- * @returns A new array containing the supplied strings.
- */
-export default function stringToArray(argument) {
-    if (Array.isArray(argument)) {
-        return [...argument];
-    }
-    else if (typeof argument === "string") {
-        return [argument];
-    }
-    else {
-        throw new Error(`argument should be a string or an array of strings.`);
-    }
-}

package/esm/helpers/stringifyDates.d.ts

@@ -1,5 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-export default function stringifyDates(simpleTable: SimpleTable, types: {
-    [key: string]: string;
-}): Promise<void>;
-//# sourceMappingURL=stringifyDates.d.ts.map

package/esm/helpers/stringifyDates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringifyDates.d.ts","sourceRoot":"","sources":["../../src/helpers/stringifyDates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,cAAc,CAC1C,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,iBAcjC"}

package/esm/helpers/stringifyDates.js

@@ -1,14 +0,0 @@
-export default async function stringifyDates(simpleTable, types) {
-    const typesKeys = Object.keys(types);
-    const typesValues = Object.values(types);
-    const toConvert = {};
-    for (let i = 0; i < typesKeys.length; i++) {
-        if (typesValues[i] === "TIMESTAMP" || typesValues[i] === "DATE") {
-            toConvert[typesKeys[i]] = "string";
-        }
-    }
-    if (Object.keys(toConvert).length > 0) {
-        await simpleTable.convert(toConvert, { datetimeFormat: "%xT%T.%g%z" });
-        await simpleTable.replace(Object.keys(toConvert), { "+00": "Z" });
-    }
-}

package/esm/helpers/stringifyDatesInvert.d.ts

@@ -1,5 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-export default function stringifyDatesInvert(simpleTable: SimpleTable, types: {
-    [key: string]: string;
-}): Promise<void>;
-//# sourceMappingURL=stringifyDatesInvert.d.ts.map

package/esm/helpers/stringifyDatesInvert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stringifyDatesInvert.d.ts","sourceRoot":"","sources":["../../src/helpers/stringifyDatesInvert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,oBAAoB,CAChD,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,iBAgBjC"}

package/esm/helpers/stringifyDatesInvert.js

@@ -1,14 +0,0 @@
-export default async function stringifyDatesInvert(simpleTable, types) {
-    const typesKeys = Object.keys(types);
-    const typesValues = Object.values(types);
-    const toConvertBack = {};
-    for (let i = 0; i < typesKeys.length; i++) {
-        if (typesValues[i] === "TIMESTAMP" || typesValues[i] === "DATE") {
-            toConvertBack[typesKeys[i]] = typesValues[i].toLowerCase();
-        }
-    }
-    if (Object.keys(toConvertBack).length > 0) {
-        await simpleTable.replace(Object.keys(toConvertBack), { "Z": "+00" });
-        await simpleTable.convert(toConvertBack);
-    }
-}

package/esm/helpers/tableGeneration.d.ts

@@ -1,18 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-declare const tableGenerationIdBrand: unique symbol;
-/** An opaque identifier for one in-process or cached table generation. */
-export type TableGenerationId = string & {
-    readonly [tableGenerationIdBrand]: true;
-};
-/** Returns an established generation without creating one for a new table. */
-export declare function peekTableGeneration(table: SimpleTable): TableGenerationId | undefined;
-/** Creates a new table generation identifier. */
-export declare function createTableGenerationId(): TableGenerationId;
-/** Returns the current in-process generation identifier for a table. */
-export declare function getTableGeneration(table: SimpleTable): TableGenerationId;
-/** Gives a table a new generation after it may have changed. */
-export declare function markTableChanged(table: SimpleTable): TableGenerationId;
-/** Restores the generation persisted with a cached table artifact. */
-export declare function restoreTableGeneration(table: SimpleTable, generation: TableGenerationId): void;
-export {};
-//# sourceMappingURL=tableGeneration.d.ts.map

package/esm/helpers/tableGeneration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tableGeneration.d.ts","sourceRoot":"","sources":["../../src/helpers/tableGeneration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,OAAO,CAAC,MAAM,sBAAsB,EAAE,OAAO,MAAM,CAAC;AAEpD,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IACvC,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;CACzC,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,GACjB,iBAAiB,GAAG,SAAS,CAE/B;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAOxE;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAItE;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,iBAAiB,GAC5B,IAAI,CAEN"}

package/esm/helpers/tableGeneration.js

@@ -1,29 +0,0 @@
-import crypto from "node:crypto";
-const generations = new WeakMap();
-/** Returns an established generation without creating one for a new table. */
-export function peekTableGeneration(table) {
-    return generations.get(table);
-}
-/** Creates a new table generation identifier. */
-export function createTableGenerationId() {
-    return crypto.randomUUID();
-}
-/** Returns the current in-process generation identifier for a table. */
-export function getTableGeneration(table) {
-    let generation = generations.get(table);
-    if (generation === undefined) {
-        generation = createTableGenerationId();
-        generations.set(table, generation);
-    }
-    return generation;
-}
-/** Gives a table a new generation after it may have changed. */
-export function markTableChanged(table) {
-    const generation = createTableGenerationId();
-    generations.set(table, generation);
-    return generation;
-}
-/** Restores the generation persisted with a cached table artifact. */
-export function restoreTableGeneration(table, generation) {
-    generations.set(table, generation);
-}

package/esm/helpers/tableRegistry.d.ts

@@ -1,11 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-import type SimpleTable from "../class/SimpleTable.js";
-export declare function initializeTableRegistry<Table extends SimpleTable>(simpleDB: SimpleDB<Table>): void;
-export declare function getRegisteredTables<Table extends SimpleTable>(simpleDB: SimpleDB<Table>): readonly Table[];
-export declare function listRegisteredTables<Table extends SimpleTable>(simpleDB: SimpleDB<Table>): readonly Table[];
-export declare function registerTable<Table extends SimpleTable>(simpleDB: SimpleDB<Table>, table: Table): void;
-export declare function ensureTableRegistered<Table extends SimpleTable>(simpleDB: SimpleDB<Table>, table: Table): void;
-/** Prevents distinct handles from owning the same DuckDB table name. */
-export declare function assertTableNameAvailable(simpleDB: SimpleDB, name: string, renamedTable?: SimpleTable): void;
-export declare function retainRegisteredTables<Table extends SimpleTable>(simpleDB: SimpleDB<Table>, predicate: (table: Table) => boolean): void;
-//# sourceMappingURL=tableRegistry.d.ts.map

package/esm/helpers/tableRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tableRegistry.d.ts","sourceRoot":"","sources":["../../src/helpers/tableRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAiBvD,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,WAAW,EAC/D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GACxB,IAAI,CAEN;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,WAAW,EAC3D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GACxB,SAAS,KAAK,EAAE,CAElB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,WAAW,EAC5D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GACxB,SAAS,KAAK,EAAE,CAElB;AAED,wBAAgB,aAAa,CAAC,KAAK,SAAS,WAAW,EACrD,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EACzB,KAAK,EAAE,KAAK,GACX,IAAI,CAYN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,WAAW,EAC7D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EACzB,KAAK,EAAE,KAAK,GACX,IAAI,CAKN;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,WAAW,GACzB,IAAI,CASN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,WAAW,EAC9D,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GACnC,IAAI,CAUN"}

package/esm/helpers/tableRegistry.js

@@ -1,54 +0,0 @@
-import { markTableChanged } from "./tableGeneration.js";
-import { recordCacheTableCreation } from "./cacheTableDependencies.js";
-import foldIdentifier from "./foldIdentifier.js";
-const registries = new WeakMap();
-function getMutableTables(simpleDB) {
-    const tables = registries.get(simpleDB);
-    if (tables === undefined) {
-        throw new Error("The table registry has not been initialized.");
-    }
-    return tables;
-}
-export function initializeTableRegistry(simpleDB) {
-    registries.set(simpleDB, []);
-}
-export function getRegisteredTables(simpleDB) {
-    return getMutableTables(simpleDB);
-}
-export function listRegisteredTables(simpleDB) {
-    return [...getMutableTables(simpleDB)];
-}
-export function registerTable(simpleDB, table) {
-    const TableClass = simpleDB.tableClass;
-    if (!(table instanceof TableClass)) {
-        throw new Error(`The table must be an instance of ${TableClass.name}.`);
-    }
-    const tables = getMutableTables(simpleDB);
-    assertTableNameAvailable(simpleDB, table.name);
-    tables.push(table);
-    recordCacheTableCreation(table);
-}
-export function ensureTableRegistered(simpleDB, table) {
-    const tables = getMutableTables(simpleDB);
-    if (!tables.includes(table)) {
-        registerTable(simpleDB, table);
-    }
-}
-/** Prevents distinct handles from owning the same DuckDB table name. */
-export function assertTableNameAvailable(simpleDB, name, renamedTable) {
-    const normalizedName = foldIdentifier(name);
-    if (getRegisteredTables(simpleDB).some((table) => table !== renamedTable && foldIdentifier(table.name) === normalizedName)) {
-        throw new Error(`Table ${name} already exists.`);
-    }
-}
-export function retainRegisteredTables(simpleDB, predicate) {
-    const tables = getMutableTables(simpleDB);
-    const retained = tables.filter(predicate);
-    const retainedSet = new Set(retained);
-    for (const table of tables) {
-        if (!retainedSet.has(table)) {
-            markTableChanged(table);
-        }
-    }
-    tables.splice(0, tables.length, ...retained);
-}

package/esm/helpers/toDuckDBValue.d.ts

@@ -1,4 +0,0 @@
-import { type DuckDBValue } from "@duckdb/node-api";
-/** Converts a supported JavaScript data value to its DuckDB binding value. */
-export default function toDuckDBValue(value: unknown): DuckDBValue;
-//# sourceMappingURL=toDuckDBValue.d.ts.map

package/esm/helpers/toDuckDBValue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toDuckDBValue.d.ts","sourceRoot":"","sources":["../../src/helpers/toDuckDBValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAgBjE"}

package/esm/helpers/toDuckDBValue.js

@@ -1,15 +0,0 @@
-import { DuckDBTimestampValue } from "@duckdb/node-api";
-/** Converts a supported JavaScript data value to its DuckDB binding value. */
-export default function toDuckDBValue(value) {
-    if (value === null || value === undefined || Number.isNaN(value)) {
-        return null;
-    }
-    if (value instanceof Date) {
-        return new DuckDBTimestampValue(BigInt(value.getTime() * 1000));
-    }
-    if (typeof value === "string" || typeof value === "number" ||
-        typeof value === "boolean" || typeof value === "bigint") {
-        return value;
-    }
-    throw new Error(`Unknown bind value type ${typeof value} of ${String(value)}`);
-}

package/esm/helpers/umapRandom.d.ts

@@ -1,2 +0,0 @@
-export default function umapRandom(seed: number): () => number;
-//# sourceMappingURL=umapRandom.d.ts.map

package/esm/helpers/umapRandom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"umapRandom.d.ts","sourceRoot":"","sources":["../../src/helpers/umapRandom.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,IAAI,EAAE,MAAM,gBAQ9C"}

package/esm/helpers/umapRandom.js

@@ -1,10 +0,0 @@
-// Mulberry32: separate initialization and sampling streams, stable per seed.
-export default function umapRandom(seed) {
-    let state = seed >>> 0;
-    return () => {
-        state = (state + 0x6D2B79F5) | 0;
-        let value = Math.imul(state ^ state >>> 15, 1 | state);
-        value ^= value + Math.imul(value ^ value >>> 7, 61 | value);
-        return ((value ^ value >>> 14) >>> 0) / 4294967296;
-    };
-}

package/esm/helpers/unifyColumns.d.ts

@@ -1,12 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Adds the columns missing from each table (filled with NULL) so all tables
- * share the same columns. Runs immediately, without queueing, so it's safe
- * inside a barrier's execute, which runs during a flush.
- */
-export default function unifyColumns(allTables: SimpleTable[], allTypes: {
-    [key: string]: string;
-}): Promise<{
-    [key: string]: string[];
-}>;
-//# sourceMappingURL=unifyColumns.d.ts.map

package/esm/helpers/unifyColumns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"unifyColumns.d.ts","sourceRoot":"","sources":["../../src/helpers/unifyColumns.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD;;;;GAIG;AACH,wBAA8B,YAAY,CACxC,SAAS,EAAE,WAAW,EAAE,EACxB,QAAQ,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE;;GAoCpC"}

package/esm/helpers/unifyColumns.js

@@ -1,33 +0,0 @@
-import quoteIdentifier from "./quoteIdentifier.js";
-import mergeOptions from "./mergeOptions.js";
-import queryDB from "./queryDB.js";
-/**
- * Adds the columns missing from each table (filled with NULL) so all tables
- * share the same columns. Runs immediately, without queueing, so it's safe
- * inside a barrier's execute, which runs during a flush.
- */
-export default async function unifyColumns(allTables, allTypes) {
-    const columnsAdded = {};
-    // Each table's columns are fetched once, instead of one hasColumn
-    // round-trip per column and table.
-    const existingColumns = new Map();
-    for (const table of allTables) {
-        existingColumns.set(table, new Set(await table.getColumns()));
-    }
-    for (const column in allTypes) {
-        for (const table of allTables) {
-            if (!existingColumns.get(table).has(column)) {
-                await queryDB(table, `ALTER TABLE ${quoteIdentifier(table.name)} ADD ${quoteIdentifier(column)} ${allTypes[column]};`, mergeOptions(table, {
-                    table: table.name,
-                    method: "insertTables()",
-                    parameters: { column, type: allTypes[column] },
-                }));
-                if (!columnsAdded[table.name]) {
-                    columnsAdded[table.name] = [];
-                }
-                columnsAdded[table.name].push(column);
-            }
-        }
-    }
-    return columnsAdded;
-}

package/esm/helpers/updateColumnsWithJS.d.ts

@@ -1,58 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-/**
- * Generates columns from selected input columns, keeping other SQL values in
- * DuckDB. Call from an asynchronous extension barrier. The callback must return
- * one row per input row in the same order; only the declared output columns are
- * stored. Existing output columns are replaced, with types inferred from the
- * generated values. Generation runs sequentially in bounded batches (1,000 rows
- * by default); callbacks must not depend on receiving the whole table. Non-null
- * output types must agree across batches. All-null batches defer type inference.
- * Only one batch of inputs and outputs is retained by this helper in JavaScript;
- * callers must also bound their own buffering. Reads finish before callbacks or
- * writes use the shared connection. The original table is replaced only after
- * staging succeeds. Empty tables are unchanged and do not invoke the callback;
- * outputs that remain null in every batch use VARCHAR.
- *
- * Untouched geometry columns remain in DuckDB, preserving their values, types
- * and CRS without GeoJSON conversion. Geometry columns cannot be selected as
- * inputs or overwritten as outputs; use updateWithJS() for editable GeoJSON.
- * This SQL-only preservation path accepts any source CRS.
- *
- * @example
- * ```ts
- * queueAsyncBarrier(table, {
- *   method: "label()",
- *   parameters: null,
- *   execute: () => updateColumnsWithJS(table, ["name"], ["label"], async (rows) =>
- *     rows.map((row) => ({ label: String(row.name).toUpperCase() })),
- *     { batchSize: 500 }),
- * });
- * await table.log();
- * ```
- *
- * @param table - Table to enrich.
- *
- * @param inputColumns - Columns available to the callback.
- *
- * @param outputColumns - Generated columns to add or replace.
- *
- * @param generate - Produces one result per input row, in input order.
- *
- * @param options - Controls the maximum rows read, generated, and staged at once.
- *
- * @returns Resolves after merging the generated columns into the table.
- */
-export default function updateColumnsWithJS(table: SimpleTable, inputColumns: string[], outputColumns: string[], generate: (rows: {
-    [key: string]: unknown;
-}[]) => Promise<{
-    [key: string]: unknown;
-}[]>, options?: {
-    /** Maximum rows per callback and transfer batch. Defaults to 1,000.
-     * @example
-     * ```ts
-     * { batchSize: 500 }
-     * ```
-     */
-    batchSize?: number;
-}): Promise<void>;
-//# sourceMappingURL=updateColumnsWithJS.d.ts.map

package/esm/helpers/updateColumnsWithJS.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"updateColumnsWithJS.d.ts","sourceRoot":"","sources":["../../src/helpers/updateColumnsWithJS.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAQvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAA8B,mBAAmB,CAC/C,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,CACR,IAAI,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,KAC/B,OAAO,CAAC;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,CAAC,EAC1C,OAAO,GAAE;IACP;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,IAAI,CAAC,CA0Jf"}

package/esm/helpers/updateColumnsWithJS.js

@@ -1,147 +0,0 @@
-import quoteIdentifier from "./quoteIdentifier.js";
-import readMutationRows from "./readMutationRows.js";
-import { retainRegisteredTables } from "./tableRegistry.js";
-import { prepareArray } from "../methods/loadArray.js";
-import appendColumnBatches from "./appendColumnBatches.js";
-import parseDuckDBType from "./parseDuckDBType.js";
-/**
- * Generates columns from selected input columns, keeping other SQL values in
- * DuckDB. Call from an asynchronous extension barrier. The callback must return
- * one row per input row in the same order; only the declared output columns are
- * stored. Existing output columns are replaced, with types inferred from the
- * generated values. Generation runs sequentially in bounded batches (1,000 rows
- * by default); callbacks must not depend on receiving the whole table. Non-null
- * output types must agree across batches. All-null batches defer type inference.
- * Only one batch of inputs and outputs is retained by this helper in JavaScript;
- * callers must also bound their own buffering. Reads finish before callbacks or
- * writes use the shared connection. The original table is replaced only after
- * staging succeeds. Empty tables are unchanged and do not invoke the callback;
- * outputs that remain null in every batch use VARCHAR.
- *
- * Untouched geometry columns remain in DuckDB, preserving their values, types
- * and CRS without GeoJSON conversion. Geometry columns cannot be selected as
- * inputs or overwritten as outputs; use updateWithJS() for editable GeoJSON.
- * This SQL-only preservation path accepts any source CRS.
- *
- * @example
- * ```ts
- * queueAsyncBarrier(table, {
- *   method: "label()",
- *   parameters: null,
- *   execute: () => updateColumnsWithJS(table, ["name"], ["label"], async (rows) =>
- *     rows.map((row) => ({ label: String(row.name).toUpperCase() })),
- *     { batchSize: 500 }),
- * });
- * await table.log();
- * ```
- *
- * @param table - Table to enrich.
- *
- * @param inputColumns - Columns available to the callback.
- *
- * @param outputColumns - Generated columns to add or replace.
- *
- * @param generate - Produces one result per input row, in input order.
- *
- * @param options - Controls the maximum rows read, generated, and staged at once.
- *
- * @returns Resolves after merging the generated columns into the table.
- */
-export default async function updateColumnsWithJS(table, inputColumns, outputColumns, generate, options = {}) {
-    const batchSize = options.batchSize ?? 1000;
-    if (!Number.isSafeInteger(batchSize) || batchSize < 1) {
-        throw new Error("batchSize must be a positive safe integer.");
-    }
-    if (inputColumns.length === 0 || outputColumns.length === 0) {
-        throw new Error("Input and output columns must not be empty.");
-    }
-    if (new Set(outputColumns.map((name) => name.toLowerCase())).size !==
-        outputColumns.length) {
-        throw new Error("Output columns must be unique.");
-    }
-    const types = await table.getTypes();
-    for (const [name, type] of Object.entries(types)) {
-        if (type.toUpperCase().startsWith("GEOMETRY") &&
-            [...inputColumns, ...outputColumns].some((column) => column.toLowerCase() === name.toLowerCase())) {
-            throw new Error(`Geometry column ${JSON.stringify(name)} cannot be an input or output of updateColumnsWithJS(); use updateWithJS() for editable GeoJSON.`);
-        }
-    }
-    const suffix = crypto.randomUUID().replaceAll("-", "");
-    const id = `__sda_id_${suffix}`;
-    const snapshot = `__sda_source_${suffix}`;
-    const staged = table.sdb.newTable(`__sda_generated_${suffix}`);
-    const q = quoteIdentifier;
-    try {
-        // A SQL snapshot gives every row a stable identity, including duplicate rows
-        // and user columns named rowid. No untouched values cross the JS boundary.
-        await table.sdb.customQuery(`CREATE TEMP TABLE ${q(snapshot)} AS SELECT *, row_number() OVER () AS ${q(id)} FROM ${q(table.name)}`);
-        const knownTypes = new Map();
-        let lastId = "0";
-        let hasRows = false;
-        while (true) {
-            const upperId = BigInt(lastId) + BigInt(batchSize);
-            const { rows } = await readMutationRows(table.connection, `SELECT ${q(id)}, ${inputColumns.map(q).join(", ")} FROM ${q(snapshot)} WHERE ${q(id)} > ${lastId} AND ${q(id)} <= ${upperId}
-        ORDER BY ${q(id)} LIMIT ${batchSize}`);
-            if (rows.length === 0)
-                break;
-            const ids = rows.map((row) => String(row[id]));
-            lastId = ids[ids.length - 1];
-            for (const row of rows)
-                delete row[id];
-            const generated = await generate(rows);
-            if (generated.length !== ids.length) {
-                throw new Error("Column generation must return one row per input row.");
-            }
-            // Generated vectors retain this helper's existing inference contract.
-            const prepared = prepareArray(generated.map((row, i) => ({
-                ...Object.fromEntries(outputColumns.map((name) => [name, row[name]])),
-                [id]: ids[i],
-            })));
-            const batchTypes = new Map(prepared.keys.map((name, i) => [name, prepared.types[i]]));
-            for (const name of outputColumns) {
-                const nonNull = generated.some((row) => row[name] !== null && row[name] !== undefined);
-                if (!nonNull)
-                    continue;
-                const previous = knownTypes.get(name);
-                const current = batchTypes.get(name);
-                if (previous !== undefined && previous !== current) {
-                    throw new Error(`Generated column ${JSON.stringify(name)} changed type from ${previous} to ${current}.`);
-                }
-                if (previous === undefined) {
-                    knownTypes.set(name, current);
-                    if (hasRows) {
-                        await table.sdb.customQuery(`ALTER TABLE ${q(staged.name)} ALTER COLUMN ${q(name)} TYPE ${current} USING NULL`);
-                    }
-                }
-            }
-            if (!hasRows) {
-                await table.sdb.customQuery(`CREATE TEMP TABLE ${q(staged.name)} (${prepared.keys.map((name, i) => `${q(name)} ${prepared.types[i]}`)
-                    .join(", ")})`);
-                hasRows = true;
-            }
-            // All-null batches use the column's established type, avoiding a separate
-            // batch table and SQL copy just to cast nulls into the staged schema.
-            await appendColumnBatches(table.connection, staged.name, prepared.keys.map((name, i) => parseDuckDBType(knownTypes.get(name) ?? prepared.types[i])), prepared.rowCount, (column, start, end) => prepared.columnsData[column].slice(start, end));
-        }
-        if (!hasRows)
-            return;
-        const outputs = new Map(outputColumns.map((name) => [name.toLowerCase(), name]));
-        const columns = Object.keys(types).map((name) => {
-            const replacement = outputs.get(name.toLowerCase());
-            return replacement === undefined
-                ? `original.${q(name)}`
-                : `generated.${q(replacement)} AS ${q(name)}`;
-        });
-        const existing = new Set(Object.keys(types).map((name) => name.toLowerCase()));
-        for (const name of outputColumns) {
-            if (!existing.has(name.toLowerCase())) {
-                columns.push(`generated.${q(name)}`);
-            }
-        }
-        await table.sdb.customQuery(`CREATE OR REPLACE TABLE ${q(table.name)} AS SELECT ${columns.join(", ")} FROM ${q(snapshot)} original JOIN ${q(staged.name)} generated ON original.${q(id)} = CAST(generated.${q(id)} AS BIGINT) ORDER BY original.${q(id)}`);
-    }
-    finally {
-        await table.sdb.customQuery(`DROP TABLE IF EXISTS ${q(snapshot)}; DROP TABLE IF EXISTS ${q(staged.name)};`);
-        retainRegisteredTables(table.sdb, (item) => item !== staged);
-    }
-}

package/esm/helpers/validateGraphRouteResultSchema.d.ts

@@ -1,4 +0,0 @@
-import type { TableSchema } from "./pendingOps.js";
-/** Validates that route result columns do not replace original input columns. */
-export default function validateGraphRouteResultSchema(schema: TableSchema, method: string, additionalResultColumns?: readonly string[], includeTotal?: boolean): void;
-//# sourceMappingURL=validateGraphRouteResultSchema.d.ts.map

package/esm/helpers/validateGraphRouteResultSchema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validateGraphRouteResultSchema.d.ts","sourceRoot":"","sources":["../../src/helpers/validateGraphRouteResultSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,iFAAiF;AACjF,MAAM,CAAC,OAAO,UAAU,8BAA8B,CACpD,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,uBAAuB,GAAE,SAAS,MAAM,EAAO,EAC/C,YAAY,UAAO,GAClB,IAAI,CAmBN"}

package/esm/helpers/validateGraphRouteResultSchema.js

@@ -1,15 +0,0 @@
-import foldIdentifier from "./foldIdentifier.js";
-import quoteIdentifier from "./quoteIdentifier.js";
-const resultColumns = ["pathId", "step", "weight", "total"];
-/** Validates that route result columns do not replace original input columns. */
-export default function validateGraphRouteResultSchema(schema, method, additionalResultColumns = [], includeTotal = true) {
-    for (const resultColumn of [...resultColumns, ...additionalResultColumns]) {
-        if (resultColumn === "total" && !includeTotal)
-            continue;
-        const folded = foldIdentifier(resultColumn);
-        const inputColumn = Object.keys(schema).find((column) => foldIdentifier(column) === folded);
-        if (inputColumn !== undefined) {
-            throw new Error(`${method} cannot add ${quoteIdentifier(resultColumn)} because input column ${quoteIdentifier(inputColumn)} conflicts with that result column. Rename ${quoteIdentifier(inputColumn)} with renameColumns() before calculating the graph.`);
-        }
-    }
-}

package/esm/helpers/validateGraphTemporalEvents.d.ts

@@ -1,7 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-import { type PreparedGraphTemporalOptions } from "./prepareGraphTemporalSql.js";
-/** Rejects invalid selected timestamps before a chronological graph runs. */
-export default function validateGraphTemporalEvents(simpleTable: SimpleTable, options: PreparedGraphTemporalOptions, method: string, parameters: {
-    [key: string]: unknown;
-}): Promise<void>;
-//# sourceMappingURL=validateGraphTemporalEvents.d.ts.map

package/esm/helpers/validateGraphTemporalEvents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validateGraphTemporalEvents.d.ts","sourceRoot":"","sources":["../../src/helpers/validateGraphTemporalEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,OAAgC,EAC9B,KAAK,4BAA4B,EAClC,MAAM,8BAA8B,CAAC;AAItC,6EAA6E;AAC7E,wBAA8B,2BAA2B,CACvD,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,4BAA4B,EACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAiDf"}