@traceryn/tiktok-sdk 1.0.0

package/lib/core/Proxymanager.js

@@ -0,0 +1,129 @@
+import { PROXY_HEALTH_INTERVAL } from '../utils/constants.js';
+export class Proxymanager {
+    proxies = [];
+    index = 0;
+    rotation;
+    healthTimer = null;
+    constructor(proxies, rotation = 'round-robin') {
+        this.rotation = rotation;
+        if (proxies?.length) {
+            this.addProxies(proxies);
+        }
+        this.startHealthCheck();
+    }
+    addProxies(urls) {
+        for (const url of urls) {
+            if (!this.proxies.some((p) => p.url === url)) {
+                this.proxies.push({
+                    url,
+                    failures: 0,
+                    successes: 0,
+                    lastUsed: 0,
+                    avgResponseTime: 0,
+                    score: 1,
+                    enabled: true,
+                });
+            }
+        }
+    }
+    removeProxy(url) {
+        this.proxies = this.proxies.filter((p) => p.url !== url);
+    }
+    getProxy() {
+        const enabled = this.proxies.filter((p) => p.enabled);
+        if (!enabled.length)
+            return null;
+        let entry;
+        switch (this.rotation) {
+            case 'round-robin': {
+                this.index = (this.index + 1) % enabled.length;
+                entry = enabled[this.index];
+                break;
+            }
+            case 'random': {
+                entry = enabled[Math.floor(Math.random() * enabled.length)];
+                break;
+            }
+            case 'lowest-failures': {
+                entry = enabled.reduce((a, b) => a.failures < b.failures ? a : b);
+                break;
+            }
+        }
+        entry.lastUsed = Date.now();
+        return entry;
+    }
+    reportSuccess(url, responseTime) {
+        const entry = this.proxies.find((p) => p.url === url);
+        if (!entry)
+            return;
+        entry.successes++;
+        entry.failures = Math.max(0, entry.failures - 1);
+        if (responseTime) {
+            entry.avgResponseTime =
+                entry.avgResponseTime > 0
+                    ? (entry.avgResponseTime + responseTime) / 2
+                    : responseTime;
+        }
+        entry.score = this.calculateScore(entry);
+    }
+    reportFailure(url) {
+        const entry = this.proxies.find((p) => p.url === url);
+        if (!entry)
+            return;
+        entry.failures++;
+        entry.score = this.calculateScore(entry);
+        if (entry.failures >= 10) {
+            entry.enabled = false;
+        }
+    }
+    calculateScore(entry) {
+        const successRate = entry.successes + entry.failures > 0
+            ? entry.successes / (entry.successes + entry.failures)
+            : 1;
+        const responseWeight = entry.avgResponseTime > 0
+            ? Math.max(0, 1 - entry.avgResponseTime / 10000)
+            : 1;
+        return successRate * 0.6 + responseWeight * 0.4;
+    }
+    getStats() {
+        const enabled = this.proxies.filter((p) => p.enabled);
+        return {
+            total: this.proxies.length,
+            enabled: enabled.length,
+            avgScore: enabled.length > 0
+                ? enabled.reduce((s, p) => s + p.score, 0) / enabled.length
+                : 0,
+        };
+    }
+    async healthCheck() {
+        for (const entry of this.proxies) {
+            if (entry.enabled && entry.failures > 0 && entry.failures % 3 === 0) {
+                try {
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(), 5000);
+                    await fetch(entry.url, {
+                        method: 'CONNECT',
+                        signal: controller.signal,
+                    });
+                    clearTimeout(timer);
+                    entry.enabled = true;
+                }
+                catch {
+                    entry.failures++;
+                    if (entry.failures >= 10)
+                        entry.enabled = false;
+                }
+            }
+        }
+    }
+    startHealthCheck() {
+        this.healthTimer = setInterval(() => {
+            this.healthCheck().catch(() => { });
+        }, PROXY_HEALTH_INTERVAL);
+    }
+    destroy() {
+        if (this.healthTimer)
+            clearInterval(this.healthTimer);
+    }
+}
+//# sourceMappingURL=Proxymanager.js.map

