@cesteral/tiktok-mcp 1.0.0

package/dist/mcp-server/transports/streamable-http-transport.d.ts

@@ -0,0 +1,59 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "tiktok-bearer" | "jwt" | "none";
+    tiktokApiBaseUrl: string;
+    tiktokApiVersion: string;
+    tiktokRateLimitPerMinute: number;
+    tiktokReportPollIntervalMs: number;
+    tiktokReportMaxPollAttempts: number;
+    tiktokVideoUploadPollIntervalMs: number;
+    tiktokVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    tiktokAccessToken?: string | undefined;
+    tiktokAdvertiserId?: string | undefined;
+    tiktokAppId?: string | undefined;
+    tiktokAppSecret?: string | undefined;
+    tiktokRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "tiktok-bearer" | "jwt" | "none";
+    tiktokApiBaseUrl: string;
+    tiktokApiVersion: string;
+    tiktokRateLimitPerMinute: number;
+    tiktokReportPollIntervalMs: number;
+    tiktokReportMaxPollAttempts: number;
+    tiktokVideoUploadPollIntervalMs: number;
+    tiktokVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    tiktokAccessToken?: string | undefined;
+    tiktokAdvertiserId?: string | undefined;
+    tiktokAppId?: string | undefined;
+    tiktokAppSecret?: string | undefined;
+    tiktokRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/mcp-server/transports/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA2JnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.js

