@nshiab/simple-data-analysis-core 2.1.7 → 2.1.8

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

@@ -1 +1 @@
-{"version":3,"file":"buildGraphTemporalCostStateSql.d.ts","sourceRoot":"","sources":["../../src/helpers/buildGraphTemporalCostStateSql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,OAAO,UAAU,8BAA8B,CACpD,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,kBAAkB,EAAE,MAAM,KAAK,MAAM,CAAC,EAC/D,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,wBAAwB,EAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,MAAM,EAAO,GAC7B,yBAAyB,CAuF3B"}
+{"version":3,"file":"buildGraphTemporalCostStateSql.d.ts","sourceRoot":"","sources":["../../src/helpers/buildGraphTemporalCostStateSql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,OAAO,UAAU,8BAA8B,CACpD,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,kBAAkB,EAAE,MAAM,KAAK,MAAM,CAAC,EAC/D,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,wBAAwB,EAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,MAAM,EAAO,EAC9B,QAAQ,GAAE,QAAQ,GAAG,OAAkB,GACtC,yBAAyB,CAyG3B"}

package/esm/helpers/buildGraphTemporalCostStateSql.js

@@ -1,6 +1,6 @@
 import quoteIdentifier from "./quoteIdentifier.js";
 /** Builds keyed best-cost chronological states from an arbitrary start relation. */
-export default function buildGraphTemporalCostStateSql(prepared, startsSelect, direction, temporal, distanceType, edgeWeight, eventSelections = []) {
+export default function buildGraphTemporalCostStateSql(prepared, startsSelect, direction, temporal, distanceType, edgeWeight, eventSelections = [], minimize = "weight") {
     const q = quoteIdentifier;
     const relations = prepared.relationNames([
         "graph_starts",
@@ -29,12 +29,26 @@ export default function buildGraphTemporalCostStateSql(prepared, startsSelect, d
     const edgeCost = `${q("edges")}.${q("__weight")}`;
     const bestDistance = `${q("best")}.${q("distance")}`;
     const gap = `${q("settings")}.${q("__gap")}`;
-    const candidateDistance = `CAST(${reachedDistance} + ${edgeCost} AS ${distanceType})`;
+    const candidateSteps = `${q("reached")}.${q("steps")} + 1`;
+    // A steps-only bound must not sum reported weights: discarded routes can
+    // overflow even when every optimal route's reported total is representable.
+    const firstDistance = minimize === "steps" ? "CAST(1 AS BIGINT)" : edgeCost;
+    const candidateDistance = minimize === "steps"
+        ? candidateSteps
+        : `CAST(${reachedDistance} + ${edgeCost} AS ${distanceType})`;
+    const bestSteps = `${q("best")}.${q("steps")}`;
+    const order = (distance, steps) => minimize === "steps"
+        ? `ROW(${steps}, ${distance})`
+        : `ROW(${distance}, ${steps})`;
+    const candidateOrder = order(candidateDistance, candidateSteps);
+    const selectedDistance = `arg_min(${candidateDistance}, ${candidateOrder})`;
+    const selectedSteps = `arg_min(${candidateSteps}, ${candidateOrder})`;
     const resolvedStartsSelect = typeof startsSelect === "string"
         ? startsSelect
         : startsSelect(edgesRelation);
-    // Only costs for the same start and physical event can dominate each other.
-    // Strict improvements and non-negative weights terminate even zero-cost cycles.
+    // Only states for the same start and physical event can dominate each other.
+    // Weight optimization orders by cost then steps; step optimization counts
+    // only connections. Strict improvements terminate even zero-cost cycles.
     return {
         costRelation,
         edgesRelation,
@@ -58,17 +72,17 @@ export default function buildGraphTemporalCostStateSql(prepared, startsSelect, d
       ${q("start")}, ${q("node")},
       ${q("__start_key")}, ${q("__node_key")},
       ${q("__event_id")}, ${q("__event_start")}, ${q("__event_end")},
-      ${q("distance")}
+      ${q("distance")}, ${q("steps")}
     ) USING KEY(${q("__start_key")}, ${q("__event_id")}) AS (
       SELECT ${start}, ${edgeTo}, ${startKey}, ${edgeToKey},
-        ${eventId}, ${eventStart}, ${eventEnd}, ${edgeCost}
+        ${eventId}, ${eventStart}, ${eventEnd}, ${firstDistance}, CAST(1 AS BIGINT)
       FROM ${startsRelation} AS ${q("starts")}
       INNER JOIN ${edgesRelation} AS ${q("edges")}
         ON ${startKey} = ${edgeFromKey}
       UNION
       SELECT ${reachedStart}, ${edgeTo}, ${reachedStartKey}, ${edgeToKey},
         ${eventId}, ${eventStart}, ${eventEnd},
-        MIN(${candidateDistance}) AS ${q("distance")}
+        ${selectedDistance} AS ${q("distance")}, ${selectedSteps} AS ${q("steps")}
       FROM ${costRelation} AS ${q("reached")}
       INNER JOIN ${edgesRelation} AS ${q("edges")}
         ON ${reachedNodeKey} = ${edgeFromKey}
@@ -78,9 +92,9 @@ export default function buildGraphTemporalCostStateSql(prepared, startsSelect, d
         AND ${eventId} = ${q("best")}.${q("__event_id")}
       WHERE ${temporal.transition("reached", "edges", direction, gap)}
       GROUP BY ${reachedStart}, ${edgeTo}, ${reachedStartKey}, ${edgeToKey},
-        ${eventId}, ${eventStart}, ${eventEnd}, ${bestDistance}
+        ${eventId}, ${eventStart}, ${eventEnd}, ${bestDistance}, ${bestSteps}
       HAVING ${bestDistance} IS NULL OR
-        MIN(${candidateDistance}) < ${bestDistance}
+        ${order(selectedDistance, selectedSteps)} < ${order(bestDistance, bestSteps)}
     )`,
     };
 }

package/esm/helpers/graphRouteResultSchema.d.ts

@@ -1,4 +1,4 @@
 import type { TableSchema } from "./pendingOps.js";
 /** Derives the route result schema while preserving input columns and types. */
-export default function graphRouteResultSchema(schema: TableSchema, distanceType: string, method: string, elapsedTime?: boolean): TableSchema;
+export default function graphRouteResultSchema(schema: TableSchema, distanceType: string, method: string, elapsedTime?: boolean, includeTotal?: boolean): TableSchema;
 //# sourceMappingURL=graphRouteResultSchema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphRouteResultSchema.d.ts","sourceRoot":"","sources":["../../src/helpers/graphRouteResultSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,gFAAgF;AAChF,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,WAAW,UAAQ,GAClB,WAAW,CAcb"}
+{"version":3,"file":"graphRouteResultSchema.d.ts","sourceRoot":"","sources":["../../src/helpers/graphRouteResultSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,gFAAgF;AAChF,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,WAAW,UAAQ,EACnB,YAAY,UAAO,GAClB,WAAW,CAeb"}

package/esm/helpers/graphRouteResultSchema.js

@@ -1,12 +1,12 @@
 import validateGraphRouteResultSchema from "./validateGraphRouteResultSchema.js";
 /** Derives the route result schema while preserving input columns and types. */
-export default function graphRouteResultSchema(schema, distanceType, method, elapsedTime = false) {
-    validateGraphRouteResultSchema(schema, method, elapsedTime ? ["elapsedTimeMs"] : []);
+export default function graphRouteResultSchema(schema, distanceType, method, elapsedTime = false, includeTotal = true) {
+    validateGraphRouteResultSchema(schema, method, elapsedTime ? ["elapsedTimeMs"] : [], includeTotal);
     return {
         pathId: "BIGINT",
         step: "BIGINT",
         weight: distanceType,
-        total: distanceType,
+        ...(includeTotal ? { total: distanceType } : {}),
         ...(elapsedTime ? { elapsedTimeMs: "DOUBLE" } : {}),
         ...schema,
     };

package/esm/helpers/graphRouteResultSelect.d.ts

@@ -1,4 +1,4 @@
 import type { GraphEdgeIdColumn } from "./getGraphEdgeIdColumn.js";
 /** Joins ranked route steps to their original input rows for final output. */
-export default function graphRouteResultSelect(rankedRelation: string, input: string, edgeIdColumn: GraphEdgeIdColumn, includeStart?: boolean, elapsedTime?: boolean): string;
+export default function graphRouteResultSelect(rankedRelation: string, input: string, edgeIdColumn: GraphEdgeIdColumn, includeStart?: boolean, elapsedTime?: boolean, includeTotal?: boolean): string;
 //# sourceMappingURL=graphRouteResultSelect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphRouteResultSelect.d.ts","sourceRoot":"","sources":["../../src/helpers/graphRouteResultSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,8EAA8E;AAC9E,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,iBAAiB,EAC/B,YAAY,UAAQ,EACpB,WAAW,UAAQ,GAClB,MAAM,CA8BR"}
+{"version":3,"file":"graphRouteResultSelect.d.ts","sourceRoot":"","sources":["../../src/helpers/graphRouteResultSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,8EAA8E;AAC9E,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,iBAAiB,EAC/B,YAAY,UAAQ,EACpB,WAAW,UAAQ,EACnB,YAAY,UAAO,GAClB,MAAM,CA8BR"}

package/esm/helpers/graphRouteResultSelect.js

@@ -1,6 +1,6 @@
 import quoteIdentifier from "./quoteIdentifier.js";
 /** Joins ranked route steps to their original input rows for final output. */
-export default function graphRouteResultSelect(rankedRelation, input, edgeIdColumn, includeStart = false, elapsedTime = false) {
+export default function graphRouteResultSelect(rankedRelation, input, edgeIdColumn, includeStart = false, elapsedTime = false, includeTotal = true) {
     const q = quoteIdentifier;
     const routeStep = `${q("unnested")}.${q("route_step")}`;
     const originalEdgeId = `${q("original")}.${q(edgeIdColumn.column)}`;
@@ -12,7 +12,7 @@ export default function graphRouteResultSelect(rankedRelation, input, edgeIdColu
     return `SELECT ${includeStart ? `${q("ranked")}.${q("start")},\n      ` : ""}${q("ranked")}.${q("pathId")},
       CAST(${q("unnested")}.${q("step")} AS BIGINT) AS ${q("step")},
       ${routeStep}.${q("weight")} AS ${q("weight")},
-      ${routeStep}.${q("distance")} AS ${q("total")},
+      ${includeTotal ? `${routeStep}.${q("distance")} AS ${q("total")},` : ""}
       ${elapsedTime
         ? `${routeStep}.${q("elapsedTimeMs")} AS ${q("elapsedTimeMs")},`
         : ""}

package/esm/helpers/prepareGraphMetricOptions.d.ts

@@ -1,13 +1,13 @@
 export type GraphMetricOptions = {
     elapsedTime?: boolean;
-    minimize?: "weight" | "elapsedTime";
+    minimize?: "steps" | "weight" | "elapsedTime";
     weight?: string;
     startTimeColumn?: string;
     endTimeColumn?: string;
 };
 export type PreparedGraphMetricOptions = {
     elapsedTime: boolean;
-    minimize: "weight" | "elapsedTime" | "connections";
+    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;

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

@@ -1 +1 @@
-{"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,QAAQ,GAAG,aAAa,CAAC;IACpC,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,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;CACpD,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,0BAA0B,CAwD5B"}
+{"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/esm/helpers/prepareGraphMetricOptions.js

@@ -14,8 +14,9 @@ export default function prepareGraphMetricOptions(options, method, optimize) {
         if (!optimize) {
             throw new TypeError(`${method} options.minimize is not supported because this method returns all routes.`);
         }
-        if (options.minimize !== "weight" && options.minimize !== "elapsedTime") {
-            throw new TypeError(`${method} options.minimize must be "weight" or "elapsedTime".`);
+        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.`);
@@ -26,7 +27,7 @@ export default function prepareGraphMetricOptions(options, method, optimize) {
     }
     if (optimize && elapsedTime && options.weight !== undefined &&
         options.minimize === undefined) {
-        throw new TypeError(`${method} when weight and elapsedTime are both enabled, specify options.minimize: "weight" or "elapsedTime".`);
+        throw new TypeError(`${method} when weight and elapsedTime are both enabled, specify options.minimize: "steps", "weight", or "elapsedTime".`);
     }
     return {
         elapsedTime,
@@ -35,6 +36,6 @@ export default function prepareGraphMetricOptions(options, method, optimize) {
                 ? "weight"
                 : elapsedTime
                     ? "elapsedTime"
-                    : "connections"),
+                    : "steps"),
     };
 }

package/esm/helpers/prepareGraphRouteSql.d.ts

@@ -8,13 +8,13 @@ export type PreparedGraphRouteEndpoints = {
 /** 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): {
+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): {
+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;

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

@@ -1 +1 @@
-{"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;;;;EAmBf;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;;;;;;;;;;;;;EAkDf"}
+{"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/esm/helpers/prepareGraphRouteSql.js

@@ -34,13 +34,13 @@ export function prepareGraphRouteEndpoints(start, end, method) {
     };
 }
 /** Validates the columns shared by edge-route methods from queued schema data. */
-export function validateGraphRouteInputs(schema, source, target, edgeId, endpoints, weight, method) {
+export function validateGraphRouteInputs(schema, source, target, edgeId, endpoints, weight, method, includeTotal = true) {
     const nodes = validateGraphStarts(schema, source, target, endpoints.values, method);
     const edges = getGraphEdgeIdColumn(schema, edgeId, method);
     const weightColumn = weight === undefined
         ? undefined
         : getGraphWeightColumn(schema, weight, method);
-    validateGraphRouteResultSchema(schema, method);
+    validateGraphRouteResultSchema(schema, method, [], includeTotal);
     return {
         distanceType: weightColumn?.distanceType ?? "BIGINT",
         edgeIdType: edges.idType,
@@ -48,8 +48,8 @@ export function validateGraphRouteInputs(schema, source, target, edgeId, endpoin
     };
 }
 /** Prepares the typed SQL expressions shared by edge-route enumeration. */
-export function prepareGraphRouteSql(input, schema, source, target, edgeId, endpoints, weight, method) {
-    validateGraphRouteResultSchema(schema, method);
+export function prepareGraphRouteSql(input, schema, source, target, edgeId, endpoints, weight, method, includeTotal = true) {
+    validateGraphRouteResultSchema(schema, method, [], includeTotal);
     const traversal = prepareGraphTraversal(input, schema, source, target, endpoints.values, method);
     const edgeIdColumn = getGraphEdgeIdColumn(schema, edgeId, method);
     const weightColumn = weight === undefined

package/esm/helpers/validateGraphRouteResultSchema.d.ts

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

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

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

package/esm/helpers/validateGraphRouteResultSchema.js

@@ -2,8 +2,10 @@ import foldIdentifier from "./foldIdentifier.js";
 import quoteIdentifier from "./quoteIdentifier.js";
 const resultColumns = ["pathId", "step", "weight", "total"];
 /** Validates that route result columns do not replace original input columns. */
-export default function validateGraphRouteResultSchema(schema, method, additionalResultColumns = []) {
+export default function validateGraphRouteResultSchema(schema, method, additionalResultColumns = [], includeTotal = true) {
     for (const resultColumn of [...resultColumns, ...additionalResultColumns]) {
+        if (resultColumn === "total" && !includeTotal)
+            continue;
         const folded = foldIdentifier(resultColumn);
         const inputColumn = Object.keys(schema).find((column) => foldIdentifier(column) === folded);
         if (inputColumn !== undefined) {

package/esm/methods/distances.d.ts

@@ -7,7 +7,7 @@ type DistancesOptions = GraphTemporalOptions & {
     outputTable?: string | boolean;
     weight?: string;
     elapsedTime?: boolean;
-    minimize?: "weight" | "elapsedTime";
+    minimize?: "steps" | "weight" | "elapsedTime";
 };
 export default function distances(simpleTable: SimpleTable, sourceColumn: string, targetColumn: string, startNodes: GraphId | GraphId[], options?: DistancesOptions): SimpleTable;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"distances.d.ts","sourceRoot":"","sources":["../../src/methods/distances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAOvD,OAAgC,EAC9B,KAAK,oBAAoB,EAG1B,MAAM,uCAAuC,CAAC;AAC/C,OAA2B,EACzB,KAAK,OAAO,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAA8B,EAC5B,KAAK,cAAc,EAEpB,MAAM,qCAAqC,CAAC;AAK7C,KAAK,gBAAgB,GAAG,oBAAoB,GAAG;IAC7C,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACrC,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GAAG,OAAO,EAAE,EAC/B,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CA4Gb"}
+{"version":3,"file":"distances.d.ts","sourceRoot":"","sources":["../../src/methods/distances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAOvD,OAAgC,EAC9B,KAAK,oBAAoB,EAG1B,MAAM,uCAAuC,CAAC;AAC/C,OAA2B,EACzB,KAAK,OAAO,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAA8B,EAC5B,KAAK,cAAc,EAEpB,MAAM,qCAAqC,CAAC;AAK7C,KAAK,gBAAgB,GAAG,oBAAoB,GAAG;IAC7C,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;CAC/C,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GAAG,OAAO,EAAE,EAC/B,OAAO,GAAE,gBAAqB,GAC7B,WAAW,CA+Gb"}