notebooklm-kit 0.0.1 → 2.1.1

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Error handling utilities for NotebookLM API
+ * Comprehensive error code dictionary and error detection
+ */
+import { NotebookLMError } from '../types/common.js';
+/**
+ * Error type categories
+ */
+export declare enum ErrorType {
+    UNKNOWN = "Unknown",
+    AUTHENTICATION = "Authentication",
+    AUTHORIZATION = "Authorization",
+    RATE_LIMIT = "RateLimit",
+    NOT_FOUND = "NotFound",
+    INVALID_INPUT = "InvalidInput",
+    SERVER_ERROR = "ServerError",
+    NETWORK_ERROR = "NetworkError",
+    PERMISSION_DENIED = "PermissionDenied",
+    RESOURCE_EXHAUSTED = "ResourceExhausted",
+    UNAVAILABLE = "Unavailable"
+}
+/**
+ * Error code definition
+ */
+export interface ErrorCode {
+    code: number;
+    type: ErrorType;
+    message: string;
+    description: string;
+    retryable: boolean;
+}
+/**
+ * API error with context
+ */
+export declare class APIError extends NotebookLMError {
+    readonly errorCode?: ErrorCode | undefined;
+    readonly httpStatus?: number | undefined;
+    readonly rawResponse?: string | undefined;
+    constructor(message: string, errorCode?: ErrorCode | undefined, httpStatus?: number | undefined, rawResponse?: string | undefined);
+    isRetryable(): boolean;
+}
+/**
+ * Get error code definition
+ */
+export declare function getErrorCode(code: number): ErrorCode | null;
+/**
+ * Check if response contains an error
+ */
+export declare function isErrorResponse(response: any): APIError | null;
+/**
+ * Add custom error code
+ */
+export declare function addErrorCode(code: number, errorCode: ErrorCode): void;
+/**
+ * Get all registered error codes
+ */
+export declare function listErrorCodes(): Record<number, ErrorCode>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,UAAU,cAAc;IACxB,SAAS,aAAa;IACtB,aAAa,iBAAiB;IAC9B,YAAY,gBAAgB;IAC5B,aAAa,iBAAiB;IAC9B,iBAAiB,qBAAqB;IACtC,kBAAkB,sBAAsB;IACxC,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,eAAe;aAGzB,SAAS,CAAC,EAAE,SAAS;aACrB,UAAU,CAAC,EAAE,MAAM;aACnB,WAAW,CAAC,EAAE,MAAM;gBAHpC,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,SAAS,YAAA,EACrB,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,WAAW,CAAC,EAAE,MAAM,YAAA;IAOtC,WAAW,IAAI,OAAO;CAYvB;AAoOD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,GAAG,IAAI,CA8E9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE1D"}

package/dist/src/utils/errors.js

