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

package/script/helpers/pendingOps.d.ts

@@ -1,153 +0,0 @@
-import type { DuckDBValue } from "@duckdb/node-api";
-/**
- * The types of a table's schema, as returned by DESCRIBE: column names mapped
- * to DuckDB types (e.g., { name: "VARCHAR", salary: "BIGINT" }).
- */
-export type TableSchema = {
-    [column: string]: string;
-};
-/**
- * A queued operation that can be expressed as a single SELECT over its input.
- * At flush time, consecutive fusable operations on the same table are
- * composed as CTEs into one statement.
- */
-export type FusableOp = {
-    kind: "fusable";
-    /** The SDA method that queued the operation (e.g., "filter()"). */
-    method: string;
-    /** The parameters passed to the method, for error reporting. */
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * The operation's position in program order across all tables of the
-     * database, stamped by queueOp.
-     */
-    sequence: number;
-    /**
-     * Whether buildSelect needs the schema of its input relation. When `false`,
-     * the flush compiler skips the DESCRIBE round-trip and passes an empty
-     * schema.
-     */
-    needsSchema: boolean;
-    /**
-     * Whether the SELECT uses spatial functions. The flush compiler loads the
-     * spatial extension once per connection before executing such operations.
-     */
-    needsSpatial?: boolean;
-    /**
-     * The user-supplied SQL fragments embedded verbatim in the SELECT (e.g.,
-     * filter conditions, addColumn definitions). Such SQL can reference tables
-     * by name, and names don't follow a fused chain: a subquery on the
-     * operation's own table would read the pre-chain state instead of the
-     * previous step's output. The flush compiler scans these fragments and
-     * executes the operation against materialized tables when they reference
-     * one.
-     */
-    rawSQL?: string[];
-    /**
-     * Whether the operation's fused segment must be rooted in a materialized
-     * table rather than an external source. Used when DuckDB's source execution
-     * shape affects an observable result such as deterministic sampled-row
-     * order.
-     */
-    requiresMaterializedInput?: boolean;
-    /** Data values bound to placeholders in this operation's SELECT. */
-    values?: DuckDBValue[] | ((schema: TableSchema) => DuckDBValue[]);
-    /**
-     * Whether the SELECT returns exactly the schema of its input (same columns,
-     * same types), like `SELECT * REPLACE` with type-preserving expressions.
-     * The flush compiler reuses the schema across consecutive
-     * schema-preserving operations instead of running a DESCRIBE per step.
-     */
-    preservesSchema?: boolean;
-    /**
-     * Derives the output schema from a known input schema without another
-     * DESCRIBE query. Used by projections and explicit casts whose output types
-     * are fully determined by their arguments.
-     */
-    outputSchema?: (input: TableSchema) => TableSchema;
-    /**
-     * Returns a single SELECT statement over `input`, which is either the
-     * quoted table name or the alias of the previous CTE in the fused chain.
-     */
-    buildSelect: (input: string, schema: TableSchema) => string;
-};
-/**
- * A queued operation that starts a fused segment from an external relational
- * source instead of consuming the target table's current contents.
- */
-export type SourceOp = {
-    kind: "source";
-    /** The SDA method that queued the source (e.g., "loadData()"). */
-    method: string;
-    /** The parameters passed to the method, for error reporting. */
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    /** The operation's position in database-wide program order. */
-    sequence: number;
-    /**
-     * User-supplied SQL fragments or table names read by the source. They close
-     * pending segments for those tables before the source executes.
-     */
-    rawSQL?: string[];
-    /** A schema known from explicit source options, when inference is unnecessary. */
-    schema?: TableSchema;
-    /** Whether the source uses spatial functions. */
-    needsSpatial?: boolean;
-    /** Returns a composable SELECT, optionally inspecting materialized inputs. */
-    buildSelect: () => string | Promise<string>;
-};
-/** A relational operation that can participate in a fused segment. */
-export type RelationalOp = SourceOp | FusableOp;
-/**
- * A queued operation that is multi-statement by nature (or otherwise cannot
- * be expressed as a single SELECT). Barriers execute in order between fused
- * segments.
- */
-export type BarrierOp = {
-    kind: "barrier";
-    /** The SDA method that queued the operation (e.g., "loadData()"). */
-    method: string;
-    /** The parameters passed to the method, for error reporting. */
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * The operation's position in program order across all tables of the
-     * database, stamped by queueOp.
-     */
-    sequence: number;
-    /** Executes the operation. */
-    execute: () => Promise<void>;
-};
-/**
- * An asynchronous extension barrier whose callback can queue builder methods.
- * Nested operations drain before the callback observes the database and before
- * the original chain continues.
- */
-export type AsyncBarrierOp = {
-    kind: "asyncBarrier";
-    /** The extension method that queued the operation. */
-    method: string;
-    /** The parameters passed to the extension method, for error reporting. */
-    parameters: {
-        [key: string]: unknown;
-    } | null;
-    /** The operation's position in database-wide program order. */
-    sequence: number;
-    /** Executes the asynchronous extension operation. */
-    execute: () => Promise<void>;
-};
-/**
- * An operation queued by a sync builder or extension method, executed when
- * the pending chains are flushed at an observation point.
- */
-export type PendingOp = RelationalOp | BarrierOp | AsyncBarrierOp;
-/**
- * A pending operation as built by a sync builder or extension method, before
- * queueOp stamps it with its program-order sequence.
- */
-export type PendingOpInput = Omit<FusableOp, "sequence"> | Omit<SourceOp, "sequence"> | Omit<BarrierOp, "sequence"> | Omit<AsyncBarrierOp, "sequence">;
-//# sourceMappingURL=pendingOps.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pendingOps.d.ts","sourceRoot":"","sources":["../../src/helpers/pendingOps.ts"],"names":[],"mappings":"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"}

