@nicia-ai/typegraph 0.42.1 → 0.43.0

package/dist/interchange/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk5P6IPIT6_cjs = require('../chunk-5P6IPIT6.cjs');
-require('../chunk-K2HHCWZO.cjs');
-var chunk2SO5I5AI_cjs = require('../chunk-2SO5I5AI.cjs');
+var chunk64LERBFM_cjs = require('../chunk-64LERBFM.cjs');
+require('../chunk-BLBG2VZ5.cjs');
+var chunkKDRF3NR2_cjs = require('../chunk-KDRF3NR2.cjs');
 require('../chunk-ZDH3DX3C.cjs');
 require('../chunk-CVK4T34X.cjs');
 require('../chunk-ECU53PMN.cjs');
@@ -178,7 +178,7 @@ async function consumeTrustedChunks(store, session, chunks) {
 }
 async function trustedImportGraphStream(store, chunks) {
   rejectUnsupportedStoreFeatures(store);
-  const backend = chunk2SO5I5AI_cjs.storeBackend(store);
+  const backend = chunkKDRF3NR2_cjs.storeBackend(store);
   const trustedImport = backend.trustedImport;
   if (trustedImport === void 0) {
     throw new chunkKTBTSHU6_cjs.TrustedImportError(
@@ -203,75 +203,75 @@ function trustedImportGraph(store, data) {
 
 Object.defineProperty(exports, "ConflictStrategySchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ConflictStrategySchema; }
+  get: function () { return chunk64LERBFM_cjs.ConflictStrategySchema; }
 });
 Object.defineProperty(exports, "ExportOptionsSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ExportOptionsSchema; }
+  get: function () { return chunk64LERBFM_cjs.ExportOptionsSchema; }
 });
 Object.defineProperty(exports, "ExportStreamOptionsSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ExportStreamOptionsSchema; }
+  get: function () { return chunk64LERBFM_cjs.ExportStreamOptionsSchema; }
 });
 Object.defineProperty(exports, "FORMAT_VERSION", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.FORMAT_VERSION; }
+  get: function () { return chunk64LERBFM_cjs.FORMAT_VERSION; }
 });
 Object.defineProperty(exports, "GraphDataHeaderSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.GraphDataHeaderSchema; }
+  get: function () { return chunk64LERBFM_cjs.GraphDataHeaderSchema; }
 });
 Object.defineProperty(exports, "GraphDataSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.GraphDataSchema; }
+  get: function () { return chunk64LERBFM_cjs.GraphDataSchema; }
 });
 Object.defineProperty(exports, "GraphDataSourceSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.GraphDataSourceSchema; }
+  get: function () { return chunk64LERBFM_cjs.GraphDataSourceSchema; }
 });
 Object.defineProperty(exports, "GraphInterchangeChunkSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.GraphInterchangeChunkSchema; }
+  get: function () { return chunk64LERBFM_cjs.GraphInterchangeChunkSchema; }
 });
 Object.defineProperty(exports, "ImportErrorSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ImportErrorSchema; }
+  get: function () { return chunk64LERBFM_cjs.ImportErrorSchema; }
 });
 Object.defineProperty(exports, "ImportOptionsSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ImportOptionsSchema; }
+  get: function () { return chunk64LERBFM_cjs.ImportOptionsSchema; }
 });
 Object.defineProperty(exports, "ImportResultSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.ImportResultSchema; }
+  get: function () { return chunk64LERBFM_cjs.ImportResultSchema; }
 });
 Object.defineProperty(exports, "InterchangeEdgeSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.InterchangeEdgeSchema; }
+  get: function () { return chunk64LERBFM_cjs.InterchangeEdgeSchema; }
 });
 Object.defineProperty(exports, "InterchangeNodeSchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.InterchangeNodeSchema; }
+  get: function () { return chunk64LERBFM_cjs.InterchangeNodeSchema; }
 });
 Object.defineProperty(exports, "UnknownPropertyStrategySchema", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.UnknownPropertyStrategySchema; }
