@adport/provider-tiktok 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Yannick Westermann
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { AdProvider, ProviderCapabilities, StandardActions, Account, NormalizedQuery, Report, WriteOperation, WriteGuard, WritePreview, WriteResult, AnyToolDefinition, CredentialStore, ProviderModule } from '@adport/core';
+
+interface TikTokCredentials {
+    /** Long-term access token (does not expire; revoked by the advertiser). */
+    accessToken: string;
+    appId?: string;
+    secret?: string;
+    /** Use the sandbox environment (sandbox-ads.tiktok.com). */
+    sandbox?: boolean;
+}
+declare const TIKTOK_API_VERSION = "v1.3";
+/**
+ * TikTok Business API client. Peculiarities handled here:
+ * - every endpoint needs a TRAILING SLASH (404 otherwise)
+ * - business errors arrive as HTTP 200 with a non-zero envelope `code`
+ * - array query params are JSON-encoded strings
+ */
+declare class TikTokClient {
+    private readonly credentials;
+    private readonly fetchImpl;
+    readonly baseUrl: string;
+    constructor(credentials: TikTokCredentials, fetchImpl?: typeof fetch);
+    get<T>(path: string, params?: Record<string, string | number | unknown[] | object | undefined>): Promise<T>;
+    post<T>(path: string, body: Record<string, unknown>): Promise<T>;
+    private send;
+}
+
+/** TikTok budgets are floats in whole account-currency units. */
+declare const UNITS_TO_MICROS = 1000000;
+interface TikTokCampaign {
+    campaign_id: string;
+    campaign_name: string;
+    operation_status: 'ENABLE' | 'DISABLE';
+    secondary_status?: string;
+    budget: number;
+    budget_mode: string;
+    objective_type: string;
+}
+declare class TikTokAdsProvider implements AdProvider {
+    private readonly client;
+    private readonly app;
+    readonly id = "tiktok";
+    constructor(client: TikTokClient, app: {
+        appId: string;
+        secret: string;
+    });
+    capabilities(): ProviderCapabilities;
+    standardActions(): StandardActions;
+    listAccounts(): Promise<Account[]>;
+    report(query: NormalizedQuery): Promise<Report>;
+    private toReportRow;
+    rawReport(input: {
+        account_id: string;
+        data_level: string;
+        dimensions: string[];
+        metrics: string[];
+        start_date: string;
+        end_date: string;
+        page_size?: number;
+    }): Promise<Array<Record<string, unknown>>>;
+    listCampaigns(accountId: string, campaignIds?: string[]): Promise<TikTokCampaign[]>;
+    previewWrite(op: WriteOperation, guard: WriteGuard): Promise<WritePreview>;
+    applyWrite(op: WriteOperation, guard: WriteGuard): Promise<WriteResult>;
+    private plan;
+    private planCreateCampaign;
+    private planSetStatus;
+    private planSetBudget;
+    private appId;
+    private secret;
+}
+
+declare function tiktokTools(provider: TikTokAdsProvider): AnyToolDefinition[];
+
+declare function resolveTikTokCredentials(store: CredentialStore): Promise<(TikTokCredentials & {
+    appId: string;
+    secret: string;
+}) | undefined>;
+declare function createTikTokModule(store: CredentialStore): Promise<ProviderModule | undefined>;
+
+export { TIKTOK_API_VERSION, TikTokAdsProvider, TikTokClient, type TikTokCredentials, UNITS_TO_MICROS, createTikTokModule, resolveTikTokCredentials, tiktokTools };

package/dist/index.js

