notebooklm-sdk 0.3.3 → 0.3.4

package/dist/index.d.cts

@@ -402,6 +402,12 @@ interface DataTableContent {
     headers: string[];
     rows: string[][];
 }
+interface PollUntilReadyOptions {
+    timeoutSecs?: number;
+    intervalSecs?: number;
+    onTick?: (status: GenerationStatus) => void | Promise<void>;
+    signal?: AbortSignal;
+}
 type ReportFormat = "briefing_doc" | "study_guide" | "blog_post" | "custom";
 interface CreateReportOptions {
     format?: ReportFormat;
@@ -439,6 +445,9 @@ declare class ArtifactsAPI {
     createMindMap(notebookId: string, sourceIds?: string[]): Promise<Note>;
     /** Poll until artifact reaches completed/failed status. */
     waitUntilReady(notebookId: string, artifactId: string, timeout?: number, pollInterval?: number): Promise<Artifact>;
+    /** Poll until artifact is fully ready, with optional progress hooks and cancellation. */
+    pollUntilReady(notebookId: string, artifactId: string, opts?: PollUntilReadyOptions): Promise<Artifact>;
+    private throwIfAborted;
     /** Get the current status of a generated artifact without waiting. */
     pollStatus(notebookId: string, artifactId: string): Promise<GenerationStatus>;
     /** Download audio content as a Buffer. */
@@ -682,4 +691,4 @@ declare class NotebookLMClient {
     refreshTokens(): Promise<void>;
 }
 
-export { type AddSourceOptions, type Artifact, type ArtifactStatus, type ArtifactType, ArtifactTypeCode, ArtifactsAPI, type AskOptions, type AskResult, AudioFormat, type AudioFormatValue, AudioLength, type AudioLengthValue, AuthTokens, ChatAPI, ChatGoal, type ChatGoalValue, ChatMode, type ChatModeValue, type ChatReference, ChatResponseLength, type ChatResponseLengthValue, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, DriveMimeType, type DriveMimeTypeValue, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, type ReportFormat, type ReportSuggestion, ResearchAPI, type ResearchResult, type ResearchSource, type ResearchTask, SettingsAPI, ShareAccess, type ShareAccessValue, SharePermission, type SharePermissionValue, type ShareStatus, ShareViewLevel, type ShareViewLevelValue, type SharedUser, SharingAPI, SlideDeckFormat, type SlideDeckFormatValue, SlideDeckLength, type SlideDeckLengthValue, type Source, type SourceFulltext, type SourceGuide, type SourceStatus, type SourceSummary, type SourceType, SourcesAPI, type SuggestedTopic, VideoFormat, type VideoFormatValue, VideoStyle, type VideoStyleValue };
+export { type AddSourceOptions, type Artifact, type ArtifactStatus, type ArtifactType, ArtifactTypeCode, ArtifactsAPI, type AskOptions, type AskResult, AudioFormat, type AudioFormatValue, AudioLength, type AudioLengthValue, AuthTokens, ChatAPI, ChatGoal, type ChatGoalValue, ChatMode, type ChatModeValue, type ChatReference, ChatResponseLength, type ChatResponseLengthValue, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, DriveMimeType, type DriveMimeTypeValue, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, type PollUntilReadyOptions, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, type ReportFormat, type ReportSuggestion, ResearchAPI, type ResearchResult, type ResearchSource, type ResearchTask, SettingsAPI, ShareAccess, type ShareAccessValue, SharePermission, type SharePermissionValue, type ShareStatus, ShareViewLevel, type ShareViewLevelValue, type SharedUser, SharingAPI, SlideDeckFormat, type SlideDeckFormatValue, SlideDeckLength, type SlideDeckLengthValue, type Source, type SourceFulltext, type SourceGuide, type SourceStatus, type SourceSummary, type SourceType, SourcesAPI, type SuggestedTopic, VideoFormat, type VideoFormatValue, VideoStyle, type VideoStyleValue };

package/dist/index.d.ts

@@ -402,6 +402,12 @@ interface DataTableContent {
     headers: string[];
     rows: string[][];
 }
+interface PollUntilReadyOptions {
+    timeoutSecs?: number;
+    intervalSecs?: number;
+    onTick?: (status: GenerationStatus) => void | Promise<void>;
+    signal?: AbortSignal;
+}
 type ReportFormat = "briefing_doc" | "study_guide" | "blog_post" | "custom";
 interface CreateReportOptions {
     format?: ReportFormat;
@@ -439,6 +445,9 @@ declare class ArtifactsAPI {
     createMindMap(notebookId: string, sourceIds?: string[]): Promise<Note>;
     /** Poll until artifact reaches completed/failed status. */
     waitUntilReady(notebookId: string, artifactId: string, timeout?: number, pollInterval?: number): Promise<Artifact>;
+    /** Poll until artifact is fully ready, with optional progress hooks and cancellation. */
+    pollUntilReady(notebookId: string, artifactId: string, opts?: PollUntilReadyOptions): Promise<Artifact>;
+    private throwIfAborted;
     /** Get the current status of a generated artifact without waiting. */
     pollStatus(notebookId: string, artifactId: string): Promise<GenerationStatus>;
     /** Download audio content as a Buffer. */
@@ -682,4 +691,4 @@ declare class NotebookLMClient {
     refreshTokens(): Promise<void>;
 }
 
-export { type AddSourceOptions, type Artifact, type ArtifactStatus, type ArtifactType, ArtifactTypeCode, ArtifactsAPI, type AskOptions, type AskResult, AudioFormat, type AudioFormatValue, AudioLength, type AudioLengthValue, AuthTokens, ChatAPI, ChatGoal, type ChatGoalValue, ChatMode, type ChatModeValue, type ChatReference, ChatResponseLength, type ChatResponseLengthValue, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, DriveMimeType, type DriveMimeTypeValue, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, type ReportFormat, type ReportSuggestion, ResearchAPI, type ResearchResult, type ResearchSource, type ResearchTask, SettingsAPI, ShareAccess, type ShareAccessValue, SharePermission, type SharePermissionValue, type ShareStatus, ShareViewLevel, type ShareViewLevelValue, type SharedUser, SharingAPI, SlideDeckFormat, type SlideDeckFormatValue, SlideDeckLength, type SlideDeckLengthValue, type Source, type SourceFulltext, type SourceGuide, type SourceStatus, type SourceSummary, type SourceType, SourcesAPI, type SuggestedTopic, VideoFormat, type VideoFormatValue, VideoStyle, type VideoStyleValue };
+export { type AddSourceOptions, type Artifact, type ArtifactStatus, type ArtifactType, ArtifactTypeCode, ArtifactsAPI, type AskOptions, type AskResult, AudioFormat, type AudioFormatValue, AudioLength, type AudioLengthValue, AuthTokens, ChatAPI, ChatGoal, type ChatGoalValue, ChatMode, type ChatModeValue, type ChatReference, ChatResponseLength, type ChatResponseLengthValue, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, DriveMimeType, type DriveMimeTypeValue, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, type PollUntilReadyOptions, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, type ReportFormat, type ReportSuggestion, ResearchAPI, type ResearchResult, type ResearchSource, type ResearchTask, SettingsAPI, ShareAccess, type ShareAccessValue, SharePermission, type SharePermissionValue, type ShareStatus, ShareViewLevel, type ShareViewLevelValue, type SharedUser, SharingAPI, SlideDeckFormat, type SlideDeckFormatValue, SlideDeckLength, type SlideDeckLengthValue, type Source, type SourceFulltext, type SourceGuide, type SourceStatus, type SourceSummary, type SourceType, SourcesAPI, type SuggestedTopic, VideoFormat, type VideoFormatValue, VideoStyle, type VideoStyleValue };

package/dist/index.js

@@ -938,9 +938,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) {
@@ -949,12 +963,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) {