notebooklm-kit 0.0.1 → 2.1.1

package/dist/src/services/notebook-language.js

@@ -0,0 +1,204 @@
+/**
+ * Notebook Language Service
+ * Handles getting and setting the notebook's default output language
+ *
+ * The notebook's default output language is used as the default for:
+ * - Artifact creation (audio, video, report, infographics, slide decks)
+ * - Chat responses
+ * - All other notebook operations
+ *
+ * If a specific language is provided in artifact creation, it overrides the default.
+ */
+import * as RPC from '../rpc/rpc-methods.js';
+import { APIError } from '../utils/errors.js';
+import { isLanguageSupported } from '../types/languages.js';
+/**
+ * Service for managing notebook output language
+ */
+export class NotebookLanguageService {
+    rpc;
+    // Cache for notebook languages to avoid repeated RPC calls
+    languageCache = new Map();
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Get the default output language for a notebook
+     *
+     * **What it does:** Retrieves the notebook's default output language setting.
+     * This language is used as the default for all artifact creation, chat responses,
+     * and other notebook operations unless overridden.
+     *
+     * **Input:**
+     * - `notebookId` (string, required): The ID of the notebook
+     *
+     * **Output:** Returns the language code (e.g., 'en', 'de', 'ja')
+     *
+     * **Note:**
+     * - Returns cached language if available (set via `set()` method)
+     * - If not cached, defaults to 'en' (English)
+     * - The language is cached when set via `set()` method
+     *
+     * @param notebookId - The notebook ID
+     * @returns The default language code
+     *
+     * @example
+     * ```typescript
+     * const language = await sdk.notebookLanguage.get('notebook-id');
+     * console.log(`Default language: ${language}`); // 'en', 'de', 'ja', etc.
+     * ```
+     */
+    async get(notebookId) {
+        // Check cache first - language is cached when set via set() method
+        if (this.languageCache.has(notebookId)) {
+            return this.languageCache.get(notebookId);
+        }
+        // If not cached, default to 'en'
+        // The language will be cached when set via set() method
+        const defaultLanguage = 'en';
+        this.languageCache.set(notebookId, defaultLanguage);
+        return defaultLanguage;
+    }
+    /**
+     * Set the default output language for a notebook
+     *
+     * **What it does:** Sets the notebook's default output language.
+     * This language will be used as the default for all artifact creation,
+     * chat responses, and other notebook operations.
+     *
+     * **Input:**
+     * - `notebookId` (string, required): The ID of the notebook
+     * - `language` (string, required): Language code (e.g., 'en', 'de', 'ja')
+     *   - Use `NotebookLMLanguage` enum for type safety
+     *   - Supports 80+ languages
+     *
+     * **Output:** Returns the updated language code
+     *
+     * **Note:**
+     * - The language setting is persistent and affects all future operations
+     * - Cache is updated after successful setting
+     * - Uses RPC `hT54vc` (MutateAccount) to update the language
+     *
+     * @param notebookId - The notebook ID
+     * @param language - Language code to set
+     * @returns The updated language code
+     *
+     * @example
+     * ```typescript
+     * import { NotebookLMLanguage } from 'notebooklm-kit';
+     *
+     * // Set to German
+     * await sdk.notebookLanguage.set('notebook-id', NotebookLMLanguage.GERMAN);
+     *
+     * // Set to Japanese
+     * await sdk.notebookLanguage.set('notebook-id', NotebookLMLanguage.JAPANESE);
+     *
+     * // Set using language code directly
+     * await sdk.notebookLanguage.set('notebook-id', 'de');
+     * ```
+     */
+    async set(notebookId, language) {
+        // Validate language code
+        if (!language || typeof language !== 'string') {
+            throw new APIError('Invalid language code. Must be a non-empty string.', undefined, 400);
+        }
+        // Normalize language code (lowercase)
+        const normalizedLang = language.toLowerCase();
+        // Validate that it's a supported language (optional check)
+        if (!isLanguageSupported(normalizedLang)) {
+            console.warn(`Language code '${normalizedLang}' may not be supported. Proceeding anyway.`);
+        }
+        try {
+            // Based on mm55.txt, the RPC call structure is:
+            // RPC: hT54vc (MutateAccount)
+            // Args: [[null, [[null, null, null, null, ["en"]]]]]
+            // The language code is in a nested array at the end
+            const args = [
+                [
+                    null,
+                    [
+                        [
+                            null,
+                            null,
+                            null,
+                            null,
+                            [normalizedLang] // Language code in array
+                        ]
+                    ]
+                ]
+            ];
+            // Make the RPC call to set the language
+            await this.rpc.call(RPC.RPC_MUTATE_ACCOUNT, // hT54vc
+            args, notebookId);
+            // Also call ozz5Z RPC (based on mm55.txt, this seems to be a follow-up call)
+            // Args: [[[[null, "1", 627]], [null, null, null, null, null, null, null, null, null, [null, null, 1]]], 1]]
+            try {
+                await this.rpc.call(RPC.RPC_UNKNOWN_POST_SLIDE_DECK, // ozz5Z
+                [
+                    [
+                        [
+                            [null, "1", 627]
+                        ],
+                        [
+                            null,
+                            null,
+                            null,
+                            null,
+                            null,
+                            null,
+                            null,
+                            null,
+                            null,
+                            [null, null, 1]
+                        ]
+                    ],
+                    1
+                ], notebookId);
+            }
+            catch (error) {
+                // ozz5Z call is optional, don't fail if it errors
+                console.warn('Optional ozz5Z RPC call failed (non-critical):', error);
+            }
+            // Update cache
+            this.languageCache.set(notebookId, normalizedLang);
+            return normalizedLang;
+        }
+        catch (error) {
+            // Clear cache on error
+            this.languageCache.delete(notebookId);
+            throw new APIError(`Failed to set notebook language to '${normalizedLang}': ${error instanceof Error ? error.message : String(error)}`, undefined, 500);
+        }
+    }
+    /**
+     * Clear the language cache for a notebook
+     * Useful if you want to force a fresh fetch
+     *
+     * @param notebookId - The notebook ID (optional, clears all if not provided)
+     */
+    clearCache(notebookId) {
+        if (notebookId) {
+            this.languageCache.delete(notebookId);
+        }
+        else {
+            this.languageCache.clear();
+        }
+    }
+    /**
+     * Get language information with metadata
+     *
+     * @param notebookId - The notebook ID
+     * @returns Language information object
+     */
+    async getInfo(notebookId) {
+        const language = await this.get(notebookId);
+        // Import getLanguageInfo dynamically to avoid circular dependencies
+        const { getLanguageInfo } = await import('../types/languages.js');
+        const info = getLanguageInfo(language);
+        return {
+            language,
+            name: info?.name,
+            nativeName: info?.nativeName,
+        };
+    }
+}
+//# sourceMappingURL=notebook-language.js.map

