@nicia-ai/typegraph 0.41.0 → 0.42.1

package/dist/graph-merge/index.js

@@ -1,38 +1,38 @@
-import { createStoreWithSchema } from '../chunk-MQBF3XGY.js';
-import { compareStrings } from '../chunk-DRACN6XG.js';
-import '../chunk-L3DDZUZP.js';
-import { importGraphStream, exportGraphStream } from '../chunk-XMEYZYGE.js';
-import '../chunk-53BSOG3O.js';
-import { storeBackend, generateId, computeUniqueKey, transactionBackend, lockRecordedGraphWrite, readRevisionOrigin, readRecordedClock } from '../chunk-JHK6NPFV.js';
+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 '../chunk-35S6P5ZU.js';
-import '../chunk-YYLMXERH.js';
-import '../chunk-L5ET7FYQ.js';
-import '../chunk-QOHTVDHU.js';
-import { computeSchemaHash, serializeSchema } from '../chunk-V3S74J44.js';
-import { defineNode } from '../chunk-76HE7DJP.js';
-import '../chunk-ZE6NVENI.js';
+import '../chunk-CDYRPI5U.js';
+import '../chunk-UZLEQFTV.js';
+import '../chunk-2OOY4OYT.js';
+import { computeSchemaHash, serializeSchema } from '../chunk-RAWG2FEU.js';
+import { compareStrings } from '../chunk-DRACN6XG.js';
+import { defineNode } from '../chunk-2HKIID5K.js';
+import '../chunk-O3USVVWS.js';
 import { sortedReplacer } from '../chunk-UR7W5YQK.js';
-import '../chunk-UUIBACKJ.js';
-import { getNodeKinds, getEdgeKinds, defineGraph } from '../chunk-PH4IJ3V5.js';
-import '../chunk-3SHAUJRB.js';
-import '../chunk-2I3DNNBU.js';
-import '../chunk-AQVDAKXH.js';
-import '../chunk-VWEFXG73.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 { sha256Hex } from '../chunk-K34OPSJK.js';
 import '../chunk-2EBMPJBO.js';
-import '../chunk-Y5UC3IXF.js';
-import '../chunk-6N7QBIWN.js';
+import '../chunk-42XYPKZU.js';
+import '../chunk-M4GYQF2H.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-SCTZRFW5.js';
-export { isErr, isOk, unwrap } from '../chunk-SCTZRFW5.js';
+import { ok, err, isErr, computeTransitiveClosure, isReachable } from '../chunk-EQOQOT55.js';
+export { isErr, isOk, unwrap } from '../chunk-EQOQOT55.js';
 import '../chunk-GYA4JRP5.js';
-import '../chunk-TAUGGLNQ.js';
+import '../chunk-RXOAXO3R.js';
 import '../chunk-ITE4IXAK.js';
-import '../chunk-XZA3Y4YH.js';
-import { TypeGraphError } from '../chunk-DPNA466P.js';
+import '../chunk-4WYFRACU.js';
+import { TypeGraphError } from '../chunk-OYJSYDIH.js';
 import '../chunk-G6Q5UM7U.js';
 import { z } from 'zod';
 

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

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-BLEVH4SG.js';
-import { M as MaterializeIndexesResult } from './materialize-indexes-D4iei4Kp.js';
+import { K as KindEntity } from './types-Dh-EgT-w.cjs';
+import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-DzMCetZe.cjs';
 
 /**
  * TypeGraph Error Hierarchy
@@ -374,11 +374,26 @@ declare class SchemaMismatchError extends TypeGraphError {
 /**
  * Details for MigrationError.
  */
