@cesteral/amazon-dsp-mcp 1.0.0

package/dist/services/amazon-dsp/amazon-dsp-api-contract.js

@@ -0,0 +1,193 @@
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+export const AMAZON_DSP_ENTITY_ALIASES = {
+    campaign: "order",
+    adGroup: "lineItem",
+};
+export const AMAZON_DSP_ENTITY_CONTRACT = {
+    order: {
+        canonicalType: "order",
+        aliases: ["campaign"],
+        listPath: "/dsp/orders",
+        getPath: "/dsp/orders/{entityId}",
+        createPath: "/dsp/orders",
+        updatePath: "/dsp/orders/{entityId}",
+        createMediaType: "application/vnd.dsporders.v2.2+json",
+        updateMediaType: "application/vnd.dsporders.v2.2+json",
+        idField: "orderId",
+        responseKey: "orders",
+        listFilterParam: "advertiserId",
+        displayName: "Campaign / Order",
+        requiredOnCreate: [
+            { field: "name", expectedType: "string" },
+            { field: "advertiserId", expectedType: "string" },
+            { field: "startDateTime", expectedType: "string", hint: "ISO 8601 date-time string" },
+            { field: "endDateTime", expectedType: "string", hint: "ISO 8601 date-time string" },
+        ],
+        readOnlyFields: ["orderId", "creationDate", "lastUpdatedDate", "createdTime", "modifiedTime"],
+        notes: [
+            "Campaign management is backed by the order object in Amazon DSP.",
+            "Amazon released Performance+ support via the optional automatedAdGroupCreation field on the order object.",
+            "Budget and pacing fields vary by campaign type; keep payloads aligned with the specific campaign subtype in the Amazon reference.",
+        ],
+    },
+    lineItem: {
+        canonicalType: "lineItem",
+        aliases: ["adGroup"],
+        listPath: "/dsp/lineItems",
+        getPath: "/dsp/lineItems/{entityId}",
+        createPath: "/dsp/lineItems",
+        updatePath: "/dsp/lineItems/{entityId}",
+        createMediaType: "application/vnd.dsplineitems.v3.1+json",
+        updateMediaType: "application/vnd.dsplineitems.v3.1+json",
+        idField: "lineItemId",
+        responseKey: "lineItems",
+        listFilterParam: "orderId",
+        displayName: "Ad Group / Line Item",
+        requiredOnCreate: [
+            { field: "name", expectedType: "string" },
+            { field: "orderId", expectedType: "string", hint: "Parent campaign / order ID" },
+            { field: "advertiserId", expectedType: "string" },
+            {
+                field: "budget",
+                expectedType: "object",
+                hint: '{ budgetType: "DAILY" | "LIFETIME", budget: number }',
+            },
+        ],
+        readOnlyFields: [
+            "lineItemId",
+            "creationDate",
+            "lastUpdatedDate",
+            "createdTime",
+            "modifiedTime",
+        ],
+        notes: [
+            "Ad group management is backed by the line item object in Amazon DSP.",
+            "Targeting and optimization options vary by media type and tactic.",
+        ],
+    },
+    creative: {
+        canonicalType: "creative",
+        aliases: [],
+        listPath: "/dsp/creatives",
+        getPath: "/dsp/creatives/{entityId}",
+        createPath: "/dsp/creatives",
+        updatePath: "/dsp/creatives/{entityId}",
+        idField: "creativeId",
+        responseKey: "creatives",
+        listFilterParam: "advertiserId",
+        displayName: "Creative",
+        requiredOnCreate: [
+            { field: "name", expectedType: "string" },
+            { field: "advertiserId", expectedType: "string" },
+            {
+                field: "creativeType",
+                expectedType: "string",
+                hint: "Creative subtype accepted by Amazon DSP",
+            },
+        ],
+        readOnlyFields: [
+            "creativeId",
+            "creationDate",
+            "lastUpdatedDate",
+            "createdTime",
+            "modifiedTime",
+        ],
+        notes: [
+            "Creative creation depends on the underlying format and may require additional assets or subtype-specific fields.",
+            "Creative association to line items is modeled separately from creative asset creation.",
+            "Amazon DSP has no plain POST /dsp/creatives endpoint — writes are subtype-routed (/dsp/creatives/image, /video, /thirdParty, /rec) with their own vendor media types. The createPath/updatePath above are for read-side aggregation only; create/update via this service will not work until subtype routing is added.",
+        ],
+    },
+    target: {
+        canonicalType: "target",
+        aliases: [],
+        listPath: "/dsp/targets",
+        getPath: "/dsp/targets/{entityId}",
+        createPath: "/dsp/targets",
+        updatePath: "/dsp/targets/{entityId}",
+        idField: "targetId",
+        responseKey: "targets",
+        listFilterParam: "lineItemId",
+        displayName: "Target",
+        requiredOnCreate: [
+            { field: "lineItemId", expectedType: "string", hint: "Parent ad group / line item ID" },
+        ],
+        readOnlyFields: ["targetId", "creationDate", "lastUpdatedDate", "createdTime", "modifiedTime"],
+        notes: [
+            "The exact request shape depends on the targeting tactic and media type.",
+            "Use Amazon’s current targeting docs to choose the correct expression structure and targeting subtype fields.",
+        ],
+    },
+    creativeAssociation: {
+        canonicalType: "creativeAssociation",
+        aliases: [],
+        listPath: "/dsp/creativeAssociations",
+        getPath: "/dsp/creativeAssociations/{entityId}",
+        createPath: "/dsp/creativeAssociations",
+        updatePath: "/dsp/creativeAssociations/{entityId}",
+        idField: "creativeAssociationId",
+        responseKey: "creativeAssociations",
+        listFilterParam: "lineItemId",
+        displayName: "Creative Association",
+        requiredOnCreate: [
+            { field: "lineItemId", expectedType: "string", hint: "Parent ad group / line item ID" },
+            { field: "creativeId", expectedType: "string", hint: "Creative asset to associate" },
+        ],
+        readOnlyFields: [
+            "creativeAssociationId",
+            "creationDate",
+            "lastUpdatedDate",
+            "createdTime",
+            "modifiedTime",
+        ],
+        notes: [
+            "Creative associations link existing creative assets to delivery entities.",
+            "Amazon’s public launch notes mention creative association batch-read support; callers should prefer Amazon’s latest contract for high-volume association workflows.",
+        ],
+    },
+};
+export const AMAZON_DSP_CANONICAL_ENTITY_TYPES = Object.keys(AMAZON_DSP_ENTITY_CONTRACT);
+export const AMAZON_DSP_PUBLIC_ENTITY_TYPES = [
+    ...AMAZON_DSP_CANONICAL_ENTITY_TYPES,
+    "campaign",
+    "adGroup",
+];
+export const AMAZON_DSP_REPORTING_CONTRACT = {
+    submitPathTemplate: "/dsp/reports",
+    statusPathTemplate: "/dsp/reports/{reportId}",
+    statuses: ["IN_PROGRESS", "SUCCESS", "FAILURE"],
+    defaultTimeUnit: "DAILY",
+    reportTypes: [
+        "CAMPAIGN",
+        "INVENTORY",
+        "AUDIENCE",
+        "PRODUCTS",
+        "TECHNOLOGY",
+        "GEOGRAPHY",
+        "CONVERSION_SOURCE",
+    ],
+    dimensionsByType: {
+        CAMPAIGN: ["ORDER", "LINE_ITEM", "CREATIVE"],
+    },
+    knownMetrics: ["impressions", "totalCost", "viewableImpressions", "viewabilityRate"],
+    notes: [
+        "POST /dsp/reports body shape: { startDate (YYYYMMDD), endDate (YYYYMMDD), type (one of reportTypes), dimensions?: string[], metrics?: string (comma-separated), timeUnit?: 'DAILY' }.",
+        "Returns 202 with { reportId, type, format, status:'IN_PROGRESS', location:'', expiration } — poll GET /dsp/reports/{reportId} until status === 'SUCCESS' (returns presigned S3 download `location`) or 'FAILURE'.",
+        "Plain application/json Content-Type works — no vendor media type required (unlike entity writes).",
+        "Endpoint is NOT account-scoped — `accountId` is not part of the URL path. The Amazon-Advertising-API-Scope header still identifies the profile.",
+    ],
+};
+export function normalizeAmazonDspEntityType(entityType) {
+    if (entityType in AMAZON_DSP_ENTITY_CONTRACT) {
+        return entityType;
+    }
+    const aliased = AMAZON_DSP_ENTITY_ALIASES[entityType];
+    if (aliased) {
+        return aliased;
+    }
+    throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown Amazon DSP entity type: ${entityType}`);
+}
+export function getAmazonDspEntityContract(entityType) {
+    return AMAZON_DSP_ENTITY_CONTRACT[normalizeAmazonDspEntityType(entityType)];
+}
+//# sourceMappingURL=amazon-dsp-api-contract.js.map

package/dist/services/amazon-dsp/amazon-dsp-api-contract.js.map

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

package/dist/services/amazon-dsp/amazon-dsp-http-client.d.ts

@@ -0,0 +1,15 @@
+import type { AmazonDspAuthAdapter } from "../../auth/amazon-dsp-auth-adapter.js";
+import type { RequestContext } from "@cesteral/shared";
+export declare class AmazonDspHttpClient {
+    private readonly authAdapter;
+    private readonly profileId;
+    private readonly baseUrl;
+    private readonly logger;
+    constructor(authAdapter: AmazonDspAuthAdapter, profileId: string, baseUrl: string, logger: import("pino").Logger);
+    get(path: string, params?: Record<string, string>, context?: RequestContext, accept?: string): Promise<unknown>;
+    post(path: string, data?: Record<string, unknown>, context?: RequestContext, accept?: string, contentType?: string): Promise<unknown>;
+    put(path: string, data?: Record<string, unknown>, context?: RequestContext, contentType?: string): Promise<unknown>;
+    private buildUrl;
+    private executeRequest;
+}
+//# sourceMappingURL=amazon-dsp-http-client.d.ts.map

package/dist/services/amazon-dsp/amazon-dsp-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amazon-dsp-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/amazon-dsp/amazon-dsp-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAsDpE,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,WAAW,EAAE,oBAAoB,EACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM;IAO1C,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IAsBb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC;IAwBb,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC;IAiBnB,OAAO,CAAC,QAAQ;YAYF,cAAc;CAqC7B"}

package/dist/services/amazon-dsp/amazon-dsp-http-client.js

@@ -0,0 +1,138 @@
+import { fetchWithTimeout, executeWithRetry } from "@cesteral/shared";
+import { withAmazonDspApiSpan } from "../../utils/platform.js";
+const AMAZON_DSP_RETRY_CONFIG = {
+    maxRetries: 2,
+    initialBackoffMs: 2_000,
+    maxBackoffMs: 30_000,
+    timeoutMs: 30_000,
+    platformName: "AmazonDsp",
+    tokenExpiryHint: "Amazon DSP token expired. Regenerate via Login with Amazon.",
+};
+function isAmazonDspRetryable(status, _errorBody) {
+    return status >= 500;
+}
+function buildAmazonDspNextAction(status, _errorBody, defaultHint) {
+    if (status === 401) {
+        return "Renew the Amazon DSP access token via Login with Amazon (LWA) using the configured refresh token, then update AMAZON_DSP_ACCESS_TOKEN.";
+    }
+    if (status === 403) {
+        return "Verify the Amazon-Advertising-API-Scope (profileId) and ClientId headers correspond to a profile the user has access to. Use amazon_dsp_list_accounts to discover valid profileIds.";
+    }
+    if (status === 404) {
+        return "Verify the order/lineItem/creative ID with amazon_dsp_list_entities and the accountId with amazon_dsp_list_accounts.";
+    }
+    if (status === 429) {
+        return "Amazon DSP per-LwA-app quota tripped. Amazon does not send Retry-After; wait at least 5 minutes before retrying, and reduce request rate. /dsp/orders, /dsp/lineItems, /dsp/creatives have particularly tight rolling-window limits.";
+    }
+    return defaultHint;
+}
+export class AmazonDspHttpClient {
+    authAdapter;
+    profileId;
+    baseUrl;
+    logger;
+    constructor(authAdapter, profileId, baseUrl, logger) {
+        this.authAdapter = authAdapter;
+        this.profileId = profileId;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+    }
+    async get(path, params, context, accept) {
+        const url = this.buildUrl(path, params);
+        const headers = accept ? { Accept: accept } : undefined;
+        return this.executeRequest(url, context, { method: "GET", headers });
+    }
+    async post(path, data, context, accept, contentType) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify(data ?? {});
+        const headers = {
+            "Content-Type": contentType ?? "application/json",
+        };
+        if (accept) {
+            headers.Accept = accept;
+        }
+        else if (contentType) {
+            headers.Accept = contentType;
+        }
+        return this.executeRequest(url, context, {
+            method: "POST",
+            headers,
+            body,
+        });
+    }
+    async put(path, data, context, contentType) {
+        const url = this.buildUrl(path);
+        const body = JSON.stringify(data ?? {});
+        const headers = {
+            "Content-Type": contentType ?? "application/json",
+        };
+        if (contentType) {
+            headers.Accept = contentType;
+        }
+        return this.executeRequest(url, context, {
+            method: "PUT",
+            headers,
+            body,
+        });
+    }
+    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 withAmazonDspApiSpan(`api.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(AMAZON_DSP_RETRY_CONFIG, {
+                url,
+                fetchOptions: options,
+                context,
+                logger: this.logger,
+                fetchFn: fetchWithTimeout,
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    const headers = {
+                        ...normalizeHeaders(options?.headers),
+                        Authorization: `Bearer ${accessToken}`,
+                        "Amazon-Advertising-API-Scope": this.profileId,
+                    };
+                    if (options?.body && !headers["Content-Type"]) {
+                        headers["Content-Type"] = "application/json";
+                    }
+                    const clientId = this.authAdapter.clientId;
+                    if (clientId) {
+                        headers["Amazon-Advertising-API-ClientId"] = clientId;
+                    }
+                    return headers;
+                },
+                buildNextAction: buildAmazonDspNextAction,
+                isRetryable: isAmazonDspRetryable,
+            });
+        });
+    }
+}
+function normalizeHeaders(headers) {
+    if (!headers) {
+        return {};
+    }
+    if (headers instanceof Headers) {
+        return Object.fromEntries(headers.entries());
+    }
+    if (Array.isArray(headers)) {
+        return Object.fromEntries(headers);
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(headers)) {
+        normalized[key] = Array.isArray(value) ? value.join(", ") : String(value);
+    }
+    return normalized;
+}
+//# sourceMappingURL=amazon-dsp-http-client.js.map

