@cesteral/pinterest-mcp 1.0.0

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

@@ -0,0 +1,149 @@
+import { fetchWithTimeout, buildMultipartFormData, executeWithRetry, McpError, mapHttpStatusToJsonRpc, } from "@cesteral/shared";
+import { withPinterestApiSpan } from "../../utils/platform.js";
+const PINTEREST_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 2_000,
+    maxBackoffMs: 30_000,
+    timeoutMs: 30_000,
+    platformName: "Pinterest",
+    tokenExpiryHint: "Pinterest token expired. Regenerate at developers.pinterest.com.",
+};
+function buildPinterestNextAction(status, _errorBody, defaultHint) {
+    if (status === 401) {
+        return "Renew the Pinterest access token. Regenerate it at https://developers.pinterest.com and update PINTEREST_ACCESS_TOKEN.";
+    }
+    if (status === 403) {
+        return "Verify the token has ads:read / ads:write scopes and the user is admin/employee on the ad account.";
+    }
+    if (status === 404) {
+        return "Verify the ad_account_id and entity IDs with pinterest_list_ad_accounts / pinterest_list_entities.";
+    }
+    return defaultHint;
+}
+export class PinterestHttpClient {
+    authAdapter;
+    adAccountId;
+    baseUrl;
+    logger;
+    apiVersion;
+    constructor(authAdapter, adAccountId, baseUrl, logger, apiVersion = "v5") {
+        this.authAdapter = authAdapter;
+        this.adAccountId = adAccountId;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+        this.apiVersion = apiVersion;
+    }
+    get accountId() {
+        return this.adAccountId;
+    }
+    get version() {
+        return this.apiVersion;
+    }
+    async get(path, params, context) {
+        const url = this.buildUrl(path, params);
+        return this.executeRequest(url, context, { method: "GET" });
+    }
+    async post(path, data, context) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify(data ?? {});
+        return this.executeRequest(url, context, {
+            method: "POST",
+            body,
+        });
+    }
+    async patch(path, data, context) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify(data ?? {});
+        return this.executeRequest(url, context, {
+            method: "PATCH",
+            body,
+        });
+    }
+    async delete(path, params, context) {
+        const url = this.buildUrl(path, params);
+        return this.executeRequest(url, context, {
+            method: "DELETE",
+        });
+    }
+    async postMultipart(path, fields, fileField, fileBuffer, filename, fileContentType, context) {
+        const url = this.buildUrl(path);
+        return withPinterestApiSpan("api.multipart.POST", path, async (span) => {
+            span.setAttribute("http.request.method", "POST");
+            span.setAttribute("http.url", url);
+            const { body, contentType } = buildMultipartFormData(fields, fileField, fileBuffer, filename, fileContentType);
+            const result = await executeWithRetry(PINTEREST_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,
+                    };
+                },
+                buildNextAction: buildPinterestNextAction,
+            });
+            span.setAttribute("http.response.status_code", 200);
+            return result;
+        });
+    }
+    async uploadToS3(uploadUrl, uploadParameters, fileBuffer, filename, fileContentType, context) {
+        return withPinterestApiSpan("api.s3.upload", uploadUrl, async (span) => {
+            span.setAttribute("http.request.method", "POST");
+            span.setAttribute("http.url", uploadUrl);
+            const { body, contentType } = buildMultipartFormData(uploadParameters, "file", fileBuffer, filename, fileContentType);
+            const response = await fetchWithTimeout(uploadUrl, 120_000, context, {
+                method: "POST",
+                headers: { "Content-Type": contentType },
+                body,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => "");
+                throw new McpError(mapHttpStatusToJsonRpc(response.status), `Pinterest S3 upload failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
+            }
+        });
+    }
+    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 withPinterestApiSpan(`api.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(PINTEREST_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;
+                },
+                buildNextAction: buildPinterestNextAction,
+            });
+        });
+    }
+}
+//# sourceMappingURL=pinterest-http-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pinterest-http-client.js","sourceRoot":"","sources":["../../../src/services/pinterest/pinterest-http-client.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,QAAQ,EACR,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,sBAAsB,GAAgB;IAC1C,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,MAAM;IACpB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,kEAAkE;CACpF,CAAC;AAEF,SAAS,wBAAwB,CAC/B,MAAc,EACd,UAAkB,EAClB,WAA+B;IAE/B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,wHAAwH,CAAC;IAClI,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,oGAAoG,CAAC;IAC9G,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,oGAAoG,CAAC;IAC9G,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAiBD,MAAM,OAAO,mBAAmB;IAEX;IACA;IACA;IACA;IACA;IALnB,YACmB,WAAiC,EACjC,WAAmB,EACnB,OAAe,EACf,MAAc,EACd,aAAqB,IAAI;QAJzB,gBAAW,GAAX,WAAW,CAAsB;QACjC,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAe;IACzC,CAAC;IAKJ,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAKD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAKD,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,MAA+B,EAC/B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAMD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAc,EAAE,OAAwB;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAExC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAc,EAAE,OAAwB;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAExC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;YACvC,MAAM,EAAE,OAAO;YACf,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,MAA+B,EAC/B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAExC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE;YACvC,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;IAMD,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,oBAAoB,CAAC,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrE,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACnC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAClD,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,sBAAsB,EAAE;gBAC5D,GAAG;gBACH,YAAY,EAAE;oBACZ,MAAM,EAAE,MAAM;oBACd,IAAI;iBACL;gBACD,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,eAAe,EAAE,wBAAwB;aAC1C,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,gBAAwC,EACxC,UAAkB,EAClB,QAAgB,EAChB,eAAuB,EACvB,OAAwB;QAExB,OAAO,oBAAoB,CAAC,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrE,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAEzC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAClD,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,QAAQ,EACR,eAAe,CAChB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;gBACnE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;gBACxC,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,IAAI,QAAQ,CAChB,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,EACvC,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACxG,CAAC;YACJ,CAAC;QACH,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,oBAAoB,CAAC,OAAO,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC/D,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACnC,OAAO,gBAAgB,CAAC,sBAAsB,EAAE;gBAC9C,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,eAAe,EAAE,wBAAwB;aAC1C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,60 @@
+import type { PinterestHttpClient } from "./pinterest-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import type { Logger } from "pino";
+export type ReportTaskStatus = "IN_PROGRESS" | "FINISHED" | "FAILED" | "EXPIRED" | "DOES_NOT_EXIST";
+interface ReportTaskCheckData {
+    report_status: ReportTaskStatus;
+    url?: string;
+    size?: number;
+    token: string;
+}
+export interface PinterestReportConfig {
+    type?: "CAMPAIGN" | "AD_GROUP" | "AD" | "KEYWORD" | "ACCOUNT";
+    columns: string[];
+    start_date: string;
+    end_date: string;
+    granularity?: "TOTAL" | "DAY" | "HOUR" | "WEEK" | "MONTH";
+    campaign_ids?: string[];
+    ad_group_ids?: string[];
+    ad_ids?: string[];
+}
+export declare class PinterestReportingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(rateLimiter: RateLimiter, httpClient: PinterestHttpClient, logger: Logger, pollIntervalMs?: number, maxPollAttempts?: number);
+    submitReport(reportConfig: PinterestReportConfig, 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: PinterestReportConfig, maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+    getReportBreakdowns(reportConfig: PinterestReportConfig, breakdowns: string[], maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=pinterest-reporting-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pinterest-reporting-service.d.ts","sourceRoot":"","sources":["../../../src/services/pinterest/pinterest-reporting-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAaL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAGpG,UAAU,mBAAmB;IAC3B,aAAa,EAAE,gBAAgB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAJf,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAwC,EACxD,eAAe,GAAE,MAAyC;IAOvE,YAAY,CAChB,YAAY,EAAE,qBAAqB,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BzB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoClF,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBxE,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,SAA0B,EACjC,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GACxC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgEjF,SAAS,CACb,YAAY,EAAE,qBAAqB,EACnC,gBAAgB,GAAE,MAAM,GAAG,cAAwC,EACnE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAsChF,mBAAmB,CACvB,YAAY,EAAE,qBAAqB,EACnC,UAAU,EAAE,MAAM,EAAE,EACpB,gBAAgB,GAAE,MAAM,GAAG,cAAwC,EACnE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQvF"}

package/dist/services/pinterest/pinterest-reporting-service.js

@@ -0,0 +1,132 @@
+import { fetchWithTimeout, McpError, JsonRpcErrorCode, DEFAULT_REPORT_MAX_BACKOFF_MS, DEFAULT_REPORT_POLL_INTERVAL_MS, DEFAULT_REPORT_MAX_POLL_ATTEMPTS, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, DEFAULT_REPORT_MAX_SIZE_BYTES, DEFAULT_REPORT_MAX_ROWS, parseCSV, pollUntilComplete, ReportFailedError, } from "@cesteral/shared";
+export class PinterestReportingService {
+    rateLimiter;
+    httpClient;
+    logger;
+    pollIntervalMs;
+    maxPollAttempts;
+    constructor(rateLimiter, httpClient, logger, pollIntervalMs = DEFAULT_REPORT_POLL_INTERVAL_MS, maxPollAttempts = DEFAULT_REPORT_MAX_POLL_ATTEMPTS) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.pollIntervalMs = pollIntervalMs;
+        this.maxPollAttempts = maxPollAttempts;
+    }
+    async submitReport(reportConfig, context) {
+        await this.rateLimiter.consume(`pinterest:reporting`);
+        const adAccountId = this.httpClient.accountId;
+        const result = (await this.httpClient.post(`/v5/ad_accounts/${adAccountId}/reports`, {
+            type: reportConfig.type ?? "CAMPAIGN",
+            columns: reportConfig.columns,
+            start_date: reportConfig.start_date,
+            end_date: reportConfig.end_date,
+            ...(reportConfig.granularity ? { granularity: reportConfig.granularity } : {}),
+            ...(reportConfig.campaign_ids ? { campaign_ids: reportConfig.campaign_ids } : {}),
+            ...(reportConfig.ad_group_ids ? { ad_group_ids: reportConfig.ad_group_ids } : {}),
+            ...(reportConfig.ad_ids ? { ad_ids: reportConfig.ad_ids } : {}),
+        }, context));
+        return { task_id: result.token };
+    }
+    async pollReport(taskId, context) {
+        this.logger.debug({ taskId, maxPollAttempts: this.maxPollAttempts }, "Starting report poll");
+        const adAccountId = this.httpClient.accountId;
+        try {
+            return await pollUntilComplete({
+                fetchStatus: async () => {
+                    await this.rateLimiter.consume(`pinterest:reporting`);
+                    return (await this.httpClient.get(`/v5/ad_accounts/${adAccountId}/reports`, { token: taskId }, context));
+                },
+                isComplete: (r) => r.report_status === "FINISHED",
+                isFailed: (r) => r.report_status === "FAILED" ||
+                    r.report_status === "EXPIRED" ||
+                    r.report_status === "DOES_NOT_EXIST",
+                initialDelayMs: this.pollIntervalMs,
+                maxDelayMs: DEFAULT_REPORT_MAX_BACKOFF_MS,
+                maxAttempts: this.maxPollAttempts,
+            });
+        }
+        catch (err) {
+            if (err instanceof ReportFailedError) {
+                return err.status;
+            }
+            throw err;
+        }
+    }
+    async checkReportStatus(taskId, context) {
+        await this.rateLimiter.consume(`pinterest:reporting`);
+        const adAccountId = this.httpClient.accountId;
+        const result = (await this.httpClient.get(`/v5/ad_accounts/${adAccountId}/reports`, { token: taskId }, context));
+        return {
+            taskId: result.token,
+            status: result.report_status,
+            downloadUrl: result.url,
+        };
+    }
+    async downloadReport(downloadUrl, maxRows = DEFAULT_REPORT_MAX_ROWS, context, options = {}) {
+        const response = await fetchWithTimeout(downloadUrl, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, context);
+        if (!response.ok) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Failed to download Pinterest report: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers?.get("content-length");
+        if (contentLength && parseInt(contentLength, 10) > DEFAULT_REPORT_MAX_SIZE_BYTES) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Pinterest report too large (${contentLength} bytes, limit ${DEFAULT_REPORT_MAX_SIZE_BYTES}). Use more restrictive filters or date ranges.`);
+        }
+        const csvText = await response.text();
+        const normalizedCsvText = csvText
+            .replace(/^\uFEFF/, "")
+            .replace(/\r\n/g, "\n")
+            .trim();
+        if (normalizedCsvText.length === 0) {
+            return {
+                rows: [],
+                headers: [],
+                totalRows: 0,
+                ...(options.includeRawCsv ? { rawCsv: "" } : {}),
+            };
+        }
+        const { headers, rows: recordRows } = parseCSV(normalizedCsvText);
+        if (headers.length === 0 && recordRows.length === 0) {
+            return {
+                rows: [],
+                headers: [],
+                totalRows: 0,
+                ...(options.includeRawCsv ? { rawCsv: normalizedCsvText } : {}),
+            };
+        }
+        const limited = recordRows.slice(0, maxRows);
+        const rows = limited.map((record) => headers.map((h) => record[h] ?? ""));
+        return {
+            rows,
+            headers,
+            totalRows: recordRows.length,
+            ...(options.includeRawCsv ? { rawCsv: normalizedCsvText } : {}),
+        };
+    }
+    async getReport(reportConfig, maxRowsOrContext = DEFAULT_REPORT_MAX_ROWS, context) {
+        const maxRows = typeof maxRowsOrContext === "number" ? maxRowsOrContext : DEFAULT_REPORT_MAX_ROWS;
+        const requestContext = typeof maxRowsOrContext === "number" ? context : maxRowsOrContext;
+        const { task_id } = await this.submitReport(reportConfig, requestContext);
+        const taskResult = await this.pollReport(task_id, requestContext);
+        if (taskResult.report_status === "FAILED" ||
+            taskResult.report_status === "EXPIRED" ||
+            taskResult.report_status === "DOES_NOT_EXIST") {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Pinterest report task ${task_id} failed with status: ${taskResult.report_status}`);
+        }
+        if (!taskResult.url) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Pinterest report task ${task_id} completed but has no download URL`);
+        }
+        const reportData = await this.downloadReport(taskResult.url, maxRows, requestContext);
+        return {
+            ...reportData,
+            taskId: task_id,
+        };
+    }
+    async getReportBreakdowns(reportConfig, breakdowns, maxRowsOrContext = DEFAULT_REPORT_MAX_ROWS, context) {
+        const configWithBreakdowns = {
+            ...reportConfig,
+            columns: [...reportConfig.columns, ...breakdowns],
+        };
+        return this.getReport(configWithBreakdowns, maxRowsOrContext, context);
+    }
+}
+//# sourceMappingURL=pinterest-reporting-service.js.map

package/dist/services/pinterest/pinterest-reporting-service.js.map

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

package/dist/services/pinterest/pinterest-service.d.ts

@@ -0,0 +1,110 @@
+import type { PinterestHttpClient } from "./pinterest-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import { type PinterestEntityType } from "../../mcp-server/tools/utils/entity-mapping.js";
+import type { Logger } from "pino";
+import type { components } from "../../generated/types.js";
+type PinterestCampaign = components["schemas"]["CampaignResponse"];
+type PinterestAdGroup = components["schemas"]["AdGroupResponse"];
+type PinterestAd = components["schemas"]["AdResponse"];
+type PinterestPin = components["schemas"]["Pin"];
+interface PinterestEntityMap {
+    campaign: PinterestCampaign;
+    adGroup: PinterestAdGroup;
+    ad: PinterestAd;
+    creative: PinterestPin;
+}
+export type { PinterestCampaign, PinterestAdGroup, PinterestAd, PinterestPin };
+interface PinterestPageInfo {
+    bookmark: string | null;
+}
+export declare class PinterestService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    constructor(rateLimiter: RateLimiter, httpClient: PinterestHttpClient, logger: Logger);
+    get client(): PinterestHttpClient;
+    listEntities<T extends PinterestEntityType>(entityType: T, filters: {
+        adAccountId: string;
+        campaignId?: string;
+        adGroupId?: string;
+    }, bookmark?: string, pageSize?: number, context?: RequestContext): Promise<{
+        entities: PinterestEntityMap[T][];
+        pageInfo: PinterestPageInfo;
+    }>;
+    getEntity<T extends PinterestEntityType>(entityType: T, filters: {
+        adAccountId: string;
+    }, entityId: string, context?: RequestContext): Promise<PinterestEntityMap[T]>;
+    createEntity<T extends PinterestEntityType>(entityType: T, filters: {
+        adAccountId: string;
+    }, body: unknown, context?: RequestContext): Promise<PinterestEntityMap[T]>;
+    updateEntity<T extends PinterestEntityType>(entityType: T, filters: {
+        adAccountId: string;
+    }, entityId: string, updates: unknown, context?: RequestContext): Promise<PinterestEntityMap[T]>;
+    deleteEntity(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, entityIds: string[], context?: RequestContext): Promise<unknown>;
+    updateEntityStatus(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, entityIds: string[], status: string, context?: RequestContext): Promise<unknown[]>;
+    listAdAccounts(context?: RequestContext): Promise<{
+        entities: unknown[];
+        nextCursor?: string;
+    }>;
+    duplicateEntity(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, entityId: string, options?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    adjustBids(filters: {
+        adAccountId: string;
+    }, adjustments: Array<{
+        adGroupId: string;
+        bidPrice: number;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            adGroupId: string;
+            success: boolean;
+            previousBid?: number;
+            newBid?: number;
+            error?: string;
+        }>;
+    }>;
+    bulkCreateEntities(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, items: unknown[], context?: RequestContext): Promise<{
+        results: Array<{
+            success: boolean;
+            entity?: unknown;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateEntities(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, items: Array<{
+        entityId: string;
+        data: unknown;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateStatus(entityType: PinterestEntityType, filters: {
+        adAccountId: string;
+    }, entityIds: string[], status: string, context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    searchTargeting(targetingType: string, query?: string, limit?: number, context?: RequestContext): Promise<unknown>;
+    getTargetingOptions(targetingType?: string, context?: RequestContext): Promise<unknown>;
+    getAudienceEstimate(filters: {
+        adAccountId: string;
+    }, targetingConfig: unknown, context?: RequestContext): Promise<unknown>;
+    getAdPreviews(filters: {
+        adAccountId: string;
+    }, adId: string, adFormat?: string, context?: RequestContext): Promise<unknown>;
+}
+//# sourceMappingURL=pinterest-service.d.ts.map

package/dist/services/pinterest/pinterest-service.d.ts.map

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