@nicia-ai/typegraph 0.42.1 → 0.44.0

package/dist/graph-merge/index.js

@@ -1,38 +1,38 @@
-import { createStoreWithSchema } from '../chunk-DP7KC6CL.js';
-import '../chunk-CVNGKTHO.js';
-import { importGraphStream, exportGraphStream } from '../chunk-WYQILW5V.js';
-import '../chunk-6NB73BXV.js';
-import { storeBackend, generateId, computeUniqueKey, transactionBackend, lockRecordedGraphWrite, readRevisionOrigin, readRecordedClock } from '../chunk-EVFL2ZY5.js';
+import { createStoreWithSchema } from '../chunk-BCP7LLOY.js';
+import '../chunk-PHXITZE4.js';
+import { importGraphStream, exportGraphStream } from '../chunk-VITTKBWF.js';
+import '../chunk-SBPC5IP3.js';
+import { storeBackend, generateId, computeUniqueKey, transactionBackend, lockRecordedGraphWrite, readRevisionOrigin, readRecordedClock } from '../chunk-FSXTPBRN.js';
 import '../chunk-35S6P5ZU.js';
-import '../chunk-CDYRPI5U.js';
-import '../chunk-UZLEQFTV.js';
-import '../chunk-2OOY4OYT.js';
-import { computeSchemaHash, serializeSchema } from '../chunk-RAWG2FEU.js';
+import '../chunk-MIJKEVV7.js';
+import '../chunk-FMMIX6N4.js';
+import '../chunk-2L54C2C2.js';
+import { computeSchemaHash, serializeSchema } from '../chunk-BEFM74L2.js';
 import { compareStrings } from '../chunk-DRACN6XG.js';
-import { defineNode } from '../chunk-2HKIID5K.js';
-import '../chunk-O3USVVWS.js';
+import { defineNode } from '../chunk-2Y4IFKW7.js';
+import '../chunk-DK2S42XB.js';
 import { sortedReplacer } from '../chunk-UR7W5YQK.js';
-import '../chunk-CUPJL6TS.js';
-import { getNodeKinds, getEdgeKinds, defineGraph } from '../chunk-3V6D5DEC.js';
-import '../chunk-GT7NEXSU.js';
-import '../chunk-2G6ZEGYO.js';
-import '../chunk-4XRP2N6B.js';
-import '../chunk-ZP2KPDNN.js';
+import '../chunk-B75XRV3O.js';
+import { getNodeKinds, getEdgeKinds, defineGraph } from '../chunk-S4KQ5LV4.js';
+import '../chunk-KCO5EFJU.js';
+import '../chunk-46GDII45.js';
+import '../chunk-JRP3VGHS.js';
+import '../chunk-TFMVL4QH.js';
 import { sha256Hex } from '../chunk-K34OPSJK.js';
 import '../chunk-2EBMPJBO.js';
-import '../chunk-42XYPKZU.js';
-import '../chunk-M4GYQF2H.js';
+import '../chunk-K3BUWSFR.js';
+import '../chunk-6DCB664D.js';
 import '../chunk-D7PG5D5K.js';
 import '../chunk-SNXVDZAJ.js';
 import { requireDefined } from '../chunk-QMQLUA66.js';
 import '../chunk-PC2UBAUB.js';
-import { ok, err, isErr, computeTransitiveClosure, isReachable } from '../chunk-EQOQOT55.js';
-export { isErr, isOk, unwrap } from '../chunk-EQOQOT55.js';
+import { ok, err, isErr, computeTransitiveClosure, isReachable } from '../chunk-IJTLXNGJ.js';
+export { isErr, isOk, unwrap } from '../chunk-IJTLXNGJ.js';
 import '../chunk-GYA4JRP5.js';
-import '../chunk-RXOAXO3R.js';
+import '../chunk-2WDD2NO3.js';
 import '../chunk-ITE4IXAK.js';
-import '../chunk-4WYFRACU.js';
-import { TypeGraphError } from '../chunk-OYJSYDIH.js';
+import '../chunk-TVLKA4AY.js';
+import { TypeGraphError } from '../chunk-4MB3AQAQ.js';
 import '../chunk-G6Q5UM7U.js';
 import { z } from 'zod';
 

