notebooklm-sdk 0.3.3 → 0.3.4

package/README.md

@@ -137,6 +137,7 @@ npx notebooklm-sdk login
 bun run examples/basic.ts           # list notebooks and sources
 bun run examples/chat.ts            # ask questions, follow-up conversations
 bun run examples/audio.ts           # generate and download a podcast
+bun run examples/video.ts           # generate and download a cinematic video
 bun run examples/report.ts          # generate and download a briefing doc
 bun run examples/slide-deck.ts      # generate and download PDF / PPTX
 bun run examples/infographic.ts     # generate and download a PNG infographic

package/dist/index.cjs

@@ -940,9 +940,23 @@ ${opts.extraInstructions}` : cfg.prompt;
   // Polling / download
   // ---------------------------------------------------------------------------
   /** Poll until artifact reaches completed/failed status. */
-  async waitUntilReady(notebookId, artifactId, timeout = 300, pollInterval = 3) {
+  async waitUntilReady(notebookId, artifactId, timeout = 1800, pollInterval = 3) {
+    return this.pollUntilReady(notebookId, artifactId, {
+      timeoutSecs: timeout,
+      intervalSecs: pollInterval
+    });
+  }
+  /** Poll until artifact is fully ready, with optional progress hooks and cancellation. */
+  async pollUntilReady(notebookId, artifactId, opts = {}) {
+    const timeout = opts.timeoutSecs ?? 1800;
+    const pollInterval = opts.intervalSecs ?? 3;
     const deadline = Date.now() + timeout * 1e3;
+    let lastStatus = null;
     while (Date.now() < deadline) {
+      this.throwIfAborted(opts.signal);
+      const status = await this.pollStatus(notebookId, artifactId);
+      lastStatus = status;
+      if (opts.onTick) await opts.onTick(status);
       const artifact = await this.get(notebookId, artifactId);
       if (artifact?.status === "completed") {
         if (artifact.kind === "audio" && !artifact.audioUrl || artifact.kind === "video" && !artifact.videoUrl) {
@@ -951,12 +965,22 @@ ${opts.extraInstructions}` : cfg.prompt;
         }
         return artifact;
       }
-      if (artifact?.status === "failed") {
-        throw new ArtifactNotReadyError(artifact.kind, { artifactId, status: "failed" });
+      if (artifact?.status === "failed" || status.status === "failed") {
+        throw new ArtifactNotReadyError(artifact?.kind ?? "artifact", {
+          artifactId,
+          status: "failed"
+        });
       }
       await sleep(pollInterval * 1e3);
     }
-    throw new ArtifactNotReadyError("artifact", { artifactId, status: "timeout" });
+    throw new ArtifactNotReadyError("artifact", {
+      artifactId,
+      status: lastStatus?.status ?? "timeout"
+    });
+  }
+  throwIfAborted(signal) {
+    if (!signal?.aborted) return;
+    throw new Error("Artifact polling aborted");
   }
   /** Get the current status of a generated artifact without waiting. */
   async pollStatus(notebookId, artifactId) {