notebooklm-sdk 0.1.7 → 0.1.8

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AuthTokens, a as ConnectOptions } from './auth-Ba2hsZW_.cjs';
-export { C as CookieMap, d as connect } from './auth-Ba2hsZW_.cjs';
+import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.cjs';
+export { C as CookieMap, d as connect } from './auth-Dxsm8894.cjs';
 export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, AuthError, ChatError, ClientError, NetworkError, NotebookError, NotebookLMError, NotebookNotFoundError, RPCError, RPCTimeoutError, RateLimitError, ServerError, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError } from './errors.cjs';
 
 /** RPC method IDs for NotebookLM batchexecute API. */
@@ -523,10 +523,12 @@ interface ClientOptions {
  *
  * @example
  * ```ts
- * const client = await NotebookLMClient.connect({
- *   cookies: process.env.NOTEBOOKLM_COOKIES,
- * });
+ * // After running `npx notebooklm-sdk login` once:
+ * const client = await NotebookLMClient.connect();
  * const notebooks = await client.notebooks.list();
+ *
+ * // Or with explicit credentials:
+ * const client = await NotebookLMClient.connect({ cookiesFile: './session.json' });
  * ```
  */
 declare class NotebookLMClient {
@@ -544,7 +546,7 @@ declare class NotebookLMClient {
      * Connect to NotebookLM using cookies.
      * Fetches CSRF and session tokens from the NotebookLM homepage.
      */
-    static connect(opts: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
+    static connect(opts?: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
     /**
      * Refresh CSRF and session tokens (e.g. if they expire mid-session).
      */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AuthTokens, a as ConnectOptions } from './auth-Ba2hsZW_.js';
-export { C as CookieMap, d as connect } from './auth-Ba2hsZW_.js';
+import { A as AuthTokens, a as ConnectOptions } from './auth-Dxsm8894.js';
+export { C as CookieMap, d as connect } from './auth-Dxsm8894.js';
 export { ArtifactDownloadError, ArtifactError, ArtifactNotFoundError, ArtifactNotReadyError, ArtifactParseError, AuthError, ChatError, ClientError, NetworkError, NotebookError, NotebookLMError, NotebookNotFoundError, RPCError, RPCTimeoutError, RateLimitError, ServerError, SourceAddError, SourceError, SourceNotFoundError, SourceProcessingError, SourceTimeoutError } from './errors.js';
 
 /** RPC method IDs for NotebookLM batchexecute API. */
@@ -523,10 +523,12 @@ interface ClientOptions {
  *
  * @example
  * ```ts
- * const client = await NotebookLMClient.connect({
- *   cookies: process.env.NOTEBOOKLM_COOKIES,
- * });
+ * // After running `npx notebooklm-sdk login` once:
+ * const client = await NotebookLMClient.connect();
  * const notebooks = await client.notebooks.list();
+ *
+ * // Or with explicit credentials:
+ * const client = await NotebookLMClient.connect({ cookiesFile: './session.json' });
  * ```
  */
 declare class NotebookLMClient {
@@ -544,7 +546,7 @@ declare class NotebookLMClient {
      * Connect to NotebookLM using cookies.
      * Fetches CSRF and session tokens from the NotebookLM homepage.
      */
-    static connect(opts: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
+    static connect(opts?: ConnectOptions, clientOpts?: ClientOptions): Promise<NotebookLMClient>;
     /**
      * Refresh CSRF and session tokens (e.g. if they expire mid-session).
      */

package/dist/index.js

@@ -1,4 +1,6 @@
-import { readFileSync } from 'fs';
+import { readFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -452,8 +454,8 @@ function loadCookiesFromFile(filePath) {
     raw = readFileSync(filePath, "utf-8");
   } catch {
     throw new AuthError(
-      `Cookie file not found: ${filePath}
-Provide valid Playwright storage state JSON.`
+      `Session file not found: ${filePath}
+Run: npx notebooklm-sdk login`
     );
   }
   return extractCookiesFromStorageState(JSON.parse(raw));
@@ -497,7 +499,7 @@ function extractCookiesFromStorageState(storageState) {
   }
   if (!cookies["SID"]) {
     throw new AuthError(
-      "Missing required cookie: SID. Provide valid Playwright storage state with Google cookies."
+      "Missing required cookie: SID. Session may be invalid or expired.\nRun: npx notebooklm-sdk login"
     );
   }
   return cookies;
@@ -536,7 +538,7 @@ function extractCsrfToken(html, finalUrl) {
   const match = /"SNlM0e"\s*:\s*"([^"]+)"/.exec(html);
   if (!match?.[1]) {
     if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
-      throw new AuthError("Authentication expired or invalid. Cookies may need to be refreshed.");
+      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
     }
     throw new AuthError("CSRF token (SNlM0e) not found in NotebookLM page HTML.");
   }
@@ -546,7 +548,7 @@ function extractSessionId(html, finalUrl) {
   const match = /"FdrFJe"\s*:\s*"([^"]+)"/.exec(html);
   if (!match?.[1]) {
     if (isGoogleAuthRedirect(finalUrl) || html.includes("accounts.google.com")) {
-      throw new AuthError("Authentication expired or invalid. Cookies may need to be refreshed.");
+      throw new AuthError("Session expired or invalid.\nRun: npx notebooklm-sdk login");
     }
     throw new AuthError("Session ID (FdrFJe) not found in NotebookLM page HTML.");
   }
@@ -555,7 +557,7 @@ function extractSessionId(html, finalUrl) {
 function isGoogleAuthRedirect(url) {
   return url.includes("accounts.google.com") || url.includes("signin");
 }
-async function connect(opts) {
+async function connect(opts = {}) {
   let cookieMap;
   let googleCookieHeader = null;
   if (opts.cookies) {
@@ -572,11 +574,24 @@ async function connect(opts) {
     }
   } else {
     const envCookies = process.env["NOTEBOOKLM_COOKIES"];
-    if (envCookies) {
+    const envFile = process.env["NOTEBOOKLM_COOKIES_FILE"];
+    if (envFile) {
+      cookieMap = loadCookiesFromFile(envFile);
+    } else if (existsSync(DEFAULT_SESSION_FILE)) {
+      const raw = readFileSync(DEFAULT_SESSION_FILE, "utf-8");
+      const storageState = JSON.parse(raw);
+      cookieMap = loadCookiesFromObject(storageState);
+      googleCookieHeader = buildGoogleCookieHeader(storageState);
+    } else if (existsSync("storage_state.json")) {
+      const raw = readFileSync("storage_state.json", "utf-8");
+      const storageState = JSON.parse(raw);
+      cookieMap = loadCookiesFromObject(storageState);
+      googleCookieHeader = buildGoogleCookieHeader(storageState);
+    } else if (envCookies) {
       cookieMap = loadCookiesFromString(envCookies);
     } else {
       throw new AuthError(
-        "No cookies provided. Pass cookies, cookiesFile, or cookiesObject to connect()."
+        "No session found. Run: npx notebooklm-sdk login"
       );
     }
   }
@@ -590,10 +605,11 @@ async function connect(opts) {
     googleCookieHeader: googleCookieHeader ?? cookieHeader
   };
 }
-var NOTEBOOKLM_URL;
+var DEFAULT_SESSION_FILE, NOTEBOOKLM_URL;
 var init_auth = __esm({
   "src/auth.ts"() {
     init_errors();
+    DEFAULT_SESSION_FILE = join(homedir(), ".notebooklm", "session.json");
     NOTEBOOKLM_URL = "https://notebooklm.google.com/";
   }
 });
@@ -2395,7 +2411,7 @@ var NotebookLMClient = class _NotebookLMClient {
    * Connect to NotebookLM using cookies.
    * Fetches CSRF and session tokens from the NotebookLM homepage.
    */
-  static async connect(opts, clientOpts = {}) {
+  static async connect(opts = {}, clientOpts = {}) {
     const auth = await connect(opts);
     return new _NotebookLMClient(auth, clientOpts);
   }