@nicia-ai/typegraph 0.42.0 → 0.43.0

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.0",
+  "version": "0.43.0",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",