@nicia-ai/typegraph 0.21.0 → 0.23.0

package/dist/index.cjs

@@ -1,9 +1,11 @@
 'use strict';
 
+var chunkHTGDWIDE_cjs = require('./chunk-HTGDWIDE.cjs');
 var chunkHRNQ3DVJ_cjs = require('./chunk-HRNQ3DVJ.cjs');
 var chunkWRWVWKQL_cjs = require('./chunk-WRWVWKQL.cjs');
+var chunkRNUNP5JD_cjs = require('./chunk-RNUNP5JD.cjs');
 var chunkO5PST6TB_cjs = require('./chunk-O5PST6TB.cjs');
-var chunkFQCQM3KG_cjs = require('./chunk-FQCQM3KG.cjs');
+var chunk3JK66E3I_cjs = require('./chunk-3JK66E3I.cjs');
 var chunkUVZHTBZ5_cjs = require('./chunk-UVZHTBZ5.cjs');
 var zod = require('zod');
 var drizzleOrm = require('drizzle-orm');
@@ -1930,9 +1932,9 @@ function validateTableName(name, label) {
   if (!name || name.length === 0) {
     throw new chunkO5PST6TB_cjs.ConfigurationError(`${label} table name cannot be empty`);
   }
-  if (name.length > chunkFQCQM3KG_cjs.MAX_PG_IDENTIFIER_LENGTH) {
+  if (name.length > chunk3JK66E3I_cjs.MAX_PG_IDENTIFIER_LENGTH) {
     throw new chunkO5PST6TB_cjs.ConfigurationError(
-      `${label} table name exceeds maximum length of ${chunkFQCQM3KG_cjs.MAX_PG_IDENTIFIER_LENGTH} characters`
+      `${label} table name exceeds maximum length of ${chunk3JK66E3I_cjs.MAX_PG_IDENTIFIER_LENGTH} characters`
     );
   }
   if (!VALID_IDENTIFIER_PATTERN.test(name)) {
@@ -1941,7 +1943,7 @@ function validateTableName(name, label) {
     );
   }
 }
-function quoteIdentifier(name) {
+function quoteIdentifier2(name) {
   return `"${name.replaceAll('"', '""')}"`;
 }
 function createSqlSchema(names = {}) {
@@ -1952,10 +1954,10 @@ function createSqlSchema(names = {}) {
   validateTableName(tables.fulltext, "fulltext");
   return {
     tables,
-    nodesTable: drizzleOrm.sql.raw(quoteIdentifier(tables.nodes)),
-    edgesTable: drizzleOrm.sql.raw(quoteIdentifier(tables.edges)),
-    embeddingsTable: drizzleOrm.sql.raw(quoteIdentifier(tables.embeddings)),
-    fulltextTable: drizzleOrm.sql.raw(quoteIdentifier(tables.fulltext))
+    nodesTable: drizzleOrm.sql.raw(quoteIdentifier2(tables.nodes)),
+    edgesTable: drizzleOrm.sql.raw(quoteIdentifier2(tables.edges)),
+    embeddingsTable: drizzleOrm.sql.raw(quoteIdentifier2(tables.embeddings)),
+    fulltextTable: drizzleOrm.sql.raw(quoteIdentifier2(tables.fulltext))
   };
 }
 var DEFAULT_SQL_SCHEMA = createSqlSchema();
@@ -1993,76 +1995,6 @@ function compileTypedJsonExtract(input) {
     }
   }
 }
-var NODE_COLUMNS = [
-  "id",
-  "kind",
-  "props",
-  "version",
-  "valid_from",
-  "valid_to",
-  "created_at",
-  "updated_at",
-  "deleted_at"
-];
-var EDGE_COLUMNS = [
-  "id",
-  "kind",
-  "from_id",
-  "to_id",
-  "props",
-  "valid_from",
-  "valid_to",
-  "created_at",
-  "updated_at",
-  "deleted_at"
-];
-var EMPTY_REQUIRED_COLUMNS = /* @__PURE__ */ new Set();
-function quoteIdentifier2(identifier) {
-  return drizzleOrm.sql.raw(`"${identifier.replaceAll('"', '""')}"`);
-}
-function shouldProjectColumn(requiredColumns, column, alwaysRequiredColumns) {
-  if (alwaysRequiredColumns?.has(column)) return true;
-  if (requiredColumns === void 0) return true;
-  return requiredColumns.has(column);
-}
-function addRequiredColumn(requiredColumnsByAlias, alias, column) {
-  const existing = requiredColumnsByAlias.get(alias);
-  if (existing) {
-    existing.add(column);
-    return;
-  }
-  requiredColumnsByAlias.set(alias, /* @__PURE__ */ new Set([column]));
-}
-function markFieldRefAsRequired(requiredColumnsByAlias, field2) {
-  const column = field2.path[0];
-  if (column === void 0) return;
-  addRequiredColumn(requiredColumnsByAlias, field2.alias, column);
-}
-function mapSelectiveSystemFieldToColumn(field2) {
-  if (field2 === "fromId") return "from_id";
-  if (field2 === "toId") return "to_id";
-  if (field2.startsWith("meta.")) {
-    return field2.slice(5).replaceAll(/([A-Z])/g, "_$1").toLowerCase();
-  }
-  return field2;
-}
-function markSelectiveFieldAsRequired(requiredColumnsByAlias, field2) {
-  if (field2.isSystemField) {
-    addRequiredColumn(
-      requiredColumnsByAlias,
-      field2.alias,
-      mapSelectiveSystemFieldToColumn(field2.field)
-    );
-    return;
-  }
-  addRequiredColumn(requiredColumnsByAlias, field2.alias, "props");
-}
-function isIdFieldRef(field2) {
-  return field2.path.length === 1 && field2.path[0] === "id" && field2.jsonPointer === void 0;
-}
-function isAggregateExpr(source) {
-  return "__type" in source && source.__type === "aggregate";
-}
 
 // src/query/compiler/emitter/standard-builders.ts
 function compileColumnReference(tableAlias, column) {
@@ -2072,7 +2004,7 @@ function compileColumnReference(tableAlias, column) {
   return drizzleOrm.sql`${drizzleOrm.sql.raw(tableAlias)}.${drizzleOrm.sql.raw(column)}`;
 }
 function qualifyColumn(owner, name) {
-  return drizzleOrm.sql`${quoteIdentifier2(owner)}.${quoteIdentifier2(name)}`;
+  return drizzleOrm.sql`${chunkHTGDWIDE_cjs.quoteIdentifier(owner)}.${chunkHTGDWIDE_cjs.quoteIdentifier(name)}`;
 }
 var SCOPED_RELEVANCE_NODES_ALIAS = "scoped_relevance_nodes";
 function buildScopedNodeIdsSubquery(nodeAlias) {
@@ -2082,20 +2014,20 @@ function buildScopedNodeIdsSubquery(nodeAlias) {
         SELECT DISTINCT
           ${qualifyColumn(cteAlias, `${nodeAlias}_id`)} AS node_id,
           ${qualifyColumn(cteAlias, `${nodeAlias}_kind`)} AS node_kind
-        FROM ${quoteIdentifier2(cteAlias)}
+        FROM ${chunkHTGDWIDE_cjs.quoteIdentifier(cteAlias)}
       ) AS ${drizzleOrm.sql.raw(SCOPED_RELEVANCE_NODES_ALIAS)}
   `;
 }
 function compileNodeSelectColumns(tableAlias, alias, requiredColumns) {
-  return NODE_COLUMNS.filter(
-    (column) => column === "id" || column === "kind" || shouldProjectColumn(requiredColumns, column)
+  return chunkHTGDWIDE_cjs.NODE_COLUMNS.filter(
+    (column) => column === "id" || column === "kind" || chunkHTGDWIDE_cjs.shouldProjectColumn(requiredColumns, column)
   ).map(
     (column) => drizzleOrm.sql`${compileColumnReference(tableAlias, column)} AS ${drizzleOrm.sql.raw(`${alias}_${column}`)}`
   );
 }
 function compileEdgeSelectColumns(tableAlias, alias, requiredColumns) {
-  return EDGE_COLUMNS.filter(
-    (column) => shouldProjectColumn(requiredColumns, column)
+  return chunkHTGDWIDE_cjs.EDGE_COLUMNS.filter(
+    (column) => chunkHTGDWIDE_cjs.shouldProjectColumn(requiredColumns, column)
   ).map(
     (column) => drizzleOrm.sql`${compileColumnReference(tableAlias, column)} AS ${drizzleOrm.sql.raw(`${alias}_${column}`)}`
   );
@@ -2104,6 +2036,7 @@ function buildStandardStartCte(input) {
   const { ast, ctx, graphId, predicateIndex, requiredColumnsByAlias } = input;
   const alias = ast.start.alias;
   const kinds = ast.start.kinds;
+  const cteMaterialization = ctx.dialect.capabilities.emitNotMaterializedHint ? drizzleOrm.sql`NOT MATERIALIZED ` : drizzleOrm.sql``;
   const kindFilter = compileKindFilter(drizzleOrm.sql.raw("kind"), kinds);
   const temporalFilter = input.temporalFilterPass.forAlias();
   const cteContext = { ...ctx, cteColumnPrefix: "" };
@@ -2117,15 +2050,20 @@ function buildStandardStartCte(input) {
     temporalFilter,
     ...predicateClauses
   ];
-  const effectiveRequiredColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(alias) ?? EMPTY_REQUIRED_COLUMNS : void 0;
+  const effectiveRequiredColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(alias) ?? chunkHTGDWIDE_cjs.EMPTY_REQUIRED_COLUMNS : void 0;
+  const limitClause = input.limitOffset === void 0 ? drizzleOrm.sql`` : input.limitOffset.offset === void 0 ? drizzleOrm.sql`
+        LIMIT ${input.limitOffset.limit}
+      ` : drizzleOrm.sql`
+      LIMIT ${input.limitOffset.limit} OFFSET ${input.limitOffset.offset}
+    `;
   return drizzleOrm.sql`
-    cte_${drizzleOrm.sql.raw(alias)} AS (
+    cte_${drizzleOrm.sql.raw(alias)} AS ${cteMaterialization}(
       SELECT ${drizzleOrm.sql.join(
     compileNodeSelectColumns(void 0, alias, effectiveRequiredColumns),
     drizzleOrm.sql`, `
   )}
       FROM ${ctx.schema.nodesTable}
-      WHERE ${drizzleOrm.sql.join(whereClauses, drizzleOrm.sql` AND `)}
+      WHERE ${drizzleOrm.sql.join(whereClauses, drizzleOrm.sql` AND `)}${limitClause}
     )
   `;
 }
@@ -2178,8 +2116,8 @@ function buildStandardTraversalCte(input) {
   const previousAlias = traversal.joinFromAlias;
   const edgeAlias = traversal.edgeAlias;
   const nodeAlias = traversal.nodeAlias;
-  const requiredNodeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(nodeAlias) ?? EMPTY_REQUIRED_COLUMNS : void 0;
-  const requiredEdgeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(edgeAlias) ?? EMPTY_REQUIRED_COLUMNS : void 0;
+  const requiredNodeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(nodeAlias) ?? chunkHTGDWIDE_cjs.EMPTY_REQUIRED_COLUMNS : void 0;
+  const requiredEdgeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(edgeAlias) ?? chunkHTGDWIDE_cjs.EMPTY_REQUIRED_COLUMNS : void 0;
   const previousRowColumns = carryForwardPreviousColumns ? [drizzleOrm.sql`cte_${drizzleOrm.sql.raw(previousAlias)}.*`] : [
     drizzleOrm.sql`cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAlias)}_id AS ${drizzleOrm.sql.raw(previousAlias)}_id`,
     drizzleOrm.sql`cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAlias)}_kind AS ${drizzleOrm.sql.raw(previousAlias)}_kind`
@@ -2189,7 +2127,7 @@ function buildStandardTraversalCte(input) {
     ...compileEdgeSelectColumns("e", edgeAlias, requiredEdgeColumns),
     ...compileNodeSelectColumns("n", nodeAlias, requiredNodeColumns)
   ];
-  const cteMaterialization = materializeCte ? drizzleOrm.sql`MATERIALIZED ` : drizzleOrm.sql``;
+  const cteMaterialization = materializeCte ? drizzleOrm.sql`MATERIALIZED ` : ctx.dialect.capabilities.emitNotMaterializedHint ? drizzleOrm.sql`NOT MATERIALIZED ` : drizzleOrm.sql``;
   function compileTraversalBranch(branch) {
     const whereClauses = [
       ...baseWhereClauses,
@@ -2311,7 +2249,7 @@ function compileAggregateExprFromSource(expr, dialect) {
   }
 }
 function compileProjectedSource(field2, dialect) {
-  if (isAggregateExpr(field2.source)) {
+  if (chunkHTGDWIDE_cjs.isAggregateExpr(field2.source)) {
     return compileAggregateExprFromSource(field2.source, dialect);
   }
   const cteAlias = field2.cteAlias ?? `cte_${field2.source.alias}`;
@@ -2338,7 +2276,7 @@ function buildStandardProjection(input) {
   }
   const projectedFields = fields.map((field2) => {
     const source = compileProjectedSource(field2, dialect);
-    return drizzleOrm.sql`${source} AS ${quoteIdentifier2(field2.outputName)}`;
+    return drizzleOrm.sql`${source} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(field2.outputName)}`;
   });
   return drizzleOrm.sql.join(projectedFields, drizzleOrm.sql`, `);
 }
@@ -2357,8 +2295,8 @@ function compileSelectiveProjection(fields, dialect, ast, collapsedTraversalCteA
   const columns = fields.map((field2) => {
     const cteAlias = collapsedTraversalCteAlias ?? aliasToCte.get(field2.alias) ?? `cte_${field2.alias}`;
     if (field2.isSystemField) {
-      const dbColumn = mapSelectiveSystemFieldToColumn(field2.field);
-      return drizzleOrm.sql`${drizzleOrm.sql.raw(cteAlias)}.${drizzleOrm.sql.raw(`${field2.alias}_${dbColumn}`)} AS ${quoteIdentifier2(field2.outputName)}`;
+      const dbColumn = chunkHTGDWIDE_cjs.mapSelectiveSystemFieldToColumn(field2.field);
+      return drizzleOrm.sql`${drizzleOrm.sql.raw(cteAlias)}.${drizzleOrm.sql.raw(`${field2.alias}_${dbColumn}`)} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(field2.outputName)}`;
     }
     const propsColumn = `${field2.alias}_props`;
     const column = drizzleOrm.sql`${drizzleOrm.sql.raw(cteAlias)}.${drizzleOrm.sql.raw(propsColumn)}`;
@@ -2369,7 +2307,7 @@ function compileSelectiveProjection(fields, dialect, ast, collapsedTraversalCteA
       pointer,
       valueType: field2.valueType
     });
-    return drizzleOrm.sql`${extracted} AS ${quoteIdentifier2(field2.outputName)}`;
+    return drizzleOrm.sql`${extracted} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(field2.outputName)}`;
   });
   return drizzleOrm.sql.join(columns, drizzleOrm.sql`, `);
 }
@@ -3170,7 +3108,7 @@ function lowerComposableQueryToLogicalPlanNode(query, dialect, graphId, nextPlan
       nextPlanNodeId
     });
   }
-  const dialectAdapter = chunkFQCQM3KG_cjs.getDialect(dialect);
+  const dialectAdapter = chunk3JK66E3I_cjs.getDialect(dialect);
   const vectorPredicate = runVectorPredicatePass(
     query,
     dialectAdapter
@@ -3439,8 +3377,8 @@ function compileRecursiveCte(ast, traversal, graphId, ctx, requiredColumnsByAlia
   if (previousNodeKinds.length > 1) {
     recursiveJoinRequiredColumns.add("kind");
   }
-  const requiredStartColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(startAlias) ?? EMPTY_REQUIRED_COLUMNS : void 0;
-  const requiredNodeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(nodeAlias) ?? EMPTY_REQUIRED_COLUMNS : void 0;
+  const requiredStartColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(startAlias) ?? chunkHTGDWIDE_cjs.EMPTY_REQUIRED_COLUMNS : void 0;
+  const requiredNodeColumns = requiredColumnsByAlias ? requiredColumnsByAlias.get(nodeAlias) ?? chunkHTGDWIDE_cjs.EMPTY_REQUIRED_COLUMNS : void 0;
   const startColumnsFromBase = compileNodeSelectColumnsFromTable(
     "n0",
     startAlias,
@@ -3636,30 +3574,30 @@ function collectRequiredColumnsByAlias(ast, traversal) {
   const previousNodeKinds = [
     .../* @__PURE__ */ new Set([...ast.start.kinds, ...traversal.nodeKinds])
   ];
-  addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "id");
+  chunkHTGDWIDE_cjs.addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "id");
   if (previousNodeKinds.length > 1) {
-    addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "kind");
+    chunkHTGDWIDE_cjs.addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "kind");
   }
   for (const field2 of selectiveFields) {
-    markSelectiveFieldAsRequired(requiredColumnsByAlias, field2);
+    chunkHTGDWIDE_cjs.markSelectiveFieldAsRequired(requiredColumnsByAlias, field2);
   }
   if (ast.orderBy) {
     for (const orderSpec of ast.orderBy) {
-      markFieldRefAsRequired(requiredColumnsByAlias, orderSpec.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, orderSpec.field);
     }
   }
   return requiredColumnsByAlias;
 }
 function compileNodeSelectColumnsFromTable(tableAlias, alias, requiredColumns, alwaysRequiredColumns) {
-  return NODE_COLUMNS.filter(
-    (column) => shouldProjectColumn(requiredColumns, column, alwaysRequiredColumns)
+  return chunkHTGDWIDE_cjs.NODE_COLUMNS.filter(
+    (column) => chunkHTGDWIDE_cjs.shouldProjectColumn(requiredColumns, column, alwaysRequiredColumns)
   ).map(
     (column) => drizzleOrm.sql`${drizzleOrm.sql.raw(tableAlias)}.${drizzleOrm.sql.raw(column)} AS ${drizzleOrm.sql.raw(`${alias}_${column}`)}`
   );
 }
 function compileNodeSelectColumnsFromRecursiveRow(alias, requiredColumns, alwaysRequiredColumns) {
-  return NODE_COLUMNS.filter(
-    (column) => shouldProjectColumn(requiredColumns, column, alwaysRequiredColumns)
+  return chunkHTGDWIDE_cjs.NODE_COLUMNS.filter(
+    (column) => chunkHTGDWIDE_cjs.shouldProjectColumn(requiredColumns, column, alwaysRequiredColumns)
   ).map((column) => {
     const projected = `${alias}_${column}`;
     return drizzleOrm.sql`r.${drizzleOrm.sql.raw(projected)} AS ${drizzleOrm.sql.raw(projected)}`;
@@ -3700,10 +3638,10 @@ function compileRecursiveProjection(ast, traversal, dialect) {
     drizzleOrm.sql`${drizzleOrm.sql.raw(nodeAlias)}_deleted_at`
   ];
   if (vl.depthAlias !== void 0) {
-    fields.push(drizzleOrm.sql`depth AS ${quoteIdentifier2(vl.depthAlias)}`);
+    fields.push(drizzleOrm.sql`depth AS ${chunkHTGDWIDE_cjs.quoteIdentifier(vl.depthAlias)}`);
   }
   if (vl.pathAlias !== void 0) {
-    fields.push(drizzleOrm.sql`path AS ${quoteIdentifier2(vl.pathAlias)}`);
+    fields.push(drizzleOrm.sql`path AS ${chunkHTGDWIDE_cjs.quoteIdentifier(vl.pathAlias)}`);
   }
   return drizzleOrm.sql.join(fields, drizzleOrm.sql`, `);
 }
@@ -3716,8 +3654,8 @@ function compileRecursiveSelectiveProjection(fields, ast, traversal, dialect) {
       );
     }
     if (field2.isSystemField) {
-      const dbColumn = mapSelectiveSystemFieldToColumn(field2.field);
-      return drizzleOrm.sql`${drizzleOrm.sql.raw(`${field2.alias}_${dbColumn}`)} AS ${quoteIdentifier2(field2.outputName)}`;
+      const dbColumn = chunkHTGDWIDE_cjs.mapSelectiveSystemFieldToColumn(field2.field);
+      return drizzleOrm.sql`${drizzleOrm.sql.raw(`${field2.alias}_${dbColumn}`)} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(field2.outputName)}`;
     }
     const column = drizzleOrm.sql.raw(`${field2.alias}_props`);
     const extracted = compileTypedJsonExtract({
@@ -3726,14 +3664,14 @@ function compileRecursiveSelectiveProjection(fields, ast, traversal, dialect) {
       pointer: chunkUVZHTBZ5_cjs.jsonPointer([field2.field]),
       valueType: field2.valueType
     });
-    return drizzleOrm.sql`${extracted} AS ${quoteIdentifier2(field2.outputName)}`;
+    return drizzleOrm.sql`${extracted} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(field2.outputName)}`;
   });
   const vl = traversal.variableLength;
   if (vl.depthAlias !== void 0) {
-    columns.push(drizzleOrm.sql`depth AS ${quoteIdentifier2(vl.depthAlias)}`);
+    columns.push(drizzleOrm.sql`depth AS ${chunkHTGDWIDE_cjs.quoteIdentifier(vl.depthAlias)}`);
   }
   if (vl.pathAlias !== void 0) {
-    columns.push(drizzleOrm.sql`path AS ${quoteIdentifier2(vl.pathAlias)}`);
+    columns.push(drizzleOrm.sql`path AS ${chunkHTGDWIDE_cjs.quoteIdentifier(vl.pathAlias)}`);
   }
   return drizzleOrm.sql.join(columns, drizzleOrm.sql`, `);
 }
@@ -4000,9 +3938,9 @@ function truncateToBytes(value, maxBytes) {
 }
 function projectionAlias(entityPrefix, kind, field2) {
   const prefix = entityPrefix === "node" ? "sg_n" : "sg_e";
-  const hash = chunkFQCQM3KG_cjs.fnv1aBase36(`${kind}\0${field2}`);
+  const hash = chunk3JK66E3I_cjs.fnv1aBase36(`${kind}\0${field2}`);
   const fixedBytes = prefix.length + 1 + 1 + hash.length;
-  const maxKindBytes = chunkFQCQM3KG_cjs.MAX_PG_IDENTIFIER_LENGTH - fixedBytes;
+  const maxKindBytes = chunk3JK66E3I_cjs.MAX_PG_IDENTIFIER_LENGTH - fixedBytes;
   const truncatedKind = truncateToBytes(kind, maxKindBytes);
   return `${prefix}_${truncatedKind}_${hash}`;
 }
@@ -4248,7 +4186,7 @@ function buildProjectedPropertyColumns(alias, plan, dialect) {
         valueType: fieldPlan.typeInfo?.valueType
       });
       columns.push(
-        drizzleOrm.sql`CASE WHEN ${drizzleOrm.sql.raw(alias)}.kind = ${kind} THEN ${extracted} ELSE NULL END AS ${quoteIdentifier2(fieldPlan.outputName)}`
+        drizzleOrm.sql`CASE WHEN ${drizzleOrm.sql.raw(alias)}.kind = ${kind} THEN ${extracted} ELSE NULL END AS ${chunkHTGDWIDE_cjs.quoteIdentifier(fieldPlan.outputName)}`
       );
     }
   }
@@ -4833,7 +4771,7 @@ function isColumnPruningEnabled(ast) {
 function markPredicateFieldsAsRequired(requiredColumnsByAlias, expression) {
   switch (expression.__type) {
     case "comparison": {
-      markFieldRefAsRequired(requiredColumnsByAlias, expression.left);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, expression.left);
       return;
     }
     case "string_op":
@@ -4841,7 +4779,7 @@ function markPredicateFieldsAsRequired(requiredColumnsByAlias, expression) {
     case "between":
     case "array_op":
     case "object_op": {
-      markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
       return;
     }
     case "and":
@@ -4859,22 +4797,22 @@ function markPredicateFieldsAsRequired(requiredColumnsByAlias, expression) {
       return;
     }
     case "aggregate_comparison": {
-      markFieldRefAsRequired(
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(
         requiredColumnsByAlias,
         expression.aggregate.field
       );
       return;
     }
     case "in_subquery": {
-      markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
       return;
     }
     case "vector_similarity": {
-      markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
       return;
     }
     case "fulltext_match": {
-      markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, expression.field);
       return;
     }
     case "exists": {
@@ -4884,33 +4822,33 @@ function markPredicateFieldsAsRequired(requiredColumnsByAlias, expression) {
 }
 function collectRequiredColumnsByAlias2(ast) {
   const requiredColumnsByAlias = /* @__PURE__ */ new Map();
-  addRequiredColumn(requiredColumnsByAlias, ast.start.alias, "id");
+  chunkHTGDWIDE_cjs.addRequiredColumn(requiredColumnsByAlias, ast.start.alias, "id");
   for (const traversal of ast.traversals) {
-    addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "id");
+    chunkHTGDWIDE_cjs.addRequiredColumn(requiredColumnsByAlias, traversal.nodeAlias, "id");
   }
   if (ast.selectiveFields && ast.selectiveFields.length > 0) {
     for (const field2 of ast.selectiveFields) {
-      markSelectiveFieldAsRequired(requiredColumnsByAlias, field2);
+      chunkHTGDWIDE_cjs.markSelectiveFieldAsRequired(requiredColumnsByAlias, field2);
     }
   } else {
     for (const projectedField of ast.projection.fields) {
       const source = projectedField.source;
       if (source.__type === "field_ref") {
-        markFieldRefAsRequired(requiredColumnsByAlias, source);
+        chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, source);
       } else {
-        addRequiredColumn(requiredColumnsByAlias, source.field.alias, "id");
-        markFieldRefAsRequired(requiredColumnsByAlias, source.field);
+        chunkHTGDWIDE_cjs.addRequiredColumn(requiredColumnsByAlias, source.field.alias, "id");
+        chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, source.field);
       }
     }
   }
   if (ast.groupBy) {
     for (const field2 of ast.groupBy.fields) {
-      markFieldRefAsRequired(requiredColumnsByAlias, field2);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, field2);
     }
   }
   if (ast.orderBy) {
     for (const orderSpec of ast.orderBy) {
-      markFieldRefAsRequired(requiredColumnsByAlias, orderSpec.field);
+      chunkHTGDWIDE_cjs.markFieldRefAsRequired(requiredColumnsByAlias, orderSpec.field);
     }
   }
   if (ast.having) {
@@ -4924,7 +4862,7 @@ function collectRequiredColumnsByAlias2(ast) {
 function hasIdEqualityPredicate(expression, alias) {
   switch (expression.__type) {
     case "comparison": {
-      return expression.op === "eq" && expression.left.alias === alias && isIdFieldRef(expression.left);
+      return expression.op === "eq" && expression.left.alias === alias && chunkHTGDWIDE_cjs.isIdFieldRef(expression.left);
     }
     case "and": {
       return expression.predicates.some(
@@ -5245,7 +5183,7 @@ function compileSetOperation2(op, graphId, options = "sqlite") {
   );
 }
 function resolveDialectAdapter(dialect, fulltextStrategy) {
-  const baseAdapter = chunkFQCQM3KG_cjs.getDialect(dialect);
+  const baseAdapter = chunk3JK66E3I_cjs.getDialect(dialect);
   if (fulltextStrategy === void 0 || fulltextStrategy === baseAdapter.fulltext) {
     return baseAdapter;
   }
@@ -5276,39 +5214,50 @@ function resolveCountAggregateFastPath(ast) {
     return void 0;
   }
   const groupField = ast.groupBy.fields[0];
-  if (groupField.alias !== ast.start.alias || !isIdFieldRef(groupField)) {
+  if (groupField.alias !== ast.start.alias || !chunkHTGDWIDE_cjs.isIdFieldRef(groupField)) {
     return void 0;
   }
-  let requiresCount = false;
-  let requiresCountDistinct = false;
+  let requiresNodeCount = false;
+  let requiresNodeCountDistinct = false;
+  let requiresEdgeCount = false;
+  let requiresEdgeCountDistinct = false;
   for (const projectedField of ast.projection.fields) {
     const source = projectedField.source;
-    if (!isAggregateExpr(source)) {
+    if (!chunkHTGDWIDE_cjs.isAggregateExpr(source)) {
       if (source.alias !== ast.start.alias) {
         return void 0;
       }
       continue;
     }
-    if (source.field.alias !== traversal.nodeAlias || !isIdFieldRef(source.field)) {
+    if (!chunkHTGDWIDE_cjs.isIdFieldRef(source.field)) {
+      return void 0;
+    }
+    const isNodeTarget = source.field.alias === traversal.nodeAlias;
+    const isEdgeTarget = source.field.alias === traversal.edgeAlias;
+    if (!isNodeTarget && !isEdgeTarget) {
       return void 0;
     }
     if (source.function === "count") {
-      requiresCount = true;
+      if (isNodeTarget) requiresNodeCount = true;
+      else requiresEdgeCount = true;
       continue;
     }
     if (source.function === "countDistinct") {
-      requiresCountDistinct = true;
+      if (isNodeTarget) requiresNodeCountDistinct = true;
+      else requiresEdgeCountDistinct = true;
       continue;
     }
     return void 0;
   }
-  if (!requiresCount && !requiresCountDistinct) {
+  if (!requiresNodeCount && !requiresNodeCountDistinct && !requiresEdgeCount && !requiresEdgeCountDistinct) {
     return void 0;
   }
   return {
     traversal,
-    requiresCount,
-    requiresCountDistinct
+    requiresNodeCount,
+    requiresNodeCountDistinct,
+    requiresEdgeCount,
+    requiresEdgeCountDistinct
   };
 }
 function compileCountAggregateFastPath(ast, graphId, ctx, logicalPlan, requiredColumnsByAlias, predicateIndex, temporalFilterPass) {
@@ -5316,15 +5265,23 @@ function compileCountAggregateFastPath(ast, graphId, ctx, logicalPlan, requiredC
   if (!plan) {
     return void 0;
   }
-  const { traversal, requiresCount, requiresCountDistinct } = plan;
+  const {
+    traversal,
+    requiresNodeCount,
+    requiresNodeCountDistinct,
+    requiresEdgeCount,
+    requiresEdgeCountDistinct
+  } = plan;
   const { dialect } = ctx;
   const startAlias = ast.start.alias;
   const previousAlias = traversal.joinFromAlias;
   const previousAliasIdColumn = `${previousAlias}_id`;
   const previousAliasKindColumn = `${previousAlias}_kind`;
   const countCteAlias = `cte_${traversal.nodeAlias}_counts`;
-  const countColumn = `${traversal.nodeAlias}_count`;
-  const countDistinctColumn = `${traversal.nodeAlias}_count_distinct`;
+  const nodeCountColumn = `${traversal.nodeAlias}_count`;
+  const nodeCountDistinctColumn = `${traversal.nodeAlias}_count_distinct`;
+  const edgeCountColumn = `${traversal.edgeAlias}_count`;
+  const edgeCountDistinctColumn = `${traversal.edgeAlias}_count_distinct`;
   const previousNodeKinds = getNodeKindsForAlias(ast, traversal.joinFromAlias);
   const edgeKinds = [...new Set(traversal.edgeKinds)];
   const nodeKinds = traversal.nodeKinds;
@@ -5350,34 +5307,68 @@ function compileCountAggregateFastPath(ast, graphId, ctx, logicalPlan, requiredC
   const targetField = traversal.direction === "out" ? "to_id" : "from_id";
   const joinKindField = traversal.direction === "out" ? "from_kind" : "to_kind";
   const targetKindField = traversal.direction === "out" ? "to_kind" : "from_kind";
+  const hasNodePredicates = nodePredicateClauses.length > 0;
+  const requiresNodeJoin = requiresNodeCount || requiresNodeCountDistinct || hasNodePredicates;
+  const useInnerJoin = hasNodePredicates;
   const whereClauses = [
     drizzleOrm.sql`e.graph_id = ${graphId}`,
     compileKindFilter(drizzleOrm.sql.raw("e.kind"), edgeKinds),
     compileKindFilter(drizzleOrm.sql.raw(`e.${joinKindField}`), previousNodeKinds),
     compileKindFilter(drizzleOrm.sql.raw(`e.${targetKindField}`), nodeKinds),
-    compileKindFilter(drizzleOrm.sql.raw("n.kind"), nodeKinds),
     edgeTemporalFilter,
-    nodeTemporalFilter,
-    ...nodePredicateClauses,
-    ...edgePredicateClauses
+    ...edgePredicateClauses,
+    // INNER JOIN mode: node-side filters in WHERE constrain every aggregate.
+    ...requiresNodeJoin && useInnerJoin ? [
+      compileKindFilter(drizzleOrm.sql.raw("n.kind"), nodeKinds),
+      nodeTemporalFilter,
+      ...nodePredicateClauses
+    ] : []
   ];
+  const nodeJoinOnClauses = requiresNodeJoin ? useInnerJoin ? (
+    // INNER JOIN: only the key conditions; filters live in WHERE.
+    [
+      drizzleOrm.sql`n.graph_id = e.graph_id`,
+      drizzleOrm.sql`n.id = e.${drizzleOrm.sql.raw(targetField)}`,
+      drizzleOrm.sql`n.kind = e.${drizzleOrm.sql.raw(targetKindField)}`
+    ]
+  ) : [
+    drizzleOrm.sql`n.graph_id = e.graph_id`,
+    drizzleOrm.sql`n.id = e.${drizzleOrm.sql.raw(targetField)}`,
+    drizzleOrm.sql`n.kind = e.${drizzleOrm.sql.raw(targetKindField)}`,
+    compileKindFilter(drizzleOrm.sql.raw("n.kind"), nodeKinds),
+    nodeTemporalFilter
+  ] : [];
   const aggregateColumns = [];
-  if (requiresCount) {
-    aggregateColumns.push(drizzleOrm.sql`COUNT(n.id) AS ${drizzleOrm.sql.raw(countColumn)}`);
+  if (requiresNodeCount) {
+    aggregateColumns.push(drizzleOrm.sql`COUNT(n.id) AS ${drizzleOrm.sql.raw(nodeCountColumn)}`);
+  }
+  if (requiresNodeCountDistinct) {
+    aggregateColumns.push(
+      drizzleOrm.sql`COUNT(DISTINCT n.id) AS ${drizzleOrm.sql.raw(nodeCountDistinctColumn)}`
+    );
   }
-  if (requiresCountDistinct) {
+  if (requiresEdgeCount) {
+    aggregateColumns.push(drizzleOrm.sql`COUNT(e.id) AS ${drizzleOrm.sql.raw(edgeCountColumn)}`);
+  }
+  if (requiresEdgeCountDistinct) {
     aggregateColumns.push(
-      drizzleOrm.sql`COUNT(DISTINCT n.id) AS ${drizzleOrm.sql.raw(countDistinctColumn)}`
+      drizzleOrm.sql`COUNT(DISTINCT e.id) AS ${drizzleOrm.sql.raw(edgeCountDistinctColumn)}`
     );
   }
+  const startCteLimit = traversal.optional && ast.orderBy === void 0 && ast.limit !== void 0 ? { limit: ast.limit, offset: ast.offset } : void 0;
   const startCte = buildStandardStartCte({
     ast,
     ctx,
     graphId,
     predicateIndex,
     requiredColumnsByAlias,
-    temporalFilterPass
+    temporalFilterPass,
+    ...startCteLimit === void 0 ? {} : { limitOffset: startCteLimit }
   });
+  const targetNodeJoinKeyword = useInnerJoin ? "JOIN" : "LEFT JOIN";
+  const targetNodeJoin = requiresNodeJoin ? drizzleOrm.sql`
+        ${drizzleOrm.sql.raw(targetNodeJoinKeyword)} ${ctx.schema.nodesTable} n ON ${drizzleOrm.sql.join(nodeJoinOnClauses, drizzleOrm.sql` AND `)}
+      ` : drizzleOrm.sql``;
   const countCte = drizzleOrm.sql`
     ${drizzleOrm.sql.raw(countCteAlias)} AS (
       SELECT
@@ -5386,32 +5377,36 @@ function compileCountAggregateFastPath(ast, graphId, ctx, logicalPlan, requiredC
         ${drizzleOrm.sql.join(aggregateColumns, drizzleOrm.sql`, `)}
       FROM cte_${drizzleOrm.sql.raw(previousAlias)}
       JOIN ${ctx.schema.edgesTable} e ON cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasIdColumn)} = e.${drizzleOrm.sql.raw(joinField)}
