@nshiab/simple-data-analysis-core 1.0.1 → 2.0.1

package/esm/methods/fuzzyJoin.js

@@ -1,11 +1,37 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import getIdenticalColumns from "../helpers/getIdenticalColumns.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
-import fuzzyJoinQuery from "./fuzzyJoinQuery.js";
-export default async function fuzzyJoin(leftTable, rightTable, leftColumn, rightColumn, threshold, options = {}) {
+import queueOp from "../helpers/queueOp.js";
+import assertSameDatabase from "../helpers/assertSameDatabase.js";
+import buildFuzzyMatchSql from "../helpers/buildFuzzyMatchSql.js";
+export default function fuzzyJoin(leftTable, rightTable, leftColumn, rightColumn, threshold, options = {}) {
+    assertSameDatabase(leftTable.sdb, [rightTable], "fuzzyJoin()");
+    options = structuredClone(options);
+    // This validation doesn't need the database, so it stays at call time.
     if (leftColumn === rightColumn) {
-        throw new Error(`The leftColumn and rightColumn have the same name "${leftColumn}". Rename one of them before doing the fuzzy join.`);
+        throw new Error(`The leftColumn and rightColumn have the same name ${quoteIdentifier(leftColumn)}. Rename one of them before doing the fuzzy join.`);
     }
+    // The output table instance is created at call time so it can be returned
+    // synchronously and chained on right away.
+    const outputTable = typeof options.outputTable === "string"
+        ? leftTable.sdb.newTable(options.outputTable)
+        : leftTable;
+    queueOp(outputTable, {
+        kind: "barrier",
+        method: "fuzzyJoin()",
+        parameters: {
+            leftColumn,
+            rightColumn,
+            rightTable: rightTable.name,
+            threshold,
+            options,
+        },
+        execute: () => executeFuzzyJoin(leftTable, rightTable, outputTable, leftColumn, rightColumn, threshold, options),
+    });
+    return outputTable;
+}
+async function executeFuzzyJoin(leftTable, rightTable, outputTable, leftColumn, rightColumn, threshold, options) {
     const leftCols = await leftTable.getColumns();
     const rightCols = await rightTable.getColumns();
     const identicalColumns = getIdenticalColumns(leftCols, rightCols);
@@ -17,18 +43,23 @@ export default async function fuzzyJoin(leftTable, rightTable, leftColumn, right
             throw new Error(`The tables have columns with identical names. Rename or remove "${identicalColumnsForError[0]}" in one of the two tables before doing the fuzzy join.`);
         }
         else {
-            throw new Error(`The tables have columns with identical names. Rename or remove ${identicalColumnsForError.map((d) => `"${d}"`).join(", ")} in one of the two tables before doing the fuzzy join.`);
+            throw new Error(`The tables have columns with identical names. Rename or remove ${identicalColumnsForError.map((d) => `${quoteIdentifier(d)}`).join(", ")} in one of the two tables before doing the fuzzy join.`);
         }
     }
     const method = options.method ?? "ratio";
     const similarityColumn = options.similarityColumn;
-    const outputTableName = typeof options.outputTable === "string"
-        ? options.outputTable
-        : leftTable.name;
+    // The right table's copy of a column shared with the left table (only
+    // rightColumn can be shared, checked above) is excluded from the SELECT
+    // directly, instead of dropping its _1 duplicate with a rewrite after the
+    // join.
+    const rightSelect = rightCols
+        .filter((d) => !leftCols.includes(d))
+        .map((d) => `${quoteIdentifier(rightTable.name)}.${quoteIdentifier(d)}`)
+        .join(", ");
     const sql = `INSTALL rapidfuzz FROM community; LOAD rapidfuzz;\n` +
-        fuzzyJoinQuery(leftTable.name, leftColumn, rightTable.name, rightColumn, method, threshold, outputTableName, similarityColumn, options.preFilterPrefixLen);
+        fuzzyJoinQuery(leftTable.name, leftColumn, rightTable.name, rightColumn, method, threshold, outputTable.name, similarityColumn, rightSelect, options.prefilterPrefixLength);
     await queryDB(leftTable, sql, mergeOptions(leftTable, {
-        table: outputTableName,
+        table: outputTable.name,
         method: "fuzzyJoin()",
         parameters: {
             leftColumn,
@@ -38,15 +69,25 @@ export default async function fuzzyJoin(leftTable, rightTable, leftColumn, right
             options,
         },
     }));
-    const outputTable = typeof options.outputTable === "string"
-        ? leftTable.sdb.newTable(options.outputTable)
-        : leftTable;
-    // Remove the duplicate right-column produced when leftColumn === rightColumn
-    // (DuckDB suffixes it with _1 in SELECT *)
-    const outputCols = await outputTable.getColumns();
-    const duplicateCol = `${rightColumn}_1`;
-    if (outputCols.includes(duplicateCol)) {
-        await outputTable.removeColumns([duplicateCol]);
+}
+function fuzzyJoinQuery(leftTable, leftColumn, rightTable, rightColumn, method, threshold, outputTable, similarityColumn, rightSelect, prefilterPrefixLength) {
+    const leftExpression = `${quoteIdentifier(leftTable)}.${quoteIdentifier(leftColumn)}`;
+    const rightExpression = `${quoteIdentifier(rightTable)}.${quoteIdentifier(rightColumn)}`;
+    const { scoreExpression, condition } = buildFuzzyMatchSql(leftExpression, rightExpression, method, threshold, { decimals: 2, prefilterPrefixLength });
+    if (similarityColumn) {
+        return `CREATE OR REPLACE TABLE ${quoteIdentifier(outputTable)} AS
+SELECT * EXCLUDE ("_sda_score"), "_sda_score" AS ${quoteIdentifier(similarityColumn)}
+FROM (
+  SELECT ${quoteIdentifier(leftTable)}.*, ${rightSelect}, ${scoreExpression} AS "_sda_score"
+  FROM ${quoteIdentifier(leftTable)} LEFT JOIN ${quoteIdentifier(rightTable)} ON ${condition}
+) _sda
+ORDER BY ${quoteIdentifier(leftColumn)}, "_sda_score" DESC;\n`;
     }
-    return outputTable;
+    return `CREATE OR REPLACE TABLE ${quoteIdentifier(outputTable)} AS
+SELECT *
+FROM (
+  SELECT ${quoteIdentifier(leftTable)}.*, ${rightSelect}
+  FROM ${quoteIdentifier(leftTable)} LEFT JOIN ${quoteIdentifier(rightTable)} ON ${condition}
+) _sda
+ORDER BY ${quoteIdentifier(leftColumn)}, ${quoteIdentifier(rightColumn)};\n`;
 }

package/esm/methods/getBottom.d.ts

@@ -3,6 +3,6 @@ export default function getBottom(simpleTable: SimpleTable, count: number, optio
     originalOrder?: boolean;
     conditions?: string;
 }): Promise<{
-    [key: string]: string | number | boolean | Date | null;
+    [key: string]: unknown;
 }[]>;
 //# sourceMappingURL=getBottom.d.ts.map

package/esm/methods/getBottom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getBottom.d.ts","sourceRoot":"","sources":["../../src/methods/getBottom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,SAAS,CACrC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;KA6BP"}
+{"version":3,"file":"getBottom.d.ts","sourceRoot":"","sources":["../../src/methods/getBottom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,SAAS,CACrC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;KA6BP"}

package/esm/methods/getBottom.js

@@ -1,17 +1,18 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
 export default async function getBottom(simpleTable, count, options = {}) {
     const queryResult = await queryDB(simpleTable, `WITH "numberedRowsForGetBottom" AS (
-                SELECT *, row_number() OVER () as "rowNumberForGetBottom" FROM "${simpleTable.name}"${options.conditions ? ` WHERE ${options.conditions}` : ""}
+                SELECT *, row_number() OVER () as "rowNumberForGetBottom" FROM ${quoteIdentifier(simpleTable.name)}${options.conditions ? ` WHERE ${options.conditions}` : ""}
             )
             SELECT * FROM "numberedRowsForGetBottom" ORDER BY "rowNumberForGetBottom" DESC LIMIT ${count};`, mergeOptions(simpleTable, {
         table: simpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getBottom()",
         parameters: { count, options },
     }));
     if (!queryResult) {
-        throw new Error("No queryResult");
+        throw new Error("The query did not return a result.");
     }
     const rowsRaw = queryResult.map((d) => {
         delete d.rowNumberForGetBottom;

package/esm/methods/getBoundingBox.d.ts

@@ -0,0 +1,3 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function getBoundingBox(simpleTable: SimpleTable, column?: string): Promise<[number, number, number, number]>;
+//# sourceMappingURL=getBoundingBox.d.ts.map

package/esm/methods/getBoundingBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBoundingBox.d.ts","sourceRoot":"","sources":["../../src/methods/getBoundingBox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,cAAc,CAC1C,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAkB3C"}

package/esm/methods/getBoundingBox.js

@@ -0,0 +1,19 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
+import findGeoColumn from "../helpers/findGeoColumn.js";
+import mergeOptions from "../helpers/mergeOptions.js";
+import queryDB from "../helpers/queryDB.js";
+export default async function getBoundingBox(simpleTable, column) {
+    const col = column ?? (await findGeoColumn(simpleTable, "getBoundingBox()"));
+    const result = (await queryDB(simpleTable, `SELECT
+                MIN(ST_YMin(${quoteIdentifier(col)})) AS minX,
+                MIN(ST_XMin(${quoteIdentifier(col)})) AS minY,
+                MAX(ST_YMax(${quoteIdentifier(col)})) AS maxX,
+                MAX(ST_XMax(${quoteIdentifier(col)})) AS maxY,
+            from ${quoteIdentifier(simpleTable.name)};`, mergeOptions(simpleTable, {
+        table: simpleTable.name,
+        method: "getBoundingBox()",
+        parameters: { column },
+        returnData: true,
+    })));
+    return [result[0].minY, result[0].minX, result[0].maxY, result[0].maxX];
+}

package/esm/methods/getCharacterCount.d.ts

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

package/esm/methods/getCharacterCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCharacterCount.d.ts","sourceRoot":"","sources":["../../src/methods/getCharacterCount.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,iBAAiB,CAC7C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,mBAsBf"}

package/esm/methods/getCharacterCount.js

@@ -0,0 +1,17 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
+import mergeOptions from "../helpers/mergeOptions.js";
+import queryDB from "../helpers/queryDB.js";
+import quoteQualifiedIdentifier from "../helpers/quoteQualifiedIdentifier.js";
+export default async function getCharacterCount(SimpleTable, column) {
+    const queryResult = await queryDB(SimpleTable, `SELECT CAST(SUM(LENGTH(${quoteQualifiedIdentifier(SimpleTable.name, column)})) AS BIGINT) AS total_chars FROM ${quoteIdentifier(SimpleTable.name)}`, mergeOptions(SimpleTable, {
+        table: SimpleTable.name,
+        returnData: true,
+        method: "getCharacterCount()",
+        parameters: { column },
+    }));
+    if (!queryResult) {
+        throw new Error("The query did not return a result.");
+    }
+    const result = Number(queryResult[0].total_chars);
+    return result;
+}

package/esm/methods/getColumns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getColumns.d.ts","sourceRoot":"","sources":["../../src/methods/getColumns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,UAAU,CAAC,WAAW,EAAE,WAAW,qBAmBhE"}
+{"version":3,"file":"getColumns.d.ts","sourceRoot":"","sources":["../../src/methods/getColumns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,UAAU,CAAC,WAAW,EAAE,WAAW,qBAmBhE"}

package/esm/methods/getColumns.js

@@ -1,14 +1,15 @@
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 export default async function getColumns(simpleTable) {
-    const queryResult = await queryDB(simpleTable, `DESCRIBE ${simpleTable.name}`, mergeOptions(simpleTable, {
+    const queryResult = await queryDB(simpleTable, `DESCRIBE ${quoteIdentifier(simpleTable.name)}`, mergeOptions(simpleTable, {
         table: simpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getColumns()",
         parameters: {},
     }));
     if (!queryResult) {
-        throw new Error("No result");
+        throw new Error("The query did not return a result.");
     }
     const columns = queryResult.map((d) => d.column_name);
     return columns;

package/esm/methods/getData.d.ts

@@ -0,0 +1,9 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function getData(simpleTable: SimpleTable, options?: {
+    columns?: string | string[];
+    conditions?: string;
+    limit?: number;
+}): Promise<{
+    [key: string]: unknown;
+}[]>;
+//# sourceMappingURL=getData.d.ts.map

package/esm/methods/getData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getData.d.ts","sourceRoot":"","sources":["../../src/methods/getData.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAIvD,wBAA8B,OAAO,CACnC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX;;KAmCP"}

package/esm/methods/getData.js

@@ -0,0 +1,23 @@
+import mergeOptions from "../helpers/mergeOptions.js";
+import queryDB from "../helpers/queryDB.js";
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
+import quoteQualifiedIdentifier from "../helpers/quoteQualifiedIdentifier.js";
+export default async function getData(simpleTable, options = {}) {
+    if (options.limit !== undefined &&
+        (!Number.isInteger(options.limit) || options.limit < 0)) {
+        throw new Error("getData() limit must be an integer greater than or equal to 0.");
+    }
+    const columns = options.columns
+        ? (typeof options.columns === "string"
+            ? [options.columns]
+            : options.columns)
+        : undefined;
+    return (await queryDB(simpleTable, `SELECT ${columns
+        ? columns.map((column) => quoteQualifiedIdentifier(simpleTable.name, column)).join(", ")
+        : "*"} from ${quoteIdentifier(simpleTable.name)}${options.conditions ? ` WHERE ${options.conditions}` : ""}${options.limit === undefined ? "" : ` LIMIT ${options.limit}`}`, mergeOptions(simpleTable, {
+        returnData: true,
+        table: simpleTable.name,
+        method: "getData()",
+        parameters: { options },
+    })));
+}

package/esm/methods/getDescription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDescription.d.ts","sourceRoot":"","sources":["../../src/methods/getDescription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,cAAc,CAAC,WAAW,EAAE,WAAW;YAc3C,MAAM;;WAEP,MAAM;YACC,MAAM;UACV,MAAM;KAIjC"}
+{"version":3,"file":"getDescription.d.ts","sourceRoot":"","sources":["../../src/methods/getDescription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,cAAc,CAAC,WAAW,EAAE,WAAW;;;WAoB1C,MAAM;YACG,MAAM;UACZ,MAAM;KAKnC"}

package/esm/methods/getDescription.js

@@ -2,19 +2,24 @@ export default async function getDescription(simpleTable) {
     const types = await simpleTable.getTypes();
     const columns = await simpleTable.getColumns();
     const summaryForGetDescription = await simpleTable.summarize({
-        values: columns,
-        summaries: ["count", "countUnique", "countNull"],
-        toMs: true,
+        columns: columns,
+        stats: ["count", "countDistinct", "countNull"],
+        datesToMs: true,
         outputTable: "summaryForGetDescription",
     });
     const summaryData = await summaryForGetDescription.getData();
     await summaryForGetDescription.removeTable();
-    const description = summaryData.map((d) => ({
-        column: d["value"],
-        type: types[d["value"]],
-        count: d["count"],
-        unique: d["countUnique"],
-        null: d["countNull"],
-    }));
+    // summarize adds the `column` output column only when it summarizes more than one
+    // column; for a single-column table the column name is already known.
+    const description = summaryData.map((d) => {
+        const column = columns.length > 1 ? d.column : columns[0];
+        return {
+            column,
+            type: types[column],
+            count: d["count"],
+            unique: d["countDistinct"],
+            null: d["countNull"],
+        };
+    });
     return description;
 }

package/esm/methods/getFirstRow.d.ts

@@ -2,6 +2,6 @@ import type SimpleTable from "../class/SimpleTable.js";
 export default function getFirstRow(simpleTable: SimpleTable, options?: {
     conditions?: string;
 }): Promise<{
-    [key: string]: string | number | boolean | Date | null;
+    [key: string]: unknown;
 }>;
 //# sourceMappingURL=getFirstRow.d.ts.map

package/esm/methods/getFirstRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFirstRow.d.ts","sourceRoot":"","sources":["../../src/methods/getFirstRow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,WAAW,CACvC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;GAqBP"}
+{"version":3,"file":"getFirstRow.d.ts","sourceRoot":"","sources":["../../src/methods/getFirstRow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,WAAW,CACvC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;GAqBP"}

package/esm/methods/getFirstRow.js

@@ -1,15 +1,16 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
 export default async function getFirstRow(simpleTable, options = {}) {
-    const queryResult = await queryDB(simpleTable, `SELECT * FROM "${simpleTable.name}"${options.conditions ? ` WHERE ${options.conditions}` : ""} LIMIT 1`, mergeOptions(simpleTable, {
+    const queryResult = await queryDB(simpleTable, `SELECT * FROM ${quoteIdentifier(simpleTable.name)}${options.conditions ? ` WHERE ${options.conditions}` : ""} LIMIT 1`, mergeOptions(simpleTable, {
         table: simpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getFirstRow()",
         parameters: { options },
     }));
     if (!queryResult) {
-        throw new Error("No queryResult");
+        throw new Error("The query did not return a result.");
     }
     const result = queryResult[0];
-    return result;
+    return result ?? null;
 }

package/esm/methods/getGeoData.d.ts

@@ -10,7 +10,7 @@ export default function getGeoData(SimpleTable: SimpleTable, column: string, opt
             coordinates: unknown[];
         };
         properties: {
-            [key: string]: string | number | boolean | Date | null;
+            [key: string]: unknown;
         };
     }[];
 }>;

package/esm/methods/getGeoData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getGeoData.d.ts","sourceRoot":"","sources":["../../src/methods/getGeoData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAMvD,wBAA8B,UAAU,CACtC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;kBAuBtB,MAAM;yBACC,OAAO,EAAE;;;;;;GAgC7B"}
+{"version":3,"file":"getGeoData.d.ts","sourceRoot":"","sources":["../../src/methods/getGeoData.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAMvD,wBAA8B,UAAU,CACtC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;kBA0BtB,MAAM;yBACC,OAAO,EAAE;;;;;;GAgC7B"}

package/esm/methods/getGeoData.js

@@ -1,16 +1,18 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import rewind from "../helpers/rewind.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
 export default async function getGeoData(SimpleTable, column, options = {}) {
-    const query = `SELECT * EXCLUDE ${column}, ST_AsGeoJSON(${column}) as geoJsonFragment from "${SimpleTable.name}";`;
+    const quotedColumn = quoteIdentifier(column);
+    const query = `SELECT * EXCLUDE ${quotedColumn}, ST_AsGeoJSON(${quotedColumn}) AS ${quoteIdentifier("geoJsonFragment")} FROM ${quoteIdentifier(SimpleTable.name)};`;
     const queryResult = await queryDB(SimpleTable, query, mergeOptions(SimpleTable, {
         table: null,
         method: "getGeoData()",
         parameters: { column },
-        returnDataFrom: "query",
+        returnData: true,
     }));
     if (!queryResult) {
-        throw new Error("No queryResults");
+        throw new Error("The query did not return a result.");
     }
     const features = queryResult.map((d) => {
         const { geoJsonFragment, ...properties } = d;

package/esm/methods/getHash.d.ts

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

package/esm/methods/getHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHash.d.ts","sourceRoot":"","sources":["../../src/methods/getHash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAMvD,wBAA8B,OAAO,CAAC,WAAW,EAAE,WAAW,gBAyC7D"}

package/esm/methods/getHash.js

@@ -0,0 +1,39 @@
+import crypto from "node:crypto";
+import mergeOptions from "../helpers/mergeOptions.js";
+import queryDB from "../helpers/queryDB.js";
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
+import getTypes from "./getTypes.js";
+export default async function getHash(simpleTable) {
+    const types = await getTypes(simpleTable);
+    const result = await queryDB(simpleTable, `WITH numbered AS (
+      SELECT
+        ROW_NUMBER() OVER () AS __sda_position,
+        source AS __sda_row
+      FROM ${quoteIdentifier(simpleTable.name)} AS source
+    )
+    SELECT
+      CAST(COUNT(*) AS VARCHAR) AS row_count,
+      CAST(
+        COALESCE(BIT_XOR(MD5_NUMBER(numbered::VARCHAR)), 0)
+        AS VARCHAR
+      ) AS checksum
+    FROM numbered`, mergeOptions(simpleTable, {
+        table: simpleTable.name,
+        returnData: true,
+        method: "getHash()",
+        parameters: {},
+    }));
+    if (result === null || result.length !== 1) {
+        throw new Error("getHash() could not compute the table hash.");
+    }
+    const { row_count, checksum } = result[0];
+    if (typeof row_count !== "string" || typeof checksum !== "string") {
+        throw new Error("getHash() received an unexpected result from DuckDB.");
+    }
+    return crypto.createHash("sha256").update(JSON.stringify([
+        "sda-table-hash-v1",
+        Object.entries(types),
+        row_count,
+        checksum,
+    ])).digest("hex");
+}

package/esm/methods/getLastRow.d.ts

@@ -2,6 +2,6 @@ import type SimpleTable from "../class/SimpleTable.js";
 export default function getLastRow(simpleTable: SimpleTable, options?: {
     conditions?: string;
 }): Promise<{
-    [key: string]: string | number | boolean | Date | null;
-}>;
+    [key: string]: unknown;
+} | null>;
 //# sourceMappingURL=getLastRow.d.ts.map

package/esm/methods/getLastRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getLastRow.d.ts","sourceRoot":"","sources":["../../src/methods/getLastRow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,UAAU,CACtC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;GAwBP"}
+{"version":3,"file":"getLastRow.d.ts","sourceRoot":"","sources":["../../src/methods/getLastRow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,UAAU,CACtC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB;;UA2BP"}

package/esm/methods/getLastRow.js

@@ -1,19 +1,23 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
 export default async function getLastRow(simpleTable, options = {}) {
     const queryResult = await queryDB(simpleTable, `WITH "numberedRowsForGetLastRow" AS (
-                SELECT *, row_number() OVER () as "rowNumberForGetLastRow" FROM "${simpleTable.name}"${options.conditions ? ` WHERE ${options.conditions}` : ""}
+                SELECT *, row_number() OVER () as "rowNumberForGetLastRow" FROM ${quoteIdentifier(simpleTable.name)}${options.conditions ? ` WHERE ${options.conditions}` : ""}
             )
             SELECT * FROM "numberedRowsForGetLastRow" ORDER BY "rowNumberForGetLastRow" DESC LIMIT 1;`, mergeOptions(simpleTable, {
         table: simpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getLastRow()",
         parameters: { options },
     }));
     if (!queryResult) {
-        throw new Error("No queryResult");
+        throw new Error("The query did not return a result.");
     }
     const result = queryResult[0];
+    if (result === undefined) {
+        return null;
+    }
     delete result.rowNumberForGetLastRow;
     return result;
 }

package/esm/methods/getMax.d.ts

@@ -1,3 +1,3 @@
 import type SimpleTable from "../class/SimpleTable.js";
-export default function getMax(simpleTable: SimpleTable, column: string): Promise<string | number | boolean | Date | null>;
+export default function getMax(simpleTable: SimpleTable, column: string): Promise<unknown>;
 //# sourceMappingURL=getMax.d.ts.map

package/esm/methods/getMax.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMax.d.ts","sourceRoot":"","sources":["../../src/methods/getMax.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,MAAM,CAClC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,oDAuBf"}
+{"version":3,"file":"getMax.d.ts","sourceRoot":"","sources":["../../src/methods/getMax.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,MAAM,CAClC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,oBAuBf"}

package/esm/methods/getMax.js

@@ -1,17 +1,17 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
+import quoteQualifiedIdentifier from "../helpers/quoteQualifiedIdentifier.js";
 export default async function getMax(simpleTable, column) {
-    const queryResult = await queryDB(simpleTable, `SELECT MAX("${column}") AS "${column}" FROM "${simpleTable.name}"`, {
-        ...mergeOptions(simpleTable, {
-            table: simpleTable.name,
-            returnDataFrom: "query",
-            method: "getMax()",
-            parameters: { column },
-        }),
-        types: await simpleTable.getTypes(),
-    });
+    const qualifiedColumn = quoteQualifiedIdentifier(simpleTable.name, column);
+    const queryResult = await queryDB(simpleTable, `SELECT MAX(${qualifiedColumn}) AS ${quoteIdentifier(column)} FROM ${quoteIdentifier(simpleTable.name)}`, mergeOptions(simpleTable, {
+        table: simpleTable.name,
+        returnData: true,
+        method: "getMax()",
+        parameters: { column },
+    }));
     if (!queryResult) {
-        throw new Error("No queryResults");
+        throw new Error("The query did not return a result.");
     }
     const result = queryResult[0][column];
     return result;

package/esm/methods/getMean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMean.d.ts","sourceRoot":"","sources":["../../src/methods/getMean.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,OAAO,CACnC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,mBAsBP"}
+{"version":3,"file":"getMean.d.ts","sourceRoot":"","sources":["../../src/methods/getMean.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,OAAO,CACnC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,mBA2BP"}

package/esm/methods/getMean.js

@@ -1,16 +1,19 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
+import quoteQualifiedIdentifier from "../helpers/quoteQualifiedIdentifier.js";
 export default async function getMean(simpleTable, column, options = {}) {
+    const qualifiedColumn = quoteQualifiedIdentifier(simpleTable.name, column);
     const queryResult = await queryDB(simpleTable, typeof options.decimals === "number"
-        ? `SELECT ROUND(AVG("${column}"), ${options.decimals}) AS "${column}" FROM "${simpleTable.name}"`
-        : `SELECT AVG("${column}") AS "${column}" FROM "${simpleTable.name}"`, mergeOptions(simpleTable, {
+        ? `SELECT ROUND(AVG(${qualifiedColumn}), ${options.decimals}) AS ${quoteIdentifier(column)} FROM ${quoteIdentifier(simpleTable.name)}`
+        : `SELECT AVG(${qualifiedColumn}) AS ${quoteIdentifier(column)} FROM ${quoteIdentifier(simpleTable.name)}`, mergeOptions(simpleTable, {
         table: simpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getMean()",
         parameters: { column, options },
     }));
     if (!queryResult) {
-        throw new Error("No queryResults");
+        throw new Error("The query did not return a result.");
     }
     const result = queryResult[0][column];
     return result;

package/esm/methods/getMedian.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMedian.d.ts","sourceRoot":"","sources":["../../src/methods/getMedian.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,SAAS,CACrC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,mBAqBP"}
+{"version":3,"file":"getMedian.d.ts","sourceRoot":"","sources":["../../src/methods/getMedian.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,SAAS,CACrC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,mBA0BP"}

package/esm/methods/getMedian.js

@@ -1,16 +1,19 @@
+import quoteIdentifier from "../helpers/quoteIdentifier.js";
 import mergeOptions from "../helpers/mergeOptions.js";
 import queryDB from "../helpers/queryDB.js";
+import quoteQualifiedIdentifier from "../helpers/quoteQualifiedIdentifier.js";
 export default async function getMedian(SimpleTable, column, options = {}) {
+    const qualifiedColumn = quoteQualifiedIdentifier(SimpleTable.name, column);
     const queryResult = await queryDB(SimpleTable, typeof options.decimals === "number"
-        ? `SELECT ROUND(MEDIAN("${column}"), ${options.decimals}) AS "${column}" FROM "${SimpleTable.name}"`
-        : `SELECT MEDIAN("${column}") AS "${column}" FROM "${SimpleTable.name}"`, mergeOptions(SimpleTable, {
+        ? `SELECT ROUND(MEDIAN(${qualifiedColumn}), ${options.decimals}) AS ${quoteIdentifier(column)} FROM ${quoteIdentifier(SimpleTable.name)}`
+        : `SELECT MEDIAN(${qualifiedColumn}) AS ${quoteIdentifier(column)} FROM ${quoteIdentifier(SimpleTable.name)}`, mergeOptions(SimpleTable, {
         table: SimpleTable.name,
-        returnDataFrom: "query",
+        returnData: true,
         method: "getMedian()",
         parameters: { column, options },
     }));
     if (!queryResult) {
-        throw new Error("No queryResults");
+        throw new Error("The query did not return a result.");
     }
     const result = queryResult[0][column];
     return result;

package/esm/methods/getMin.d.ts

@@ -1,3 +1,3 @@
 import type SimpleTable from "../class/SimpleTable.js";
-export default function getMin(simpleTable: SimpleTable, column: string): Promise<string | number | boolean | Date | null>;
+export default function getMin(simpleTable: SimpleTable, column: string): Promise<unknown>;
 //# sourceMappingURL=getMin.d.ts.map

package/esm/methods/getMin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMin.d.ts","sourceRoot":"","sources":["../../src/methods/getMin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,MAAM,CAClC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,oDAsBf"}
+{"version":3,"file":"getMin.d.ts","sourceRoot":"","sources":["../../src/methods/getMin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,wBAA8B,MAAM,CAClC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,oBAsBf"}