@nshiab/simple-data-analysis-core 1.0.0 → 2.0.0

package/script/methods/normalize.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = normalize;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function normalize(simpleTable, column, newColumn, options = {}) {
+    if (options.range !== undefined &&
+        (!Array.isArray(options.range) ||
+            options.range.length !== 2 ||
+            !Number.isFinite(options.range[0]) ||
+            !Number.isFinite(options.range[1]) ||
+            options.range[0] >= options.range[1])) {
+        throw new Error("normalize() options.range must contain two finite numbers in ascending order.");
+    }
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "normalize()",
+        parameters: { column, newColumn, options },
+        needsSchema: true,
+        buildSelect: (input, schema) => {
+            (0, assertNewColumns_js_1.default)(schema, [newColumn], "normalize()");
+            const by = options.by ? (0, stringToArray_js_1.default)(options.by) : [];
+            const partition = by.length > 0
+                ? `PARTITION BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")}`
+                : "";
+            const normalizedQuery = `(${(0, quoteIdentifier_js_1.default)(column)} - MIN(${(0, quoteIdentifier_js_1.default)(column)}) OVER(${partition}))
+    /
+    (MAX(${(0, quoteIdentifier_js_1.default)(column)}) OVER(${partition}) - MIN(${(0, quoteIdentifier_js_1.default)(column)}) OVER(${partition}))`;
+            const [rangeMin, rangeMax] = options.range ?? [0, 1];
+            const scaledQuery = options.range === undefined
+                ? normalizedQuery
+                : `${rangeMin} + (${normalizedQuery}) * ${rangeMax - rangeMin}`;
+            return `SELECT *, (
+        ${typeof options.decimals === "number"
+                ? `ROUND(${scaledQuery}, ${options.decimals})`
+                : scaledQuery}
+        ) AS ${(0, quoteIdentifier_js_1.default)(newColumn)},
+    FROM ${input}`;
+        },
+    });
+}

package/script/methods/normalizeString.d.ts

@@ -1,5 +1,5 @@
 import type SimpleTable from "../class/SimpleTable.js";
 export default function normalizeString(simpleTable: SimpleTable, column: string, newColumn: string, options?: {
     stripPunctuation?: boolean;
-}): Promise<void>;
+}): void;
 //# sourceMappingURL=normalizeString.d.ts.map

package/script/methods/normalizeString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeString.d.ts","sourceRoot":"","sources":["../../src/methods/normalizeString.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAIvD,wBAA8B,eAAe,CAC3C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,OAAO,CAAC,IAAI,CAAC,CAiCf"}
+{"version":3,"file":"normalizeString.d.ts","sourceRoot":"","sources":["../../src/methods/normalizeString.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,IAAI,CA2BN"}

package/script/methods/normalizeString.js

@@ -4,29 +4,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = normalizeString;
-const queryDB_js_1 = __importDefault(require("../helpers/queryDB.js"));
-const mergeOptions_js_1 = __importDefault(require("../helpers/mergeOptions.js"));
-async function normalizeString(simpleTable, column, newColumn, options = {}) {
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function normalizeString(simpleTable, column, newColumn, options = {}) {
     const { stripPunctuation = true } = options;
-    const accentRemoved = `strip_accents("${column}")`;
+    const accentRemoved = `strip_accents(${(0, quoteIdentifier_js_1.default)(column)})`;
     const lowercased = `lower(${accentRemoved})`;
     const punctuationRemoved = stripPunctuation
         ? `regexp_replace(${lowercased}, '[[:punct:]]', '', 'g')`
         : lowercased;
     const normalizedClause = `trim(regexp_replace(${punctuationRemoved}, '\\s+', ' ', 'g'))`;
-    await (0, queryDB_js_1.default)(simpleTable, `CREATE OR REPLACE TABLE "${simpleTable.name}" AS 
-    SELECT *,
-      CASE 
-        WHEN "${column}" IS NULL THEN NULL
-        ELSE ${normalizedClause}
-      END AS "${newColumn}"
-    FROM "${simpleTable.name}"`, (0, mergeOptions_js_1.default)(simpleTable, {
-        table: simpleTable.name,
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
         method: "normalizeString()",
-        parameters: {
-            column,
-            newColumn,
-            stripPunctuation,
-        },
-    }));
+        parameters: { column, newColumn, stripPunctuation },
+        needsSchema: false,
+        buildSelect: (input) => `SELECT *,
+      CASE
+        WHEN ${(0, quoteIdentifier_js_1.default)(column)} IS NULL THEN NULL
+        ELSE ${normalizedClause}
+      END AS ${(0, quoteIdentifier_js_1.default)(newColumn)}
+    FROM ${input}`,
+    });
 }

