@nicia-ai/typegraph 0.36.0 → 0.37.0

package/dist/{index-BLtQWKRj.d.cts → index-BPM59vsg.d.cts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-ixRpJVUp.cjs';
-import { M as MaterializeIndexesResult } from './materialize-indexes-B4e9360H.cjs';
+import { K as KindEntity } from './extension-types-BM2ACfYO.cjs';
+import { M as MaterializeIndexesResult } from './materialize-indexes-CuR3gAZb.cjs';
 
 /**
  * TypeGraph Error Hierarchy
@@ -501,6 +501,51 @@ declare class ConfigurationError extends TypeGraphError {
         suggestion?: string;
     });
 }
+/**
+ * Thrown when an iterative graph algorithm exhausts its caller-visible round
+ * budget before reaching its convergence predicate.
+ */
+declare class GraphAlgorithmConvergenceError extends TypeGraphError {
+    constructor(algorithm: string, maxIterations: number);
+}
+/** Stable reasons a weighted traversal can reject an edge's weight value. */
+type InvalidEdgeWeightReason = "missing" | "negative" | "non_numeric" | "out_of_range";
+/** Details for InvalidEdgeWeightError. */
+type InvalidEdgeWeightErrorDetails = Readonly<{
+    /** Id of the first offending edge, in binary-collation order. */
+    edgeId: string;
+    /** Kind of the offending edge. */
+    edgeKind: string;
+    /** The audited weight property. */
+    property: string;
+    /** Why the weight was rejected. */
+    reason: InvalidEdgeWeightReason;
+    /** The offending value, when one was present and renderable. */
+    value?: string;
+}>;
+/**
+ * Thrown when a weighted graph algorithm finds an edge whose weight property
+ * violates the weighted-traversal contract (missing without a default,
+ * non-numeric, or negative). Raised before any traversal rounds run, so a
+ * weighted call either observes a fully valid weight domain or fails fast.
+ */
+declare class InvalidEdgeWeightError extends TypeGraphError {
+    readonly details: InvalidEdgeWeightErrorDetails;
+    constructor(details: InvalidEdgeWeightErrorDetails);
+}
+/** Thrown when an operation requires a backend capability it does not expose. */
+declare class UnsupportedBackendCapabilityError extends TypeGraphError {
+    constructor(operation: string, capability: string, details?: Readonly<Record<string, unknown>>, suggestion?: string);
+}
+/** Stable reasons an intentionally trusted initial import can be rejected. */
+type TrustedImportErrorReason = "backend_unsupported" | "database_not_empty" | "fulltext_unsupported" | "history_unsupported" | "invalid_stream" | "revision_tracking_unsupported" | "uniqueness_unsupported" | "vector_unsupported";
+/** Thrown when the trusted initial-import contract is unavailable or violated. */
+declare class TrustedImportError extends TypeGraphError {
+    constructor(message: string, reason: TrustedImportErrorReason, details?: Readonly<Record<string, unknown>>, options?: Readonly<{
+        cause?: unknown;
+        suggestion?: string;
+    }>);
+}
 /**
  * The stable `details.code` values raised by the recorded-capture guards on a
  * history- or revision-tracked store. These are the sanctioned branch points
@@ -592,14 +637,14 @@ type StoreNotInitializedErrorDetails = Readonly<{
     reason: StoreNotInitializedReason;
 }> & Readonly<Record<string, unknown>>;
 /**
- * Thrown when a fulltext-dependent operation runs against a connection
- * whose strategy-owned storage has not been durably materialized.
+ * Thrown when a fulltext- or vector-dependent operation runs against a
+ * connection whose strategy-owned storage has not been durably materialized.
  *
  * `createStore()` is a synchronous, zero-I/O attach: it never creates
  * tables, repairs DDL, or writes materialization markers. The durable
  * marker is written exclusively by the async boot path
- * (`createStoreWithSchema`). When a fulltext read/write — or an
- * adopted/business transaction — observes no valid marker, it refuses
+ * (`createStoreWithSchema`). When a fulltext or embedding read/write — or
+ * an adopted/business transaction — observes no valid marker, it refuses
  * loudly here instead of lazily emitting DDL on the hot path.
  */
 declare class StoreNotInitializedError extends TypeGraphError {
@@ -765,4 +810,4 @@ declare function isConstraintError(error: unknown): boolean;
  */
 declare function getErrorSuggestion(error: unknown): string | undefined;
 
-export { VersionConflictError as $, RestrictedDeleteError as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type RestrictedDeleteErrorDetails as F, type SchemaContentConflictErrorDetails as G, SchemaMismatchError as H, type SchemaMismatchErrorDetails as I, StaleVersionError as J, KindNotFoundError as K, type StaleVersionErrorDetails as L, MigrationError as M, NodeConstraintNotFoundError as N, StoreNotInitializedError as O, type StoreNotInitializedErrorDetails as P, type StoreNotInitializedReason as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, TypeGraphError as T, TransactionClosedError as U, type ValidationIssue as V, type TypeGraphErrorOptions as W, UniquenessError as X, type UniquenessErrorDetails as Y, UnsupportedPredicateError as Z, type ValidationErrorDetails as _, ValidationError as a, type VersionConflictErrorDetails as a0, getErrorSuggestion as a1, isConstraintError as a2, isRecordedCaptureGuardError as a3, isSystemError as a4, isTypeGraphError as a5, isUserRecoverable as a6, 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 KindNotFoundErrorDetails as r, type MigrationErrorDetails as s, type NodeConstraintNotFoundErrorDetails as t, NodeIndexNotFoundError as u, type NodeIndexNotFoundErrorDetails as v, NodeNotFoundError as w, type NodeNotFoundErrorDetails as x, type RecordedCaptureGuardCode as y, type RecordedCaptureGuardError as z };
+export { type TrustedImportErrorReason 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, TypeGraphError as T, type StaleVersionErrorDetails as U, type ValidationIssue as V, StoreNotInitializedError as W, type StoreNotInitializedErrorDetails as X, type StoreNotInitializedReason as Y, TransactionClosedError as Z, TrustedImportError 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 };

package/dist/{index-BFvdmBPV.d.ts → index-BeacbPoe.d.ts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-ixRpJVUp.js';
-import { M as MaterializeIndexesResult } from './materialize-indexes-te9TPMMJ.js';
+import { K as KindEntity } from './extension-types-BM2ACfYO.js';
+import { M as MaterializeIndexesResult } from './materialize-indexes-zK2J_flP.js';
 
 /**
  * TypeGraph Error Hierarchy
@@ -501,6 +501,51 @@ declare class ConfigurationError extends TypeGraphError {
         suggestion?: string;
     });
 }
+/**
+ * Thrown when an iterative graph algorithm exhausts its caller-visible round
+ * budget before reaching its convergence predicate.
+ */
+declare class GraphAlgorithmConvergenceError extends TypeGraphError {
+    constructor(algorithm: string, maxIterations: number);
+}
+/** Stable reasons a weighted traversal can reject an edge's weight value. */
+type InvalidEdgeWeightReason = "missing" | "negative" | "non_numeric" | "out_of_range";
+/** Details for InvalidEdgeWeightError. */
+type InvalidEdgeWeightErrorDetails = Readonly<{
+    /** Id of the first offending edge, in binary-collation order. */
+    edgeId: string;
+    /** Kind of the offending edge. */
+    edgeKind: string;
+    /** The audited weight property. */
+    property: string;
+    /** Why the weight was rejected. */
+    reason: InvalidEdgeWeightReason;
+    /** The offending value, when one was present and renderable. */
+    value?: string;
+}>;
+/**
+ * Thrown when a weighted graph algorithm finds an edge whose weight property
+ * violates the weighted-traversal contract (missing without a default,
+ * non-numeric, or negative). Raised before any traversal rounds run, so a
+ * weighted call either observes a fully valid weight domain or fails fast.
+ */
+declare class InvalidEdgeWeightError extends TypeGraphError {
+    readonly details: InvalidEdgeWeightErrorDetails;
+    constructor(details: InvalidEdgeWeightErrorDetails);
+}
+/** Thrown when an operation requires a backend capability it does not expose. */
+declare class UnsupportedBackendCapabilityError extends TypeGraphError {
+    constructor(operation: string, capability: string, details?: Readonly<Record<string, unknown>>, suggestion?: string);
+}
+/** Stable reasons an intentionally trusted initial import can be rejected. */
+type TrustedImportErrorReason = "backend_unsupported" | "database_not_empty" | "fulltext_unsupported" | "history_unsupported" | "invalid_stream" | "revision_tracking_unsupported" | "uniqueness_unsupported" | "vector_unsupported";
+/** Thrown when the trusted initial-import contract is unavailable or violated. */
+declare class TrustedImportError extends TypeGraphError {
+    constructor(message: string, reason: TrustedImportErrorReason, details?: Readonly<Record<string, unknown>>, options?: Readonly<{
+        cause?: unknown;
+        suggestion?: string;
+    }>);
+}
 /**
  * The stable `details.code` values raised by the recorded-capture guards on a
  * history- or revision-tracked store. These are the sanctioned branch points
@@ -592,14 +637,14 @@ type StoreNotInitializedErrorDetails = Readonly<{
     reason: StoreNotInitializedReason;
 }> & Readonly<Record<string, unknown>>;
 /**
- * Thrown when a fulltext-dependent operation runs against a connection
- * whose strategy-owned storage has not been durably materialized.
+ * Thrown when a fulltext- or vector-dependent operation runs against a
+ * connection whose strategy-owned storage has not been durably materialized.
  *
  * `createStore()` is a synchronous, zero-I/O attach: it never creates
  * tables, repairs DDL, or writes materialization markers. The durable
  * marker is written exclusively by the async boot path
- * (`createStoreWithSchema`). When a fulltext read/write — or an
- * adopted/business transaction — observes no valid marker, it refuses
+ * (`createStoreWithSchema`). When a fulltext or embedding read/write — or
+ * an adopted/business transaction — observes no valid marker, it refuses
  * loudly here instead of lazily emitting DDL on the hot path.
  */
 declare class StoreNotInitializedError extends TypeGraphError {
@@ -765,4 +810,4 @@ declare function isConstraintError(error: unknown): boolean;
  */
 declare function getErrorSuggestion(error: unknown): string | undefined;
 
-export { VersionConflictError as $, RestrictedDeleteError as A, BackendDisposedError as B, CardinalityError as C, DatabaseOperationError as D, EagerMaterializationError as E, type RestrictedDeleteErrorDetails as F, type SchemaContentConflictErrorDetails as G, SchemaMismatchError as H, type SchemaMismatchErrorDetails as I, StaleVersionError as J, KindNotFoundError as K, type StaleVersionErrorDetails as L, MigrationError as M, NodeConstraintNotFoundError as N, StoreNotInitializedError as O, type StoreNotInitializedErrorDetails as P, type StoreNotInitializedReason as Q, RECORDED_CAPTURE_GUARD_CODES as R, SchemaContentConflictError as S, TypeGraphError as T, TransactionClosedError as U, type ValidationIssue as V, type TypeGraphErrorOptions as W, UniquenessError as X, type UniquenessErrorDetails as Y, UnsupportedPredicateError as Z, type ValidationErrorDetails as _, ValidationError as a, type VersionConflictErrorDetails as a0, getErrorSuggestion as a1, isConstraintError as a2, isRecordedCaptureGuardError as a3, isSystemError as a4, isTypeGraphError as a5, isUserRecoverable as a6, 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 KindNotFoundErrorDetails as r, type MigrationErrorDetails as s, type NodeConstraintNotFoundErrorDetails as t, NodeIndexNotFoundError as u, type NodeIndexNotFoundErrorDetails as v, NodeNotFoundError as w, type NodeNotFoundErrorDetails as x, type RecordedCaptureGuardCode as y, type RecordedCaptureGuardError as z };
+export { type TrustedImportErrorReason 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, TypeGraphError as T, type StaleVersionErrorDetails as U, type ValidationIssue as V, StoreNotInitializedError as W, type StoreNotInitializedErrorDetails as X, type StoreNotInitializedReason as Y, TransactionClosedError as Z, TrustedImportError 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 };