notebooklm-api 0.2.0

package/dist/api/sources.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Sources API Module
+ *
+ * Handles source document management for notebooks.
+ */
+import { ClientCore } from '../core.ts';
+import type { Source, SourceFulltext, SourceGuide } from '../types.ts';
+/**
+ * API client for source operations.
+ */
+export declare class SourcesAPI {
+    private core;
+    constructor(core: ClientCore);
+    /**
+     * Lists all sources in a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @returns List of sources
+     */
+    list(notebookId: string): Promise<Source[]>;
+    /**
+     * Gets details for a specific source.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     * @returns Source details
+     */
+    get(notebookId: string, sourceId: string): Promise<Source>;
+    /**
+     * Adds a URL source to a notebook.
+     * Automatically detects YouTube URLs.
+     *
+     * @param notebookId - The notebook ID
+     * @param url - The URL to add
+     * @returns The created source
+     */
+    addUrl(notebookId: string, url: string): Promise<Source>;
+    /**
+     * Adds copied text as a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param title - Title for the text source
+     * @param content - The text content
+     * @returns The created source
+     */
+    addText(notebookId: string, title: string, content: string): Promise<Source>;
+    /**
+     * Uploads a file as a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param filename - The filename
+     * @param content - File content as bytes
+     * @param contentType - MIME type of the file
+     * @returns The created source
+     */
+    addFile(notebookId: string, filename: string, content: Uint8Array, contentType: string): Promise<Source>;
+    /**
+     * Adds a Google Drive document as a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param driveId - The Drive document ID
+     * @returns The created source
+     */
+    addDrive(notebookId: string, driveId: string): Promise<Source>;
+    /**
+     * Deletes a source from a notebook.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID to delete
+     */
+    delete(notebookId: string, sourceId: string): Promise<void>;
+    /**
+     * Renames a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     * @param newTitle - The new title
+     */
+    rename(notebookId: string, sourceId: string, newTitle: string): Promise<void>;
+    /**
+     * Refreshes content for a URL or Drive source.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     */
+    refresh(notebookId: string, sourceId: string): Promise<void>;
+    /**
+     * Waits for a source to finish processing.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     * @param options - Polling options
+     * @returns The processed source
+     */
+    waitUntilReady(notebookId: string, sourceId: string, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<Source>;
+    /**
+     * Waits for multiple sources to be ready.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceIds - List of source IDs
+     * @param options - Polling options
+     * @returns List of processed sources
+     */
+    waitForSources(notebookId: string, sourceIds: string[], options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<Source[]>;
+    /**
+     * Gets the AI-generated guide for a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     * @returns Source guide with summary and keywords
+     */
+    getGuide(notebookId: string, sourceId: string): Promise<SourceGuide>;
+    /**
+     * Gets the full indexed text content of a source.
+     *
+     * @param notebookId - The notebook ID
+     * @param sourceId - The source ID
+     * @returns Full text content with sections
+     */
+    getFulltext(notebookId: string, sourceId: string): Promise<SourceFulltext>;
+    /**
+     * Checks if a source needs refreshing based on its age.
+     *
+     * @param source - The source to check
+     * @param maxAgeMs - Maximum age in milliseconds (default 24 hours)
+     * @returns Whether the source should be refreshed
+     */
+    checkFreshness(source: Source, maxAgeMs?: number): boolean;
+}
+//# sourceMappingURL=sources.d.ts.map

package/dist/api/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/api/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQxC,OAAO,KAAK,EAAE,MAAM,EAAc,cAAc,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAoBlG;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQjD;;;;;;OAMG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWhE;;;;;;;OAOG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY9D;;;;;;;OAOG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;;;;OAQG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAoBlB;;;;;;OAMG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcpE;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;;;;;OAMG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;OAKG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE;;;;;;;OAOG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,MAAM,CAAC;IAmClB;;;;;;;OAOG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB,GACL,OAAO,CAAC,MAAM,EAAE,CAAC;IAMpB;;;;;;OAMG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAW1E;;;;;;OAMG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC;IAW1B;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAW,GAAG,OAAO;CAI7D"}

package/dist/auth.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Authentication Module for NotebookLM Client
+ *
+ * Handles loading cookies from Playwright storage state and
+ * extracting CSRF/Session tokens from the NotebookLM homepage.
+ */
+import type { Cookie } from './types.ts';
+/**
+ * Playwright storage state format
+ */
+interface StorageState {
+    cookies: PlaywrightCookie[];
+    origins?: unknown[];
+}
+interface PlaywrightCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires: number;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite: 'Strict' | 'Lax' | 'None';
+}
+/**
+ * Authentication tokens for API requests
+ */
+export declare class AuthTokens {
+    cookies: Cookie[];
+    csrfToken: string;
+    sessionId: string;
+    constructor(cookies: Cookie[], csrfToken: string, sessionId: string);
+    /**
+     * Creates AuthTokens from a Playwright storage state file.
+     *
+     * This is the recommended initialization method.
+     */
+    static fromStorage(storagePath?: string): Promise<AuthTokens>;
+    /**
+     * Creates AuthTokens from a parsed storage state object.
+     */
+    static fromStorageState(storageState: StorageState): Promise<AuthTokens>;
+    /**
+     * Returns cookies as a header string for fetch requests.
+     */
+    getCookieHeader(): string;
+    /**
+     * Checks if the tokens appear to be valid.
+     */
+    isValid(): boolean;
+}
+/**
+ * Extracts and filters cookies from Playwright storage state.
+ *
+ * Uses domain whitelist and priority rules to ensure deterministic behavior.
+ */
+export declare function extractCookiesFromStorage(storageState: StorageState): Cookie[];
+/**
+ * Fetches CSRF and session tokens from the NotebookLM homepage.
+ *
+ * These tokens are embedded in the page HTML and required for API calls.
+ */
+export declare function fetchTokens(cookies: Cookie[]): Promise<{
+    csrfToken: string;
+    sessionId: string;
+}>;
+/**
+ * Creates an httpx-compatible cookie jar for downloads.
+ * Preserves domain information for cross-domain redirects.
+ */
+export declare function createCookieJar(cookies: Cookie[]): Map<string, string>;
+/**
+ * Refreshes authentication tokens.
+ *
+ * This helps prevent "Session Expired" errors by obtaining fresh tokens.
+ */
+export declare function refreshTokens(cookies: Cookie[]): Promise<{
+    csrfToken: string;
+    sessionId: string;
+}>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAqBzC;;GAEG;AACH,UAAU,YAAY;IACpB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,UAAU;IAEZ,OAAO,EAAE,MAAM,EAAE;IACjB,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;gBAFjB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;IAG1B;;;;OAIG;WACU,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiCnE;;OAEG;WACU,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAc9E;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB;;OAEG;IACH,OAAO,IAAI,OAAO;CAGnB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAyC9E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAStE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAED"}

package/dist/cli/commands/chat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Chat Commands
+ */
+import { Command } from 'commander';
+export declare const chatCommand: Command;
+export declare const askCommand: Command;
+//# sourceMappingURL=chat.d.ts.map

package/dist/cli/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,WAAW,SACc,CAAC;AAmDvC,eAAO,MAAM,UAAU,SAyCnB,CAAC"}

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate Commands
+ */
+import { Command } from 'commander';
+export declare const generateCommand: Command;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,eAAe,SAES,CAAC"}

package/dist/cli/commands/login.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Login Command
+ *
+ * Authenticates with Google using Playwright browser automation.
+ */
+import { Command } from 'commander';
+export declare const loginCommand: Command;
+//# sourceMappingURL=login.d.ts.map

package/dist/cli/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/login.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,eAAO,MAAM,YAAY,SAiFrB,CAAC"}

package/dist/cli/commands/notebook.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Notebook Commands
+ */
+import { Command } from 'commander';
+export declare const notebookCommand: Command;
+export declare const createCommand: Command;
+export declare const listCommand: Command;
+//# sourceMappingURL=notebook.d.ts.map

package/dist/cli/commands/notebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/notebook.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,eAAe,SACM,CAAC;AAkJnC,eAAO,MAAM,aAAa,SAiBtB,CAAC;AAGL,eAAO,MAAM,WAAW,SAiCpB,CAAC"}

package/dist/cli/commands/research.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Research Commands
+ */
+import { Command } from 'commander';
+export declare const researchCommand: Command;
+//# sourceMappingURL=research.d.ts.map

package/dist/cli/commands/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/research.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,eAAe,SACe,CAAC"}

package/dist/cli/commands/source.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Source Commands
+ */
+import { Command } from 'commander';
+export declare const sourceCommand: Command;
+//# sourceMappingURL=source.d.ts.map

package/dist/cli/commands/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,eAAO,MAAM,aAAa,SACe,CAAC"}

package/dist/cli/helpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CLI Helper Functions
+ */
+import { NotebookLMClient } from '../client.ts';
+/**
+ * Gets a configured client, handling auth errors gracefully.
+ */
+export declare function getClient(storagePath?: string): Promise<NotebookLMClient>;
+/**
+ * Formats a date for display.
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Formats a duration in milliseconds.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Truncates a string to a maximum length.
+ */
+export declare function truncate(str: string, maxLen: number): string;
+/**
+ * Prints a success message.
+ */
+export declare function success(message: string): void;
+/**
+ * Prints an error message.
+ */
+export declare function error(message: string): void;
+/**
+ * Prints an info message.
+ */
+export declare function info(message: string): void;
+/**
+ * Prints a warning message.
+ */
+export declare function warn(message: string): void;
+/**
+ * Creates a simple table from data.
+ */
+export declare function table(headers: string[], rows: string[][], columnWidths?: number[]): void;
+/**
+ * Spinner for long operations.
+ */
+export declare class Spinner {
+    private interval;
+    private frames;
+    private frameIndex;
+    private message;
+    constructor(message: string);
+    start(): void;
+    stop(finalMessage?: string): void;
+    succeed(message?: string): void;
+    fail(message?: string): void;
+}
+//# sourceMappingURL=helpers.d.ts.map

package/dist/cli/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU/E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQ7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,IAAI,CAoBN;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAI3B,KAAK,IAAI,IAAI;IAQb,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAWjC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/B,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAG7B"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * NotebookLM CLI
+ *
+ * Command-line interface for Google NotebookLM.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}