@@ -0,0 +1,107 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { TikTokBearerAuthStrategy } from "../../auth/tiktok-auth-strategy.js";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: config.mcpAuthMode === "tiktok-bearer"
+            ? new TikTokBearerAuthStrategy(config.tiktokApiBaseUrl, logger, config.tiktokApiVersion)
+            : createAuthStrategy(config.mcpAuthMode, {
+                jwtSecret: config.mcpAuthSecretKey,
+                logger,
+            }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "X-TikTok-Advertiser-Id",
+            "X-TikTok-App-Id",
+            "X-TikTok-App-Secret",
+            "X-TikTok-Refresh-Token",
+        ],
+        authErrorHint: config.mcpAuthMode === "tiktok-bearer"
+            ? "Provide a TikTok access token via Authorization: Bearer <token> header and advertiser ID via X-TikTok-Advertiser-Id header."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.platformAuthAdapter;
+            if (adapter) {
+                const cfg = appConfig;
+                const services = createSessionServices(adapter, {
+                    baseUrl: cfg.tiktokApiBaseUrl,
+                    reportPollIntervalMs: cfg.tiktokReportPollIntervalMs,
+                    reportMaxPollAttempts: cfg.tiktokReportMaxPollAttempts,
+                    apiVersion: cfg.tiktokApiVersion,
+                }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
+                const cfg = appConfig;
+                const tiktokAdvertiserId = cfg.tiktokAdvertiserId;
+                if (cfg.tiktokAppId &&
+                    cfg.tiktokAppSecret &&
+                    cfg.tiktokRefreshToken &&
+                    tiktokAdvertiserId) {
+                    const { TikTokRefreshTokenAdapter } = await import("../../auth/tiktok-auth-adapter.js");
+                    const envAdapter = new TikTokRefreshTokenAdapter({
+                        appId: cfg.tiktokAppId,
+                        appSecret: cfg.tiktokAppSecret,
+                        refreshToken: cfg.tiktokRefreshToken,
+                    }, tiktokAdvertiserId, cfg.tiktokApiBaseUrl, cfg.tiktokApiVersion);
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfg.tiktokApiBaseUrl,
+                        reportPollIntervalMs: cfg.tiktokReportPollIntervalMs,
+                        reportMaxPollAttempts: cfg.tiktokReportMaxPollAttempts,
+                        apiVersion: cfg.tiktokApiVersion,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                const tiktokToken = cfg.tiktokAccessToken;
+                if (tiktokToken && tiktokAdvertiserId) {
+                    const { TikTokAccessTokenAdapter } = await import("../../auth/tiktok-auth-adapter.js");
+                    const envAdapter = new TikTokAccessTokenAdapter(tiktokToken, tiktokAdvertiserId, cfg.tiktokApiBaseUrl, cfg.tiktokApiVersion);
+                    await envAdapter.validate();
+                    const cfgFallback = appConfig;
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfgFallback.tiktokApiBaseUrl,
+                        reportPollIntervalMs: cfgFallback.tiktokReportPollIntervalMs,
+                        reportMaxPollAttempts: cfgFallback.tiktokReportMaxPollAttempts,
+                        apiVersion: cfgFallback.tiktokApiVersion,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (appConfig.mcpAuthMode !== "none") {
+                    return {
+                        services: null,
+                        error: {
+                            message: "TikTok access token and advertiser ID required. Set TIKTOK_ACCESS_TOKEN and TIKTOK_ADVERTISER_ID env vars, or use MCP_AUTH_MODE=tiktok-bearer.",
+                            status: 400,
+                        },
+                    };
+                }
+                return { services: null };
+            }
+            return {
+                services: null,
+                error: {
+                    message: "TikTok API credentials required for this server.",
+                    status: 400,
+                },
+            };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("tiktok-mcp"),
+    };
+}
+export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
+//# sourceMappingURL=streamable-http-transport.js.map

package/dist/mcp-server/transports/streamable-http-transport.js.map

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

package/dist/services/session-services.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from "pino";
+import type { TikTokAuthAdapter } from "../auth/tiktok-auth-adapter.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { ReportCsvStore, SessionServiceStore } from "@cesteral/shared";
+export { SessionServiceStore } from "@cesteral/shared";
+import { TikTokService } from "./tiktok/tiktok-service.js";
+import { TikTokReportingService } from "./tiktok/tiktok-reporting-service.js";
+export interface SessionServices {
+    tiktokService: TikTokService;
+    tiktokReportingService: TikTokReportingService;
+}
+export interface TikTokSessionConfig {
+    baseUrl: string;
+    reportPollIntervalMs: number;
+    reportMaxPollAttempts: number;
+    apiVersion: string;
+}
+export declare function createSessionServices(authAdapter: TikTokAuthAdapter, config: TikTokSessionConfig, logger: Logger, rateLimiter: RateLimiter): SessionServices;
+export declare const sessionServiceStore: SessionServiceStore<SessionServices>;
+export declare const reportCsvStore: ReportCsvStore;
+//# sourceMappingURL=session-services.d.ts.map

package/dist/services/session-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-services.d.ts","sourceRoot":"","sources":["../../src/services/session-services.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAEL,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAG9E,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,eAAe,CAyBjB;AAED,eAAO,MAAM,mBAAmB,sCAA6C,CAAC;AAO9E,eAAO,MAAM,cAAc,gBAIzB,CAAC"}

package/dist/services/session-services.js

@@ -0,0 +1,25 @@
+import { deleteSpilledObjectsForSession, ReportCsvStore, SessionServiceStore, } from "@cesteral/shared";
+export { SessionServiceStore } from "@cesteral/shared";
+import { TikTokHttpClient } from "./tiktok/tiktok-http-client.js";
+import { TikTokService } from "./tiktok/tiktok-service.js";
+import { TikTokReportingService } from "./tiktok/tiktok-reporting-service.js";
+import { setApiVersion } from "../mcp-server/tools/utils/entity-mapping.js";
+export function createSessionServices(authAdapter, config, logger, rateLimiter) {
+    setApiVersion(config.apiVersion);
+    const httpClient = new TikTokHttpClient(authAdapter, authAdapter.advertiserId, config.baseUrl, logger, config.apiVersion);
+    const tiktokService = new TikTokService(rateLimiter, httpClient, logger, config.apiVersion);
+    const tiktokReportingService = new TikTokReportingService(rateLimiter, httpClient, logger, config.reportPollIntervalMs, config.reportMaxPollAttempts, config.apiVersion);
+    return {
+        tiktokService,
+        tiktokReportingService,
+    };
+}
+export const sessionServiceStore = new SessionServiceStore();
+export const reportCsvStore = new ReportCsvStore({
+    mirror: { bucketResolver: () => process.env.REPORT_SPILL_BUCKET },
+});
+sessionServiceStore.onDelete((sessionId) => {
+    void deleteSpilledObjectsForSession("tiktok", sessionId);
+    reportCsvStore.clearForSession(sessionId);
+});
+//# sourceMappingURL=session-services.js.map

package/dist/services/session-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-services.js","sourceRoot":"","sources":["../../src/services/session-services.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,8BAA8B,EAC9B,cAAc,EACd,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAc5E,MAAM,UAAU,qBAAqB,CACnC,WAA8B,EAC9B,MAA2B,EAC3B,MAAc,EACd,WAAwB;IAGxB,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEjC,MAAM,UAAU,GAAG,IAAI,gBAAgB,CACrC,WAAW,EACX,WAAW,CAAC,YAAY,EACxB,MAAM,CAAC,OAAO,EACd,MAAM,EACN,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5F,MAAM,sBAAsB,GAAG,IAAI,sBAAsB,CACvD,WAAW,EACX,UAAU,EACV,MAAM,EACN,MAAM,CAAC,oBAAoB,EAC3B,MAAM,CAAC,qBAAqB,EAC5B,MAAM,CAAC,UAAU,CAClB,CAAC;IAEF,OAAO;QACL,aAAa;QACb,sBAAsB;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAmB,CAAC;AAO9E,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC;IAG/C,MAAM,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE;CAClE,CAAC,CAAC;AAIH,mBAAmB,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,EAAE;IACzC,KAAK,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC"}

package/dist/services/tiktok/tiktok-http-client.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from "pino";
+import type { TikTokAuthAdapter } from "../../auth/tiktok-auth-adapter.js";
+import type { RequestContext } from "@cesteral/shared";
+export declare class TikTokHttpClient {
+    private readonly authAdapter;
+    private readonly advertiserId;
+    private readonly baseUrl;
+    private readonly logger;
+    private readonly apiVersion;
+    constructor(authAdapter: TikTokAuthAdapter, advertiserId: string, baseUrl: string, logger: Logger, apiVersion?: string);
+    versionedPath(suffix: string): string;
+    get(path: string, params?: Record<string, string>, context?: RequestContext): Promise<unknown>;
+    post(path: string, data?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    delete(path: string, data?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    postMultipart(path: string, fields: Record<string, string>, fileField: string, fileBuffer: Buffer, filename: string, fileContentType: string, context?: RequestContext): Promise<unknown>;
+    private buildUrl;
+    private executeRequest;
+}
+//# sourceMappingURL=tiktok-http-client.d.ts.map

package/dist/services/tiktok/tiktok-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/tiktok/tiktok-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAG3E,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AA2GpE,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,WAAW,EAAE,iBAAiB,EAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAe;IAO9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ/B,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAYb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAoBb,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAqBb,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAoCnB,OAAO,CAAC,QAAQ;YAYF,cAAc;CAgC7B"}

package/dist/services/tiktok/tiktok-http-client.js

@@ -0,0 +1,184 @@
+import { McpError, JsonRpcErrorCode, mapHttpStatusToJsonRpc } from "@cesteral/shared";
+import { fetchWithTimeout, buildMultipartFormData, executeWithRetry } from "@cesteral/shared";
+import { withTikTokApiSpan } from "../../utils/platform.js";
+const TIKTOK_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 2_000,
+    maxBackoffMs: 30_000,
+    timeoutMs: 30_000,
+    platformName: "TikTok",
+    tokenExpiryHint: "TikTok token expired. Regenerate in TikTok Business Center.",
+};
+const AUTH_ERROR_CODES = new Set([40001, 40002, 40013]);
+const RATE_LIMIT_CODES = new Set([40100, 40101]);
+function mapTikTokErrorToJsonRpc(tiktokCode, httpStatus) {
+    if (AUTH_ERROR_CODES.has(tiktokCode)) {
+        return JsonRpcErrorCode.Unauthorized;
+    }
+    if (RATE_LIMIT_CODES.has(tiktokCode)) {
+        return JsonRpcErrorCode.RateLimited;
+    }
+    if (tiktokCode >= 50000) {
+        return JsonRpcErrorCode.ServiceUnavailable;
+    }
+    return mapHttpStatusToJsonRpc(httpStatus);
+}
+function buildTikTokEnvelopeNextAction(tiktokCode, message) {
+    if (AUTH_ERROR_CODES.has(tiktokCode)) {
+        return "Renew the TikTok access token. Regenerate it in TikTok Business Center and update TIKTOK_ACCESS_TOKEN.";
+    }
+    if (RATE_LIMIT_CODES.has(tiktokCode)) {
+        return "Back off and retry with exponential delay. TikTok rate limits are per-app and per-advertiser; reduce concurrent requests.";
+    }
+    if (tiktokCode === 40105 || /advertiser/i.test(message)) {
+        return "Verify the advertiser_id with tiktok_list_advertisers; the authenticated user may not have access to this advertiser.";
+    }
+    if (tiktokCode === 40002 || /permission/i.test(message)) {
+        return "Verify the token has Ads Management scopes and the user has manager-level access in TikTok Business Center.";
+    }
+    return undefined;
+}
+function buildTikTokHttpNextAction(status, _errorBody, defaultHint) {
+    if (status === 401) {
+        return "Renew the TikTok access token. Regenerate it in TikTok Business Center and update TIKTOK_ACCESS_TOKEN.";
+    }
+    if (status === 403) {
+        return "Verify the user has Ads Management permission for this advertiser in TikTok Business Center.";
+    }
+    if (status === 404) {
+        return "Verify entity IDs with tiktok_list_entities; check the advertiser_id with tiktok_list_advertisers.";
+    }
+    return defaultHint;
+}
+function validateTikTokEnvelope(body) {
+    const json = body;
+    if (json.code === 0) {
+        return json.data;
+    }
+    const jsonRpcCode = mapTikTokErrorToJsonRpc(json.code, 200);
+    const retryable = RATE_LIMIT_CODES.has(json.code);
+    const nextAction = buildTikTokEnvelopeNextAction(json.code, json.message ?? "");
+    throw new McpError(jsonRpcCode, json.message || `TikTok API error: code=${json.code}`, {
+        tiktokCode: json.code,
+        tiktokRequestId: json.request_id,
+        retryable,
+        ...(nextAction ? { nextAction } : {}),
+    });
+}
+export class TikTokHttpClient {
+    authAdapter;
+    advertiserId;
+    baseUrl;
+    logger;
+    apiVersion;
+    constructor(authAdapter, advertiserId, baseUrl, logger, apiVersion = "v1.3") {
+        this.authAdapter = authAdapter;
+        this.advertiserId = advertiserId;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+        this.apiVersion = apiVersion;
+    }
+    versionedPath(suffix) {
+        return `/open_api/${this.apiVersion}/${suffix}`;
+    }
+    async get(path, params, context) {
+        const url = this.buildUrl(path, {
+            advertiser_id: this.advertiserId,
+            ...params,
+        });
+        return this.executeRequest(url, context, { method: "GET" });
+    }
+    async post(path, data, context) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify({
+            advertiser_id: this.advertiserId,
+            ...data,
+        });
+        return this.executeRequest(url, context, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body,
+        });
+    }
+    async delete(path, data, context) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify({
+            advertiser_id: this.advertiserId,
+            ...data,
+        });
+        return this.executeRequest(url, context, {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body,
+        });
+    }
+    async postMultipart(path, fields, fileField, fileBuffer, filename, fileContentType, context) {
+        const url = this.buildUrl(path);
+        return withTikTokApiSpan("api.multipart.POST", path, async (span) => {
+            span.setAttribute("http.request.method", "POST");
+            span.setAttribute("http.url", url);
+            const allFields = { advertiser_id: this.advertiserId, ...fields };
+            const { body, contentType } = buildMultipartFormData(allFields, fileField, fileBuffer, filename, fileContentType);
+            const result = await executeWithRetry(TIKTOK_RETRY_CONFIG, {
+                url,
+                fetchOptions: { method: "POST", body },
+                context,
+                logger: this.logger,
+                fetchFn: fetchWithTimeout,
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    return {
+                        Authorization: `Bearer ${accessToken}`,
+                        "Content-Type": contentType,
+                    };
+                },
+                validateResponseBody: validateTikTokEnvelope,
+                buildNextAction: buildTikTokHttpNextAction,
+            });
+            span.setAttribute("http.response.status_code", 200);
+            return result;
+        });
+    }
+    buildUrl(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        return url.toString();
+    }
+    async executeRequest(url, context, options) {
+        const method = options?.method || "GET";
+        return withTikTokApiSpan(`api.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(TIKTOK_RETRY_CONFIG, {
+                url,
+                fetchOptions: options,
+                context,
+                logger: this.logger,
+                fetchFn: fetchWithTimeout,
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    const headers = {
+                        Authorization: `Bearer ${accessToken}`,
+                    };
+                    if (options?.body) {
+                        headers["Content-Type"] = "application/json";
+                    }
+                    return headers;
+                },
+                validateResponseBody: validateTikTokEnvelope,
+                buildNextAction: buildTikTokHttpNextAction,
+            });
+        });
+    }
+}
+//# sourceMappingURL=tiktok-http-client.js.map

package/dist/services/tiktok/tiktok-http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok-http-client.js","sourceRoot":"","sources":["../../../src/services/tiktok/tiktok-http-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,mBAAmB,GAAgB;IACvC,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,MAAM;IACpB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,6DAA6D;CAC/E,CAAC;AAWF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAGxD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEjD,SAAS,uBAAuB,CAAC,UAAkB,EAAE,UAAkB;IACrE,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,YAAY,CAAC;IACvC,CAAC;IACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,kBAAkB,CAAC;IAC7C,CAAC;IACD,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,6BAA6B,CAAC,UAAkB,EAAE,OAAe;IACxE,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,wGAAwG,CAAC;IAClH,CAAC;IACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,2HAA2H,CAAC;IACrI,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,uHAAuH,CAAC;IACjI,CAAC;IACD,IAAI,UAAU,KAAK,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,6GAA6G,CAAC;IACvH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAc,EACd,UAAkB,EAClB,WAA+B;IAE/B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,wGAAwG,CAAC;IAClH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,8FAA8F,CAAC;IACxG,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,oGAAoG,CAAC;IAC9G,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAOD,SAAS,sBAAsB,CAAC,IAAa;IAC3C,MAAM,IAAI,GAAG,IAAyB,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAEhF,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,IAAI,0BAA0B,IAAI,CAAC,IAAI,EAAE,EAAE;QACrF,UAAU,EAAE,IAAI,CAAC,IAAI;QACrB,eAAe,EAAE,IAAI,CAAC,UAAU;QAChC,SAAS;QACT,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAcD,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IACA;IACA;IALnB,YACmB,WAA8B,EAC9B,YAAoB,EACpB,OAAe,EACf,MAAc,EACd,aAAqB,MAAM;QAJ3B,gBAAW,GAAX,WAAW,CAAmB;QAC9B,iBAAY,GAAZ,YAAY,CAAQ;QACpB,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAiB;IAC3C,CAAC;IAMJ,aAAa,CAAC,MAAc;QAC1B,OAAO,aAAa,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC;IAClD,CAAC;IAMD,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,MAA+B,EAC/B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC9B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,GAAG,MAAM;SACV,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAMD,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,IAA8B,EAC9B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,IAA8B,EAC9B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;YACvC,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAOD,KAAK,CAAC,aAAa,CACjB,IAAY,EACZ,MAA8B,EAC9B,SAAiB,EACjB,UAAkB,EAClB,QAAgB,EAChB,eAAuB,EACvB,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEhC,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClE,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC;YAClE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAClD,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,mBAAmB,EAAE;gBACzD,GAAG;gBACH,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;gBACtC,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,gBAAgB;gBACzB,UAAU,EAAE,KAAK,IAAI,EAAE;oBACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;oBAC5D,OAAO;wBACL,aAAa,EAAE,UAAU,WAAW,EAAE;wBACtC,cAAc,EAAE,WAAW;qBAC5B,CAAC;gBACJ,CAAC;gBACD,oBAAoB,EAAE,sBAAsB;gBAC5C,eAAe,EAAE,yBAAyB;aAC3C,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,MAA+B;QAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,GAAW,EACX,OAAwB,EACxB,OAAqB;QAErB,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;QAExC,OAAO,iBAAiB,CAAC,OAAO,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC5D,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACnC,OAAO,gBAAgB,CAAC,mBAAmB,EAAE;gBAC3C,GAAG;gBACH,YAAY,EAAE,OAAO;gBACrB,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,gBAAgB;gBACzB,UAAU,EAAE,KAAK,IAAI,EAAE;oBACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;oBAC5D,MAAM,OAAO,GAA2B;wBACtC,aAAa,EAAE,UAAU,WAAW,EAAE;qBACvC,CAAC;oBAEF,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;wBAClB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;oBAC/C,CAAC;oBACD,OAAO,OAAO,CAAC;gBACjB,CAAC;gBACD,oBAAoB,EAAE,sBAAsB;gBAC5C,eAAe,EAAE,yBAAyB;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/services/tiktok/tiktok-reporting-service.d.ts

@@ -0,0 +1,62 @@
+import type { TikTokHttpClient } from "./tiktok-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import type { RequestContext } from "@cesteral/shared";
+import type { Logger } from "pino";
+export type ReportTaskStatus = "PENDING" | "RUNNING" | "DONE" | "FAILED";
+interface ReportTaskCheckData {
+    status: ReportTaskStatus;
+    download_url?: string;
+    task_id: string;
+}
+export interface TikTokReportConfig {
+    report_type?: "BASIC" | "AUDIENCE" | "PLAYABLE_MATERIAL";
+    dimensions: string[];
+    metrics: string[];
+    start_date: string;
+    end_date: string;
+    page?: number;
+    page_size?: number;
+    filtering?: Record<string, unknown>[];
+    order_field?: string;
+    order_type?: "ASC" | "DESC";
+}
+export declare class TikTokReportingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    private readonly apiVersion;
+    constructor(rateLimiter: RateLimiter, httpClient: TikTokHttpClient, logger: Logger, pollIntervalMs?: number, maxPollAttempts?: number, apiVersion?: string);
+    submitReport(reportConfig: TikTokReportConfig, context?: RequestContext): Promise<{
+        task_id: string;
+    }>;
+    pollReport(taskId: string, context?: RequestContext): Promise<ReportTaskCheckData>;
+    checkReportStatus(taskId: string, context?: RequestContext): Promise<{
+        taskId: string;
+        status: ReportTaskStatus;
+        downloadUrl?: string;
+    }>;
+    downloadReport(downloadUrl: string, maxRows?: number, context?: RequestContext, options?: {
+        includeRawCsv?: boolean;
+    }): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        rawCsv?: string;
+    }>;
+    getReport(reportConfig: TikTokReportConfig, maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+    getReportBreakdowns(reportConfig: TikTokReportConfig, breakdowns: string[], maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=tiktok-reporting-service.d.ts.map

package/dist/services/tiktok/tiktok-reporting-service.d.ts.map

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