package/dist/{index-DQzVJBHa.d.ts → index-By89Sezh.d.ts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './types-Dh-EgT-w.js';
-import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-BM3u0aXE.js';
+import { K as KindEntity } from './types-Cjvkj0jA.js';
+import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-BD4V3svD.js';
 
 /**
  * TypeGraph Error Hierarchy
@@ -379,21 +379,51 @@ declare class SchemaMismatchError extends TypeGraphError {
  * branch on the outcome instead of matching the message text, which is free
  * to be reworded in any release.
  */
-declare const MIGRATION_FAILURE_REASONS: readonly ["schema-behind", "breaking-change", "no-active-version", "version-not-found"];
+declare const MIGRATION_FAILURE_REASONS: readonly ["schema-behind", "breaking-change", "no-active-version", "version-not-found", "kind-removal"];
 type MigrationFailureReason = (typeof MIGRATION_FAILURE_REASONS)[number];
+/**
+ * Structured context for a {@link MigrationError}, discriminated on `reason`.
+ *
+ * Modelled as a union rather than one shape with optional fields so the
+ * payload a reason promises is the payload it must carry: narrowing on
+ * `reason === "kind-removal"` gives you a non-optional `droppedKinds`, and the
+ * constructor cannot be handed a `kind-removal` without one.
+ *
+ * The common fields are repeated per member rather than factored into a shared
+ * base alias, which would be a hoisted-unexported symbol on the public
+ * entrypoint.
+ */
 type MigrationErrorDetails = Readonly<{
     graphId: string;
     fromVersion: number;
     toVersion: number;
-    /** Stable discriminant for the failure — branch on this, not the message. */
-    reason: MigrationFailureReason;
+    /** Stable discriminant — branch on this, not the message. */
+    reason: "schema-behind" | "breaking-change";
     /**
-     * The structured diff behind the failure, when one was computed
-     * (`schema-behind` and `breaking-change`). Carries per-change `severity`
+     * The structured diff behind the failure. Carries per-change `severity`
      * alongside `hasChanges` / `hasBreakingChanges`, so a caller can decide
      * "additive → proceed, incompatible → ask the user" without re-querying.
      */
     diff?: SchemaDiff;
+}> | Readonly<{
+    graphId: string;
+    fromVersion: number;
+    toVersion: number;
+    reason: "no-active-version" | "version-not-found";
+}> | Readonly<{
+    graphId: string;
+    fromVersion: number;
+    toVersion: number;
+    reason: "kind-removal";
+    /**
+     * The dropped kinds that still held rows, and so caused the refusal. A
+     * kind the commit drops but that is already empty is permitted and does
+     * NOT appear here. Both lists are sorted; at least one is non-empty.
+     */
+    droppedKinds: Readonly<{
+        nodes: readonly string[];
+        edges: readonly string[];
+    }>;
 }>;
 /**
  * Thrown when schema migration fails.

package/dist/{index-DHXw7QAl.d.cts → index-DcQ3Sxs-.d.cts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './types-Dh-EgT-w.cjs';
-import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-DzMCetZe.cjs';
+import { K as KindEntity } from './types-Cjvkj0jA.cjs';
+import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-DVRhd5h4.cjs';
 
 /**
  * TypeGraph Error Hierarchy
@@ -379,21 +379,51 @@ declare class SchemaMismatchError extends TypeGraphError {
  * branch on the outcome instead of matching the message text, which is free
  * to be reworded in any release.
  */
-declare const MIGRATION_FAILURE_REASONS: readonly ["schema-behind", "breaking-change", "no-active-version", "version-not-found"];
+declare const MIGRATION_FAILURE_REASONS: readonly ["schema-behind", "breaking-change", "no-active-version", "version-not-found", "kind-removal"];
 type MigrationFailureReason = (typeof MIGRATION_FAILURE_REASONS)[number];
+/**
+ * Structured context for a {@link MigrationError}, discriminated on `reason`.
+ *
+ * Modelled as a union rather than one shape with optional fields so the
+ * payload a reason promises is the payload it must carry: narrowing on
+ * `reason === "kind-removal"` gives you a non-optional `droppedKinds`, and the
+ * constructor cannot be handed a `kind-removal` without one.
+ *
+ * The common fields are repeated per member rather than factored into a shared
+ * base alias, which would be a hoisted-unexported symbol on the public
+ * entrypoint.
+ */
 type MigrationErrorDetails = Readonly<{
     graphId: string;
     fromVersion: number;
     toVersion: number;
-    /** Stable discriminant for the failure — branch on this, not the message. */
-    reason: MigrationFailureReason;
+    /** Stable discriminant — branch on this, not the message. */
+    reason: "schema-behind" | "breaking-change";
     /**
-     * The structured diff behind the failure, when one was computed
-     * (`schema-behind` and `breaking-change`). Carries per-change `severity`
+     * The structured diff behind the failure. Carries per-change `severity`
      * alongside `hasChanges` / `hasBreakingChanges`, so a caller can decide
      * "additive → proceed, incompatible → ask the user" without re-querying.
      */
     diff?: SchemaDiff;
+}> | Readonly<{
+    graphId: string;
+    fromVersion: number;
+    toVersion: number;
+    reason: "no-active-version" | "version-not-found";
+}> | Readonly<{
+    graphId: string;
+    fromVersion: number;
+    toVersion: number;
+    reason: "kind-removal";
+    /**
+     * The dropped kinds that still held rows, and so caused the refusal. A
+     * kind the commit drops but that is already empty is permitted and does
+     * NOT appear here. Both lists are sorted; at least one is non-empty.
+     */
+    droppedKinds: Readonly<{
+        nodes: readonly string[];
+        edges: readonly string[];
+    }>;
 }>;
 /**
  * Thrown when schema migration fails.