untiktok-api 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+import type { BrowserContext, Page } from "playwright";
+export interface ProxySettings {
+    server: string;
+    bypass?: string;
+    username?: string;
+    password?: string;
+}
+export interface TikTokPlaywrightSession {
+    context: BrowserContext;
+    page: Page;
+    proxy?: ProxySettings | string | null;
+    params?: Record<string, string> | null;
+    headers?: Record<string, string> | null;
+    msToken?: string | null;
+    baseUrl: string;
+    isValid: boolean;
+}
+export interface CreateSessionsOptions {
+    numSessions?: number;
+    headless?: boolean;
+    msTokens?: string[] | null;
+    /** @deprecated Use proxyProvider instead */
+    proxies?: (ProxySettings | string)[] | null;
+    sleepAfter?: number;
+    startingUrl?: string;
+    contextOptions?: Record<string, unknown>;
+    overrideBrowserArgs?: string[] | null;
+    cookies?: Record<string, string>[] | null;
+    suppressResourceLoadTypes?: string[] | null;
+    browser?: "chromium" | "firefox" | "webkit";
+    executablePath?: string | null;
+    pageFactory?: ((context: BrowserContext) => Promise<Page>) | null;
+    browserContextFactory?: ((playwright: unknown) => Promise<BrowserContext>) | null;
+    timeout?: number;
+    enableSessionRecovery?: boolean;
+    allowPartialSessions?: boolean;
+    minSessions?: number | null;
+}
+export type TikTokResponse = Record<string, unknown>;
+export interface ResourceStats {
+    totalSessions: number;
+    validSessions: number;
+    invalidSessions: number;
+    hasBrowser: boolean;
+    hasPlaywright: boolean;
+    cleanupCalled: boolean;
+    autoCleanupEnabled: boolean;
+    recoveryEnabled: boolean;
+}
+export interface HealthCheckResult extends ResourceStats {
+    sessionDetails: Array<{
+        index: number;
+        valid: boolean;
+        markedValid: boolean;
+    }>;
+    healthySessions: number;
+    warning?: string;
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// types.ts
+// Shared TypeScript interfaces and types
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "untiktok-api",
+  "version": "1.0.0",
+  "description": "Unofficial TikTok API wrapper in TypeScript (ported from Python)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "ts-node src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "tiktok",
+    "api",
+    "scraper",
+    "typescript",
+    "playwright"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.17.0",
+    "https-proxy-agent": "^9.1.0",
+    "playwright": "^1.44.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.9.3",
+    "eslint": "^10.5.0",
+    "rimraf": "^6.1.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.61.0"
+  }
+}