@nicia-ai/typegraph 0.35.0 → 0.37.0

package/dist/{chunk-XOX22WHL.cjs → chunk-WOJMKB3N.cjs}

@@ -1,20 +1,19 @@
 'use strict';
 
-var chunkEOLERH7Y_cjs = require('./chunk-EOLERH7Y.cjs');
-var chunk4TOD4LBZ_cjs = require('./chunk-4TOD4LBZ.cjs');
-var chunkBLZDPRXT_cjs = require('./chunk-BLZDPRXT.cjs');
+var chunkIPSVVTWT_cjs = require('./chunk-IPSVVTWT.cjs');
+var chunk3GH67G4Z_cjs = require('./chunk-3GH67G4Z.cjs');
 var chunk7YSP4V4R_cjs = require('./chunk-7YSP4V4R.cjs');
-var chunkH7YNSMA7_cjs = require('./chunk-H7YNSMA7.cjs');
-var chunkLGEALRC6_cjs = require('./chunk-LGEALRC6.cjs');
+var chunkHAHNRASW_cjs = require('./chunk-HAHNRASW.cjs');
+var chunkBVRDGYXQ_cjs = require('./chunk-BVRDGYXQ.cjs');
 var drizzleOrm = require('drizzle-orm');
 var nanoid = require('nanoid');
 
 // src/core/temporal.ts
 var RECORDED_MAX = "9999-12-31T23:59:59.999Z";
 function assertValidRecordedInstant(value, path) {
-  chunkBLZDPRXT_cjs.validateCanonicalIsoDate(value, path);
+  chunk3GH67G4Z_cjs.validateCanonicalIsoDate(value, path);
   if (value >= RECORDED_MAX) {
-    throw new chunkLGEALRC6_cjs.ValidationError(
+    throw new chunkBVRDGYXQ_cjs.ValidationError(
       `${path} must be before the recorded-time open sentinel ${RECORDED_MAX}.`,
       {
         issues: [
@@ -36,7 +35,7 @@ function asRecordedInstant(value) {
 }
 function resolveReadCoordinate(mode, asOf, suggestion) {
   if (mode !== "asOf" && asOf !== void 0) {
-    throw new chunkLGEALRC6_cjs.ValidationError(
+    throw new chunkBVRDGYXQ_cjs.ValidationError(
       `Temporal mode "${mode}" does not take an asOf timestamp.`,
       {
         issues: [
@@ -67,7 +66,7 @@ function withRecordedCoordinate(coordinate, recordedAsOf) {
 }
 function assertValidAsOf(mode, asOf, options) {
   if (mode === "asOf" && asOf === void 0) {
-    throw new chunkLGEALRC6_cjs.ValidationError(
+    throw new chunkBVRDGYXQ_cjs.ValidationError(
       'Temporal mode "asOf" requires a timestamp',
       {
         issues: [
@@ -80,7 +79,7 @@ function assertValidAsOf(mode, asOf, options) {
     );
   }
   if (asOf !== void 0) {
-    chunkBLZDPRXT_cjs.validateCanonicalIsoDate(asOf, "asOf");
+    chunk3GH67G4Z_cjs.validateCanonicalIsoDate(asOf, "asOf");
   }
 }
 function describeCoordinate(coordinate) {
@@ -145,15 +144,15 @@ function resolveTableNames(names) {
 var VALID_IDENTIFIER_PATTERN = /^[a-z_][a-z0-9_$]*$/i;
 function validateTableName(name, label) {
   if (!name || name.length === 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(`${label} table name cannot be empty`);
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(`${label} table name cannot be empty`);
   }
   if (name.length > chunk7YSP4V4R_cjs.MAX_PG_IDENTIFIER_LENGTH) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       `${label} table name exceeds maximum length of ${chunk7YSP4V4R_cjs.MAX_PG_IDENTIFIER_LENGTH} characters`
     );
   }
   if (!VALID_IDENTIFIER_PATTERN.test(name)) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       `${label} table name "${name}" is not a valid SQL identifier. Table names must start with a letter or underscore and contain only letters, digits, underscores, or dollar signs.`
     );
   }
@@ -169,7 +168,7 @@ function isSqlSchema(schema) {
 }
 function requireSqlSchema(schema, surface = "SqlSchema") {
   if (isSqlSchema(schema)) return schema;
-  throw new chunkLGEALRC6_cjs.ConfigurationError(
+  throw new chunkBVRDGYXQ_cjs.ConfigurationError(
     `${surface} must be created with createSqlSchema(...).`,
     { code: "INVALID_SQL_SCHEMA", surface },
     {
@@ -215,7 +214,7 @@ function recordedRelation(options) {
 function requireExternalRecordedReadSource(source) {
   if (source === void 0) return void 0;
   if (isExternalRecordedReadSource(source)) return source;
-  throw new chunkLGEALRC6_cjs.ConfigurationError(
+  throw new chunkBVRDGYXQ_cjs.ConfigurationError(
     "recordedRead must be created with recordedRelation({ schema }).",
     { code: "INVALID_RECORDED_READ_SOURCE" },
     {
@@ -239,7 +238,7 @@ function createRecordedReadBinding(schema) {
 function requireRecordedReadBinding(binding, surface) {
   if (isRecordedReadBinding(binding)) return binding;
   if (binding !== void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "Recorded-time reads require a recorded read relation created by TypeGraph.",
       { code: "INVALID_RECORDED_READ_BINDING", surface },
       {
@@ -247,7 +246,7 @@ function requireRecordedReadBinding(binding, surface) {
       }
     );
   }
-  throw new chunkLGEALRC6_cjs.ConfigurationError(
+  throw new chunkBVRDGYXQ_cjs.ConfigurationError(
     "Recorded-time reads require a recorded read relation.",
     { code: "RECORDED_READ_REQUIRES_BINDING", surface },
     {
@@ -297,7 +296,7 @@ function generateId() {
 }
 function requireRecordedSchema(target) {
   if (target.tableNames === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "Recorded-time capture requires the backend to expose tableNames.",
       { dialect: target.dialect },
       {
@@ -309,7 +308,7 @@ function requireRecordedSchema(target) {
 }
 function requireCaptureStatements(target) {
   if (target.executeStatement === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "Recorded-time capture requires backend.executeStatement support on the transaction backend.",
       { dialect: target.dialect },
       {
@@ -320,10 +319,10 @@ function requireCaptureStatements(target) {
 }
 async function executeStatement(target, query) {
   requireCaptureStatements(target);
-  await target.executeStatement(chunkEOLERH7Y_cjs.asCompiledStatementSql(query));
+  await target.executeStatement(chunkIPSVVTWT_cjs.asCompiledStatementSql(query));
 }
 function unsupportedPostgresIsolationError(isolationLevel) {
-  return new chunkLGEALRC6_cjs.ConfigurationError(
+  return new chunkBVRDGYXQ_cjs.ConfigurationError(
     "Recorded-time capture on PostgreSQL requires read_committed isolation.",
     { isolationLevel: isolationLevel ?? "unknown" },
     {
@@ -336,6 +335,7 @@ function isSupportedRecordedIsolationLevel(isolationLevel) {
 }
 function assertRequestedRecordedIsolation(backend, options) {
   if (backend.dialect !== "postgres") return;
+  if (options?.accessMode === "read_only") return;
   const isolationLevel = options?.isolationLevel;
   if (isSupportedRecordedIsolationLevel(isolationLevel)) return;
   throw unsupportedPostgresIsolationError(isolationLevel);
@@ -344,10 +344,11 @@ function normalizeIsolationLevel(value) {
   if (typeof value !== "string") return void 0;
   return value.replaceAll(" ", "_").toLowerCase();
 }
-async function assertRecordedCaptureTransactionIsolation(target) {
+async function assertRecordedCaptureTransactionIsolation(target, options) {
   if (target.dialect !== "postgres") return;
+  if (options?.accessMode === "read_only") return;
   const rows = await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(drizzleOrm.sql`
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(drizzleOrm.sql`
       SELECT current_setting('transaction_isolation') AS transaction_isolation
     `)
   );
@@ -357,28 +358,35 @@ async function assertRecordedCaptureTransactionIsolation(target) {
   if (isSupportedRecordedIsolationLevel(isolationLevel)) return;
   throw unsupportedPostgresIsolationError(isolationLevel);
 }
-function recordedCaptureRequiresCallbackTransactionError(details) {
-  return new chunkLGEALRC6_cjs.ConfigurationError(
+function recordedCaptureRequiresCallbackTransactionError(details = {}) {
+  return new chunkBVRDGYXQ_cjs.ConfigurationError(
     "withTransaction() has no recorded-time capture flush point when history is enabled.",
-    details,
+    {
+      ...details,
+      code: "RECORDED_CAPTURE_REQUIRES_CALLBACK_TRANSACTION"
+    },
     {
       suggestion: "Use store.withRecordedTransaction(externalTx, async (tx) => ...) so TypeGraph can flush capture before the caller commits."
     }
   );
 }
 function historyUnsafeRawWriteError(surface) {
-  return new chunkLGEALRC6_cjs.ConfigurationError(
+  return new chunkBVRDGYXQ_cjs.ConfigurationError(
     `${surface} is not available when history capture is enabled because raw SQL writes bypass recorded-time capture.`,
-    { code: "RECORDED_CAPTURE_RAW_SQL_DISABLED" },
+    {
+      code: "RECORDED_CAPTURE_RAW_SQL_DISABLED"
+    },
     {
       suggestion: "Run graph writes through store.nodes/store.edges (or tx.nodes/tx.edges inside a transaction), or perform raw relational writes outside a history-enabled TypeGraph store."
     }
   );
 }
 function revisionTrackingUnsafeRawWriteError(surface) {
-  return new chunkLGEALRC6_cjs.ConfigurationError(
+  return new chunkBVRDGYXQ_cjs.ConfigurationError(
     `${surface} is not available when revision tracking is enabled because raw SQL writes bypass the revision anchor.`,
-    { code: "REVISION_TRACKING_RAW_SQL_DISABLED" },
+    {
+      code: "REVISION_TRACKING_RAW_SQL_DISABLED"
+    },
     {
       suggestion: "Run graph writes through store.nodes/store.edges (or tx.nodes/tx.edges inside a transaction), so TypeGraph can advance the revision anchor."
     }
@@ -455,7 +463,7 @@ function rawWriteGuards(target, prefix) {
 }
 function assertCapturableBackend(backend) {
   if (!backend.capabilities.transactions) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "history: true requires a backend with transaction support.",
       { dialect: backend.dialect },
       {
@@ -464,7 +472,7 @@ function assertCapturableBackend(backend) {
     );
   }
   if (backend.executeStatement === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "history: true requires a backend that supports executeStatement.",
       { dialect: backend.dialect },
       {
@@ -473,7 +481,7 @@ function assertCapturableBackend(backend) {
     );
   }
   if (backend.capabilities.returning === false) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "history: true requires a backend that supports UPDATE \u2026 RETURNING.",
       { dialect: backend.dialect },
       {
@@ -482,7 +490,7 @@ function assertCapturableBackend(backend) {
     );
   }
   if (backend.tableNames === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "history: true requires a backend that exposes tableNames.",
       { dialect: backend.dialect },
       {
@@ -493,7 +501,7 @@ function assertCapturableBackend(backend) {
 }
 function assertRevisionTrackableBackend(backend) {
   if (!backend.capabilities.transactions) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "revisionTracking: true requires a backend with transaction support.",
       { dialect: backend.dialect },
       {
@@ -502,7 +510,7 @@ function assertRevisionTrackableBackend(backend) {
     );
   }
   if (backend.executeStatement === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "revisionTracking: true requires a backend that supports executeStatement.",
       { dialect: backend.dialect },
       {
@@ -511,7 +519,7 @@ function assertRevisionTrackableBackend(backend) {
     );
   }
   if (backend.tableNames === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "revisionTracking: true requires a backend that exposes tableNames.",
       { dialect: backend.dialect },
       {
@@ -520,7 +528,7 @@ function assertRevisionTrackableBackend(backend) {
     );
   }
   if (backend.ensureRevisionOriginsTable === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "revisionTracking: true requires a backend that can bootstrap revision origins.",
       { dialect: backend.dialect },
       {
@@ -568,7 +576,7 @@ function registerRecordedGraphLockMemo(backend, memo) {
 }
 async function acquireRecordedGraphWriteLock(target, graphId) {
   await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(recordedGraphWriteAdvisoryLockSql(graphId))
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(recordedGraphWriteAdvisoryLockSql(graphId))
   );
 }
 async function lockRecordedGraphWrite(target, graphId, memo) {
@@ -592,7 +600,7 @@ async function lockRecordedGraphWrite(target, graphId, memo) {
   return graphWriteLockEvidence();
 }
 function failInvalidClockTimestamp(value) {
-  throw new chunkLGEALRC6_cjs.ConfigurationError(
+  throw new chunkBVRDGYXQ_cjs.ConfigurationError(
     "Recorded clock row contained an invalid timestamp",
     { value }
   );
@@ -631,12 +639,12 @@ function toCanonicalIso(value) {
   return failInvalidClockTimestamp(value);
 }
 function nextRecordedCommitTime(previous) {
-  const wallTime = Date.parse(chunkBLZDPRXT_cjs.nowIso());
+  const wallTime = Date.parse(chunk3GH67G4Z_cjs.nowIso());
   return previous === void 0 ? wallTime : Math.max(wallTime, Date.parse(previous) + 1);
 }
 async function readRecordedClock(target, schema, graphId) {
   const rows = await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(drizzleOrm.sql`
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(drizzleOrm.sql`
       SELECT recorded_at
       FROM ${schema.recordedClockTable}
       WHERE graph_id = ${graphId}
@@ -647,7 +655,7 @@ async function readRecordedClock(target, schema, graphId) {
 }
 async function readRevisionOrigin(target, schema, graphId) {
   const rows = await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(drizzleOrm.sql`
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(drizzleOrm.sql`
       SELECT origin
       FROM ${schema.revisionOriginsTable}
       WHERE graph_id = ${graphId}
@@ -656,7 +664,7 @@ async function readRevisionOrigin(target, schema, graphId) {
   const first = rows[0];
   if (first === void 0) return void 0;
   if (typeof first.origin !== "string" || first.origin.length === 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "Revision origin row contained an invalid origin",
       { graphId, origin: first.origin }
     );
@@ -666,7 +674,7 @@ async function readRevisionOrigin(target, schema, graphId) {
 async function ensureRevisionOrigin(target, schema, graphId) {
   const ensureTable = target.ensureRevisionOriginsTable;
   if (ensureTable === void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       "Revision tracking requires a backend that can bootstrap revision origins.",
       { dialect: target.dialect },
       {
@@ -687,7 +695,7 @@ async function ensureRevisionOrigin(target, schema, graphId) {
   );
   const origin = await readRevisionOrigin(target, schema, graphId);
   if (origin !== void 0) return origin;
-  throw new chunkLGEALRC6_cjs.ConfigurationError(
+  throw new chunkBVRDGYXQ_cjs.ConfigurationError(
     "Revision origin was not persisted after initialization.",
     { graphId, dialect: target.dialect }
   );
@@ -705,7 +713,7 @@ async function writeRecordedClock(target, schema, graphId, recordedAt) {
 async function lockRecordedClock(target, schema, graphId, ownsWriteLock) {
   if (target.dialect === "postgres") {
     await target.execute(
-      chunkEOLERH7Y_cjs.asCompiledRowsSql(recordedClockAdvisoryLockSql(graphId))
+      chunkIPSVVTWT_cjs.asCompiledRowsSql(recordedClockAdvisoryLockSql(graphId))
     );
     return;
   }
@@ -724,7 +732,7 @@ async function allocateRecordedCommit(target, schema, graphId, ownsWriteLock, pr
   const previous = previousRevision ?? await readRecordedClock(target, schema, graphId);
   const recordedCommitTime = nextRecordedCommitTime(previous);
   if (!Number.isFinite(recordedCommitTime) || recordedCommitTime >= RECORDED_MAX_TIME) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       `Recorded commit clock reached the open sentinel ${RECORDED_MAX}`,
       { graphId, recordedCommitTime },
       {
@@ -873,7 +881,7 @@ var RECORDED_BIND_PARAM_BUDGET = 900;
 function recordedBindParamBudget(target) {
   const budget = target.capabilities.maxBindParameters ?? RECORDED_BIND_PARAM_BUDGET;
   if (!Number.isSafeInteger(budget) || budget < 1) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkBVRDGYXQ_cjs.ConfigurationError(
       `backend capabilities.maxBindParameters must be a positive integer, got: ${String(budget)}`,
       {
         code: "INVALID_BACKEND_CAPABILITY",
@@ -894,7 +902,7 @@ function recordedCommonCells() {
     graph_id: (row) => drizzleOrm.sql`${row.graph_id}`,
     id: (row) => drizzleOrm.sql`${row.id}`,
     kind: (row) => drizzleOrm.sql`${row.kind}`,
-    props: (row) => drizzleOrm.sql`${chunk4TOD4LBZ_cjs.rowPropsToJsonText(row.props)}`,
+    props: (row) => drizzleOrm.sql`${chunkIPSVVTWT_cjs.rowPropsToJsonText(row.props)}`,
     valid_from: (row) => drizzleOrm.sql`${chunk7YSP4V4R_cjs.sqlNull(row.valid_from)}`,
     valid_to: (row) => drizzleOrm.sql`${chunk7YSP4V4R_cjs.sqlNull(row.valid_to)}`,
     created_at: (row) => drizzleOrm.sql`${row.created_at}`,
@@ -987,20 +995,20 @@ function entityKey(entity) {
 async function closeOpenReturning(target, table, graphId, ids, recordedCommit, kind) {
   const kindFilter = kind === void 0 ? drizzleOrm.sql`` : drizzleOrm.sql`AND kind = ${kind}`;
   const rows = await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(drizzleOrm.sql`
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(drizzleOrm.sql`
       UPDATE ${table}
       SET recorded_to = ${recordedCommit}
       WHERE graph_id = ${graphId}
         ${kindFilter}
         AND recorded_to = ${RECORDED_MAX}
-        AND id IN (${chunk4TOD4LBZ_cjs.sqlValueList(ids)})
+        AND id IN (${chunkIPSVVTWT_cjs.sqlValueList(ids)})
       RETURNING id, deleted_at
     `)
   );
-  return new Map(rows.map((row) => [row.id, chunk4TOD4LBZ_cjs.isPresent(row.deleted_at)]));
+  return new Map(rows.map((row) => [row.id, chunkIPSVVTWT_cjs.isPresent(row.deleted_at)]));
 }
 function recordedOp(hadOpenRow, priorRowWasTombstone, after) {
-  if (chunk4TOD4LBZ_cjs.isPresent(after.deleted_at)) return "delete";
+  if (chunkIPSVVTWT_cjs.isPresent(after.deleted_at)) return "delete";
   if (!hadOpenRow || priorRowWasTombstone) return "create";
   return "update";
 }
@@ -1037,7 +1045,7 @@ function recordedInsertsFor(afterById, closed) {
 async function flushNodes(target, schema, graphId, entities, recordedCommit) {
   const chunkSize = recordedNodeChunkSize(target);
   for (const [kind, group] of groupNodesByKind(entities)) {
-    for (const entityChunk of chunk4TOD4LBZ_cjs.chunk(group, chunkSize)) {
+    for (const entityChunk of chunkIPSVVTWT_cjs.chunk(group, chunkSize)) {
       const ids = entityChunk.map((entity) => entity.id);
       const closed = await closeOpenReturning(
         target,
@@ -1062,7 +1070,7 @@ async function flushNodes(target, schema, graphId, entities, recordedCommit) {
 }
 async function flushEdges(target, schema, graphId, entities, recordedCommit) {
   const chunkSize = recordedEdgeChunkSize(target);
-  for (const entityChunk of chunk4TOD4LBZ_cjs.chunk(entities, chunkSize)) {
+  for (const entityChunk of chunkIPSVVTWT_cjs.chunk(entities, chunkSize)) {
     const ids = entityChunk.map((entity) => entity.id);
     const closed = await closeOpenReturning(
       target,
@@ -1141,7 +1149,7 @@ async function closeRecordedHardDeletedKind(target, schema, graphId, removal, ow
 }
 async function queryConnectedEdgeIds(target, schema, params) {
   const rows = await target.execute(
-    chunkEOLERH7Y_cjs.asCompiledRowsSql(drizzleOrm.sql`
+    chunkIPSVVTWT_cjs.asCompiledRowsSql(drizzleOrm.sql`
       SELECT id
       FROM ${schema.edgesTable}
       WHERE graph_id = ${params.graphId}
@@ -1188,22 +1196,32 @@ function edgeParamsIdentityKey(params) {
 function edgeRowIdentityKey(row) {
   return edgeIdentityKey(row.graph_id, row.id);
 }
+function recordedCaptureSealedError(details) {
+  return new chunkBVRDGYXQ_cjs.ConfigurationError(
+    "Recorded-time capture session is sealed: a graph write happened after the transaction's capture was flushed.",
+    details,
+    {
+      suggestion: "Perform all writes inside the withRecordedTransaction callback; do not reuse the transaction context after it returns."
+    }
+  );
+}
 function createRecordedCaptureSession() {
   const touched = /* @__PURE__ */ new Map();
   let sealed = false;
   function touch(entity) {
     if (sealed) {
-      throw new chunkLGEALRC6_cjs.ConfigurationError(
-        "Recorded-time capture session is sealed: a graph write happened after the transaction's capture was flushed.",
-        { entity: entity.entity, graphId: entity.graphId, id: entity.id },
-        {
-          suggestion: "Perform all writes inside the withRecordedTransaction callback; do not reuse the transaction context after it returns."
-        }
-      );
+      throw recordedCaptureSealedError({
+        entity: entity.entity,
+        graphId: entity.graphId,
+        id: entity.id
+      });
     }
     touched.set(entityKey(entity), entity);
   }
   return {
+    assertOpen() {
+      if (sealed) throw recordedCaptureSealedError({});
+    },
     touchNode(graphId, kind, id, afterImage) {
       touch({ entity: "node", graphId, kind, id, afterImage });
     },
@@ -1212,7 +1230,7 @@ function createRecordedCaptureSession() {
     },
     async flush(target, schema, ownsWriteLock) {
       if (sealed) {
-        throw new chunkLGEALRC6_cjs.ConfigurationError(
+        throw new chunkBVRDGYXQ_cjs.ConfigurationError(
           "Recorded-time capture session was already flushed.",
           {},
           {
@@ -1223,7 +1241,7 @@ function createRecordedCaptureSession() {
       sealed = true;
       if (touched.size === 0) return /* @__PURE__ */ new Map();
       const recordedByGraph = /* @__PURE__ */ new Map();
-      const byGraph = chunk4TOD4LBZ_cjs.groupBy(touched.values(), (entity) => entity.graphId);
+      const byGraph = chunkIPSVVTWT_cjs.groupBy(touched.values(), (entity) => entity.graphId);
       for (const [graphId, entities] of byGraph) {
         const recordedCommit = await allocateRecordedCommit(
           target,
@@ -1261,9 +1279,10 @@ function createRecordedTransactionBackend(target, session, schema) {
       await lockRecordedGraphWrite(target, graphId, graphLocks);
     }
   }
-  const overlay = chunk4TOD4LBZ_cjs.createBackendOverlay(target, {
+  const overlay = chunkIPSVVTWT_cjs.createBackendOverlay(target, {
     ...rawWriteGuards(target, "tx.backend"),
     async insertNode(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       const row = await target.insertNode(params);
       session.touchNode(params.graphId, params.kind, params.id, row);
@@ -1271,6 +1290,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertNodeNoReturn === void 0 ? {} : {
       async insertNodeNoReturn(params) {
+        session.assertOpen();
         await lockGraph(params.graphId);
         await runInsertNoReturn(nodeDispatch, params);
         session.touchNode(params.graphId, params.kind, params.id);
@@ -1278,6 +1298,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertNodesBatch === void 0 ? {} : {
       async insertNodesBatch(params) {
+        session.assertOpen();
         await lockGraphs(params);
         await runInsertBatch(nodeDispatch, params);
         for (const node of params) {
@@ -1287,6 +1308,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertNodesBatchReturning === void 0 ? {} : {
       async insertNodesBatchReturning(params) {
+        session.assertOpen();
         await lockGraphs(params);
         const rows = await runInsertBatchReturning(nodeDispatch, params);
         const rowsByIdentity = new Map(
@@ -1304,17 +1326,20 @@ function createRecordedTransactionBackend(target, session, schema) {
       }
     },
     async updateNode(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       const row = await target.updateNode(params);
       session.touchNode(params.graphId, params.kind, params.id, row);
       return row;
     },
     async deleteNode(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       await target.deleteNode(params);
       session.touchNode(params.graphId, params.kind, params.id);
     },
     async hardDeleteNode(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       const connectedEdgeIds = await queryConnectedEdgeIds(
         target,
@@ -1328,6 +1353,7 @@ function createRecordedTransactionBackend(target, session, schema) {
       }
     },
     async insertEdge(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       const row = await target.insertEdge(params);
       session.touchEdge(params.graphId, params.id, row);
@@ -1335,6 +1361,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertEdgeNoReturn === void 0 ? {} : {
       async insertEdgeNoReturn(params) {
+        session.assertOpen();
         await lockGraph(params.graphId);
         await runInsertNoReturn(edgeDispatch, params);
         session.touchEdge(params.graphId, params.id);
@@ -1342,6 +1369,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertEdgesBatch === void 0 ? {} : {
       async insertEdgesBatch(params) {
+        session.assertOpen();
         await lockGraphs(params);
         await runInsertBatch(edgeDispatch, params);
         for (const edge of params) {
@@ -1351,6 +1379,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.insertEdgesBatchReturning === void 0 ? {} : {
       async insertEdgesBatchReturning(params) {
+        session.assertOpen();
         await lockGraphs(params);
         const rows = await runInsertBatchReturning(edgeDispatch, params);
         const rowsByIdentity = new Map(
@@ -1367,23 +1396,27 @@ function createRecordedTransactionBackend(target, session, schema) {
       }
     },
     async updateEdge(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       const row = await target.updateEdge(params);
       session.touchEdge(params.graphId, params.id, row);
       return row;
     },
     async deleteEdge(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       await target.deleteEdge(params);
       session.touchEdge(params.graphId, params.id);
     },
     async hardDeleteEdge(params) {
+      session.assertOpen();
       await lockGraph(params.graphId);
       await target.hardDeleteEdge(params);
       session.touchEdge(params.graphId, params.id);
     },
     ...target.deleteEdgesBatch === void 0 ? {} : {
       async deleteEdgesBatch(params) {
+        session.assertOpen();
         await lockGraph(params.graphId);
         await target.deleteEdgesBatch(params);
         for (const id of params.ids) {
@@ -1393,6 +1426,7 @@ function createRecordedTransactionBackend(target, session, schema) {
     },
     ...target.hardDeleteEdgesBatch === void 0 ? {} : {
       async hardDeleteEdgesBatch(params) {
+        session.assertOpen();
         await lockGraph(params.graphId);
         await target.hardDeleteEdgesBatch(params);
         for (const id of params.ids) {
@@ -1411,7 +1445,7 @@ function createRecordedTransactionScope(target, schema, ownsWriteLock = false) {
   return {
     backend: createRecordedTransactionBackend(target, session, resolvedSchema),
     async flush() {
-      return chunkBLZDPRXT_cjs.withRecordedRelationsPrecondition(
+      return chunk3GH67G4Z_cjs.withRecordedRelationsPrecondition(
         session.flush(target, resolvedSchema, ownsWriteLock),
         { dialect: target.dialect, surface: "capture-flush" }
       );
@@ -1431,7 +1465,7 @@ async function runCapturedAutocommit(backend, schema, fn, options) {
 function createRecordedBackend(backend, schema) {
   assertCapturableBackend(backend);
   const capture = (fn) => runCapturedAutocommit(backend, schema, fn);
-  return chunk4TOD4LBZ_cjs.createBackendOverlay(backend, {
+  return chunkIPSVVTWT_cjs.createBackendOverlay(backend, {
     ...rawWriteGuards(backend, "backend"),
     async insertNode(params) {
       return capture((target) => target.insertNode(params));
@@ -1514,8 +1548,9 @@ function createRecordedBackend(backend, schema) {
       const backendOptions = stripRecordedFlushObserver(options);
       assertRequestedRecordedIsolation(backend, backendOptions);
       return backend.transaction(async (target) => {
-        await assertRecordedCaptureTransactionIsolation(target);
-        const scope = createRecordedTransactionScope(target, schema, true);
+        await assertRecordedCaptureTransactionIsolation(target, backendOptions);
+        const readOnly = backendOptions?.accessMode === "read_only";
+        const scope = createRecordedTransactionScope(target, schema, !readOnly);
         const result = await fn(scope.backend, createHistoryUnsafeSqlRef());
         const instants = await scope.flush();
         observer?.(instants);
@@ -1537,7 +1572,7 @@ var embeddingFieldsCache = /* @__PURE__ */ new WeakMap();
 function getEmbeddingFields(schema) {
   const cached = embeddingFieldsCache.get(schema);
   if (cached) return cached;
-  const fields = chunkH7YNSMA7_cjs.resolveEmbeddingFields(schema);
+  const fields = chunkHAHNRASW_cjs.resolveEmbeddingFields(schema);
   embeddingFieldsCache.set(schema, fields);
   return fields;
 }
@@ -1666,10 +1701,10 @@ function isValidEmbeddingValue(value) {
 // src/store/fulltext-sync.ts
 var FIELD_SEPARATOR = "\n";
 function resolveCombinedLanguage(fields) {
-  return fields[0]?.metadata.language ?? chunkH7YNSMA7_cjs.DEFAULT_SEARCHABLE_LANGUAGE;
+  return fields[0]?.metadata.language ?? chunkHAHNRASW_cjs.DEFAULT_SEARCHABLE_LANGUAGE;
 }
 function computeFulltextContent(schema, props) {
-  const searchableFields = chunkH7YNSMA7_cjs.getSearchableFields(schema);
+  const searchableFields = chunkHAHNRASW_cjs.getSearchableFields(schema);
   if (searchableFields.length === 0) return void 0;
   const parts = [];
   for (const field of searchableFields) {
@@ -1700,7 +1735,7 @@ async function syncFulltext(ctx, schema, props) {
     });
     return;
   }
-  if (chunkH7YNSMA7_cjs.getSearchableFields(schema).length === 0) return;
+  if (chunkHAHNRASW_cjs.getSearchableFields(schema).length === 0) return;
   await backend.deleteFulltext({
     graphId: ctx.graphId,
     nodeKind: ctx.nodeKind,
@@ -1714,7 +1749,7 @@ async function syncFulltextBatchForKind(args, schema, items) {
   }
   const rows = [];
   const emptyContentIds = [];
-  const hasSearchableFields = chunkH7YNSMA7_cjs.getSearchableFields(schema).length > 0;
+  const hasSearchableFields = chunkHAHNRASW_cjs.getSearchableFields(schema).length > 0;
   for (const item of items) {
     const computed = computeFulltextContent(schema, item.props);
     if (computed !== void 0) {
@@ -1761,7 +1796,7 @@ async function deleteNodeFulltext(ctx, schema) {
   if (!backend.deleteFulltext) {
     return;
   }
-  if (chunkH7YNSMA7_cjs.getSearchableFields(schema).length === 0) {
+  if (chunkHAHNRASW_cjs.getSearchableFields(schema).length === 0) {
     return;
   }
   await backend.deleteFulltext({
@@ -1823,7 +1858,7 @@ function evaluatePredicate(predicate, props) {
   if (pred.op === "isNull") {
     return value === null || value === void 0;
   }
-  return chunk4TOD4LBZ_cjs.isPresent(value);
+  return chunkIPSVVTWT_cjs.isPresent(value);
 }
 function getKindsForUniquenessCheck(baseKind, scope, registry) {
   if (scope === "kind") {
@@ -1852,7 +1887,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
     }
     case "one": {
       if (existingEdgeCount > 0) {
-        return new chunkLGEALRC6_cjs.CardinalityError({
+        return new chunkBVRDGYXQ_cjs.CardinalityError({
           edgeKind,
           fromKind,
           fromId,
@@ -1867,7 +1902,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
     }
     case "oneActive": {
       if (hasActiveEdge) {
-        return new chunkLGEALRC6_cjs.CardinalityError({
+        return new chunkBVRDGYXQ_cjs.CardinalityError({
           edgeKind,
           fromKind,
           fromId,
@@ -1881,7 +1916,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
 }
 function checkUniqueEdge(edgeKind, fromKind, fromId, _toKind, _toId, existingCount) {
   if (existingCount > 0) {
-    return new chunkLGEALRC6_cjs.CardinalityError({
+    return new chunkBVRDGYXQ_cjs.CardinalityError({
       edgeKind,
       fromKind,
       fromId,
@@ -1894,7 +1929,7 @@ function checkUniqueEdge(edgeKind, fromKind, fromId, _toKind, _toId, existingCou
 function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registry) {
   const validFromKinds = registration.from.map((node) => node.kind);
   if (!registry.isAssignableToAny(fromKind, validFromKinds)) {
-    return new chunkLGEALRC6_cjs.EndpointError({
+    return new chunkBVRDGYXQ_cjs.EndpointError({
       edgeKind,
       endpoint: "from",
       actualKind: fromKind,
@@ -1903,7 +1938,7 @@ function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registr
   }
   const validToKinds = registration.to.map((node) => node.kind);
   if (!registry.isAssignableToAny(toKind, validToKinds)) {
-    return new chunkLGEALRC6_cjs.EndpointError({
+    return new chunkBVRDGYXQ_cjs.EndpointError({
       edgeKind,
       endpoint: "to",
       actualKind: toKind,
@@ -1915,7 +1950,7 @@ function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registr
 function checkDisjointness(nodeId, nodeKind, existingKinds, registry) {
   for (const existingKind of existingKinds) {
     if (registry.areDisjoint(nodeKind, existingKind)) {
-      return new chunkLGEALRC6_cjs.DisjointError({
+      return new chunkBVRDGYXQ_cjs.DisjointError({
         nodeId,
         attemptedKind: nodeKind,
         conflictingKind: existingKind
@@ -1952,7 +1987,7 @@ async function checkUniquenessConstraints(ctx, kind, id, props, constraints) {
         key
       });
       if (existing && existing.node_id !== id) {
-        throw new chunkLGEALRC6_cjs.UniquenessError({
+        throw new chunkBVRDGYXQ_cjs.UniquenessError({
           constraintName: constraint.name,
           kind: kindToCheck,
           existingId: existing.node_id,
@@ -2058,7 +2093,7 @@ async function updateUniquenessEntries(ctx, kind, id, oldProps, newProps, constr
           key: newKey
         });
         if (existing && existing.node_id !== id) {
-          throw new chunkLGEALRC6_cjs.UniquenessError({
+          throw new chunkBVRDGYXQ_cjs.UniquenessError({
             constraintName: constraint.name,
             kind: kindToCheck,
             existingId: existing.node_id,
@@ -2115,7 +2150,7 @@ async function enforceNodeDeleteBehavior(ctx, args, backend, policy) {
   if (connectedEdges.length === 0) return;
   switch (behavior) {
     case "restrict": {
-      throw new chunkLGEALRC6_cjs.RestrictedDeleteError({
+      throw new chunkBVRDGYXQ_cjs.RestrictedDeleteError({
         nodeKind: args.kind,
         nodeId: args.id,
         edgeCount: connectedEdges.length,
@@ -2188,7 +2223,7 @@ async function applyNodeInsertSideEffectsBatch(ctx, items, backend) {
   );
 }
 function parseRowProps(row) {
-  return chunk4TOD4LBZ_cjs.rowPropsToObject(row.props);
+  return chunkIPSVVTWT_cjs.rowPropsToObject(row.props);
 }
 async function applyNodeUpdate(ctx, args, backend) {
   const { kind, id } = args.existing;
@@ -2379,5 +2414,5 @@ exports.validateEdgeEndpoints = validateEdgeEndpoints;
 exports.vectorSlotKey = vectorSlotKey;
 exports.withRecordedCoordinate = withRecordedCoordinate;
 exports.withRecordedFlushObserver = withRecordedFlushObserver;
-//# sourceMappingURL=chunk-XOX22WHL.cjs.map
-//# sourceMappingURL=chunk-XOX22WHL.cjs.map
+//# sourceMappingURL=chunk-WOJMKB3N.cjs.map
+//# sourceMappingURL=chunk-WOJMKB3N.cjs.map