@nicia-ai/typegraph 0.65.0 → 0.66.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @nicia-ai/typegraph
 
+## 0.66.0
+
+### Highlights
+
+TypeGraph 0.66 adds `tx.writeNodeUpsertBatch()` for recorded PostgreSQL transactions. Submit caller-assigned IDs spanning multiple plain node kinds and receive ordered postimages from one statement, while inserts, live updates, resurrections, history capture, and receipt counts remain atomic. The narrow envelope is designed for latency-sensitive heterogeneous node ingestion and preserves the existing per-entity pipeline for constrained writes.
+
+Recorded transactions also lease their schema-fence evidence across managed writes and capture flushes. Reusing that evidence removes repeated fence probes from history-enabled adopted transaction loops while retaining conservative per-write fencing for non-history adopted transactions.
+
+### Upgrade notes
+
+- Use `tx.writeNodeUpsertBatch(entries)` only inside a recorded PostgreSQL transaction. The batch supports plain node kinds with caller-assigned IDs; it refuses operational-identity graphs, unique or disjointness claims, search or embedding projections, temporal options, unchanged-upsert coalescing, duplicate `(kind, id)` entries, stale schema fences, oversized batches, and unsupported backends. Split oversized inputs before retrying.
+- Custom backends may implement the optional exact-session heterogeneous upsert capability to support this method. Backends that omit it retain the existing portable write paths, and `tx.writeNodeUpsertBatch()` refuses with a typed unsupported-capability error.
+
+### Minor Changes
+
+- [#722](https://github.com/nicia-ai/typegraph/pull/722) [`8ad6da1`](https://github.com/nicia-ai/typegraph/commit/8ad6da18fb352a7f593f0092f006e47b21ed7709) Thanks [@pdlug](https://github.com/pdlug)! - Add `tx.writeNodeUpsertBatch()` for one-statement, caller-ID upserts across plain node kinds inside a recorded PostgreSQL transaction.
+
 ## 0.65.0
 
 ### Highlights

package/dist/{atomic-mutation-program-BznZQ06C.d.ts → atomic-mutation-program-BhP75Qn0.d.ts}

@@ -1,4 +1,4 @@
-import { g as GraphBackend, T as TransactionBackend, j as InsertNodeParams, N as NodeInsertClaim, k as NodeInsertProjection, l as SchemaWriteFenceParams, m as InsertEdgeParams, E as EdgeConvergenceMatch, n as EdgeRow, o as ClaimEdgeCardinalityParams, p as NodeRow } from './types-CRCyg1fJ.js';
+import { g as GraphBackend, T as TransactionBackend, j as InsertNodeParams, N as NodeInsertClaim, k as NodeInsertProjection, l as SchemaWriteFenceParams, m as InsertEdgeParams, E as EdgeConvergenceMatch, n as EdgeRow, o as ClaimEdgeCardinalityParams, p as NodeRow } from './types-BynPp5kU.js';
 
 type AtomicSqlRow = Readonly<Record<string, unknown>>;
 /** A transport-ready statement in the portable atomic-program protocol. */

package/dist/{atomic-mutation-program-Bfu5z-je.d.cts → atomic-mutation-program-DMdmc4s0.d.cts}

@@ -1,4 +1,4 @@
-import { g as GraphBackend, T as TransactionBackend, j as InsertNodeParams, N as NodeInsertClaim, k as NodeInsertProjection, l as SchemaWriteFenceParams, m as InsertEdgeParams, E as EdgeConvergenceMatch, n as EdgeRow, o as ClaimEdgeCardinalityParams, p as NodeRow } from './types-CRCyg1fJ.cjs';
+import { g as GraphBackend, T as TransactionBackend, j as InsertNodeParams, N as NodeInsertClaim, k as NodeInsertProjection, l as SchemaWriteFenceParams, m as InsertEdgeParams, E as EdgeConvergenceMatch, n as EdgeRow, o as ClaimEdgeCardinalityParams, p as NodeRow } from './types-BynPp5kU.cjs';
 
 type AtomicSqlRow = Readonly<Record<string, unknown>>;
 /** A transport-ready statement in the portable atomic-program protocol. */

package/dist/backend/drizzle/engine/index.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunk3KWF25MF_cjs = require('../../../chunk-3KWF25MF.cjs');
+var chunkXQNKN3UF_cjs = require('../../../chunk-XQNKN3UF.cjs');
 require('../../../chunk-DCYIUKIM.cjs');
 require('../../../chunk-FZKXBPTS.cjs');
-require('../../../chunk-DSX3P4S5.cjs');
-require('../../../chunk-BNTJ5YFO.cjs');
-require('../../../chunk-MKJPBSID.cjs');
-require('../../../chunk-ZOWRACZQ.cjs');
-require('../../../chunk-KDNRACRG.cjs');
+require('../../../chunk-76OB5RSH.cjs');
+require('../../../chunk-EACDHXJL.cjs');
+require('../../../chunk-I7SBZJI2.cjs');
+require('../../../chunk-G7OKJDMG.cjs');
+require('../../../chunk-MRUOOAIQ.cjs');
 require('../../../chunk-6YKISECL.cjs');
-require('../../../chunk-JRWKRBI5.cjs');
-require('../../../chunk-OC5ROP7V.cjs');
+require('../../../chunk-5JOCIMQ3.cjs');
+require('../../../chunk-6JRVV2SS.cjs');
 require('../../../chunk-5ICDVLI3.cjs');
 require('../../../chunk-L4L4AV6F.cjs');
 require('../../../chunk-AHUN2DLL.cjs');
@@ -34,23 +34,23 @@ require('../../../chunk-7XYPLAPL.cjs');
 
 Object.defineProperty(exports, "DERIVABLE_ENGINE_PROFILE_KEYS", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.DERIVABLE_ENGINE_PROFILE_KEYS; }
+  get: function () { return chunkXQNKN3UF_cjs.DERIVABLE_ENGINE_PROFILE_KEYS; }
 });
 Object.defineProperty(exports, "buildPostgresEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.buildPostgresEngineProfile; }
+  get: function () { return chunkXQNKN3UF_cjs.buildPostgresEngineProfile; }
 });
 Object.defineProperty(exports, "buildSqliteEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.buildSqliteEngineProfile; }
+  get: function () { return chunkXQNKN3UF_cjs.buildSqliteEngineProfile; }
 });
 Object.defineProperty(exports, "createSqlBackend", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.createSqlBackend; }
