notebooklm-sdk 0.1.7 → 0.2.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AuthTokens, a as ConnectOptions } from './auth-Ba2hsZW_.cjs';
-export { C as CookieMap, d as connect } from './auth-Ba2hsZW_.cjs';
+import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.cjs';
+export { C as CookieMap, d as connect } from './auth-Dxsm8894.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. */
@@ -280,11 +280,19 @@ interface Note {
     createdAt: Date | null;
     updatedAt: Date | null;
 }
-interface MindMap {
-    id: string;
-    title: string | null;
-    content: string;
-    createdAt: Date | null;
+
+declare class NotesAPI {
+    private readonly rpc;
+    constructor(rpc: RPCCore);
+    list(notebookId: string): Promise<Note[]>;
+    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>;
+    private _fetchAll;
+    private _isMindMap;
+    private _extractContent;
+    private _parseItem;
 }
 
 interface CreateAudioOptions {
@@ -322,6 +330,15 @@ interface CreateSlideDeckOptions {
     instructions?: string;
     language?: string;
 }
+interface CreateDataTableOptions {
+    sourceIds?: string[];
+    instructions?: string;
+    language?: string;
+}
+interface DataTableContent {
+    headers: string[];
+    rows: string[][];
+}
 type ReportFormat = "briefing_doc" | "study_guide" | "blog_post" | "custom";
 interface CreateReportOptions {
     format?: ReportFormat;
@@ -333,8 +350,10 @@ interface CreateReportOptions {
 declare class ArtifactsAPI {
     private readonly rpc;
     private readonly auth;
-    constructor(rpc: RPCCore, auth: AuthTokens);
+    private readonly notes;
+    constructor(rpc: RPCCore, auth: AuthTokens, notes: NotesAPI);
     list(notebookId: string): Promise<Artifact[]>;
+    private _listRaw;
     get(notebookId: string, artifactId: string): Promise<Artifact | null>;
     delete(notebookId: string, artifactId: string): Promise<boolean>;
     rename(notebookId: string, artifactId: string, newTitle: string): Promise<boolean>;
@@ -344,8 +363,9 @@ declare class ArtifactsAPI {
     createFlashcards(notebookId: string, opts?: CreateQuizOptions): Promise<GenerationStatus>;
     createInfographic(notebookId: string, opts?: CreateInfographicOptions): Promise<GenerationStatus>;
     createSlideDeck(notebookId: string, opts?: CreateSlideDeckOptions): Promise<GenerationStatus>;
+    createDataTable(notebookId: string, opts?: CreateDataTableOptions): Promise<GenerationStatus>;
     createReport(notebookId: string, opts?: CreateReportOptions): Promise<GenerationStatus>;
-    createMindMap(notebookId: string, sourceIds?: string[]): Promise<GenerationStatus>;
+    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>;
     /** Download audio content as a Buffer. */
@@ -356,6 +376,12 @@ declare class ArtifactsAPI {
     getReportMarkdown(notebookId: string, artifactId: string): Promise<string | null>;
     /** Get interactive HTML for quiz/flashcard artifacts. */
     getInteractiveHtml(notebookId: string, artifactId: string): Promise<string | null>;
+    /** Download a completed slide deck as PDF or PPTX. Returns a Buffer. */
+    downloadSlideDeck(notebookId: string, artifactId: string, format?: "pdf" | "pptx"): Promise<Buffer>;
+    /** Download a completed infographic as PNG. Returns a Buffer. */
+    downloadInfographic(notebookId: string, artifactId: string): Promise<Buffer>;
+    /** Get parsed headers and rows from a completed data table artifact. */
+    getDataTableContent(notebookId: string, artifactId: string): Promise<DataTableContent | null>;
     /**
      * Fetch a Google-hosted media URL, manually following redirects to ensure
      * cookies are included on every hop. Node/Bun fetch strips the Cookie header
@@ -395,18 +421,6 @@ declare class NotebooksAPI {
     getDescription(notebookId: string): Promise<NotebookDescription>;
 }
 
-declare class NotesAPI {
-    private readonly rpc;
-    constructor(rpc: RPCCore);
-    list(notebookId: string): Promise<{
-        notes: Note[];
-        mindMaps: MindMap[];
-    }>;
-    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>;
-}
-
 interface ResearchTask {
     taskId: string;
     reportId: string | null;
@@ -523,10 +537,12 @@ interface ClientOptions {
  *
  * @example
  * ```ts
- * const client = await NotebookLMClient.connect({
- *   cookies: process.env.NOTEBOOKLM_COOKIES,
- * });
+ * // After running `npx notebooklm-sdk login` once:
+ * const client = await NotebookLMClient.connect();
  * const notebooks = await client.notebooks.list();
+ *
+ * // Or with explicit credentials:
+ * const client = await NotebookLMClient.connect({ cookiesFile: './session.json' });
  * ```
  */
 declare class NotebookLMClient {
@@ -544,11 +560,11 @@ declare class NotebookLMClient {
      * Connect to NotebookLM using cookies.
      * Fetches CSRF and session tokens from the NotebookLM homepage.
      */
-    static connect(opts: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
+    static connect(opts?: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
     /**
      * Refresh CSRF and session tokens (e.g. if they expire mid-session).
      */
     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, type ChatReference, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type MindMap, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, 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 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, type ChatReference, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, 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, 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 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-Ba2hsZW_.js';
-export { C as CookieMap, d as connect } from './auth-Ba2hsZW_.js';
+import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.js';
+export { C as CookieMap, d as connect } from './auth-Dxsm8894.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. */
@@ -280,11 +280,19 @@ interface Note {
     createdAt: Date | null;
     updatedAt: Date | null;
 }
-interface MindMap {
-    id: string;
-    title: string | null;
-    content: string;
-    createdAt: Date | null;
+
+declare class NotesAPI {
+    private readonly rpc;
+    constructor(rpc: RPCCore);
+    list(notebookId: string): Promise<Note[]>;
+    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>;
+    private _fetchAll;
+    private _isMindMap;
+    private _extractContent;
+    private _parseItem;
 }
 
 interface CreateAudioOptions {
@@ -322,6 +330,15 @@ interface CreateSlideDeckOptions {
     instructions?: string;
     language?: string;
 }
+interface CreateDataTableOptions {
+    sourceIds?: string[];
+    instructions?: string;
+    language?: string;
+}
+interface DataTableContent {
+    headers: string[];
+    rows: string[][];
+}
 type ReportFormat = "briefing_doc" | "study_guide" | "blog_post" | "custom";
 interface CreateReportOptions {
     format?: ReportFormat;
@@ -333,8 +350,10 @@ interface CreateReportOptions {
 declare class ArtifactsAPI {
     private readonly rpc;
     private readonly auth;
-    constructor(rpc: RPCCore, auth: AuthTokens);
+    private readonly notes;
+    constructor(rpc: RPCCore, auth: AuthTokens, notes: NotesAPI);
     list(notebookId: string): Promise<Artifact[]>;
+    private _listRaw;
     get(notebookId: string, artifactId: string): Promise<Artifact | null>;
     delete(notebookId: string, artifactId: string): Promise<boolean>;
     rename(notebookId: string, artifactId: string, newTitle: string): Promise<boolean>;
@@ -344,8 +363,9 @@ declare class ArtifactsAPI {
     createFlashcards(notebookId: string, opts?: CreateQuizOptions): Promise<GenerationStatus>;
     createInfographic(notebookId: string, opts?: CreateInfographicOptions): Promise<GenerationStatus>;
     createSlideDeck(notebookId: string, opts?: CreateSlideDeckOptions): Promise<GenerationStatus>;
+    createDataTable(notebookId: string, opts?: CreateDataTableOptions): Promise<GenerationStatus>;
     createReport(notebookId: string, opts?: CreateReportOptions): Promise<GenerationStatus>;
-    createMindMap(notebookId: string, sourceIds?: string[]): Promise<GenerationStatus>;
+    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>;
     /** Download audio content as a Buffer. */
@@ -356,6 +376,12 @@ declare class ArtifactsAPI {
     getReportMarkdown(notebookId: string, artifactId: string): Promise<string | null>;
     /** Get interactive HTML for quiz/flashcard artifacts. */
     getInteractiveHtml(notebookId: string, artifactId: string): Promise<string | null>;
+    /** Download a completed slide deck as PDF or PPTX. Returns a Buffer. */
+    downloadSlideDeck(notebookId: string, artifactId: string, format?: "pdf" | "pptx"): Promise<Buffer>;
+    /** Download a completed infographic as PNG. Returns a Buffer. */
+    downloadInfographic(notebookId: string, artifactId: string): Promise<Buffer>;
+    /** Get parsed headers and rows from a completed data table artifact. */
+    getDataTableContent(notebookId: string, artifactId: string): Promise<DataTableContent | null>;
     /**
      * Fetch a Google-hosted media URL, manually following redirects to ensure
      * cookies are included on every hop. Node/Bun fetch strips the Cookie header
@@ -395,18 +421,6 @@ declare class NotebooksAPI {
     getDescription(notebookId: string): Promise<NotebookDescription>;
 }
 
-declare class NotesAPI {
-    private readonly rpc;
-    constructor(rpc: RPCCore);
-    list(notebookId: string): Promise<{
-        notes: Note[];
-        mindMaps: MindMap[];
-    }>;
-    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>;
-}
-
 interface ResearchTask {
     taskId: string;
     reportId: string | null;
@@ -523,10 +537,12 @@ interface ClientOptions {
  *
  * @example
  * ```ts
- * const client = await NotebookLMClient.connect({
- *   cookies: process.env.NOTEBOOKLM_COOKIES,
- * });
+ * // After running `npx notebooklm-sdk login` once:
+ * const client = await NotebookLMClient.connect();
  * const notebooks = await client.notebooks.list();
+ *
+ * // Or with explicit credentials:
+ * const client = await NotebookLMClient.connect({ cookiesFile: './session.json' });
  * ```
  */
 declare class NotebookLMClient {
@@ -544,11 +560,11 @@ declare class NotebookLMClient {
      * Connect to NotebookLM using cookies.
      * Fetches CSRF and session tokens from the NotebookLM homepage.
      */
-    static connect(opts: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
+    static connect(opts?: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
     /**
      * Refresh CSRF and session tokens (e.g. if they expire mid-session).
      */
     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, type ChatReference, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, ExportType, type ExportTypeValue, type GenerationStatus, type ImportedSource, InfographicDetail, type InfographicDetailValue, InfographicOrientation, type InfographicOrientationValue, InfographicStyle, type InfographicStyleValue, type MindMap, type Note, type Notebook, type NotebookDescription, NotebookLMClient, type NotebookMetadata, NotebooksAPI, NotesAPI, QuizDifficulty, type QuizDifficultyValue, QuizQuantity, type QuizQuantityValue, RPCMethod, type RPCMethodId, 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 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, type ChatReference, type ClientOptions, ConnectOptions, type ConversationTurn, type CreateAudioOptions, type CreateDataTableOptions, type CreateInfographicOptions, type CreateQuizOptions, type CreateReportOptions, type CreateSlideDeckOptions, type CreateVideoOptions, type DataTableContent, 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, 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 SourceStatus, type SourceSummary, type SourceType, SourcesAPI, type SuggestedTopic, VideoFormat, type VideoFormatValue, VideoStyle, type VideoStyleValue };