@nicia-ai/typegraph 0.46.2 → 0.48.0

package/dist/{chunk-HNYLMPQQ.cjs → chunk-OTUPEF2W.cjs}

@@ -1,19 +1,21 @@
 'use strict';
 
-var chunkBQM5P2NO_cjs = require('./chunk-BQM5P2NO.cjs');
-var chunk32UETY6S_cjs = require('./chunk-32UETY6S.cjs');
-var chunkQPOQX2DI_cjs = require('./chunk-QPOQX2DI.cjs');
-var chunkANKOXPCC_cjs = require('./chunk-ANKOXPCC.cjs');
-var chunkWA64ZSCA_cjs = require('./chunk-WA64ZSCA.cjs');
-var chunkZBVZ7HXD_cjs = require('./chunk-ZBVZ7HXD.cjs');
-var chunk5PDSCELM_cjs = require('./chunk-5PDSCELM.cjs');
-var chunkKCH7WQA5_cjs = require('./chunk-KCH7WQA5.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 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) => chunk5PDSCELM_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(),
@@ -178,6 +183,7 @@ var ImportResultSchema = zod.z.object({
   }),
   errors: zod.z.array(ImportErrorSchema)
 });
+var MAX_TIMER_DELAY_MS = 2147483647;
 var ExportOptionsSchema = zod.z.object({
   /** Filter to specific node kinds (undefined = all) */
   nodeKinds: zod.z.array(zod.z.string()).optional(),
@@ -217,6 +223,20 @@ var ExportOptionsSchema = zod.z.object({
   signal: zod.z.instanceof(AbortSignal).optional()
 });
 var ExportStreamOptionsSchema = ExportOptionsSchema.extend({
+  /**
+   * Maximum time the consumer may leave a delivered chunk unacknowledged
+   * before the export settles itself. The clock starts when a chunk is yielded
+   * and is cleared when the consumer asks for the next chunk, so time spent
+   * waiting for the backend to produce a chunk does not count as consumer
+   * idleness. On expiry, the consumer is rejected with
+   * `ExportStreamIdleTimeoutError` and any snapshot transaction and serialized
+   * connection lease are released.
+   *
+   * Omit this only when the caller guarantees a cooperative exit (`break`,
+   * `throw`, or `iterator.return()`) or supplies a signal it will abort. An
+   * abandoned async iterator is not closed by garbage collection.
+   */
+  idleTimeoutMs: zod.z.number().int().positive().max(MAX_TIMER_DELAY_MS).optional(),
   batchSize: zod.z.number().int().positive().default(1e3)
 });
 
@@ -239,8 +259,8 @@ async function importGraph(store, data, rawOptions) {
   );
 }
 async function withImportStreamLease(store, run) {
-  const lease = chunkANKOXPCC_cjs.acquireSerializedStreamLease(
-    chunk32UETY6S_cjs.storeBackend(store),
+  const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(
+    chunk3KOY4FH3_cjs.storeBackend(store),
     "import-stream"
   );
   if (!lease.acquired) {
@@ -263,13 +283,13 @@ async function importGraphData(store, data, options) {
   const errors = [];
   const graph = store.graph;
   const graphId = store.graphId;
-  const backend = chunk32UETY6S_cjs.storeBackend(store);
-  const runtime = chunk32UETY6S_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 chunkQPOQX2DI_cjs.runInWriteTransaction(
+  await chunkJFRT7S3B_cjs.runInWriteTransaction(
     {
       graphId,
       schemaVersion: store.introspect().schemaVersion,
@@ -332,8 +352,8 @@ async function importGraphData(store, data, options) {
 async function importGraphStream(store, chunks, rawOptions) {
   const options = ImportOptionsSchema.parse(rawOptions);
   const sourceBackend = exportStreamBackend(chunks);
-  const targetBackend = chunk32UETY6S_cjs.storeBackend(store);
-  const contention = sourceBackend === void 0 ? void 0 : chunkANKOXPCC_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,
@@ -350,7 +370,7 @@ async function importGraphStream(store, chunks, rawOptions) {
   try {
     for await (const chunk of chunks) {
       if (releaseImportLease === void 0) {
-        const lease = chunkANKOXPCC_cjs.acquireSerializedStreamLease(
+        const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(
           targetBackend,
           "import-stream"
         );
@@ -480,7 +500,7 @@ function serializedStreamRefusal(input) {
     requested,
     heldBy
   );
-  return new chunkKCH7WQA5_cjs.ConfigurationError(
+  return new chunkMRDBBHIZ_cjs.ConfigurationError(
     message,
     { code, graphId, requested, heldBy },
     { suggestion }
@@ -515,7 +535,7 @@ function throwIfStreamChunkFailed(result, options) {
 }
 function assertIdentityImportSupported(store, hasIdentitySection) {
   if (hasIdentitySection && store.graph.identity === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "Cannot import identity assertions into an identity-disabled graph.",
       { code: "IDENTITY_IMPORT_REQUIRES_PROFILE", graphId: store.graphId }
     );
@@ -525,7 +545,7 @@ function validateIdentitySection(identity) {
   if (identity === void 0) return;
   const parsed = InterchangeIdentitySchema.safeParse(identity);
   if (parsed.success) return;
-  throw new chunkKCH7WQA5_cjs.ValidationError(
+  throw new chunkMRDBBHIZ_cjs.ValidationError(
     `Invalid identity interchange section: ${parsed.error.message}`,
     {
       issues: parsed.error.issues.map((issue) => ({
@@ -551,19 +571,19 @@ function identityImportError(assertion, graphId, message) {
   };
 }
 function isIdConflictError(error) {
-  return error instanceof chunkKCH7WQA5_cjs.ConfigurationError && error.details["code"] === IDENTITY_IMPORT_ID_CONFLICT_CODE;
+  return error instanceof chunkMRDBBHIZ_cjs.ConfigurationError && error.details["code"] === IDENTITY_IMPORT_ID_CONFLICT_CODE;
 }
 function touchesRef(assertion, ref) {
   return assertion.a.kind === ref.kind && assertion.a.id === ref.id || assertion.b.kind === ref.kind && assertion.b.id === ref.id;
 }
 function asIdentityImportError(assertions, graphId, error) {
   const tagged = taggedAssertion(assertions, error);
-  if (error instanceof chunkKCH7WQA5_cjs.NodeNotFoundError) {
+  if (error instanceof chunkMRDBBHIZ_cjs.NodeNotFoundError) {
     const ref = error.details;
     const assertion = tagged ?? assertions.find((candidate) => touchesRef(candidate, ref));
     return identityImportError(assertion, graphId, error.message);
   }
-  if (error instanceof chunkKCH7WQA5_cjs.IdentityContradictionError) {
+  if (error instanceof chunkMRDBBHIZ_cjs.IdentityContradictionError) {
     const { a, b } = error.details;
     const assertion = tagged ?? assertions.find(
       (candidate) => touchesRef(candidate, a) && touchesRef(candidate, b)
@@ -589,12 +609,12 @@ function asIdentityImportError(assertions, graphId, error) {
 }
 function taggedAssertion(assertions, error) {
   if (typeof error !== "object" || error === null) return void 0;
-  const id = error[chunkQPOQX2DI_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);
 }
 function isIdentityAssertionValidationError(error) {
-  return error instanceof chunkKCH7WQA5_cjs.ValidationError && error.details.issues.length > 0 && error.details.issues.every(
+  return error instanceof chunkMRDBBHIZ_cjs.ValidationError && error.details.issues.length > 0 && error.details.issues.every(
     (issue) => issue.path === "identity.assertions" && issue.assertionId !== void 0
   );
 }
@@ -620,7 +640,7 @@ function identityImportProgress(error) {
   if (typeof error !== "object" || error === null) {
     return { created: 0, skipped: 0 };
   }
-  const progress = error[chunkQPOQX2DI_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 };
   }
@@ -629,7 +649,7 @@ function identityImportProgress(error) {
 function validateStreamHeader(header) {
   const parsed = GraphDataHeaderSchema.safeParse(header);
   if (parsed.success) return;
-  throw new chunkKCH7WQA5_cjs.ValidationError(
+  throw new chunkMRDBBHIZ_cjs.ValidationError(
     `Invalid graph interchange stream header: ${parsed.error.message}`,
     {
       issues: parsed.error.issues.map((issue) => ({
@@ -689,7 +709,7 @@ async function refreshStatisticsAfterImport(store, options, result, surface) {
 }
 function buildNodeSchemaMap(graph) {
   const map = /* @__PURE__ */ new Map();
-  for (const kindName of chunkWA64ZSCA_cjs.getNodeKinds(graph)) {
+  for (const kindName of chunkBFUOME67_cjs.getNodeKinds(graph)) {
     const registration = graph.nodes[kindName];
     map.set(kindName, {
       registration,
@@ -700,7 +720,7 @@ function buildNodeSchemaMap(graph) {
 }
 function buildEdgeSchemaMap(graph) {
   const map = /* @__PURE__ */ new Map();
-  for (const kindName of chunkWA64ZSCA_cjs.getEdgeKinds(graph)) {
+  for (const kindName of chunkBFUOME67_cjs.getEdgeKinds(graph)) {
     const registration = graph.edges[kindName];
     map.set(kindName, {
       registration,
@@ -822,8 +842,8 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
     registerAppliedNodeUpdate,
     seedNodeRow,
     seedUniqueRow
-  } = chunkBQM5P2NO_cjs.createNodeBatchValidationBackend(graphId, registry, backend);
-  await chunkBQM5P2NO_cjs.primeBatchValidationCaches(
+  } = chunkJB6T4GLL_cjs.createNodeBatchValidationBackend(graphId, registry, backend);
+  await chunkJB6T4GLL_cjs.primeBatchValidationCaches(
     { graphId, registry },
     candidates.map((candidate) => candidate.draft),
     backend,
@@ -844,7 +864,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
         case "skip": {
           record(node, {
             status: "skipped",
-            liveTarget: chunkANKOXPCC_cjs.isLiveNodeRow(existing)
+            liveTarget: chunk5PRKMB24_cjs.isLiveNodeRow(existing)
           });
           break;
         }
@@ -856,7 +876,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
           break;
         }
         case "update": {
-          if (!chunkANKOXPCC_cjs.isLiveNodeRow(existing)) {
+          if (!chunk5PRKMB24_cjs.isLiveNodeRow(existing)) {
             record(node, { status: "skipped", liveTarget: false });
             break;
           }
@@ -891,7 +911,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
             registerAppliedNodeUpdate(
               node.kind,
               node.id,
-              chunkANKOXPCC_cjs.rowPropsToObject(existing.props),
+              chunk5PRKMB24_cjs.rowPropsToObject(existing.props),
               props,
               uniqueConstraints
             );
@@ -906,7 +926,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
       continue;
     }
     const uniquenessResult = await catchUniquenessError(
-      () => chunk32UETY6S_cjs.checkUniquenessConstraints(
+      () => chunk3KOY4FH3_cjs.checkUniquenessConstraints(
         { graphId, registry, backend: validationBackend },
         node.kind,
         node.id,
@@ -933,7 +953,7 @@ async function processNodeSlice(backend, graphId, registry, batch, schemas, opti
     } else {
       await backend.insertNodesBatch(insertParamsList);
     }
-    await chunk32UETY6S_cjs.applyNodeInsertSideEffectsBatch(
+    await chunk3KOY4FH3_cjs.applyNodeInsertSideEffectsBatch(
       writeContext,
       accepted.map((candidate) => ({
         kind: candidate.node.kind,
@@ -978,7 +998,7 @@ async function catchUniquenessError(fn) {
   try {
     return { ok: true, value: await fn() };
   } catch (error) {
-    if (error instanceof chunkKCH7WQA5_cjs.UniquenessError) {
+    if (error instanceof chunkMRDBBHIZ_cjs.UniquenessError) {
       return { ok: false, error: error.message };
     }
     throw error;
@@ -988,7 +1008,7 @@ var NODE_UPDATE_TARGET_CHANGED_CODE = "INTERCHANGE_NODE_UPDATE_TARGET_CHANGED";
 async function updateImportedNode(writeContext, backend, node, args) {
   try {
     const result = await catchUniquenessError(
-      () => chunk32UETY6S_cjs.applyNodeUpdate(
+      () => chunk3KOY4FH3_cjs.applyNodeUpdate(
         writeContext,
         {
           existing: args.existing,
@@ -1003,7 +1023,7 @@ async function updateImportedNode(writeContext, backend, node, args) {
     );
     return result.ok ? void 0 : result.error;
   } catch (error) {
-    if (!(error instanceof chunkKCH7WQA5_cjs.DatabaseOperationError) || error.details.reason !== "no_row_returned") {
+    if (!(error instanceof chunkMRDBBHIZ_cjs.DatabaseOperationError) || error.details.reason !== "no_row_returned") {
       throw error;
     }
     return `${NODE_UPDATE_TARGET_CHANGED_CODE}: Node "${node.kind}:${node.id}" was not updated: no live node matching the id and the validity bound this import checked remained when the write ran, so the row changed or was removed after it was checked. Re-export the source and retry.`;
@@ -1039,7 +1059,7 @@ async function updateImportedEdge(backend, graphId, edge, props, windowFence) {
     });
     return void 0;
   } catch (error) {
-    if (!(error instanceof chunkKCH7WQA5_cjs.DatabaseOperationError) || error.details.reason !== "no_row_returned") {
+    if (!(error instanceof chunkMRDBBHIZ_cjs.DatabaseOperationError) || error.details.reason !== "no_row_returned") {
       throw error;
     }
     return `${EDGE_IDENTITY_CONFLICT_CODE}: Edge "${edge.id}" of kind "${edge.kind}" from "${edge.from.kind}:${edge.from.id}" to "${edge.to.kind}:${edge.to.id}" was not updated: no live edge matching the identity and the validity bound this import checked remained when the write ran, so the row changed or was removed after it was checked. Re-export the source and retry.`;
@@ -1049,9 +1069,9 @@ function windowResultOf(assert) {
   try {
     return { ok: true, value: assert() };
   } catch (error) {
-    if (error instanceof chunkKCH7WQA5_cjs.ValidationError) {
+    if (error instanceof chunkMRDBBHIZ_cjs.ValidationError) {
       const coded = error.details.issues.find(
-        (issue) => issue.code === chunkKCH7WQA5_cjs.INVERTED_VALIDITY_WINDOW_CODE || issue.code === chunkKCH7WQA5_cjs.IMMUTABLE_VALIDITY_LOWER_BOUND_CODE
+        (issue) => issue.code === chunkMRDBBHIZ_cjs.INVERTED_VALIDITY_WINDOW_CODE || issue.code === chunkMRDBBHIZ_cjs.IMMUTABLE_VALIDITY_LOWER_BOUND_CODE
       );
       if (coded !== void 0) {
         return { ok: false, error: `${coded.code}: ${error.message}` };
@@ -1069,12 +1089,12 @@ function windowErrorOf(assert) {
 }
 function validateValidityWindow(entity) {
   return windowErrorOf(() => {
-    chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(
+    chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
       entity.validFrom ?? void 0,
       "validFrom"
     );
-    chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(entity.validTo, "validTo");
-    chunk5PDSCELM_cjs.assertOrderedValidityWindow(
+    chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(entity.validTo, "validTo");
+    chunkTQHGE7UC_cjs.assertOrderedValidityWindow(
       `${entity.kind} "${entity.id}"`,
       entity.validFrom ?? void 0,
       entity.validTo
@@ -1083,7 +1103,7 @@ function validateValidityWindow(entity) {
 }
 function validateUpdateValidityWindow(entity, storedValidFrom) {
   const verdict = windowResultOf(
-    () => chunk5PDSCELM_cjs.assertWritableValidityWindow(
+    () => chunkTQHGE7UC_cjs.assertWritableValidityWindow(
       `${entity.kind} "${entity.id}"`,
       entity.validFrom ?? void 0,
       {
@@ -1122,7 +1142,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
   if (existing) {
     switch (options.onConflict) {
       case "skip": {
-        return { status: "skipped", liveTarget: chunkANKOXPCC_cjs.isLiveNodeRow(existing) };
+        return { status: "skipped", liveTarget: chunk5PRKMB24_cjs.isLiveNodeRow(existing) };
       }
       case "error": {
         return {
@@ -1131,7 +1151,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
         };
       }
       case "update": {
-        if (!chunkANKOXPCC_cjs.isLiveNodeRow(existing)) {
+        if (!chunk5PRKMB24_cjs.isLiveNodeRow(existing)) {
           return { status: "skipped", liveTarget: false };
         }
         const updateWindow = validateUpdateValidityWindow(
@@ -1161,7 +1181,7 @@ async function processNode(backend, graphId, registry, node, schemas, options, l
     }
   }
   const uniquenessResult = await catchUniquenessError(
-    () => chunk32UETY6S_cjs.checkUniquenessConstraints(
+    () => chunk3KOY4FH3_cjs.checkUniquenessConstraints(
       { graphId, registry, backend },
       node.kind,
       node.id,
@@ -1180,7 +1200,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 chunk32UETY6S_cjs.applyNodeInsertSideEffects(
+  await chunk3KOY4FH3_cjs.applyNodeInsertSideEffects(
     writeContext,
     {
       kind: node.kind,
@@ -1266,7 +1286,7 @@ async function processEdgeSlice(backend, graphId, registry, batch, edgeSchemas,
       });
       continue;
     }
-    const endpointError = chunkZBVZ7HXD_cjs.validateEdgeEndpoints(
+    const endpointError = chunkFQPEMEWX_cjs.validateEdgeEndpoints(
       edge.kind,
       edge.from.kind,
       edge.to.kind,
@@ -1315,7 +1335,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 (chunkANKOXPCC_cjs.isLiveNodeRow(row)) {
+        if (chunk5PRKMB24_cjs.isLiveNodeRow(row)) {
           liveEndpointKeys.add(makeNodeKey(kind, row.id));
         }
       }
@@ -1326,7 +1346,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 && chunkANKOXPCC_cjs.isLiveNodeRow(row);
+    return row !== void 0 && chunk5PRKMB24_cjs.isLiveNodeRow(row);
   };
   const existingById = /* @__PURE__ */ new Map();
   if (candidates.length > 0 && backend.getEdges !== void 0) {
@@ -1468,7 +1488,7 @@ async function processEdge(backend, graphId, registry, edge, edgeSchemas, nodeSc
   if (!nodeSchemas.has(edge.to.kind)) {
     return { status: "error", error: `Unknown to node kind: ${edge.to.kind}` };
   }
-  const endpointError = chunkZBVZ7HXD_cjs.validateEdgeEndpoints(
+  const endpointError = chunkFQPEMEWX_cjs.validateEdgeEndpoints(
     edge.kind,
     edge.from.kind,
     edge.to.kind,
@@ -1487,7 +1507,7 @@ async function processEdge(backend, graphId, registry, edge, edgeSchemas, nodeSc
         edge.from.kind,
         edge.from.id
       );
-      if (fromExists === void 0 || !chunkANKOXPCC_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}`
@@ -1496,7 +1516,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 || !chunkANKOXPCC_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}`
@@ -1633,7 +1653,7 @@ function formatZodError(error) {
   }).join("; ");
 }
 function makeNodeKey(kind, id) {
-  return chunkQPOQX2DI_cjs.encodeTupleKey([kind, id]);
+  return chunkEZEEWCFJ_cjs.encodeTupleKey([kind, id]);
 }
 
 // src/interchange/export.ts
@@ -1676,17 +1696,62 @@ async function exportGraph(store, options) {
   };
 }
 function exportGraphStream(store, options) {
-  const backend = chunk32UETY6S_cjs.storeBackend(store);
+  const backend = chunk3KOY4FH3_cjs.storeBackend(store);
   return markExportStreamBackend(
     exportGraphStreamFromBackend(store, backend, options),
     backend
   );
 }
 async function* exportGraphStreamFromBackend(store, backend, options) {
-  const resolved = ExportStreamOptionsSchema.parse(options ?? {});
+  const parsed = ExportStreamOptionsSchema.parse(options ?? {});
+  const exportsIdentity = store.graph.identity !== void 0;
+  const explicitlyDisabledTemporalFields = options?.includeTemporal === false;
+  if (exportsIdentity && explicitlyDisabledTemporalFields) {
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+      "Identity export requires temporal endpoint fields.",
+      {
+        code: "IDENTITY_EXPORT_REQUIRES_TEMPORAL_FIELDS",
+        identityMode: parsed.identityMode,
+        includeTemporal: false
+      },
+      {
+        suggestion: "Remove includeTemporal or set it to true when exporting an identity-enabled graph."
+      }
+    );
+  }
+  const resolved = exportsIdentity ? { ...parsed, includeTemporal: true } : parsed;
   const signal = resolved.signal;
+  const idleTimeoutMs = resolved.idleTimeoutMs;
   const channel = createRendezvousChannel();
-  const abortStream = () => {
+  let idleTimer;
+  let subscribedToSignal = false;
+  function unsubscribeFromSignal() {
+    if (!subscribedToSignal) return;
+    signal?.removeEventListener("abort", abortStream);
+    subscribedToSignal = false;
+  }
+  function clearIdleTimer() {
+    if (idleTimer === void 0) return;
+    clearTimeout(idleTimer);
+    idleTimer = void 0;
+  }
+  function armIdleTimer() {
+    if (idleTimeoutMs === void 0) return;
+    idleTimer = setTimeout(() => {
+      idleTimer = void 0;
+      unsubscribeFromSignal();
+      channel.abort(
+        new chunkMRDBBHIZ_cjs.ExportStreamIdleTimeoutError(
+          store.graphId,
+          idleTimeoutMs,
+          backend.capabilities.transactions
+        )
+      );
+    }, idleTimeoutMs);
+    unrefTimer(idleTimer);
+  }
+  function abortStream() {
+    clearIdleTimer();
     channel.abort(
       exportStreamCancelled(
         "mid-stream",
@@ -1695,11 +1760,9 @@ async function* exportGraphStreamFromBackend(store, backend, options) {
         backend.capabilities.transactions
       )
     );
-  };
-  const unsubscribeFromSignal = () => {
-    signal?.removeEventListener("abort", abortStream);
-  };
+  }
   signal?.addEventListener("abort", abortStream, { once: true });
+  subscribedToSignal = signal !== void 0;
   if (signal?.aborted === true) {
     unsubscribeFromSignal();
     throw exportStreamCancelled(
@@ -1750,20 +1813,28 @@ async function* exportGraphStreamFromBackend(store, backend, options) {
     for (; ; ) {
       const delivery = await channel.take();
       if (delivery === void 0) return;
+      armIdleTimer();
       yield delivery.value;
+      clearIdleTimer();
       delivery.acknowledge();
     }
   } finally {
     unsubscribeFromSignal();
+    clearIdleTimer();
     channel.cancel();
     await producer;
   }
 }
+function unrefTimer(timer) {
+  if (typeof timer === "object" && "unref" in timer && typeof timer.unref === "function") {
+    timer.unref();
+  }
+}
 function exportStreamCancelled(phase, graphId, signal, framed) {
   const message = phase === "before-open" ? "The graph export stream was aborted through its AbortSignal before it opened: no snapshot transaction was started and no database connection claimed." : framed ? "The graph export stream was aborted through its AbortSignal: its repeatable-read snapshot has been rolled back and the connection it held released." : "The graph export stream was aborted through its AbortSignal: its remaining reads were abandoned. This backend does not support transactions, so the export held no snapshot and no connection \u2014 and the chunks already delivered were never guaranteed to agree with one another.";
   const cause = signal?.reason;
   const suggestion = phase === "before-open" ? "Start a new export; the aborted one claimed nothing." : framed ? "Start a new export; the aborted one released its snapshot transaction and the connection it held." : "Start a new export; nothing was held, but discard the chunks already delivered unless partial, mutually-inconsistent data is acceptable.";
-  return new chunkKCH7WQA5_cjs.ExportStreamCancelledError(
+  return new chunkMRDBBHIZ_cjs.ExportStreamCancelledError(
     message,
     { graphId },
     {
@@ -1773,7 +1844,7 @@ function exportStreamCancelled(phase, graphId, signal, framed) {
   );
 }
 function claimSnapshotExportLeaseOrRefuse(graphId, backend) {
-  const lease = chunkANKOXPCC_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
+  const lease = chunkSIT26LAZ_cjs.acquireSerializedStreamLease(backend, "export-snapshot");
   if (!lease.acquired) {
     throw serializedStreamRefusal({
       graphId,
@@ -1785,14 +1856,14 @@ function claimSnapshotExportLeaseOrRefuse(graphId, backend) {
 }
 async function produceExportChunks(store, backend, options, emit) {
   const graphId = store.graphId;
-  const nodeKinds = options.nodeKinds ?? chunkWA64ZSCA_cjs.getNodeKinds(store.graph);
-  const edgeKinds = options.edgeKinds ?? chunkWA64ZSCA_cjs.getEdgeKinds(store.graph);
+  const nodeKinds = options.nodeKinds ?? chunkBFUOME67_cjs.getNodeKinds(store.graph);
+  const edgeKinds = options.edgeKinds ?? chunkBFUOME67_cjs.getEdgeKinds(store.graph);
   const schemaVersion = await backend.getActiveSchema(graphId);
   await emit({
     type: "header",
     header: {
       formatVersion: FORMAT_VERSION,
-      exportedAt: chunk5PDSCELM_cjs.nowIso(),
+      exportedAt: chunkTQHGE7UC_cjs.nowIso(),
       source: {
         type: "typegraph-export",
         graphId,
@@ -1829,7 +1900,7 @@ async function produceExportChunks(store, backend, options, emit) {
   if (store.graph.identity === void 0) return;
   let after;
   for (; ; ) {
-    const page = await chunk32UETY6S_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
+    const page = await chunk3KOY4FH3_cjs.storeRuntime(store).readIdentityAssertionPageAtTarget(
       backend,
       options.identityMode,
       {
@@ -1978,7 +2049,7 @@ async function* exportNodeChunks(backend, graphId, kind, options) {
       const node = {
         kind: row.kind,
         id: row.id,
-        properties: chunkANKOXPCC_cjs.rowPropsToObject(row.props)
+        properties: chunk5PRKMB24_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2028,7 +2099,7 @@ async function* exportEdgeChunks(backend, graphId, kind, options) {
           kind: row.to_kind,
           id: row.to_id
         },
-        properties: chunkANKOXPCC_cjs.rowPropsToObject(row.props)
+        properties: chunk5PRKMB24_cjs.rowPropsToObject(row.props)
       };
       if (options.includeTemporal) {
         const validFrom = (
@@ -2078,5 +2149,5 @@ exports.importGraph = importGraph;
 exports.importGraphStream = importGraphStream;
 exports.serializedStreamRefusal = serializedStreamRefusal;
 exports.withImportStreamLease = withImportStreamLease;
-//# sourceMappingURL=chunk-HNYLMPQQ.cjs.map
-//# sourceMappingURL=chunk-HNYLMPQQ.cjs.map
+//# sourceMappingURL=chunk-OTUPEF2W.cjs.map
+//# sourceMappingURL=chunk-OTUPEF2W.cjs.map