package/script/methods/outliersIQR.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function outliersIQR(simpleTable: SimpleTable, column: string, newColumn: string, options?: {
+    by?: string | string[];
+}): void;
+//# sourceMappingURL=outliersIQR.d.ts.map

package/script/methods/outliersIQR.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outliersIQR.d.ts","sourceRoot":"","sources":["../../src/methods/outliersIQR.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnB,QAWP"}

package/script/methods/outliersIQR.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = outliersIQR;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function outliersIQR(simpleTable, column, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "outliersIQR()",
+        parameters: { column, newColumn, options },
+        needsSchema: false,
+        buildSelect: (input) => outliersIQRSelect(input, column, newColumn, options),
+    });
+}
+function outliersIQRSelect(input, column, newColumn, options = {}) {
+    const by = options.by
+        ? (0, stringToArray_js_1.default)(options.by).map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`)
+        : [];
+    const partition = by.length > 0 ? `PARTITION BY ${by.join(", ")}` : "";
+    const quantile = (fraction) => `IF(COUNT(${(0, quoteIdentifier_js_1.default)(column)}) OVER (${partition}) % 2 = 0,
+      quantile_disc(${(0, quoteIdentifier_js_1.default)(column)}, ${fraction}) OVER (${partition}),
+      quantile_cont(${(0, quoteIdentifier_js_1.default)(column)}, ${fraction}) OVER (${partition})
+    )`;
+    // q1/q3 are computed as window values (one pass) instead of a per-category
+    // CTE joined back through a correlated subquery per row.
+    return `SELECT * EXCLUDE ("_sda_q1", "_sda_q3"), CASE
+        WHEN ${(0, quoteIdentifier_js_1.default)(column)} > "_sda_q3" + ("_sda_q3" - "_sda_q1") * 1.5
+          OR ${(0, quoteIdentifier_js_1.default)(column)} < "_sda_q1" - ("_sda_q3" - "_sda_q1") * 1.5
+        THEN TRUE
+        ELSE FALSE
+    END AS ${(0, quoteIdentifier_js_1.default)(newColumn)}
+    FROM (
+        SELECT *,
+            ${quantile(0.25)} AS "_sda_q1",
+            ${quantile(0.75)} AS "_sda_q3"
+        FROM ${input}
+    ) "_sda"`;
+}

package/script/methods/pad.d.ts

@@ -0,0 +1,6 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function pad(simpleTable: SimpleTable, columns: string | string[], length: number, options?: {
+    side?: "left" | "right";
+    character?: string;
+}): void;
+//# sourceMappingURL=pad.d.ts.map

package/script/methods/pad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.d.ts","sourceRoot":"","sources":["../../src/methods/pad.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,GAAG,CACzB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,QAqB9D"}

package/script/methods/pad.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = pad;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function pad(simpleTable, columns, length, options = {}) {
+    if (!Number.isFinite(length) || !Number.isInteger(length) || length < 0) {
+        throw new Error("pad() length must be a finite integer greater than or equal to 0.");
+    }
+    columns = Array.isArray(columns) ? [...columns] : columns;
+    options = structuredClone(options);
+    const columnList = (0, stringToArray_js_1.default)(columns);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "pad()",
+        parameters: { columns, length, options },
+        needsSchema: true,
+        preservesSchema: true,
+        values: padValues(columnList, length, options),
+        buildSelect: (input, schema) => padSelect(input, schema, columnList, length, options),
+    });
+}
+function padSelect(input, schema, columns, length, options) {
+    for (const column of columns) {
+        if (schema[column] !== "VARCHAR") {
+            throw new Error(`The column ${(0, quoteIdentifier_js_1.default)(column)} is of type ${schema[column]}. The pad() method only works with string (VARCHAR) columns. Please convert the column to string first with the .convert() method.`);
+        }
+    }
+    const usedNames = new Set(Object.keys(schema));
+    const overflowAliases = columns.map((_, index) => {
+        let alias = `__sda_pad_overflow_${index}`;
+        while (usedNames.has(alias)) {
+            alias += "_";
+        }
+        usedNames.add(alias);
+        return alias;
+    });
+    const func = options.side === "right" ? "RPAD" : "LPAD";
+    const counts = columns.map((column, index) => `COUNT(*) FILTER (WHERE LENGTH(${(0, quoteIdentifier_js_1.default)(column)}) > ${length}) OVER () AS ${(0, quoteIdentifier_js_1.default)(overflowAliases[index])}`).join(", ");
+    const replacements = columns.map((column, index) => {
+        const alias = (0, quoteIdentifier_js_1.default)(overflowAliases[index]);
+        return `CASE WHEN ${alias} > 0 THEN error(CONCAT(?, CAST(${alias} AS VARCHAR), ?)) ELSE ${func}(${(0, quoteIdentifier_js_1.default)(column)}, ${length}, ?) END AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+    }).join(", ");
+    const excluded = overflowAliases.map(quoteIdentifier_js_1.default).join(", ");
+    return `SELECT * EXCLUDE (${excluded}) REPLACE (${replacements})
+FROM (
+  SELECT *, ${counts} FROM ${input}
+) AS ${(0, quoteIdentifier_js_1.default)("__sda_pad_source")}`;
+}
+function padValues(columns, length, options) {
+    const character = options.character ?? "0";
+    return columns.flatMap((column) => [
+        `The column ${(0, quoteIdentifier_js_1.default)(column)} has `,
+        ` string(s) exceeding the target length of ${length}. The pad() method does not truncate. Shorten the strings first or use a larger target length.`,
+        character,
+    ]);
+}

