@raisindb/client 0.4.0 → 0.4.1

package/dist/index.mjs

@@ -2688,6 +2688,13 @@ var Branches = class {
    * Each root's parent path must already exist on the target branch. With
    * `deleteMissing`, target nodes under the roots that are absent from the
    * copied source set are pruned (one-way sync).
+   *
+   * `sourceRevision` pins the read to a point in time. A promotion of a large
+   * set is not instantaneous, so without it the copy reads each node when its
+   * turn comes and a writer working in parallel lands partly inside the result
+   * — a torn snapshot. Pass the revision captured when the operation was
+   * decided (see `getHead`) to copy exactly that state. The target branch is
+   * always resolved at its head: the pin says WHAT to copy, never where.
    */
   async copyNodes(sourceBranch, targetBranch, opts) {
     return this.sendRequest(
@@ -2697,7 +2704,8 @@ var Branches = class {
         workspace: opts.workspace,
         roots: opts.roots,
         recursive: opts.recursive ?? true,
-        delete_missing: opts.deleteMissing ?? false
+        delete_missing: opts.deleteMissing ?? false,
+        source_revision: opts.sourceRevision ?? null
       },
       "branch_copy_nodes" /* BranchCopyNodes */
     );