+/**
+ * Why a migration operation failed. A stable discriminant so callers can
+ * 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"];
+type MigrationFailureReason = (typeof MIGRATION_FAILURE_REASONS)[number];
 type MigrationErrorDetails = Readonly<{
     graphId: string;
     fromVersion: number;
     toVersion: number;
-    reason?: string;
+    /** Stable discriminant for the failure — branch on this, not the message. */
+    reason: MigrationFailureReason;
+    /**
+     * The structured diff behind the failure, when one was computed
+     * (`schema-behind` and `breaking-change`). Carries per-change `severity`
+     * alongside `hasChanges` / `hasBreakingChanges`, so a caller can decide
+     * "additive → proceed, incompatible → ask the user" without re-querying.
+     */
+    diff?: SchemaDiff;
 }>;
 /**
  * Thrown when schema migration fails.
@@ -812,4 +827,4 @@ declare function isConstraintError(error: unknown): boolean;
  */
 declare function getErrorSuggestion(error: unknown): string | undefined;
 
-export { TypeGraphError as $, type RecordedCaptureGuardCode as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type RecordedCaptureGuardError as F, GraphAlgorithmConvergenceError as G, RestrictedDeleteError as H, InvalidEdgeWeightError as I, type RestrictedDeleteErrorDetails as J, KindNotFoundError as K, type SchemaContentConflictErrorDetails as L, MigrationError as M, NodeConstraintNotFoundError as N, SchemaMismatchError as O, type SchemaMismatchErrorDetails as P, StaleVersionError as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, type StaleVersionErrorDetails as T, StoreNotInitializedError as U, type ValidationIssue as V, type StoreNotInitializedErrorDetails as W, type StoreNotInitializedReason as X, TransactionClosedError as Y, TrustedImportError as Z, type TrustedImportErrorReason as _, ValidationError as a, type TypeGraphErrorOptions as a0, UniquenessError as a1, type UniquenessErrorDetails as a2, UnsupportedBackendCapabilityError as a3, UnsupportedPredicateError as a4, type ValidationErrorDetails as a5, VersionConflictError as a6, type VersionConflictErrorDetails as a7, getErrorSuggestion as a8, isConstraintError as a9, isRecordedCaptureGuardError as aa, isSystemError as ab, isTypeGraphError as ac, isUserRecoverable as ad, type CardinalityErrorDetails as b, CompilerInvariantError as c, ConfigurationError as d, type DatabaseOperationErrorDetails as e, DisjointError as f, type DisjointErrorDetails as g, type EagerMaterializationErrorDetails as h, EdgeNotFoundError as i, type EdgeNotFoundErrorDetails as j, EmbeddingDimensionChangedError as k, type EmbeddingDimensionChangedErrorDetails as l, EndpointError as m, type EndpointErrorDetails as n, EndpointNotFoundError as o, type EndpointNotFoundErrorDetails as p, type ErrorCategory as q, type InvalidEdgeWeightErrorDetails as r, type InvalidEdgeWeightReason as s, type KindNotFoundErrorDetails as t, type MigrationErrorDetails as u, type NodeConstraintNotFoundErrorDetails as v, NodeIndexNotFoundError as w, type NodeIndexNotFoundErrorDetails as x, NodeNotFoundError as y, type NodeNotFoundErrorDetails as z };
+export { TrustedImportError as $, NodeNotFoundError as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type NodeNotFoundErrorDetails as F, GraphAlgorithmConvergenceError as G, type RecordedCaptureGuardCode as H, InvalidEdgeWeightError as I, type RecordedCaptureGuardError as J, KindNotFoundError as K, RestrictedDeleteError as L, MIGRATION_FAILURE_REASONS as M, NodeConstraintNotFoundError as N, type RestrictedDeleteErrorDetails as O, type SchemaContentConflictErrorDetails as P, SchemaMismatchError as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, type SchemaMismatchErrorDetails as T, StaleVersionError as U, type ValidationIssue as V, type StaleVersionErrorDetails as W, StoreNotInitializedError as X, type StoreNotInitializedErrorDetails as Y, type StoreNotInitializedReason as Z, TransactionClosedError as _, ValidationError as a, type TrustedImportErrorReason as a0, TypeGraphError as a1, type TypeGraphErrorOptions as a2, UniquenessError as a3, type UniquenessErrorDetails as a4, UnsupportedBackendCapabilityError as a5, UnsupportedPredicateError as a6, type ValidationErrorDetails as a7, VersionConflictError as a8, type VersionConflictErrorDetails as a9, getErrorSuggestion as aa, isConstraintError as ab, isRecordedCaptureGuardError as ac, isSystemError as ad, isTypeGraphError as ae, isUserRecoverable as af, type CardinalityErrorDetails as b, CompilerInvariantError as c, ConfigurationError as d, type DatabaseOperationErrorDetails as e, DisjointError as f, type DisjointErrorDetails as g, type EagerMaterializationErrorDetails as h, EdgeNotFoundError as i, type EdgeNotFoundErrorDetails as j, EmbeddingDimensionChangedError as k, type EmbeddingDimensionChangedErrorDetails as l, EndpointError as m, type EndpointErrorDetails as n, EndpointNotFoundError as o, type EndpointNotFoundErrorDetails as p, type ErrorCategory as q, type InvalidEdgeWeightErrorDetails as r, type InvalidEdgeWeightReason as s, type KindNotFoundErrorDetails as t, MigrationError as u, type MigrationErrorDetails as v, type MigrationFailureReason as w, type NodeConstraintNotFoundErrorDetails as x, NodeIndexNotFoundError as y, type NodeIndexNotFoundErrorDetails as z };

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

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-BLEVH4SG.cjs';
-import { M as MaterializeIndexesResult } from './materialize-indexes-ExQ6OrAh.cjs';
+import { K as KindEntity } from './types-Dh-EgT-w.js';
+import { M as MaterializeIndexesResult, S as SchemaDiff } from './materialize-indexes-BM3u0aXE.js';
 
 /**
  * TypeGraph Error Hierarchy
@@ -374,11 +374,26 @@ declare class SchemaMismatchError extends TypeGraphError {
 /**
  * Details for MigrationError.
  */
