@nicia-ai/typegraph 0.65.0 → 0.66.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @nicia-ai/typegraph
 
+## 0.66.1
+
+### Highlights
+
+TypeGraph 0.66.1 fixes store-opening failures when upgrading older SQLite or PostgreSQL databases that never received the recorded-node and recorded-edge tables. Base-schema adoption now creates the missing tables and indexes while preserving existing graph data and custom table names, including when recorded history is not enabled.
+
+### Upgrade notes
+
+- If an earlier upgrade failed with a missing recorded-table error, deploy 0.66.1 and retry your normal privileged store-open or `backend.adoptBaseSchema()` path. Adoption resumes from the installed marker, including databases left at base-schema version 2.
+- After upgrading and verifying successful adoption, remove any extra `bootstrapTables()` call added specifically to work around this failure. Keep bootstrap calls required by your normal provisioning workflow; runtime-only, least-privilege store opening still does not perform adoption.
+- Roll affected deployments forward. Do not roll back to 0.56.0 after the base-schema marker has advanced beyond version 1: that release refuses the newer marker.
+
+### Patch Changes
+
+- [#724](https://github.com/nicia-ai/typegraph/pull/724) [`e3ebddd`](https://github.com/nicia-ai/typegraph/commit/e3ebddda8f37833255dcdd75cd38b5f24a02c2e5) Thanks [@pdlug](https://github.com/pdlug)! - Fix upgrades from legacy databases that lack recorded-node or recorded-edge tables. Version-3 base-schema adoption now creates these tables and their structural indexes before installing changed-since indexes on SQLite and PostgreSQL, preserving existing data and custom table names. Failed upgrades left at base-schema version 2 can retry through normal adoption without an explicit `bootstrapTables()` workaround.
+
+## 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 chunkMN325MG4_cjs = require('../../../chunk-MN325MG4.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 chunkMN325MG4_cjs.DERIVABLE_ENGINE_PROFILE_KEYS; }
 });
 Object.defineProperty(exports, "buildPostgresEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.buildPostgresEngineProfile; }
+  get: function () { return chunkMN325MG4_cjs.buildPostgresEngineProfile; }
 });
 Object.defineProperty(exports, "buildSqliteEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.buildSqliteEngineProfile; }
+  get: function () { return chunkMN325MG4_cjs.buildSqliteEngineProfile; }
 });
 Object.defineProperty(exports, "createSqlBackend", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.createSqlBackend; }
+  get: function () { return chunkMN325MG4_cjs.createSqlBackend; }
 });
 Object.defineProperty(exports, "deriveEngineProfile", {
   enumerable: true,
-  get: function () { return chunk3KWF25MF_cjs.deriveEngineProfile; }
+  get: function () { return chunkMN325MG4_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-DppApFgt.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-DppApFgt.cjs';
+export { b as buildPostgresEngineProfile } from '../../../postgres-Dp3MpyJt.cjs';
+export { b as buildSqliteEngineProfile } from '../../../sqlite-BpRtjC36.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-Ch5SSewK.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-Ch5SSewK.js';
+export { b as buildPostgresEngineProfile } from '../../../postgres-BbTYW3b_.js';
+export { b as buildSqliteEngineProfile } from '../../../sqlite-CH0Zq0Qv.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-2DJKHZQ4.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[];