+  get: function () { return chunk64LERBFM_cjs.UnknownPropertyStrategySchema; }
 });
 Object.defineProperty(exports, "exportGraph", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.exportGraph; }
+  get: function () { return chunk64LERBFM_cjs.exportGraph; }
 });
 Object.defineProperty(exports, "exportGraphStream", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.exportGraphStream; }
+  get: function () { return chunk64LERBFM_cjs.exportGraphStream; }
 });
 Object.defineProperty(exports, "importGraph", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.importGraph; }
+  get: function () { return chunk64LERBFM_cjs.importGraph; }
 });
 Object.defineProperty(exports, "importGraphStream", {
   enumerable: true,
-  get: function () { return chunk5P6IPIT6_cjs.importGraphStream; }
+  get: function () { return chunk64LERBFM_cjs.importGraphStream; }
 });
 exports.trustedImportGraph = trustedImportGraph;
 exports.trustedImportGraphStream = trustedImportGraphStream;

package/dist/interchange/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { G as GraphDef } from '../define-graph-Byslw2OO.cjs';
-import { a as Store } from '../store-view-CNcOG8bQ.cjs';
+import { a as Store } from '../store-view-D1F6KqsE.cjs';
 import '../types-Dh-EgT-w.cjs';
 import '../temporal-CMpigMCW.cjs';
 import '../manager-U9_zopqr.cjs';

package/dist/interchange/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { G as GraphDef } from '../define-graph-DBFnc7u_.js';
-import { a as Store } from '../store-view-6C2vTWqf.js';
+import { a as Store } from '../store-view-DdwBNjZQ.js';
 import '../types-Dh-EgT-w.js';
 import '../temporal-BtrTYTiB.js';
 import '../manager-Dl0-er1G.js';

package/dist/interchange/index.js

@@ -1,6 +1,6 @@
-export { ConflictStrategySchema, ExportOptionsSchema, ExportStreamOptionsSchema, FORMAT_VERSION, GraphDataHeaderSchema, GraphDataSchema, GraphDataSourceSchema, GraphInterchangeChunkSchema, ImportErrorSchema, ImportOptionsSchema, ImportResultSchema, InterchangeEdgeSchema, InterchangeNodeSchema, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream } from '../chunk-WYQILW5V.js';
-import '../chunk-6NB73BXV.js';
-import { storeBackend } from '../chunk-EVFL2ZY5.js';
+export { ConflictStrategySchema, ExportOptionsSchema, ExportStreamOptionsSchema, FORMAT_VERSION, GraphDataHeaderSchema, GraphDataSchema, GraphDataSourceSchema, GraphInterchangeChunkSchema, ImportErrorSchema, ImportOptionsSchema, ImportResultSchema, InterchangeEdgeSchema, InterchangeNodeSchema, UnknownPropertyStrategySchema, exportGraph, exportGraphStream, importGraph, importGraphStream } from '../chunk-L2BYRYHC.js';
+import '../chunk-L5AUCL5P.js';
+import { storeBackend } from '../chunk-CTWZPYJW.js';
 import '../chunk-35S6P5ZU.js';
 import '../chunk-CDYRPI5U.js';
 import '../chunk-UZLEQFTV.js';

package/dist/profiler/index.d.cts

@@ -1,6 +1,6 @@
 import { G as GraphDef } from '../define-graph-Byslw2OO.cjs';
 import { Q as QueryAst } from '../types-Dh-EgT-w.cjs';
-import { a as Store } from '../store-view-CNcOG8bQ.cjs';
+import { a as Store } from '../store-view-D1F6KqsE.cjs';
 import { P as ProfilerOptions, a as ProfileReport } from '../types-G4sVM-76.cjs';
 export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-G4sVM-76.cjs';
 import 'zod';

package/dist/profiler/index.d.ts

@@ -1,6 +1,6 @@
 import { G as GraphDef } from '../define-graph-DBFnc7u_.js';
 import { Q as QueryAst } from '../types-Dh-EgT-w.js';
