@traceryn/tiktok-sdk 1.0.0

package/lib/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,oHAC4F,CAAC;AAEpH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;CAyBV,CAAC;AAEX,eAAO,MAAM,WAAW,gqBAOd,CAAC;AAEX,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAC7C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,qBAAqB,QAAS,CAAC"}

package/lib/utils/constants.js

@@ -0,0 +1,48 @@
+export const DESKTOP_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36';
+export const HEADERS = {
+    desktop: {
+        'User-Agent': DESKTOP_UA,
+        Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Sec-Ch-Ua': '"Chromium";v="135", "Not)A;Brand";v="99"',
+        'Sec-Ch-Ua-Mobile': '?0',
+        'Sec-Ch-Ua-Platform': '"Windows"',
+        'Sec-Fetch-Site': 'none',
+        'Sec-Fetch-Mode': 'navigate',
+        'Sec-Fetch-Dest': 'document',
+    },
+    api: {
+        'User-Agent': DESKTOP_UA,
+        Accept: 'application/json, text/plain, */*',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Sec-Ch-Ua': '"Chromium";v="135", "Not)A;Brand";v="99"',
+        'Sec-Ch-Ua-Mobile': '?0',
+        'Sec-Ch-Ua-Platform': '"Windows"',
+        'Sec-Fetch-Site': 'same-origin',
+        'Sec-Fetch-Mode': 'cors',
+        'Sec-Fetch-Dest': 'empty',
+    },
+};
+export const UA_ROTATION = [
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:136.0) Gecko/20100101 Firefox/136.0',
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3 Safari/605.1.15',
+    'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36',
+];
+export const TIKTOK_DOMAINS = {
+    www: 'https://www.tiktok.com',
+    api: 'https://www.tiktok.com/api',
+};
+export const DEFAULT_RATE_LIMIT = 5;
+export const DEFAULT_MAX_RETRIES = 3;
+export const DEFAULT_CACHE_TTL = 60_000;
+export const DEFAULT_CONCURRENCY = 3;
+export const DEFAULT_TIMEOUT = 30_000;
+export const PROXY_HEALTH_INTERVAL = 120_000;
+export const CIRCUIT_BREAKER_THRESHOLD = 5;
+export const CIRCUIT_BREAKER_RESET = 30_000;
+//# sourceMappingURL=constants.js.map

package/lib/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GACrB,iHAAiH,CAAC;AAEpH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE;QACP,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,iEAAiE;QACzE,iBAAiB,EAAE,gBAAgB;QACnC,iBAAiB,EAAE,mBAAmB;QACtC,WAAW,EAAE,0CAA0C;QACvD,kBAAkB,EAAE,IAAI;QACxB,oBAAoB,EAAE,WAAW;QACjC,gBAAgB,EAAE,MAAM;QACxB,gBAAgB,EAAE,UAAU;QAC5B,gBAAgB,EAAE,UAAU;KAC7B;IACD,GAAG,EAAE;QACH,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,mCAAmC;QAC3C,iBAAiB,EAAE,gBAAgB;QACnC,iBAAiB,EAAE,mBAAmB;QACtC,WAAW,EAAE,0CAA0C;QACvD,kBAAkB,EAAE,IAAI;QACxB,oBAAoB,EAAE,WAAW;QACjC,gBAAgB,EAAE,aAAa;QAC/B,gBAAgB,EAAE,MAAM;QACxB,gBAAgB,EAAE,OAAO;KAC1B;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iHAAiH;IACjH,iHAAiH;IACjH,uHAAuH;IACvH,kFAAkF;IAClF,uHAAuH;IACvH,uGAAuG;CAC/F,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,4BAA4B;CACzB,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC"}

package/lib/utils/errors.d.ts

