@nicia-ai/typegraph 0.46.1 → 0.46.2

package/dist/{store-B0h6x7wo.d.cts → store-Bo1psfVZ.d.ts}

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { cw as ValueType, cx as PredicateExpression, aY as FulltextQueryMode, cy as VectorMetricType, Q as QueryAst, J as JsonPointer, ad as FieldRef, bo as ParameterRef, u as NodeType, v as AnyEdgeType, a5 as EdgeType, bV as TraversalExpansion, y as GraphBackend, S as SqlDialect, w as SqlSchema, cz as Traversal, cA as NodePredicate, cB as ProjectedField, bn as OrderSpec, cC as AggregateOrderSpec, T as TemporalMode, cD as GroupBySpec, b7 as HybridFusionOptions, bb as JsonPointerInput, cE as RecursiveCyclePolicy, d as GraphDef, ag as TraversalDirection$1, aO as EdgeRegistration, _ as NodeId, bS as TransactionBackend, ac as AggregateExpr, bG as SortDirection, ax as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, cF as VectorSlotMap, cG as RecordedReadBinding, cH as SelectiveField, cI as ComposableQuery, cJ as SetOperationType, cK as SetOperation, G as GraphIdentityConfig, a1 as NodeKinds, cL as NodeRow, K as KindEntity, aR as ExternalRecordedReadSource, $ as EdgeId, cM as EdgeRow, bm as NodeRegistration, aM as EdgeKinds, bU as TransactionReadBackend, al as AllNodeTypes, a3 as KindAnnotations, X as JsonSchema, b_ as UniquenessScope, as as Collation, ar as Cardinality, aQ as EndpointExistence, b4 as GraphExtension, cN as VectorMetric, B as BackendCapabilities, C as ContributionDiagnostic, c as ContributionRepairResult, aD as ContributionProbeResult, aG as ContributionRebuildScope, aF as ContributionRebuildResult, bT as TransactionOptions, A as AdapterBackend } from './types-HkveCCx0.cjs';
-import { R as RecordedInstant, d as ReadCoordinate } from './temporal-Bn-Fi8FJ.cjs';
-import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-CIje5XYD.cjs';
-import { K as KindRegistry, S as SchemaManagerOptions, b as SchemaValidationResult } from './manager-HGk6E_HW.cjs';
-import { S as SchemaDiff, j as MaterializeIndexesOptions, M as MaterializeIndexesResult, k as MaterializeSystemIndexesOptions } from './materialize-indexes-6A7dWGtb.cjs';
+import { cw as ValueType, cx as PredicateExpression, aY as FulltextQueryMode, cy as VectorMetricType, Q as QueryAst, J as JsonPointer, ad as FieldRef, bo as ParameterRef, u as NodeType, v as AnyEdgeType, a5 as EdgeType, bV as TraversalExpansion, y as GraphBackend, S as SqlDialect, w as SqlSchema, cz as Traversal, cA as NodePredicate, cB as ProjectedField, bn as OrderSpec, cC as AggregateOrderSpec, T as TemporalMode, cD as GroupBySpec, b7 as HybridFusionOptions, bb as JsonPointerInput, cE as RecursiveCyclePolicy, d as GraphDef, ag as TraversalDirection$1, aO as EdgeRegistration, _ as NodeId, bS as TransactionBackend, ac as AggregateExpr, bG as SortDirection, ax as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, cF as VectorSlotMap, cG as RecordedReadBinding, cH as SelectiveField, cI as ComposableQuery, cJ as SetOperationType, cK as SetOperation, G as GraphIdentityConfig, a1 as NodeKinds, cL as NodeRow, K as KindEntity, aR as ExternalRecordedReadSource, $ as EdgeId, cM as EdgeRow, bm as NodeRegistration, aM as EdgeKinds, bU as TransactionReadBackend, al as AllNodeTypes, a3 as KindAnnotations, X as JsonSchema, b_ as UniquenessScope, as as Collation, ar as Cardinality, aQ as EndpointExistence, b4 as GraphExtension, cN as VectorMetric, B as BackendCapabilities, C as ContributionDiagnostic, c as ContributionRepairResult, aD as ContributionProbeResult, aG as ContributionRebuildScope, aF as ContributionRebuildResult, bT as TransactionOptions, A as AdapterBackend } from './types-Du78EvpN.js';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-DPtn0HOu.js';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-BOUuA83f.js';
+import { K as KindRegistry, S as SchemaManagerOptions, b as SchemaValidationResult } from './manager-DX983gJ0.js';
+import { S as SchemaDiff, j as MaterializeIndexesOptions, M as MaterializeIndexesResult, k as MaterializeSystemIndexesOptions } from './materialize-indexes-CpXoggWU.js';
 
 type FieldTypeInfo = Readonly<{
     valueType: ValueType;
@@ -2231,6 +2231,15 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
      * describes the edge to create if none is found.
      */
     validFrom?: string;
+    /**
+     * How an `ifExists: "update"` write treats a stated `validFrom` that differs
+     * from the live edge's stored lower bound. Default: `"refuse"`.
+     *
+     * `"preserve"` makes `validFrom` create/resurrection-only input: it is still
+     * validated, but a live update keeps the stored lower bound while applying
+     * properties and `validTo`.
+     */
+    onImmutableLowerBound?: "preserve" | "refuse";
     /**
      * Valid-time end for a created, updated, or resurrected edge. Ignored when
      * the operation returns an existing edge without writing. May not precede
@@ -2821,6 +2830,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
         props: z.input<E["schema"]>;
         validFrom?: string;
         validTo?: string;
+        onImmutableLowerBound?: "preserve" | "refuse";
     }>[], options?: Pick<EdgeGetOrCreateByEndpointsOptions<E>, "matchOn" | "ifExists">) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
 /**

package/dist/{store-ClQ-MZQS.d.ts → store-FTqBpuJD.d.cts}

@@ -1,9 +1,9 @@
 import { z } from 'zod';
-import { cw as ValueType, cx as PredicateExpression, aY as FulltextQueryMode, cy as VectorMetricType, Q as QueryAst, J as JsonPointer, ad as FieldRef, bo as ParameterRef, u as NodeType, v as AnyEdgeType, a5 as EdgeType, bV as TraversalExpansion, y as GraphBackend, S as SqlDialect, w as SqlSchema, cz as Traversal, cA as NodePredicate, cB as ProjectedField, bn as OrderSpec, cC as AggregateOrderSpec, T as TemporalMode, cD as GroupBySpec, b7 as HybridFusionOptions, bb as JsonPointerInput, cE as RecursiveCyclePolicy, d as GraphDef, ag as TraversalDirection$1, aO as EdgeRegistration, _ as NodeId, bS as TransactionBackend, ac as AggregateExpr, bG as SortDirection, ax as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, cF as VectorSlotMap, cG as RecordedReadBinding, cH as SelectiveField, cI as ComposableQuery, cJ as SetOperationType, cK as SetOperation, G as GraphIdentityConfig, a1 as NodeKinds, cL as NodeRow, K as KindEntity, aR as ExternalRecordedReadSource, $ as EdgeId, cM as EdgeRow, bm as NodeRegistration, aM as EdgeKinds, bU as TransactionReadBackend, al as AllNodeTypes, a3 as KindAnnotations, X as JsonSchema, b_ as UniquenessScope, as as Collation, ar as Cardinality, aQ as EndpointExistence, b4 as GraphExtension, cN as VectorMetric, B as BackendCapabilities, C as ContributionDiagnostic, c as ContributionRepairResult, aD as ContributionProbeResult, aG as ContributionRebuildScope, aF as ContributionRebuildResult, bT as TransactionOptions, A as AdapterBackend } from './types-HkveCCx0.js';
-import { R as RecordedInstant, d as ReadCoordinate } from './temporal-BtM4UALv.js';
-import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-9OQoPuRs.js';
-import { K as KindRegistry, S as SchemaManagerOptions, b as SchemaValidationResult } from './manager-CfZAimti.js';
-import { S as SchemaDiff, j as MaterializeIndexesOptions, M as MaterializeIndexesResult, k as MaterializeSystemIndexesOptions } from './materialize-indexes-BMJP6Tms.js';
+import { cw as ValueType, cx as PredicateExpression, aY as FulltextQueryMode, cy as VectorMetricType, Q as QueryAst, J as JsonPointer, ad as FieldRef, bo as ParameterRef, u as NodeType, v as AnyEdgeType, a5 as EdgeType, bV as TraversalExpansion, y as GraphBackend, S as SqlDialect, w as SqlSchema, cz as Traversal, cA as NodePredicate, cB as ProjectedField, bn as OrderSpec, cC as AggregateOrderSpec, T as TemporalMode, cD as GroupBySpec, b7 as HybridFusionOptions, bb as JsonPointerInput, cE as RecursiveCyclePolicy, d as GraphDef, ag as TraversalDirection$1, aO as EdgeRegistration, _ as NodeId, bS as TransactionBackend, ac as AggregateExpr, bG as SortDirection, ax as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, cF as VectorSlotMap, cG as RecordedReadBinding, cH as SelectiveField, cI as ComposableQuery, cJ as SetOperationType, cK as SetOperation, G as GraphIdentityConfig, a1 as NodeKinds, cL as NodeRow, K as KindEntity, aR as ExternalRecordedReadSource, $ as EdgeId, cM as EdgeRow, bm as NodeRegistration, aM as EdgeKinds, bU as TransactionReadBackend, al as AllNodeTypes, a3 as KindAnnotations, X as JsonSchema, b_ as UniquenessScope, as as Collation, ar as Cardinality, aQ as EndpointExistence, b4 as GraphExtension, cN as VectorMetric, B as BackendCapabilities, C as ContributionDiagnostic, c as ContributionRepairResult, aD as ContributionProbeResult, aG as ContributionRebuildScope, aF as ContributionRebuildResult, bT as TransactionOptions, A as AdapterBackend } from './types-Du78EvpN.cjs';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-CXewwLTB.cjs';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-BrUh0pdc.cjs';
+import { K as KindRegistry, S as SchemaManagerOptions, b as SchemaValidationResult } from './manager-ptr3JLRP.cjs';
+import { S as SchemaDiff, j as MaterializeIndexesOptions, M as MaterializeIndexesResult, k as MaterializeSystemIndexesOptions } from './materialize-indexes-BXz77YqO.cjs';
 
 type FieldTypeInfo = Readonly<{
     valueType: ValueType;
@@ -2231,6 +2231,15 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
      * describes the edge to create if none is found.
      */
     validFrom?: string;
+    /**
+     * How an `ifExists: "update"` write treats a stated `validFrom` that differs
+     * from the live edge's stored lower bound. Default: `"refuse"`.
+     *
+     * `"preserve"` makes `validFrom` create/resurrection-only input: it is still
+     * validated, but a live update keeps the stored lower bound while applying
+     * properties and `validTo`.
+     */
+    onImmutableLowerBound?: "preserve" | "refuse";
     /**
      * Valid-time end for a created, updated, or resurrected edge. Ignored when
      * the operation returns an existing edge without writing. May not precede
@@ -2821,6 +2830,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
         props: z.input<E["schema"]>;
         validFrom?: string;
         validTo?: string;
+        onImmutableLowerBound?: "preserve" | "refuse";
     }>[], options?: Pick<EdgeGetOrCreateByEndpointsOptions<E>, "matchOn" | "ifExists">) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
 /**

package/dist/{temporal-Bn-Fi8FJ.d.cts → temporal-CXewwLTB.d.cts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-HkveCCx0.cjs';
+import { T as TemporalMode } from './types-Du78EvpN.cjs';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{temporal-BtM4UALv.d.ts → temporal-DPtn0HOu.d.ts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-HkveCCx0.js';
+import { T as TemporalMode } from './types-Du78EvpN.js';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{types-KFfk-8Ah.d.ts → types-CeT7xM4M.d.ts}

@@ -1,4 +1,4 @@
-import { K as KindEntity, J as JsonPointer } from './types-HkveCCx0.js';
+import { K as KindEntity, J as JsonPointer } from './types-Du78EvpN.js';
 
 /**
  * QueryProfiler types.

package/dist/{types-HkveCCx0.d.ts → types-Du78EvpN.d.cts}

@@ -3330,7 +3330,7 @@ type RecordContributionMaterializationParams = Readonly<{
  *   `DROP`, a schema-scoped restore that missed the contribution
  *   tables). The state {@link GraphBackend.verifyContributions} exists
  *   to surface: nothing on the open path probes the catalog, so this
- *   database opens clean and fails at the first read of the slot.
+ *   database opens clean and fails at the first dependent read or write.
  * - `missing-marker` — the physical table exists but no marker attests
  *   it as initialized (no row, no recorded success, or a recorded
  *   failure). Reads and writes are refused with
@@ -3453,9 +3453,10 @@ type ContributionProbeContribution = "fulltext" | "vector";
  *   its durable marker and present in the catalog. Not a promise about
  *   future coherence: a write that lands after the probe returns is
  *   outside what any assessment can cover.
- * - `degraded` — at least one contribution is unusable. Queries against
- *   this projection will be refused (`StoreNotInitializedError`) or will
- *   read incomplete storage.
+ * - `degraded` — at least one contribution is unusable. Dependent operations
+ *   may be refused with a typed contribution error, fail at the engine boundary
+ *   when compiled SQL directly references missing storage, or observe
+ *   incomplete storage.
  *   {@link ContributionProbeEntry.detail} says which and why.
  * - `building` — **reserved.** No shipped path publishes it. Recording
  *   an in-flight marker would need a fifth
@@ -4152,8 +4153,8 @@ type GraphBackend = Readonly<{
      * per-instance signature cache and then on the marker row alone, which
      * is the right default for a hot path but leaves a database whose
      * contribution tables were dropped out of band opening clean and
-     * failing at the first read. This method is the explicit, operator-
-     * invoked catalog probe that fills that gap: it issues one uncached
+     * failing at the first dependent read or write. This method is the explicit,
+     * operator-invoked catalog probe that fills that gap: it issues one uncached
      * existence query per distinct physical table and performs ZERO DDL
      * and ZERO writes, so it is safe under a least-privilege runtime role.
      *

package/dist/{types-HkveCCx0.d.cts → types-Du78EvpN.d.ts}

@@ -3330,7 +3330,7 @@ type RecordContributionMaterializationParams = Readonly<{
  *   `DROP`, a schema-scoped restore that missed the contribution
  *   tables). The state {@link GraphBackend.verifyContributions} exists
  *   to surface: nothing on the open path probes the catalog, so this
- *   database opens clean and fails at the first read of the slot.
+ *   database opens clean and fails at the first dependent read or write.
  * - `missing-marker` — the physical table exists but no marker attests
  *   it as initialized (no row, no recorded success, or a recorded
  *   failure). Reads and writes are refused with
@@ -3453,9 +3453,10 @@ type ContributionProbeContribution = "fulltext" | "vector";
  *   its durable marker and present in the catalog. Not a promise about
  *   future coherence: a write that lands after the probe returns is
  *   outside what any assessment can cover.
- * - `degraded` — at least one contribution is unusable. Queries against
- *   this projection will be refused (`StoreNotInitializedError`) or will
- *   read incomplete storage.
+ * - `degraded` — at least one contribution is unusable. Dependent operations
+ *   may be refused with a typed contribution error, fail at the engine boundary
+ *   when compiled SQL directly references missing storage, or observe
+ *   incomplete storage.
  *   {@link ContributionProbeEntry.detail} says which and why.
  * - `building` — **reserved.** No shipped path publishes it. Recording
  *   an in-flight marker would need a fifth
@@ -4152,8 +4153,8 @@ type GraphBackend = Readonly<{
      * per-instance signature cache and then on the marker row alone, which
      * is the right default for a hot path but leaves a database whose
      * contribution tables were dropped out of band opening clean and
-     * failing at the first read. This method is the explicit, operator-
-     * invoked catalog probe that fills that gap: it issues one uncached
+     * failing at the first dependent read or write. This method is the explicit,
+     * operator-invoked catalog probe that fills that gap: it issues one uncached
      * existence query per distinct physical table and performs ZERO DDL
      * and ZERO writes, so it is safe under a least-privilege runtime role.
      *

package/dist/{types-CoIx8HX5.d.cts → types-XR1nHERK.d.cts}

@@ -1,4 +1,4 @@
-import { K as KindEntity, J as JsonPointer } from './types-HkveCCx0.cjs';
+import { K as KindEntity, J as JsonPointer } from './types-Du78EvpN.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{where--fk7_0kv.d.cts → where-CJsp-YUf.d.cts}

@@ -1,4 +1,4 @@
-import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-HkveCCx0.cjs';
+import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-Du78EvpN.cjs';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/dist/{where-ws5hf-Ov.d.ts → where-CMbFiWwp.d.ts}

@@ -1,4 +1,4 @@
-import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-HkveCCx0.js';
+import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-Du78EvpN.js';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicia-ai/typegraph",
-  "version": "0.46.1",
+  "version": "0.46.2",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",