notebooklm-kit 0.0.1 → 2.1.1

package/dist/src/services/artifacts.d.ts

@@ -0,0 +1,1017 @@
+/**
+ * Artifacts service
+ * Handles all artifact operations (documents, presentations, audio, video, quizzes, flashcards, etc.)
+ */
+import { RPCClient } from '../rpc/rpc-client.js';
+import { ArtifactType, ArtifactState } from '../types/artifact.js';
+export { ArtifactType, ArtifactState } from '../types/artifact.js';
+export declare enum ShareOption {
+    PRIVATE = 0,
+    PUBLIC = 1
+}
+export interface Artifact {
+    artifactId: string;
+    type?: ArtifactType;
+    state?: ArtifactState;
+    title?: string;
+    sourceIds?: string[];
+    createdAt?: string;
+    updatedAt?: string;
+    audioData?: string;
+    videoData?: string;
+    status?: string;
+    duration?: number;
+}
+export interface AudioOverview {
+    projectId: string;
+    audioId?: string;
+    title?: string;
+    audioData?: string;
+    isReady: boolean;
+    state?: ArtifactState;
+    duration?: number;
+    createdAt?: string;
+}
+export interface VideoOverview {
+    projectId: string;
+    videoId?: string;
+    title?: string;
+    videoData?: string;
+    isReady: boolean;
+    state?: ArtifactState;
+    createdAt?: string;
+}
+export interface CreateAudioOverviewOptions {
+    title?: string;
+    instructions?: string;
+    sourceIds?: string[];
+    customization?: AudioCustomization;
+}
+export interface CreateVideoOverviewOptions {
+    title?: string;
+    instructions?: string;
+    sourceIds?: string[];
+    customization?: VideoCustomization;
+}
+export interface ShareAudioResult {
+    shareUrl: string;
+    shareId: string;
+    isPublic: boolean;
+}
+export interface ShareArtifactOptions {
+    users?: Array<{
+        email: string;
+        role: 2 | 3 | 4;
+    }>;
+    notify?: boolean;
+    accessType?: 1 | 2;
+}
+export interface ShareArtifactResult {
+    shareUrl: string;
+    success: boolean;
+    notebookId: string;
+    accessType: 1 | 2;
+    isShared: boolean;
+    users?: Array<{
+        email: string;
+        role: 2 | 3;
+    }>;
+}
+export interface QuizCustomization {
+    numberOfQuestions?: 1 | 2 | 3;
+    difficulty?: 1 | 2 | 3;
+    language?: string;
+}
+export interface FlashcardCustomization {
+    numberOfCards?: 1 | 2 | 3;
+    difficulty?: 1 | 2 | 3;
+    language?: string;
+}
+export interface SlideDeckCustomization {
+    format?: 2 | 3;
+    language?: string;
+    length?: 1 | 2 | 3;
+}
+export interface InfographicCustomization {
+    language?: string;
+    orientation?: 1 | 2 | 3;
+    levelOfDetail?: 1 | 2 | 3;
+}
+export interface AudioCustomization {
+    format?: 0 | 1 | 2 | 3;
+    language?: string;
+    length?: 1 | 2 | 3;
+}
+export interface VideoCustomization {
+    format?: 1 | 2;
+    language?: string;
+    visualStyle?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+    focus?: string;
+    customStyleDescription?: string;
+}
+export interface CreateArtifactOptions {
+    title?: string;
+    instructions?: string;
+    sourceIds?: string[];
+    customization?: QuizCustomization | FlashcardCustomization | SlideDeckCustomization | InfographicCustomization | AudioCustomization | VideoCustomization;
+}
+export interface QuizQuestion {
+    question: string;
+    options: string[];
+    correctAnswer: number;
+    explanation?: string;
+    hint?: string;
+    reasoning?: string;
+    optionReasons?: string[];
+}
+export interface QuizData {
+    questions: QuizQuestion[];
+    totalQuestions: number;
+}
+export interface FlashcardData {
+    csv: string;
+    flashcards?: Array<{
+        question: string;
+        answer: string;
+    }>;
+}
+export interface ParsedFlashcardData {
+    flashcards: Array<{
+        question: string;
+        answer: string;
+    }>;
+    totalCards: number;
+    csv: string;
+}
+export interface AudioArtifact extends Artifact {
+    audioData: string;
+    duration?: number;
+    status?: string;
+}
+export interface VideoArtifact extends Artifact {
+    videoData: string;
+    status?: string;
+}
+export interface InfographicImageData {
+    imageUrl: string;
+    imageData?: Uint8Array | ArrayBuffer;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+}
+export interface FetchInfographicOptions {
+    downloadImage?: boolean;
+    cookies?: string;
+}
+export interface DownloadSlidesOptions {
+    googleDomainCookies?: string;
+}
+export interface GetSlideOptions {
+    /** Download format: 'pdf' (default) or 'png' */
+    downloadAs?: 'pdf' | 'png';
+    /** Output directory path (required for slides) */
+    outputPath: string;
+}
+export interface GetVideoOptions {
+    /** Output directory path (required for videos) */
+    outputPath: string;
+}
+export interface CreateReportOptions {
+    instructions?: string;
+    sourceIds?: string[];
+    title?: string;
+    subtitle?: string;
+    language?: string;
+}
+export interface ReportContent {
+    title: string;
+    content: string;
+    sections?: Array<{
+        title: string;
+        content: string;
+    }>;
+}
+/**
+ * Service for artifact operations
+ */
+declare class VideoService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateVideoOverviewOptions): Promise<VideoOverview>;
+}
+declare class AudioService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateAudioOverviewOptions): Promise<AudioOverview>;
+}
+declare class InfographicService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+declare class MindMapService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+declare class ReportService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+declare class FlashcardService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+declare class QuizService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+declare class SlideService {
+    private artifactsService;
+    constructor(artifactsService: ArtifactsService);
+    create(notebookId: string, options?: CreateArtifactOptions): Promise<Artifact>;
+}
+export declare class ArtifactsService {
+    private rpc;
+    private quota?;
+    readonly video: VideoService;
+    readonly audio: AudioService;
+    readonly infographic: InfographicService;
+    readonly mindmap: MindMapService;
+    readonly report: ReportService;
+    readonly flashcard: FlashcardService;
+    readonly quiz: QuizService;
+    readonly slide: SlideService;
+    private notebookLanguageService;
+    constructor(rpc: RPCClient, quota?: import("../utils/quota.js").QuotaManager | undefined);
+    /**
+     * Get the default language for a notebook
+     * Uses the notebook's default output language if available, otherwise falls back to 'en'
+     *
+     * @param notebookId - The notebook ID
+     * @returns The default language code
+     */
+    private getDefaultLanguage;
+    /**
+     * List all artifacts for a notebook
+     *
+     * **What it does:** Retrieves a list of all artifacts (quizzes, flashcards, study guides,
+     * mind maps, infographics, slide decks, reports, audio, video) associated with a notebook.
+     *
+     * **Input:**
+     * - `notebookId` (string, required): The ID of the notebook to list artifacts from
+     * - `options` (object, optional): Filtering options
+     *   - `type` (ArtifactType, optional): Filter by artifact type
+     *   - `state` (ArtifactState, optional): Filter by artifact state
+     *
+     * **Output:** Returns an array of `Artifact` objects, each containing:
+     * - `artifactId`: Unique identifier for the artifact
+     * - `type`: Artifact type (QUIZ, FLASHCARDS, REPORT, MIND_MAP, INFOGRAPHIC, SLIDE_DECK, AUDIO, VIDEO, etc.)
+     * - `state`: Current state (CREATING, READY, FAILED)
+     * - `title`: Artifact title/name
+     * - `sourceIds`: Source IDs used to create the artifact
+     * - `createdAt`, `updatedAt`: Timestamps
+     *
+     * **Next steps:**
+     * - Use `get(artifactId)` to fetch detailed artifact information
+     * - Use `download(artifactId)` to retrieve artifact content (for quizzes, flashcards, audio, etc.)
+     * - Check `state` field to see if artifact is READY before downloading
+     *
+     * @param notebookId - The notebook ID
+     * @param options - Filtering options
+     *
+     * @example
+     * ```typescript
+     * // List all artifacts
+     * const artifacts = await client.artifacts.list('notebook-id');
+     *
+     * // Filter by type
+     * const quizzes = await client.artifacts.list('notebook-id', { type: ArtifactType.QUIZ });
+     *
+     * // Filter by state
+     * const ready = await client.artifacts.list('notebook-id', { state: ArtifactState.READY });
+     *
+     * // Filter by both type and state
+     * const readyQuizzes = await client.artifacts.list('notebook-id', {
+     *   type: ArtifactType.QUIZ,
+     *   state: ArtifactState.READY
+     * });
+     * ```
+     */
+    list(notebookId: string, options?: {
+        type?: ArtifactType;
+        state?: ArtifactState;
+    }): Promise<Artifact[]>;
+    /**
+     * Rename an artifact
+     *
+     * **What it does:** Changes the display name/title of an existing artifact. Works for all artifact
+     * types (quiz, flashcards, study guide, mind map, infographic, slide deck, report, audio, video).
+     *
+     * **Input:**
+     * - `artifactId` (string, required): The ID of the artifact to rename
+     *   - Use the artifact ID from `create()` or `list()` for all artifact types
+     *   - Audio and video artifacts have their own artifactId (not the notebook ID)
+     * - `newTitle` (string, required): The new title/name for the artifact
+     *
+     * **Output:** Returns the updated `Artifact` object with the new title.
+     *
+     * **Note:**
+     * - This only updates the title. To update other fields, use `update()`.
+     * - Works for all artifact types (quiz, flashcards, study guide, mind map, infographic, slide deck, report, audio, video)
+     *
+     * @param artifactId - The artifact ID (from create() or list())
+     * @param newTitle - New title
+     *
+     * @example
+     * ```typescript
+     * // Rename any artifact type
+     * const artifact = await client.artifacts.rename('artifact-id', 'My Updated Quiz');
+     * console.log(`Renamed to: ${artifact.title}`);
+     *
+     * // Rename audio artifact (use audioId from create() or list())
+     * const audio = await sdk.artifacts.audio.create('notebook-id');
+     * const renamed = await client.artifacts.rename(audio.audioId, 'My Audio Overview');
+     * ```
+     */
+    rename(artifactId: string, newTitle: string): Promise<Artifact>;
+    /**
+     * Delete an artifact
+     *
+     * **What it does:** Permanently removes an artifact from the notebook. Works for all artifact types
+     * (quiz, flashcards, study guide, mind map, infographic, slide deck, report, audio, video).
+     * This action cannot be undone.
+     *
+     * **Input:**
+     * - `artifactId` (string, required): The ID of the artifact to delete
+     *   - Use the artifact ID from `create()` or `list()` for all artifact types
+     *   - Audio and video artifacts have their own artifactId (not the notebook ID)
+     * - `notebookId` (string, optional): Optional notebook ID (helpful for audio/video artifacts if get() fails)
+     *
+     * **Output:** Returns `void` on success. Throws an error if deletion fails.
+     *
+     * **Note:**
+     * - Deletion is permanent and cannot be undone
+     * - Works for all artifact types (quiz, flashcards, study guide, mind map, infographic, slide deck, report, audio, video)
+     * - Audio and video artifacts use V5N4be RPC with `[[2], artifactId]` structure
+     * - Other artifacts use WxBZtb RPC with `[artifactId]` structure
+     *
+     * @param artifactId - The artifact ID (from create() or list())
+     * @param notebookId - Optional notebook ID (helpful for audio/video if get() needs it)
+     *
+     * @example
+     * ```typescript
+     * // Delete any artifact type (recommended - automatically detects type)
+     * await client.artifacts.delete('artifact-id');
+     *
+     * // Delete with notebook ID (helpful if get() fails)
+     * await client.artifacts.delete('artifact-id', 'notebook-id');
+     * ```
+     */
+    delete(artifactId: string, notebookId?: string): Promise<void>;
+    /**
+     * Share an artifact
+     *
+     * **What it does:** Shares an artifact (or the notebook containing the artifact) with specific users
+     * or makes it publicly accessible via a shareable link. Works for all artifact types. Artifacts are
+     * shared at the notebook level, so sharing an artifact shares the entire notebook.
+     *
+     * **Input:**
+     * - `notebookId` (string, required): The ID of the notebook containing the artifact
+     * - `options` (object, optional): Sharing options:
+     *   - `users` (array, optional): Array of users to share with:
+     *     - `email` (string, required): User email address
+     *     - `role` (number, required): User role - 2=editor, 3=viewer, 4=remove
+     *   - `notify` (boolean, optional): Send notification to users (default: true, only used when users are provided)
+     *   - `accessType` (number, optional): Access type - 1=anyone with link, 2=restricted (default: 2)
+     *
+     * **Output:** Returns a `ShareArtifactResult` object containing:
+     * - `shareUrl`: Shareable URL for the notebook
+     * - `success`: Whether the share operation succeeded
+     * - `notebookId`: The notebook ID that was shared
+     * - `accessType`: Access type (1=anyone with link, 2=restricted)
+     * - `isShared`: Whether the notebook is shared
+     * - `users`: Array of users with access (if users were shared)
+     *
+     * **Note:**
+     * - Artifacts are shared at the notebook level - sharing an artifact shares the entire notebook
+     * - Must provide either `users` array or `accessType=1` (anyone with link)
+     * - User roles: 2=editor, 3=viewer, 4=remove (removes user access)
+     *
+     * @param notebookId - The notebook ID containing the artifact
+     * @param options - Sharing options
+     *
+     * @example
+     * ```typescript
+     * // Share with specific users
+     * const result = await client.artifacts.share('notebook-id', {
+     *   users: [
+     *     { email: 'user@example.com', role: 3 }, // viewer
+     *     { email: 'editor@example.com', role: 2 } // editor
+     *   ],
+     *   notify: true
+     * });
+     * console.log(`Shared! URL: ${result.shareUrl}`);
+     *
+     * // Share publicly (anyone with link)
+     * const publicResult = await client.artifacts.share('notebook-id', {
+     *   accessType: 1
+     * });
+     * console.log(`Public share URL: ${publicResult.shareUrl}`);
+     *
+     * // Remove user access
+     * await client.artifacts.share('notebook-id', {
+     *   users: [{ email: 'user@example.com', role: 4 }] // remove
+     * });
+     * ```
+     */
+    share(notebookId: string, options?: ShareArtifactOptions): Promise<ShareArtifactResult>;
+    /**
+     * Get artifact details
+     *
+     * **What it does:** Retrieves detailed information about a specific artifact, including its
+     * current state, metadata, and content references.
+     *
+     * **Input:**
+     * - `artifactId` (string, required): The ID of the artifact to retrieve
+     *   - Use the artifact ID from `create()` or `list()` for all artifact types
+     *   - Audio and video artifacts have their own artifactId (not the notebook ID)
+     * - `notebookId` (string, optional): Optional notebook ID (helpful for audio/video if get() needs it)
+     * - `options` (object, optional): Additional options
+     *   - For reports: `exportToDocs?: boolean` or `exportToSheets?: boolean` - Export report to Google Docs/Sheets and return URL
+     *   - For slides: `downloadAs?: 'pdf' | 'png'` (default: 'pdf') and `outputPath: string` (required) - Download slides as PDF or PNG files
+     *   - For videos: `outputPath: string` (required) - Download video as MP4 file
+     *
+     * **Output:** Returns an `Artifact` object containing:
+     * - `artifactId`: Unique identifier
+     * - `type`: Artifact type (QUIZ, FLASHCARDS, REPORT, MIND_MAP, INFOGRAPHIC, SLIDE_DECK, AUDIO, VIDEO, etc.)
+     * - `state`: Current state - check this to see if artifact is ready:
+     *   - `CREATING`: Artifact is still being generated
+     *   - `READY`: Artifact is complete and ready to use
+     *   - `FAILED`: Artifact creation failed
+     * - `title`: Display name
+     * - `sourceIds`: Source IDs used in creation
+     * - `createdAt`, `updatedAt`: Timestamps
+     * - For QUIZ: Returns `Artifact + QuizData` (questions, options, correct answers, explanations)
+     * - For FLASHCARDS: Returns `Artifact + FlashcardData` (flashcards array, CSV, totalCards)
+     * - For AUDIO: Returns `Artifact + audioData` (base64 audio data)
+     * - For VIDEO: Downloads video (requires `outputPath` option) - returns `Artifact + { downloadPath: string }`
+     * - For SLIDE_DECK: Downloads slides (requires `outputPath` option) - returns `Artifact + { downloadPath: string, downloadFormat: 'pdf' | 'png' }`
+     * - For INFOGRAPHIC: Returns `Artifact + InfographicImageData`
+     * - For REPORT: Returns `Artifact + ReportContent` or `Artifact + { exportUrl: string }` if export options provided
+     * - For MIND_MAP: Returns `Artifact + { experimental: true }`
+     *
+     * **Next steps:**
+     * - Check `state` field - if `CREATING`, wait and poll again using `get()`
+     * - If `READY`, the full data is automatically included in the response
+     * - For reports with export options, the export URL is returned instead of content
+     *
+     * @param artifactId - The artifact ID
+     * @param notebookId - Optional notebook ID (for audio artifacts)
+     * @param options - Additional options (export options for reports)
+     *
+     * @example
+     * ```typescript
+     * // Get artifact details
+     * const artifact = await client.artifacts.get('artifact-id', 'notebook-id');
+     *
+     * // Get quiz with full data
+     * const quiz = await client.artifacts.get('quiz-id', 'notebook-id');
+     * console.log(`Quiz has ${quiz.totalQuestions} questions`);
+     *
+     * // Get report and export to Google Docs
+     * const report = await client.artifacts.get('report-id', 'notebook-id', { exportToDocs: true });
+     * console.log('Google Docs URL:', report.exportUrl);
+     *
+     * // Get audio artifact (use audioId from create() or list())
+     * const audio = await sdk.artifacts.audio.create('notebook-id');
+     * const audioData = await client.artifacts.get(audio.audioId, 'notebook-id');
+     *
+     * // Download slide deck as PDF (default)
+     * const slides = await client.artifacts.get('slide-id', 'notebook-id', { outputPath: './downloads' });
+     * console.log('Slides saved to:', slides.downloadPath);
+     *
+     * // Download slide deck as PNG files
+     * const slidesPng = await client.artifacts.get('slide-id', 'notebook-id', { downloadAs: 'png', outputPath: './downloads' });
+     * console.log('PNG files saved to:', slidesPng.downloadPath);
+     *
+     * // Download video as MP4
+     * const video = await client.artifacts.get('video-id', 'notebook-id', { outputPath: './downloads' });
+     * console.log('Video saved to:', video.downloadPath);
+     * ```
+     */
+    get(artifactId: string, notebookId?: string, options?: {
+        exportToDocs?: boolean;
+        exportToSheets?: boolean;
+    } & GetSlideOptions & GetVideoOptions): Promise<Artifact | QuizData | FlashcardData | AudioArtifact | VideoArtifact | any>;
+    /**
+     * Create an artifact
+     *
+     * **What it does:** Creates a new artifact (quiz, flashcards, study guide, mind map, infographic,
+     * slide deck, report, audio overview, or video overview) from the sources in a notebook. The
+     * artifact generation process begins immediately but may take time to complete.
+     *
+     * **⚠️ IMPORTANT: Sources Required**
+     * - **The notebook must have at least one source** before creating artifacts
+     * - `sourceIds` (optional): If provided, only those sources will be used. If omitted or empty, **all sources in the notebook** will be used automatically
+     * - This is a convenience feature - the SDK automatically fetches all sources when `sourceIds` is omitted
+     * - Provide `sourceIds` as an array of source ID strings (e.g., `['source-id-1', 'source-id-2']`) to use only specific sources
+     * - Use `sources.list(notebookId)` to get available source IDs if you want to filter
+     *
+     * **Input:**
+     * - `notebookId` (string, required): The notebook containing the sources to use
+     * - `type` (ArtifactType, required): The type of artifact to create:
+     *   - `ArtifactType.QUIZ` - Multiple choice questions with explanations
+     *   - `ArtifactType.FLASHCARDS` - Question/answer pairs for memorization
+     *   - `ArtifactType.REPORT` - Comprehensive report/document
+     *   - `ArtifactType.MIND_MAP` - Visual concept mapping
+     *   - `ArtifactType.INFOGRAPHIC` - Visual data summary
+     *   - `ArtifactType.SLIDE_DECK` - Presentation slides
+     *   - `ArtifactType.AUDIO` - Audio overview (podcast-style)
+     *   - `ArtifactType.VIDEO` - Video overview
+     * - `options` (CreateArtifactOptions, optional): Creation parameters:
+     *   - `title` (string, optional): Display name for the artifact
+     *   - `instructions` (string, optional): Custom instructions for generation (e.g., "Focus on key concepts")
+     *   - `sourceIds` (string[], optional): Source IDs to use for artifact generation (e.g., `['source-id-1', 'source-id-2']`)
+     *     - If provided: Only the specified sources will be used
+     *     - If omitted or empty: **All sources in the notebook** will be used automatically (SDK convenience feature)
+     *     - The notebook must have at least one source before creating artifacts
+     *   - `customization` (object, optional): Type-specific customization options (see below)
+     *
+     * **Customization Options by Type:**
+     *
+     * **Note:** Customization is only supported for the following artifact types:
+     * Quiz, Flashcards, Slide Deck, Infographic, Audio, Video.
+     *
+     * Other artifact types (Mind Map, Report) do not support customization.
+     *
+     * **Quiz (`QuizCustomization`):**
+     * - `customization.numberOfQuestions` (1 | 2 | 3, optional): Number of questions
+     *   - `1` = Fewer questions
+     *   - `2` = Standard (default)
+     *   - `3` = More questions
+     * - `customization.difficulty` (1 | 2 | 3, optional): Difficulty level
+     *   - `1` = Easy
+     *   - `2` = Medium (default)
+     *   - `3` = Hard
+     * - `customization.language` (string, optional): Language code (use NotebookLMLanguage enum or ISO 639-1 code, e.g., 'en', 'hi', 'ta')
+   *   - NotebookLM supports 80+ languages for artifacts
+   *   - Use `NotebookLMLanguage` enum for type safety, or pass ISO 639-1 codes directly
+     * - `instructions` (string, optional): Custom instructions for question focus
+     *
+     * **Flashcards (`FlashcardCustomization`):**
+     * - `customization.numberOfCards` (1 | 2 | 3, optional): Number of flashcard pairs
+     *   - `1` = Fewer cards
+     *   - `2` = Standard (default)
+     *   - `3` = More cards
+     * - `customization.difficulty` (1 | 2 | 3, optional): Difficulty level
+     *   - `1` = Easy
+     *   - `2` = Medium (default)
+     *   - `3` = Hard
+     * - `customization.language` (string, optional): Language code (use NotebookLMLanguage enum or ISO 639-1 code, e.g., 'en', 'hi', 'ta')
+   *   - NotebookLM supports 80+ languages for artifacts
+   *   - Use `NotebookLMLanguage` enum for type safety, or pass ISO 639-1 codes directly
+     * - `instructions` (string, optional): Custom instructions for topic focus
+     *
+     * **Slide Deck (`SlideDeckCustomization`):**
+     * - `customization.format` (2 | 3, optional): Presentation format
+     *   - `2` = Presenter slides (default)
+     *   - `3` = Detailed deck
+     * - `customization.language` (string, optional): Language code (use NotebookLMLanguage enum or ISO 639-1 code, e.g., 'en')
+   *   - NotebookLM supports 80+ languages for slide decks
+     * - `customization.length` (1 | 2 | 3, optional): Length preference
+     *   - `1` = Short
+     *   - `2` = Default (default)
+     *   - `3` = Long
+     * - `instructions` (string, optional): Used as description/theme for the presentation
+     *
+     * **Infographic (`InfographicCustomization`):**
+     * - `customization.language` (string, optional): Language code (use NotebookLMLanguage enum or ISO 639-1 code, e.g., 'en', 'hi', 'ta')
+   *   - NotebookLM supports 80+ languages for artifacts
+   *   - Use `NotebookLMLanguage` enum for type safety, or pass ISO 639-1 codes directly
+     * - `customization.orientation` (1 | 2 | 3, optional): Visual orientation/style
+     *   - `1` = Landscape (default)
+     *   - `2` = Portrait
+     *   - `3` = Square
+     * - `customization.levelOfDetail` (1 | 2 | 3, optional): Level of detail
+     *   - `1` = Concise
+     *   - `2` = Standard (default)
+     *   - `3` = Detailed
+     *
+     * **Audio Overview (`AudioCustomization`):**
+     * - `customization.format` (0 | 1 | 2 | 3, optional): Audio format type
+     *   - `0` = Deep dive (default)
+     *   - `1` = Brief
+     *   - `2` = Critique
+     *   - `3` = Debate
+     * - `customization.language` (string, optional): Language code (e.g., 'en', 'hi')
+     * - `customization.length` (1 | 2 | 3, optional): Length preference
+     *   - `1` = Short
+     *   - `2` = Default (default)
+     *   - `3` = Long
+     * - `instructions` (string, optional): Custom instructions for content and style
+     *
+     * **Video Overview (`VideoCustomization`):**
+     * - `customization.format` (1 | 2, optional): Video format
+     *   - `1` = Explainer (default)
+     *   - `2` = Brief
+     * - `customization.language` (string, optional): Language code (use NotebookLMLanguage enum or ISO 639-1 code, default: 'en')
+   *   - NotebookLM supports 80+ languages for video overviews
+     * - `customization.visualStyle` (0 | 1 | 2 | 3 | 4 | 5, optional): Visual style
+     *   - `0` = Auto-select (default)
+     *   - `1` = Custom
+     *   - `2` = Classic
+     *   - `3` = Whiteboard
+     *   - `4` = Kawaii
+     *   - `5` = Anime
+     * - `sourceIds` (string[], optional): Specify sources to include. If omitted, all sources in the notebook will be used
+     * - `instructions` (string, optional): Detailed instructions for video content and style
+     *
+     * **Mind Map, Report:**
+     * - Customization is NOT supported for these artifact types
+     * - Use `title` and `instructions` only
+     *
+     * **Output:** Returns an `Artifact` object with:
+     * - `artifactId`: Unique identifier (save this for later operations)
+     * - `type`: The artifact type you specified
+     * - `state`: Usually `CREATING` initially (check with `get()` to see when it becomes `READY`)
+     * - `title`: The title (if provided)
+     * - `sourceIds`: Sources used for generation
+     * - `createdAt`, `updatedAt`: Timestamps
+     *
+     * **Next steps:**
+     * 1. **Poll for completion:** Use `get(artifactId)` periodically to check if `state === ArtifactState.READY`
+     * 2. **Download content:** Once ready, use `download(artifactId)` to get the actual data:
+     *    - Quizzes: Returns `QuizData` with questions, options, correct answers, explanations
+     *    - Flashcards: Returns `FlashcardData` with CSV string and parsed flashcards
+     *    - Audio: Returns `AudioArtifact` with base64 audio data (save to file)
+     *    - Video: Returns `VideoArtifact` with video data
+     *    - Others: Returns artifact data structure
+     * 3. **List artifacts:** Use `list(notebookId)` to see all artifacts in the notebook
+     * 4. **Manage:** Use `rename()`, `update()`, or `delete()` as needed
+     *
+     * **Quota:** Creation consumes quota for certain types (quizzes, flashcards, audio, video).
+     * Quota is checked before creation and recorded after success.
+     *
+     * @param notebookId - The notebook ID
+     * @param type - The artifact type (use ArtifactType enum)
+     * @param options - Creation options
+     *
+     * @example
+     * ```typescript
+     * import { ArtifactType, ArtifactState } from 'notebooklm-kit';
+     *
+     * // Using sub-services (recommended)
+     * const quiz = await client.artifacts.quiz.create('notebook-id', {
+     *   title: 'Chapter 1 Quiz',
+     *   instructions: 'Create 10 multiple choice questions covering key concepts',
+     *   customization: {
+     *     numberOfQuestions: 3,
+     *     difficulty: 2,
+     *     language: 'en',
+     *   },
+     * });
+     *
+     * const flashcards = await client.artifacts.flashcard.create('notebook-id', {
+     *   instructions: 'Focus on key terminology and definitions',
+     * });
+     *
+     * const video = await client.artifacts.video.create('notebook-id', {
+     *   instructions: 'Create an engaging video overview',
+     *   sourceIds: ['source-id-1', 'source-id-2'],
+     *   customization: {
+     *     format: 1,
+     *     visualStyle: 0,
+     *   },
+     * });
+     *
+     * // Using main create() method (also supported)
+     * const quiz2 = await client.artifacts.create('notebook-id', ArtifactType.QUIZ, {
+     *   title: 'Chapter 1 Quiz',
+     *   instructions: 'Create 10 multiple choice questions covering key concepts',
+     * });
+     * console.log(`Quiz ID: ${quiz2.artifactId}, State: ${quiz2.state}`);
+     *
+     * // Create quiz with customization
+     * import { NotebookLMLanguage } from 'notebooklm-kit';
+     *
+     * const quiz = await client.artifacts.create('notebook-id', ArtifactType.QUIZ, {
+     *   title: 'Chapter 1 Quiz',
+     *   instructions: 'Focus on key concepts',
+     *   customization: {
+     *     numberOfQuestions: 3, // More questions
+     *     difficulty: 3, // Hard
+     *     language: NotebookLMLanguage.ENGLISH, // or 'en'
+     *   },
+     * });
+     *
+     * // Create flashcards with customization
+     * const flashcards = await client.artifacts.create('notebook-id', ArtifactType.FLASHCARDS, {
+     *   instructions: 'Focus on key terminology',
+     *   customization: {
+     *     numberOfCards: 2, // Standard
+     *     difficulty: 2, // Medium
+     *     language: NotebookLMLanguage.HINDI, // or 'hi'
+     *   },
+     * });
+     *
+     * // Create slide deck with customization
+     * const slides = await client.artifacts.create('notebook-id', ArtifactType.SLIDE_DECK, {
+     *   title: 'Quarterly Report',
+     *   instructions: 'Focus on revenue and growth metrics',
+     *   customization: {
+     *     format: 3, // Detailed deck
+     *     language: NotebookLMLanguage.SPANISH, // or 'es'
+     *     length: 2, // Default
+     *   },
+     * });
+     *
+     * // Create infographic with customization
+     * const infographic = await client.artifacts.create('notebook-id', ArtifactType.INFOGRAPHIC, {
+     *   customization: {
+     *     language: NotebookLMLanguage.TAMIL, // or 'ta'
+     *     orientation: 1, // Landscape
+     *     levelOfDetail: 2, // Standard
+     *   },
+     * });
+     *
+     * // Create audio overview with customization
+     * const audio = await client.artifacts.create('notebook-id', ArtifactType.AUDIO, {
+     *   instructions: 'Create an engaging podcast summary',
+     *   customization: {
+     *     format: 0, // Deep dive
+     *     language: NotebookLMLanguage.FRENCH, // or 'fr' - supports 80+ languages
+     *     length: 2, // Default
+     *   },
+     * });
+     *
+     * // Create video overview with customization
+     * const video = await client.artifacts.create('notebook-id', ArtifactType.VIDEO, {
+     *   instructions: 'Create a video overview focusing on the main research findings',
+     *   sourceIds: ['source-id-1', 'source-id-2'],
+     *   customization: {
+     *     format: 1, // Explainer
+     *     language: NotebookLMLanguage.JAPANESE, // or 'ja' - supports 80+ languages
+     *     visualStyle: 0, // Auto-select
+     *   },
+     * });
+     *
+     * // Create report (uses all sources)
+     * const report = await client.artifacts.report.create('notebook-id', {
+     *   title: 'Final Report',
+     *   instructions: 'Focus on key concepts, formulas, and important dates',
+     * });
+     *
+     * // Create report from specific sources
+     * const reportFromSelected = await client.artifacts.report.create('notebook-id', {
+     *   title: 'Chapter 1-3 Report',
+     *   instructions: 'Focus on chapters 1-3',
+     *   sourceIds: ['source-id-1', 'source-id-2', 'source-id-3'],
+     * });
+     *
+     * // Poll until ready, then download
+     * let artifact = quiz;
+     * while (artifact.state === ArtifactState.CREATING) {
+     *   await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
+     *   artifact = await client.artifacts.get(quiz.artifactId);
+     * }
+     *
+     * if (artifact.state === ArtifactState.READY) {
+     *   const quizData = await client.artifacts.download(quiz.artifactId);
+     *   console.log(`Quiz has ${quizData.totalQuestions} questions`);
+     * }
+     * ```
+     */
+    create(notebookId: string, type: ArtifactType, options?: CreateArtifactOptions): Promise<Artifact>;
+    /**
+     * Download artifact data and save to file
+     *
+     * **What it does:** Downloads the actual content/data for artifacts and saves it to the specified
+     * folder location. The file format and naming depend on the artifact type. Use this after an
+     * artifact's state is `READY`.
+     *
+     * **Input:**
+     * - `artifactId` (string, required): The ID of the artifact to download
+     *   - Use the artifact ID from `create()` or `list()` for all artifact types
+     *   - Audio and video artifacts have their own artifactId (not the notebook ID)
+     * - `folderPath` (string, required): Folder path where the file should be saved
+     *   - On Node.js: Absolute or relative file system path (e.g., `./downloads` or `/tmp/artifacts`)
+     *   - On Browser: File name only (file will be downloaded via browser download)
+     * - `notebookId` (string, optional): Optional notebook ID (helpful for audio/video if download needs it)
+     *
+     * **Output:** Returns the path/name of the saved file and the data structure:
+     * ```typescript
+     * {
+     *   filePath: string, // Path/filename where the file was saved
+     *   data: QuizData | FlashcardData | AudioArtifact | VideoArtifact | any // The artifact data
+     * }
+     * ```
+     *
+     * **File Formats by Type:**
+     *
+     * **Audio:**
+     * - Format: MP3 audio file
+     * - Filename: `audio_<artifactId>.mp3` (or based on artifact title if available)
+     * - Content: Base64 decoded audio data saved as binary
+     *
+     * **Video:**
+     * - ⚠️ **Experimental**: Download not implemented. Use `get()` to retrieve the video URL.
+     * - The video URL is available in `artifact.url` field from `get()` method.
+     *
+     * **Slide Deck:**
+     * - Format: PDF file (by default) or PNG files in subfolder
+     * - Filename: `<artifact-title>.pdf` or `<artifact-title>/slide_*.png`
+     * - Content: Slides downloaded as PDF or individual PNG images
+     * - Uses Playwright for authentication and download
+     *
+     * **Quiz:**
+     * - Format: JSON file
+     * - Filename: `quiz_<artifactId>_<timestamp>.json`
+     * - Content: Complete artifact data including questions, options, correct answers, explanations, and metadata
+     *
+     * **Flashcards:**
+     * - Format: JSON file
+     * - Filename: `flashcard_<artifactId>_<timestamp>.json`
+     * - Content: Complete artifact data including flashcards array, CSV, totalCards, and metadata
+     *
+     * **Mind Map:**
+     * - Format: JSON file
+     * - Filename: `mindmap_<artifactId>.json`
+     * - Content: Structured mind map data (nodes, connections, etc.)
+     *
+     * **Infographic:**
+     * - Format: JSON or image file (depends on backend)
+     * - Filename: `infographic_<artifactId>.json` or `.png`/`.jpg`
+     * - Content: Infographic data or image file
+     *
+     * **Study Guide / Report:**
+     * - Format: JSON file
+     * - Filename: `studyguide_<artifactId>.json` or `report_<artifactId>.json`
+     * - Content: Structured document data
+     *
+     * **Important:**
+     * - Ensure artifact state is `READY` before downloading (check with `get()`)
+     * - Downloading a `CREATING` artifact may return incomplete data
+     * - For audio/video/slides, large files may take time to download
+     * - On Node.js: The folder must exist or be creatable
+     * - On Browser: The file will trigger a browser download with the specified filename
+     *
+     * @param artifactId - The artifact ID
+     * @param folderPath - Folder path where to save the file
+     * @param notebookId - Optional notebook ID (for audio artifacts)
+     * @returns Object with filePath and data
+     *
+     * @example
+     * ```typescript
+     * import { ArtifactState } from 'notebooklm-kit';
+     *
+     * // Download quiz and save as JSON
+     * const artifact = await client.artifacts.get('quiz-id');
+     * if (artifact.state === ArtifactState.READY) {
+     *   const result = await client.artifacts.download('quiz-id', './downloads');
+     *   console.log(`Quiz saved to: ${result.filePath}`);
+     *   console.log(`Quiz has ${result.data.totalQuestions} questions`);
+     * }
+     *
+     * // Download flashcards and save as CSV
+     * const flashcardResult = await client.artifacts.download('flashcard-id', './downloads');
+     * console.log(`Flashcards saved to: ${flashcardResult.filePath}`);
+     *
+     * // Download audio and save as MP3 (use audioId from create() or list())
+     * const audio = await sdk.artifacts.audio.create('notebook-id');
+     * const audioResult = await client.artifacts.download(audio.audioId, './downloads', 'notebook-id');
+     * console.log(`Audio saved to: ${audioResult.filePath}`);
+     *
+     * // Video: Download not available (experimental)
+     * // Use get() to retrieve URLs instead:
+     * const video = await client.artifacts.get('video-id', 'notebook-id');
+     * console.log('Video URL:', video.url);
+     *
+     * // Slides: Download using download() or get() with downloadAs option
+     * const slidesResult = await client.artifacts.download('slide-id', './downloads', 'notebook-id');
+     * console.log('Slides saved to:', slidesResult.filePath);
+     *
+     * // Download mind map
+     * const mindmapResult = await client.artifacts.download('mindmap-id', './downloads');
+     * console.log(`Mind map saved to: ${mindmapResult.filePath}`);
+     *
+     * // Download infographic
+     * const infographicResult = await client.artifacts.download('infographic-id', './downloads');
+     * console.log(`Infographic saved to: ${infographicResult.filePath}`);
+     *
+     * // Download study guide
+     * const guideResult = await client.artifacts.download('guide-id', './downloads');
+     * console.log(`Study guide saved to: ${guideResult.filePath}`);
+     * ```
+     */
+    download(artifactId: string, folderPath: string, notebookId?: string, artifactType?: ArtifactType): Promise<{
+        filePath: string;
+        data: QuizData | FlashcardData | AudioArtifact | VideoArtifact | any;
+    }>;
+    private getApiTypeNumber;
+    /**
+     * Maps API response type numbers to ArtifactType enum (for parsing list/get responses)
+     * Note: Both Quiz and Flashcards use type 4 in API responses, so we need to differentiate
+     * them by looking at the customization data structure or other fields.
+     */
+    private mapApiTypeToArtifactType;
+    /**
+     * Create artifacts using R7cb6c RPC (Quiz, Slides, Infographics, Video)
+     */
+    private createR7cb6cArtifact;
+    /**
+     * Parse video creation response into VideoOverview
+     * Used by createVideo method to return VideoOverview instead of Artifact
+     */
+    private parseCreateResponse;
+    /**
+     * Maps length string to number
+     */
+    private mapLengthToNumber;
+    /**
+     * Create mind map using yyryJe RPC (RPC_ACT_ON_SOURCES)
+     * Structure from RPC: [[[sourceId1]], [[sourceId2]], ...], null, null, null, null, ["interactive_mindmap", [["[CONTEXT]", ""]], "", null, [2, null, [1]]]
+     */
+    private createMindMap;
+    private createStandardArtifact;
+    private createAudio;
+    private downloadAudio;
+    private getQuotaType;
+    /**
+     * Helper function to fetch all source IDs from a notebook
+     * Used when sourceIds is omitted/empty - automatically uses all sources
+     */
+    private getAllSourceIds;
+    private parseListResponse;
+    private parseArtifactResponse;
+    private parseArtifactData;
+    /**
+     * Parse Mind Map creation response
+     * Structure: [jsonString, null, [artifactId, ...otherIds...]]
+     * Example: ["{\n\"name\": \"...\",\n\"children\": [...]}", null, ["id1", "id2", 123]]
+     */
+    private parseMindMapResponse;
+    private parseAudioCreateResponse;
+    private parseAudioResponse;
+    private parseVideoCreateResponse;
+    private parseDownloadResponse;
+    /**
+     * Parse quiz data from RPC response
+     */
+    private parseQuizData;
+    /**
+     * Parse flashcard data from RPC response
+     * BnLyuf (GET_ARTIFACT) should return CSV data for flashcards
+     */
+    private parseFlashcardData;
+    /**
+     * Parse a CSV line handling quoted fields properly
+     */
+    private parseCSVLine;
+    /**
+     * Save artifact data to file based on artifact type
+     * Handles both Node.js (fs) and browser (Blob) environments
+     */
+    private saveArtifactToFile;
+    /**
+     * Convert base64 string to Uint8Array
+     */
+    private base64ToUint8Array;
+    /**
+     * Join path components (works in both Node.js and browser)
+     */
+    private joinPath;
+    /**
+     * Write file (handles both Node.js and browser)
+     */
+    private writeFile;
+}
+export declare function downloadAudioFile(rpc: RPCClient, audioId: string, notebookId?: string): Promise<{
+    audioData: Uint8Array;
+    audioUrl: string | null;
+    saveToFile: (path: string) => Promise<void>;
+}>;
+export declare function fetchQuizData(rpc: RPCClient, quizId: string, notebookId?: string): Promise<QuizData>;
+export declare function fetchFlashcardData(rpc: RPCClient, flashcardId: string, notebookId?: string): Promise<ParsedFlashcardData>;
+export declare function fetchInfographic(rpc: RPCClient, infographicId: string, notebookId?: string, options?: FetchInfographicOptions): Promise<InfographicImageData>;
+export declare function downloadSlidesFile(rpc: RPCClient, slideId: string, notebookId: string, options?: DownloadSlidesOptions): Promise<{
+    slidesData: Uint8Array;
+    pdfUrl: string;
+    saveToFile: (path: string) => Promise<void>;
+}>;
+export declare function createReport(rpc: RPCClient, notebookId: string, options?: CreateReportOptions): Promise<{
+    artifactId: string;
+    state: ArtifactState;
+    title?: string;
+}>;
+export declare function reportToDocs(rpc: RPCClient, reportId: string, notebookId: string, title?: string): Promise<string>;
+export declare function reportToSheets(rpc: RPCClient, reportId: string, notebookId: string, title?: string): Promise<string>;
+export declare function getReportContent(rpc: RPCClient, reportId: string, notebookId: string): Promise<ReportContent>;
+export declare function formatReportAsMarkdown(report: ReportContent): string;
+export declare function formatReportAsText(report: ReportContent): string;
+export declare function formatReportAsHTML(report: ReportContent): string;
+export declare function formatReportAsJSON(report: ReportContent): string;
+//# sourceMappingURL=artifacts.d.ts.map