@@ -0,0 +1,357 @@
+/**
+ * Error handling utilities for NotebookLM API
+ * Comprehensive error code dictionary and error detection
+ */
+import { NotebookLMError } from '../types/common.js';
+/**
+ * Error type categories
+ */
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["UNKNOWN"] = "Unknown";
+    ErrorType["AUTHENTICATION"] = "Authentication";
+    ErrorType["AUTHORIZATION"] = "Authorization";
+    ErrorType["RATE_LIMIT"] = "RateLimit";
+    ErrorType["NOT_FOUND"] = "NotFound";
+    ErrorType["INVALID_INPUT"] = "InvalidInput";
+    ErrorType["SERVER_ERROR"] = "ServerError";
+    ErrorType["NETWORK_ERROR"] = "NetworkError";
+    ErrorType["PERMISSION_DENIED"] = "PermissionDenied";
+    ErrorType["RESOURCE_EXHAUSTED"] = "ResourceExhausted";
+    ErrorType["UNAVAILABLE"] = "Unavailable";
+})(ErrorType || (ErrorType = {}));
+/**
+ * API error with context
+ */
+export class APIError extends NotebookLMError {
+    errorCode;
+    httpStatus;
+    rawResponse;
+    constructor(message, errorCode, httpStatus, rawResponse) {
+        super(message, httpStatus);
+        this.errorCode = errorCode;
+        this.httpStatus = httpStatus;
+        this.rawResponse = rawResponse;
+        this.name = 'APIError';
+        Object.setPrototypeOf(this, APIError.prototype);
+    }
+    isRetryable() {
+        if (this.errorCode) {
+            return this.errorCode.retryable;
+        }
+        // HTTP errors that are retryable
+        if (this.httpStatus) {
+            return [429, 500, 502, 503, 504].includes(this.httpStatus);
+        }
+        return false;
+    }
+}
+/**
+ * Error code dictionary
+ * Maps numeric error codes to their definitions
+ */
+const errorCodeDictionary = {
+    // Authentication errors
+    277566: {
+        code: 277566,
+        type: ErrorType.AUTHENTICATION,
+        message: 'Authentication required',
+        description: 'The request requires user authentication. Please check your credentials.',
+        retryable: false,
+    },
+    277567: {
+        code: 277567,
+        type: ErrorType.AUTHENTICATION,
+        message: 'Authentication token expired',
+        description: 'The authentication token has expired. Please get fresh credentials.',
+        retryable: false,
+    },
+    80620: {
+        code: 80620,
+        type: ErrorType.AUTHORIZATION,
+        message: 'Access denied',
+        description: 'Access to the requested resource is denied. Check your permissions.',
+        retryable: false,
+    },
+    // Rate limiting
+    324934: {
+        code: 324934,
+        type: ErrorType.RATE_LIMIT,
+        message: 'Rate limit exceeded',
+        description: 'Too many requests have been sent. Please wait before making more requests.',
+        retryable: true,
+    },
+    // Resource not found
+    143: {
+        code: 143,
+        type: ErrorType.NOT_FOUND,
+        message: 'Resource not found',
+        description: 'The requested resource could not be found. It may have been deleted or you may not have access to it.',
+        retryable: false,
+    },
+    // gRPC-style error codes
+    1: {
+        code: 1,
+        type: ErrorType.INVALID_INPUT,
+        message: 'Invalid request',
+        description: 'The request contains invalid parameters or data.',
+        retryable: false,
+    },
+    2: {
+        code: 2,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Internal server error',
+        description: 'An internal server error occurred. Please try again later.',
+        retryable: true,
+    },
+    3: {
+        code: 3,
+        type: ErrorType.UNAVAILABLE,
+        message: 'Service unavailable',
+        description: 'The service is temporarily unavailable. Please try again later.',
+        retryable: true,
+    },
+    4: {
+        code: 4,
+        type: ErrorType.PERMISSION_DENIED,
+        message: 'Permission denied',
+        description: 'You do not have permission to access this resource.',
+        retryable: false,
+    },
+    5: {
+        code: 5,
+        type: ErrorType.NOT_FOUND,
+        message: 'Not found',
+        description: 'The requested item was not found.',
+        retryable: false,
+    },
+    6: {
+        code: 6,
+        type: ErrorType.INVALID_INPUT,
+        message: 'Invalid argument',
+        description: 'One or more arguments are invalid.',
+        retryable: false,
+    },
+    7: {
+        code: 7,
+        type: ErrorType.PERMISSION_DENIED,
+        message: 'Permission denied',
+        description: 'The caller does not have permission to execute the specified operation.',
+        retryable: false,
+    },
+    8: {
+        code: 8,
+        type: ErrorType.RESOURCE_EXHAUSTED,
+        message: 'Resource exhausted',
+        description: 'Some resource has been exhausted (quota, disk space, etc.).',
+        retryable: true,
+    },
+    9: {
+        code: 9,
+        type: ErrorType.INVALID_INPUT,
+        message: 'Failed precondition',
+        description: "Operation was rejected because the system is not in a state required for the operation's execution.",
+        retryable: false,
+    },
+    10: {
+        code: 10,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Aborted',
+        description: 'The operation was aborted due to a concurrency issue.',
+        retryable: true,
+    },
+    11: {
+        code: 11,
+        type: ErrorType.INVALID_INPUT,
+        message: 'Out of range',
+        description: 'Operation was attempted past the valid range.',
+        retryable: false,
+    },
+    12: {
+        code: 12,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Unimplemented',
+        description: 'Operation is not implemented or not supported/enabled.',
+        retryable: false,
+    },
+    13: {
+        code: 13,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Internal error',
+        description: "Internal errors that shouldn't be exposed to clients.",
+        retryable: true,
+    },
+    14: {
+        code: 14,
+        type: ErrorType.UNAVAILABLE,
+        message: 'Unavailable',
+        description: 'The service is currently unavailable.',
+        retryable: true,
+    },
+    15: {
+        code: 15,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Data loss',
+        description: 'Unrecoverable data loss or corruption.',
+        retryable: false,
+    },
+    16: {
+        code: 16,
+        type: ErrorType.AUTHENTICATION,
+        message: 'Unauthenticated',
+        description: 'The request does not have valid authentication credentials.',
+        retryable: false,
+    },
+    // HTTP status codes
+    400: {
+        code: 400,
+        type: ErrorType.INVALID_INPUT,
+        message: 'Bad Request',
+        description: 'The request is malformed or contains invalid parameters.',
+        retryable: false,
+    },
+    401: {
+        code: 401,
+        type: ErrorType.AUTHENTICATION,
+        message: 'Unauthorized',
+        description: 'Authentication is required to access this resource.',
+        retryable: false,
+    },
+    403: {
+        code: 403,
+        type: ErrorType.PERMISSION_DENIED,
+        message: 'Forbidden',
+        description: 'Access to this resource is forbidden.',
+        retryable: false,
+    },
+    404: {
+        code: 404,
+        type: ErrorType.NOT_FOUND,
+        message: 'Not Found',
+        description: 'The requested resource was not found.',
+        retryable: false,
+    },
+    429: {
+        code: 429,
+        type: ErrorType.RATE_LIMIT,
+        message: 'Too Many Requests',
+        description: 'Rate limit exceeded. Please wait before making more requests.',
+        retryable: true,
+    },
+    500: {
+        code: 500,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Internal Server Error',
+        description: 'An internal server error occurred.',
+        retryable: true,
+    },
+    502: {
+        code: 502,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Bad Gateway',
+        description: 'The server received an invalid response from an upstream server.',
+        retryable: true,
+    },
+    503: {
+        code: 503,
+        type: ErrorType.UNAVAILABLE,
+        message: 'Service Unavailable',
+        description: 'The service is temporarily unavailable.',
+        retryable: true,
+    },
+    504: {
+        code: 504,
+        type: ErrorType.SERVER_ERROR,
+        message: 'Gateway Timeout',
+        description: 'The server did not receive a timely response from an upstream server.',
+        retryable: true,
+    },
+};
+/**
+ * Get error code definition
+ */
+export function getErrorCode(code) {
+    return errorCodeDictionary[code] || null;
+}
+/**
+ * Check if response contains an error
+ */
+export function isErrorResponse(response) {
+    if (!response) {
+        return null;
+    }
+    // Check explicit error field
+    if (response.error) {
+        return new APIError(response.error);
+    }
+    // Check if data is null (often indicates auth issue)
+    if (response.data === null || response.data === undefined) {
+        return null; // null data is not necessarily an error
+    }
+    const data = response.data;
+    // Handle numeric error codes
+    if (typeof data === 'number') {
+        const code = data;
+        // Skip success codes
+        if (code === 0 || code === 1) {
+            return null;
+        }
+        const errorCode = getErrorCode(code);
+        if (errorCode) {
+            return new APIError(errorCode.message, errorCode);
+        }
+        return new APIError(`Unknown error code: ${code}`);
+    }
+    // Handle array responses
+    if (Array.isArray(data) && data.length > 0) {
+        const firstEl = data[0];
+        if (typeof firstEl === 'number') {
+            const code = firstEl;
+            // Skip success codes
+            if (code === 0 || code === 1) {
+                return null;
+            }
+            const errorCode = getErrorCode(code);
+            if (errorCode) {
+                return new APIError(errorCode.message, errorCode);
+            }
+        }
+    }
+    // Handle object responses
+    if (typeof data === 'object' && data !== null) {
+        if ('error' in data && data.error) {
+            return new APIError(String(data.error));
+        }
+        if ('error_code' in data && typeof data.error_code === 'number') {
+            const errorCode = getErrorCode(data.error_code);
+            if (errorCode) {
+                return new APIError(errorCode.message, errorCode);
+            }
+        }
+    }
+    // Handle string responses
+    if (typeof data === 'string') {
+        const trimmed = data.trim();
+        const code = parseInt(trimmed, 10);
+        if (!isNaN(code) && code !== 0 && code !== 1) {
+            const errorCode = getErrorCode(code);
+            if (errorCode) {
+                return new APIError(errorCode.message, errorCode);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Add custom error code
+ */
+export function addErrorCode(code, errorCode) {
+    errorCodeDictionary[code] = errorCode;
+}
+/**
+ * Get all registered error codes
+ */
+export function listErrorCodes() {
+    return { ...errorCodeDictionary };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAN,IAAY,SAYX;AAZD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,qCAAwB,CAAA;IACxB,mCAAsB,CAAA;IACtB,2CAA8B,CAAA;IAC9B,yCAA4B,CAAA;IAC5B,2CAA8B,CAAA;IAC9B,mDAAsC,CAAA;IACtC,qDAAwC,CAAA;IACxC,wCAA2B,CAAA;AAC7B,CAAC,EAZW,SAAS,KAAT,SAAS,QAYpB;AAaD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,eAAe;IAGzB;IACA;IACA;IAJlB,YACE,OAAe,EACC,SAAqB,EACrB,UAAmB,EACnB,WAAoB;QAEpC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAJX,cAAS,GAAT,SAAS,CAAY;QACrB,eAAU,GAAV,UAAU,CAAS;QACnB,gBAAW,GAAX,WAAW,CAAS;QAGpC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAClC,CAAC;QAED,iCAAiC;QACjC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,mBAAmB,GAA8B;IACrD,wBAAwB;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,OAAO,EAAE,yBAAyB;QAClC,WAAW,EAAE,0EAA0E;QACvF,SAAS,EAAE,KAAK;KACjB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,OAAO,EAAE,8BAA8B;QACvC,WAAW,EAAE,qEAAqE;QAClF,SAAS,EAAE,KAAK;KACjB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,qEAAqE;QAClF,SAAS,EAAE,KAAK;KACjB;IAED,gBAAgB;IAChB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,4EAA4E;QACzF,SAAS,EAAE,IAAI;KAChB;IAED,qBAAqB;IACrB,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,uGAAuG;QACpH,SAAS,EAAE,KAAK;KACjB;IAED,yBAAyB;IACzB,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,kDAAkD;QAC/D,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,4DAA4D;QACzE,SAAS,EAAE,IAAI;KAChB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,iEAAiE;QAC9E,SAAS,EAAE,IAAI;KAChB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,iBAAiB;QACjC,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,qDAAqD;QAClE,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,iBAAiB;QACjC,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,yEAAyE;QACtF,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,kBAAkB;QAClC,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,6DAA6D;QAC1E,SAAS,EAAE,IAAI;KAChB;IACD,CAAC,EAAE;QACD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,qGAAqG;QAClH,SAAS,EAAE,KAAK;KACjB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,uDAAuD;QACpE,SAAS,EAAE,IAAI;KAChB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,+CAA+C;QAC5D,SAAS,EAAE,KAAK;KACjB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,KAAK;KACjB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,uDAAuD;QACpE,SAAS,EAAE,IAAI;KAChB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE,IAAI;KAChB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,wCAAwC;QACrD,SAAS,EAAE,KAAK;KACjB;IACD,EAAE,EAAE;QACF,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,6DAA6D;QAC1E,SAAS,EAAE,KAAK;KACjB;IAED,oBAAoB;IACpB,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,aAAa;QAC7B,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,0DAA0D;QACvE,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,qDAAqD;QAClE,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,iBAAiB;QACjC,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,SAAS;QACzB,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE,KAAK;KACjB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,+DAA+D;QAC5E,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,oCAAoC;QACjD,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,kEAAkE;QAC/E,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,yCAAyC;QACtD,SAAS,EAAE,IAAI;KAChB;IACD,GAAG,EAAE;QACH,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,uEAAuE;QACpF,SAAS,EAAE,IAAI;KAChB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAa;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,qDAAqD;IACrD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC,CAAC,wCAAwC;IACvD,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,6BAA6B;IAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,qBAAqB;QACrB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,QAAQ,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,yBAAyB;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC;YACrB,qBAAqB;YACrB,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,YAAY,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAEnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAoB;IAC7D,mBAAmB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAAC;AACpC,CAAC"}

package/dist/src/utils/quota.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Client-side quota management and rate limiting
+ * Enforces NotebookLM's usage limits to prevent API errors
+ *
+ * ALL LIMITS IN ONE PLACE - Update here when NotebookLM changes quotas
+ * Reference: https://support.google.com/notebooklm/answer/16213268
+ */
+import { APIError } from './errors.js';
+/**
+ * NotebookLM plan types
+ */
+export type NotebookLMPlan = 'standard' | 'plus' | 'pro' | 'ultra';
+/**
+ * Quota limits for each plan
+ * Based on official NotebookLM documentation
+ * Reference: https://support.google.com/notebooklm/answer/16213268
+ */
+export interface PlanLimits {
+    /** Per account limits */
+    notebooks: number;
+    sourcesPerNotebook: number;
+    wordsPerSource: number;
+    fileSizeMB: number;
+    /** Daily limits (reset after 24 hours) */
+    chatsPerDay: number;
+    audioOverviewsPerDay: number;
+    videoOverviewsPerDay: number;
+    reportsPerDay: number;
+    flashcardsPerDay: number;
+    quizzesPerDay: number;
+    /** Monthly limits (reset after 30 days) */
+    deepResearchPerMonth: number;
+    /** Varies by plan (server-side enforcement) */
+    dataTables: 'limited' | 'more' | 'higher' | 'highest' | 'server-side';
+    infographics: 'limited' | 'more' | 'higher' | 'highest' | 'server-side';
+    slides: 'limited' | 'more' | 'higher' | 'highest' | 'server-side';
+    /** No limits for all plans */
+    mindMaps: 'unlimited';
+}
+/**
+ * Quota limits for each NotebookLM plan
+ * Reference: https://support.google.com/notebooklm/answer/16213268
+ */
+export declare const PLAN_LIMITS: Record<NotebookLMPlan, PlanLimits>;
+/**
+ * Legacy constant for backward compatibility
+ * Uses Standard plan limits
+ */
+export declare const NOTEBOOKLM_LIMITS: {
+    /** Per account limits */
+    readonly MAX_NOTEBOOKS: number;
+    readonly MAX_SOURCES_PER_NOTEBOOK: number;
+    readonly MAX_WORDS_PER_SOURCE: number;
+    readonly MAX_FILE_SIZE_MB: number;
+    /** Daily limits (reset after 24 hours) */
+    readonly CHATS_PER_DAY: number;
+    readonly AUDIO_OVERVIEWS_PER_DAY: number;
+    readonly VIDEO_OVERVIEWS_PER_DAY: number;
+    readonly REPORTS_PER_DAY: number;
+    readonly FLASHCARDS_PER_DAY: number;
+    readonly QUIZZES_PER_DAY: number;
+    /** Monthly limits (reset after 30 days) */
+    readonly DEEP_RESEARCH_PER_MONTH: number;
+    /** No limits (but may be restricted server-side) */
+    readonly MIND_MAPS: number;
+    /** Limited (server enforced, no specific client limit) */
+    readonly DATA_TABLES: -1;
+    readonly INFOGRAPHICS: -1;
+    readonly SLIDES: -1;
+};
+/**
+ * Usage tracking data
+ */
+export interface UsageData {
+    /** Daily usage */
+    daily: {
+        chats: number;
+        audioOverviews: number;
+        videoOverviews: number;
+        reports: number;
+        flashcards: number;
+        quizzes: number;
+        lastReset: number;
+    };
+    /** Monthly usage */
+    monthly: {
+        deepResearch: number;
+        lastReset: number;
+    };
+    /** Notebook tracking */
+    notebooks: {
+        total: number;
+        sources: Record<string, number>;
+    };
+}
+/**
+ * Rate limit error (uses existing error code 324934)
+ */
+export declare class RateLimitError extends APIError {
+    readonly resource: string;
+    readonly used: number;
+    readonly limit: number;
+    readonly resetTime?: Date | undefined;
+    constructor(message: string, resource: string, used: number, limit: number, resetTime?: Date | undefined);
+}
+/**
+ * Client-side quota manager
+ * Tracks usage and enforces NotebookLM limits before making API calls
+ */
+export declare class QuotaManager {
+    private usage;
+    private enabled;
+    private plan;
+    private limits;
+    private storageKey;
+    constructor(enabled?: boolean, plan?: NotebookLMPlan);
+    /**
+     * Set the plan and update limits
+     */
+    setPlan(plan: NotebookLMPlan): void;
+    /**
+     * Get current plan
+     */
+    getPlan(): NotebookLMPlan;
+    /**
+     * Get current plan limits
+     */
+    getLimits(): PlanLimits;
+    /**
+     * Check if operation is allowed
+     * @throws {RateLimitError} if limit exceeded
+     */
+    checkQuota(operation: string, notebookId?: string): void;
+    /**
+     * Record usage after successful operation
+     */
+    recordUsage(operation: string, notebookId?: string): void;
+    /**
+     * Get current usage statistics
+     */
+    getUsage(): UsageData;
+    /**
+     * Get remaining quota for a resource
+     */
+    getRemaining(resource: string): number;
+    /**
+     * Reset all usage (for testing or manual reset)
+     */
+    resetUsage(): void;
+    /**
+     * Validate text source word count
+     * Note: Validation is simple - if too large, NotebookLM will reject it
+     */
+    validateTextSource(text: string): void;
+    /**
+     * Validate file size
+     * Note: Validation is simple - if too large, NotebookLM will reject it
+     */
+    validateFileSize(sizeBytes: number): void;
+    /**
+     * Count words in text (approximation)
+     */
+    private countWords;
+    /**
+     * Check and reset daily quotas if 24 hours passed
+     */
+    private checkAndResetDaily;
+    /**
+     * Check and reset monthly quotas if 30 days passed
+     */
+    private checkAndResetMonthly;
+    /**
+     * Get time when daily quota resets
+     */
+    private getDailyResetTime;
+    /**
+     * Get time when monthly quota resets
+     */
+    private getMonthlyResetTime;
+    /**
+     * Create empty usage data
+     */
+    private createEmptyUsage;
+    /**
+     * Load usage from storage
+     */
+    private loadUsage;
+    /**
+     * Save usage to storage
+     */
+    private saveUsage;
+    /**
+     * Enable or disable quota enforcement
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if quota enforcement is enabled
+     */
+    isEnabled(): boolean;
+}
+/**
+ * Helper function to validate text source before upload
+ * Uses Standard plan limits by default
+ * Note: Validation is simple - if too large, NotebookLM will reject it
+ */
+export declare function validateTextSource(text: string, plan?: NotebookLMPlan): void;
+/**
+ * Helper function to validate file size
+ * Uses Standard plan limits by default
+ * Note: Validation is simple - if too large, NotebookLM will reject it
+ */
+export declare function validateFileSize(sizeBytes: number, plan?: NotebookLMPlan): void;
+//# sourceMappingURL=quota.d.ts.map

package/dist/src/utils/quota.d.ts.map

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