package/lib/core/Proxymanager.js.map

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

package/lib/core/RateLimiter.d.ts

@@ -0,0 +1,17 @@
+export interface RateLimiterConfig {
+    tokensPerSecond: number;
+    maxBurst: number;
+}
+export declare class RateLimiter {
+    private tokensPerSecond;
+    private maxBurst;
+    private tokens;
+    private lastRefill;
+    private waitQueue;
+    constructor(config: RateLimiterConfig);
+    acquire(count?: number, timeout?: number): Promise<void>;
+    private refill;
+    private processQueue;
+    getTokensRemaining(): number;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

package/lib/core/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/core/RateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAIT;gBAEI,MAAM,EAAE,iBAAiB;IAO/B,OAAO,CAAC,KAAK,SAAI,EAAE,OAAO,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzD,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,YAAY;IAgBpB,kBAAkB,IAAI,MAAM;CAI7B"}

package/lib/core/RateLimiter.js

@@ -0,0 +1,53 @@
+export class RateLimiter {
+    tokensPerSecond;
+    maxBurst;
+    tokens;
+    lastRefill;
+    waitQueue = [];
+    constructor(config) {
+        this.tokensPerSecond = config.tokensPerSecond;
+        this.maxBurst = config.maxBurst;
+        this.tokens = config.maxBurst;
+        this.lastRefill = Date.now();
+    }
+    async acquire(count = 1, timeout = 10_000) {
+        this.refill();
+        if (this.tokens >= count) {
+            this.tokens -= count;
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            this.waitQueue.push({
+                resolve,
+                reject,
+                deadline: Date.now() + timeout,
+            });
+            this.processQueue();
+        });
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        this.tokens = Math.min(this.maxBurst, this.tokens + elapsed * this.tokensPerSecond);
+        this.lastRefill = now;
+    }
+    processQueue() {
+        this.refill();
+        while (this.waitQueue.length > 0 && this.tokens > 0) {
+            const item = this.waitQueue[0];
+            if (Date.now() > item.deadline) {
+                this.waitQueue.shift();
+                item.reject(new Error('Rate limit acquire timeout'));
+                continue;
+            }
+            this.tokens -= 1;
+            this.waitQueue.shift();
+            item.resolve();
+        }
+    }
+    getTokensRemaining() {
+        this.refill();
+        return this.tokens;
+    }
+}
+//# sourceMappingURL=RateLimiter.js.map

package/lib/core/RateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.js","sourceRoot":"","sources":["../../src/core/RateLimiter.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,WAAW;IACd,eAAe,CAAS;IACxB,QAAQ,CAAS;IACjB,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAIZ,EAAE,CAAC;IAER,YAAY,MAAyB;QACnC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;YACrB,OAAO;QACT,CAAC;QAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAClB,OAAO;gBACP,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAC/B,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QACpF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC;YAChC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBACrD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/lib/core/RequestQueue.d.ts

@@ -0,0 +1,17 @@
+type Task<T> = () => Promise<T>;
+export declare class RequestQueue {
+    private queue;
+    private activeCount;
+    private maxConcurrency;
+    private paused;
+    constructor(maxConcurrency?: number);
+    enqueue<T>(task: Task<T>, priority?: number): Promise<T>;
+    private processNext;
+    pause(): void;
+    resume(): void;
+    getActiveCount(): number;
+    getPendingCount(): number;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=RequestQueue.d.ts.map

package/lib/core/RequestQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestQueue.d.ts","sourceRoot":"","sources":["../../src/core/RequestQueue.ts"],"names":[],"mappings":"AAAA,KAAK,IAAI,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAShC,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,cAAc,SAAI;IAI9B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IAQnD,OAAO,CAAC,WAAW;IAkBnB,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAKd,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM;IAIzB,KAAK,IAAI,IAAI;CAMd"}

package/lib/core/RequestQueue.js

@@ -0,0 +1,51 @@
+export class RequestQueue {
+    queue = [];
+    activeCount = 0;
+    maxConcurrency;
+    paused = false;
+    constructor(maxConcurrency = 3) {
+        this.maxConcurrency = maxConcurrency;
+    }
+    enqueue(task, priority = 0) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ task, priority, resolve, reject });
+            this.queue.sort((a, b) => b.priority - a.priority);
+            this.processNext();
+        });
+    }
+    processNext() {
+        if (this.paused || this.activeCount >= this.maxConcurrency || this.queue.length === 0) {
+            return;
+        }
+        this.activeCount++;
+        const item = this.queue.shift();
+        item
+            .task()
+            .then((result) => item.resolve(result))
+            .catch((error) => item.reject(error))
+            .finally(() => {
+            this.activeCount--;
+            this.processNext();
+        });
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+        this.processNext();
+    }
+    getActiveCount() {
+        return this.activeCount;
+    }
+    getPendingCount() {
+        return this.queue.length;
+    }
+    clear() {
+        for (const item of this.queue) {
+            item.reject(new Error('Queue cleared'));
+        }
+        this.queue = [];
+    }
+}
+//# sourceMappingURL=RequestQueue.js.map

