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

package/script/helpers/updateColumnsWithJS.js

@@ -1,153 +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 = updateColumnsWithJS;
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const readMutationRows_js_1 = __importDefault(require("./readMutationRows.js"));
-const tableRegistry_js_1 = require("./tableRegistry.js");
-const loadArray_js_1 = require("../methods/loadArray.js");
-const appendColumnBatches_js_1 = __importDefault(require("./appendColumnBatches.js"));
-const parseDuckDBType_js_1 = __importDefault(require("./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.
- */
-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_js_1.default;
-    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 (0, readMutationRows_js_1.default)(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 = (0, loadArray_js_1.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 (0, appendColumnBatches_js_1.default)(table.connection, staged.name, prepared.keys.map((name, i) => (0, parseDuckDBType_js_1.default)(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)};`);
-        (0, tableRegistry_js_1.retainRegisteredTables)(table.sdb, (item) => item !== staged);
-    }
-}

package/script/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/script/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/script/helpers/validateGraphRouteResultSchema.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 = validateGraphRouteResultSchema;
-const foldIdentifier_js_1 = __importDefault(require("./foldIdentifier.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const resultColumns = ["pathId", "step", "weight", "total"];
-/** Validates that route result columns do not replace original input columns. */
-function validateGraphRouteResultSchema(schema, method, additionalResultColumns = [], includeTotal = true) {
-    for (const resultColumn of [...resultColumns, ...additionalResultColumns]) {
-        if (resultColumn === "total" && !includeTotal)
-            continue;
-        const folded = (0, foldIdentifier_js_1.default)(resultColumn);
-        const inputColumn = Object.keys(schema).find((column) => (0, foldIdentifier_js_1.default)(column) === folded);
-        if (inputColumn !== undefined) {
-            throw new Error(`${method} cannot add ${(0, quoteIdentifier_js_1.default)(resultColumn)} because input column ${(0, quoteIdentifier_js_1.default)(inputColumn)} conflicts with that result column. Rename ${(0, quoteIdentifier_js_1.default)(inputColumn)} with renameColumns() before calculating the graph.`);
-        }
-    }
-}

package/script/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/script/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"}

package/script/helpers/validateGraphTemporalEvents.js

@@ -1,53 +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 = validateGraphTemporalEvents;
-const mergeOptions_js_1 = __importDefault(require("./mergeOptions.js"));
-const prepareGraphTemporalSql_js_1 = __importDefault(require("./prepareGraphTemporalSql.js"));
-const queryDB_js_1 = __importDefault(require("./queryDB.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-/** Rejects invalid selected timestamps before a chronological graph runs. */
-async function validateGraphTemporalEvents(simpleTable, options, method, parameters) {
-    const schema = await simpleTable.getTypes();
-    const temporal = (0, prepareGraphTemporalSql_js_1.default)(schema, options, method);
-    const q = quoteIdentifier_js_1.default;
-    const eventsName = "__graph_temporal_events";
-    const events = q(eventsName);
-    const eventStart = `${events}.${q("__event_start")}`;
-    const eventEnd = `${events}.${q("__event_end")}`;
-    const rows = await (0, queryDB_js_1.default)(simpleTable, `SELECT CASE
-      WHEN ${eventStart} IS NULL THEN 1
-      WHEN ${eventEnd} IS NULL THEN 2
-      WHEN NOT isfinite(${eventStart}) THEN 3
-      WHEN NOT isfinite(${eventEnd}) THEN 4
-      ELSE 5
-    END AS ${q("reason")}
-    FROM (
-      SELECT ${temporal.eventSelections().join(", ")}
-      FROM ${q(simpleTable.name)}
-    ) AS ${events}
-    WHERE (${temporal.eventValidity(eventsName)}) IS NOT TRUE
-    LIMIT 1`, (0, mergeOptions_js_1.default)(simpleTable, {
-        table: simpleTable.name,
-        method,
-        parameters,
-        returnData: true,
-    }));
-    const reason = rows?.[0]?.reason;
-    if (reason === undefined)
-        return;
-    const startColumn = temporal.startTimeColumn ?? temporal.endTimeColumn;
-    const endColumn = temporal.endTimeColumn ?? temporal.startTimeColumn;
-    const message = reason === 1
-        ? `selected start-time column ${q(startColumn)} contains a null timestamp.`
-        : reason === 2
-            ? `selected end-time column ${q(endColumn)} contains a null timestamp.`
-            : reason === 3
-                ? `selected start-time column ${q(startColumn)} contains an infinite timestamp.`
-                : reason === 4
-                    ? `selected end-time column ${q(endColumn)} contains an infinite timestamp.`
-                    : `selected end-time column ${q(endColumn)} contains a timestamp before its start in ${q(startColumn)}.`;
-    throw new TypeError(`${method} ${message}`);
-}

package/script/helpers/validateNumericalAnalysis.d.ts

@@ -1,29 +0,0 @@
-import type { TableSchema } from "./pendingOps.js";
-/**
- * Validates the column options shared by numerical pair analyses.
- *
- * @example
- * ```ts
- * const columns = validateNumericalAnalysis(
- *   { x: "DOUBLE", y: "BIGINT" },
- *   { x: "x" },
- *   "correlations()",
- *   "measurements",
- * );
- * ```
- *
- * @param types - The schema of the table being analyzed.
- *
- * @param options - The optional x and y columns selected by the caller.
- *
- * @param method - The SDA method performing the analysis.
- *
- * @param tableName - The name of the table being analyzed.
- *
- * @returns All numeric columns in the table schema.
- */
-export default function validateNumericalAnalysis(types: TableSchema, options: {
-    x?: string;
-    y?: string;
-}, method: string, tableName: string): string[];
-//# sourceMappingURL=validateNumericalAnalysis.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validateNumericalAnalysis.d.ts","sourceRoot":"","sources":["../../src/helpers/validateNumericalAnalysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAoDV"}

package/script/helpers/validateNumericalAnalysis.js

@@ -1,59 +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 = validateNumericalAnalysis;
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const keepNumericalColumns_js_1 = __importDefault(require("./keepNumericalColumns.js"));
-/**
- * Validates the column options shared by numerical pair analyses.
- *
- * @example
- * ```ts
- * const columns = validateNumericalAnalysis(
- *   { x: "DOUBLE", y: "BIGINT" },
- *   { x: "x" },
- *   "correlations()",
- *   "measurements",
- * );
- * ```
- *
- * @param types - The schema of the table being analyzed.
- *
- * @param options - The optional x and y columns selected by the caller.
- *
- * @param method - The SDA method performing the analysis.
- *
- * @param tableName - The name of the table being analyzed.
- *
- * @returns All numeric columns in the table schema.
- */
-function validateNumericalAnalysis(types, options, method, tableName) {
-    if (options.x === undefined && options.y !== undefined) {
-        throw new Error(`${method} options.y cannot be used without options.x. Provide options.x, or omit options.y to analyze every numeric column pair.`);
-    }
-    const numericalColumns = (0, keepNumericalColumns_js_1.default)(types);
-    const requestedColumns = [options.x, options.y].filter((column) => column !== undefined);
-    for (const column of requestedColumns) {
-        const type = types[column];
-        if (type === undefined) {
-            const availableColumns = Object.keys(types).sort();
-            throw new Error(`${method} could not find column ${(0, quoteIdentifier_js_1.default)(column)} in table ${(0, quoteIdentifier_js_1.default)(tableName)}. Available columns: ${availableColumns.map(quoteIdentifier_js_1.default).join(", ")}.`);
-        }
-        if (!numericalColumns.includes(column)) {
-            throw new Error(`${method} requires numeric columns, but column ${(0, quoteIdentifier_js_1.default)(column)} in table ${(0, quoteIdentifier_js_1.default)(tableName)} has type ${type}. Convert ${(0, quoteIdentifier_js_1.default)(column)} to a numeric type first.`);
-        }
-    }
-    if (options.y === undefined && numericalColumns.length < 2) {
-        const found = numericalColumns.length === 0
-            ? ""
-            : `: ${numericalColumns.map(quoteIdentifier_js_1.default).join(", ")}`;
-        const missingCount = 2 - numericalColumns.length;
-        const columnsToConvert = numericalColumns.length === 0
-            ? `${missingCount} columns`
-            : `${missingCount} more column${missingCount === 1 ? "" : "s"}`;
-        throw new Error(`${method} requires at least 2 numeric columns in table ${(0, quoteIdentifier_js_1.default)(tableName)}, but found ${numericalColumns.length}${found}. Convert at least ${columnsToConvert} to ${missingCount === 1 ? "a numeric type" : "numeric types"} first.`);
-    }
-    return numericalColumns;
-}

package/script/helpers/validateVectorRowIds.d.ts

@@ -1,4 +0,0 @@
-import type { DuckDBConnection } from "@duckdb/node-api";
-/** Validate the positional identity contract before bounded vector scans. */
-export default function validateVectorRowIds(connection: DuckDBConnection, rows: string, count: number): Promise<void>;
-//# sourceMappingURL=validateVectorRowIds.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validateVectorRowIds.d.ts","sourceRoot":"","sources":["../../src/helpers/validateVectorRowIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,6EAA6E;AAC7E,wBAA8B,oBAAoB,CAChD,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/script/helpers/validateVectorRowIds.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = validateVectorRowIds;
-/** Validate the positional identity contract before bounded vector scans. */
-async function validateVectorRowIds(connection, rows, count) {
-    // Graph state and DuckDB scratch schemas use signed INTEGER vertex ids.
-    if (!Number.isSafeInteger(count) || count < 1 || count > 2147483647) {
-        throw new Error("Vector row count must fit a positive INTEGER vertex count.");
-    }
-    const [actual, distinct, minimum, maximum, invalid] = (await connection.runAndReadAll(`SELECT count(*),count(DISTINCT vertex),
-      min(vertex),max(vertex),count(*) FILTER (
-        WHERE vertex IS NULL OR vertex!=trunc(vertex)) FROM ${rows}`))
-        .getRowsJS()[0];
-    if (Number(actual) !== count || Number(distinct) !== count ||
-        Number(minimum) !== 0 || Number(maximum) !== count - 1 ||
-        Number(invalid) !== 0) {
-        throw new Error(`Vector rows must contain exactly ${count} unique integer vertex ids from 0 to ${count - 1}.`);
-    }
-}

package/script/helpers/vectorDistanceExpression.d.ts

@@ -1,6 +0,0 @@
-/**
- * Build a DOUBLE-precision distance expression for prepared vector aliases.
- * Cosine callers first stabilize their private rows with stabilizeCosineVectors.
- */
-export default function vectorDistanceExpression(left: string, right: string, metric: "euclidean" | "cosine"): string;
-//# sourceMappingURL=vectorDistanceExpression.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"vectorDistanceExpression.d.ts","sourceRoot":"","sources":["../../src/helpers/vectorDistanceExpression.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAC7B,MAAM,CAKR"}

package/script/helpers/vectorDistanceExpression.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = vectorDistanceExpression;
-/**
- * Build a DOUBLE-precision distance expression for prepared vector aliases.
- * Cosine callers first stabilize their private rows with stabilizeCosineVectors.
- */
-function vectorDistanceExpression(left, right, metric) {
-    if (metric === "euclidean")
-        return `array_distance(${left},${right})`;
-    // DuckDB can return tiny positive or negative errors for equal/cosine-aligned
-    // vectors. Exact equality also makes duplicate behavior deterministic.
-    return `CASE WHEN ${left}=${right} THEN 0 ELSE greatest(0,array_cosine_distance(${left},${right})) END`;
-}

package/script/helpers/wrapString.d.ts

@@ -1,40 +0,0 @@
-/**
- * Wraps a string to a specified maximum width, attempting to break at word
- * boundaries when possible. If a single word exceeds the maximum width, it
- * will be broken at a grapheme boundary, keeping combining accents with their
- * letters. This function is primarily used for preparing text to be displayed
- * in console tables. Widths count graphemes, not terminal columns for wide
- * characters or emoji.
- *
- * @example
- * ```typescript
- * const text = "This is a very long sentence that needs to be wrapped";
- * const wrapped = wrapString(text, 20);
- * console.log(wrapped);
- * // Output:
- * // This is a very long
- * // sentence that needs
- * // to be wrapped
- * ```
- *
- * @example
- * ```typescript
- * // Character-based wrapping (no word boundaries)
- * const text = "Thisisaverylongword";
- * const wrapped = wrapString(text, 10, false);
- * // Output: Thisisaver
- * //         ylongword
- * ```
- *
- * @param str - The string to wrap.
- *
- * @param maxWidth - The maximum number of graphemes in each line.
- *
- * @param wordWrap - If true, attempts to break at word boundaries. If false,
- *   breaks at grapheme boundaries. Defaults to `true`.
- *
- * @returns The wrapped string with newline characters inserted at appropriate
- *   positions.
- */
-export default function wrapString(str: string, maxWidth: number, wordWrap?: boolean): string;
-//# sourceMappingURL=wrapString.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"wrapString.d.ts","sourceRoot":"","sources":["../../src/helpers/wrapString.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,UAAO,GACd,MAAM,CA6DR"}

package/script/helpers/wrapString.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 = wrapString;
-const splitGraphemes_js_1 = __importDefault(require("./splitGraphemes.js"));
-/**
- * Wraps a string to a specified maximum width, attempting to break at word
- * boundaries when possible. If a single word exceeds the maximum width, it
- * will be broken at a grapheme boundary, keeping combining accents with their
- * letters. This function is primarily used for preparing text to be displayed
- * in console tables. Widths count graphemes, not terminal columns for wide
- * characters or emoji.
- *
- * @example
- * ```typescript
- * const text = "This is a very long sentence that needs to be wrapped";
- * const wrapped = wrapString(text, 20);
- * console.log(wrapped);
- * // Output:
- * // This is a very long
- * // sentence that needs
- * // to be wrapped
- * ```
- *
- * @example
- * ```typescript
- * // Character-based wrapping (no word boundaries)
- * const text = "Thisisaverylongword";
- * const wrapped = wrapString(text, 10, false);
- * // Output: Thisisaver
- * //         ylongword
- * ```
- *
- * @param str - The string to wrap.
- *
- * @param maxWidth - The maximum number of graphemes in each line.
- *
- * @param wordWrap - If true, attempts to break at word boundaries. If false,
- *   breaks at grapheme boundaries. Defaults to `true`.
- *
- * @returns The wrapped string with newline characters inserted at appropriate
- *   positions.
- */
-function wrapString(str, maxWidth, wordWrap = true) {
-    const graphemes = (0, splitGraphemes_js_1.default)(str);
-    if (graphemes.length <= maxWidth) {
-        return str;
-    }
-    if (!wordWrap) {
-        // Simple grapheme-based wrapping
-        const lines = [];
-        for (let i = 0; i < graphemes.length; i += maxWidth) {
-            lines.push(graphemes.slice(i, i + maxWidth).join(""));
-        }
-        return lines.join("\n");
-    }
-    // Word-aware wrapping
-    const lines = [];
-    let currentLine = "";
-    let currentWidth = 0;
-    const words = str.split(/(\s+)/); // Split but keep whitespace
-    for (const word of words) {
-        const wordGraphemes = (0, splitGraphemes_js_1.default)(word);
-        const wordWidth = wordGraphemes.length;
-        // If adding this word would exceed maxWidth
-        if (currentWidth + wordWidth > maxWidth) {
-            // If current line is not empty, save it
-            if (currentLine.length > 0) {
-                lines.push(currentLine.trimEnd());
-                currentLine = "";
-                currentWidth = 0;
-            }
-            // If the word itself is longer than maxWidth, break it
-            if (wordWidth > maxWidth) {
-                for (let i = 0; i < wordWidth; i += maxWidth) {
-                    const chunk = wordGraphemes.slice(i, i + maxWidth).join("");
-                    if (i + maxWidth < wordWidth) {
-                        lines.push(chunk);
-                    }
-                    else {
-                        currentLine = chunk;
-                        currentWidth = wordWidth - i;
-                    }
-                }
-            }
-            else {
-                currentLine = word;
-                currentWidth = wordWidth;
-            }
-        }
-        else {
-            currentLine += word;
-            currentWidth += wordWidth;
-        }
-    }
-    // Add any remaining text
-    if (currentLine.length > 0) {
-        lines.push(currentLine.trimEnd());
-    }
-    return lines.join("\n");
-}

package/script/helpers/writeDataAsArrays.d.ts

@@ -1,3 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-export default function writeDataAsArrays(simpleTable: SimpleTable, file: string): Promise<void>;
-//# sourceMappingURL=writeDataAsArrays.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"writeDataAsArrays.d.ts","sourceRoot":"","sources":["../../src/helpers/writeDataAsArrays.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAIvD,wBAA8B,iBAAiB,CAC7C,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,iBASb"}

package/script/helpers/writeDataAsArrays.js

@@ -1,19 +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 = writeDataAsArrays;
-const dataToArrays_js_1 = __importDefault(require("./dataToArrays.js"));
-const getExtension_js_1 = __importDefault(require("./getExtension.js"));
-const node_fs_1 = require("node:fs");
-async function writeDataAsArrays(simpleTable, file) {
-    const fileExtension = (0, getExtension_js_1.default)(file);
-    if (fileExtension === "json") {
-        const data = await simpleTable.getData();
-        (0, node_fs_1.writeFileSync)(file, JSON.stringify((0, dataToArrays_js_1.default)(data)));
-    }
-    else {
-        throw new Error("The option dataAsArrays works only with json files.");
-    }
-}

package/script/helpers/writeDbMetadata.d.ts

@@ -1,4 +0,0 @@
-import type SimpleDB from "../class/SimpleDB.js";
-import type { IndexDefinition } from "./indexDefinitions.js";
-export default function writeDbMetadata(sdb: SimpleDB, database: string, indexes: Record<string, IndexDefinition[]>): Promise<void>;
-//# sourceMappingURL=writeDbMetadata.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"writeDbMetadata.d.ts","sourceRoot":"","sources":["../../src/helpers/writeDbMetadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,wBAA8B,eAAe,CAC3C,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/script/helpers/writeDbMetadata.js

@@ -1,15 +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 = writeDbMetadata;
-const queryDbFile_js_1 = __importDefault(require("./queryDbFile.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-const parseValue_js_1 = __importDefault(require("./parseValue.js"));
-async function writeDbMetadata(sdb, database, indexes) {
-    const catalog = (0, quoteIdentifier_js_1.default)(database);
-    await (0, queryDbFile_js_1.default)(sdb, `CREATE SCHEMA IF NOT EXISTS ${catalog}.__sda;
-     CREATE OR REPLACE TABLE ${catalog}.__sda.metadata AS
-     SELECT 1 AS version, ${(0, parseValue_js_1.default)(JSON.stringify(indexes))}::VARCHAR AS indexes;`);
-}

package/script/helpers/writeGeoData.d.ts

@@ -1,9 +0,0 @@
-import type SimpleTable from "../class/SimpleTable.js";
-export default function writeGeoData(table: SimpleTable, file: string, options?: {
-    precision?: number;
-    compression?: boolean;
-    rewind?: boolean;
-    metadata?: unknown;
-    formatDates?: boolean;
-}): Promise<void>;
-//# sourceMappingURL=writeGeoData.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"writeGeoData.d.ts","sourceRoot":"","sources":["../../src/helpers/writeGeoData.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,YAAY,CACxC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GACL,OAAO,CAAC,IAAI,CAAC,CAqFf"}