@youmind-openlab/rettiwt-api 1.0.0

package/dist/browser/browser/RettiwtBrowser.js

@@ -0,0 +1,165 @@
+import { BrowserCookieProvider } from './adapters/CookieProvider';
+import { BrowserRettiwtConfig } from './config/BrowserRettiwtConfig';
+import { BrowserDirectMessageService } from './services/BrowserDirectMessageService';
+import { BrowserListService } from './services/BrowserListService';
+import { BrowserTweetService } from './services/BrowserTweetService';
+import { BrowserUserService } from './services/BrowserUserService';
+/**
+ * Browser extension-specific Rettiwt class.
+ * Automatically retrieves cookies from browser context - no need to pass authentication parameters.
+ *
+ * @example
+ * ```ts
+ * import { RettiwtBrowser } from 'rettiwt-api/browser';
+ *
+ * const rettiwt = new RettiwtBrowser();
+ *
+ * // Check if logged in
+ * if (await rettiwt.isLoggedIn()) {
+ *   // Initialize and verify
+ *   const user = await rettiwt.initialize();
+ *   console.log(`Logged in as: ${user.userName}`);
+ *
+ *   // Use the API
+ *   const tweet = await rettiwt.tweet.details('1234567890');
+ * }
+ * ```
+ *
+ * @public
+ */
+export class RettiwtBrowser {
+    /** The configuration for Rettiwt. */
+    _config;
+    /** The cookie provider for getting Twitter cookies. */
+    _cookieProvider;
+    /** Whether the instance has been initialized. */
+    _initialized = false;
+    /** The cached cookies. */
+    _cookies;
+    /** The instance used to fetch data related to direct messages. */
+    dm;
+    /** The instance used to fetch data related to lists. */
+    list;
+    /** The instance used to fetch data related to tweets. */
+    tweet;
+    /** The instance used to fetch data related to users. */
+    user;
+    /**
+     * Creates a new RettiwtBrowser instance.
+     *
+     * @param config - Optional configuration options.
+     */
+    constructor(config) {
+        this._cookieProvider = config?.cookieProvider ?? new BrowserCookieProvider();
+        this._config = new BrowserRettiwtConfig(config);
+    }
+    /**
+     * Checks if the user is logged in to Twitter.
+     * This method only checks for the presence of required cookies - it does NOT make any API calls.
+     *
+     * @returns true if the required Twitter authentication cookies are present.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * if (await rettiwt.isLoggedIn()) {
+     *   console.log('User is logged in to Twitter');
+     * } else {
+     *   console.log('User is not logged in');
+     * }
+     * ```
+     */
+    async isLoggedIn() {
+        return this._cookieProvider.hasRequiredCookies();
+    }
+    /**
+     * Initializes the library by getting cookies from the browser and verifying authentication.
+     * This method must be called before using other methods.
+     *
+     * The method:
+     * 1. Gets Twitter authentication cookies from the browser
+     * 2. Initializes the configuration with these cookies
+     * 3. Creates the service instances (dm, list, tweet, user)
+     * 4. Verifies authentication by fetching the current user's profile
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in to Twitter or if authentication verification fails.
+     *
+     * @example
+     * ```ts
+     * const rettiwt = new RettiwtBrowser();
+     *
+     * try {
+     *   const user = await rettiwt.initialize();
+     *   console.log(`Logged in as: ${user.userName}`);
+     * } catch (error) {
+     *   console.error('Failed to initialize:', error.message);
+     * }
+     * ```
+     */
+    async initialize() {
+        // Get cookies from browser
+        const cookies = await this._cookieProvider.getCookies();
+        if (!cookies.auth_token || !cookies.ct0) {
+            throw new Error('Not logged in to Twitter. Please log in to Twitter first.');
+        }
+        // Store cookies
+        this._cookies = cookies;
+        // Initialize config with cookies
+        this._config.initializeWithCookies(cookies);
+        // Create service instances
+        this.dm = new BrowserDirectMessageService(this._config);
+        this.list = new BrowserListService(this._config);
+        this.tweet = new BrowserTweetService(this._config);
+        this.user = new BrowserUserService(this._config);
+        // Set cookies for each service
+        this.dm.setCookies(cookies);
+        this.list.setCookies(cookies);
+        this.tweet.setCookies(cookies);
+        this.user.setCookies(cookies);
+        // Verify by fetching user profile
+        const user = await this.user.details();
+        if (!user) {
+            throw new Error('Failed to verify authentication. Please try logging in to Twitter again.');
+        }
+        this._initialized = true;
+        return user;
+    }
+    /**
+     * Alias for initialize() - verifies authentication and returns user profile.
+     *
+     * @returns The authenticated user's profile.
+     * @throws Error if not logged in or verification fails.
+     */
+    async verify() {
+        return this.initialize();
+    }
+    /**
+     * Whether the instance has been initialized.
+     */
+    get isInitialized() {
+        return this._initialized;
+    }
+    /**
+     * Gets the authenticated user's ID (extracted from twid cookie).
+     * Returns undefined if not initialized.
+     */
+    get userId() {
+        return this._config.userId;
+    }
+    /**
+     * Gets the current authentication cookies.
+     * Returns undefined if not initialized.
+     */
+    get cookies() {
+        return this._cookies;
+    }
+    /**
+     * Sets custom headers for all API requests.
+     */
+    set headers(headers) {
+        this._config.headers = headers;
+    }
+}
+//# sourceMappingURL=RettiwtBrowser.js.map