package/script/methods/perimeter.d.ts

@@ -0,0 +1,7 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function perimeter(simpleTable: SimpleTable, newColumn: string, options?: {
+    unit?: "m" | "km";
+    column?: string;
+    decimals?: number;
+}): void;
+//# sourceMappingURL=perimeter.d.ts.map

package/script/methods/perimeter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perimeter.d.ts","sourceRoot":"","sources":["../../src/methods/perimeter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,QAyBxE"}

package/script/methods/perimeter.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = perimeter;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function perimeter(simpleTable, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "perimeter()",
+        parameters: { newColumn, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "perimeter()");
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "perimeter()", simpleTable.name);
+            let expression = `ST_Perimeter_Spheroid(${(0, quoteIdentifier_js_1.default)(column)}) ${options.unit === "km" ? "/ 1000" : ""}`;
+            if (typeof options.decimals === "number") {
+                expression = `ROUND(${expression}, ${options.decimals})`;
+            }
+            return `SELECT *, CAST(${expression} AS DOUBLE) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/quantiles.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function quantiles(simpleTable: SimpleTable, column: string, count: number, newColumn: string, options?: {
+    by?: string | string[];
+}): void;
+//# sourceMappingURL=quantiles.d.ts.map

package/script/methods/quantiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantiles.d.ts","sourceRoot":"","sources":["../../src/methods/quantiles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnB,QAuBP"}

package/script/methods/quantiles.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = quantiles;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function quantiles(simpleTable, column, count, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "quantiles()",
+        parameters: { column, count, newColumn, options },
+        needsSchema: true,
+        buildSelect: (input, schema) => {
+            (0, assertNewColumns_js_1.default)(schema, [newColumn], "quantiles()");
+            const by = options.by ? (0, stringToArray_js_1.default)(options.by) : [];
+            const partition = by.length === 0
+                ? ""
+                : `PARTITION BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(",")} `;
+            return `SELECT *, ntile(${count}) OVER (${partition}ORDER BY ${(0, quoteIdentifier_js_1.default)(column)}) AS ${(0, quoteIdentifier_js_1.default)(newColumn)}
+    FROM ${input}`;
+        },
+    });
+}

package/script/methods/randomPoint.d.ts

@@ -0,0 +1,6 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function randomPoint(simpleTable: SimpleTable, newColumn: string, tries: number, options?: {
+    column?: string;
+    strict?: boolean;
+}): void;
+//# sourceMappingURL=randomPoint.d.ts.map

package/script/methods/randomPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomPoint.d.ts","sourceRoot":"","sources":["../../src/methods/randomPoint.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAGvD,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,QAmBpD"}

package/script/methods/randomPoint.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = randomPoint;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const findGeoColumn_js_1 = __importDefault(require("../helpers/findGeoColumn.js"));
+const mergeOptions_js_1 = __importDefault(require("../helpers/mergeOptions.js"));
+const queryDB_js_1 = __importDefault(require("../helpers/queryDB.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const ensureSpatial_js_1 = __importDefault(require("../helpers/ensureSpatial.js"));
+function randomPoint(simpleTable, newColumn, tries, options = {}) {
+    options = structuredClone(options);
+    // This validation doesn't need the database, so it stays at call time.
+    if (!Number.isFinite(tries) || !Number.isInteger(tries) || tries < 0) {
+        throw new Error("randomPoint() tries must be a finite integer greater than or equal to 0.");
+    }
+    // The generated points are checked against the data afterwards, so
+    // randomPoint can't be expressed as a single SELECT over its input: it
+    // executes as a barrier.
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "barrier",
+        method: "randomPoint()",
+        parameters: { newColumn, tries, options },
+        execute: () => executeRandomPoint(simpleTable, newColumn, tries, options),
+    });
+}
+async function executeRandomPoint(simpleTable, newColumn, tries, options) {
+    await (0, ensureSpatial_js_1.default)(simpleTable);
+    const column = typeof options.column === "string"
+        ? options.column
+        : await (0, findGeoColumn_js_1.default)(simpleTable, "randomPoint()");
+    const geoType = await simpleTable.getProjection(column);
+    await (0, queryDB_js_1.default)(simpleTable, randomPointQuery(simpleTable.name, column, newColumn, tries, geoType, options.strict !== false), (0, mergeOptions_js_1.default)(simpleTable, {
+        table: simpleTable.name,
+        method: "randomPoint()",
+        parameters: { column, newColumn, tries, options, geoType },
+    }));
+}
+function randomPointQuery(table, column, newColumn, tries, geoType, strict) {
+    // Recursive CTE approach: each iteration only carries forward the rows that
+    // have NOT yet found a valid interior point, so DuckDB stops per-row as soon
+    // as ST_Within is satisfied — giving O(1) behaviour for easy polygons instead
+    // of the O(N) materialisation that occurs with LATERAL + range() + WHERE.
+    //
+    // Zero-tries contract: `WHERE 1 <= ${tries}` in the base case
+    // produces no rows when tries is 0, so the LEFT JOIN returns NULL for
+    // every row and the UPDATE sets the column to NULL — no special-case branch
+    // needed and the normal UPDATE code path is always exercised.
+    //
+    // Volatility guard: `CASE WHEN (rid + n) IS NOT NULL THEN random() END`
+    // prevents the planner from constant-folding random() across iterations while
+    // still evaluating to random() for every non-null row.
+    const failedExpression = strict
+        ? `CASE WHEN v.failed_count > 0 THEN error(CONCAT(CAST(v.failed_count AS VARCHAR), ' points could not be generated. Consider increasing tries or set options.strict to false.')) ELSE v.pt::${geoType} END`
+        : `v.pt::${geoType}`;
+    const select = newColumn === column
+        ? `t.* REPLACE (${failedExpression} AS ${(0, quoteIdentifier_js_1.default)(newColumn)})`
+        : `t.*, ${failedExpression} AS ${(0, quoteIdentifier_js_1.default)(newColumn)}`;
+    return `CREATE OR REPLACE TABLE ${(0, quoteIdentifier_js_1.default)(table)} AS
+WITH RECURSIVE
+base AS (
+    SELECT
+        rowid AS rid,
+        ${(0, quoteIdentifier_js_1.default)(column)} AS geom,
+        ST_XMin(${(0, quoteIdentifier_js_1.default)(column)}) AS xmin,
+        ST_XMax(${(0, quoteIdentifier_js_1.default)(column)}) - ST_XMin(${(0, quoteIdentifier_js_1.default)(column)}) AS xdiff,
+        ST_YMin(${(0, quoteIdentifier_js_1.default)(column)}) AS ymin,
+        ST_YMax(${(0, quoteIdentifier_js_1.default)(column)}) - ST_YMin(${(0, quoteIdentifier_js_1.default)(column)}) AS ydiff
+    FROM ${(0, quoteIdentifier_js_1.default)(table)}
+),
+attempts(rid, geom, xmin, xdiff, ymin, ydiff, pt, n) AS (
+    SELECT
+        rid, geom, xmin, xdiff, ymin, ydiff,
+        ST_Point(
+            xmin + CASE WHEN rid IS NOT NULL THEN random() END * xdiff,
+            ymin + CASE WHEN rid IS NOT NULL THEN random() END * ydiff
+        ),
+        1
+    FROM base
+    WHERE 1 <= ${tries}
+    UNION ALL
+    SELECT
+        rid, geom, xmin, xdiff, ymin, ydiff,
+        ST_Point(
+            xmin + CASE WHEN (rid + n) IS NOT NULL THEN random() END * xdiff,
+            ymin + CASE WHEN (rid + n) IS NOT NULL THEN random() END * ydiff
+        ),
+        n + 1
+    FROM attempts
+    WHERE NOT ST_Within(pt, geom) AND n < ${tries}
+),
+valid_points AS (
+    SELECT rid, pt
+    FROM attempts
+    WHERE ST_Within(pt, geom)
+    QUALIFY ROW_NUMBER() OVER (PARTITION BY rid ORDER BY n) = 1
+),
+generated AS (
+    SELECT
+        b.rid,
+        vp.pt,
+        COUNT(*) FILTER (WHERE vp.pt IS NULL) OVER () AS failed_count
+    FROM (SELECT rowid AS rid FROM ${(0, quoteIdentifier_js_1.default)(table)}) b
+    LEFT JOIN valid_points vp ON b.rid = vp.rid
+)
+SELECT ${select}
+FROM ${(0, quoteIdentifier_js_1.default)(table)} t
+JOIN generated v ON t.rowid = v.rid;`;
+}

package/script/methods/ranks.d.ts

@@ -0,0 +1,7 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function ranks(simpleTable: SimpleTable, column: string, newColumn: string, options?: {
+    order?: "asc" | "desc";
+    by?: string | string[];
+    dense?: boolean;
+}): void;
+//# sourceMappingURL=ranks.d.ts.map

package/script/methods/ranks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranks.d.ts","sourceRoot":"","sources":["../../src/methods/ranks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,KAAK,CAC3B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,QAyBP"}

package/script/methods/ranks.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = ranks;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function ranks(simpleTable, column, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "ranks()",
+        parameters: { column, newColumn, options },
+        needsSchema: true,
+        buildSelect: (input, schema) => {
+            (0, assertNewColumns_js_1.default)(schema, [newColumn], "ranks()");
+            const by = options.by ? (0, stringToArray_js_1.default)(options.by) : [];
+            const partition = by.length === 0
+                ? ""
+                : `PARTITION BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(",")} `;
+            return `SELECT *, ${options.dense ? "dense_rank()" : "rank()"} OVER (${partition}ORDER BY ${(0, quoteIdentifier_js_1.default)(column)} ${typeof options.order === "string" ? options.order.toUpperCase() : ""}) AS ${(0, quoteIdentifier_js_1.default)(newColumn)}
+    FROM ${input}`;
+        },
+    });
+}

package/script/methods/reducePrecision.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function reducePrecision(simpleTable: SimpleTable, decimals: number, options?: {
+    column?: string;
+}): void;
+//# sourceMappingURL=reducePrecision.d.ts.map

package/script/methods/reducePrecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducePrecision.d.ts","sourceRoot":"","sources":["../../src/methods/reducePrecision.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAyBlC"}

package/script/methods/reducePrecision.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = reducePrecision;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function reducePrecision(simpleTable, decimals, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "reducePrecision()",
+        parameters: { decimals, options },
+        needsSchema: true,
+        needsSpatial: true,
+        // The cast pins the geometry column back to its existing type, so the
+        // schema is unchanged.
+        preservesSchema: true,
+        buildSelect: (input, types) => {
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "reducePrecision()", simpleTable.name);
+            // The schema type carries the projection (e.g. GEOMETRY('EPSG:4326')),
+            // so the cast keeps it on the new geometries.
+            return `SELECT * REPLACE (ST_ReducePrecision(${(0, quoteIdentifier_js_1.default)(column)}, ${1 / Math.pow(10, decimals)})::${types[column]} AS ${(0, quoteIdentifier_js_1.default)(column)}) FROM ${input}`;
+        },
+    });
+}

package/script/methods/removeColumns.d.ts

@@ -0,0 +1,3 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function removeColumns(simpleTable: SimpleTable, columns: string | string[]): void;
+//# sourceMappingURL=removeColumns.d.ts.map

package/script/methods/removeColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeColumns.d.ts","sourceRoot":"","sources":["../../src/methods/removeColumns.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAa3B"}

package/script/methods/removeColumns.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = removeColumns;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function removeColumns(simpleTable, columns) {
+    const cols = (0, stringToArray_js_1.default)(columns);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "removeColumns()",
+        parameters: { columns },
+        needsSchema: false,
+        buildSelect: (input) => `SELECT * EXCLUDE (${cols.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")}) FROM ${input}`,
+    });
+}