-        AND cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasKindColumn)} = e.${drizzleOrm.sql.raw(joinKindField)}
-      JOIN ${ctx.schema.nodesTable} n ON n.graph_id = e.graph_id
-        AND n.id = e.${drizzleOrm.sql.raw(targetField)}
-        AND n.kind = e.${drizzleOrm.sql.raw(targetKindField)}
+        AND cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasKindColumn)} = e.${drizzleOrm.sql.raw(joinKindField)}${targetNodeJoin}
       WHERE ${drizzleOrm.sql.join(whereClauses, drizzleOrm.sql` AND `)}
       GROUP BY
         cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasIdColumn)},
         cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasKindColumn)}
     )
   `;
+  function resolveCountColumn(source) {
+    const isEdge = source.field.alias === traversal.edgeAlias;
+    if (source.function === "countDistinct") {
+      return isEdge ? edgeCountDistinctColumn : nodeCountDistinctColumn;
+    }
+    return isEdge ? edgeCountColumn : nodeCountColumn;
+  }
   const projection = drizzleOrm.sql.join(
     ast.projection.fields.map((projectedField) => {
       const source = projectedField.source;
-      if (!isAggregateExpr(source)) {
+      if (!chunkHTGDWIDE_cjs.isAggregateExpr(source)) {
         const value = compileFieldValue(
           source,
           dialect,
           source.valueType,
           `cte_${source.alias}`
         );
-        return drizzleOrm.sql`${value} AS ${quoteIdentifier2(projectedField.outputName)}`;
+        return drizzleOrm.sql`${value} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(projectedField.outputName)}`;
       }
-      const projectedCountColumn = source.function === "countDistinct" ? countDistinctColumn : countColumn;
+      const projectedCountColumn = resolveCountColumn(source);
       const countValue = drizzleOrm.sql`${drizzleOrm.sql.raw(countCteAlias)}.${drizzleOrm.sql.raw(projectedCountColumn)}`;
       const aggregateValue = traversal.optional ? drizzleOrm.sql`COALESCE(${countValue}, 0)` : countValue;
-      return drizzleOrm.sql`${aggregateValue} AS ${quoteIdentifier2(projectedField.outputName)}`;
+      return drizzleOrm.sql`${aggregateValue} AS ${chunkHTGDWIDE_cjs.quoteIdentifier(projectedField.outputName)}`;
     }),
     drizzleOrm.sql`, `
   );
@@ -5423,19 +5418,29 @@ function compileCountAggregateFastPath(ast, graphId, ctx, logicalPlan, requiredC
       AND ${drizzleOrm.sql.raw(countCteAlias)}.${drizzleOrm.sql.raw(previousAliasKindColumn)} = cte_${drizzleOrm.sql.raw(previousAlias)}.${drizzleOrm.sql.raw(previousAliasKindColumn)}
   `;
   const orderBy = buildStandardOrderBy({ ast, dialect });