@@ -0,0 +1,464 @@
+// src/client.ts
+import { AdportError } from "@adport/core";
+var TIKTOK_API_VERSION = "v1.3";
+var PROD_BASE = "https://business-api.tiktok.com/open_api";
+var SANDBOX_BASE = "https://sandbox-ads.tiktok.com/open_api";
+var CODE_HINTS = {
+  40105: "The access token is invalid \u2014 re-run `adport connect tiktok`.",
+  40102: "The access token expired or was revoked \u2014 re-run `adport connect tiktok`.",
+  40100: "Rate limited (app level) \u2014 back off and retry.",
+  40133: "Rate limited (advertiser level) \u2014 back off and retry."
+};
+var TikTokClient = class {
+  constructor(credentials, fetchImpl = fetch) {
+    this.credentials = credentials;
+    this.fetchImpl = fetchImpl;
+    this.baseUrl = `${credentials.sandbox ? SANDBOX_BASE : PROD_BASE}/${TIKTOK_API_VERSION}`;
+  }
+  credentials;
+  fetchImpl;
+  baseUrl;
+  async get(path, params = {}) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value === void 0) continue;
+      search.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
+    }
+    const query = search.size > 0 ? `?${search}` : "";
+    return this.send(`${path}${query}`, { method: "GET" });
+  }
+  async post(path, body) {
+    return this.send(path, { method: "POST", body: JSON.stringify(body) });
+  }
+  async send(pathWithQuery, init) {
+    const [path, query] = pathWithQuery.split("?");
+    const url = `${this.baseUrl}/${path.replace(/^\/|\/$/g, "")}/${query ? `?${query}` : ""}`;
+    const response = await this.fetchImpl(url, {
+      method: init.method,
+      headers: {
+        "Access-Token": this.credentials.accessToken,
+        ...init.body ? { "content-type": "application/json" } : {}
+      },
+      body: init.body
+    });
+    const raw = await response.text();
+    if (!response.ok) {
+      throw new AdportError("PROVIDER_ERROR", `TikTok API HTTP ${response.status} for ${path} (check method and trailing slash)`, raw);
+    }
+    const envelope = JSON.parse(raw);
+    if (envelope.code !== 0) {
+      const hint = CODE_HINTS[envelope.code];
+      throw new AdportError(
+        "PROVIDER_ERROR",
+        `TikTok API error ${envelope.code}: ${envelope.message}${hint ? `
+  ${hint}` : ""}` + (envelope.request_id ? ` [request_id: ${envelope.request_id}]` : ""),
+        envelope
+      );
+    }
+    return envelope.data ?? {};
+  }
+};
+
+// src/provider.ts
+import {
+  AdportError as AdportError2,
+  resolveDateRange
+} from "@adport/core";
+var UNITS_TO_MICROS = 1e6;
+var DATA_LEVEL = {
+  account: "AUCTION_ADVERTISER",
+  campaign: "AUCTION_CAMPAIGN",
+  ad_group: "AUCTION_ADGROUP",
+  ad: "AUCTION_AD"
+};
+var ID_DIMENSION = {
+  account: "advertiser_id",
+  campaign: "campaign_id",
+  ad_group: "adgroup_id",
+  ad: "ad_id"
+};
+var TikTokAdsProvider = class {
+  constructor(client, app) {
+    this.client = client;
+    this.app = app;
+  }
+  client;
+  app;
+  id = "tiktok";
+  capabilities() {
+    return { serverDryRun: false };
+  }
+  standardActions() {
+    return {
+      pauseCampaign: (accountId, campaignId) => ({
+        tool: "tiktok_set_campaign_status",
+        input: { account_id: accountId, campaign_ids: [campaignId], operation_status: "DISABLE" }
+      })
+    };
+  }
+  async listAccounts() {
+    const authorized = await this.client.get(
+      "oauth2/advertiser/get",
+      { app_id: this.appId(), secret: this.secret() }
+    );
+    const ids = (authorized.list ?? []).map((a) => a.advertiser_id);
+    if (ids.length === 0) return [];
+    const info = await this.client.get("advertiser/info", { advertiser_ids: ids.slice(0, 100), fields: ["name", "currency", "status", "timezone"] });
+    const byId = new Map((info.list ?? []).map((i) => [i.advertiser_id, i]));
+    return ids.map((id) => {
+      const details = byId.get(id);
+      return {
+        provider: this.id,
+        id,
+        name: details?.name ?? (authorized.list ?? []).find((a) => a.advertiser_id === id)?.advertiser_name ?? id,
+        currency: details?.currency,
+        status: details?.status?.replace("STATUS_", "")
+      };
+    });
+  }
+  async report(query) {
+    const range = resolveDateRange(query.dateRange);
+    const accountIds = query.accountIds ?? (await this.listAccounts()).map((a) => a.id);
+    const level = DATA_LEVEL[query.level];
+    const idDim = ID_DIMENSION[query.level];
+    const nameMetric = { campaign: "campaign_name", ad_group: "adgroup_name", ad: "ad_name" }[query.level];
+    const rows = [];
+    for (const accountId of accountIds) {
+      const data = await this.client.get("report/integrated/get", {
+        advertiser_id: accountId,
+        report_type: "BASIC",
+        data_level: level,
+        dimensions: [idDim],
+        metrics: [
+          ...nameMetric ? [nameMetric] : [],
+          "spend",
+          "impressions",
+          "clicks",
+          "conversion",
+          "complete_payment_roas",
+          "total_complete_payment_rate"
+        ],
+        start_date: range.start,
+        end_date: range.end,
+        page: 1,
+        page_size: Math.min(query.limit ?? 200, 1e3)
+      });
+      for (const row of data.list ?? []) {
+        rows.push(this.toReportRow(row, accountId, query, idDim, nameMetric));
+      }
+    }
+    return { rows };
+  }
+  toReportRow(row, accountId, query, idDim, nameMetric) {
+    const num = (key) => Number(row.metrics[key] ?? 0);
+    const spend = num("spend");
+    const impressions = num("impressions");
+    const clicks = num("clicks");
+    const conversions = num("conversion");
+    const conversionValue = num("total_complete_payment_rate");
+    const all = {
+      spend: round2(spend),
+      impressions,
+      clicks,
+      conversions,
+      conversion_value: round2(conversionValue),
+      ctr: impressions > 0 ? round2(clicks / impressions * 100) : 0,
+      cpc: clicks > 0 ? round2(spend / clicks) : 0,
+      cpm: impressions > 0 ? round2(spend / impressions * 1e3) : 0,
+      cpa: conversions > 0 ? round2(spend / conversions) : 0,
+      roas: spend > 0 ? round2(conversionValue / spend) : 0
+    };
+    const entityId = row.dimensions[idDim] ?? "";
+    return {
+      provider: this.id,
+      accountId,
+      entity: {
+        level: query.level,
+        id: entityId,
+        name: (nameMetric ? row.metrics[nameMetric] : void 0) ?? entityId
+      },
+      metrics: Object.fromEntries(query.metrics.map((m) => [m, all[m]]))
+    };
+  }
+  async rawReport(input) {
+    const data = await this.client.get("report/integrated/get", {
+      advertiser_id: input.account_id,
+      report_type: "BASIC",
+      data_level: input.data_level,
+      dimensions: input.dimensions,
+      metrics: input.metrics,
+      start_date: input.start_date,
+      end_date: input.end_date,
+      page: 1,
+      page_size: Math.min(input.page_size ?? 200, 1e3)
+    });
+    return data.list ?? [];
+  }
+  async listCampaigns(accountId, campaignIds) {
+    const data = await this.client.get("campaign/get", {
+      advertiser_id: accountId,
+      ...campaignIds ? { filtering: { campaign_ids: campaignIds } } : {},
+      page: 1,
+      page_size: campaignIds ? campaignIds.length : 100
+    });
+    return data.list ?? [];
+  }
+  async previewWrite(op, guard) {
+    const plan = await this.plan(op, guard);
+    return {
+      summary: plan.summary,
+      changes: plan.changes,
+      coercions: plan.coercions,
+      budgetDeltas: plan.budgetDeltas,
+      serverValidated: false
+    };
+  }
+  async applyWrite(op, guard) {
+    const plan = await this.plan(op, guard);
+    const resourceIds = await plan.execute();
+    return { applied: true, resourceIds };
+  }
+  async plan(op, guard) {
+    const payload = op.payload;
+    switch (op.tool) {
+      case "tiktok_create_campaign":
+        return this.planCreateCampaign(op.accountId, payload, guard);
+      case "tiktok_set_campaign_status":
+        return this.planSetStatus(op.accountId, payload);
+      case "tiktok_set_budget":
+        return this.planSetBudget(op.accountId, payload);
+      default:
+        throw new AdportError2("PROVIDER_ERROR", `tiktok: unsupported write tool ${op.tool}`);
+    }
+  }
+  async planCreateCampaign(accountId, payload, guard) {
+    const coercions = [];
+    let operationStatus = payload.operation_status ?? "ENABLE";
+    if (guard.forcePausedCreation && operationStatus === "ENABLE") {
+      operationStatus = "DISABLE";
+      coercions.push("operation_status coerced to DISABLE (paused) by policy (paused_creation)");
+    }
+    if (payload.budget_mode !== "BUDGET_MODE_INFINITE" && !payload.budget) {
+      throw new AdportError2("INVALID_INPUT", `tiktok: budget is required for ${payload.budget_mode}`);
+    }
+    const budgetDeltas = [];
+    if (payload.budget) {
+      budgetDeltas.push({
+        target: `new campaign "${payload.campaign_name}" ${payload.budget_mode === "BUDGET_MODE_DAY" ? "daily" : "total"} budget`,
+        toMicros: payload.budget * UNITS_TO_MICROS
+      });
+    }
+    return {
+      summary: `Create TikTok campaign "${payload.campaign_name}" (${payload.objective_type}, ${operationStatus === "DISABLE" ? "paused" : "active"})`,
+      changes: [
+        `+ campaign "${payload.campaign_name}" objective=${payload.objective_type} ${payload.budget_mode}` + (payload.budget ? ` budget=${payload.budget}` : "") + ` operation_status=${operationStatus}`
+      ],
+      coercions,
+      budgetDeltas,
+      execute: async () => {
+        const data = await this.client.post("campaign/create", {
+          advertiser_id: accountId,
+          campaign_name: payload.campaign_name,
+          objective_type: payload.objective_type,
+          budget_mode: payload.budget_mode,
+          ...payload.budget ? { budget: payload.budget } : {},
+          operation_status: operationStatus
+        });
+        return data.campaign_id ? [data.campaign_id] : [];
+      }
+    };
+  }
+  async planSetStatus(accountId, payload) {
+    const campaigns = await this.listCampaigns(accountId, payload.campaign_ids);
+    const changes = payload.campaign_ids.map((id) => {
+      const campaign = campaigns.find((c) => c.campaign_id === id);
+      return `~ campaign ${id} ("${campaign?.campaign_name ?? "?"}") operation_status ${campaign?.operation_status ?? "?"} \u2192 ${payload.operation_status}`;
+    });
+    return {
+      summary: `Set ${payload.campaign_ids.length} TikTok campaign(s) \u2192 ${payload.operation_status === "DISABLE" ? "paused" : "active"}`,
+      changes,
+      coercions: [],
+      budgetDeltas: [],
+      execute: async () => {
+        await this.client.post("campaign/status/update", {
+          advertiser_id: accountId,
+          campaign_ids: payload.campaign_ids,
+          operation_status: payload.operation_status
+        });
+        return payload.campaign_ids;
+      }
+    };
+  }
+  async planSetBudget(accountId, payload) {
+    const campaigns = await this.listCampaigns(accountId, [payload.campaign_id]);
+    const campaign = campaigns[0];
+    if (!campaign) {
+      throw new AdportError2("PROVIDER_ERROR", `tiktok: campaign ${payload.campaign_id} not found in advertiser ${accountId}`);
+    }
+    if (campaign.budget_mode === "BUDGET_MODE_INFINITE") {
+      throw new AdportError2("PROVIDER_ERROR", `tiktok: campaign "${campaign.campaign_name}" has no budget (BUDGET_MODE_INFINITE)`);
+    }
+    return {
+      summary: `Change TikTok campaign "${campaign.campaign_name}" budget ${campaign.budget} \u2192 ${payload.budget} (${campaign.budget_mode})`,
+      changes: [
+        `~ campaign ${payload.campaign_id} budget ${campaign.budget} \u2192 ${payload.budget}`,
+        "! TikTok requires the new budget to be \u2265105% of already-spent amount; the API rejects violations"
+      ],
+      coercions: [],
+      budgetDeltas: [
+        {
+          target: `campaign "${campaign.campaign_name}" ${campaign.budget_mode === "BUDGET_MODE_DAY" ? "daily" : "total"} budget`,
+          fromMicros: campaign.budget * UNITS_TO_MICROS,
+          toMicros: payload.budget * UNITS_TO_MICROS
+        }
+      ],
+      execute: async () => {
+        await this.client.post("campaign/update", {
+          advertiser_id: accountId,
+          campaign_id: payload.campaign_id,
+          budget: payload.budget
+        });
+        return [payload.campaign_id];
+      }
+    };
+  }
+  appId() {
+    return this.app.appId;
+  }
+  secret() {
+    return this.app.secret;
+  }
+};
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+
+// src/tools.ts
+import { defineTool, guardedWriteTool } from "@adport/core";
+import { z } from "zod";
+var OBJECTIVES = [
+  "REACH",
+  "TRAFFIC",
+  "VIDEO_VIEWS",
+  "LEAD_GENERATION",
+  "ENGAGEMENT",
+  "APP_PROMOTION",
+  "WEB_CONVERSIONS",
+  "PRODUCT_SALES"
+];
+var operationStatusSchema = z.enum(["ENABLE", "DISABLE"]);
+function tiktokTools(provider) {
+  return [
+    defineTool({
+      name: "tiktok_campaigns",
+      namespace: "tiktok",
+      description: "List TikTok campaigns (id, name, operation_status ENABLE/DISABLE, budget, budget_mode, objective).",
+      input: z.object({
+        account_id: z.string().describe("Advertiser id"),
+        campaign_ids: z.array(z.string()).optional()
+      }),
+      annotations: { readOnly: true },
+      async handler(input) {
+        const campaigns = await provider.listCampaigns(input.account_id, input.campaign_ids);
+        return { campaigns };
+      }
+    }),
+    defineTool({
+      name: "tiktok_report",
+      namespace: "tiktok",
+      description: "Raw TikTok synchronous reporting (report/integrated). Metric values come back as strings; note total_complete_payment_rate is total purchase VALUE (misleading name), complete_payment_roas is purchase ROAS.",
+      input: z.object({
+        account_id: z.string(),
+        data_level: z.enum(["AUCTION_ADVERTISER", "AUCTION_CAMPAIGN", "AUCTION_ADGROUP", "AUCTION_AD"]).default("AUCTION_CAMPAIGN"),
+        dimensions: z.array(z.string()).min(1).default(["campaign_id"]),
+        metrics: z.array(z.string()).min(1).default(["spend", "impressions", "clicks", "conversion"]),
+        start_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+        end_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+        page_size: z.number().int().positive().max(1e3).default(200)
+      }),
+      annotations: { readOnly: true },
+      async handler(input) {
+        const rows = await provider.rawReport(input);
+        return { rows, row_count: rows.length };
+      }
+    }),
+    guardedWriteTool({
+      name: "tiktok_create_campaign",
+      namespace: "tiktok",
+      description: "Create a TikTok campaign. Budget is a float in whole account-currency units (min ~20 USD-equivalent for DAY/TOTAL modes). TikTok has no server-side dry run \u2014 the preview is a client-side diff.",
+      provider: "tiktok",
+      kind: "create",
+      payload: z.object({
+        campaign_name: z.string().min(1).max(512),
+        objective_type: z.enum(OBJECTIVES).default("TRAFFIC"),
+        budget_mode: z.enum(["BUDGET_MODE_DAY", "BUDGET_MODE_TOTAL", "BUDGET_MODE_INFINITE"]).default("BUDGET_MODE_DAY"),
+        budget: z.number().positive().optional().describe("Whole currency units (float), required unless BUDGET_MODE_INFINITE"),
+        operation_status: operationStatusSchema.optional()
+      })
+    }),
+    guardedWriteTool({
+      name: "tiktok_set_campaign_status",
+      namespace: "tiktok",
+      description: "Enable or pause (DISABLE) up to 20 TikTok campaigns.",
+      provider: "tiktok",
+      kind: "update",
+      payload: z.object({
+        campaign_ids: z.array(z.string()).min(1).max(20),
+        operation_status: operationStatusSchema
+      })
+    }),
+    guardedWriteTool({
+      name: "tiktok_set_budget",
+      namespace: "tiktok",
+      description: "Change a TikTok campaign's budget (whole currency units). TikTok rejects new budgets below 105% of current spend.",
+      provider: "tiktok",
+      kind: "update",
+      payload: z.object({
+        campaign_id: z.string(),
+        budget: z.number().positive()
+      })
+    })
+  ];
+}
+
+// src/index.ts
+async function resolveTikTokCredentials(store) {
+  const record = await store.get("tiktok");
+  if (record?.data.access_token && record.data.app_id && record.data.secret) {
+    return {
+      accessToken: record.data.access_token,
+      appId: record.data.app_id,
+      secret: record.data.secret,
+      sandbox: record.data.sandbox === "true"
+    };
+  }
+  const env = process.env;
+  if (env.TIKTOK_ACCESS_TOKEN && env.TIKTOK_APP_ID && env.TIKTOK_APP_SECRET) {
+    return {
+      accessToken: env.TIKTOK_ACCESS_TOKEN,
+      appId: env.TIKTOK_APP_ID,
+      secret: env.TIKTOK_APP_SECRET,
+      sandbox: env.TIKTOK_SANDBOX === "true"
+    };
+  }
+  return void 0;
+}
+async function createTikTokModule(store) {
+  const credentials = await resolveTikTokCredentials(store);
+  if (!credentials) return void 0;
+  const provider = new TikTokAdsProvider(new TikTokClient(credentials), {
+    appId: credentials.appId,
+    secret: credentials.secret
+  });
+  return { provider, tools: tiktokTools(provider) };
+}
+export {
+  TIKTOK_API_VERSION,
+  TikTokAdsProvider,
+  TikTokClient,
+  UNITS_TO_MICROS,
+  createTikTokModule,
+  resolveTikTokCredentials,
+  tiktokTools
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/provider.ts","../src/tools.ts","../src/index.ts"],"sourcesContent":["import { AdportError } from '@adport/core';\n\nexport interface TikTokCredentials {\n  /** Long-term access token (does not expire; revoked by the advertiser). */\n  accessToken: string;\n  appId?: string;\n  secret?: string;\n  /** Use the sandbox environment (sandbox-ads.tiktok.com). */\n  sandbox?: boolean;\n}\n\nexport const TIKTOK_API_VERSION = 'v1.3';\nconst PROD_BASE = 'https://business-api.tiktok.com/open_api';\nconst SANDBOX_BASE = 'https://sandbox-ads.tiktok.com/open_api';\n\n/** Business-error codes worth a targeted hint. */\nconst CODE_HINTS: Record<number, string> = {\n  40105: 'The access token is invalid — re-run `adport connect tiktok`.',\n  40102: 'The access token expired or was revoked — re-run `adport connect tiktok`.',\n  40100: 'Rate limited (app level) — back off and retry.',\n  40133: 'Rate limited (advertiser level) — back off and retry.',\n};\n\n/**\n * TikTok Business API client. Peculiarities handled here:\n * - every endpoint needs a TRAILING SLASH (404 otherwise)\n * - business errors arrive as HTTP 200 with a non-zero envelope `code`\n * - array query params are JSON-encoded strings\n */\nexport class TikTokClient {\n  readonly baseUrl: string;\n\n  constructor(\n    private readonly credentials: TikTokCredentials,\n    private readonly fetchImpl: typeof fetch = fetch,\n  ) {\n    this.baseUrl = `${credentials.sandbox ? SANDBOX_BASE : PROD_BASE}/${TIKTOK_API_VERSION}`;\n  }\n\n  async get<T>(path: string, params: Record<string, string | number | unknown[] | object | undefined> = {}): Promise<T> {\n    const search = new URLSearchParams();\n    for (const [key, value] of Object.entries(params)) {\n      if (value === undefined) continue;\n      search.set(key, typeof value === 'object' ? JSON.stringify(value) : String(value));\n    }\n    const query = search.size > 0 ? `?${search}` : '';\n    return this.send<T>(`${path}${query}`, { method: 'GET' });\n  }\n\n  async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    return this.send<T>(path, { method: 'POST', body: JSON.stringify(body) });\n  }\n\n  private async send<T>(pathWithQuery: string, init: { method: string; body?: string }): Promise<T> {\n    // Trailing slash is mandatory before the query string.\n    const [path, query] = pathWithQuery.split('?');\n    const url = `${this.baseUrl}/${path!.replace(/^\\/|\\/$/g, '')}/${query ? `?${query}` : ''}`;\n    const response = await this.fetchImpl(url, {\n      method: init.method,\n      headers: {\n        'Access-Token': this.credentials.accessToken,\n        ...(init.body ? { 'content-type': 'application/json' } : {}),\n      },\n      body: init.body,\n    });\n    const raw = await response.text();\n    if (!response.ok) {\n      throw new AdportError('PROVIDER_ERROR', `TikTok API HTTP ${response.status} for ${path} (check method and trailing slash)`, raw);\n    }\n    const envelope = JSON.parse(raw) as { code: number; message: string; request_id?: string; data?: T };\n    if (envelope.code !== 0) {\n      const hint = CODE_HINTS[envelope.code];\n      throw new AdportError(\n        'PROVIDER_ERROR',\n        `TikTok API error ${envelope.code}: ${envelope.message}${hint ? `\\n  ${hint}` : ''}` +\n          (envelope.request_id ? ` [request_id: ${envelope.request_id}]` : ''),\n        envelope,\n      );\n    }\n    return (envelope.data ?? {}) as T;\n  }\n}\n","import {\n  AdportError,\n  resolveDateRange,\n  type Account,\n  type AdProvider,\n  type MetricName,\n  type NormalizedQuery,\n  type ProviderCapabilities,\n  type Report,\n  type ReportRow,\n  type StandardActions,\n  type WriteGuard,\n  type WriteOperation,\n  type WritePreview,\n  type WriteResult,\n} from '@adport/core';\nimport { TikTokClient } from './client.js';\n\n/** TikTok budgets are floats in whole account-currency units. */\nexport const UNITS_TO_MICROS = 1_000_000;\n\nconst DATA_LEVEL = {\n  account: 'AUCTION_ADVERTISER',\n  campaign: 'AUCTION_CAMPAIGN',\n  ad_group: 'AUCTION_ADGROUP',\n  ad: 'AUCTION_AD',\n} as const;\n\nconst ID_DIMENSION = {\n  account: 'advertiser_id',\n  campaign: 'campaign_id',\n  ad_group: 'adgroup_id',\n  ad: 'ad_id',\n} as const;\n\ninterface TikTokCampaign {\n  campaign_id: string;\n  campaign_name: string;\n  operation_status: 'ENABLE' | 'DISABLE';\n  secondary_status?: string;\n  budget: number;\n  budget_mode: string;\n  objective_type: string;\n}\n\ninterface WritePlan {\n  summary: string;\n  changes: string[];\n  coercions: string[];\n  budgetDeltas: WritePreview['budgetDeltas'];\n  execute: () => Promise<string[]>;\n}\n\nexport class TikTokAdsProvider implements AdProvider {\n  readonly id = 'tiktok';\n\n  constructor(\n    private readonly client: TikTokClient,\n    private readonly app: { appId: string; secret: string },\n  ) {}\n\n  capabilities(): ProviderCapabilities {\n    // No server-side dry run in the Marketing API — previews are client-side diffs.\n    return { serverDryRun: false };\n  }\n\n  standardActions(): StandardActions {\n    return {\n      pauseCampaign: (accountId, campaignId) => ({\n        tool: 'tiktok_set_campaign_status',\n        input: { account_id: accountId, campaign_ids: [campaignId], operation_status: 'DISABLE' },\n      }),\n    };\n  }\n\n  async listAccounts(): Promise<Account[]> {\n    const authorized = await this.client.get<{ list?: Array<{ advertiser_id: string; advertiser_name: string }> }>(\n      'oauth2/advertiser/get',\n      { app_id: this.appId(), secret: this.secret() },\n    );\n    const ids = (authorized.list ?? []).map((a) => a.advertiser_id);\n    if (ids.length === 0) return [];\n    const info = await this.client.get<{\n      list?: Array<{ advertiser_id: string; name?: string; currency?: string; status?: string; timezone?: string }>;\n    }>('advertiser/info', { advertiser_ids: ids.slice(0, 100), fields: ['name', 'currency', 'status', 'timezone'] });\n    const byId = new Map((info.list ?? []).map((i) => [i.advertiser_id, i]));\n    return ids.map((id) => {\n      const details = byId.get(id);\n      return {\n        provider: this.id,\n        id,\n        name: details?.name ?? (authorized.list ?? []).find((a) => a.advertiser_id === id)?.advertiser_name ?? id,\n        currency: details?.currency,\n        status: details?.status?.replace('STATUS_', ''),\n      };\n    });\n  }\n\n  async report(query: NormalizedQuery): Promise<Report> {\n    const range = resolveDateRange(query.dateRange);\n    const accountIds = query.accountIds ?? (await this.listAccounts()).map((a) => a.id);\n    const level = DATA_LEVEL[query.level];\n    const idDim = ID_DIMENSION[query.level];\n    const nameMetric = { campaign: 'campaign_name', ad_group: 'adgroup_name', ad: 'ad_name' }[\n      query.level as string\n    ];\n\n    const rows: ReportRow[] = [];\n    for (const accountId of accountIds) {\n      const data = await this.client.get<{\n        list?: Array<{ dimensions: Record<string, string>; metrics: Record<string, string> }>;\n        page_info?: { total_number?: number };\n      }>('report/integrated/get', {\n        advertiser_id: accountId,\n        report_type: 'BASIC',\n        data_level: level,\n        dimensions: [idDim],\n        metrics: [\n          ...(nameMetric ? [nameMetric] : []),\n          'spend',\n          'impressions',\n          'clicks',\n          'conversion',\n          'complete_payment_roas',\n          'total_complete_payment_rate',\n        ],\n        start_date: range.start,\n        end_date: range.end,\n        page: 1,\n        page_size: Math.min(query.limit ?? 200, 1000),\n      });\n      for (const row of data.list ?? []) {\n        rows.push(this.toReportRow(row, accountId, query, idDim, nameMetric));\n      }\n    }\n    return { rows };\n  }\n\n  private toReportRow(\n    row: { dimensions: Record<string, string>; metrics: Record<string, string> },\n    accountId: string,\n    query: NormalizedQuery,\n    idDim: string,\n    nameMetric?: string,\n  ): ReportRow {\n    // All TikTok metric values are strings (\"14.68\"); spend is whole currency units.\n    const num = (key: string) => Number(row.metrics[key] ?? 0);\n    const spend = num('spend');\n    const impressions = num('impressions');\n    const clicks = num('clicks');\n    const conversions = num('conversion');\n    // total_complete_payment_rate is (despite the name) total purchase VALUE.\n    const conversionValue = num('total_complete_payment_rate');\n    const all: Record<MetricName, number> = {\n      spend: round2(spend),\n      impressions,\n      clicks,\n      conversions,\n      conversion_value: round2(conversionValue),\n      ctr: impressions > 0 ? round2((clicks / impressions) * 100) : 0,\n      cpc: clicks > 0 ? round2(spend / clicks) : 0,\n      cpm: impressions > 0 ? round2((spend / impressions) * 1000) : 0,\n      cpa: conversions > 0 ? round2(spend / conversions) : 0,\n      roas: spend > 0 ? round2(conversionValue / spend) : 0,\n    };\n    const entityId = row.dimensions[idDim] ?? '';\n    return {\n      provider: this.id,\n      accountId,\n      entity: {\n        level: query.level,\n        id: entityId,\n        name: (nameMetric ? row.metrics[nameMetric] : undefined) ?? entityId,\n      },\n      metrics: Object.fromEntries(query.metrics.map((m) => [m, all[m]])),\n    };\n  }\n\n  async rawReport(input: {\n    account_id: string;\n    data_level: string;\n    dimensions: string[];\n    metrics: string[];\n    start_date: string;\n    end_date: string;\n    page_size?: number;\n  }): Promise<Array<Record<string, unknown>>> {\n    const data = await this.client.get<{ list?: Array<Record<string, unknown>> }>('report/integrated/get', {\n      advertiser_id: input.account_id,\n      report_type: 'BASIC',\n      data_level: input.data_level,\n      dimensions: input.dimensions,\n      metrics: input.metrics,\n      start_date: input.start_date,\n      end_date: input.end_date,\n      page: 1,\n      page_size: Math.min(input.page_size ?? 200, 1000),\n    });\n    return data.list ?? [];\n  }\n\n  async listCampaigns(accountId: string, campaignIds?: string[]): Promise<TikTokCampaign[]> {\n    const data = await this.client.get<{ list?: TikTokCampaign[] }>('campaign/get', {\n      advertiser_id: accountId,\n      ...(campaignIds ? { filtering: { campaign_ids: campaignIds } } : {}),\n      page: 1,\n      page_size: campaignIds ? campaignIds.length : 100,\n    });\n    return data.list ?? [];\n  }\n\n  async previewWrite(op: WriteOperation, guard: WriteGuard): Promise<WritePreview> {\n    const plan = await this.plan(op, guard);\n    // No validate_only equivalent — the preview is a client-side diff from live lookups.\n    return {\n      summary: plan.summary,\n      changes: plan.changes,\n      coercions: plan.coercions,\n      budgetDeltas: plan.budgetDeltas,\n      serverValidated: false,\n    };\n  }\n\n  async applyWrite(op: WriteOperation, guard: WriteGuard): Promise<WriteResult> {\n    const plan = await this.plan(op, guard);\n    const resourceIds = await plan.execute();\n    return { applied: true, resourceIds };\n  }\n\n  private async plan(op: WriteOperation, guard: WriteGuard): Promise<WritePlan> {\n    const payload = op.payload as never;\n    switch (op.tool) {\n      case 'tiktok_create_campaign':\n        return this.planCreateCampaign(op.accountId, payload, guard);\n      case 'tiktok_set_campaign_status':\n        return this.planSetStatus(op.accountId, payload);\n      case 'tiktok_set_budget':\n        return this.planSetBudget(op.accountId, payload);\n      default:\n        throw new AdportError('PROVIDER_ERROR', `tiktok: unsupported write tool ${op.tool}`);\n    }\n  }\n\n  private async planCreateCampaign(\n    accountId: string,\n    payload: { campaign_name: string; objective_type: string; budget_mode: string; budget?: number; operation_status?: string },\n    guard: WriteGuard,\n  ): Promise<WritePlan> {\n    const coercions: string[] = [];\n    // TikTok creates campaigns ENABLED by default; DISABLE is its \"paused\".\n    let operationStatus = payload.operation_status ?? 'ENABLE';\n    if (guard.forcePausedCreation && operationStatus === 'ENABLE') {\n      operationStatus = 'DISABLE';\n      coercions.push('operation_status coerced to DISABLE (paused) by policy (paused_creation)');\n    }\n    if (payload.budget_mode !== 'BUDGET_MODE_INFINITE' && !payload.budget) {\n      throw new AdportError('INVALID_INPUT', `tiktok: budget is required for ${payload.budget_mode}`);\n    }\n    const budgetDeltas: WritePreview['budgetDeltas'] = [];\n    if (payload.budget) {\n      budgetDeltas.push({\n        target: `new campaign \"${payload.campaign_name}\" ${payload.budget_mode === 'BUDGET_MODE_DAY' ? 'daily' : 'total'} budget`,\n        toMicros: payload.budget * UNITS_TO_MICROS,\n      });\n    }\n    return {\n      summary: `Create TikTok campaign \"${payload.campaign_name}\" (${payload.objective_type}, ${operationStatus === 'DISABLE' ? 'paused' : 'active'})`,\n      changes: [\n        `+ campaign \"${payload.campaign_name}\" objective=${payload.objective_type} ${payload.budget_mode}` +\n          (payload.budget ? ` budget=${payload.budget}` : '') +\n          ` operation_status=${operationStatus}`,\n      ],\n      coercions,\n      budgetDeltas,\n      execute: async () => {\n        const data = await this.client.post<{ campaign_id?: string }>('campaign/create', {\n          advertiser_id: accountId,\n          campaign_name: payload.campaign_name,\n          objective_type: payload.objective_type,\n          budget_mode: payload.budget_mode,\n          ...(payload.budget ? { budget: payload.budget } : {}),\n          operation_status: operationStatus,\n        });\n        return data.campaign_id ? [data.campaign_id] : [];\n      },\n    };\n  }\n\n  private async planSetStatus(\n    accountId: string,\n    payload: { campaign_ids: string[]; operation_status: 'ENABLE' | 'DISABLE' },\n  ): Promise<WritePlan> {\n    const campaigns = await this.listCampaigns(accountId, payload.campaign_ids);\n    const changes = payload.campaign_ids.map((id) => {\n      const campaign = campaigns.find((c) => c.campaign_id === id);\n      return `~ campaign ${id} (\"${campaign?.campaign_name ?? '?'}\") operation_status ${campaign?.operation_status ?? '?'} → ${payload.operation_status}`;\n    });\n    return {\n      summary: `Set ${payload.campaign_ids.length} TikTok campaign(s) → ${payload.operation_status === 'DISABLE' ? 'paused' : 'active'}`,\n      changes,\n      coercions: [],\n      budgetDeltas: [],\n      execute: async () => {\n        await this.client.post('campaign/status/update', {\n          advertiser_id: accountId,\n          campaign_ids: payload.campaign_ids,\n          operation_status: payload.operation_status,\n        });\n        return payload.campaign_ids;\n      },\n    };\n  }\n\n  private async planSetBudget(\n    accountId: string,\n    payload: { campaign_id: string; budget: number },\n  ): Promise<WritePlan> {\n    const campaigns = await this.listCampaigns(accountId, [payload.campaign_id]);\n    const campaign = campaigns[0];\n    if (!campaign) {\n      throw new AdportError('PROVIDER_ERROR', `tiktok: campaign ${payload.campaign_id} not found in advertiser ${accountId}`);\n    }\n    if (campaign.budget_mode === 'BUDGET_MODE_INFINITE') {\n      throw new AdportError('PROVIDER_ERROR', `tiktok: campaign \"${campaign.campaign_name}\" has no budget (BUDGET_MODE_INFINITE)`);\n    }\n    return {\n      summary: `Change TikTok campaign \"${campaign.campaign_name}\" budget ${campaign.budget} → ${payload.budget} (${campaign.budget_mode})`,\n      changes: [\n        `~ campaign ${payload.campaign_id} budget ${campaign.budget} → ${payload.budget}`,\n        '! TikTok requires the new budget to be ≥105% of already-spent amount; the API rejects violations',\n      ],\n      coercions: [],\n      budgetDeltas: [\n        {\n          target: `campaign \"${campaign.campaign_name}\" ${campaign.budget_mode === 'BUDGET_MODE_DAY' ? 'daily' : 'total'} budget`,\n          fromMicros: campaign.budget * UNITS_TO_MICROS,\n          toMicros: payload.budget * UNITS_TO_MICROS,\n        },\n      ],\n      execute: async () => {\n        await this.client.post('campaign/update', {\n          advertiser_id: accountId,\n          campaign_id: payload.campaign_id,\n          budget: payload.budget,\n        });\n        return [payload.campaign_id];\n      },\n    };\n  }\n\n  private appId(): string {\n    return this.app.appId;\n  }\n\n  private secret(): string {\n    return this.app.secret;\n  }\n}\n\nfunction round2(n: number): number {\n  return Math.round(n * 100) / 100;\n}\n","import { defineTool, guardedWriteTool, type AnyToolDefinition } from '@adport/core';\nimport { z } from 'zod';\nimport type { TikTokAdsProvider } from './provider.js';\n\nconst OBJECTIVES = [\n  'REACH',\n  'TRAFFIC',\n  'VIDEO_VIEWS',\n  'LEAD_GENERATION',\n  'ENGAGEMENT',\n  'APP_PROMOTION',\n  'WEB_CONVERSIONS',\n  'PRODUCT_SALES',\n] as const;\n\nconst operationStatusSchema = z.enum(['ENABLE', 'DISABLE']);\n\nexport function tiktokTools(provider: TikTokAdsProvider): AnyToolDefinition[] {\n  return [\n    defineTool({\n      name: 'tiktok_campaigns',\n      namespace: 'tiktok',\n      description: 'List TikTok campaigns (id, name, operation_status ENABLE/DISABLE, budget, budget_mode, objective).',\n      input: z.object({\n        account_id: z.string().describe('Advertiser id'),\n        campaign_ids: z.array(z.string()).optional(),\n      }),\n      annotations: { readOnly: true },\n      async handler(input) {\n        const campaigns = await provider.listCampaigns(input.account_id, input.campaign_ids);\n        return { campaigns };\n      },\n    }),\n    defineTool({\n      name: 'tiktok_report',\n      namespace: 'tiktok',\n      description:\n        'Raw TikTok synchronous reporting (report/integrated). Metric values come back as strings; ' +\n        'note total_complete_payment_rate is total purchase VALUE (misleading name), complete_payment_roas is purchase ROAS.',\n      input: z.object({\n        account_id: z.string(),\n        data_level: z.enum(['AUCTION_ADVERTISER', 'AUCTION_CAMPAIGN', 'AUCTION_ADGROUP', 'AUCTION_AD']).default('AUCTION_CAMPAIGN'),\n        dimensions: z.array(z.string()).min(1).default(['campaign_id']),\n        metrics: z.array(z.string()).min(1).default(['spend', 'impressions', 'clicks', 'conversion']),\n        start_date: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/),\n        end_date: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/),\n        page_size: z.number().int().positive().max(1000).default(200),\n      }),\n      annotations: { readOnly: true },\n      async handler(input) {\n        const rows = await provider.rawReport(input);\n        return { rows, row_count: rows.length };\n      },\n    }),\n    guardedWriteTool({\n      name: 'tiktok_create_campaign',\n      namespace: 'tiktok',\n      description:\n        'Create a TikTok campaign. Budget is a float in whole account-currency units (min ~20 USD-equivalent for ' +\n        'DAY/TOTAL modes). TikTok has no server-side dry run — the preview is a client-side diff.',\n      provider: 'tiktok',\n      kind: 'create',\n      payload: z.object({\n        campaign_name: z.string().min(1).max(512),\n        objective_type: z.enum(OBJECTIVES).default('TRAFFIC'),\n        budget_mode: z.enum(['BUDGET_MODE_DAY', 'BUDGET_MODE_TOTAL', 'BUDGET_MODE_INFINITE']).default('BUDGET_MODE_DAY'),\n        budget: z.number().positive().optional().describe('Whole currency units (float), required unless BUDGET_MODE_INFINITE'),\n        operation_status: operationStatusSchema.optional(),\n      }),\n    }),\n    guardedWriteTool({\n      name: 'tiktok_set_campaign_status',\n      namespace: 'tiktok',\n      description: 'Enable or pause (DISABLE) up to 20 TikTok campaigns.',\n      provider: 'tiktok',\n      kind: 'update',\n      payload: z.object({\n        campaign_ids: z.array(z.string()).min(1).max(20),\n        operation_status: operationStatusSchema,\n      }),\n    }),\n    guardedWriteTool({\n      name: 'tiktok_set_budget',\n      namespace: 'tiktok',\n      description:\n        \"Change a TikTok campaign's budget (whole currency units). TikTok rejects new budgets below 105% of current spend.\",\n      provider: 'tiktok',\n      kind: 'update',\n      payload: z.object({\n        campaign_id: z.string(),\n        budget: z.number().positive(),\n      }),\n    }),\n  ];\n}\n","import type { CredentialStore, ProviderModule } from '@adport/core';\nimport { TikTokClient, type TikTokCredentials } from './client.js';\nimport { TikTokAdsProvider } from './provider.js';\nimport { tiktokTools } from './tools.js';\n\nexport { TikTokClient, TIKTOK_API_VERSION, type TikTokCredentials } from './client.js';\nexport { TikTokAdsProvider, UNITS_TO_MICROS } from './provider.js';\nexport { tiktokTools } from './tools.js';\n\nexport async function resolveTikTokCredentials(\n  store: CredentialStore,\n): Promise<(TikTokCredentials & { appId: string; secret: string }) | undefined> {\n  const record = await store.get('tiktok');\n  if (record?.data.access_token && record.data.app_id && record.data.secret) {\n    return {\n      accessToken: record.data.access_token,\n      appId: record.data.app_id,\n      secret: record.data.secret,\n      sandbox: record.data.sandbox === 'true',\n    };\n  }\n  const env = process.env;\n  if (env.TIKTOK_ACCESS_TOKEN && env.TIKTOK_APP_ID && env.TIKTOK_APP_SECRET) {\n    return {\n      accessToken: env.TIKTOK_ACCESS_TOKEN,\n      appId: env.TIKTOK_APP_ID,\n      secret: env.TIKTOK_APP_SECRET,\n      sandbox: env.TIKTOK_SANDBOX === 'true',\n    };\n  }\n  return undefined;\n}\n\nexport async function createTikTokModule(store: CredentialStore): Promise<ProviderModule | undefined> {\n  const credentials = await resolveTikTokCredentials(store);\n  if (!credentials) return undefined;\n  const provider = new TikTokAdsProvider(new TikTokClient(credentials), {\n    appId: credentials.appId,\n    secret: credentials.secret,\n  });\n  return { provider, tools: tiktokTools(provider) };\n}\n"],"mappings":"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","names":["AdportError"]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@adport/provider-tiktok",
+  "version": "0.1.0",
+  "description": "TikTok Ads provider for adport — TikTok Business/Marketing API v1.3 with sandbox support",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.25.0",
+    "@adport/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --sourcemap --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}