@nicia-ai/typegraph 0.67.1 → 0.68.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @nicia-ai/typegraph
 
+## 0.68.1
+
+### Patch Changes
+
+- [#735](https://github.com/nicia-ai/typegraph/pull/735) [`149db17`](https://github.com/nicia-ai/typegraph/commit/149db17e9042ee461908b9677f7c6c5c7f7bcbd6) Thanks [@pdlug](https://github.com/pdlug)! - `cloneWorkingCopyStrategy` now imports with `onUnknownProperty: "allow"`, so a working copy — and therefore `branch()`, `ingestionBranch()`, and `planCandidateWriteSet()` — can be seeded from live rows that carry undeclared properties `validateStore()` already reports as healthy. Incoming candidate write-set documents remain strict. A streamed interchange abort now names the failing entity and property in the thrown message instead of wrapping only a generic abort.
+
+- [#737](https://github.com/nicia-ai/typegraph/pull/737) [`3428764`](https://github.com/nicia-ai/typegraph/commit/34287643aa708ed53caf56c8216c50042aef6441) Thanks [@pdlug](https://github.com/pdlug)! - `compareAndSet()` and `updateWhere()` no longer throw an untyped Zod error on node kinds whose schema has object-level refinements. Early field checks reconstruct a partial schema from `.shape` so refinements stay on the complete after-image, the same document `update()` already validates.
+
+## 0.68.0
+
+### Highlights
+
+TypeGraph 0.68 adds atomic operations to durable graph-merge branches. `operateDurableBranch()` lets a durable host commit an opaque graph mutation and immutable evidence in one host transaction, so a process can recover and deliver committed work after a crash without inventing a second coordination protocol. Canonical request digests make retries exact: the same idempotency key replays its evidence, while a changed mutation or metadata payload conflicts without another write.
+
+The new evidence lifecycle is inspectable and bounded. Applications can read or page committed evidence, mark delivery monotonically, and ask whether any evidence remains undelivered. TypeGraph validates every host-returned outcome and preserves a typed destruction fence until downstream delivery is complete; unsupported hosts execute no mutation, and existing durable strategies remain valid without the optional capability.
+
+### Upgrade notes
+
+- Existing `DurableWorkingCopyStrategy` implementations require no changes unless they opt into `operations`. To opt in, commit the host mutation and its immutable evidence in one transaction, attest the descriptor's sealed origin, enforce exact idempotency replay and digest conflicts, and serialize operations against destruction.
+- Treat only `applied` and `replayed` outcomes from `operateDurableBranch()` as committed. An `unsupported` outcome guarantees that the host ran no mutation SQL; do not recreate the atomic guarantee with callbacks or a separate evidence write.
+- Deliver committed evidence with `scanDurableOperations()` or `getDurableOperation()`, then call `markDurableOperationDelivered()` only after the downstream transaction commits. A first application must remain undelivered, and `destroyDurableBranch()` refuses while any evidence is undelivered.
+
+### Minor Changes
+
+- [#731](https://github.com/nicia-ai/typegraph/pull/731) [`f8e800b`](https://github.com/nicia-ai/typegraph/commit/f8e800bca25f7168747624d1ab4dea525ec736c0) Thanks [@pdlug](https://github.com/pdlug)! - Add atomic durable-branch operations. A `DurableWorkingCopyStrategy` may now expose an optional `operations` capability that commits an opaque host mutation and its immutable evidence in one host transaction, keyed by idempotency. New public orchestrators `operateDurableBranch()`, `getDurableOperation()`, `scanDurableOperations()`, `markDurableOperationDelivered()`, and `durableBranchHasUndeliveredEvidence()` wrap it, with typed `DurableOperationError` subclasses for conflicts, unsupported capabilities, malformed evidence, and the undelivered-evidence destroy fence.
+
 ## 0.67.1
 
 ### Patch Changes

package/dist/backend/postgres/pglite-store.cjs

@@ -7,7 +7,7 @@ require('../../chunk-7XYPLAPL.cjs');
 async function createLocalPgliteStore(graph, options = {}) {
   const impl = await chunkMUKIEXH5_cjs.loadDrizzleBackedModule(
     "./postgres/pglite",
-    () => import('../../pglite-store-impl-HAPAJUIO.cjs')
+    () => import('../../pglite-store-impl-KDS4NRMC.cjs')
   );
   return impl.createLocalPgliteStoreImpl(graph, options);
 }

package/dist/backend/postgres/pglite-store.js

@@ -5,7 +5,7 @@ import '../../chunk-GMKPIYHY.js';
 async function createLocalPgliteStore(graph, options = {}) {
   const impl = await loadDrizzleBackedModule(
     "./postgres/pglite",
-    () => import('../../pglite-store-impl-HDLFOZWS.js')
+    () => import('../../pglite-store-impl-LJDF2EUF.js')
   );
   return impl.createLocalPgliteStoreImpl(graph, options);
 }

package/dist/backend/sqlite/local-store.cjs

@@ -8,7 +8,7 @@ require('../../chunk-7XYPLAPL.cjs');
 async function createLocalSqliteStore(graph, options = {}) {
   const impl = await chunkMUKIEXH5_cjs.loadDrizzleBackedModule(
     "./sqlite/local",
-    () => import('../../local-store-impl-GI6S4J6B.cjs')
+    () => import('../../local-store-impl-INNRHDK3.cjs')
   );
   return impl.createLocalSqliteStoreImpl(graph, options);
 }

package/dist/backend/sqlite/local-store.js

@@ -6,7 +6,7 @@ import '../../chunk-GMKPIYHY.js';
 async function createLocalSqliteStore(graph, options = {}) {
   const impl = await loadDrizzleBackedModule(
     "./sqlite/local",
-    () => import('../../local-store-impl-CCMWTLGY.js')
+    () => import('../../local-store-impl-VGC3OKCA.js')
   );
   return impl.createLocalSqliteStoreImpl(graph, options);
 }

package/dist/{chunk-T3VU3YRQ.cjs → chunk-6GUBF5TF.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkWY3IFEKV_cjs = require('./chunk-WY3IFEKV.cjs');
+var chunkIFTYHOEE_cjs = require('./chunk-IFTYHOEE.cjs');
 var chunkVNJMM2QQ_cjs = require('./chunk-VNJMM2QQ.cjs');
 var chunkG7OKJDMG_cjs = require('./chunk-G7OKJDMG.cjs');
 var chunkEBQX7MYL_cjs = require('./chunk-EBQX7MYL.cjs');
@@ -372,7 +372,7 @@ async function importGraphData(store, data, options) {
   const batchPointRead = chunk7LQTDGV5_cjs.batchPointReadVerdict(backend);
   const uniqueSidecarBatch = chunk7LQTDGV5_cjs.uniqueSidecarBatchVerdict(backend);
   const statementExecution = chunk7LQTDGV5_cjs.statementExecutionVerdict(backend);
-  const owedClaimReason = chunkWY3IFEKV_cjs.graphOwesClaims(graph, registry);
+  const owedClaimReason = chunkIFTYHOEE_cjs.graphOwesClaims(graph, registry);
   const claimRefusal = owedClaimReason === void 0 ? void 0 : chunk6B3LQUYG_cjs.constraintFenceRefusal({ graphId }, backend, owedClaimReason);
   if (claimRefusal !== void 0) throw claimRefusal;
   const nodeSchemas = buildNodeSchemaMap(graph);
@@ -396,7 +396,7 @@ async function importGraphData(store, data, options) {
     uniqueSidecarBatch,
     statementExecution
   };
-  const { result, errors } = await chunkWY3IFEKV_cjs.runWritePlan(
+  const { result, errors } = await chunkIFTYHOEE_cjs.runWritePlan(
     {
       graphId,
       registry,
@@ -424,7 +424,7 @@ 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.
-    chunkWY3IFEKV_cjs.mixedWritePlan(void 0, true),
+    chunkIFTYHOEE_cjs.mixedWritePlan(void 0, true),
     backend,
     (session, target, overlaidSession, _lock, transactionMode) => runImportWritePlanAttempt(
       attemptInputs,
@@ -618,12 +618,17 @@ function serializedStreamRefusalText(requested, heldBy) {
     suggestion: "Await the import already in flight before starting the next one, or import into an independent backend."
   };
 }
+function summarizeImportErrors(errors) {
+  return errors.map(
+    (entry) => `${entry.entityType} ${entry.kind} ${entry.id}: ${entry.error}`
+  ).join("; ");
+}
 function throwIfStreamChunkFailed(result, options) {
   if (options.onStreamChunkError === "continue" || result.errors.length === 0) {
     return;
   }
   throw new Error(
-    'Graph interchange stream aborted after a chunk reported import errors. Earlier chunks remain committed; use onStreamChunkError: "continue" for best-effort ingestion.'
+    `Graph interchange stream aborted after a chunk reported import errors. Reported errors: ${summarizeImportErrors(result.errors)}. Earlier chunks remain committed; use onStreamChunkError: "continue" for best-effort ingestion.`
   );
 }
 function assertIdentityImportSupported(store, hasIdentitySection) {
@@ -935,8 +940,8 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
     registerAppliedNodeUpdate,
     seedNodeRow,
     seedUniqueRow
-  } = chunkWY3IFEKV_cjs.createNodeBatchValidationSeams(graphId, registry, frame.target);
-  await chunkWY3IFEKV_cjs.primeBatchValidationCaches(
+  } = chunkIFTYHOEE_cjs.createNodeBatchValidationSeams(graphId, registry, frame.target);
+  await chunkIFTYHOEE_cjs.primeBatchValidationCaches(
     {
       graphId,
       registry,
@@ -1019,7 +1024,7 @@ async function processNodeSlice(frame, graphId, registry, batch, schemas, option
         props,
         uniqueConstraints
       );
-      await chunkWY3IFEKV_cjs.checkDisjointnessConstraint(
+      await chunkIFTYHOEE_cjs.checkDisjointnessConstraint(
         { graphId, registry, backend: validationBackend },
         node.kind,
         node.id
@@ -1221,7 +1226,7 @@ async function updateImportedEdge(session, edge, props, windowFence) {
   }
 }
 function importedEdgeIdentityUpdateError(registration, edge, existing, props) {
-  return chunkWY3IFEKV_cjs.edgeMatchIdentityUpdateRefusal({
+  return chunkIFTYHOEE_cjs.edgeMatchIdentityUpdateRefusal({
     identity: registration.matchIdentity,
     kind: edge.kind,
     id: edge.id,
@@ -1346,7 +1351,7 @@ async function processNode(frame, graphId, registry, node, schemas, options) {
       propsResult.data,
       uniqueConstraints
     );
-    await chunkWY3IFEKV_cjs.checkDisjointnessConstraint(
+    await chunkIFTYHOEE_cjs.checkDisjointnessConstraint(
       { graphId, registry, backend: frame.target },
       node.kind,
       node.id
@@ -1413,7 +1418,7 @@ function recordEdgeOutcome(edge, outcome, result, errors) {
 }
 function prepareEdgeImportCreate(graphId, candidate, registration) {
   const { edge, props } = candidate;
-  const matchIdentity = chunkWY3IFEKV_cjs.resolveEdgeMatchIdentityStorage(
+  const matchIdentity = chunkIFTYHOEE_cjs.resolveEdgeMatchIdentityStorage(
     registration.matchIdentity,
     {
       fromKind: edge.from.kind,
@@ -1551,7 +1556,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
     backend: cardinalityValidationBackend,
     registerPendingEdgeForCardinality,
     seedCardinalityRows
-  } = chunkWY3IFEKV_cjs.createEdgeBatchValidationBackend(frame.target);
+  } = chunkIFTYHOEE_cjs.createEdgeBatchValidationBackend(frame.target);
   const candidates = [];
   const deferred = [];
   const seenIds = /* @__PURE__ */ new Set();
@@ -1840,7 +1845,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
     const { candidate, params, cardinality } = prepared;
     const { edge } = candidate;
     const cardinalityResult = await catchDeclaredConstraintRefusal(
-      () => chunkWY3IFEKV_cjs.checkCardinalityConstraint(
+      () => chunkIFTYHOEE_cjs.checkCardinalityConstraint(
         { graphId, registry, backend: cardinalityValidationBackend },
         edge.kind,
         cardinality,
@@ -1908,7 +1913,7 @@ async function processEdgeSlice(frame, graphId, registry, batch, edgeSchemas, no
       const rows = await chunkBXHAPCQG_cjs.requireDefined(frame.session.createEdgesDurable)(
         acceptedWork
       );
-      const outcomes = chunkWY3IFEKV_cjs.classifyDurableEdgeBatchOutcomes(
+      const outcomes = chunkIFTYHOEE_cjs.classifyDurableEdgeBatchOutcomes(
         accepted.map((prepared) => prepared.params),
         rows
       );
@@ -2105,7 +2110,7 @@ async function processEdge(frame, graphId, registry, edge, edgeSchemas, nodeSche
   }
   const { cardinality, params } = preparation.value;
   const cardinalityResult = await catchDeclaredConstraintRefusal(
-    () => chunkWY3IFEKV_cjs.checkCardinalityConstraint(
+    () => chunkIFTYHOEE_cjs.checkCardinalityConstraint(
       { graphId, registry, backend: frame.target },
       edge.kind,
       cardinality,
@@ -2767,7 +2772,7 @@ function nodeParams(graphId, node) {
   };
 }
 function edgeParams(graphId, edge, registration) {
-  const matchIdentity = chunkWY3IFEKV_cjs.resolveEdgeMatchIdentityStorage(
+  const matchIdentity = chunkIFTYHOEE_cjs.resolveEdgeMatchIdentityStorage(
     registration.matchIdentity,
     {
       fromKind: edge.from.kind,
@@ -3004,7 +3009,8 @@ exports.exportGraphStream = exportGraphStream;
 exports.importGraph = importGraph;
 exports.importGraphStream = importGraphStream;
 exports.registerIngestionImportTarget = registerIngestionImportTarget;
+exports.summarizeImportErrors = summarizeImportErrors;
 exports.trustedImportGraph = trustedImportGraph;
 exports.trustedImportGraphStream = trustedImportGraphStream;
-//# sourceMappingURL=chunk-T3VU3YRQ.cjs.map
-//# sourceMappingURL=chunk-T3VU3YRQ.cjs.map
+//# sourceMappingURL=chunk-6GUBF5TF.cjs.map
+//# sourceMappingURL=chunk-6GUBF5TF.cjs.map