package/script/helpers/pendingOps.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/script/helpers/prepareDbExtensions.d.ts

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

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

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

package/script/helpers/prepareDbExtensions.js

@@ -1,28 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = prepareDbExtensions;
-const queryDbFile_js_1 = __importDefault(require("./queryDbFile.js"));
-const parseValue_js_1 = __importDefault(require("./parseValue.js"));
-async function prepareDbExtensions(sdb, database, indexes) {
-    const definitions = Object.values(indexes).flat();
-    const physicalIndexes = await (0, queryDbFile_js_1.default)(sdb, `SELECT sql FROM duckdb_indexes() WHERE database_name = ${(0, parseValue_js_1.default)(database)};`, { returnData: true });
-    if (definitions.some((index) => index.kind === "vss") ||
-        physicalIndexes.some((index) => /\bUSING\s+HNSW\b/i.test(String(index.sql)))) {
-        await (0, queryDbFile_js_1.default)(sdb, "INSTALL vss; LOAD vss; SET hnsw_enable_experimental_persistence = true;");
-    }
-    const ftsSchemas = await (0, queryDbFile_js_1.default)(sdb, `SELECT schema_name FROM duckdb_schemas() WHERE database_name = ${(0, parseValue_js_1.default)(database)} AND starts_with(schema_name, 'fts_');`, { returnData: true });
-    if (definitions.some((index) => index.kind === "fts") || ftsSchemas.length > 0) {
-        await (0, queryDbFile_js_1.default)(sdb, "INSTALL fts; LOAD fts;");
-    }
-    if (!sdb.spatialLoaded) {
-        const geometryColumns = await (0, queryDbFile_js_1.default)(sdb, `SELECT column_name FROM duckdb_columns()
-       WHERE database_name = ${(0, parseValue_js_1.default)(database)} AND data_type ILIKE '%GEOMETRY%' LIMIT 1;`, { returnData: true });
-        if (geometryColumns.length > 0) {
-            await (0, queryDbFile_js_1.default)(sdb, "INSTALL spatial; LOAD spatial; SET geometry_always_xy = true;");
-            sdb.spatialLoaded = true;
-        }
-    }
-}

package/script/helpers/prepareGeometry.d.ts

@@ -1,3 +0,0 @@
-/** Validates and snapshots a two-dimensional WGS84 GeoJSON geometry cell. */
-export default function prepareGeometry(value: unknown, column: string, row: number): string | null;
-//# sourceMappingURL=prepareGeometry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareGeometry.d.ts","sourceRoot":"","sources":["../../src/helpers/prepareGeometry.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CA+Gf"}

package/script/helpers/prepareGeometry.js