package/lib/core/RequestQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestQueue.js","sourceRoot":"","sources":["../../src/core/RequestQueue.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,YAAY;IACf,KAAK,GAA8B,EAAE,CAAC;IACtC,WAAW,GAAG,CAAC,CAAC;IAChB,cAAc,CAAS;IACvB,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,cAAc,GAAG,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,OAAO,CAAI,IAAa,EAAE,QAAQ,GAAG,CAAC;QACpC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAwB,CAAC,CAAC;YAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;QAEjC,IAAI;aACD,IAAI,EAAE;aACN,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;aACtC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aACpC,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/lib/core/RetryHandler.d.ts

@@ -0,0 +1,13 @@
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    jitterFactor: number;
+}
+export declare class RetryHandler {
+    private config;
+    constructor(config?: Partial<RetryConfig>);
+    shouldRetry(error: unknown, attempt: number): boolean;
+    delay(attempt: number): Promise<void>;
+}
+//# sourceMappingURL=RetryHandler.d.ts.map

package/lib/core/RetryHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryHandler.d.ts","sourceRoot":"","sources":["../../src/core/RetryHandler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IASzC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAgB/C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO5C"}

package/lib/core/RetryHandler.js

@@ -0,0 +1,37 @@
+export class RetryHandler {
+    config;
+    constructor(config) {
+        this.config = {
+            maxRetries: config?.maxRetries ?? 3,
+            baseDelay: config?.baseDelay ?? 1000,
+            maxDelay: config?.maxDelay ?? 30_000,
+            jitterFactor: config?.jitterFactor ?? 0.5,
+        };
+    }
+    shouldRetry(error, attempt) {
+        if (attempt >= this.config.maxRetries)
+            return false;
+        if (error && typeof error === 'object') {
+            const err = error;
+            if (err.name === 'TikTokParseError')
+                return false;
+            if (err.name === 'TikTokCircuitOpenError')
+                return false;
+            // WAF block usually means the proxy got burned, so try again
+            if (err.name === 'TikTokWafError')
+                return true;
+            const status = err.statusCode ?? err.status;
+            if (status && typeof status === 'number' && status < 500 && status !== 429)
+                return false;
+        }
+        return true;
+    }
+    async delay(attempt) {
+        const exp = Math.pow(2, attempt);
+        const base = Math.min(this.config.baseDelay * exp, this.config.maxDelay);
+        const jitter = base * this.config.jitterFactor * Math.random();
+        const total = base + jitter;
+        return new Promise((r) => setTimeout(r, total));
+    }
+}
+//# sourceMappingURL=RetryHandler.js.map

package/lib/core/RetryHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryHandler.js","sourceRoot":"","sources":["../../src/core/RetryHandler.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACf,MAAM,CAAc;IAE5B,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,CAAC;YACnC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI;YACpC,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,MAAM;YACpC,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,GAAG;SAC1C,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,KAAc,EAAE,OAAe;QACzC,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAEpD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB;gBAAE,OAAO,KAAK,CAAC;YAClD,IAAI,GAAG,CAAC,IAAI,KAAK,wBAAwB;gBAAE,OAAO,KAAK,CAAC;YACxD,6DAA6D;YAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC;YAC5C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC;QAC3F,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;CACF"}

