notebooklm-sdk 0.3.2 → 0.3.4

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.cjs';
-export { C as CookieMap, d as connect } from './auth-Dxsm8894.cjs';
+import { A as AuthTokens, a as ConnectOptions } from './auth-BlG6x47F.cjs';
+export { C as CookieMap, d as connect } from './auth-BlG6x47F.cjs';
 export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, AuthError, ChatError, ClientError, NetworkError, NotebookError, NotebookLMError, NotebookNotFoundError, RPCError, RPCTimeoutError, RateLimitError, ServerError, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError } from './errors.cjs';
 
 /** RPC method IDs for NotebookLM batchexecute API. */
@@ -219,8 +219,9 @@ interface RPCCallOptions {
 declare class RPCCore {
     private readonly auth;
     private readonly timeoutMs;
-    constructor(auth: AuthTokens, timeoutMs?: number);
-    call(methodId: RPCMethodId, params: unknown[], opts?: RPCCallOptions): Promise<unknown>;
+    private readonly refreshAuth?;
+    constructor(auth: AuthTokens, timeoutMs?: number, refreshAuth?: () => Promise<void>);
+    call(methodId: RPCMethodId, params: unknown[], opts?: RPCCallOptions, retried?: boolean): Promise<unknown>;
     /** Extract source IDs from a notebook (used by chat/artifact APIs). */
     getSourceIds(notebookId: string): Promise<string[]>;
 }
@@ -345,10 +346,12 @@ declare class NotesAPI {
     private readonly rpc;
     constructor(rpc: RPCCore);
     list(notebookId: string): Promise<Note[]>;
+    get(notebookId: string, noteId: string): Promise<Note | null>;
     listMindMaps(notebookId: string): Promise<Note[]>;
     create(notebookId: string, content: string, title?: string): Promise<Note>;
     update(notebookId: string, noteId: string, content: string, title?: string): Promise<Note>;
     delete(notebookId: string, noteId: string): Promise<boolean>;
+    deleteMindMap(notebookId: string, mindMapId: string): Promise<boolean>;
     private _fetchAll;
     private _isMindMap;
     private _extractContent;
@@ -399,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;
@@ -436,6 +445,11 @@ 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. */
     downloadAudio(notebookId: string, artifactId: string): Promise<Buffer>;
     /** Download video content as a Buffer. */
@@ -475,25 +489,29 @@ interface AskOptions {
 declare class ChatAPI {
     private readonly rpc;
     private readonly auth;
+    private readonly refreshAuth?;
     private readonly conversationCache;
     private reqid;
-    constructor(rpc: RPCCore, auth: AuthTokens);
+    constructor(rpc: RPCCore, auth: AuthTokens, refreshAuth?: (() => Promise<void>) | undefined);
     ask(notebookId: string, query: string, opts?: AskOptions): Promise<AskResult>;
     getConversationTurns(notebookId: string, conversationId: string): Promise<ConversationTurn[]>;
     getLastConversationId(notebookId: string): Promise<string | null>;
+    getHistory(notebookId: string, limit?: number, conversationId?: string): Promise<Array<[string, string]>>;
     /**
      * Low-level chat configuration. Set goal, response length, and optional
      * custom instructions directly. Persists on the server per notebook.
      * Use `setMode()` for preset combinations instead.
      */
-    configure(notebookId: string, goal: ChatGoalValue, length: ChatResponseLengthValue, customPrompt?: string): Promise<void>;
+    configure(notebookId: string, goal?: ChatGoalValue, length?: ChatResponseLengthValue, customPrompt?: string): Promise<void>;
     /**
      * Set the chat mode for a notebook. Persists on the server — affects all
      * subsequent `ask()` calls until changed.
      */
     setMode(notebookId: string, mode: ChatModeValue): Promise<void>;
     clearCache(conversationId?: string): void;
+    getCachedTurns(conversationId: string): ConversationTurn[];
     private _buildHistory;
+    private _postChatRequest;
 }
 
 declare class NotebooksAPI {
@@ -506,7 +524,15 @@ declare class NotebooksAPI {
     rename(notebookId: string, newTitle: string): Promise<Notebook>;
     getSummary(notebookId: string): Promise<string>;
     removeFromRecent(notebookId: string): Promise<void>;
+    getRaw(notebookId: string): Promise<unknown>;
     getDescription(notebookId: string): Promise<NotebookDescription>;
+    share(notebookId: string, publicAccess?: boolean, artifactId?: string): Promise<{
+        public: boolean;
+        url: string | null;
+        artifactId: string | null;
+    }>;
+    getShareUrl(notebookId: string, artifactId?: string): string;
+    getMetadata(notebookId: string): Promise<NotebookMetadata>;
 }
 
 interface ResearchTask {
@@ -620,7 +646,9 @@ declare class SourcesAPI {
     checkFreshness(notebookId: string, sourceId: string): Promise<boolean>;
     delete(notebookId: string, sourceId: string): Promise<boolean>;
     refresh(notebookId: string, sourceId: string): Promise<boolean>;
+    rename(notebookId: string, sourceId: string, newTitle: string): Promise<Source>;
     waitUntilReady(notebookId: string, sourceId: string, timeout?: number, initialInterval?: number, maxInterval?: number, backoffFactor?: number): Promise<Source>;
+    waitForSources(notebookId: string, sourceIds: string[], timeout?: number, initialInterval?: number, maxInterval?: number, backoffFactor?: number): Promise<Source[]>;
 }
 
 interface ClientOptions {
@@ -650,6 +678,7 @@ declare class NotebookLMClient {
     readonly research: ResearchAPI;
     readonly settings: SettingsAPI;
     readonly sharing: SharingAPI;
+    private refreshPromise;
     private constructor();
     /**
      * Connect to NotebookLM using cookies.
@@ -662,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 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

@@ -1,5 +1,5 @@
-import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.js';
-export { C as CookieMap, d as connect } from './auth-Dxsm8894.js';
+import { A as AuthTokens, a as ConnectOptions } from './auth-BlG6x47F.js';
+export { C as CookieMap, d as connect } from './auth-BlG6x47F.js';
 export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, AuthError, ChatError, ClientError, NetworkError, NotebookError, NotebookLMError, NotebookNotFoundError, RPCError, RPCTimeoutError, RateLimitError, ServerError, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError } from './errors.js';
 
 /** RPC method IDs for NotebookLM batchexecute API. */
@@ -219,8 +219,9 @@ interface RPCCallOptions {
 declare class RPCCore {
     private readonly auth;
     private readonly timeoutMs;
-    constructor(auth: AuthTokens, timeoutMs?: number);
-    call(methodId: RPCMethodId, params: unknown[], opts?: RPCCallOptions): Promise<unknown>;
+    private readonly refreshAuth?;
+    constructor(auth: AuthTokens, timeoutMs?: number, refreshAuth?: () => Promise<void>);
+    call(methodId: RPCMethodId, params: unknown[], opts?: RPCCallOptions, retried?: boolean): Promise<unknown>;
     /** Extract source IDs from a notebook (used by chat/artifact APIs). */
     getSourceIds(notebookId: string): Promise<string[]>;
 }
@@ -345,10 +346,12 @@ declare class NotesAPI {
     private readonly rpc;
     constructor(rpc: RPCCore);
     list(notebookId: string): Promise<Note[]>;
+    get(notebookId: string, noteId: string): Promise<Note | null>;
     listMindMaps(notebookId: string): Promise<Note[]>;
     create(notebookId: string, content: string, title?: string): Promise<Note>;
     update(notebookId: string, noteId: string, content: string, title?: string): Promise<Note>;
     delete(notebookId: string, noteId: string): Promise<boolean>;
+    deleteMindMap(notebookId: string, mindMapId: string): Promise<boolean>;
     private _fetchAll;
     private _isMindMap;
     private _extractContent;
@@ -399,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;
@@ -436,6 +445,11 @@ 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. */
     downloadAudio(notebookId: string, artifactId: string): Promise<Buffer>;
     /** Download video content as a Buffer. */
@@ -475,25 +489,29 @@ interface AskOptions {
 declare class ChatAPI {
     private readonly rpc;
     private readonly auth;
+    private readonly refreshAuth?;
     private readonly conversationCache;
     private reqid;
-    constructor(rpc: RPCCore, auth: AuthTokens);
+    constructor(rpc: RPCCore, auth: AuthTokens, refreshAuth?: (() => Promise<void>) | undefined);
     ask(notebookId: string, query: string, opts?: AskOptions): Promise<AskResult>;
     getConversationTurns(notebookId: string, conversationId: string): Promise<ConversationTurn[]>;
     getLastConversationId(notebookId: string): Promise<string | null>;
+    getHistory(notebookId: string, limit?: number, conversationId?: string): Promise<Array<[string, string]>>;
     /**
      * Low-level chat configuration. Set goal, response length, and optional
      * custom instructions directly. Persists on the server per notebook.
      * Use `setMode()` for preset combinations instead.
      */
-    configure(notebookId: string, goal: ChatGoalValue, length: ChatResponseLengthValue, customPrompt?: string): Promise<void>;
+    configure(notebookId: string, goal?: ChatGoalValue, length?: ChatResponseLengthValue, customPrompt?: string): Promise<void>;
     /**
      * Set the chat mode for a notebook. Persists on the server — affects all
      * subsequent `ask()` calls until changed.
      */
     setMode(notebookId: string, mode: ChatModeValue): Promise<void>;
     clearCache(conversationId?: string): void;
+    getCachedTurns(conversationId: string): ConversationTurn[];
     private _buildHistory;
+    private _postChatRequest;
 }
 
 declare class NotebooksAPI {
@@ -506,7 +524,15 @@ declare class NotebooksAPI {
     rename(notebookId: string, newTitle: string): Promise<Notebook>;
     getSummary(notebookId: string): Promise<string>;
     removeFromRecent(notebookId: string): Promise<void>;
+    getRaw(notebookId: string): Promise<unknown>;
     getDescription(notebookId: string): Promise<NotebookDescription>;
+    share(notebookId: string, publicAccess?: boolean, artifactId?: string): Promise<{
+        public: boolean;
+        url: string | null;
+        artifactId: string | null;
+    }>;
+    getShareUrl(notebookId: string, artifactId?: string): string;
+    getMetadata(notebookId: string): Promise<NotebookMetadata>;
 }
 
 interface ResearchTask {
@@ -620,7 +646,9 @@ declare class SourcesAPI {
     checkFreshness(notebookId: string, sourceId: string): Promise<boolean>;
     delete(notebookId: string, sourceId: string): Promise<boolean>;
     refresh(notebookId: string, sourceId: string): Promise<boolean>;
+    rename(notebookId: string, sourceId: string, newTitle: string): Promise<Source>;
     waitUntilReady(notebookId: string, sourceId: string, timeout?: number, initialInterval?: number, maxInterval?: number, backoffFactor?: number): Promise<Source>;
+    waitForSources(notebookId: string, sourceIds: string[], timeout?: number, initialInterval?: number, maxInterval?: number, backoffFactor?: number): Promise<Source[]>;
 }
 
 interface ClientOptions {
@@ -650,6 +678,7 @@ declare class NotebookLMClient {
     readonly research: ResearchAPI;
     readonly settings: SettingsAPI;
     readonly sharing: SharingAPI;
+    private refreshPromise;
     private constructor();
     /**
      * Connect to NotebookLM using cookies.
@@ -662,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 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 };