@@ -1,102 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = prepareGeometry;
-/** Validates and snapshots a two-dimensional WGS84 GeoJSON geometry cell. */
-function prepareGeometry(value, column, row) {
-    if (value === null)
-        return null;
-    const fail = (message) => {
-        throw new Error(`Column ${JSON.stringify(column)}, row ${row}: ${message}`);
-    };
-    const active = new Set();
-    let hasSignedZero = false;
-    function position(value) {
-        if (!Array.isArray(value) || value.length !== 2 ||
-            !Array.from(value).every((n) => typeof n === "number" && Number.isFinite(n))) {
-            fail("Expected a finite two-dimensional [longitude, latitude] position; Z/M coordinates are unsupported.");
-        }
-        const point = value;
-        if (Math.abs(point[0]) > 180 || Math.abs(point[1]) > 90) {
-            fail("Expected WGS84 longitude [-180, 180] and latitude [-90, 90]; reproject the input first.");
-        }
-        hasSignedZero ||= Object.is(point[0], -0) || Object.is(point[1], -0);
-        return [...point];
-    }
-    function list(value, convert) {
-        if (!Array.isArray(value))
-            fail("Expected a coordinate array.");
-        return Array.from(value, convert);
-    }
-    function line(value) {
-        const points = list(value, position);
-        if (points.length < 2) {
-            fail("A LineString must contain at least two positions.");
-        }
-        return points;
-    }
-    function ring(value) {
-        const points = list(value, position);
-        if (points.length < 4 || points[0][0] !== points.at(-1)[0] ||
-            points[0][1] !== points.at(-1)[1]) {
-            fail("A polygon ring must contain at least four positions and be closed.");
-        }
-        return points;
-    }
-    function geometry(value) {
-        if (typeof value !== "object" || value === null || Array.isArray(value)) {
-            fail("Expected a GeoJSON geometry object or null.");
-        }
-        const object = value;
-        if (active.has(object))
-            fail("Cyclic GeometryCollections are unsupported.");
-        if (active.size >= 100) {
-            fail("GeometryCollections may nest at most 100 levels.");
-        }
-        active.add(object);
-        try {
-            const type = object.type;
-            if (type === "Feature" || type === "FeatureCollection") {
-                fail("Expected a GeoJSON geometry object, not a Feature or FeatureCollection; extract each feature's geometry first.");
-            }
-            if ("crs" in object) {
-                fail("Geometry crs members are unsupported; supply WGS84 coordinates and declare GEOMETRY('EPSG:4326').");
-            }
-            let coordinates;
-            switch (type) {
-                case "Point":
-                    coordinates = position(object.coordinates);
-                    break;
-                case "MultiPoint":
-                    coordinates = list(object.coordinates, position);
-                    break;
-                case "LineString":
-                    coordinates = line(object.coordinates);
-                    break;
-                case "MultiLineString":
-                    coordinates = list(object.coordinates, line);
-                    break;
-                case "Polygon":
-                    coordinates = list(object.coordinates, ring);
-                    break;
-                case "MultiPolygon":
-                    coordinates = list(object.coordinates, (v) => list(v, ring));
-                    break;
-                case "GeometryCollection":
-                    return { type, geometries: list(object.geometries, geometry) };
-                default:
-                    fail("Expected a supported GeoJSON geometry type.");
-            }
-            return { type, coordinates };
-        }
-        finally {
-            active.delete(object);
-        }
-    }
-    const prepared = geometry(value);
-    if (!hasSignedZero)
-        return JSON.stringify(prepared);
-    // JSON.stringify normalizes -0. Only supported geometry type names survive
-    // validation as strings, so the "-0" marker cannot collide with input text.
-    // Emit a decimal literal so DuckDB also preserves its sign when parsing JSON.
-    return JSON.stringify(prepared, (_key, cell) => Object.is(cell, -0) ? "-0" : cell).replaceAll('"-0"', "-0.0");
-}

package/script/helpers/prepareGraphMetricOptions.d.ts

@@ -1,14 +0,0 @@
-export type GraphMetricOptions = {
-    elapsedTime?: boolean;
-    minimize?: "steps" | "weight" | "elapsedTime";
-    weight?: string;
-    startTimeColumn?: string;
-    endTimeColumn?: string;
-};
-export type PreparedGraphMetricOptions = {
-    elapsedTime: boolean;
-    minimize: "steps" | "weight" | "elapsedTime";
-};
-/** Resolves graph cost selection separately from optional elapsed-time reporting. */
-export default function prepareGraphMetricOptions(options: GraphMetricOptions, method: string, optimize: boolean): PreparedGraphMetricOptions;
-//# sourceMappingURL=prepareGraphMetricOptions.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareGraphMetricOptions.d.ts","sourceRoot":"","sources":["../../src/helpers/prepareGraphMetricOptions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;CAC9C,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,0BAA0B,CA2D5B"}

