@nicia-ai/typegraph 0.47.0 → 0.49.0

package/dist/{chunk-U5EDAVOJ.cjs → chunk-3G5W2U2L.cjs}

@@ -1,19 +1,21 @@
 'use strict';
 
-var chunkWGX7JH7E_cjs = require('./chunk-WGX7JH7E.cjs');
-var chunkMFZR4QKM_cjs = require('./chunk-MFZR4QKM.cjs');
-var chunkMX4DHSQP_cjs = require('./chunk-MX4DHSQP.cjs');
-var chunk3HGRTCDU_cjs = require('./chunk-3HGRTCDU.cjs');
+var chunkJB6T4GLL_cjs = require('./chunk-JB6T4GLL.cjs');
+var chunk3KOY4FH3_cjs = require('./chunk-3KOY4FH3.cjs');
+var chunkJFRT7S3B_cjs = require('./chunk-JFRT7S3B.cjs');
+var chunkEZEEWCFJ_cjs = require('./chunk-EZEEWCFJ.cjs');
+var chunkSIT26LAZ_cjs = require('./chunk-SIT26LAZ.cjs');
+var chunk5PRKMB24_cjs = require('./chunk-5PRKMB24.cjs');
 var chunkBFUOME67_cjs = require('./chunk-BFUOME67.cjs');
 var chunkFQPEMEWX_cjs = require('./chunk-FQPEMEWX.cjs');
-var chunk425IZOQ5_cjs = require('./chunk-425IZOQ5.cjs');
+var chunkTQHGE7UC_cjs = require('./chunk-TQHGE7UC.cjs');
 var chunkMRDBBHIZ_cjs = require('./chunk-MRDBBHIZ.cjs');
 var chunkN66HCGCY_cjs = require('./chunk-N66HCGCY.cjs');
 var zod = require('zod');
 
 var FORMAT_VERSION = "2.0";
 var AcceptedFormatVersionSchema = zod.z.enum(["1.0", "2.0"]);