@@ -0,0 +1,31 @@
+export declare class TikTokError extends Error {
+    constructor(message: string);
+}
+export declare class TikTokParseError extends TikTokError {
+    strategiesAttempted: number;
+    constructor(message?: string, strategiesAttempted?: number);
+}
+export declare class TikTokFetchError extends TikTokError {
+    statusCode?: number;
+    proxy?: string;
+    constructor(message: string, statusCode?: number, proxy?: string);
+}
+export declare class TikTokRateLimitError extends TikTokError {
+    retryAfter: number;
+    constructor(retryAfter?: number);
+}
+export declare class TikTokProxyError extends TikTokError {
+    proxy?: string;
+    constructor(message: string, proxy?: string);
+}
+export declare class TikTokCircuitOpenError extends TikTokError {
+    retryAfter: number;
+    constructor(retryAfter: number);
+}
+export declare class TikTokCacheError extends TikTokError {
+    constructor(message: string);
+}
+export declare class TikTokWafError extends TikTokFetchError {
+    constructor(message?: string, proxy?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,WAAW;IACxC,mBAAmB,EAAE,MAAM,CAAC;gBAEvB,OAAO,SAAqC,EAAE,mBAAmB,SAAI;CAKlF;AAED,qBAAa,gBAAiB,SAAQ,WAAW;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAMjE;AAED,qBAAa,oBAAqB,SAAQ,WAAW;IAC5C,UAAU,EAAE,MAAM,CAAC;gBAEd,UAAU,SAAO;CAK9B;AAED,qBAAa,gBAAiB,SAAQ,WAAW;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAK5C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;IAC9C,UAAU,EAAE,MAAM,CAAC;gBAEd,UAAU,EAAE,MAAM;CAK/B;AAED,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,gBAAgB;gBACtC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAQ7C"}

package/lib/utils/errors.js

@@ -0,0 +1,63 @@
+export class TikTokError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TikTokError';
+    }
+}
+export class TikTokParseError extends TikTokError {
+    strategiesAttempted;
+    constructor(message = 'Failed to parse TikTok page data', strategiesAttempted = 0) {
+        super(message);
+        this.name = 'TikTokParseError';
+        this.strategiesAttempted = strategiesAttempted;
+    }
+}
+export class TikTokFetchError extends TikTokError {
+    statusCode;
+    proxy;
+    constructor(message, statusCode, proxy) {
+        super(message);
+        this.name = 'TikTokFetchError';
+        this.statusCode = statusCode;
+        this.proxy = proxy;
+    }
+}
+export class TikTokRateLimitError extends TikTokError {
+    retryAfter;
+    constructor(retryAfter = 5000) {
+        super(`Rate limited. Retry after ${retryAfter}ms`);
+        this.name = 'TikTokRateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+export class TikTokProxyError extends TikTokError {
+    proxy;
+    constructor(message, proxy) {
+        super(message);
+        this.name = 'TikTokProxyError';
+        this.proxy = proxy;
+    }
+}
+export class TikTokCircuitOpenError extends TikTokError {
+    retryAfter;
+    constructor(retryAfter) {
+        super(`Circuit breaker open. Retry after ${retryAfter}ms`);
+        this.name = 'TikTokCircuitOpenError';
+        this.retryAfter = retryAfter;
+    }
+}
+export class TikTokCacheError extends TikTokError {
+    constructor(message) {
+        super(message);
+        this.name = 'TikTokCacheError';
+    }
+}
+export class TikTokWafError extends TikTokFetchError {
+    constructor(message, proxy) {
+        const msg = message ?? ('TikTok is blocking the request (WAF). ' +
+            'Try using a PlaywrightSession — npm install playwright');
+        super(msg, 200, proxy);
+        this.name = 'TikTokWafError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACxC,mBAAmB,CAAS;IAEnC,YAAY,OAAO,GAAG,kCAAkC,EAAE,mBAAmB,GAAG,CAAC;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACxC,UAAU,CAAU;IACpB,KAAK,CAAU;IAEtB,YAAY,OAAe,EAAE,UAAmB,EAAE,KAAc;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAC5C,UAAU,CAAS;IAE1B,YAAY,UAAU,GAAG,IAAI;QAC3B,KAAK,CAAC,6BAA6B,UAAU,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACxC,KAAK,CAAU;IAEtB,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IAC9C,UAAU,CAAS;IAE1B,YAAY,UAAkB;QAC5B,KAAK,CAAC,qCAAqC,UAAU,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAClD,YAAY,OAAgB,EAAE,KAAc;QAC1C,MAAM,GAAG,GAAG,OAAO,IAAI,CACrB,wCAAwC;YACxC,wDAAwD,CACzD,CAAC;QACF,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/lib/utils/helpers.d.ts

@@ -0,0 +1,9 @@
+export declare function pad2(n: number): string;
+export declare function formatDuration(seconds: number): string;
+export declare function formatISODate(epoch: number): string;
+export declare function formatUploadDate(epoch: number): string;
+export declare function parseCookieString(cookies: Record<string, string>): string;
+export declare function parseUsername(urlOrName: string): string;
+export declare function randomUserAgent(): string;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIzE;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/lib/utils/helpers.js

@@ -0,0 +1,41 @@
+import { UA_ROTATION } from './constants.js';
+export function pad2(n) {
+    return n.toString().padStart(2, '0');
+}
+export function formatDuration(seconds) {
+    if (seconds <= 0)
+        return '0:00';
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = seconds % 60;
+    if (h > 0)
+        return `${h}:${pad2(m)}:${pad2(s)}`;
+    return `${m}:${pad2(s)}`;
+}
+export function formatISODate(epoch) {
+    if (!epoch)
+        return '';
+    return new Date(epoch * 1000).toISOString();
+}
+export function formatUploadDate(epoch) {
+    if (!epoch)
+        return '';
+    const d = new Date(epoch * 1000);
+    return `${d.getUTCFullYear()}${pad2(d.getUTCMonth() + 1)}${pad2(d.getUTCDate())}`;
+}
+export function parseCookieString(cookies) {
+    return Object.entries(cookies)
+        .map(([k, v]) => `${k}=${v}`)
+        .join('; ');
+}
+export function parseUsername(urlOrName) {
+    const m = urlOrName.match(/@([\w.-]+)/);
+    return m?.[1] ?? urlOrName.replace('@', '');
+}
+export function randomUserAgent() {
+    return UA_ROTATION[Math.floor(Math.random() * UA_ROTATION.length)];
+}
+export function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=helpers.js.map

package/lib/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}