package/script/helpers/prepareGraphMetricOptions.js

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = prepareGraphMetricOptions;
-/** Resolves graph cost selection separately from optional elapsed-time reporting. */
-function prepareGraphMetricOptions(options, method, optimize) {
-    if (options.elapsedTime !== undefined &&
-        typeof options.elapsedTime !== "boolean") {
-        throw new TypeError(`${method} options.elapsedTime must be a boolean.`);
-    }
-    const elapsedTime = options.elapsedTime === true;
-    if (elapsedTime &&
-        (options.startTimeColumn === undefined ||
-            options.endTimeColumn === undefined)) {
-        throw new TypeError(`${method} options.elapsedTime requires both options.startTimeColumn and options.endTimeColumn.`);
-    }
-    if (options.minimize !== undefined) {
-        if (!optimize) {
-            throw new TypeError(`${method} options.minimize is not supported because this method returns all routes.`);
-        }
-        if (options.minimize !== "steps" && options.minimize !== "weight" &&
-            options.minimize !== "elapsedTime") {
-            throw new TypeError(`${method} options.minimize must be "steps", "weight", or "elapsedTime".`);
-        }
-        if (options.minimize === "weight" && options.weight === undefined) {
-            throw new TypeError(`${method} options.minimize: "weight" requires options.weight.`);
-        }
-        if (options.minimize === "elapsedTime" && !elapsedTime) {
-            throw new TypeError(`${method} options.minimize: "elapsedTime" requires options.elapsedTime: true.`);
-        }
-    }
-    if (optimize && elapsedTime && options.weight !== undefined &&
-        options.minimize === undefined) {
-        throw new TypeError(`${method} when weight and elapsedTime are both enabled, specify options.minimize: "steps", "weight", or "elapsedTime".`);
-    }
-    return {
-        elapsedTime,
-        minimize: options.minimize ??
-            (options.weight !== undefined
-                ? "weight"
-                : elapsedTime
-                    ? "elapsedTime"
-                    : "steps"),
-    };
-}

package/script/helpers/prepareGraphRouteSql.d.ts

@@ -1,31 +0,0 @@
-import type { TableSchema } from "./pendingOps.js";
-import { type GraphId, type PreparedGraphStarts } from "./prepareGraphStarts.js";
-export type PreparedGraphRouteEndpoints = {
-    end: PreparedGraphStarts;
-    start: PreparedGraphStarts;
-    values: PreparedGraphStarts;
-};
-/** Prepares and validates the two scalar endpoints shared by route methods. */
-export declare function prepareGraphRouteEndpoints(start: GraphId, end: GraphId, method: string): PreparedGraphRouteEndpoints;
-/** Validates the columns shared by edge-route methods from queued schema data. */
-export declare function validateGraphRouteInputs(schema: TableSchema, source: string, target: string, edgeId: string, endpoints: PreparedGraphRouteEndpoints, weight: string | undefined, method: string, includeTotal?: boolean): {
-    distanceType: string;
-    edgeIdType: string;
-    nodeIdType: string;
-};
-/** Prepares the typed SQL expressions shared by edge-route enumeration. */
-export declare function prepareGraphRouteSql(input: string, schema: TableSchema, source: string, target: string, edgeId: string, endpoints: PreparedGraphRouteEndpoints, weight: string | undefined, method: string, includeTotal?: boolean): {
-    distanceType: string;
-    edgeIdColumn: import("./getGraphEdgeIdColumn.js").GraphEdgeIdColumn;
-    edgeKey: string;
-    edgeWeight: string;
-    endpointValue: string;
-    keyType: string;
-    stepType: string;
-    input: string;
-    schema: TableSchema;
-    traversal: import("./prepareGraphTraversal.js").PreparedGraphTraversal;
-    typedEdgeId: string;
-    weightType: string | undefined;
-};
-//# sourceMappingURL=prepareGraphRouteSql.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareGraphRouteSql.d.ts","sourceRoot":"","sources":["../../src/helpers/prepareGraphRouteSql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAA2B,EACzB,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAMjC,MAAM,MAAM,2BAA2B,GAAG;IACxC,GAAG,EAAE,mBAAmB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACb,2BAA2B,CA+B7B;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,2BAA2B,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,EACd,YAAY,UAAO;;;;EAmBpB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,2BAA2B,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,EACd,YAAY,UAAO;;;;;;;;;;;;;EAkDpB"}

