@ultipa-graph/ultipa-driver 6.0.13 → 6.0.14

package/dist/client.d.ts

@@ -347,27 +347,44 @@ export declare class GqldbClient {
     /** Stop a running task by ID */
     stopTask(taskId: string, config?: QueryConfig): Promise<Response>;
     /**
-     * Insert nodes using GQL INSERT syntax with RETURN clause.
-     * GQL: INSERT (n0:Label {p1: v1}), (n1:Label {p2: v2}) RETURN n0, n1
-     * When config.insertType is InsertType.Overwrite, uses INSERT OVERWRITE syntax.
-     * If NodeData.id is set (non-empty), includes it as _id property in the GQL.
-     * Returns the raw Response containing the inserted nodes in columns n0, n1, etc.
+     * Insert nodes — backward-compatible overloaded entry point.
      *
-     * @param nodes Nodes to insert.
-     * @param config Optional InsertConfig. Supports per-call graphName and insertType.
+     * Two call shapes are accepted; the runtime dispatches on the first
+     * argument's type:
+     *
+     *   1. `insertNodes(graphName: string, nodes, config?)` — original
+     *      6.0.0 signature, routes through the bulk-import gRPC path
+     *      (`DataService.InsertNodes`). Returns `InsertNodesResult` with
+     *      gRPC-level metadata. Preserves source compatibility for
+     *      callers written against 6.0.0 (e.g. gqldb-manager).
+     *
+     *   2. `insertNodes(nodes, config?)` — convenience GQL emitter (added
+     *      after 6.0.0). Synthesizes
+     *      `INSERT (n0:Label {...}), (n1:Label {...}) RETURN n0, n1`,
+     *      with `INSERT OVERWRITE` when `config.insertType` is
+     *      `InsertType.Overwrite`. Returns the raw `Response`.
+     *      `NodeData.id`, when set, is emitted as the `_id` property.
      */
+    insertNodes(graphName: string, nodes: NodeData[], config?: InsertNodesConfig): Promise<InsertNodesResult>;
     insertNodes(nodes: NodeData[], config?: InsertConfig): Promise<Response>;
     /**
-     * Insert edges using GQL INSERT syntax with RETURN clause.
-     * Each edge is inserted individually using MATCH + INSERT to resolve node IDs.
-     * GQL: MATCH (src WHERE id(src) = 'from'), (dst WHERE id(dst) = 'to')
-     *      INSERT (src)-[e0:Label {p1: v1}]->(dst) RETURN e0
-     * When config.insertType is InsertType.Overwrite, uses INSERT OVERWRITE syntax.
-     * Returns a merged Response containing all inserted edges in columns e0, e1, etc.
+     * Insert edges — backward-compatible overloaded entry point.
+     *
+     * Two call shapes are accepted; the runtime dispatches on the first
+     * argument's type:
+     *
+     *   1. `insertEdges(graphName: string, edges, config?)` — original
+     *      6.0.0 signature, routes through the bulk-import gRPC path
+     *      (`DataService.InsertEdges`). Returns `InsertEdgesResult` with
+     *      gRPC-level metadata. Preserves source compatibility for
+     *      6.0.0 callers.
      *
-     * @param edges Edges to insert.
-     * @param config Optional InsertConfig. Supports per-call graphName and insertType.
+     *   2. `insertEdges(edges, config?)` — convenience GQL emitter
+     *      (added after 6.0.0). Per edge synthesizes
+     *      `MATCH (src WHERE id(src) = 'from'), (dst WHERE id(dst) = 'to') INSERT (src)-[e0:Label {...}]->(dst) RETURN e0`.
+     *      Returns a merged `Response` with columns `e0, e1, ...`.
      */
+    insertEdges(graphName: string, edges: EdgeData[], config?: InsertEdgesConfig): Promise<InsertEdgesResult>;
     insertEdges(edges: EdgeData[], config?: InsertConfig): Promise<Response>;
     /** Return currently running processes (queries) */
     top(config?: QueryConfig): Promise<ProcessInfo[]>;