-  const limitOffset = buildLimitOffsetClause({
-    limit: ast.limit,
-    offset: ast.offset
-  });
+  const emittedLogicalPlan = startCteLimit === void 0 ? logicalPlan : stripLimitOffsetFromPlan(logicalPlan);
+  const limitOffset = startCteLimit === void 0 ? buildLimitOffsetClause({ limit: ast.limit, offset: ast.offset }) : void 0;
   return emitStandardQuerySql({
     ctes: [startCte, countCte],
     fromClause,
     ...orderBy === void 0 ? {} : { orderBy },
     ...limitOffset === void 0 ? {} : { limitOffset },
-    logicalPlan,
+    logicalPlan: emittedLogicalPlan,
     projection
   });
 }
+function stripLimitOffsetFromPlan(plan) {
+  return { ...plan, root: stripLimitOffsetFromPlanNode(plan.root) };
+}
+function stripLimitOffsetFromPlanNode(node) {
+  if (node.op === "limit_offset") {
+    return stripLimitOffsetFromPlanNode(node.input);
+  }
+  if ("input" in node) {
+    return { ...node, input: stripLimitOffsetFromPlanNode(node.input) };
+  }
+  return node;
+}
 var STANDARD_QUERY_STRATEGY_HANDLERS = {
   cte_project: compileStandardQueryWithCteStrategy
 };