package/script/helpers/prepareGraphRouteSql.js

@@ -1,127 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.prepareGraphRouteEndpoints = prepareGraphRouteEndpoints;
-exports.validateGraphRouteInputs = validateGraphRouteInputs;
-exports.prepareGraphRouteSql = prepareGraphRouteSql;
-const getGraphEdgeIdColumn_js_1 = __importDefault(require("./getGraphEdgeIdColumn.js"));
-const getGraphWeightColumn_js_1 = __importDefault(require("./getGraphWeightColumn.js"));
-const validateGraphRouteResultSchema_js_1 = __importDefault(require("./validateGraphRouteResultSchema.js"));
-const prepareGraphStarts_js_1 = __importDefault(require("./prepareGraphStarts.js"));
-const prepareGraphTraversal_js_1 = __importStar(require("./prepareGraphTraversal.js"));
-const quoteIdentifier_js_1 = __importDefault(require("./quoteIdentifier.js"));
-/** Prepares and validates the two scalar endpoints shared by route methods. */
-function prepareGraphRouteEndpoints(start, end, method) {
-    if (Array.isArray(start)) {
-        throw new TypeError(`${method} start must be one node ID.`);
-    }
-    if (Array.isArray(end)) {
-        throw new TypeError(`${method} end must be one node ID.`);
-    }
-    const preparedStart = (0, prepareGraphStarts_js_1.default)(start, method);
-    const preparedEnd = (0, prepareGraphStarts_js_1.default)(end, method);
-    if (preparedStart.family !== preparedEnd.family) {
-        throw new TypeError(`${method} start and end must both be string IDs or both be numeric IDs.`);
-    }
-    if (preparedStart.values[0] === preparedEnd.values[0]) {
-        throw new TypeError(`${method} start and end must be different. Use distances() to measure return routes or findCycles() to find loops.`);
-    }
-    return {
-        start: preparedStart,
-        end: preparedEnd,
-        values: {
-            family: preparedStart.family,
-            numericValues: [
-                ...preparedStart.numericValues,
-                ...preparedEnd.numericValues,
-            ],
-            values: [preparedStart.values[0], preparedEnd.values[0]],
-        },
-    };
-}
-/** Validates the columns shared by edge-route methods from queued schema data. */
-function validateGraphRouteInputs(schema, source, target, edgeId, endpoints, weight, method, includeTotal = true) {
-    const nodes = (0, prepareGraphTraversal_js_1.validateGraphStarts)(schema, source, target, endpoints.values, method);
-    const edges = (0, getGraphEdgeIdColumn_js_1.default)(schema, edgeId, method);
-    const weightColumn = weight === undefined
-        ? undefined
-        : (0, getGraphWeightColumn_js_1.default)(schema, weight, method);
-    (0, validateGraphRouteResultSchema_js_1.default)(schema, method, [], includeTotal);
-    return {
-        distanceType: weightColumn?.distanceType ?? "BIGINT",
-        edgeIdType: edges.idType,
-        nodeIdType: nodes.idType,
-    };
-}
-/** Prepares the typed SQL expressions shared by edge-route enumeration. */
-function prepareGraphRouteSql(input, schema, source, target, edgeId, endpoints, weight, method, includeTotal = true) {
-    (0, validateGraphRouteResultSchema_js_1.default)(schema, method, [], includeTotal);
-    const traversal = (0, prepareGraphTraversal_js_1.default)(input, schema, source, target, endpoints.values, method);
-    const edgeIdColumn = (0, getGraphEdgeIdColumn_js_1.default)(schema, edgeId, method);
-    const weightColumn = weight === undefined
-        ? undefined
-        : (0, getGraphWeightColumn_js_1.default)(schema, weight, method);
-    const distanceType = weightColumn?.distanceType ?? "BIGINT";
-    const q = quoteIdentifier_js_1.default;
-    const edgeIdReference = `${q("edges")}.${q(edgeIdColumn.column)}`;
-    const typedEdgeId = `CAST(${edgeIdReference} AS ${edgeIdColumn.idType})`;
-    const edgeKey = edgeIdColumn.family === "string"
-        ? `ENCODE(${typedEdgeId})`
-        : typedEdgeId;
-    const edgeWeight = weightColumn === undefined
-        ? `CAST(1 AS ${distanceType})`
-        : `CAST(${q("edges")}.${q(weightColumn.column)} AS ${distanceType})`;
-    const keyType = edgeIdColumn.family === "string"
-        ? "BLOB"
-        : edgeIdColumn.idType;
-    const stepType = `STRUCT(${q("edgeId")} ${edgeIdColumn.idType}, ${q("source")} ${traversal.endpoints.idType}, ${q("target")} ${traversal.endpoints.idType}, ${q("weight")} ${distanceType}, ${q("distance")} ${distanceType})`;
-    return {
-        distanceType,
-        edgeIdColumn,
-        edgeKey,
-        edgeWeight,
-        endpointValue: `TRY_CAST(? AS ${traversal.endpoints.idType})`,
-        keyType,
-        stepType,
-        input,
-        schema,
-        traversal,
-        typedEdgeId,
-        weightType: weightColumn?.type,
-    };
-}