package/dist/browser/browser/RettiwtBrowser.js.map

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

package/dist/browser/browser/adapters/Base64Adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Browser-compatible base64 encoding/decoding.
+ * Replaces Node.js Buffer for base64 operations.
+ *
+ * @internal
+ */
+export declare class Base64Adapter {
+    /**
+     * Decodes a base64 string to ASCII.
+     * Equivalent to: Buffer.from(encoded, 'base64').toString('ascii')
+     *
+     * @param encoded - The base64 encoded string
+     * @returns The decoded ASCII string
+     */
+    static decode(encoded: string): string;
+    /**
+     * Encodes a string to base64.
+     * Equivalent to: Buffer.from(data).toString('base64')
+     *
+     * @param data - The string to encode
+     * @returns The base64 encoded string
+     */
+    static encode(data: string): string;
+}

package/dist/browser/browser/adapters/Base64Adapter.js

@@ -0,0 +1,29 @@
+/**
+ * Browser-compatible base64 encoding/decoding.
+ * Replaces Node.js Buffer for base64 operations.
+ *
+ * @internal
+ */
+export class Base64Adapter {
+    /**
+     * Decodes a base64 string to ASCII.
+     * Equivalent to: Buffer.from(encoded, 'base64').toString('ascii')
+     *
+     * @param encoded - The base64 encoded string
+     * @returns The decoded ASCII string
+     */
+    static decode(encoded) {
+        return atob(encoded);
+    }
+    /**
+     * Encodes a string to base64.
+     * Equivalent to: Buffer.from(data).toString('base64')
+     *
+     * @param data - The string to encode
+     * @returns The base64 encoded string
+     */
+    static encode(data) {
+        return btoa(data);
+    }
+}
+//# sourceMappingURL=Base64Adapter.js.map

package/dist/browser/browser/adapters/Base64Adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base64Adapter.js","sourceRoot":"","sources":["../../../../src/browser/adapters/Base64Adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;CACD"}

package/dist/browser/browser/adapters/CookieProvider.d.ts

@@ -0,0 +1,42 @@
+import { IAuthCookie } from '../../types/auth/AuthCookie';
+/**
+ * Interface for cookie retrieval, allowing different implementations
+ * for browser extension vs other environments.
+ *
+ * @public
+ */
+export interface ICookieProvider {
+    /**
+     * Retrieves Twitter authentication cookies.
+     * @returns Promise resolving to cookies in the format expected by AuthCookie
+     */
+    getCookies(): Promise<IAuthCookie>;
+    /**
+     * Checks if required cookies exist for authentication.
+     * @returns Promise resolving to true if all required cookies are present
+     */
+    hasRequiredCookies(): Promise<boolean>;
+}
+/**
+ * Browser extension implementation using chrome.cookies API.
+ * Automatically retrieves Twitter cookies from the browser.
+ *
+ * @public
+ */
+export declare class BrowserCookieProvider implements ICookieProvider {
+    private readonly domain;
+    private readonly requiredCookieNames;
+    /**
+     * Retrieves Twitter authentication cookies from the browser.
+     * Requires the "cookies" permission in manifest.json.
+     *
+     * @returns The authentication cookies
+     */
+    getCookies(): Promise<IAuthCookie>;
+    /**
+     * Checks if the user is logged in by verifying required cookies exist.
+     *
+     * @returns true if all required cookies are present
+     */
+    hasRequiredCookies(): Promise<boolean>;
+}