@@ -5776,14 +5781,14 @@ function generateId() {
 
 // src/utils/path.ts
 function parseSqlitePath(path) {
-  const emptyPath = `${chunkFQCQM3KG_cjs.SQLITE_PATH_DELIMITER}${chunkFQCQM3KG_cjs.SQLITE_PATH_DELIMITER}`;
+  const emptyPath = `${chunk3JK66E3I_cjs.SQLITE_PATH_DELIMITER}${chunk3JK66E3I_cjs.SQLITE_PATH_DELIMITER}`;
   if (!path || path === emptyPath) return [];
   const trimmed = path.slice(1, -1);
   if (trimmed === "") return [];
-  return trimmed.split(chunkFQCQM3KG_cjs.SQLITE_PATH_DELIMITER);
+  return trimmed.split(chunk3JK66E3I_cjs.SQLITE_PATH_DELIMITER);
 }
 function isSqlitePath(value) {
-  return typeof value === "string" && value.startsWith(chunkFQCQM3KG_cjs.SQLITE_PATH_DELIMITER) && value.endsWith(chunkFQCQM3KG_cjs.SQLITE_PATH_DELIMITER);
+  return typeof value === "string" && value.startsWith(chunk3JK66E3I_cjs.SQLITE_PATH_DELIMITER) && value.endsWith(chunk3JK66E3I_cjs.SQLITE_PATH_DELIMITER);
 }
 function normalizePath(value) {
   if (Array.isArray(value)) {
@@ -5798,12 +5803,12 @@ function normalizePath(value) {
   return [];
 }
 function isPostgresTextArray(value) {
-  return typeof value === "string" && value.startsWith(chunkFQCQM3KG_cjs.PG_ARRAY_START) && value.endsWith(chunkFQCQM3KG_cjs.PG_ARRAY_END);
+  return typeof value === "string" && value.startsWith(chunk3JK66E3I_cjs.PG_ARRAY_START) && value.endsWith(chunk3JK66E3I_cjs.PG_ARRAY_END);
 }
 function parsePostgresTextArray(value) {
   const inner = value.slice(1, -1);
   if (inner === "") return [];
-  return inner.split(chunkFQCQM3KG_cjs.PG_PATH_ELEMENT_SEPARATOR);
+  return inner.split(chunk3JK66E3I_cjs.PG_PATH_ELEMENT_SEPARATOR);
 }
 
 // src/query/execution/result-mapper.ts
@@ -6040,7 +6045,7 @@ async function* createStreamIterable(batchSize, paginate) {
   }
 }
 function getStreamBatchSize(options) {
-  return options?.batchSize ?? chunkFQCQM3KG_cjs.DEFAULT_STREAM_BATCH_SIZE;
+  return options?.batchSize ?? chunk3JK66E3I_cjs.DEFAULT_STREAM_BATCH_SIZE;
 }
 
 // src/query/execution/field-tracker.ts
@@ -6122,7 +6127,7 @@ function createNodeTrackingProxy(alias, kindNames, tracker, options) {
           return getPlaceholderForSystemField(property, options.mode);
         }
         if (property === "meta") {
-          for (const key of chunkFQCQM3KG_cjs.NODE_META_KEYS) {
+          for (const key of chunk3JK66E3I_cjs.NODE_META_KEYS) {
             tracker.record(alias, `meta.${key}`, true);
           }
           return buildNodeMetaPlaceholder(options.mode);
@@ -6155,7 +6160,7 @@ function createEdgeTrackingProxy(alias, edgeKindNames, tracker, options) {
           return getPlaceholderForSystemField(property, options.mode);
         }
         if (property === "meta") {
-          for (const key of chunkFQCQM3KG_cjs.EDGE_META_KEYS) {
+          for (const key of chunk3JK66E3I_cjs.EDGE_META_KEYS) {
             tracker.record(alias, `meta.${key}`, true);
           }
           return buildEdgeMetaPlaceholder(options.mode);
@@ -6924,7 +6929,7 @@ function substituteParameters(ast, bindings) {
   };
 }
 function fillPlaceholders(params, bindings, dialect) {
-  const adapter = chunkFQCQM3KG_cjs.getDialect(dialect);
+  const adapter = chunk3JK66E3I_cjs.getDialect(dialect);
   return params.map((parameter) => {
     if (parameter instanceof drizzleOrm.Placeholder) {
       const name = parameter.name;
@@ -8019,7 +8024,7 @@ var ExecutableQuery = class _ExecutableQuery {
       );
     }
     const isBackward = options.last !== void 0 || options.before !== void 0;
-    const limit = options.first ?? options.last ?? chunkFQCQM3KG_cjs.DEFAULT_PAGINATION_LIMIT;
+    const limit = options.first ?? options.last ?? chunk3JK66E3I_cjs.DEFAULT_PAGINATION_LIMIT;
     const cursor = options.after ?? options.before;
     let cursorData;
     if (cursor) {
@@ -9360,6 +9365,12 @@ function countDistinct(alias, field2) {
     }
   };
 }
+function countEdges(edgeAlias) {
+  return count(edgeAlias);
+}
+function countDistinctEdges(edgeAlias) {
+  return countDistinct(edgeAlias);
+}
 function sum(alias, field2) {
   return {
     __type: "aggregate",
@@ -9765,7 +9776,7 @@ function createGraphAlgorithms(params) {
   const ctx = {
     graphId: params.graphId,
     backend: params.backend,
-    dialect: chunkFQCQM3KG_cjs.getDialect(params.backend.dialect),
+    dialect: chunk3JK66E3I_cjs.getDialect(params.backend.dialect),
     schema: params.schema ?? (params.backend.tableNames ? createSqlSchema(params.backend.tableNames) : createSqlSchema()),
     defaultTemporalMode: params.defaultTemporalMode
   };
@@ -12705,17 +12716,17 @@ async function rebuildFulltextIndex(ctx, nodeKind, options) {
       if (remaining > 0 && pageResult.skippedIds.length > 0) {
         skippedIds.push(...pageResult.skippedIds.slice(0, remaining));
       }
-      await backend.transaction(async (tx) => {
+      const writePage = async (target) => {
         if (pageResult.toUpsert.length > 0) {
-          if (tx.upsertFulltextBatch) {
-            await tx.upsertFulltextBatch({
+          if (target.upsertFulltextBatch) {
+            await target.upsertFulltextBatch({
               graphId: ctx.graphId,
               nodeKind: kind,
               rows: pageResult.toUpsert
             });
-          } else if (tx.upsertFulltext) {
+          } else if (target.upsertFulltext) {
             for (const item of pageResult.toUpsert) {
-              await tx.upsertFulltext({
+              await target.upsertFulltext({
                 graphId: ctx.graphId,
                 nodeKind: kind,
                 nodeId: item.nodeId,
@@ -12726,15 +12737,15 @@ async function rebuildFulltextIndex(ctx, nodeKind, options) {
           }
         }
         if (pageResult.toDelete.length > 0) {
-          if (tx.deleteFulltextBatch) {
-            await tx.deleteFulltextBatch({
+          if (target.deleteFulltextBatch) {
+            await target.deleteFulltextBatch({
               graphId: ctx.graphId,
               nodeKind: kind,
               nodeIds: pageResult.toDelete
             });
-          } else if (tx.deleteFulltext) {
+          } else if (target.deleteFulltext) {
             for (const nodeId of pageResult.toDelete) {
-              await tx.deleteFulltext({
+              await target.deleteFulltext({
                 graphId: ctx.graphId,
                 nodeKind: kind,
                 nodeId
@@ -12742,7 +12753,8 @@ async function rebuildFulltextIndex(ctx, nodeKind, options) {
             }
           }
         }
-      });
+      };
+      await chunkRNUNP5JD_cjs.runOptionallyInTransaction(backend, writePage);
       processed += rows.length;
       upserted += pageResult.toUpsert.length;
       cleared += pageResult.toDelete.length;
@@ -13424,12 +13436,19 @@ var Store = class {
   }
   // === Batch Query Execution ===
   /**
-   * Executes multiple queries over a single connection with snapshot consistency.
+   * Executes multiple queries and returns a typed tuple of results.
    *
-   * Acquires one connection via an implicit transaction, executes each query
-   * sequentially on that connection, and returns a typed tuple of results.
-   * Each query preserves its own result type, projection, filtering,
-   * sorting, and pagination.
+   * Each query preserves its own result type, projection, filtering, sorting,
+   * and pagination.
+   *
+   * **Snapshot consistency is conditional.** When
+   * `backend.capabilities.transactions` is `true`, queries run sequentially
+   * on a single connection inside an implicit transaction and observe the
+   * same database snapshot. When transactions are unavailable
+   * (Cloudflare D1, `drizzle-orm/neon-http`), queries run sequentially over
+   * independent connections and may observe writes that landed between them.
+   * Branch on `backend.capabilities.transactions` if you need a guaranteed
+   * snapshot.
    *
    * Read-only — use `bulkCreate`, `bulkInsert`, etc. for write batching.
    *
@@ -13453,10 +13472,10 @@ var Store = class {
    * @returns A tuple with per-query typed results, preserving input order
    */
   async batch(...queries) {
-    return this.#backend.transaction(async (txBackend) => {
+    return chunkRNUNP5JD_cjs.runOptionallyInTransaction(this.#backend, async (target) => {
       const results = [];
       for (const query of queries) {
-        const result = await query.executeOn(txBackend);
+        const result = await query.executeOn(target);
         results.push(result);
       }
       return results;
@@ -13495,7 +13514,7 @@ var Store = class {
       graphId: this.graphId,
       rootId,
       backend: this.#backend,
-      dialect: chunkFQCQM3KG_cjs.getDialect(this.#backend.dialect),
+      dialect: chunk3JK66E3I_cjs.getDialect(this.#backend.dialect),
       schema: this.#schema,
       options
     });
@@ -13520,8 +13539,26 @@ var Store = class {
    *   );
    * });
    * ```
+   *
+   * **Backends without transactions.** When `backend.capabilities.transactions`
+   * is `false` (Cloudflare D1, `drizzle-orm/neon-http`), this method runs the
+   * callback against the same backend used outside `transaction()` — writes
+   * are applied as they happen and a thrown error does **not** roll back
+   * earlier writes inside the callback. Branch on
+   * `backend.capabilities.transactions` if you require atomicity:
+   *
+   * ```typescript
+   * if (backend.capabilities.transactions) {
+   *   await store.transaction(async (tx) => { ... });
+   * } else {
+   *   // sequential, non-atomic — handle partial-failure recovery yourself
+   * }
+   * ```
    */
   async transaction(fn) {
+    if (!this.#backend.capabilities.transactions) {
+      return fn({ nodes: this.nodes, edges: this.edges });
+    }
     return this.#backend.transaction(async (txBackend) => {
       const txNodeOperations = {
         ...this.#nodeOperations,
@@ -13569,6 +13606,36 @@ var Store = class {
     this.#search = void 0;
   }
   // === Lifecycle ===
+  /**
+   * Refreshes the backend's query-planner statistics.
+   *
+   * Call this once after a large initial import or bulk backfill. The
+   * planner uses table statistics to choose between TypeGraph's
+   * multi-column indexes; without fresh stats a forward traversal can
+   * pick a reverse index and run an order of magnitude slower than
+   * needed. Autovacuum / background statistics will catch up
+   * eventually, but calling this explicitly after a bulk load gives
+   * you correct latencies immediately.
+   *
+   * Implementations:
+   * - SQLite runs `ANALYZE`, populating `sqlite_stat1`
+   * - PostgreSQL runs `ANALYZE` on the TypeGraph-managed tables
+   *
+   * Costs a few tens of milliseconds at the sizes this library is
+   * designed for. Safe to call at any time.
+   *
+   * @example
+   * ```typescript
+   * // After a bulk import
+   * for (const batch of batches) {
+   *   await store.nodes.Document.bulkCreate(batch);
+   * }
+   * await store.refreshStatistics();
+   * ```
+   */
+  async refreshStatistics() {
+    await this.#backend.refreshStatistics();
+  }
   /**
    * Closes the store and releases underlying resources.
    *
@@ -13807,11 +13874,11 @@ Object.defineProperty(exports, "isUserRecoverable", {
 });
 Object.defineProperty(exports, "fts5Strategy", {
   enumerable: true,
-  get: function () { return chunkFQCQM3KG_cjs.fts5Strategy; }
+  get: function () { return chunk3JK66E3I_cjs.fts5Strategy; }
 });
 Object.defineProperty(exports, "tsvectorStrategy", {
   enumerable: true,
-  get: function () { return chunkFQCQM3KG_cjs.tsvectorStrategy; }
+  get: function () { return chunk3JK66E3I_cjs.tsvectorStrategy; }
 });
 Object.defineProperty(exports, "DEFAULT_SEARCHABLE_LANGUAGE", {
   enumerable: true,
@@ -13876,6 +13943,8 @@ exports.composeFragments = composeFragments;
 exports.core = core;
 exports.count = count;
 exports.countDistinct = countDistinct;
+exports.countDistinctEdges = countDistinctEdges;
+exports.countEdges = countEdges;
 exports.createExternalRef = createExternalRef;
 exports.createFragment = createFragment;
 exports.createQueryBuilder = createQueryBuilder;