+  get: function () { return chunkXQNKN3UF_cjs.createSqlBackend; }
 });
 Object.defineProperty(exports, "deriveEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.deriveEngineProfile; }
+  get: function () { return chunkXQNKN3UF_cjs.deriveEngineProfile; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/backend/drizzle/engine/index.d.cts

@@ -1,19 +1,19 @@
-import { A as AdapterBackend, F as FenceSql } from '../../../types-CRCyg1fJ.cjs';
-export { h as AdoptedSchemaWriteTransaction, i as FenceStatements, S as SchemaProvisioning, W as WriteFencePlan } from '../../../types-CRCyg1fJ.cjs';
-import { a as SqlEngineProfile } from '../../../profile-Bmcg07Ki.cjs';
-export { B as BackendResourceAudit, b as BaseSchemaRuntime, C as ContributionRuntime, E as EngineAssembly, c as EngineProvisioning, d as EngineTableNames, G as GraphTemplateRuntime, I as IdentityRuntime, e as IndexMaterializationRuntime, K as KindRemovalRuntime } from '../../../profile-Bmcg07Ki.cjs';
-export { b as buildPostgresEngineProfile } from '../../../postgres-2FYdVYCm.cjs';
-export { b as buildSqliteEngineProfile } from '../../../sqlite-Co_uIpfs.cjs';
+import { A as AdapterBackend, F as FenceSql } from '../../../types-BynPp5kU.cjs';
+export { h as AdoptedSchemaWriteTransaction, i as FenceStatements, S as SchemaProvisioning, W as WriteFencePlan } from '../../../types-BynPp5kU.cjs';
+import { a as SqlEngineProfile } from '../../../profile-CjAffcQt.cjs';
+export { B as BackendResourceAudit, b as BaseSchemaRuntime, C as ContributionRuntime, E as EngineAssembly, c as EngineProvisioning, d as EngineTableNames, G as GraphTemplateRuntime, I as IdentityRuntime, e as IndexMaterializationRuntime, K as KindRemovalRuntime } from '../../../profile-CjAffcQt.cjs';
+export { b as buildPostgresEngineProfile } from '../../../postgres-BIm6TDfF.cjs';
+export { b as buildSqliteEngineProfile } from '../../../sqlite-DX9H3L7z.cjs';
 import 'zod';
 import 'drizzle-orm';
-import '../../../atomic-mutation-program-Bfu5z-je.cjs';
-import '../../../postgres-BONrXHb4.cjs';
+import '../../../atomic-mutation-program-DMdmc4s0.cjs';
+import '../../../postgres-DOBXcZVg.cjs';
 import 'drizzle-orm/pg-core';
 import '../../../postgres-execution-fKW0qRiN.cjs';
 import 'drizzle-orm/relations';
 import '../../../sqlite-execution-DHenxnsc.cjs';
 import 'drizzle-orm/sqlite-core';
-import '../../../sqlite-DgbYa-1Y.cjs';
+import '../../../sqlite-BkQM9ZeI.cjs';
 
 /**
  * Assembles one `AdapterBackend` from a {@link SqlEngineProfile}.

package/dist/backend/drizzle/engine/index.d.ts

@@ -1,19 +1,19 @@
-import { A as AdapterBackend, F as FenceSql } from '../../../types-CRCyg1fJ.js';
-export { h as AdoptedSchemaWriteTransaction, i as FenceStatements, S as SchemaProvisioning, W as WriteFencePlan } from '../../../types-CRCyg1fJ.js';
-import { a as SqlEngineProfile } from '../../../profile-CAD65CqS.js';
-export { B as BackendResourceAudit, b as BaseSchemaRuntime, C as ContributionRuntime, E as EngineAssembly, c as EngineProvisioning, d as EngineTableNames, G as GraphTemplateRuntime, I as IdentityRuntime, e as IndexMaterializationRuntime, K as KindRemovalRuntime } from '../../../profile-CAD65CqS.js';
-export { b as buildPostgresEngineProfile } from '../../../postgres-C9gitL71.js';
-export { b as buildSqliteEngineProfile } from '../../../sqlite-DcDAAYow.js';
+import { A as AdapterBackend, F as FenceSql } from '../../../types-BynPp5kU.js';
+export { h as AdoptedSchemaWriteTransaction, i as FenceStatements, S as SchemaProvisioning, W as WriteFencePlan } from '../../../types-BynPp5kU.js';
+import { a as SqlEngineProfile } from '../../../profile-DVd70NA-.js';
+export { B as BackendResourceAudit, b as BaseSchemaRuntime, C as ContributionRuntime, E as EngineAssembly, c as EngineProvisioning, d as EngineTableNames, G as GraphTemplateRuntime, I as IdentityRuntime, e as IndexMaterializationRuntime, K as KindRemovalRuntime } from '../../../profile-DVd70NA-.js';
+export { b as buildPostgresEngineProfile } from '../../../postgres-CRRB2qzy.js';
+export { b as buildSqliteEngineProfile } from '../../../sqlite-BNwQ5pd7.js';
 import 'zod';
 import 'drizzle-orm';
-import '../../../atomic-mutation-program-BznZQ06C.js';
-import '../../../postgres-DAFRdnTr.js';
+import '../../../atomic-mutation-program-BhP75Qn0.js';
+import '../../../postgres-DhZixg92.js';
 import 'drizzle-orm/pg-core';
 import '../../../postgres-execution-fKW0qRiN.js';
 import 'drizzle-orm/relations';
 import '../../../sqlite-execution-DHenxnsc.js';
 import 'drizzle-orm/sqlite-core';
-import '../../../sqlite-UlG5prJQ.js';
+import '../../../sqlite-CcCSeXGg.js';
 
 /**
  * Assembles one `AdapterBackend` from a {@link SqlEngineProfile}.

package/dist/backend/drizzle/engine/index.js

@@ -1,14 +1,14 @@
-export { DERIVABLE_ENGINE_PROFILE_KEYS, buildPostgresEngineProfile, buildSqliteEngineProfile, createSqlBackend, deriveEngineProfile } from '../../../chunk-PFXNQFFY.js';
+export { DERIVABLE_ENGINE_PROFILE_KEYS, buildPostgresEngineProfile, buildSqliteEngineProfile, createSqlBackend, deriveEngineProfile } from '../../../chunk-MUEPEWMQ.js';
 import '../../../chunk-DX6DIU2S.js';
 import '../../../chunk-D2DMFIH2.js';
-import '../../../chunk-HTSJTWUT.js';
-import '../../../chunk-BBOMNH44.js';
-import '../../../chunk-RQPCUHIH.js';
-import '../../../chunk-G6T23JU7.js';
-import '../../../chunk-WTMSUIRO.js';
+import '../../../chunk-OF63ZHSD.js';
+import '../../../chunk-BABP4D5B.js';
+import '../../../chunk-6ECNYQDW.js';
+import '../../../chunk-CDKNGCE7.js';
+import '../../../chunk-UFKYMQJ5.js';
 import '../../../chunk-RFMSZ7CF.js';
-import '../../../chunk-4VTCIEK3.js';
-import '../../../chunk-AD3NLSV5.js';
+import '../../../chunk-4TQOIBWH.js';
+import '../../../chunk-TU22BFMP.js';
 import '../../../chunk-OXJNL2PW.js';
 import '../../../chunk-CY657YYY.js';
 import '../../../chunk-5PP537D7.js';

package/dist/backend/drizzle/indexes.d.cts

@@ -1,7 +1,7 @@
 import { SQLWrapper } from 'drizzle-orm';
 import { IndexBuilder } from 'drizzle-orm/pg-core';
 import { IndexBuilder as IndexBuilder$1 } from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from '../../types-CRCyg1fJ.cjs';
+import { I as IndexDeclaration } from '../../types-BynPp5kU.cjs';
 import 'zod';
 
 declare function buildPostgresNodeIndexBuilders(table: NodeIndexTable, indexes: readonly IndexDeclaration[]): readonly IndexBuilder[];

package/dist/backend/drizzle/indexes.d.ts

@@ -1,7 +1,7 @@
 import { SQLWrapper } from 'drizzle-orm';
 import { IndexBuilder } from 'drizzle-orm/pg-core';
 import { IndexBuilder as IndexBuilder$1 } from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from '../../types-CRCyg1fJ.js';
+import { I as IndexDeclaration } from '../../types-BynPp5kU.js';
 import 'zod';
 
 declare function buildPostgresNodeIndexBuilders(table: NodeIndexTable, indexes: readonly IndexDeclaration[]): readonly IndexBuilder[];