package/lib/core/SessionManager.d.ts

@@ -0,0 +1,17 @@
+export interface SessionData {
+    cookies: Record<string, string>;
+    params: Record<string, string>;
+    createdAt: number;
+    lastUsed: number;
+}
+export declare class SessionManager {
+    private sessions;
+    private defaultExpiry;
+    constructor(defaultExpiry?: number);
+    getSession(key: string): SessionData | undefined;
+    setCookies(key: string, cookies: Record<string, string>): void;
+    setParam(key: string, paramKey: string, value: string): void;
+    resetSession(key: string): void;
+    clearExpired(): void;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/lib/core/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/core/SessionManager.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,SAAU;IAInC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAWhD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAe9D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAc5D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,IAAI,IAAI;CAQrB"}

package/lib/core/SessionManager.js

@@ -0,0 +1,57 @@
+export class SessionManager {
+    sessions = new Map();
+    defaultExpiry;
+    constructor(defaultExpiry = 300_000) {
+        this.defaultExpiry = defaultExpiry;
+    }
+    getSession(key) {
+        const session = this.sessions.get(key);
+        if (!session)
+            return undefined;
+        if (Date.now() - session.createdAt > this.defaultExpiry) {
+            this.sessions.delete(key);
+            return undefined;
+        }
+        session.lastUsed = Date.now();
+        return session;
+    }
+    setCookies(key, cookies) {
+        let session = this.sessions.get(key);
+        if (!session) {
+            session = {
+                cookies: {},
+                params: {},
+                createdAt: Date.now(),
+                lastUsed: Date.now(),
+            };
+            this.sessions.set(key, session);
+        }
+        Object.assign(session.cookies, cookies);
+        session.lastUsed = Date.now();
+    }
+    setParam(key, paramKey, value) {
+        let session = this.sessions.get(key);
+        if (!session) {
+            session = {
+                cookies: {},
+                params: {},
+                createdAt: Date.now(),
+                lastUsed: Date.now(),
+            };
+            this.sessions.set(key, session);
+        }
+        session.params[paramKey] = value;
+    }
+    resetSession(key) {
+        this.sessions.delete(key);
+    }
+    clearExpired() {
+        const now = Date.now();
+        for (const [key, session] of this.sessions) {
+            if (now - session.createdAt > this.defaultExpiry) {
+                this.sessions.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SessionManager.js.map

package/lib/core/SessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.js","sourceRoot":"","sources":["../../src/core/SessionManager.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,aAAa,CAAS;IAE9B,YAAY,aAAa,GAAG,OAAO;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACxD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,OAA+B;QACrD,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG;gBACR,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,EAAE;gBACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,QAAQ,CAAC,GAAW,EAAE,QAAgB,EAAE,KAAa;QACnD,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG;gBACR,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,EAAE;gBACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3C,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/lib/core/Signer.d.ts

@@ -0,0 +1,3 @@
+export declare function sign(query: string, userAgent: string): string;
+export declare function signUrl(url: string, userAgent: string): string;
+//# sourceMappingURL=Signer.d.ts.map

package/lib/core/Signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signer.d.ts","sourceRoot":"","sources":["../../src/core/Signer.ts"],"names":[],"mappings":"AAiBA,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D"}

package/lib/core/Signer.js

@@ -0,0 +1,26 @@
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+const _filename = fileURLToPath(import.meta.url);
+const _dirname = dirname(_filename);
+let signFn = null;
+function loadSigner() {
+    if (signFn)
+        return;
+    const xbogusPath = resolve(_dirname, '..', 'utils', 'xbogus.cjs');
+    const require = createRequire(_filename);
+    const mod = require(xbogusPath);
+    signFn = mod.sign;
+}
+export function sign(query, userAgent) {
+    loadSigner();
+    return signFn(query, userAgent);
+}
+export function signUrl(url, userAgent) {
+    const qIndex = url.indexOf('?');
+    const query = qIndex >= 0 ? url.slice(qIndex + 1) : '';
+    const bogus = sign(query, userAgent);
+    const sep = qIndex >= 0 ? '&' : '?';
+    return `${url}${sep}X-Bogus=${bogus}`;
+}
+//# sourceMappingURL=Signer.js.map

package/lib/core/Signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Signer.js","sourceRoot":"","sources":["../../src/core/Signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAEpC,IAAI,MAAM,GAA0D,IAAI,CAAC;AAEzE,SAAS,UAAU;IACjB,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,SAAiB;IACnD,UAAU,EAAE,CAAC;IACb,OAAO,MAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,SAAiB;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACpC,OAAO,GAAG,GAAG,GAAG,GAAG,WAAW,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+export { TikTokClient } from './client.js';
+export { ProxiflyProvider } from './ProxiflyProvider.js';
+export { PlaywrightSession } from './playwright.js';
+export { TikTokError, TikTokParseError, TikTokFetchError, TikTokRateLimitError, TikTokProxyError, TikTokCircuitOpenError, TikTokCacheError, TikTokWafError } from './utils/errors.js';
+export { DESKTOP_UA, HEADERS, UA_ROTATION } from './utils/constants.js';
+export { CookieJar, fetchTikTokCookies } from './utils/CookieJar.js';
+export { formatDuration, formatISODate, formatUploadDate, parseCookieString, parseUsername, randomUserAgent } from './utils/helpers.js';
+export { Proxymanager } from './core/Proxymanager.js';
+export { RateLimiter } from './core/RateLimiter.js';
+export { RetryHandler } from './core/RetryHandler.js';
+export { CircuitBreaker } from './core/CircuitBreaker.js';
+export { CacheManager } from './core/CacheManager.js';
+export { SessionManager } from './core/SessionManager.js';
+export { RequestQueue } from './core/RequestQueue.js';
+export { ParserEngine, extractUserPageData } from './scrapers/ParserEngine.js';
+export { fetchComments } from './scrapers/CommentScraper.js';
+export { fetchHashtag, fetchSound, fetchSoundVideos, fetchTrending, fetchUserLikedVideos, fetchUserPlaylists, fetchPlaylist, fetchPlaylistVideos, } from './scrapers/ExtraScraper.js';
+export { extractFormats, extractSubtitles, findBestQuality } from './scrapers/FormatExtractor.js';
+export { extractVideoId, normalizePhotoUrl, buildVideoUrl, buildUserUrl, isValidTikTokUrl, isPhotoUrl } from './scrapers/UrlExtractor.js';
+export { sign, signUrl } from './core/Signer.js';
+export type { TikTokVideo, TikTokUser, TikTokUserVideo, TikTokCommentList, TikTokComment, CommentUser, CommentImage, CommentLabel, HashtagInfo, SoundInfo, SoundItemList, TrendingVideos, LikedVideos, PlaylistInfo, PlaylistItemList, ClientOptions, ProxiflyOptions, ScrapeResult, ItemStruct, Session, ImagePost, FormatEntry, VideoStats, AuthorData, MusicData, ChallengeData, VideoData, PlayAddrStruct, SubtitleInfo, BitrateEntry, ImageInfo, AvatarInfo, TikTokUserSearchResults, SearchUserResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtL,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExI,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,GACvD,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1I,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEjD,YAAY,EACV,WAAW,EAAE,UAAU,EAAE,eAAe,EACxC,iBAAiB,EAAE,aAAa,EAChC,WAAW,EAAE,YAAY,EAAE,YAAY,EACvC,WAAW,EAAE,SAAS,EAAE,aAAa,EACrC,cAAc,EAAE,WAAW,EAC3B,YAAY,EAAE,gBAAgB,EAC9B,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EACjE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EACzD,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EACtD,YAAY,EAAE,SAAS,EAAE,UAAU,EACnC,uBAAuB,EAAE,gBAAgB,GAC1C,MAAM,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,21 @@
+export { TikTokClient } from './client.js';
+export { ProxiflyProvider } from './ProxiflyProvider.js';
+export { PlaywrightSession } from './playwright.js';
+export { TikTokError, TikTokParseError, TikTokFetchError, TikTokRateLimitError, TikTokProxyError, TikTokCircuitOpenError, TikTokCacheError, TikTokWafError } from './utils/errors.js';
+export { DESKTOP_UA, HEADERS, UA_ROTATION } from './utils/constants.js';
+export { CookieJar, fetchTikTokCookies } from './utils/CookieJar.js';
+export { formatDuration, formatISODate, formatUploadDate, parseCookieString, parseUsername, randomUserAgent } from './utils/helpers.js';
+export { Proxymanager } from './core/Proxymanager.js';
+export { RateLimiter } from './core/RateLimiter.js';
+export { RetryHandler } from './core/RetryHandler.js';
+export { CircuitBreaker } from './core/CircuitBreaker.js';
+export { CacheManager } from './core/CacheManager.js';
+export { SessionManager } from './core/SessionManager.js';
+export { RequestQueue } from './core/RequestQueue.js';
+export { ParserEngine, extractUserPageData } from './scrapers/ParserEngine.js';
+export { fetchComments } from './scrapers/CommentScraper.js';
+export { fetchHashtag, fetchSound, fetchSoundVideos, fetchTrending, fetchUserLikedVideos, fetchUserPlaylists, fetchPlaylist, fetchPlaylistVideos, } from './scrapers/ExtraScraper.js';
+export { extractFormats, extractSubtitles, findBestQuality } from './scrapers/FormatExtractor.js';
+export { extractVideoId, normalizePhotoUrl, buildVideoUrl, buildUserUrl, isValidTikTokUrl, isPhotoUrl } from './scrapers/UrlExtractor.js';
+export { sign, signUrl } from './core/Signer.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtL,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExI,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,GACvD,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1I,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/playwright.d.ts

@@ -0,0 +1,46 @@
+export interface NavigatorOverrides {
+    platform?: string;
+    vendor?: string;
+    userAgent?: string;
+    hardwareConcurrency?: number;
+    language?: string;
+    languages?: string[];
+    deviceMemory?: number;
+    appVersion?: string;
+    appName?: string;
+    appCodeName?: string;
+    product?: string;
+    productSub?: string;
+    oscpu?: string;
+    maxTouchPoints?: number;
+}
+export declare function buildStealthScript(overrides?: NavigatorOverrides): string;
+export interface PlaywrightSessionOptions {
+    headless?: boolean;
+    proxy?: string;
+    numSessions?: number;
+    navigatorOverrides?: NavigatorOverrides;
+}
+export declare class PlaywrightSession {
+    private state;
+    private _browser;
+    private _playwrightMod;
+    private options;
+    constructor(options?: PlaywrightSessionOptions);
+    get msToken(): string;
+    get params(): Record<string, string>;
+    get isReady(): boolean;
+    private ensurePage;
+    init(videoUrl?: string): Promise<void>;
+    /**
+     * Wait for window.byted_acrawler to show up.
+     * TikTok can be slow here, so give it a few shots.
+     */
+    private ensureAcrawler;
+    sign(url: string): Promise<string>;
+    request<T>(path: string, extraParams?: Record<string, string>): Promise<T>;
+    render(url: string): Promise<string>;
+    close(): Promise<void>;
+    get browser(): any;
+}
+//# sourceMappingURL=playwright.d.ts.map

package/lib/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA2FD,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAIzE;AAID,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AA6BD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,OAAO,CAA2B;gBAE9B,OAAO,GAAE,wBAA6B;IAQlD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnC;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;YAEa,UAAU;IAmDlB,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD5C;;;OAGG;YACW,cAAc;IAkBtB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BlC,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACvC,OAAO,CAAC,CAAC,CAAC;IAiCP,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,IAAI,OAAO,IAAI,GAAG,CAEjB;CACF"}