-import { a as Store } from '../store-view-6C2vTWqf.js';
+import { a as Store } from '../store-view-DdwBNjZQ.js';
 import { P as ProfilerOptions, a as ProfileReport } from '../types-D2rU5Taq.js';
 export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-D2rU5Taq.js';
 import 'zod';

package/dist/provenance/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk2SO5I5AI_cjs = require('../chunk-2SO5I5AI.cjs');
+var chunkKDRF3NR2_cjs = require('../chunk-KDRF3NR2.cjs');
 require('../chunk-ZDH3DX3C.cjs');
 require('../chunk-CVK4T34X.cjs');
 var chunkECU53PMN_cjs = require('../chunk-ECU53PMN.cjs');
@@ -452,8 +452,8 @@ function getFactRegistration(store, row) {
 async function closeFactCurrency(backend, store, runHooks, row, lock) {
   await runHooks("delete", row.kind, row.id, async () => {
     const registration = getFactRegistration(store, row);
-    await chunk2SO5I5AI_cjs.applyNodeSoftDelete(
-      chunk2SO5I5AI_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
+    await chunkKDRF3NR2_cjs.applyNodeSoftDelete(
+      chunkKDRF3NR2_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
       {
         existing: row,
         schema: registration.type.schema,
@@ -468,8 +468,8 @@ async function closeFactCurrency(backend, store, runHooks, row, lock) {
 async function reopenFactCurrency(backend, store, runHooks, row, lock) {
   await runHooks("update", row.kind, row.id, async () => {
     const registration = getFactRegistration(store, row);
-    await chunk2SO5I5AI_cjs.applyNodeResurrect(
-      chunk2SO5I5AI_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
+    await chunkKDRF3NR2_cjs.applyNodeResurrect(
+      chunkKDRF3NR2_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
       {
         existing: row,
         schema: registration.type.schema,
@@ -501,8 +501,8 @@ async function runTransition(store, config, sources, retracted) {
     );
   }
   return store.transaction(async (tx) => {
-    const backend = chunk2SO5I5AI_cjs.transactionBackend(tx);
-    const lock = await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(backend, store.graphId);
+    const backend = chunkKDRF3NR2_cjs.transactionBackend(tx);
+    const lock = await chunkKDRF3NR2_cjs.lockRecordedGraphWrite(backend, store.graphId);
     const rows = await Promise.all(
       uniqueSources.map(
         (source) => backend.getNode(store.graphId, source.kind, source.id)
@@ -538,7 +538,7 @@ async function runTransition(store, config, sources, retracted) {
     await synchronizeFactCurrency(
       backend,
       store,
-      chunk2SO5I5AI_cjs.transactionNodeOperationHookRunner(tx),
+      chunkKDRF3NR2_cjs.transactionNodeOperationHookRunner(tx),
       after,
       affected,
       lock
@@ -564,8 +564,8 @@ function createRetractionCapability(store, config) {
     unRetractMany: (sources) => transition(sources, false),
     async holding() {
       return store.transaction(async (tx) => {
-        const backend = chunk2SO5I5AI_cjs.transactionBackend(tx);
-        await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(backend, store.graphId);
+        const backend = chunkKDRF3NR2_cjs.transactionBackend(tx);
+        await chunkKDRF3NR2_cjs.lockRecordedGraphWrite(backend, store.graphId);
         const snapshot = await computeSupport(
           backend,
           store.graphId,

package/dist/provenance/index.d.cts

@@ -1,5 +1,5 @@
 import { G as GraphDef } from '../define-graph-Byslw2OO.cjs';
-import { b as HistoryStore } from '../store-view-CNcOG8bQ.cjs';
+import { b as HistoryStore } from '../store-view-D1F6KqsE.cjs';
 import '../types-Dh-EgT-w.cjs';
 import 'zod';
 import '../temporal-CMpigMCW.cjs';

package/dist/provenance/index.d.ts

@@ -1,5 +1,5 @@
 import { G as GraphDef } from '../define-graph-DBFnc7u_.js';
-import { b as HistoryStore } from '../store-view-6C2vTWqf.js';
+import { b as HistoryStore } from '../store-view-DdwBNjZQ.js';
 import '../types-Dh-EgT-w.js';
 import 'zod';
 import '../temporal-BtrTYTiB.js';

package/dist/provenance/index.js

@@ -1,4 +1,4 @@
-import { transactionBackend, lockRecordedGraphWrite, transactionNodeOperationHookRunner, applyNodeSoftDelete, createNodeWriteContext, applyNodeResurrect } from '../chunk-EVFL2ZY5.js';
+import { transactionBackend, lockRecordedGraphWrite, transactionNodeOperationHookRunner, applyNodeSoftDelete, createNodeWriteContext, applyNodeResurrect } from '../chunk-CTWZPYJW.js';
 import '../chunk-35S6P5ZU.js';
 import '../chunk-CDYRPI5U.js';
 import { rowPropsToObject, isLiveNodeRow, isTombstonedNodeRow } from '../chunk-UZLEQFTV.js';

package/dist/{store-view-CNcOG8bQ.d.cts → store-view-D1F6KqsE.d.cts}

@@ -1264,6 +1264,16 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
     matchOn?: readonly (keyof z.input<E["schema"]>)[];
     /** Existing record behavior. Default: "return" */
     ifExists?: IfExistsMode;
+    /**
+     * Valid-time start for a newly created edge. Ignored when an edge is found,
+     * updated, or resurrected.
+     */
+    validFrom?: string;
+    /**
+     * Valid-time end for a created, updated, or resurrected edge. Ignored when
+     * the operation returns an existing edge without writing.
+     */
+    validTo?: string;
 }>;
 /**
  * A collection of nodes of a specific type.
@@ -1685,6 +1695,11 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * property fields, only edges whose properties match on those fields are considered.
      * Soft-deleted matches are resurrected when cardinality allows.
      *
+     * `validFrom` only applies on the create branch, defaulting to the
+     * operation's creation timestamp when omitted. `validTo` applies on create,
+     * update, and resurrection, but not when an existing edge is returned
+     * without a write.
+     *
      * @param from - Source node
      * @param to - Target node
      * @param props - Full properties for create, or merge source for update
@@ -1701,7 +1716,9 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
         from: NodeRef<From>;
         to: NodeRef<To>;
         props: z.input<E["schema"]>;
-    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
+        validFrom?: string;
+        validTo?: string;
+    }>[], options?: Pick<EdgeGetOrCreateByEndpointsOptions<E>, "matchOn" | "ifExists">) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
 /**
  * Extract uniqueness constraint names from a NodeRegistration.

package/dist/{store-view-6C2vTWqf.d.ts → store-view-DdwBNjZQ.d.ts}

@@ -1264,6 +1264,16 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
     matchOn?: readonly (keyof z.input<E["schema"]>)[];
     /** Existing record behavior. Default: "return" */
     ifExists?: IfExistsMode;
+    /**
+     * Valid-time start for a newly created edge. Ignored when an edge is found,
+     * updated, or resurrected.
+     */
+    validFrom?: string;
+    /**
+     * Valid-time end for a created, updated, or resurrected edge. Ignored when
+     * the operation returns an existing edge without writing.
+     */
+    validTo?: string;
 }>;
 /**
  * A collection of nodes of a specific type.
@@ -1685,6 +1695,11 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * property fields, only edges whose properties match on those fields are considered.
      * Soft-deleted matches are resurrected when cardinality allows.
      *
+     * `validFrom` only applies on the create branch, defaulting to the
+     * operation's creation timestamp when omitted. `validTo` applies on create,
+     * update, and resurrection, but not when an existing edge is returned
+     * without a write.
+     *
      * @param from - Source node
      * @param to - Target node
      * @param props - Full properties for create, or merge source for update
@@ -1701,7 +1716,9 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
         from: NodeRef<From>;
         to: NodeRef<To>;
         props: z.input<E["schema"]>;
-    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
+        validFrom?: string;
+        validTo?: string;
+    }>[], options?: Pick<EdgeGetOrCreateByEndpointsOptions<E>, "matchOn" | "ifExists">) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
 /**
  * Extract uniqueness constraint names from a NodeRegistration.

package/package.json

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