notebooklm-api 0.2.0

package/dist/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Logging Module for NotebookLM Client
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Sets the global log level
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Gets the current log level
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Creates a logger with a specific prefix
+ */
+export declare function createLogger(prefix: string): {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+};
+export declare const logger: {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;mBAWxB,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMlC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMjC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;mBAMhC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;EAMnD;AAGD,eAAO,MAAM,MAAM;mBA3BA,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMlC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMjC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;mBAMhC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;CASJ,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Path Management for NotebookLM Client
+ */
+/**
+ * Default directory for storing NotebookLM data
+ */
+export declare const DEFAULT_DATA_DIR: string;
+/**
+ * Default path for Playwright storage state (authentication)
+ */
+export declare const DEFAULT_STORAGE_PATH: string;
+/**
+ * Default path for configuration file
+ */
+export declare const DEFAULT_CONFIG_PATH: string;
+/**
+ * Default path for conversation cache
+ */
+export declare const DEFAULT_CACHE_PATH: string;
+/**
+ * Ensures the data directory exists
+ */
+export declare function ensureDataDir(): Promise<void>;
+/**
+ * Gets the storage path from environment or default
+ */
+export declare function getStoragePath(): string;
+/**
+ * Validates that a path doesn't contain traversal attempts
+ */
+export declare function validatePath(path: string): boolean;
+/**
+ * Gets the download directory for artifacts
+ */
+export declare function getDownloadDir(notebookId?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAiC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAA+C,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAwC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AAElE;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAGnD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAevC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/dist/rpc/decoder.d.ts

@@ -0,0 +1,81 @@
+/**
+ * RPC Response Decoder for NotebookLM API
+ *
+ * Handles decoding of responses from Google's batchexecute API.
+ */
+import type { RPCMethod } from './types.ts';
+/**
+ * RPC Error class for general RPC failures
+ */
+export declare class RPCError extends Error {
+    readonly rpcId?: string | undefined;
+    readonly errorCode?: number | undefined;
+    readonly rawResponse?: unknown | undefined;
+    constructor(message: string, rpcId?: string | undefined, errorCode?: number | undefined, rawResponse?: unknown | undefined);
+}
+/**
+ * Auth Error class for authentication-specific failures
+ */
+export declare class AuthError extends RPCError {
+    constructor(message: string, rpcId?: string);
+}
+/**
+ * Strips the anti-XSSI prefix from API responses.
+ *
+ * Google adds ")]}'" prefix to prevent XSSI attacks.
+ */
+export declare function stripAntiXssi(response: string): string;
+/**
+ * Parses a chunked response from batchexecute.
+ *
+ * The format alternates between byte counts and JSON payloads:
+ * ```
+ * 123
+ * ["response data"]
+ * 456
+ * ["more data"]
+ * ```
+ */
+export declare function parseChunkedResponse(response: string): unknown[];
+/**
+ * Extracts the RPC result for a specific method from parsed chunks.
+ *
+ * @param chunks - Parsed response chunks
+ * @param method - The RPC method ID to look for
+ * @returns The extracted result data
+ */
+export declare function extractRpcResult(chunks: unknown[], method: RPCMethod): unknown;
+/**
+ * Checks if an error indicates an authentication failure.
+ */
+export declare function isAuthError(error: unknown): boolean;
+/**
+ * Decodes a complete batchexecute response.
+ *
+ * @param response - Raw response text from the API
+ * @param method - The RPC method that was called
+ * @returns The extracted and parsed result
+ */
+export declare function decodeResponse(response: string, method: RPCMethod): unknown;
+/**
+ * Extracts nested data from a deeply nested array structure.
+ * NotebookLM responses often have data buried in nested arrays.
+ *
+ * @param data - The data structure to search
+ * @param indices - Array of indices to follow
+ * @returns The extracted value or undefined
+ */
+export declare function extractNested(data: unknown, indices: number[]): unknown;
+/**
+ * Recursively searches for a value in nested arrays.
+ *
+ * @param data - Data structure to search
+ * @param predicate - Function to test values
+ * @returns First matching value or undefined
+ */
+export declare function findInNested(data: unknown, predicate: (value: unknown) => boolean): unknown;
+/**
+ * Extracts all UUIDs from a nested data structure.
+ */
+export declare function extractUuids(data: unknown): string[];
+//# sourceMappingURL=decoder.d.ts.map

package/dist/rpc/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/rpc/decoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,KAAK,CAAC,EAAE,MAAM;aACd,SAAS,CAAC,EAAE,MAAM;aAClB,WAAW,CAAC,EAAE,OAAO;gBAHrC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,WAAW,CAAC,EAAE,OAAO,YAAA;CAKxC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAI5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CA6BhE;AAoBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,EAAE,SAAS,GAChB,OAAO,CAoDT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOnD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAChB,OAAO,CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GACrC,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAgBpD"}

package/dist/rpc/encoder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * RPC Request Encoder for NotebookLM API
+ *
+ * Handles encoding of RPC requests to the batchexecute format
+ * expected by Google's API.
+ */
+import { type RPCMethod, type RPCParams } from './types.ts';
+/**
+ * Encodes an RPC request into the nested array format.
+ *
+ * The format is: [[[rpc_id, json_params, null, "generic"]]]
+ */
+export declare function encodeRpcRequest(method: RPCMethod, params: RPCParams): string;
+/**
+ * Builds the HTTP request body for batchexecute.
+ *
+ * @param encodedRequest - The encoded RPC request from encodeRpcRequest()
+ * @param csrfToken - CSRF token (SNlM0e) for authentication
+ * @returns URL-encoded form body with trailing &
+ */
+export declare function buildRequestBody(encodedRequest: string, csrfToken?: string): string;
+/**
+ * Builds URL query parameters for the batchexecute endpoint.
+ *
+ * @param method - The RPC method being called
+ * @param sessionId - Session ID (FdrFJe) from page load
+ * @param sourcePath - Source path for the request (default: "/")
+ * @returns Query string parameters
+ */
+export declare function buildUrlParams(method: RPCMethod, sessionId?: string, sourcePath?: string): URLSearchParams;
+/**
+ * Builds the full URL for an RPC call.
+ */
+export declare function buildRpcUrl(baseUrl: string, method: RPCMethod, sessionId?: string): string;
+/**
+ * Encodes a file upload request for resumable upload protocol.
+ *
+ * @param _filename - Name of the file being uploaded (reserved for future use)
+ * @param contentType - MIME type of the file
+ * @param fileSize - Size of the file in bytes
+ * @returns Headers and metadata for initiating upload
+ */
+export declare function buildUploadHeaders(_filename: string, contentType: string, fileSize: number): Record<string, string>;
+/**
+ * Encodes upload metadata for source file uploads.
+ */
+export declare function buildUploadMetadata(notebookId: string, filename: string): string;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/rpc/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/rpc/encoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAYR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,SAAM,GACf,eAAe,CAYjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAGR;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR"}

package/dist/rpc/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * RPC Module Exports
+ */
+export * from './types.ts';
+export * from './encoder.ts';
+export * from './decoder.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/rpc/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * RPC Types and Constants for NotebookLM API
+ */
+export declare const API_ENDPOINTS: {
+    readonly BATCH_EXECUTE: "https://notebooklm.google.com/_/LabsTailwindUi/data/batchexecute";
+    readonly QUERY: "https://notebooklm.google.com/_/LabsTailwindUi/data/google.internal.labs.tailwind.orchestration.v1.LabsTailwindOrchestrationService/GenerateFreeFormStreamed";
+    readonly UPLOAD: "https://notebooklm.google.com/upload/_/";
+    readonly HOME: "https://notebooklm.google.com";
+};
+export declare enum RPCMethod {
+    LIST_NOTEBOOKS = "wXbhsf",
+    CREATE_NOTEBOOK = "CCqFvf",
+    GET_NOTEBOOK = "rLM1Ne",
+    RENAME_NOTEBOOK = "s0tc2d",
+    DELETE_NOTEBOOK = "WWINqb",
+    REMOVE_FROM_RECENT = "fejl7e",
+    GET_NOTEBOOK_DESCRIPTION = "VfAZjd",// SUMMARIZE
+    ADD_URL_SOURCE = "izAoDd",
+    ADD_FILE_SOURCE = "o4cbdc",
+    ADD_TEXT_SOURCE = "izAoDd",// Same as ADD_URL_SOURCE with different params
+    DELETE_SOURCE = "tGMBJ",
+    GET_SOURCE = "hizoJc",
+    REFRESH_SOURCE = "FLmJqe",
+    UPDATE_SOURCE = "b7Wfje",
+    RENAME_SOURCE = "b7Wfje",// Same as UPDATE_SOURCE
+    GET_SOURCE_GUIDE = "tr032e",
+    GET_SOURCE_FULLTEXT = "hizoJc",// Same as GET_SOURCE
+    DISCOVER_SOURCES = "qXyaNe",
+    ASK = "QUERY_ENDPOINT",// Special endpoint
+    GET_CHAT_HISTORY = "hPTbtc",
+    CONFIGURE_CHAT = "QUERY_ENDPOINT",
+    LIST_ARTIFACTS = "gArtLc",
+    CREATE_ARTIFACT = "xpWGLf",
+    GET_ARTIFACT = "BnLyuf",
+    RENAME_ARTIFACT = "rc3d8d",
+    DELETE_ARTIFACT = "V5N4be",
+    GET_GENERATION_STATUS = "gArtLc",// POLL_STUDIO
+    EXPORT_TO_DOCS = "Krh3pd",
+    EXPORT_TO_SHEETS = "Krh3pd",
+    GET_INTERACTIVE_HTML = "v9rmvd",
+    CREATE_AUDIO = "AHyHrd",
+    GET_AUDIO = "VUsiyb",
+    DELETE_AUDIO = "sJDbic",
+    CREATE_VIDEO = "R7cb6c",
+    START_FAST_RESEARCH = "Ljjv0c",
+    START_DEEP_RESEARCH = "QA9ei",
+    POLL_RESEARCH = "e3bVqc",
+    IMPORT_RESEARCH_SOURCES = "LBwxtb",
+    SHARE_ARTIFACT = "RGP97b",
+    SHARE_NOTEBOOK = "QDyure",
+    GET_SHARE_STATUS = "JFMDGd",
+    CREATE_NOTE = "CYK0Xb",
+    GET_NOTES = "cFji9",
+    UPDATE_NOTE = "cYAfTb",
+    DELETE_NOTE = "AH0mwd",
+    GENERATE_MIND_MAP = "yyryJe"
+}
+export declare enum StudioContentType {
+    AUDIO = 1,
+    REPORT = 2,
+    VIDEO = 3,
+    QUIZ = 4,// Also used for flashcards (variant distinction)
+    MIND_MAP = 5,
+    INFOGRAPHIC = 6,
+    SLIDE_DECK = 7,
+    DATA_TABLE = 8
+}
+export declare enum AudioFormat {
+    MP3 = 1,
+    WAV = 2
+}
+export declare enum AudioLength {
+    SHORT = 1,// ~5 minutes
+    MEDIUM = 2,// ~15 minutes
+    LONG = 3
+}
+export declare enum VideoFormat {
+    MP4 = 1,
+    WEBM = 2
+}
+export declare enum VideoStyle {
+    AUTO = 1,
+    DOCUMENTARY = 2,
+    EDUCATIONAL = 3,
+    PRESENTATION = 4,
+    STORYTELLING = 5,
+    WHITEBOARD = 6,
+    PAPER_CRAFT = 7
+}
+export declare enum QuizDifficulty {
+    EASY = 1,
+    MEDIUM = 2,
+    HARD = 3
+}
+export declare enum ReportFormat {
+    BRIEFING_DOC = 1,
+    STUDY_GUIDE = 2,
+    BLOG_POST = 3,
+    CUSTOM = 4
+}
+export declare enum InfographicOrientation {
+    PORTRAIT = 1,
+    LANDSCAPE = 2
+}
+export declare enum ChatMode {
+    DEFAULT = 0,
+    GUIDED = 1,
+    CRITICAL = 2
+}
+export declare enum ResponseLength {
+    CONCISE = 1,
+    BALANCED = 2,
+    COMPREHENSIVE = 3
+}
+export declare enum ResearchSourceType {
+    WEB = 1,
+    DRIVE = 2
+}
+export declare enum ResearchMode {
+    FAST = 1,
+    DEEP = 2
+}
+export declare enum SourceStatus {
+    PROCESSING = 1,
+    READY = 2,
+    ERROR = 3
+}
+export declare enum GenerationStatusCode {
+    PENDING = 0,
+    IN_PROGRESS = 1,
+    COMPLETED = 2,
+    ERROR = 3
+}
+export declare enum DriveDocType {
+    DOCUMENT = 1,
+    SPREADSHEET = 2,
+    PRESENTATION = 3,
+    PDF = 4
+}
+export declare enum ExportDestination {
+    GOOGLE_DOCS = 1,
+    GOOGLE_SHEETS = 2
+}
+export declare function getSourceStatusString(code: number): string;
+export declare function getGenerationStatusString(code: number): string;
+export type RPCParams = (string | number | boolean | null | RPCParams)[];
+export declare const BUILD_LABEL = "ProjectMakiServiceUi_20240101.00_p0";
+//# sourceMappingURL=types.d.ts.map

package/dist/rpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Type Definitions for NotebookLM Client
+ */
+import { z } from 'zod';
+import { StudioContentType, AudioFormat, VideoFormat, QuizDifficulty, ReportFormat, ChatMode, ResponseLength } from './rpc/types.ts';
+export { StudioContentType, AudioFormat, AudioLength, VideoFormat, VideoStyle, QuizDifficulty, ReportFormat, InfographicOrientation, ChatMode, ResponseLength, ResearchSourceType, ResearchMode, SourceStatus, GenerationStatusCode, DriveDocType, ExportDestination, } from './rpc/types.ts';
+export interface Notebook {
+    id: string;
+    title: string;
+    createdAt: Date;
+    updatedAt: Date;
+    isOwner: boolean;
+    sourceCount?: number;
+}
+export interface NotebookDescription {
+    summary: string;
+    suggestedTopics: SuggestedTopic[];
+}
+export interface SuggestedTopic {
+    question: string;
+    prompt: string;
+}
+export interface Source {
+    id: string;
+    notebookId: string;
+    title: string;
+    type: SourceType;
+    url?: string;
+    status: 'processing' | 'ready' | 'error';
+    createdAt: Date;
+    wordCount?: number;
+    errorMessage?: string;
+}
+export type SourceType = 'url' | 'youtube' | 'text' | 'file' | 'drive' | 'unknown';
+export interface SourceFulltext {
+    sourceId: string;
+    title: string;
+    content: string;
+    sections: SourceSection[];
+}
+export interface SourceSection {
+    title?: string;
+    content: string;
+    startIndex: number;
+    endIndex: number;
+}
+export interface SourceGuide {
+    sourceId: string;
+    summary: string;
+    keywords: string[];
+}
+export interface AskResult {
+    answer: string;
+    references: ChatReference[];
+    conversationId: string;
+}
+export interface ChatReference {
+    sourceId: string;
+    sourceTitle: string;
+    text: string;
+    startChar: number;
+    endChar: number;
+}
+export interface ConversationTurn {
+    id: string;
+    question: string;
+    answer: string;
+    references: ChatReference[];
+    timestamp: Date;
+}
+export interface ChatConfig {
+    mode: ChatMode;
+    responseLength: ResponseLength;
+    persona?: string;
+}
+export interface Artifact {
+    id: string;
+    notebookId: string;
+    title: string;
+    type: StudioContentType;
+    status: 'pending' | 'in_progress' | 'completed' | 'error';
+    createdAt: Date;
+    url?: string;
+    errorMessage?: string;
+}
+export interface GenerationStatus {
+    artifactId: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'error';
+    progress?: number;
+    url?: string;
+    errorMessage?: string;
+}
+export interface AudioOptions {
+    format?: AudioFormat;
+    language?: string;
+    instructions?: string;
+}
+export interface VideoOptions {
+    format?: VideoFormat;
+    language?: string;
+    instructions?: string;
+}
+export interface ReportOptions {
+    format?: ReportFormat;
+    customPrompt?: string;
+    includeSourceRefs?: boolean;
+}
+export interface QuizOptions {
+    questionCount?: number;
+    difficulty?: QuizDifficulty;
+    instructions?: string;
+}
+export interface FlashcardOptions {
+    cardCount?: number;
+    instructions?: string;
+}
+export interface MindMapOptions {
+    instructions?: string;
+}
+export interface InfographicOptions {
+    instructions?: string;
+}
+export interface SlideOptions {
+    instructions?: string;
+}
+export interface DataTableOptions {
+    instructions?: string;
+}
+export interface ResearchTask {
+    taskId: string;
+    reportId: string;
+    query: string;
+    source: 'web' | 'drive';
+    mode: 'fast' | 'deep';
+}
+export interface ResearchResult {
+    taskId: string;
+    status: 'in_progress' | 'completed';
+    summary?: string;
+    sources: ResearchSource[];
+}
+export interface ResearchSource {
+    url: string;
+    title: string;
+    snippet?: string;
+}
+export interface Note {
+    id: string;
+    notebookId: string;
+    title: string;
+    content: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface AuthTokens {
+    cookies: Cookie[];
+    csrfToken: string;
+    sessionId: string;
+}
+export interface Cookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+export declare const NotebookSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    isOwner: z.ZodBoolean;
+    sourceCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const SourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    notebookId: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodEnum<{
+        unknown: "unknown";
+        url: "url";
+        youtube: "youtube";
+        text: "text";
+        file: "file";
+        drive: "drive";
+    }>;
+    url: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        processing: "processing";
+        ready: "ready";
+        error: "error";
+    }>;
+    createdAt: z.ZodDate;
+    wordCount: z.ZodOptional<z.ZodNumber>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AskResultSchema: z.ZodObject<{
+    answer: z.ZodString;
+    references: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        sourceTitle: z.ZodString;
+        text: z.ZodString;
+        startChar: z.ZodNumber;
+        endChar: z.ZodNumber;
+    }, z.core.$strip>>;
+    conversationId: z.ZodString;
+}, z.core.$strip>;
+export declare const ArtifactSchema: z.ZodObject<{
+    id: z.ZodString;
+    notebookId: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodEnum<typeof StudioContentType>;
+    status: z.ZodEnum<{
+        error: "error";
+        pending: "pending";
+        in_progress: "in_progress";
+        completed: "completed";
+    }>;
+    createdAt: z.ZodDate;
+    url: z.ZodOptional<z.ZodString>;
+    errorMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "notebooklm-api",
+  "version": "0.2.0",
+  "description": "Unofficial TypeScript/JavaScript client and CLI for Google NotebookLM API",
+  "author": "e-yc",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/e-yc/notebooklm-api.git"
+  },
+  "homepage": "https://github.com/e-yc/notebooklm-api#readme",
+  "bugs": {
+    "url": "https://github.com/e-yc/notebooklm-api/issues"
+  },
+  "keywords": [
+    "notebooklm",
+    "google",
+    "ai",
+    "notebook",
+    "podcast",
+    "audio",
+    "video",
+    "slide-deck",
+    "api",
+    "client",
+    "typescript",
+    "cli"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js",
+      "types": "./dist/cli/index.d.ts"
+    }
+  },
+  "bin": {
+    "notebooklm": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.0.0",
+    "zod": "^4.3.5"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.52.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}