package/script/methods/removeDuplicates.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function removeDuplicates(simpleTable: SimpleTable, options?: {
+    on?: string | string[];
+}): void;
+//# sourceMappingURL=removeDuplicates.d.ts.map

package/script/methods/removeDuplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeDuplicates.d.ts","sourceRoot":"","sources":["../../src/methods/removeDuplicates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnB,QAiBP"}

package/script/methods/removeDuplicates.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = removeDuplicates;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function removeDuplicates(simpleTable, options = {}) {
+    const columnsOn = options.on ? (0, stringToArray_js_1.default)(options.on) : null;
+    const distinct = columnsOn
+        ? `DISTINCT ON(${columnsOn.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(",")}) *`
+        : "DISTINCT *";
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "removeDuplicates()",
+        parameters: { options },
+        needsSchema: false,
+        preservesSchema: true,
+        buildSelect: (input) => `SELECT ${distinct} FROM ${input}`,
+    });
+}

package/script/methods/removeMissing.d.ts

@@ -3,5 +3,5 @@ export default function removeMissing(simpleTable: SimpleTable, options?: {
     columns?: string | string[];
     missingValues?: (string | number)[];
     invert?: boolean;
-}): Promise<void>;
+}): void;
 //# sourceMappingURL=removeMissing.d.ts.map

package/script/methods/removeMissing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"removeMissing.d.ts","sourceRoot":"","sources":["../../src/methods/removeMissing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,wBAA8B,aAAa,CACzC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,iBA8BP"}
+{"version":3,"file":"removeMissing.d.ts","sourceRoot":"","sources":["../../src/methods/removeMissing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAIvD,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,QA+BP"}