@nicia-ai/typegraph 0.50.0 → 0.51.1

package/dist/{chunk-CS6JTQQ2.cjs → chunk-KACEYDYV.cjs}

@@ -1,14 +1,15 @@
 'use strict';
 
-var chunkC76WFIVZ_cjs = require('./chunk-C76WFIVZ.cjs');
-var chunkTUVD4DFR_cjs = require('./chunk-TUVD4DFR.cjs');
-var chunk7PRMDZIA_cjs = require('./chunk-7PRMDZIA.cjs');
-var chunk5OWHU7Z7_cjs = require('./chunk-5OWHU7Z7.cjs');
-var chunkRDP6ZRSM_cjs = require('./chunk-RDP6ZRSM.cjs');
-var chunkZBFZGLZE_cjs = require('./chunk-ZBFZGLZE.cjs');
-var chunkGHZPZNFC_cjs = require('./chunk-GHZPZNFC.cjs');
-var chunkG2TLHH6T_cjs = require('./chunk-G2TLHH6T.cjs');
-var chunkLLVOQOWE_cjs = require('./chunk-LLVOQOWE.cjs');
+var chunk2KCTP3U2_cjs = require('./chunk-2KCTP3U2.cjs');
+var chunk2CVDZCXH_cjs = require('./chunk-2CVDZCXH.cjs');
+var chunkFMMW3KX7_cjs = require('./chunk-FMMW3KX7.cjs');
+var chunkL6EVYIID_cjs = require('./chunk-L6EVYIID.cjs');
+var chunkJQKMEKKW_cjs = require('./chunk-JQKMEKKW.cjs');
+var chunkNLX5OWK7_cjs = require('./chunk-NLX5OWK7.cjs');
+var chunkZGVTNKTX_cjs = require('./chunk-ZGVTNKTX.cjs');
+var chunkNUQ2YFFH_cjs = require('./chunk-NUQ2YFFH.cjs');
+var chunk7B7I7YAW_cjs = require('./chunk-7B7I7YAW.cjs');
+var chunkCRZ56SZU_cjs = require('./chunk-CRZ56SZU.cjs');
 var chunkM5MSP3BI_cjs = require('./chunk-M5MSP3BI.cjs');
 var chunkX4GDXBOP_cjs = require('./chunk-X4GDXBOP.cjs');
 var chunkN66HCGCY_cjs = require('./chunk-N66HCGCY.cjs');
