@cesteral/snapchat-mcp 1.0.0

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,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAapF,MAAM,UAAU,qBAAqB,CACnC,WAAgC,EAChC,MAA6B,EAC7B,MAAc,EACd,WAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,IAAI,eAAe,CACzC,UAAU,EACV,WAAW,CAAC,KAAK,EACjB,WAAW,CAAC,WAAW,EACvB,WAAW,CACZ,CAAC;IACF,MAAM,wBAAwB,GAAG,IAAI,wBAAwB,CAC3D,WAAW,EACX,UAAU,EACV,WAAW,CAAC,WAAW,EACvB,MAAM,EACN,MAAM,CAAC,oBAAoB,EAC3B,MAAM,CAAC,qBAAqB,CAC7B,CAAC;IAEF,OAAO;QACL,eAAe;QACf,wBAAwB;KACzB,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,UAAU,EAAE,SAAS,CAAC,CAAC;IAC3D,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { SnapchatAuthAdapter } from "../../auth/snapchat-auth-adapter.js";
+import type { RequestContext } from "@cesteral/shared";
+export declare class SnapchatHttpClient {
+    private readonly authAdapter;
+    private readonly baseUrl;
+    private readonly logger;
+    constructor(authAdapter: SnapchatAuthAdapter, baseUrl: string, logger: import("pino").Logger);
+    get(path: string, params?: Record<string, string>, context?: RequestContext): Promise<unknown>;
+    post(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
+    put(path: string, data?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    delete(path: string, _params?: 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=snapchat-http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapchat-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/snapchat/snapchat-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AA6FpE,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM;IAI1C,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;IAMb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAUb,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAUb,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IASb,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;IAmCnB,OAAO,CAAC,QAAQ;YAeF,cAAc;CAgC7B"}

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

@@ -0,0 +1,153 @@
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+import { fetchWithTimeout, buildMultipartFormData, executeWithRetry } from "@cesteral/shared";
+import { withSnapchatApiSpan } from "../../utils/platform.js";
+const SNAPCHAT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 2_000,
+    maxBackoffMs: 30_000,
+    timeoutMs: 30_000,
+    platformName: "Snapchat",
+    tokenExpiryHint: "Snapchat token expired. Regenerate in Snap Business Manager.",
+};
+function buildSnapchatEnvelopeNextAction(message) {
+    if (!message)
+        return undefined;
+    if (/access.?token|unauthor/i.test(message)) {
+        return "Renew the Snapchat access token in Snap Business Manager and update SNAPCHAT_ACCESS_TOKEN.";
+    }
+    if (/permission|forbidden|access denied/i.test(message)) {
+        return "Verify the user has Ad Account access in Snap Business Manager and the token includes snapchat-marketing-api scope.";
+    }
+    if (/ad.?account|advertiser/i.test(message)) {
+        return "Verify the ad_account_id with snapchat_list_ad_accounts; the authenticated user may not have access.";
+    }
+    return undefined;
+}
+function buildSnapchatHttpNextAction(status, _errorBody, defaultHint) {
+    if (status === 401) {
+        return "Renew the Snapchat access token in Snap Business Manager and update SNAPCHAT_ACCESS_TOKEN.";
+    }
+    if (status === 403) {
+        return "Verify the user has Ad Account access in Snap Business Manager. The token must include snapchat-marketing-api scope.";
+    }
+    if (status === 404) {
+        return "Verify entity IDs with snapchat_list_entities or snapchat_list_ad_accounts.";
+    }
+    return defaultHint;
+}
+function validateSnapchatEnvelope(body) {
+    const json = body;
+    const requestStatus = typeof json.request_status === "string"
+        ? json.request_status.toUpperCase()
+        : typeof json.status === "string"
+            ? json.status.toUpperCase()
+            : undefined;
+    if (requestStatus !== "FAILED") {
+        return json;
+    }
+    const nextAction = buildSnapchatEnvelopeNextAction(json.display_message);
+    throw new McpError(JsonRpcErrorCode.InvalidRequest, json.display_message ?? `Snapchat API error: request_status=FAILED`, {
+        errorCode: json.error_code,
+        ...(nextAction ? { nextAction } : {}),
+    });
+}
+export class SnapchatHttpClient {
+    authAdapter;
+    baseUrl;
+    logger;
+    constructor(authAdapter, baseUrl, logger) {
+        this.authAdapter = authAdapter;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+    }
+    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);
+        return this.executeRequest(url, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(data),
+        });
+    }
+    async put(path, data, context) {
+        const url = this.buildUrl(path);
+        return this.executeRequest(url, context, {
+            method: "PUT",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(data),
+        });
+    }
+    async delete(path, _params, context) {
+        const url = this.buildUrl(path);
+        return this.executeRequest(url, context, { method: "DELETE" });
+    }
+    async postMultipart(path, fields, fileField, fileBuffer, filename, fileContentType, context) {
+        const url = this.buildUrl(path);
+        return withSnapchatApiSpan("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(SNAPCHAT_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: validateSnapchatEnvelope,
+                buildNextAction: buildSnapchatHttpNextAction,
+            });
+            span.setAttribute("http.response.status_code", 200);
+            return result;
+        });
+    }
+    buildUrl(path, params) {
+        const url = path.startsWith("http://") || path.startsWith("https://")
+            ? new URL(path)
+            : 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 withSnapchatApiSpan(`api.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(SNAPCHAT_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: validateSnapchatEnvelope,
+                buildNextAction: buildSnapchatHttpNextAction,
+            });
+        });
+    }
+}
+//# sourceMappingURL=snapchat-http-client.js.map

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

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

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

@@ -0,0 +1,64 @@
+import type { SnapchatHttpClient } from "./snapchat-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" | "COMPLETE" | "FAILED";
+interface ReportTaskCheckData {
+    status: ReportTaskStatus;
+    download_url?: string;
+    id: string;
+}
+export interface SnapchatReportFilter {
+    field: string;
+    operator: string;
+    values: string[];
+}
+export interface SnapchatReportConfig {
+    fields: string[];
+    granularity?: "TOTAL" | "DAY" | "HOUR" | "LIFETIME";
+    start_time: string;
+    end_time: string;
+    dimension_type?: "CAMPAIGN" | "AD_SQUAD" | "AD";
+}
+export declare class SnapchatReportingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly adAccountId;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(rateLimiter: RateLimiter, httpClient: SnapchatHttpClient, adAccountId: string, logger: Logger, pollIntervalMs?: number, maxPollAttempts?: number);
+    submitReport(reportConfig: SnapchatReportConfig, 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: SnapchatReportConfig, maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+    getReportBreakdowns(reportConfig: SnapchatReportConfig, breakdowns: string[], maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+    private normalizeReportStatus;
+    private mapDimensionType;
+}
+export {};
+//# sourceMappingURL=snapchat-reporting-service.d.ts.map

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

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

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

@@ -0,0 +1,172 @@
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+import { fetchWithTimeout, 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 SnapchatReportingService {
+    rateLimiter;
+    httpClient;
+    adAccountId;
+    logger;
+    pollIntervalMs;
+    maxPollAttempts;
+    constructor(rateLimiter, httpClient, adAccountId, logger, pollIntervalMs = DEFAULT_REPORT_POLL_INTERVAL_MS, maxPollAttempts = DEFAULT_REPORT_MAX_POLL_ATTEMPTS) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.adAccountId = adAccountId;
+        this.logger = logger;
+        this.pollIntervalMs = pollIntervalMs;
+        this.maxPollAttempts = maxPollAttempts;
+    }
+    async submitReport(reportConfig, context) {
+        await this.rateLimiter.consume(`snapchat:reporting`);
+        const queryParams = {
+            async: "true",
+            async_format: "csv",
+            fields: reportConfig.fields.join(","),
+            granularity: reportConfig.granularity ?? "DAY",
+            start_time: reportConfig.start_time,
+            end_time: reportConfig.end_time,
+            ...(reportConfig.dimension_type
+                ? { breakdown: this.mapDimensionType(reportConfig.dimension_type) }
+                : {}),
+        };
+        const result = (await this.httpClient.get(`/v1/adaccounts/${this.adAccountId}/stats`, queryParams, context));
+        const reportId = result.async_stats_reports?.[0]?.async_stats_report?.report_run_id;
+        if (!reportId) {
+            throw new McpError(JsonRpcErrorCode.InternalError, "Snapchat async reporting: no report id returned from submit");
+        }
+        return { task_id: reportId };
+    }
+    async pollReport(taskId, context) {
+        this.logger.debug({ taskId, maxPollAttempts: this.maxPollAttempts }, "Starting report poll");
+        try {
+            return await pollUntilComplete({
+                fetchStatus: async () => {
+                    await this.rateLimiter.consume(`snapchat:reporting`);
+                    const envelope = (await this.httpClient.get(`/v1/adaccounts/${this.adAccountId}/stats_report`, { report_run_id: taskId }, context));
+                    const report = envelope.async_stats_reports?.[0]?.async_stats_report;
+                    if (!report) {
+                        throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat report poll: unexpected response shape for task ${taskId}`);
+                    }
+                    return {
+                        id: report.report_run_id ?? taskId,
+                        status: this.normalizeReportStatus(report.async_status),
+                        download_url: report.result,
+                    };
+                },
+                isComplete: (r) => r.status === "COMPLETE",
+                isFailed: (r) => r.status === "FAILED",
+                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(`snapchat:reporting`);
+        const envelope = (await this.httpClient.get(`/v1/adaccounts/${this.adAccountId}/stats_report`, { report_run_id: taskId }, context));
+        const report = envelope.async_stats_reports?.[0]?.async_stats_report;
+        if (!report) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat report status: unexpected response shape for task ${taskId}`);
+        }
+        return {
+            taskId: report.report_run_id ?? taskId,
+            status: this.normalizeReportStatus(report.async_status),
+            downloadUrl: report.result,
+        };
+    }
+    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.ServiceUnavailable, `Failed to download Snapchat 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.InvalidRequest, `Snapchat 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 === "") {
+            return {
+                rows: [],
+                headers: [],
+                totalRows: 0,
+                ...(options.includeRawCsv ? { rawCsv: "" } : {}),
+            };
+        }
+        const { headers, rows } = parseCSV(normalizedCsvText);
+        if (headers.length === 0 && rows.length === 0) {
+            return {
+                rows: [],
+                headers: [],
+                totalRows: 0,
+                ...(options.includeRawCsv ? { rawCsv: normalizedCsvText } : {}),
+            };
+        }
+        const limited = rows.slice(0, maxRows);
+        const rowArrays = limited.map((record) => headers.map((h) => record[h] ?? ""));
+        return {
+            rows: rowArrays,
+            headers,
+            totalRows: rows.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.status === "FAILED") {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat report task ${task_id} failed`);
+        }
+        if (!taskResult.download_url) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat report task ${task_id} completed but has no download URL`);
+        }
+        const reportData = await this.downloadReport(taskResult.download_url, maxRows, requestContext);
+        return {
+            ...reportData,
+            taskId: task_id,
+        };
+    }
+    async getReportBreakdowns(reportConfig, breakdowns, maxRowsOrContext = DEFAULT_REPORT_MAX_ROWS, context) {
+        const configWithBreakdowns = {
+            ...reportConfig,
+            fields: [...reportConfig.fields, ...breakdowns],
+        };
+        return this.getReport(configWithBreakdowns, maxRowsOrContext, context);
+    }
+    normalizeReportStatus(status) {
+        switch (status?.toUpperCase()) {
+            case "STARTED":
+            case "RUNNING":
+                return "RUNNING";
+            case "COMPLETED":
+                return "COMPLETE";
+            case "FAILED":
+                return "FAILED";
+            default:
+                return "PENDING";
+        }
+    }
+    mapDimensionType(dimensionType) {
+        switch (dimensionType) {
+            case "CAMPAIGN":
+                return "campaign";
+            case "AD_SQUAD":
+                return "adsquad";
+            case "AD":
+                return "ad";
+            default:
+                throw new McpError(JsonRpcErrorCode.InvalidParams, `Unsupported Snapchat report dimension type: ${dimensionType}`);
+        }
+    }
+}
+//# sourceMappingURL=snapchat-reporting-service.js.map

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

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

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

@@ -0,0 +1,82 @@
+import type { SnapchatHttpClient } from "./snapchat-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import { type SnapchatEntityType } from "../../mcp-server/tools/utils/entity-mapping.js";
+import type { SnapchatCampaign, SnapchatAdSquad, SnapchatAd, SnapchatCreative, SnapchatAdAccount } from "./types.js";
+export type { SnapchatCampaign, SnapchatAdSquad, SnapchatAd, SnapchatCreative, SnapchatAdAccount };
+interface SnapchatEntityMap {
+    campaign: SnapchatCampaign;
+    adGroup: SnapchatAdSquad;
+    ad: SnapchatAd;
+    creative: SnapchatCreative;
+}
+export declare class SnapchatService {
+    private readonly httpClient;
+    private readonly orgId;
+    private readonly adAccountId;
+    private readonly rateLimiter;
+    constructor(httpClient: SnapchatHttpClient, orgId: string, adAccountId: string, rateLimiter: RateLimiter);
+    private resolveUpdatePathParams;
+    private buildMergedUpdateItem;
+    get client(): SnapchatHttpClient;
+    listEntities<T extends SnapchatEntityType>(entityType: T, filters?: Record<string, string>, cursor?: string, context?: RequestContext): Promise<{
+        entities: SnapchatEntityMap[T][];
+        nextCursor?: string;
+    }>;
+    getEntity<T extends SnapchatEntityType>(entityType: T, entityId: string, context?: RequestContext): Promise<SnapchatEntityMap[T]>;
+    createEntity<T extends SnapchatEntityType>(entityType: T, filters: Record<string, string>, data: Record<string, unknown>, context?: RequestContext): Promise<SnapchatEntityMap[T]>;
+    updateEntity<T extends SnapchatEntityType>(entityType: T, entityId: string, filters: Record<string, string>, data: Record<string, unknown>, context?: RequestContext): Promise<SnapchatEntityMap[T]>;
+    deleteEntity(entityType: SnapchatEntityType, entityId: string, context?: RequestContext): Promise<unknown>;
+    updateEntityStatus<T extends SnapchatEntityType>(entityType: T, entityId: string, status: "ACTIVE" | "PAUSED", filters?: Record<string, string>, context?: RequestContext): Promise<SnapchatEntityMap[T]>;
+    listAdAccounts(context?: RequestContext): Promise<{
+        entities: SnapchatAdAccount[];
+        nextCursor?: string;
+    }>;
+    adjustBids(adjustments: Array<{
+        adGroupId: string;
+        bidPrice: number;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            adGroupId: string;
+            success: boolean;
+            previousBid?: number;
+            newBid?: number;
+            error?: string;
+        }>;
+    }>;
+    bulkCreateEntities(entityType: SnapchatEntityType, filters: Record<string, string>, items: Record<string, unknown>[], context?: RequestContext): Promise<{
+        results: Array<{
+            success: boolean;
+            entity?: unknown;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateEntities(entityType: SnapchatEntityType, filters: Record<string, string>, items: Array<{
+        entityId: string;
+        data: Record<string, unknown>;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateStatus(entityType: SnapchatEntityType, filters: Record<string, string>, entityIds: string[], status: "ACTIVE" | "PAUSED", context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    searchTargeting(targetingType: string, countryCode: string | undefined, query?: string, limit?: number, context?: RequestContext): Promise<{
+        results: Record<string, unknown>[];
+        nextCursor?: string;
+    }>;
+    getTargetingOptions(targetingType?: string, countryCode?: string, limit?: number, context?: RequestContext): Promise<{
+        results: Record<string, unknown>[];
+        nextCursor?: string;
+    }>;
+    getAudienceEstimate(targetingConfig: Record<string, unknown>, adAccountId?: string, context?: RequestContext): Promise<unknown>;
+    getCreativePreview(creativeId: string, context?: RequestContext): Promise<unknown>;
+}
+//# sourceMappingURL=snapchat-service.d.ts.map

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

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