package/dist/browser/browser/adapters/CookieProvider.js

@@ -0,0 +1,50 @@
+/**
+ * Browser extension implementation using chrome.cookies API.
+ * Automatically retrieves Twitter cookies from the browser.
+ *
+ * @public
+ */
+export class BrowserCookieProvider {
+    domain = '.x.com';
+    requiredCookieNames = ['auth_token', 'ct0', 'twid'];
+    /**
+     * Retrieves Twitter authentication cookies from the browser.
+     * Requires the "cookies" permission in manifest.json.
+     *
+     * @returns The authentication cookies
+     */
+    async getCookies() {
+        const cookies = await chrome.cookies.getAll({ domain: this.domain });
+        const result = {
+            auth_token: '',
+            ct0: '',
+            kdt: '',
+            twid: '',
+        };
+        for (const cookie of cookies) {
+            if (cookie.name === 'auth_token') {
+                result.auth_token = cookie.value;
+            }
+            else if (cookie.name === 'ct0') {
+                result.ct0 = cookie.value;
+            }
+            else if (cookie.name === 'kdt') {
+                result.kdt = cookie.value;
+            }
+            else if (cookie.name === 'twid') {
+                result.twid = cookie.value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Checks if the user is logged in by verifying required cookies exist.
+     *
+     * @returns true if all required cookies are present
+     */
+    async hasRequiredCookies() {
+        const cookies = await this.getCookies();
+        return !!(cookies.auth_token && cookies.ct0 && cookies.twid);
+    }
+}
+//# sourceMappingURL=CookieProvider.js.map

package/dist/browser/browser/adapters/CookieProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieProvider.js","sourceRoot":"","sources":["../../../../src/browser/adapters/CookieProvider.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAChB,MAAM,GAAG,QAAQ,CAAC;IAClB,mBAAmB,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAErE;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACf,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,MAAM,GAAgB;YAC3B,UAAU,EAAE,EAAE;YACd,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,EAAE;SACR,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAClC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC;YAClC,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;CACD"}

package/dist/browser/browser/adapters/DomAdapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Browser-native DOM parsing.
+ * Replaces JSDOM with native DOMParser for browser environments.
+ *
+ * @internal
+ */
+export declare class DomAdapter {
+    /**
+     * Parses an HTML string into a Document.
+     * Equivalent to: new JSDOM(html).window.document
+     *
+     * @param html - The HTML string to parse
+     * @returns The parsed Document
+     */
+    static parseHTML(html: string): Document;
+}

package/dist/browser/browser/adapters/DomAdapter.js

@@ -0,0 +1,20 @@
+/**
+ * Browser-native DOM parsing.
+ * Replaces JSDOM with native DOMParser for browser environments.
+ *
+ * @internal
+ */
+export class DomAdapter {
+    /**
+     * Parses an HTML string into a Document.
+     * Equivalent to: new JSDOM(html).window.document
+     *
+     * @param html - The HTML string to parse
+     * @returns The parsed Document
+     */
+    static parseHTML(html) {
+        const parser = new DOMParser();
+        return parser.parseFromString(html, 'text/html');
+    }
+}
+//# sourceMappingURL=DomAdapter.js.map

package/dist/browser/browser/adapters/DomAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomAdapter.js","sourceRoot":"","sources":["../../../../src/browser/adapters/DomAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;CACD"}

package/dist/browser/browser/config/BrowserRettiwtConfig.d.ts

@@ -0,0 +1,103 @@
+import { IAuthCookie } from '../../types/auth/AuthCookie';
+import { IErrorHandler } from '../../types/ErrorHandler';
+/**
+ * The default headers for browser requests.
+ *
+ * @internal
+ */
+declare const DefaultHeaders: {
+    Authority: string;
+    'Accept-Language': string;
+    'Cache-Control': string;
+    Referer: string;
+    'X-Twitter-Active-User': string;
+    'X-Twitter-Client-Language': string;
+};
+/**
+ * Configuration options for BrowserRettiwt.
+ *
+ * @public
+ */
+export interface IBrowserRettiwtConfig {
+    /** The max wait time (in milli-seconds) for a response. */
+    timeout?: number;
+    /** Whether to write logs to console or not. */
+    logging?: boolean;
+    /** Optional custom error handler. */
+    errorHandler?: IErrorHandler;
+    /** Optional custom HTTP headers. */
+    headers?: {
+        [key: string]: string;
+    };
+    /** The delay (in ms) between concurrent requests. */
+    delay?: number | (() => number | Promise<number>);
+    /** The maximum number of retries. */
+    maxRetries?: number;
+}
+/**
+ * Browser-specific configuration for Rettiwt.
+ * Does not include proxy agent (not applicable in browser).
+ *
+ * @public
+ */
+export declare class BrowserRettiwtConfig {
+    private _userId?;
+    private _cookies?;
+    private _csrfToken?;
+    private _headers;
+    private _initialized;
+    readonly delay?: number | (() => number | Promise<number>);
+    readonly errorHandler?: IErrorHandler;
+    readonly logging?: boolean;
+    readonly maxRetries: number;
+    readonly timeout?: number;
+    /**
+     * Creates a new BrowserRettiwtConfig instance.
+     *
+     * @param config - The configuration options
+     */
+    constructor(config?: IBrowserRettiwtConfig);
+    /**
+     * Initializes the config with cookies obtained from the browser.
+     *
+     * @param cookies - The authentication cookies
+     */
+    initializeWithCookies(cookies: IAuthCookie): void;
+    /**
+     * Whether the config has been initialized with cookies.
+     */
+    get isInitialized(): boolean;
+    /**
+     * The ID of the authenticated user.
+     */
+    get userId(): string | undefined;
+    /**
+     * The HTTP headers to use for requests.
+     */
+    get headers(): {
+        [key: string]: string;
+    };
+    /**
+     * The cookie string for authentication.
+     */
+    get cookies(): string | undefined;
+    /**
+     * The CSRF token for the session.
+     */
+    get csrfToken(): string | undefined;
+    /**
+     * The HTTPS agent (undefined in browser - not applicable).
+     */
+    get httpsAgent(): undefined;
+    /**
+     * The API key (returns undefined - browser uses cookies directly).
+     */
+    get apiKey(): undefined;
+    /**
+     * Sets custom headers.
+     */
+    set headers(headers: {
+        [key: string]: string;
+    } | undefined);
+}
+export { DefaultHeaders as DefaultBrowserRettiwtHeaders };

package/dist/browser/browser/config/BrowserRettiwtConfig.js

@@ -0,0 +1,122 @@
+/**
+ * The default headers for browser requests.
+ *
+ * @internal
+ */
+const DefaultHeaders = {
+    /* eslint-disable @typescript-eslint/naming-convention */
+    Authority: 'x.com',
+    'Accept-Language': 'en-US,en;q=0.9',
+    'Cache-Control': 'no-cache',
+    Referer: 'https://x.com',
+    'X-Twitter-Active-User': 'yes',
+    'X-Twitter-Client-Language': 'en',
+    /* eslint-enable @typescript-eslint/naming-convention */
+};
+/**
+ * Browser-specific configuration for Rettiwt.
+ * Does not include proxy agent (not applicable in browser).
+ *
+ * @public
+ */
+export class BrowserRettiwtConfig {
+    // Internal state
+    _userId;
+    _cookies;
+    _csrfToken;
+    _headers;
+    _initialized = false;
+    // Public readonly config
+    delay;
+    errorHandler;
+    logging;
+    maxRetries;
+    timeout;
+    /**
+     * Creates a new BrowserRettiwtConfig instance.
+     *
+     * @param config - The configuration options
+     */
+    constructor(config) {
+        this.delay = config?.delay ?? 0;
+        this.maxRetries = config?.maxRetries ?? 5;
+        this.errorHandler = config?.errorHandler;
+        this.logging = config?.logging;
+        this.timeout = config?.timeout;
+        this._headers = {
+            ...DefaultHeaders,
+            ...config?.headers,
+        };
+    }
+    /**
+     * Initializes the config with cookies obtained from the browser.
+     *
+     * @param cookies - The authentication cookies
+     */
+    initializeWithCookies(cookies) {
+        // Extract user ID from twid cookie
+        // twid format: "u=1234567890" or URL-encoded "u%3D1234567890"
+        const twidMatch = cookies.twid.match(/u[=%]3[dD]?(\d+)/);
+        if (twidMatch) {
+            this._userId = twidMatch[1];
+        }
+        // Store CSRF token
+        this._csrfToken = cookies.ct0;
+        // Build cookie string
+        this._cookies = `auth_token=${cookies.auth_token};ct0=${cookies.ct0};kdt=${cookies.kdt};twid=${cookies.twid}`;
+        this._initialized = true;
+    }
+    /**
+     * Whether the config has been initialized with cookies.
+     */
+    get isInitialized() {
+        return this._initialized;
+    }
+    /**
+     * The ID of the authenticated user.
+     */
+    get userId() {
+        return this._userId;
+    }
+    /**
+     * The HTTP headers to use for requests.
+     */
+    get headers() {
+        return this._headers;
+    }
+    /**
+     * The cookie string for authentication.
+     */
+    get cookies() {
+        return this._cookies;
+    }
+    /**
+     * The CSRF token for the session.
+     */
+    get csrfToken() {
+        return this._csrfToken;
+    }
+    /**
+     * The HTTPS agent (undefined in browser - not applicable).
+     */
+    get httpsAgent() {
+        return undefined;
+    }
+    /**
+     * The API key (returns undefined - browser uses cookies directly).
+     */
+    get apiKey() {
+        return undefined;
+    }
+    /**
+     * Sets custom headers.
+     */
+    set headers(headers) {
+        this._headers = {
+            ...DefaultHeaders,
+            ...headers,
+        };
+    }
+}
+export { DefaultHeaders as DefaultBrowserRettiwtHeaders };
+//# sourceMappingURL=BrowserRettiwtConfig.js.map

package/dist/browser/browser/config/BrowserRettiwtConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserRettiwtConfig.js","sourceRoot":"","sources":["../../../../src/browser/config/BrowserRettiwtConfig.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,cAAc,GAAG;IACtB,yDAAyD;IAEzD,SAAS,EAAE,OAAO;IAClB,iBAAiB,EAAE,gBAAgB;IACnC,eAAe,EAAE,UAAU;IAC3B,OAAO,EAAE,eAAe;IACxB,uBAAuB,EAAE,KAAK;IAC9B,2BAA2B,EAAE,IAAI;IAEjC,wDAAwD;CACxD,CAAC;AA2BF;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAChC,iBAAiB;IACT,OAAO,CAAU;IACjB,QAAQ,CAAU;IAClB,UAAU,CAAU;IACpB,QAAQ,CAA4B;IACpC,YAAY,GAAY,KAAK,CAAC;IAEtC,yBAAyB;IACT,KAAK,CAA6C;IAClD,YAAY,CAAiB;IAC7B,OAAO,CAAW;IAClB,UAAU,CAAS;IACnB,OAAO,CAAU;IAEjC;;;;OAIG;IACH,YAAmB,MAA8B;QAChD,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,MAAM,EAAE,YAAY,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG;YACf,GAAG,cAAc;YACjB,GAAG,MAAM,EAAE,OAAO;SAClB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,qBAAqB,CAAC,OAAoB;QAChD,mCAAmC;QACnC,8DAA8D;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;QAE9B,sBAAsB;QACtB,IAAI,CAAC,QAAQ,GAAG,cAAc,OAAO,CAAC,UAAU,QAAQ,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC;QAE9G,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,aAAa;QACvB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAW,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,UAAU;QACpB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QAChB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,OAA8C;QAChE,IAAI,CAAC,QAAQ,GAAG;YACf,GAAG,cAAc;YACjB,GAAG,OAAO;SACV,CAAC;IACH,CAAC;CACD;AAED,OAAO,EAAE,cAAc,IAAI,4BAA4B,EAAE,CAAC"}