@nodaro/sdk 1.5.0 → 1.7.0

package/dist/index.cjs

@@ -1645,6 +1645,63 @@ var MediaResource = class {
   downloadVideo(input) {
     return this.client.request("POST", "/v1/download-video", { body: input });
   }
+  /**
+   * Stream the live progress of a {@link MediaResource.downloadVideo} import
+   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an
+   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms
+   * until the download reaches `completed` (its event carries the stored
+   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress
+   * state expires server-side shortly after the download starts existing, so
+   * start iterating promptly after `downloadVideo` returns.
+   *
+   * No request timeout is applied (a large import legitimately takes minutes) —
+   * pass an `AbortSignal` to cancel from the caller.
+   */
+  async *downloadVideoProgress(downloadId, opts = {}) {
+    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      headers: token ? { Authorization: `Bearer ${token}` } : {},
+      signal: opts.signal
+    });
+    if (!res.ok) {
+      let errBody = {};
+      try {
+        errBody = await res.json();
+      } catch {
+      }
+      throwFromResponse(res.status, errBody);
+    }
+    if (!res.body) {
+      throw new NodaroError("progress stream has no response body", "empty_stream", res.status);
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) >= 0) {
+          const frame = buffer.slice(0, sep);
+          buffer = buffer.slice(sep + 2);
+          for (const line of frame.split("\n")) {
+            if (!line.startsWith("data:")) continue;
+            try {
+              yield JSON.parse(line.slice(5).trim());
+            } catch {
+            }
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+      await res.body.cancel().catch(() => {
+      });
+    }
+  }
   /**
    * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
    * — a server-side fetch, so nothing round-trips through the client. Poll