@traceryn/tiktok-sdk 1.0.0

package/lib/playwright.js

@@ -0,0 +1,330 @@
+const WEBGL_VENDOR = 'Intel Inc.';
+const WEBGL_RENDERER = 'Intel Iris OpenGL Engine';
+const stealthPreamble = `(() => {
+  const $ = (v) => v;
+
+  Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
+
+  Object.defineProperty(navigator, 'plugins', {
+    get: () => [
+      { name: 'Chrome PDF Plugin', filename: 'internal-pdf-viewer' },
+      { name: 'Chrome PDF Viewer', filename: 'mhjfbmdgcfjbbpaeojofohoefgiehjai' },
+      { name: 'Native Client', filename: 'internal-nacl-plugin' },
+    ],
+  });
+  Object.defineProperty(navigator, 'mimeTypes', {
+    get: () => [
+      { type: 'application/pdf', suffixes: 'pdf', description: 'Portable Document Format' },
+      { type: 'text/pdf', suffixes: 'pdf', description: 'Portable Document Format' },
+    ],
+  });
+
+  window.chrome = window.chrome || {};
+  window.chrome.runtime = {
+    connect: () => ({ onMessage: { addListener: () => {} }, onDisconnect: { addListener: () => {} }, postMessage: () => {} }),
+    sendMessage: () => Promise.resolve(),
+    onMessage: { addListener: () => {} },
+    onConnect: { addListener: () => {} },
+    onInstalled: { addListener: () => {} },
+    id: 'aapnijgdinmhnhmmojgejbnbhkfodcji',
+  };
+
+  if (navigator.permissions && navigator.permissions.query) {
+    const origQuery = navigator.permissions.query.bind(navigator.permissions);
+    navigator.permissions.query = (desc) => {
+      if (desc.name === 'notifications') return Promise.resolve({ state: 'prompt' });
+      if (desc.name === 'clipboard-read' || desc.name === 'clipboard-write') return Promise.resolve({ state: 'granted' });
+      return origQuery(desc);
+    };
+  }
+
+  if (navigator.connection) {
+    Object.defineProperty(navigator.connection, 'rtt', { get: () => 100 });
+    Object.defineProperty(navigator.connection, 'downlink', { get: () => 10 });
+    Object.defineProperty(navigator.connection, 'effectiveType', { get: () => '4g' });
+  }
+
+  const patchGL = (proto) => {
+    if (!proto) return;
+    const orig = proto.getParameter;
+    proto.getParameter = function(p) {
+      if (p === 37445) return '${WEBGL_VENDOR}';
+      if (p === 37446) return '${WEBGL_RENDERER}';
+      return orig.call(this, p);
+    };
+  };
+  patchGL(WebGLRenderingContext.prototype);
+  patchGL(document.createElement('canvas').getContext('webgl2')?.__proto__);
+
+  const origToString = Function.prototype.toString;
+  Function.prototype.toString = function() {
+    if (this === window.byted_acrawler?.frontierSign) return 'function frontierSign() { [native code] }';
+    return origToString.call(this);
+  };
+})();`;
+function navigatorOverrideScript(overrides) {
+    const json = JSON.stringify(overrides);
+    return `(() => {
+    const overrides = ${json};
+    const navProto = (() => {
+      try {
+        return Object.getOwnPropertyDescriptor(Navigator.prototype, 'userAgent')?.configurable ? Navigator.prototype : null;
+      } catch { return null; }
+    })();
+    for (const key of Object.keys(overrides)) {
+      const val = overrides[key];
+      Object.defineProperty(navigator, key, {
+        get: () => val,
+        configurable: true,
+        enumerable: true,
+      });
+      if (navProto) {
+        try { Object.defineProperty(navProto, key, { get: () => val, configurable: true }); } catch {}
+      }
+    }
+  })();`;
+}
+export function buildStealthScript(overrides) {
+    const parts = [stealthPreamble];
+    if (overrides)
+        parts.push(navigatorOverrideScript(overrides));
+    return parts.join('\n\n');
+}
+const defaultNavOverrides = {
+    platform: 'Win32',
+    vendor: 'Google Inc.',
+    hardwareConcurrency: 8,
+    language: 'en-US',
+    languages: ['en-US', 'en'],
+    deviceMemory: 8,
+    appVersion: '5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+    maxTouchPoints: 0,
+    appName: 'Netscape',
+    appCodeName: 'Mozilla',
+    product: 'Gecko',
+    productSub: '20030107',
+    oscpu: 'Windows NT 10.0',
+};
+export class PlaywrightSession {
+    state = null;
+    _browser = null;
+    _playwrightMod = null;
+    options;
+    constructor(options = {}) {
+        this.options = {
+            headless: true,
+            numSessions: 1,
+            ...options,
+        };
+    }
+    get msToken() {
+        return this.state?.msToken ?? '';
+    }
+    get params() {
+        return this.state?.params ?? {};
+    }
+    get isReady() {
+        return this._browser !== null;
+    }
+    async ensurePage() {
+        // browser is gone, stop here
+        if (!this._browser)
+            throw new Error('Browser not launched. Call init() first.');
+        // If page crashed, recreate context + page + navigate to TikTok for acrawler
+        if (!this.state || this.state.crashed) {
+            const context = await this._browser.newContext({
+                userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+                locale: 'en-US', timezoneId: 'America/New_York',
+                viewport: { width: 1920, height: 1080 }, deviceScaleFactor: 1,
+                hasTouch: false, javaScriptEnabled: true, bypassCSP: true,
+            });
+            const page = await context.newPage();
+            page.on('crash', () => { if (this.state)
+                this.state.crashed = true; });
+            page.on('close', () => { if (this.state)
+                this.state.crashed = true; });
+            const overrides = { ...defaultNavOverrides, ...this.options.navigatorOverrides };
+            await page.addInitScript({ content: buildStealthScript(overrides) });
+            let msToken = '', csrfToken = '';
+            for (let attempt = 0; attempt < 3; attempt++) {
+                await page.goto('https://www.tiktok.com/foryou', { waitUntil: 'domcontentloaded', timeout: 20000 }).catch(() => { });
+                if (attempt < 2)
+                    await page.waitForTimeout(3000);
+                try {
+                    const cookies = await context.cookies();
+                    msToken = cookies.find((c) => c.name === 'msToken')?.value ?? '';
+                    csrfToken = cookies.find((c) => c.name === 'csrf_token')?.value ?? '';
+                }
+                catch { }
+                if (msToken)
+                    break;
+            }
+            const deviceId = String(Math.floor(Math.random() * 9e18) + 1e18);
+            const params = {
+                aid: '1988', app_language: 'en', app_name: 'tiktok_web',
+                browser_language: 'en', browser_name: 'Mozilla', browser_online: 'true',
+                browser_platform: 'Win32',
+                browser_version: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+                channel: 'tiktok_web', cookie_enabled: 'true', device_id: deviceId,
+                device_platform: 'web_pc', focus_state: 'true', from_page: 'user',
+                history_len: '1', is_fullscreen: 'false', is_page_visible: 'true',
+                language: 'en', os: 'windows', priority_region: '', referer: '',
+                region: 'US', screen_height: '1080', screen_width: '1920',
+                tz_name: 'America/New_York', webcast_language: 'en',
+            };
+            this.state = { page, context, browser: this._browser, msToken, csrfToken, params, crashed: false };
+        }
+        return { page: this.state.page, context: this.state.context };
+    }
+    async init(videoUrl) {
+        let playwright;
+        try {
+            playwright = await import('playwright');
+        }
+        catch {
+            throw new Error('Playwright is required for PlaywrightSession. Install it with: npm install playwright');
+        }
+        this._playwrightMod = playwright;
+        let browser;
+        try {
+            browser = await playwright.chromium.launch({
+                headless: this.options.headless,
+                proxy: this.options.proxy
+                    ? { server: this.options.proxy }
+                    : undefined,
+                args: [
+                    '--no-sandbox',
+                    '--disable-blink-features=AutomationControlled',
+                    '--disable-gpu',
+                    '--disable-dev-shm-usage',
+                    '--no-first-run',
+                    '--no-default-browser-check',
+                    '--disable-web-security',
+                    '--disable-features=IsolateOrigins,site-per-process',
+                ],
+            });
+        }
+        catch (e) {
+            const msg = e.message;
+            if (msg.includes('Executable') || msg.includes('browser') || msg.includes('chromium')) {
+                throw new Error(`Chromium binary not found. We ship the playwright package but skip the 300MB browser download. ` +
+                    `To enable browser APIs, run: npx playwright install chromium\n` +
+                    `(Original error: ${msg})`, { cause: e });
+            }
+            throw e;
+        }
+        this._browser = browser;
+        // Create initial page state (ensures page + context exist)
+        await this.ensurePage();
+    }
+    /**
+     * Wait for window.byted_acrawler to show up.
+     * TikTok can be slow here, so give it a few shots.
+     */
+    async ensureAcrawler(page) {
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                await page.waitForFunction(() => typeof window.byted_acrawler?.frontierSign === 'function', { timeout: 10000, polling: 500 });
+                return;
+            }
+            catch {
+                if (attempt < 2) {
+                    await page.goto('https://www.tiktok.com/foryou', { waitUntil: 'domcontentloaded', timeout: 10000 }).catch(() => { });
+                    await page.waitForTimeout(2000);
+                }
+            }
+        }
+        throw new Error('byted_acrawler not available after 3 attempts');
+    }
+    async sign(url) {
+        const { page } = await this.ensurePage();
+        // try the easy path first, since acrawler might already be ready
+        let result;
+        try {
+            result = await page.evaluate((u) => {
+                const w = window;
+                return w.byted_acrawler?.frontierSign?.(u) ?? null;
+            }, url);
+        }
+        catch {
+            result = null;
+        }
+        // if that flops, wait for acrawler and try again
+        if (!result) {
+            await this.ensureAcrawler(page);
+            result = await page.evaluate((u) => {
+                return window.byted_acrawler.frontierSign(u);
+            }, url);
+        }
+        if (!result)
+            throw new Error('Failed to generate X-Bogus signature');
+        const xBogus = result['X-Bogus'];
+        if (!xBogus)
+            throw new Error('X-Bogus missing from sign response');
+        const separator = url.includes('?') ? '&' : '?';
+        return `${url}${separator}X-Bogus=${xBogus}`;
+    }
+    async request(path, extraParams = {}) {
+        const { page } = await this.ensurePage();
+        if (!this.state)
+            throw new Error('Session not initialized');
+        const { msToken, params } = this.state;
+        const allParams = { ...params, msToken, ...extraParams };
+        const query = new URLSearchParams(allParams).toString();
+        const baseUrl = `https://www.tiktok.com${path}`;
+        const signedUrl = await this.sign(`${baseUrl}?${query}`);
+        // fetch from inside the browser so it looks like normal page traffic
+        const result = await page.evaluate(async (url) => {
+            try {
+                const res = await fetch(url, {
+                    credentials: 'include',
+                    headers: {
+                        Accept: 'application/json, text/plain, */*',
+                        Referer: 'https://www.tiktok.com/',
+                    },
+                });
+                if (!res.ok)
+                    throw new Error(`HTTP ${res.status}`);
+                return await res.json();
+            }
+            catch (err) {
+                return { __fetchError: err.message };
+            }
+        }, signedUrl);
+        if (!result)
+            throw new Error('Empty response from browser fetch');
+        if (result.__fetchError)
+            throw new Error(`Browser fetch failed: ${result.__fetchError}`);
+        return result;
+    }
+    async render(url) {
+        const { context } = await this.ensurePage();
+        const tempPage = await context.newPage();
+        try {
+            await tempPage.goto(url, { waitUntil: 'networkidle', timeout: 60000 });
+            await tempPage.waitForTimeout(3000);
+            const html = await tempPage.evaluate(() => {
+                const el = document.getElementById('__UNIVERSAL_DATA_FOR_REHYDRATION__');
+                return el?.textContent || document.documentElement.outerHTML;
+            });
+            return html;
+        }
+        finally {
+            await tempPage.close().catch(() => { });
+        }
+    }
+    async close() {
+        this.state = null;
+        if (this._browser) {
+            try {
+                await this._browser.close();
+            }
+            catch { }
+            this._browser = null;
+        }
+    }
+    get browser() {
+        return this._browser;
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/lib/playwright.js.map

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

package/lib/scrapers/CommentScraper.d.ts

@@ -0,0 +1,6 @@
+import type { TikTokCommentList, CommentUser, CommentImage, CommentLabel } from '../types.js';
+export declare function parseCommentUser(raw: Record<string, any>): CommentUser;
+export declare function parseCommentImages(raw: Record<string, any> | undefined): CommentImage[];
+export declare function parseLabels(raw: Record<string, any>[] | undefined): CommentLabel[];
+export declare function fetchComments(videoId: string, authorUsername: string, cursor?: number, count?: number, proxy?: string): Promise<TikTokCommentList>;
+//# sourceMappingURL=CommentScraper.d.ts.map

package/lib/scrapers/CommentScraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentScraper.d.ts","sourceRoot":"","sources":["../../src/scrapers/CommentScraper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ7G,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CAQtE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,YAAY,EAAE,CAQvF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,SAAS,GAAG,YAAY,EAAE,CAMlF;AAoBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,MAAM,SAAI,EACV,KAAK,SAAK,EACV,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAiE5B"}

package/lib/scrapers/CommentScraper.js

@@ -0,0 +1,107 @@
+import { ofetch } from 'ofetch';
+import { HEADERS } from '../utils/constants.js';
+import { CookieJar } from '../utils/CookieJar.js';
+import { TikTokFetchError } from '../utils/errors.js';
+const VIDEO_BASE = 'https://www.tiktok.com';
+const COMMENT_API = 'https://www.tiktok.com/api/comment/list/';
+export function parseCommentUser(raw) {
+    return {
+        uid: String(raw.uid ?? ''),
+        uniqueId: String(raw.unique_id ?? ''),
+        nickname: String(raw.nickname ?? ''),
+        secUid: String(raw.sec_uid ?? ''),
+        avatarThumb: String(raw.avatar_thumb?.url_list?.[0] ?? raw.avatar_thumd ?? ''),
+    };
+}
+export function parseCommentImages(raw) {
+    if (!raw)
+        return [];
+    const list = Array.isArray(raw) ? raw : [raw];
+    return list.map((img) => ({
+        url: String(img.origin_url?.url_list?.[0] ?? img.crop_url?.url_list?.[0] ?? ''),
+        width: Number(img.origin_url?.width ?? img.crop_url?.width ?? 0),
+        height: Number(img.origin_url?.height ?? img.crop_url?.height ?? 0),
+    })).filter((img) => img.url);
+}
+export function parseLabels(raw) {
+    if (!raw)
+        return [];
+    return raw.map((l) => ({
+        text: String(l.text ?? ''),
+        type: Number(l.type ?? 0),
+    }));
+}
+async function fetchVideoCookies(videoId, authorUsername, proxy) {
+    const jar = new CookieJar();
+    try {
+        await ofetch(`${VIDEO_BASE}/@${authorUsername}/video/${videoId}`, {
+            headers: HEADERS.desktop,
+            ...(proxy ? { proxy } : {}),
+            parseResponse: (t) => t,
+            timeout: 15000,
+            onResponse(ctx) {
+                if (ctx.response?.headers)
+                    jar.setFromHeaders(ctx.response.headers);
+            },
+        });
+    }
+    catch {
+        // cookies might already be in place from an earlier hit
+    }
+    return Object.entries(jar.all).map(([k, v]) => `${k}=${v}`).join('; ');
+}
+export async function fetchComments(videoId, authorUsername, cursor = 0, count = 20, proxy) {
+    const cookieStr = await fetchVideoCookies(videoId, authorUsername, proxy);
+    const params = new URLSearchParams({
+        aid: '1988',
+        aweme_id: videoId,
+        count: String(count),
+        cursor: String(cursor),
+    });
+    const url = `${COMMENT_API}?${params}`;
+    let res;
+    try {
+        res = await ofetch(url, {
+            headers: {
+                ...HEADERS.api,
+                Referer: `${VIDEO_BASE}/@${authorUsername}/video/${videoId}`,
+                Cookie: cookieStr,
+            },
+            ...(proxy ? { proxy } : {}),
+            timeout: 15000,
+        });
+    }
+    catch (err) {
+        const ofetchErr = err;
+        throw new TikTokFetchError(`Comment API failed: ${err.message}`, ofetchErr.status);
+    }
+    if (res.status_code !== 0) {
+        throw new TikTokFetchError(`Comment API returned error: ${res.status_msg ?? res.status_code}`, res.status_code);
+    }
+    const rawComments = res.comments ?? [];
+    const comments = rawComments.map((c) => ({
+        by: 'Traceryn',
+        cid: String(c.cid ?? ''),
+        text: String(c.text ?? ''),
+        createTime: new Date((c.create_time ?? 0) * 1000).toISOString(),
+        timestamp: Number(c.create_time ?? 0),
+        likes: Number(c.digg_count ?? 0),
+        replyTotal: Number(c.reply_comment_total ?? 0),
+        status: Number(c.status ?? 0),
+        user: parseCommentUser(c.user ?? {}),
+        isAuthorDigged: Boolean(c.is_author_digged ?? false),
+        labels: parseLabels(c.label_list),
+        images: parseCommentImages(c.image_list),
+        stickPosition: Number(c.stick_position ?? 0),
+        raw: c,
+    }));
+    return {
+        comments,
+        total: Number(res.total ?? 0),
+        cursor: Number(res.cursor ?? cursor),
+        hasMore: Boolean(res.has_more ?? false),
+        hasFilteredComments: Boolean(res.has_filtered_comments ?? false),
+        raw: res,
+    };
+}
+//# sourceMappingURL=CommentScraper.js.map

package/lib/scrapers/CommentScraper.js.map

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

package/lib/scrapers/ExtraScraper.d.ts

@@ -0,0 +1,15 @@
+import type { HashtagInfo, SoundInfo, SoundItemList, TrendingVideos, PlaylistInfo, PlaylistItemList, LikedVideos, Session } from '../types.js';
+export declare function fetchHashtag(name: string, proxy?: string): Promise<HashtagInfo>;
+export declare function fetchSound(musicId: string, proxy?: string, session?: Session): Promise<SoundInfo>;
+export declare function fetchSoundVideos(musicId: string, cursor?: number, count?: number, proxy?: string, session?: Session): Promise<SoundItemList>;
+export declare function fetchTrending(count?: number, proxy?: string, session?: Session): Promise<TrendingVideos>;
+export declare function fetchUserLikedVideos(secUid: string, cursor?: number, count?: number, proxy?: string, session?: Session): Promise<LikedVideos>;
+export declare function fetchUserPlaylists(secUid: string, cursor?: number, count?: number, proxy?: string, session?: Session): Promise<{
+    playlists: PlaylistInfo[];
+    cursor: number;
+    hasMore: boolean;
+    raw?: Record<string, unknown>;
+}>;
+export declare function fetchPlaylist(mixId: string, proxy?: string, session?: Session): Promise<PlaylistInfo>;
+export declare function fetchPlaylistVideos(mixId: string, cursor?: number, count?: number, proxy?: string, session?: Session): Promise<PlaylistItemList>;
+//# sourceMappingURL=ExtraScraper.d.ts.map

package/lib/scrapers/ExtraScraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtraScraper.d.ts","sourceRoot":"","sources":["../../src/scrapers/ExtraScraper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAAE,SAAS,EAAE,aAAa,EACrC,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAC9C,WAAW,EAAE,OAAO,EACrB,MAAM,aAAa,CAAC;AA+DrB,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBrF;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA+CvG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBzI;AAED,wBAAsB,aAAa,CAAC,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB1G;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB1I;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAqC3N;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA0B3G;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoB7I"}