package/dist/src/services/notebook-language.js.map

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

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

@@ -0,0 +1,26 @@
+import { RPCClient } from '../rpc/rpc-client.js';
+import type { Notebook, CreateNotebookOptions, UpdateNotebookOptions, ShareNotebookOptions, ShareNotebookResult, DeleteNotebookResult } from '../types/notebook.js';
+export declare class NotebooksService {
+    private rpc;
+    private quota?;
+    constructor(rpc: RPCClient, quota?: import("../utils/quota.js").QuotaManager | undefined);
+    list(): Promise<Notebook[]>;
+    get(notebookId: string): Promise<Notebook>;
+    create(options: CreateNotebookOptions): Promise<Notebook>;
+    update(notebookId: string, options: UpdateNotebookOptions): Promise<Notebook>;
+    delete(notebookIds: string | string[]): Promise<DeleteNotebookResult>;
+    share(notebookId: string, options: ShareNotebookOptions): Promise<ShareNotebookResult>;
+    /**
+     * Parse sharing details response from JFMDGd RPC
+     */
+    private parseSharingResponse;
+    private parseListResponse;
+    private parseGetResponse;
+    /**
+     * Set emoji for a notebook using the s0tc2d RPC
+     * Based on mm40.txt: emoji is set via s0tc2d with args [notebookId, [[null, null, null, [null, null, emoji]]]]
+     */
+    private setEmoji;
+    private parseCreateResponse;
+}
+//# sourceMappingURL=notebooks.d.ts.map

package/dist/src/services/notebooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebooks.d.ts","sourceRoot":"","sources":["../../../src/services/notebooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAmB,MAAM,sBAAsB,CAAC;AAKrL,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK,CAAC;gBADN,GAAG,EAAE,SAAS,EACd,KAAK,CAAC,EAAE,OAAO,mBAAmB,EAAE,YAAY,YAAA;IAGpD,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAU3B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsB1C,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8BzD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwD7E,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiBrE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2J5F;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoG5B,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,gBAAgB;IA6GxB;;;OAGG;YACW,QAAQ;IAuBtB,OAAO,CAAC,mBAAmB;CAqD5B"}