-var ValidityTimestampSchema = zod.z.iso.datetime().refine((value) => chunk425IZOQ5_cjs.isCanonicalIsoDate(value), {
+var ValidityTimestampSchema = zod.z.iso.datetime().refine((value) => chunkTQHGE7UC_cjs.isCanonicalIsoDate(value), {
   message: "Expected canonical UTC ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ); convert with new Date(value).toISOString()."
 });
 var InterchangeNodeSchema = zod.z.object({
@@ -22,10 +24,13 @@ var InterchangeNodeSchema = zod.z.object({
   properties: zod.z.record(zod.z.string(), zod.z.unknown()),
   /**
    * `undefined` (key absent): not requested (`includeTemporal: false`) —
-   * import defaults it to the import's own creation timestamp. `null`:
-   * requested and confirmed the row has no lower bound (e.g. a legacy row
-   * predating the "omitted validFrom defaults to creation time" fix) —
-   * import preserves that open-left validity instead of re-stamping it.
+   * import defaults it to the import's own creation timestamp, UNLESS the
+   * record states a `validTo` at or before that instant, in which case the row
+   * is imported with no lower bound ("ended at T, start unknown") rather than
+   * one after its own end (issue #407). `null`: requested and confirmed the row
+   * has no lower bound (e.g. a legacy row predating the "omitted validFrom
+   * defaults to creation time" fix) — import preserves that open-left validity
+   * instead of re-stamping it.
    */
   validFrom: ValidityTimestampSchema.nullable().optional(),
   validTo: ValidityTimestampSchema.optional(),
@@ -235,6 +240,29 @@ var ExportStreamOptionsSchema = ExportOptionsSchema.extend({
   batchSize: zod.z.number().int().positive().default(1e3)
 });
 
+// src/interchange/ingestion-import-target.ts
+var INGESTION_IMPORT_TARGETS = /* @__PURE__ */ new WeakMap();
+function registerIngestionImportTarget(handle, store) {
+  INGESTION_IMPORT_TARGETS.set(handle, store);
+}
+function resolveIngestionImportTarget(target) {
+  const registeredStore = INGESTION_IMPORT_TARGETS.get(target);
+  if (registeredStore !== void 0) return registeredStore;
+  try {
+    chunk3KOY4FH3_cjs.storeBackend(target);
+    return target;
+  } catch (error) {
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+      "Interchange import received an unrecognized ingestion target",
+      { target: "unregistered-ingestion-target" },
+      {
+        cause: error,
+        suggestion: "Pass a Store or the exact handle returned by ingestionBranch() from this TypeGraph installation."
+      }
+    );
+  }
+}
+
 // src/interchange/stream-source.ts
 var EXPORT_STREAM_BACKENDS = /* @__PURE__ */ new WeakMap();
 function markExportStreamBackend(stream, backend) {
@@ -246,7 +274,8 @@ function exportStreamBackend(stream) {
 }
 
 // src/interchange/import.ts
-async function importGraph(store, data, rawOptions) {
+async function importGraph(target, data, rawOptions) {
+  const store = resolveIngestionImportTarget(target);
   const options = ImportOptionsSchema.parse(rawOptions);
   return withImportStreamLease(
     store,
@@ -254,8 +283,8 @@ async function importGraph(store, data, rawOptions) {
   );
 }
 async function withImportStreamLease(store, run) {
-  const lease = chunk3HGRTCDU_cjs.acquireSerializedStreamLease(
-    chunkMFZR4QKM_cjs.storeBackend(store),
+  const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(
+    chunk3KOY4FH3_cjs.storeBackend(store),
     "import-stream"
   );
   if (!lease.acquired) {
@@ -278,13 +307,13 @@ async function importGraphData(store, data, options) {
   const errors = [];
   const graph = store.graph;
   const graphId = store.graphId;
-  const backend = chunkMFZR4QKM_cjs.storeBackend(store);
-  const runtime = chunkMFZR4QKM_cjs.storeRuntime(store);
+  const backend = chunk3KOY4FH3_cjs.storeBackend(store);
+  const runtime = chunk3KOY4FH3_cjs.storeRuntime(store);
   const registry = store.registry;
   const nodeSchemas = buildNodeSchemaMap(graph);
   const edgeSchemas = buildEdgeSchemaMap(graph);
   const importedNodeIds = /* @__PURE__ */ new Set();
-  await chunkMX4DHSQP_cjs.runInWriteTransaction(
+  await chunkJFRT7S3B_cjs.runInWriteTransaction(
     {
       graphId,
       schemaVersion: store.introspect().schemaVersion,
@@ -344,11 +373,12 @@ async function importGraphData(store, data, options) {
     errors
   };
 }
-async function importGraphStream(store, chunks, rawOptions) {
+async function importGraphStream(target, chunks, rawOptions) {
+  const store = resolveIngestionImportTarget(target);
   const options = ImportOptionsSchema.parse(rawOptions);
   const sourceBackend = exportStreamBackend(chunks);
-  const targetBackend = chunkMFZR4QKM_cjs.storeBackend(store);
-  const contention = sourceBackend === void 0 ? void 0 : chunk3HGRTCDU_cjs.snapshotExportContention(sourceBackend, targetBackend);
+  const targetBackend = chunk3KOY4FH3_cjs.storeBackend(store);
+  const contention = sourceBackend === void 0 ? void 0 : chunkSIT26LAZ_cjs.snapshotExportContention(sourceBackend, targetBackend);
   if (contention !== void 0) {
     throw serializedStreamRefusal({
       graphId: store.graphId,
@@ -365,7 +395,7 @@ async function importGraphStream(store, chunks, rawOptions) {
   try {
     for await (const chunk of chunks) {
       if (releaseImportLease === void 0) {
-        const lease = chunk3HGRTCDU_cjs.acquireSerializedStreamLease(
+        const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(
           targetBackend,
           "import-stream"
         );
@@ -604,7 +634,7 @@ function asIdentityImportError(assertions, graphId, error) {
 }
 function taggedAssertion(assertions, error) {
   if (typeof error !== "object" || error === null) return void 0;
-  const id = error[chunkMX4DHSQP_cjs.IDENTITY_IMPORT_FAILED_ASSERTION];
+  const id = error[chunkJFRT7S3B_cjs.IDENTITY_IMPORT_FAILED_ASSERTION];
   if (typeof id !== "string") return void 0;
   return assertions.find((candidate) => candidate.id === id);
 }
@@ -635,7 +665,7 @@ function identityImportProgress(error) {
   if (typeof error !== "object" || error === null) {
     return { created: 0, skipped: 0 };
   }
-  const progress = error[chunkMX4DHSQP_cjs.IDENTITY_IMPORT_PROGRESS];
+  const progress = error[chunkJFRT7S3B_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 };
   }
@@ -837,8 +867,8 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
     registerAppliedNodeUpdate,
     seedNodeRow,
     seedUniqueRow
-  } = chunkWGX7JH7E_cjs.createNodeBatchValidationBackend(graphId, registry, backend);
-  await chunkWGX7JH7E_cjs.primeBatchValidationCaches(
+  } = chunkJB6T4GLL_cjs.createNodeBatchValidationBackend(graphId, registry, backend);
+  await chunkJB6T4GLL_cjs.primeBatchValidationCaches(
     { graphId, registry },
     candidates.map((candidate) => candidate.draft),
     backend,
@@ -859,7 +889,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
         case "skip": {
           record(node, {
             status: "skipped",
-            liveTarget: chunk3HGRTCDU_cjs.isLiveNodeRow(existing)
+            liveTarget: chunk5PRKMB24_cjs.isLiveNodeRow(existing)
           });
           break;
         }
@@ -871,7 +901,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
           break;
         }
         case "update": {
-          if (!chunk3HGRTCDU_cjs.isLiveNodeRow(existing)) {
+          if (!chunk5PRKMB24_cjs.isLiveNodeRow(existing)) {
             record(node, { status: "skipped", liveTarget: false });
             break;
           }
@@ -906,7 +936,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
             registerAppliedNodeUpdate(
               node.kind,
               node.id,
-              chunk3HGRTCDU_cjs.rowPropsToObject(existing.props),
+              chunk5PRKMB24_cjs.rowPropsToObject(existing.props),
               props,
               uniqueConstraints
             );
@@ -921,7 +951,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
       continue;
     }
     const uniquenessResult = await catchUniquenessError(
-      () => chunkMFZR4QKM_cjs.checkUniquenessConstraints(
+      () => chunk3KOY4FH3_cjs.checkUniquenessConstraints(
         { graphId, registry, backend: validationBackend },
         node.kind,
         node.id,
@@ -948,7 +978,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
     } else {
       await backend.insertNodesBatch(insertParamsList);
     }
-    await chunkMFZR4QKM_cjs.applyNodeInsertSideEffectsBatch(
+    await chunk3KOY4FH3_cjs.applyNodeInsertSideEffectsBatch(
       writeContext,
       accepted.map((candidate) => ({
         kind: candidate.node.kind,
@@ -1003,7 +1033,7 @@ var NODE_UPDATE_TARGET_CHANGED_CODE = "INTERCHANGE_NODE_UPDATE_TARGET_CHANGED";
 async function updateImportedNode(writeContext, backend, node, args) {
   try {
     const result = await catchUniquenessError(
-      () => chunkMFZR4QKM_cjs.applyNodeUpdate(
+      () => chunk3KOY4FH3_cjs.applyNodeUpdate(
         writeContext,
         {
           existing: args.existing,
@@ -1084,12 +1114,12 @@ function windowErrorOf(assert) {
 }
 function validateValidityWindow(entity) {
   return windowErrorOf(() => {
-    chunk425IZOQ5_cjs.validateOptionalCanonicalIsoDate(
+    chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
       entity.validFrom ?? void 0,
       "validFrom"
     );
-    chunk425IZOQ5_cjs.validateOptionalCanonicalIsoDate(entity.validTo, "validTo");
-    chunk425IZOQ5_cjs.assertOrderedValidityWindow(
+    chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(entity.validTo, "validTo");
+    chunkTQHGE7UC_cjs.assertOrderedValidityWindow(
       `${entity.kind} "${entity.id}"`,
       entity.validFrom ?? void 0,
       entity.validTo
@@ -1098,7 +1128,7 @@ function validateValidityWindow(entity) {
 }
 function validateUpdateValidityWindow(entity, storedValidFrom) {
   const verdict = windowResultOf(
-    () => chunk425IZOQ5_cjs.assertWritableValidityWindow(
+    () => chunkTQHGE7UC_cjs.assertWritableValidityWindow(
       `${entity.kind} "${entity.id}"`,
       entity.validFrom ?? void 0,
       {
@@ -1137,7 +1167,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
   if (existing) {
     switch (options.onConflict) {
       case "skip": {
-        return { status: "skipped", liveTarget: chunk3HGRTCDU_cjs.isLiveNodeRow(existing) };
+        return { status: "skipped", liveTarget: chunk5PRKMB24_cjs.isLiveNodeRow(existing) };
       }
       case "error": {
         return {
@@ -1146,7 +1176,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
         };
       }
       case "update": {
-        if (!chunk3HGRTCDU_cjs.isLiveNodeRow(existing)) {
+        if (!chunk5PRKMB24_cjs.isLiveNodeRow(existing)) {
           return { status: "skipped", liveTarget: false };
         }
         const updateWindow = validateUpdateValidityWindow(
@@ -1176,7 +1206,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
     }
   }
   const uniquenessResult = await catchUniquenessError(
-    () => chunkMFZR4QKM_cjs.checkUniquenessConstraints(
+    () => chunk3KOY4FH3_cjs.checkUniquenessConstraints(
       { graphId, registry, backend },
       node.kind,
       node.id,
@@ -1195,7 +1225,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
     ...node.validFrom !== void 0 && { validFrom: node.validFrom },
     ...node.validTo !== void 0 && { validTo: node.validTo }
   });
-  await chunkMFZR4QKM_cjs.applyNodeInsertSideEffects(
+  await chunk3KOY4FH3_cjs.applyNodeInsertSideEffects(
     writeContext,
     {
       kind: node.kind,
@@ -1330,7 +1360,7 @@ async function processEdgeSlice(backend, graphId, registry, batch, edgeSchemas,
     for (const [kind, ids] of idsByKind) {
       const rows = await backend.getNodes(graphId, kind, [...ids]);
       for (const row of rows) {
-        if (chunk3HGRTCDU_cjs.isLiveNodeRow(row)) {
+        if (chunk5PRKMB24_cjs.isLiveNodeRow(row)) {
           liveEndpointKeys.add(makeNodeKey(kind, row.id));
         }
       }
@@ -1341,7 +1371,7 @@ async function processEdgeSlice(backend, graphId, registry, batch, edgeSchemas,
     if (importedNodeIds.has(key)) return true;
     if (checkedEndpointKeys.has(key)) return liveEndpointKeys.has(key);
     const row = await backend.getNode(graphId, endpoint.kind, endpoint.id);
-    return row !== void 0 && chunk3HGRTCDU_cjs.isLiveNodeRow(row);
+    return row !== void 0 && chunk5PRKMB24_cjs.isLiveNodeRow(row);
   };
   const existingById = /* @__PURE__ */ new Map();
   if (candidates.length > 0 && backend.getEdges !== void 0) {
@@ -1502,7 +1532,7 @@ async function processEdge(backend, graphId, registry, edge, edgeSchemas, nodeSc
         edge.from.kind,
         edge.from.id
       );
-      if (fromExists === void 0 || !chunk3HGRTCDU_cjs.isLiveNodeRow(fromExists)) {
+      if (fromExists === void 0 || !chunk5PRKMB24_cjs.isLiveNodeRow(fromExists)) {
         return {
           status: "error",
           error: `From node not found: ${edge.from.kind}:${edge.from.id}`
@@ -1511,7 +1541,7 @@ async function processEdge(backend, graphId, registry, edge, edgeSchemas, nodeSc
     }
     if (!importedNodeIds.has(toKey)) {
       const toExists = await backend.getNode(graphId, edge.to.kind, edge.to.id);
-      if (toExists === void 0 || !chunk3HGRTCDU_cjs.isLiveNodeRow(toExists)) {
+      if (toExists === void 0 || !chunk5PRKMB24_cjs.isLiveNodeRow(toExists)) {
         return {
           status: "error",
           error: `To node not found: ${edge.to.kind}:${edge.to.id}`
@@ -1648,7 +1678,7 @@ function formatZodError(error) {
   }).join("; ");
 }
 function makeNodeKey(kind, id) {
-  return chunkMX4DHSQP_cjs.encodeTupleKey([kind, id]);
+  return chunkEZEEWCFJ_cjs.encodeTupleKey([kind, id]);
 }
 
 // src/interchange/export.ts
@@ -1691,7 +1721,7 @@ async function exportGraph(store, options) {
   };
 }
 function exportGraphStream(store, options) {
-  const backend = chunkMFZR4QKM_cjs.storeBackend(store);
+  const backend = chunk3KOY4FH3_cjs.storeBackend(store);
   return markExportStreamBackend(
     exportGraphStreamFromBackend(store, backend, options),
     backend
@@ -1839,7 +1869,7 @@ function exportStreamCancelled(phase, graphId, signal, framed) {
   );
 }
 function claimSnapshotExportLeaseOrRefuse(graphId, backend) {
-  const lease = chunk3HGRTCDU_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
+  const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
   if (!lease.acquired) {
     throw serializedStreamRefusal({
       graphId,
@@ -1858,7 +1888,7 @@ async function produceExportChunks(store, backend, options, emit) {
     type: "header",
     header: {
       formatVersion: FORMAT_VERSION,
-      exportedAt: chunk425IZOQ5_cjs.nowIso(),
+      exportedAt: chunkTQHGE7UC_cjs.nowIso(),
       source: {
         type: "typegraph-export",
         graphId,
@@ -1895,7 +1925,7 @@ async function produceExportChunks(store, backend, options, emit) {
   if (store.graph.identity === void 0) return;
   let after;
   for (; ; ) {
-    const page = await chunkMFZR4QKM_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
+    const page = await chunk3KOY4FH3_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
       backend,
       options.identityMode,
       {
@@ -2044,7 +2074,7 @@ async function* exportNodeChunks(backend, graphId, kind, options) {
       const node = {
         kind: row.kind,
         id: row.id,
-        properties: chunk3HGRTCDU_cjs.rowPropsToObject(row.props)
+        properties: chunk5PRKMB24_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2094,7 +2124,7 @@ async function* exportEdgeChunks(backend, graphId, kind, options) {
           kind: row.to_kind,
           id: row.to_id
         },
-        properties: chunk3HGRTCDU_cjs.rowPropsToObject(row.props)
+        properties: chunk5PRKMB24_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2142,7 +2172,8 @@ exports.exportGraphStream = exportGraphStream;
 exports.exportStreamBackend = exportStreamBackend;
 exports.importGraph = importGraph;
 exports.importGraphStream = importGraphStream;
+exports.registerIngestionImportTarget = registerIngestionImportTarget;
 exports.serializedStreamRefusal = serializedStreamRefusal;
 exports.withImportStreamLease = withImportStreamLease;
-//# sourceMappingURL=chunk-U5EDAVOJ.cjs.map
-//# sourceMappingURL=chunk-U5EDAVOJ.cjs.map
+//# sourceMappingURL=chunk-3G5W2U2L.cjs.map
+//# sourceMappingURL=chunk-3G5W2U2L.cjs.map