package/script/helpers/prepareGraphStarts.d.ts

@@ -1,9 +0,0 @@
-export type GraphId = string | number | bigint;
-export type PreparedGraphStarts = {
-    family: "string" | "numeric";
-    numericValues: bigint[];
-    values: string[];
-};
-/** Validates and snapshots scalar-or-array graph starting IDs. */
-export default function prepareGraphStarts(start: GraphId | GraphId[], method: string, argument?: string, scalar?: boolean): PreparedGraphStarts;
-//# sourceMappingURL=prepareGraphStarts.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prepareGraphStarts.d.ts","sourceRoot":"","sources":["../../src/helpers/prepareGraphStarts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,EAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,SAAU,EAClB,MAAM,UAAQ,GACb,mBAAmB,CAoErB"}

package/script/helpers/prepareGraphStarts.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = prepareGraphStarts;
-/** Validates and snapshots scalar-or-array graph starting IDs. */
-function prepareGraphStarts(start, method, argument = "start", scalar = false) {
-    const starts = Array.isArray(start) ? [...start] : [start];
-    if (starts.length === 0) {
-        throw new TypeError(`${method} ${argument} must not be an empty array.`);
-    }
-    let family;
-    const values = [];
-    const numericValues = [];
-    const seen = new Set();
-    const duplicates = [];
-    for (const value of starts) {
-        const valueFamily = typeof value === "string"
-            ? "string"
-            : typeof value === "number" || typeof value === "bigint"
-                ? "numeric"
-                : undefined;
-        if (valueFamily === undefined) {
-            throw new TypeError(scalar
-                ? `${method} ${argument} must be a string or a whole number.`
-                : `${method} ${argument} must be a string, a whole number, or an array of those values.`);
-        }
-        if (family !== undefined && family !== valueFamily) {
-            throw new TypeError(`${method} ${argument} must not mix string and numeric IDs.`);
-        }
-        family = valueFamily;
-        let encoded;
-        if (typeof value === "number") {
-            if (!Number.isSafeInteger(value)) {
-                throw new TypeError(`${method} ${argument} contains ${value}, which is not a safe whole number. Use a bigint for exact integer IDs outside JavaScript's safe integer range.`);
-            }
-            encoded = BigInt(value).toString();
-            numericValues.push(BigInt(value));
-        }
-        else if (typeof value === "bigint") {
-            encoded = value.toString();
-            numericValues.push(value);
-        }
-        else {
-            encoded = value;
-        }
-        const key = `${valueFamily}:${encoded}`;
-        if (seen.has(key)) {
-            if (!duplicates.some((duplicate) => graphIdsEqual(duplicate, value))) {
-                duplicates.push(value);
-            }
-        }
-        else {
-            seen.add(key);
-            values.push(encoded);
-        }
-    }
-    if (duplicates.length > 0) {
-        throw new TypeError(`${method} ${argument} contains duplicate IDs: ${duplicates.map(formatGraphId).join(", ")}.`);
-    }
-    return { family: family, numericValues, values };
-}
-function graphIdsEqual(left, right) {
-    if (typeof left === "string" || typeof right === "string") {
-        return left === right;
-    }
-    return BigInt(left) === BigInt(right);
-}
-function formatGraphId(value) {
-    if (typeof value === "string")
-        return JSON.stringify(value);
-    return typeof value === "bigint" ? `${value}n` : String(value);
-}