package/dist/services/amazon-dsp/amazon-dsp-http-client.js.map

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

package/dist/services/amazon-dsp/amazon-dsp-reporting-service.d.ts

@@ -0,0 +1,63 @@
+import type { AmazonDspHttpClient } from "./amazon-dsp-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import type { Logger } from "pino";
+import { AMAZON_DSP_REPORTING_CONTRACT } from "./amazon-dsp-api-contract.js";
+export type ReportTaskStatus = (typeof AMAZON_DSP_REPORTING_CONTRACT.statuses)[number];
+interface ReportTaskCheckData {
+    reportId: string;
+    status: ReportTaskStatus;
+    location?: string;
+    type?: string;
+    format?: string;
+    statusDetails?: string;
+    expiration?: number;
+}
+export interface AmazonDspReportConfig {
+    startDate: string;
+    endDate: string;
+    type: string;
+    dimensions?: string[];
+    metrics?: string[];
+    timeUnit?: "DAILY" | "SUMMARY";
+}
+export declare class AmazonDspReportingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(rateLimiter: RateLimiter, httpClient: AmazonDspHttpClient, logger: Logger, pollIntervalMs?: number, maxPollAttempts?: number);
+    submitReport(reportConfig: AmazonDspReportConfig, context?: RequestContext): Promise<{
+        taskId: 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;
+        rawMimeType?: string;
+    }>;
+    getReport(reportConfig: AmazonDspReportConfig, maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+    getReportBreakdowns(reportConfig: AmazonDspReportConfig, breakdowns: string[], maxRowsOrContext?: number | RequestContext, context?: RequestContext): Promise<{
+        rows: string[][];
+        headers: string[];
+        totalRows: number;
+        taskId: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=amazon-dsp-reporting-service.d.ts.map

package/dist/services/amazon-dsp/amazon-dsp-reporting-service.d.ts.map

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

package/dist/services/amazon-dsp/amazon-dsp-reporting-service.js

@@ -0,0 +1,134 @@
+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";
+import { AMAZON_DSP_REPORTING_CONTRACT } from "./amazon-dsp-api-contract.js";
+function toCompactDate(isoDate) {
+    return /^\d{8}$/.test(isoDate) ? isoDate : isoDate.replace(/-/g, "");
+}
+export class AmazonDspReportingService {
+    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(`amazon_dsp:reporting`);
+        const body = {
+            startDate: toCompactDate(reportConfig.startDate),
+            endDate: toCompactDate(reportConfig.endDate),
+            type: reportConfig.type,
+            timeUnit: reportConfig.timeUnit ?? AMAZON_DSP_REPORTING_CONTRACT.defaultTimeUnit,
+        };
+        if (reportConfig.dimensions && reportConfig.dimensions.length > 0) {
+            body.dimensions = reportConfig.dimensions;
+        }
+        if (reportConfig.metrics && reportConfig.metrics.length > 0) {
+            body.metrics = reportConfig.metrics.join(",");
+        }
+        const result = (await this.httpClient.post(AMAZON_DSP_REPORTING_CONTRACT.submitPathTemplate, body, context));
+        return { taskId: result.reportId };
+    }
+    async pollReport(taskId, context) {
+        this.logger.debug({ taskId, maxPollAttempts: this.maxPollAttempts }, "Starting report poll");
+        const path = AMAZON_DSP_REPORTING_CONTRACT.statusPathTemplate.replace("{reportId}", encodeURIComponent(taskId));
+        try {
+            return await pollUntilComplete({
+                fetchStatus: async () => {
+                    await this.rateLimiter.consume(`amazon_dsp:reporting`);
+                    return (await this.httpClient.get(path, undefined, context));
+                },
+                isComplete: (r) => r.status === "SUCCESS",
+                isFailed: (r) => r.status === "FAILURE",
+                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(`amazon_dsp:reporting`);
+        const path = AMAZON_DSP_REPORTING_CONTRACT.statusPathTemplate.replace("{reportId}", encodeURIComponent(taskId));
+        const result = (await this.httpClient.get(path, undefined, context));
+        return {
+            taskId: result.reportId,
+            status: result.status,
+            downloadUrl: result.location,
+        };
+    }
+    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 Amazon DSP 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, `Amazon DSP report too large (${contentLength} bytes, limit ${DEFAULT_REPORT_MAX_SIZE_BYTES}). Use more restrictive filters or date ranges.`);
+        }
+        const text = await response.text();
+        const contentType = response.headers?.get("content-type") ?? "";
+        const looksLikeJson = contentType.includes("application/json") ||
+            text.trimStart().startsWith("[") ||
+            text.trimStart().startsWith("{");
+        const rawExtras = options.includeRawCsv
+            ? { rawCsv: text, rawMimeType: looksLikeJson ? "application/json" : "text/csv" }
+            : {};
+        if (looksLikeJson) {
+            const parsed = JSON.parse(text);
+            const data = Array.isArray(parsed) ? parsed : [parsed];
+            if (data.length === 0) {
+                return { rows: [], headers: [], totalRows: 0, ...rawExtras };
+            }
+            const headers = Object.keys(data[0]);
+            const totalRows = data.length;
+            const limitedData = data.slice(0, maxRows);
+            const rows = limitedData.map((row) => headers.map((h) => String(row[h] ?? "")));
+            return { rows, headers, totalRows, ...rawExtras };
+        }
+        if (text.replace(/^\uFEFF/, "").trim() === "") {
+            return { rows: [], headers: [], totalRows: 0, ...rawExtras };
+        }
+        const { headers, rows: recordRows } = parseCSV(text);
+        if (headers.length === 0 && recordRows.length === 0) {
+            return { rows: [], headers: [], totalRows: 0, ...rawExtras };
+        }
+        const limited = recordRows.slice(0, maxRows);
+        const rows = limited.map((record) => headers.map((h) => record[h] ?? ""));
+        return { rows, headers, totalRows: recordRows.length, ...rawExtras };
+    }
+    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 { taskId } = await this.submitReport(reportConfig, requestContext);
+        const taskResult = await this.pollReport(taskId, requestContext);
+        if (taskResult.status === "FAILURE") {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Amazon DSP report task ${taskId} failed`);
+        }
+        if (!taskResult.location) {
+            throw new McpError(JsonRpcErrorCode.InternalError, `Amazon DSP report task ${taskId} completed but has no download URL`);
+        }
+        const reportData = await this.downloadReport(taskResult.location, maxRows, requestContext);
+        return {
+            ...reportData,
+            taskId,
+        };
+    }
+    async getReportBreakdowns(reportConfig, breakdowns, maxRowsOrContext = DEFAULT_REPORT_MAX_ROWS, context) {
+        const configWithBreakdowns = {
+            ...reportConfig,
+            dimensions: [...(reportConfig.dimensions ?? []), ...breakdowns],
+        };
+        return this.getReport(configWithBreakdowns, maxRowsOrContext, context);
+    }
+}
+//# sourceMappingURL=amazon-dsp-reporting-service.js.map

package/dist/services/amazon-dsp/amazon-dsp-reporting-service.js.map

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