@@ -250,7 +251,7 @@ function resolveIngestionImportTarget(target) {
   const registeredStore = INGESTION_IMPORT_TARGETS.get(target);
   if (registeredStore !== void 0) return registeredStore;
   try {
-    chunkTUVD4DFR_cjs.storeBackend(target);
+    chunk2CVDZCXH_cjs.storeBackend(target);
     return target;
   } catch (error) {
     throw new chunkX4GDXBOP_cjs.ConfigurationError(
@@ -284,8 +285,8 @@ async function importGraph(target, data, rawOptions) {
   );
 }
 async function withImportStreamLease(store, run) {
-  const lease = chunkZBFZGLZE_cjs.acquireSerializedStreamLease(
-    chunkTUVD4DFR_cjs.storeBackend(store),
+  const lease = chunkNLX5OWK7_cjs.acquireSerializedStreamLease(
+    chunk2CVDZCXH_cjs.storeBackend(store),
     "import-stream"
   );
   if (!lease.acquired) {
@@ -308,19 +309,27 @@ async function importGraphData(store, data, options) {
   const errors = [];
   const graph = store.graph;
   const graphId = store.graphId;
-  const backend = chunkTUVD4DFR_cjs.storeBackend(store);
-  const runtime = chunkTUVD4DFR_cjs.storeRuntime(store);
+  const backend = chunk2CVDZCXH_cjs.storeBackend(store);
+  const runtime = chunk2CVDZCXH_cjs.storeRuntime(store);
   const registry = store.registry;
-  const owedClaimReason = chunkC76WFIVZ_cjs.graphOwesClaims(graph, registry);
-  const claimRefusal = owedClaimReason === void 0 ? void 0 : chunkRDP6ZRSM_cjs.constraintFenceRefusal({ graphId }, backend, owedClaimReason);
+  const batchPointRead = chunkZGVTNKTX_cjs.batchPointReadVerdict(backend);
+  const uniqueSidecarBatch = chunkZGVTNKTX_cjs.uniqueSidecarBatchVerdict(backend);
+  const owedClaimReason = chunk2KCTP3U2_cjs.graphOwesClaims(graph, registry);
+  const claimRefusal = owedClaimReason === void 0 ? void 0 : chunkJQKMEKKW_cjs.constraintFenceRefusal({ graphId }, backend, owedClaimReason);
   if (claimRefusal !== void 0) throw claimRefusal;
   const nodeSchemas = buildNodeSchemaMap(graph);
   const edgeSchemas = buildEdgeSchemaMap(graph);
   const importedNodeIds = /* @__PURE__ */ new Set();
-  await chunkC76WFIVZ_cjs.runWritePlan(
+  await chunk2KCTP3U2_cjs.runWritePlan(
     {
       graphId,
       registry,
+      // Interning (`createClaimsVerdictThunk`'s `WeakMap`) makes this the SAME
+      // thunk object the store's own operations use for this backend — a
+      // second, independent memoization for the same backend is exactly what
+      // interning exists to rule out.
+      claimsVerdict: chunkZGVTNKTX_cjs.createClaimsVerdictThunk(backend),
+      uniqueSidecarBatch,
       schemaVersion: store.introspect().schemaVersion,
       historyEnabled: store.historyEnabled,
       revisionTrackingEnabled: store.revisionTrackingEnabled,
@@ -333,10 +342,16 @@ async function importGraphData(store, data, options) {
     },
     // An import writes node rows AND edge rows in one frame, so it declares the
     // mixed family explicitly instead of receiving either narrower session.
-    chunkC76WFIVZ_cjs.mixedWritePlan(void 0, true),
+    chunk2KCTP3U2_cjs.mixedWritePlan(void 0, true),
     backend,
     async (session, target, overlaidSession) => {
-      const frame = { session, target, overlaidSession };
+      const frame = {
+        session,
+        target,
+        overlaidSession,
+        batchPointRead,
+        uniqueSidecarBatch
+      };
       await processNodes(
         frame,
         graphId,
@@ -389,8 +404,8 @@ async function importGraphStream(target, chunks, rawOptions) {
   const store = resolveIngestionImportTarget(target);
   const options = ImportOptionsSchema.parse(rawOptions);
   const sourceBackend = exportStreamBackend(chunks);
-  const targetBackend = chunkTUVD4DFR_cjs.storeBackend(store);
-  const contention = sourceBackend === void 0 ? void 0 : chunkZBFZGLZE_cjs.snapshotExportContention(sourceBackend, targetBackend);
+  const targetBackend = chunk2CVDZCXH_cjs.storeBackend(store);
+  const contention = sourceBackend === void 0 ? void 0 : chunkNLX5OWK7_cjs.snapshotExportContention(sourceBackend, targetBackend);
   if (contention !== void 0) {
     throw serializedStreamRefusal({
       graphId: store.graphId,
@@ -407,7 +422,7 @@ async function importGraphStream(target, chunks, rawOptions) {
   try {
     for await (const chunk of chunks) {
       if (releaseImportLease === void 0) {
-        const lease = chunkZBFZGLZE_cjs.acquireSerializedStreamLease(
+        const lease = chunkNLX5OWK7_cjs.acquireSerializedStreamLease(
           targetBackend,
           "import-stream"
         );
@@ -646,7 +661,7 @@ function asIdentityImportError(assertions, graphId, error) {
 }
 function taggedAssertion(assertions, error) {
   if (typeof error !== "object" || error === null) return void 0;
-  const id = error[chunk5OWHU7Z7_cjs.IDENTITY_IMPORT_FAILED_ASSERTION];
+  const id = error[chunkL6EVYIID_cjs.IDENTITY_IMPORT_FAILED_ASSERTION];
   if (typeof id !== "string") return void 0;
   return assertions.find((candidate) => candidate.id === id);
 }
@@ -677,7 +692,7 @@ function identityImportProgress(error) {
   if (typeof error !== "object" || error === null) {
     return { created: 0, skipped: 0 };
   }
-  const progress = error[chunk5OWHU7Z7_cjs.IDENTITY_IMPORT_PROGRESS];
+  const progress = error[chunkL6EVYIID_cjs.IDENTITY_IMPORT_PROGRESS];
   if (typeof progress !== "object" || progress === null || !("created" in progress) || typeof progress.created !== "number" || !("skipped" in progress) || typeof progress.skipped !== "number") {
     return { created: 0, skipped: 0 };
   }
@@ -746,7 +761,7 @@ async function refreshStatisticsAfterImport(store, options, result, surface) {
 }
 function buildNodeSchemaMap(graph) {
   const map = /* @__PURE__ */ new Map();
-  for (const kindName of chunkG2TLHH6T_cjs.getNodeKinds(graph)) {
+  for (const kindName of chunk7B7I7YAW_cjs.getNodeKinds(graph)) {
     const registration = graph.nodes[kindName];
     map.set(kindName, {
       registration,
@@ -757,7 +772,7 @@ function buildNodeSchemaMap(graph) {
 }
 function buildEdgeSchemaMap(graph) {
   const map = /* @__PURE__ */ new Map();
-  for (const kindName of chunkG2TLHH6T_cjs.getEdgeKinds(graph)) {
+  for (const kindName of chunk7B7I7YAW_cjs.getEdgeKinds(graph)) {
     const registration = graph.edges[kindName];
     map.set(kindName, {
       registration,
@@ -879,9 +894,14 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
     registerAppliedNodeUpdate,
     seedNodeRow,
     seedUniqueRow
-  } = chunkC76WFIVZ_cjs.createNodeBatchValidationSeams(graphId, registry, frame.target);
-  await chunkC76WFIVZ_cjs.primeBatchValidationCaches(
-    { graphId, registry },
+  } = chunk2KCTP3U2_cjs.createNodeBatchValidationSeams(graphId, registry, frame.target);
+  await chunk2KCTP3U2_cjs.primeBatchValidationCaches(
+    {
+      graphId,
+      registry,
+      batchPointRead: frame.batchPointRead,
+      uniqueSidecarBatch: frame.uniqueSidecarBatch
+    },
     candidates.map((candidate) => candidate.draft),
     frame.target,
     { seedNodeRow, seedUniqueRow }
@@ -901,7 +921,7 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
         case "skip": {
           record(node, {
             status: "skipped",
-            liveTarget: chunkGHZPZNFC_cjs.isLiveNodeRow(existing)
+            liveTarget: chunkNUQ2YFFH_cjs.isLiveNodeRow(existing)
           });
           break;
         }
@@ -913,7 +933,7 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
           break;
         }
         case "update": {
-          if (!chunkGHZPZNFC_cjs.isLiveNodeRow(existing)) {
+          if (!chunkNUQ2YFFH_cjs.isLiveNodeRow(existing)) {
             record(node, { status: "skipped", liveTarget: false });
             break;
           }
@@ -936,7 +956,7 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
             registerAppliedNodeUpdate(
               node.kind,
               node.id,
-              chunkGHZPZNFC_cjs.rowPropsToObject(existing.props),
+              chunkNUQ2YFFH_cjs.rowPropsToObject(existing.props),
               props,
               uniqueConstraints
             );
@@ -951,14 +971,14 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
       continue;
     }
     const constraintResult = await catchDeclaredConstraintRefusal(async () => {
-      await chunkTUVD4DFR_cjs.checkUniquenessConstraints(
+      await chunk2CVDZCXH_cjs.checkUniquenessConstraints(
         { graphId, registry, backend: validationBackend },
         node.kind,
         node.id,
         props,
         uniqueConstraints
       );
-      await chunkC76WFIVZ_cjs.checkDisjointnessConstraint(
+      await chunk2KCTP3U2_cjs.checkDisjointnessConstraint(
         { graphId, registry, backend: validationBackend },
         node.kind,
         node.id
@@ -1182,7 +1202,7 @@ async function processNode(frame, graphId, registry, node, schemas, options) {
   if (existing) {
     switch (options.onConflict) {
       case "skip": {
-        return { status: "skipped", liveTarget: chunkGHZPZNFC_cjs.isLiveNodeRow(existing) };
+        return { status: "skipped", liveTarget: chunkNUQ2YFFH_cjs.isLiveNodeRow(existing) };
       }
       case "error": {
         return {
@@ -1191,7 +1211,7 @@ async function processNode(frame, graphId, registry, node, schemas, options) {
         };
       }
       case "update": {
-        if (!chunkGHZPZNFC_cjs.isLiveNodeRow(existing)) {
+        if (!chunkNUQ2YFFH_cjs.isLiveNodeRow(existing)) {
           return { status: "skipped", liveTarget: false };
         }
         const updateWindow = validateUpdateValidityWindow(
@@ -1216,14 +1236,14 @@ async function processNode(frame, graphId, registry, node, schemas, options) {
     }
   }
   const constraintResult = await catchDeclaredConstraintRefusal(async () => {
-    await chunkTUVD4DFR_cjs.checkUniquenessConstraints(
+    await chunk2CVDZCXH_cjs.checkUniquenessConstraints(
       { graphId, registry, backend: frame.target },
       node.kind,
       node.id,
       propsResult.data,
       uniqueConstraints
     );
-    await chunkC76WFIVZ_cjs.checkDisjointnessConstraint(
+    await chunk2KCTP3U2_cjs.checkDisjointnessConstraint(
       { graphId, registry, backend: frame.target },
       node.kind,
       node.id
@@ -1302,7 +1322,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
   const {
     backend: cardinalityValidationBackend,
     registerPendingEdgeForCardinality
-  } = chunkC76WFIVZ_cjs.createEdgeBatchValidationBackend(frame.target);
+  } = chunk2KCTP3U2_cjs.createEdgeBatchValidationBackend(frame.target);
   const candidates = [];
   const deferred = [];
   const seenIds = /* @__PURE__ */ new Set();
@@ -1329,7 +1349,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
       });
       continue;
     }
-    const endpointError = chunkLLVOQOWE_cjs.validateEdgeEndpoints(
+    const endpointError = chunkCRZ56SZU_cjs.validateEdgeEndpoints(
       edge.kind,
       edge.from.kind,
       edge.to.kind,
@@ -1363,7 +1383,12 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
   }
   const liveEndpointKeys = /* @__PURE__ */ new Set();
   const checkedEndpointKeys = /* @__PURE__ */ new Set();
-  if (options.validateReferences && frame.target.getNodes !== void 0) {
+  const boundGetNodesForEndpoints = chunkNUQ2YFFH_cjs.bindExtraIfReachable(
+    frame.target,
+    frame.batchPointRead.extras.getNodes,
+    chunkNUQ2YFFH_cjs.BATCH_POINT_READ.id
+  );
+  if (options.validateReferences && boundGetNodesForEndpoints !== void 0) {
     const idsByKind = /* @__PURE__ */ new Map();
     for (const { edge } of candidates) {
       for (const endpoint of [edge.from, edge.to]) {
@@ -1376,9 +1401,11 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
       }
     }
     for (const [kind, ids] of idsByKind) {
-      const rows = await frame.target.getNodes(graphId, kind, [...ids]);
+      const rows = await boundGetNodesForEndpoints.getNodes(graphId, kind, [
+        ...ids
+      ]);
       for (const row of rows) {
-        if (chunkGHZPZNFC_cjs.isLiveNodeRow(row)) {
+        if (chunkNUQ2YFFH_cjs.isLiveNodeRow(row)) {
           liveEndpointKeys.add(makeNodeKey(kind, row.id));
         }
       }
@@ -1389,11 +1416,16 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
     if (importedNodeIds.has(key)) return true;
     if (checkedEndpointKeys.has(key)) return liveEndpointKeys.has(key);
     const row = await frame.target.getNode(graphId, endpoint.kind, endpoint.id);
-    return row !== void 0 && chunkGHZPZNFC_cjs.isLiveNodeRow(row);
+    return row !== void 0 && chunkNUQ2YFFH_cjs.isLiveNodeRow(row);
   };
   const existingById = /* @__PURE__ */ new Map();
-  if (candidates.length > 0 && frame.target.getEdges !== void 0) {
-    const rows = await frame.target.getEdges(
+  const boundGetEdges = chunkNUQ2YFFH_cjs.bindExtraIfReachable(
+    frame.target,
+    frame.batchPointRead.extras.getEdges,
+    chunkNUQ2YFFH_cjs.BATCH_POINT_READ.id
+  );
+  if (candidates.length > 0 && boundGetEdges !== void 0) {
+    const rows = await boundGetEdges.getEdges(
       graphId,
       candidates.map((candidate) => candidate.edge.id)
     );
@@ -1477,7 +1509,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
     const insertParams = edgeInsertParamsOf(graphId, candidate);
     const cardinality = edgeSchemas.get(edge.kind)?.registration.cardinality ?? "many";
     const cardinalityResult = await catchDeclaredConstraintRefusal(
-      () => chunkC76WFIVZ_cjs.checkCardinalityConstraint(
+      () => chunk2KCTP3U2_cjs.checkCardinalityConstraint(
         { graphId, registry, backend: cardinalityValidationBackend },
         edge.kind,
         cardinality,
@@ -1539,7 +1571,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
   if (!nodeSchemas.has(edge.to.kind)) {
     return { status: "error", error: `Unknown to node kind: ${edge.to.kind}` };
   }
-  const endpointError = chunkLLVOQOWE_cjs.validateEdgeEndpoints(
+  const endpointError = chunkCRZ56SZU_cjs.validateEdgeEndpoints(
     edge.kind,
     edge.from.kind,
     edge.to.kind,
@@ -1558,7 +1590,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
         edge.from.kind,
         edge.from.id
       );
-      if (fromExists === void 0 || !chunkGHZPZNFC_cjs.isLiveNodeRow(fromExists)) {
+      if (fromExists === void 0 || !chunkNUQ2YFFH_cjs.isLiveNodeRow(fromExists)) {
         return {
           status: "error",
           error: `From node not found: ${edge.from.kind}:${edge.from.id}`
@@ -1571,7 +1603,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
         edge.to.kind,
         edge.to.id
       );
-      if (toExists === void 0 || !chunkGHZPZNFC_cjs.isLiveNodeRow(toExists)) {
+      if (toExists === void 0 || !chunkNUQ2YFFH_cjs.isLiveNodeRow(toExists)) {
         return {
           status: "error",
           error: `To node not found: ${edge.to.kind}:${edge.to.id}`
@@ -1633,7 +1665,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
   }
   const cardinality = schemaEntry.registration.cardinality ?? "many";
   const cardinalityResult = await catchDeclaredConstraintRefusal(
-    () => chunkC76WFIVZ_cjs.checkCardinalityConstraint(
+    () => chunk2KCTP3U2_cjs.checkCardinalityConstraint(
       { graphId, registry, backend: frame.target },
       edge.kind,
       cardinality,
@@ -1658,7 +1690,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
 }
 function importEdgeInsertWork(graphId, candidate, cardinality) {
   const params = edgeInsertParamsOf(graphId, candidate);
-  const claim = chunk7PRMDZIA_cjs.edgeCardinalityClaim(cardinality, params);
+  const claim = chunkFMMW3KX7_cjs.edgeCardinalityClaim(cardinality, params);
   return { params, ...claim === void 0 ? {} : { claim } };
 }
 function validateProperties(properties, schema, unknownStrategy) {
@@ -1723,7 +1755,7 @@ function formatZodError(error) {
   }).join("; ");
 }
 function makeNodeKey(kind, id) {
-  return chunkLLVOQOWE_cjs.encodeTupleKey([kind, id]);
+  return chunkCRZ56SZU_cjs.encodeTupleKey([kind, id]);
 }
 
 // src/interchange/export.ts
@@ -1766,7 +1798,7 @@ async function exportGraph(store, options) {
   };
 }
 function exportGraphStream(store, options) {
-  const backend = chunkTUVD4DFR_cjs.storeBackend(store);
+  const backend = chunk2CVDZCXH_cjs.storeBackend(store);
   return markExportStreamBackend(
     exportGraphStreamFromBackend(store, backend, options),
     backend
@@ -1914,7 +1946,7 @@ function exportStreamCancelled(phase, graphId, signal, framed) {
   );
 }
 function claimSnapshotExportLeaseOrRefuse(graphId, backend) {
-  const lease = chunkZBFZGLZE_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
+  const lease = chunkNLX5OWK7_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
   if (!lease.acquired) {
     throw serializedStreamRefusal({
       graphId,
@@ -1926,8 +1958,8 @@ function claimSnapshotExportLeaseOrRefuse(graphId, backend) {
 }
 async function produceExportChunks(store, backend, options, emit) {
   const graphId = store.graphId;
-  const nodeKinds = options.nodeKinds ?? chunkG2TLHH6T_cjs.getNodeKinds(store.graph);
-  const edgeKinds = options.edgeKinds ?? chunkG2TLHH6T_cjs.getEdgeKinds(store.graph);
+  const nodeKinds = options.nodeKinds ?? chunk7B7I7YAW_cjs.getNodeKinds(store.graph);
+  const edgeKinds = options.edgeKinds ?? chunk7B7I7YAW_cjs.getEdgeKinds(store.graph);
   const schemaVersion = await backend.getActiveSchema(graphId);
   await emit({
     type: "header",
@@ -1970,7 +2002,7 @@ async function produceExportChunks(store, backend, options, emit) {
   if (store.graph.identity === void 0) return;
   let after;
   for (; ; ) {
-    const page = await chunkTUVD4DFR_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
+    const page = await chunk2CVDZCXH_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
       backend,
       options.identityMode,
       {
@@ -2119,7 +2151,7 @@ async function* exportNodeChunks(backend, graphId, kind, options) {
       const node = {
         kind: row.kind,
         id: row.id,
-        properties: chunkGHZPZNFC_cjs.rowPropsToObject(row.props)
+        properties: chunkNUQ2YFFH_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2169,7 +2201,7 @@ async function* exportEdgeChunks(backend, graphId, kind, options) {
           kind: row.to_kind,
           id: row.to_id
         },
-        properties: chunkGHZPZNFC_cjs.rowPropsToObject(row.props)
+        properties: chunkNUQ2YFFH_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2220,5 +2252,5 @@ exports.importGraphStream = importGraphStream;
 exports.registerIngestionImportTarget = registerIngestionImportTarget;
 exports.serializedStreamRefusal = serializedStreamRefusal;
 exports.withImportStreamLease = withImportStreamLease;
-//# sourceMappingURL=chunk-CS6JTQQ2.cjs.map
-//# sourceMappingURL=chunk-CS6JTQQ2.cjs.map
+//# sourceMappingURL=chunk-KACEYDYV.cjs.map
+//# sourceMappingURL=chunk-KACEYDYV.cjs.map