+/**
+ * Why a migration operation failed. A stable discriminant so callers can
+ * 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"];
+type MigrationFailureReason = (typeof MIGRATION_FAILURE_REASONS)[number];
 type MigrationErrorDetails = Readonly<{
     graphId: string;
     fromVersion: number;
     toVersion: number;
-    reason?: string;
+    /** Stable discriminant for the failure — branch on this, not the message. */
+    reason: MigrationFailureReason;
+    /**
+     * The structured diff behind the failure, when one was computed
+     * (`schema-behind` and `breaking-change`). Carries per-change `severity`
+     * alongside `hasChanges` / `hasBreakingChanges`, so a caller can decide
+     * "additive → proceed, incompatible → ask the user" without re-querying.
+     */
+    diff?: SchemaDiff;
 }>;
 /**
  * Thrown when schema migration fails.
@@ -812,4 +827,4 @@ declare function isConstraintError(error: unknown): boolean;
  */
 declare function getErrorSuggestion(error: unknown): string | undefined;
 
-export { TypeGraphError as $, type RecordedCaptureGuardCode as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type RecordedCaptureGuardError as F, GraphAlgorithmConvergenceError as G, RestrictedDeleteError as H, InvalidEdgeWeightError as I, type RestrictedDeleteErrorDetails as J, KindNotFoundError as K, type SchemaContentConflictErrorDetails as L, MigrationError as M, NodeConstraintNotFoundError as N, SchemaMismatchError as O, type SchemaMismatchErrorDetails as P, StaleVersionError as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, type StaleVersionErrorDetails as T, StoreNotInitializedError as U, type ValidationIssue as V, type StoreNotInitializedErrorDetails as W, type StoreNotInitializedReason as X, TransactionClosedError as Y, TrustedImportError as Z, type TrustedImportErrorReason as _, ValidationError as a, type TypeGraphErrorOptions as a0, UniquenessError as a1, type UniquenessErrorDetails as a2, UnsupportedBackendCapabilityError as a3, UnsupportedPredicateError as a4, type ValidationErrorDetails as a5, VersionConflictError as a6, type VersionConflictErrorDetails as a7, getErrorSuggestion as a8, isConstraintError as a9, isRecordedCaptureGuardError as aa, isSystemError as ab, isTypeGraphError as ac, isUserRecoverable as ad, type CardinalityErrorDetails as b, CompilerInvariantError as c, ConfigurationError as d, type DatabaseOperationErrorDetails as e, DisjointError as f, type DisjointErrorDetails as g, type EagerMaterializationErrorDetails as h, EdgeNotFoundError as i, type EdgeNotFoundErrorDetails as j, EmbeddingDimensionChangedError as k, type EmbeddingDimensionChangedErrorDetails as l, EndpointError as m, type EndpointErrorDetails as n, EndpointNotFoundError as o, type EndpointNotFoundErrorDetails as p, type ErrorCategory as q, type InvalidEdgeWeightErrorDetails as r, type InvalidEdgeWeightReason as s, type KindNotFoundErrorDetails as t, type MigrationErrorDetails as u, type NodeConstraintNotFoundErrorDetails as v, NodeIndexNotFoundError as w, type NodeIndexNotFoundErrorDetails as x, NodeNotFoundError as y, type NodeNotFoundErrorDetails as z };
+export { TrustedImportError as $, NodeNotFoundError as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type NodeNotFoundErrorDetails as F, GraphAlgorithmConvergenceError as G, type RecordedCaptureGuardCode as H, InvalidEdgeWeightError as I, type RecordedCaptureGuardError as J, KindNotFoundError as K, RestrictedDeleteError as L, MIGRATION_FAILURE_REASONS as M, NodeConstraintNotFoundError as N, type RestrictedDeleteErrorDetails as O, type SchemaContentConflictErrorDetails as P, SchemaMismatchError as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, type SchemaMismatchErrorDetails as T, StaleVersionError as U, type ValidationIssue as V, type StaleVersionErrorDetails as W, StoreNotInitializedError as X, type StoreNotInitializedErrorDetails as Y, type StoreNotInitializedReason as Z, TransactionClosedError as _, ValidationError as a, type TrustedImportErrorReason as a0, TypeGraphError as a1, type TypeGraphErrorOptions as a2, UniquenessError as a3, type UniquenessErrorDetails as a4, UnsupportedBackendCapabilityError as a5, UnsupportedPredicateError as a6, type ValidationErrorDetails as a7, VersionConflictError as a8, type VersionConflictErrorDetails as a9, getErrorSuggestion as aa, isConstraintError as ab, isRecordedCaptureGuardError as ac, isSystemError as ad, isTypeGraphError as ae, isUserRecoverable as af, type CardinalityErrorDetails as b, CompilerInvariantError as c, ConfigurationError as d, type DatabaseOperationErrorDetails as e, DisjointError as f, type DisjointErrorDetails as g, type EagerMaterializationErrorDetails as h, EdgeNotFoundError as i, type EdgeNotFoundErrorDetails as j, EmbeddingDimensionChangedError as k, type EmbeddingDimensionChangedErrorDetails as l, EndpointError as m, type EndpointErrorDetails as n, EndpointNotFoundError as o, type EndpointNotFoundErrorDetails as p, type ErrorCategory as q, type InvalidEdgeWeightErrorDetails as r, type InvalidEdgeWeightReason as s, type KindNotFoundErrorDetails as t, MigrationError as u, type MigrationErrorDetails as v, type MigrationFailureReason as w, type NodeConstraintNotFoundErrorDetails as x, NodeIndexNotFoundError as y, type NodeIndexNotFoundErrorDetails as z };