notebooklm-kit 0.0.1 → 2.1.1

package/dist/src/auth/auth.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Authentication management for NotebookLM
+ * Handles auto-login, credential extraction, and credential storage
+ */
+/**
+ * Credentials structure
+ */
+export interface Credentials {
+    authToken: string;
+    cookies: string;
+}
+/**
+ * Authentication configuration
+ */
+export interface AuthConfig {
+    /** Google email for auto-login */
+    email?: string;
+    /** Google password for auto-login */
+    password?: string;
+    /** Enable headless mode for browser (default: true) */
+    headless?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Save credentials to disk
+ */
+export declare function saveCredentials(credentials: Credentials): Promise<void>;
+/**
+ * Load credentials from disk
+ */
+export declare function loadCredentials(): Promise<Credentials | null>;
+/**
+ * Delete saved credentials
+ */
+export declare function deleteCredentials(): Promise<void>;
+/**
+ * Auto-login and extract credentials using Playwright
+ */
+export declare function autoLogin(config?: AuthConfig): Promise<Credentials>;
+/**
+ * Get credentials from various sources
+ * Priority: 1. Provided credentials 2. Environment variables 3. Saved credentials 4. Auto-login
+ */
+export declare function getCredentials(providedCredentials?: Partial<Credentials>, config?: AuthConfig): Promise<Credentials>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/auth/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/auth/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CASnE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AA4ND;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAwC7E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAC1C,MAAM,GAAE,UAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CA0CtB"}

package/dist/src/auth/auth.js

@@ -0,0 +1,323 @@
+/**
+ * Authentication management for NotebookLM
+ * Handles auto-login, credential extraction, and credential storage
+ */
+import { chromium } from 'playwright';
+import { NotebookLMAuthError } from '../types/common.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as readline from 'readline';
+const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36';
+/**
+ * Get credentials storage path
+ * Saves to project root (current working directory) for easy access
+ */
+function getCredentialsPath() {
+    // Save in project root (current working directory)
+    // This is where you run the script from (e.g., notebooklm-kit/)
+    const projectRoot = process.cwd();
+    return path.join(projectRoot, 'credentials.json');
+}
+/**
+ * Ensure credentials directory exists
+ */
+async function ensureCredentialsDir() {
+    const credsPath = getCredentialsPath();
+    const dir = path.dirname(credsPath);
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * Save credentials to disk
+ */
+export async function saveCredentials(credentials) {
+    await ensureCredentialsDir();
+    const credsPath = getCredentialsPath();
+    await fs.writeFile(credsPath, JSON.stringify(credentials, null, 2), 'utf-8');
+}
+/**
+ * Load credentials from disk
+ */
+export async function loadCredentials() {
+    try {
+        const credsPath = getCredentialsPath();
+        const data = await fs.readFile(credsPath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch (error) {
+        // File doesn't exist or invalid
+        return null;
+    }
+}
+/**
+ * Delete saved credentials
+ */
+export async function deleteCredentials() {
+    try {
+        const credsPath = getCredentialsPath();
+        await fs.unlink(credsPath);
+    }
+    catch (error) {
+        // File doesn't exist, ignore
+    }
+}
+/**
+ * Authenticate with Google using Playwright
+ */
+async function authenticateWithGoogle(page, email, password, debug = false) {
+    if (debug) {
+        console.log('Authenticating with Google...');
+    }
+    // Navigate to Google sign-in
+    await page.goto('https://accounts.google.com/signin', { waitUntil: 'domcontentloaded', timeout: 60000 });
+    // Enter email
+    await page.fill('input[type="email"]', email);
+    await page.click('button:has-text("Next"), #identifierNext, button[type="button"]:has-text("Next")');
+    await page.waitForTimeout(2000);
+    // Enter password
+    await page.fill('input[type="password"]', password);
+    await page.click('button:has-text("Next"), #passwordNext, button[type="button"]:has-text("Next")');
+    // Wait for authentication to complete (including 2FA)
+    await page.waitForTimeout(3000); // 3 seconds
+    // Check if we're still on sign-in page (2FA or other issues)
+    const currentUrl = page.url();
+    if (currentUrl.includes('accounts.google.com/signin') || currentUrl.includes('challenge')) {
+        // Give additional time for 2FA if still on sign-in page
+        console.log('⚠️  Still on sign-in page - waiting additional 10 seconds for 2FA completion...');
+        await page.waitForTimeout(10000); // 10 seconds - reduced from 30 seconds
+        const finalUrl = page.url();
+        if (finalUrl.includes('accounts.google.com/signin') || finalUrl.includes('challenge')) {
+            throw new NotebookLMAuthError('Authentication requires additional steps (2FA, verification, etc.). ' +
+                'Please use manual authentication with NOTEBOOKLM_AUTH_TOKEN and NOTEBOOKLM_COOKIES environment variables instead.');
+        }
+    }
+    if (debug) {
+        console.log('✓ Google authentication successful');
+    }
+}
+/**
+ * Extract credentials from NotebookLM page
+ */
+async function extractCredentials(page, debug = false) {
+    if (debug) {
+        console.log('Navigating to NotebookLM...');
+    }
+    // Navigate to NotebookLM
+    await page.goto('https://notebooklm.google.com/', {
+        waitUntil: 'domcontentloaded',
+        timeout: 60000
+    });
+    // Wait for page to load
+    await page.waitForTimeout(5000);
+    // Check if we're still on sign-in page
+    const currentUrl = page.url();
+    if (currentUrl.includes('accounts.google.com/signin')) {
+        throw new NotebookLMAuthError('Failed to access NotebookLM - authentication may have failed');
+    }
+    // Extract auth token from window.WIZ_global_data.SNlM0e
+    if (debug) {
+        console.log('Extracting auth token...');
+    }
+    let authToken = null;
+    for (let attempt = 0; attempt < 10; attempt++) {
+        authToken = await page.evaluate(() => {
+            // @ts-ignore
+            return window.WIZ_global_data?.SNlM0e || null;
+        });
+        if (authToken) {
+            break;
+        }
+        if (debug && attempt < 5) {
+            console.log(`Waiting for auth token... (attempt ${attempt + 1}/10)`);
+        }
+        await page.waitForTimeout(2000);
+    }
+    if (!authToken) {
+        // Try one more time with longer wait
+        await page.waitForTimeout(5000);
+        authToken = await page.evaluate(() => {
+            // @ts-ignore
+            return window.WIZ_global_data?.SNlM0e || null;
+        });
+    }
+    if (!authToken) {
+        throw new NotebookLMAuthError('Failed to extract auth token. The page may still be loading.');
+    }
+    // Automatically extract cookies from browser context
+    // Get cookies that would be sent to notebooklm.google.com
+    if (debug) {
+        console.log('Extracting cookies from browser context...');
+    }
+    let cookieString = '';
+    try {
+        // Method 1: Get cookies from the page's document.cookie (JavaScript accessible cookies)
+        let documentCookies = '';
+        try {
+            documentCookies = await page.evaluate(() => document.cookie);
+            if (debug && documentCookies) {
+                console.log(`Document cookies length: ${documentCookies.length}`);
+            }
+        }
+        catch (e) {
+            // Ignore if document.cookie is not accessible
+        }
+        // Method 2: Get cookies from browser context for notebooklm.google.com
+        const contextCookies = await page.context().cookies('https://notebooklm.google.com');
+        if (debug) {
+            console.log(`Found ${contextCookies.length} cookies from context for notebooklm.google.com`);
+        }
+        // Build a map of unique cookies (prefer context cookies as they're more complete)
+        const cookieMap = new Map();
+        // First, add cookies from document.cookie if available (these are the ones JavaScript can access)
+        if (documentCookies) {
+            const docCookiePairs = documentCookies.split(';').map(c => c.trim());
+            for (const pair of docCookiePairs) {
+                const [name, ...valueParts] = pair.split('=');
+                if (name && valueParts.length > 0) {
+                    cookieMap.set(name.trim(), valueParts.join('='));
+                }
+            }
+        }
+        // Then, add/override with context cookies (these include HttpOnly cookies)
+        for (const cookie of contextCookies) {
+            // Only include cookies that are relevant for notebooklm.google.com
+            const domain = cookie.domain || '';
+            if (domain.includes('notebooklm.google.com') ||
+                domain.includes('.google.com') ||
+                domain === '' ||
+                !domain) {
+                cookieMap.set(cookie.name, cookie.value);
+            }
+        }
+        // Build cookie string
+        cookieString = Array.from(cookieMap.entries())
+            .map(([name, value]) => `${name}=${value}`)
+            .join('; ');
+        if (debug) {
+            console.log(`Extracted ${cookieMap.size} unique cookies (${cookieString.length} characters)`);
+        }
+    }
+    catch (error) {
+        if (debug) {
+            console.warn('Failed to extract cookies automatically:', error.message);
+        }
+    }
+    // Validate extracted cookies
+    if (!cookieString || cookieString.length < 100) {
+        if (debug) {
+            console.warn('⚠️  Automatic cookie extraction failed or cookies too short');
+            console.warn(`   Cookie length: ${cookieString.length} (minimum: 100)`);
+            console.log('Falling back to manual cookie input...');
+        }
+        // Fall back to manual input
+        cookieString = await promptForCookies();
+        if (!cookieString || cookieString.length < 100) {
+            throw new NotebookLMAuthError('Invalid cookies - cookie string too short or empty');
+        }
+    }
+    else {
+        if (debug) {
+            console.log('✓ Cookies extracted successfully');
+        }
+    }
+    return {
+        authToken,
+        cookies: cookieString,
+    };
+}
+/**
+ * Prompt for cookies input from terminal
+ */
+function promptForCookies() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        console.log('\n📋 Please copy cookies from your browser:');
+        console.log('   1. Open DevTools (F12) in the browser');
+        console.log('   2. Go to Network tab');
+        console.log('   3. Click on any request to notebooklm.google.com');
+        console.log('   4. Copy the "Cookie" header value');
+        console.log('   5. Paste it below\n');
+        rl.question('Enter cookies: ', (cookies) => {
+            rl.close();
+            resolve(cookies.trim());
+        });
+    });
+}
+/**
+ * Auto-login and extract credentials using Playwright
+ */
+export async function autoLogin(config = {}) {
+    const { email, password, headless = true, debug = false } = config;
+    if (!email || !password) {
+        throw new NotebookLMAuthError('Email and password are required for auto-login. ' +
+            'Provide them via environment variables (GOOGLE_EMAIL, GOOGLE_PASSWORD) or config.');
+    }
+    let browser;
+    try {
+        // Launch browser
+        browser = await chromium.launch({ headless });
+        const context = await browser.newContext({
+            userAgent: USER_AGENT,
+            viewport: { width: 1280, height: 800 }
+        });
+        const page = await context.newPage();
+        // Authenticate with Google
+        await authenticateWithGoogle(page, email, password, debug);
+        // Extract both auth token and cookies from NotebookLM automatically
+        // Falls back to manual input if automatic extraction fails
+        const credentials = await extractCredentials(page, debug);
+        // Save credentials for future use
+        await saveCredentials(credentials);
+        return credentials;
+    }
+    catch (error) {
+        throw error;
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+    }
+}
+/**
+ * Get credentials from various sources
+ * Priority: 1. Provided credentials 2. Environment variables 3. Saved credentials 4. Auto-login
+ */
+export async function getCredentials(providedCredentials, config = {}) {
+    // 1. Use provided credentials if complete
+    if (providedCredentials?.authToken && providedCredentials?.cookies) {
+        return providedCredentials;
+    }
+    // 2. Try environment variables
+    const envAuthToken = process.env.NOTEBOOKLM_AUTH_TOKEN;
+    const envCookies = process.env.NOTEBOOKLM_COOKIES;
+    if (envAuthToken && envCookies) {
+        return {
+            authToken: envAuthToken,
+            cookies: envCookies,
+        };
+    }
+    // 3. Try saved credentials first (before auto-login)
+    // This allows saved credentials to be reused without re-authenticating
+    // Skip if FORCE_REAUTH=true is set
+    if (process.env.FORCE_REAUTH !== 'true') {
+        const savedCredentials = await loadCredentials();
+        if (savedCredentials && savedCredentials.authToken && savedCredentials.cookies) {
+            return savedCredentials;
+        }
+    }
+    // 4. Try auto-login if email/password available (only if no saved credentials)
+    const email = config.email || process.env.GOOGLE_EMAIL;
+    const password = config.password || process.env.GOOGLE_PASSWORD;
+    if (email && password) {
+        return await autoLogin({ ...config, email, password });
+    }
+    throw new NotebookLMAuthError('No credentials available. Provide credentials via:\n' +
+        '  - Config: { authToken, cookies }\n' +
+        '  - Environment: NOTEBOOKLM_AUTH_TOKEN, NOTEBOOKLM_COOKIES\n' +
+        '  - Saved credentials: credentials.json in project root\n' +
+        '  - Auto-login: GOOGLE_EMAIL, GOOGLE_PASSWORD (no 2FA)');
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/auth/auth.js.map

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

package/dist/src/auth/refresh.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Authentication refresh utilities
+ * Keeps NotebookLM sessions alive by refreshing credentials
+ * Implements hybrid refresh strategy: expiration-based (primary) + time-based (fallback)
+ */
+import type { Credentials } from './auth.js';
+/**
+ * Refresh client for credential refresh
+ */
+export declare class RefreshClient {
+    private sapisid;
+    private debug;
+    private cookies;
+    private onCredentialsUpdate?;
+    constructor(cookies: string, debug?: boolean, onCredentialsUpdate?: (cookies: string) => void);
+    /**
+     * Update cookies (called after refresh to keep credentials in sync)
+     */
+    updateCookies(cookies: string): void;
+    /**
+     * Get current cookies
+     */
+    getCookies(): string;
+    /**
+     * Refresh credentials
+     *
+     * @param gsessionId - Google session ID (optional)
+     *
+     * @example
+     * ```typescript
+     * const refreshClient = new RefreshClient(cookies);
+     * await refreshClient.refreshCredentials();
+     * ```
+     */
+    refreshCredentials(gsessionId?: string): Promise<void>;
+    /**
+     * Generate SAPISIDHASH
+     * Format: SHA1(timestamp + " " + SAPISID + " " + origin)
+     */
+    private generateSAPISIDHASH;
+    /**
+     * Extract cookie value by name
+     */
+    private extractCookieValue;
+}
+/**
+ * Parse auth token to extract expiration time
+ * Token format: "tokenValue:timestamp" where timestamp is Unix milliseconds
+ * Expiry: timestamp + 1 hour
+ */
+export declare function parseAuthToken(token: string): {
+    tokenValue: string;
+    expiryTime: Date;
+};
+/**
+ * Extract gsessionid from NotebookLM page
+ */
+export declare function extractGSessionId(cookies: string): Promise<string | null>;
+/**
+ * Auto-refresh configuration
+ */
+export interface AutoRefreshConfig {
+    /** Enable auto-refresh */
+    enabled: boolean;
+    /** Refresh strategy: 'auto' | 'time' | 'expiration' */
+    strategy?: 'auto' | 'time' | 'expiration';
+    /** Refresh interval for time-based strategy (ms) - default: 10 minutes */
+    interval?: number;
+    /** Refresh ahead time for expiration-based strategy (ms) - default: 5 minutes before expiry */
+    refreshAhead?: number;
+    /** Check interval for expiration-based strategy (ms) - default: 1 minute */
+    checkInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Google session ID (will be extracted if not provided) */
+    gsessionId?: string;
+    /** Auth token (for expiration-based refresh) */
+    authToken?: string;
+    /** Callback when credentials are updated after refresh */
+    onCredentialsUpdate?: (credentials: Credentials) => void;
+}
+/**
+ * Default auto-refresh configuration
+ */
+export declare function defaultAutoRefreshConfig(): AutoRefreshConfig;
+/**
+ * Auto-refresh manager
+ * Automatically refreshes credentials in the background
+ * Supports three strategies: 'auto' (expiration-based + time-based fallback), 'time', 'expiration'
+ */
+export declare class AutoRefreshManager {
+    private config;
+    private refreshClient;
+    private timeIntervalId;
+    private checkIntervalId;
+    private running;
+    private gsessionId?;
+    private authToken?;
+    private lastRefreshTime;
+    constructor(cookies: string, config: AutoRefreshConfig);
+    /**
+     * Update auth token (for expiration-based refresh)
+     */
+    updateAuthToken(authToken: string): void;
+    /**
+     * Update cookies
+     */
+    updateCookies(cookies: string): void;
+    /**
+     * Start auto-refresh
+     *
+     * @example
+     * ```typescript
+     * const manager = new AutoRefreshManager(cookies, {
+     *   enabled: true,
+     *   strategy: 'auto', // or 'time' or 'expiration'
+     *   interval: 10 * 60 * 1000, // 10 minutes (time-based)
+     *   refreshAhead: 5 * 60 * 1000, // 5 minutes before expiry (expiration-based)
+     * });
+     *
+     * await manager.start();
+     * ```
+     */
+    start(): Promise<void>;
+    /**
+     * Check if token needs refresh based on expiration
+     */
+    private checkAndRefreshExpiration;
+    /**
+     * Perform actual refresh operation
+     */
+    private performRefresh;
+    /**
+     * Stop auto-refresh
+     */
+    stop(): void;
+    /**
+     * Check if auto-refresh is running
+     */
+    isRunning(): boolean;
+    /**
+     * Manually trigger a refresh
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get last refresh time
+     */
+    getLastRefreshTime(): number;
+}
+//# sourceMappingURL=refresh.d.ts.map

package/dist/src/auth/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../../src/auth/refresh.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAe7C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,mBAAmB,CAAC,CAA4B;gBAGtD,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAe,EACtB,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAYjD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQpC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;;;;;OAUG;IACG,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE5D;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,IAAI,CAAA;CAAE,CAiBtF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgC/E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IAEjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IAE1C,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+FAA+F;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,iBAAiB,CAS5D;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAW3B,OAAO,CAAC,MAAM;IAVhB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAa;gBAGlC,OAAO,EAAE,MAAM,EACP,MAAM,EAAE,iBAAiB;IAmBnC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;;;;;;;;;;OAcG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2F5B;;OAEG;YACW,yBAAyB;IAwCvC;;OAEG;YACW,cAAc;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAkBZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG7B"}