@cesteral/snapchat-mcp 1.0.0

package/dist/mcp-server/tools/definitions/validate-entity.tool.js

@@ -0,0 +1,204 @@
+import { z } from "zod";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { createValidateEntityTool } from "@cesteral/shared";
+const STATUS_VALUES = ["ACTIVE", "PAUSED"];
+const AD_SQUAD_TYPE_VALUES = ["SNAP_ADS"];
+const PLACEMENT_VALUES = ["SNAP_ADS", "CONTENT"];
+const AD_TYPE_VALUES = ["SNAP_AD"];
+const REQUIRED_FIELDS_CREATE = {
+    campaign: [
+        { field: "name", expectedType: "string" },
+        {
+            field: "status",
+            expectedType: "string",
+            hint: "ACTIVE or PAUSED",
+            suggestedValues: STATUS_VALUES,
+        },
+    ],
+    adGroup: [
+        { field: "campaign_id", expectedType: "string" },
+        { field: "name", expectedType: "string" },
+        {
+            field: "status",
+            expectedType: "string",
+            hint: "ACTIVE or PAUSED",
+            suggestedValues: STATUS_VALUES,
+        },
+        {
+            field: "type",
+            expectedType: "string",
+            hint: "e.g. SNAP_ADS",
+            suggestedValues: AD_SQUAD_TYPE_VALUES,
+        },
+        {
+            field: "placement",
+            expectedType: "string",
+            hint: "e.g. SNAP_ADS or CONTENT",
+            suggestedValues: PLACEMENT_VALUES,
+        },
+        { field: "optimization_goal", expectedType: "string" },
+        { field: "targeting", expectedType: "object" },
+    ],
+    ad: [
+        { field: "ad_squad_id", expectedType: "string" },
+        { field: "name", expectedType: "string" },
+        { field: "creative_id", expectedType: "string" },
+        {
+            field: "type",
+            expectedType: "string",
+            hint: "e.g. SNAP_AD",
+            suggestedValues: AD_TYPE_VALUES,
+        },
+        {
+            field: "status",
+            expectedType: "string",
+            hint: "ACTIVE or PAUSED",
+            suggestedValues: STATUS_VALUES,
+        },
+    ],
+    creative: [
+        { field: "name", expectedType: "string" },
+        { field: "type", expectedType: "string" },
+    ],
+};
+const READ_ONLY_FIELDS = ["created_at", "updated_at", "review_status", "delivery_status"];
+const BUDGET_FIELDS = [
+    "daily_budget_micro",
+    "lifetime_budget_micro",
+    "lifetime_spend_cap_micro",
+    "bid_micro",
+];
+export const validateEntityTool = createValidateEntityTool({
+    toolName: "snapchat_validate_entity",
+    toolTitle: "Snapchat Ads Entity Validation (Client-Side)",
+    toolDescription: `Validate an entity payload against known Snapchat Ads requirements without calling the API.
+
+Checks required fields, data types, and common configuration mistakes.
+
+**Supported entity types:** ${getEntityTypeEnum().join(", ")}
+
+This is a pure client-side check — it catches missing required fields and
+obvious type errors. The Snapchat API may still reject payloads for business-rule
+reasons (e.g., invalid objective/placement combinations).`,
+    entityTypeEnum: getEntityTypeEnum(),
+    rulesByEntity: REQUIRED_FIELDS_CREATE,
+    readOnlyFields: READ_ONLY_FIELDS,
+    extraInputSchema: {
+        adAccountId: z.string().optional().describe("Advertiser ID (recommended for create mode)"),
+        campaignId: z.string().optional().describe("Campaign ID required for adGroup updates"),
+        adSquadId: z.string().optional().describe("Ad Squad ID required for ad updates"),
+    },
+    extraValidate: ({ entityType, mode, data, extra, issues }) => {
+        if (mode === "create") {
+            if (entityType === "campaign" &&
+                data.daily_budget_micro === undefined &&
+                data.lifetime_spend_cap_micro === undefined) {
+                issues.push({
+                    field: "daily_budget_micro",
+                    code: "missing",
+                    message: 'Campaign create requires either "daily_budget_micro" or "lifetime_spend_cap_micro"',
+                    suggestedValues: ["daily_budget_micro", "lifetime_spend_cap_micro"],
+                    severity: "error",
+                });
+            }
+            if (entityType === "adGroup" &&
+                data.daily_budget_micro === undefined &&
+                data.lifetime_budget_micro === undefined) {
+                issues.push({
+                    field: "daily_budget_micro",
+                    code: "missing",
+                    message: 'Ad group create requires either "daily_budget_micro" or "lifetime_budget_micro"',
+                    suggestedValues: ["daily_budget_micro", "lifetime_budget_micro"],
+                    severity: "error",
+                });
+            }
+        }
+        if (mode === "update") {
+            if (Object.keys(data).length === 0) {
+                issues.push({
+                    field: "data",
+                    code: "custom",
+                    message: "Update payload must contain at least one field to update",
+                    severity: "error",
+                });
+            }
+            if (entityType === "adGroup" && !extra.campaignId) {
+                issues.push({
+                    field: "campaignId",
+                    code: "missing",
+                    message: "campaignId is required to route adGroup updates",
+                    severity: "error",
+                });
+            }
+            if (entityType === "ad" && !extra.adSquadId) {
+                issues.push({
+                    field: "adSquadId",
+                    code: "missing",
+                    message: "adSquadId is required to route ad updates",
+                    severity: "error",
+                });
+            }
+        }
+        for (const budgetField of BUDGET_FIELDS) {
+            const budgetValue = data[budgetField];
+            if (typeof budgetValue === "number" && budgetValue <= 0) {
+                issues.push({
+                    field: budgetField,
+                    code: "invalidValue",
+                    message: `Field "${budgetField}" must be a positive number`,
+                    severity: "error",
+                });
+            }
+        }
+        const errorIssues = issues.filter((i) => i.severity !== "warning");
+        if (errorIssues.length === 0)
+            return;
+        if (entityType === "adGroup" && errorIssues.some((i) => i.field === "campaign_id")) {
+            return {
+                nextAction: "Call snapchat_list_entities with entityType='campaign' to find a campaign_id for the parent campaign.",
+            };
+        }
+        if (entityType === "ad" && errorIssues.some((i) => i.field === "ad_squad_id")) {
+            return {
+                nextAction: "Call snapchat_list_entities with entityType='adGroup' to find an ad_squad_id (ad squads are listed as adGroup entities).",
+            };
+        }
+        if (errorIssues.some((i) => i.field === "ad_account_id")) {
+            return {
+                nextAction: "Call snapchat_list_ad_accounts to discover valid ad_account_id values.",
+            };
+        }
+        return {
+            nextAction: `Call snapchat_list_entities with entityType='${entityType}' to inspect existing examples.`,
+        };
+    },
+    inputExamples: [
+        {
+            label: "Valid campaign create",
+            input: {
+                entityType: "campaign",
+                mode: "create",
+                adAccountId: "1234567890",
+                data: {
+                    name: "Summer Sale 2026",
+                    objective: "WEB_CONVERSION",
+                    status: "ACTIVE",
+                    daily_budget_micro: 100000000,
+                },
+            },
+        },
+        {
+            label: "Missing required fields (ad group)",
+            input: {
+                entityType: "adGroup",
+                mode: "create",
+                adAccountId: "1234567890",
+                data: { name: "Test Ad Group" },
+            },
+        },
+    ],
+});
+export const ValidateEntityInputSchema = validateEntityTool.inputSchema;
+export const ValidateEntityOutputSchema = validateEntityTool.outputSchema;
+export const validateEntityLogic = validateEntityTool.logic;
+//# sourceMappingURL=validate-entity.tool.js.map

package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/validate-entity.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { allTools } from "./definitions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/tools/index.js

@@ -0,0 +1,2 @@
+export { allTools } from "./definitions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mcp-server/tools/utils/entity-mapping.d.ts

@@ -0,0 +1,18 @@
+export type SnapchatEntityType = "campaign" | "adGroup" | "ad" | "creative";
+export interface SnapchatEntityConfig {
+    listPath: string;
+    createPath: string;
+    getPath: string;
+    updatePath: string;
+    deletePath: string;
+    idField: string;
+    responseKey: string;
+    entityKey: string;
+    displayName: string;
+    defaultFields: string[];
+}
+export declare function getEntityConfig(entityType: SnapchatEntityType): SnapchatEntityConfig;
+export declare function getSupportedEntityTypes(): SnapchatEntityType[];
+export declare function getEntityTypeEnum(): [string, ...string[]];
+export declare function interpolatePath(path: string, params: Record<string, string>): string;
+//# sourceMappingURL=entity-mapping.d.ts.map

package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IAEnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAgFD,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,oBAAoB,CASpF;AAED,wBAAgB,uBAAuB,IAAI,kBAAkB,EAAE,CAE9D;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD;AAOD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEpF"}

package/dist/mcp-server/tools/utils/entity-mapping.js

@@ -0,0 +1,96 @@
+import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
+const ENTITY_CONFIGS = {
+    campaign: {
+        listPath: "/v1/adaccounts/{adAccountId}/campaigns",
+        createPath: "/v1/adaccounts/{adAccountId}/campaigns",
+        getPath: "/v1/campaigns/{entityId}",
+        updatePath: "/v1/adaccounts/{adAccountId}/campaigns",
+        deletePath: "/v1/campaigns/{entityId}",
+        idField: "id",
+        responseKey: "campaigns",
+        entityKey: "campaign",
+        displayName: "Campaign",
+        defaultFields: [
+            "id",
+            "name",
+            "status",
+            "ad_account_id",
+            "objective",
+            "daily_budget_micro",
+            "lifetime_spend_cap_micro",
+            "start_time",
+            "end_time",
+        ],
+    },
+    adGroup: {
+        listPath: "/v1/campaigns/{campaignId}/adsquads",
+        createPath: "/v1/campaigns/{campaignId}/adsquads",
+        getPath: "/v1/adsquads/{entityId}",
+        updatePath: "/v1/campaigns/{campaignId}/adsquads",
+        deletePath: "/v1/adsquads/{entityId}",
+        idField: "id",
+        responseKey: "adsquads",
+        entityKey: "adsquad",
+        displayName: "Ad Squad",
+        defaultFields: [
+            "id",
+            "name",
+            "status",
+            "campaign_id",
+            "daily_budget_micro",
+            "bid_micro",
+            "optimization_goal",
+            "placement",
+        ],
+    },
+    ad: {
+        listPath: "/v1/adsquads/{adSquadId}/ads",
+        createPath: "/v1/adsquads/{adSquadId}/ads",
+        getPath: "/v1/ads/{entityId}",
+        updatePath: "/v1/adsquads/{adSquadId}/ads",
+        deletePath: "/v1/ads/{entityId}",
+        idField: "id",
+        responseKey: "ads",
+        entityKey: "ad",
+        displayName: "Ad",
+        defaultFields: ["id", "name", "status", "ad_squad_id", "creative_id", "type"],
+    },
+    creative: {
+        listPath: "/v1/adaccounts/{adAccountId}/creatives",
+        createPath: "/v1/adaccounts/{adAccountId}/creatives",
+        getPath: "/v1/creatives/{entityId}",
+        updatePath: "/v1/adaccounts/{adAccountId}/creatives",
+        deletePath: "/v1/creatives/{entityId}",
+        idField: "id",
+        responseKey: "creatives",
+        entityKey: "creative",
+        displayName: "Creative",
+        defaultFields: [
+            "id",
+            "name",
+            "type",
+            "ad_account_id",
+            "brand_name",
+            "headline",
+            "call_to_action",
+        ],
+    },
+};
+export function getEntityConfig(entityType) {
+    const config = ENTITY_CONFIGS[entityType];
+    if (!config) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown Snapchat entity type: ${entityType}`);
+    }
+    return config;
+}
+export function getSupportedEntityTypes() {
+    return Object.keys(ENTITY_CONFIGS);
+}
+export function getEntityTypeEnum() {
+    const types = getSupportedEntityTypes();
+    return types;
+}
+export function interpolatePath(path, params) {
+    return Object.entries(params).reduce((acc, [key, val]) => acc.replace(`{${key}}`, val), path);
+}
+//# sourceMappingURL=entity-mapping.js.map

package/dist/mcp-server/tools/utils/entity-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAuC9D,MAAM,cAAc,GAAqD;IACvE,QAAQ,EAAE;QACR,QAAQ,EAAE,wCAAwC;QAClD,UAAU,EAAE,wCAAwC;QACpD,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,wCAAwC;QACpD,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,WAAW;QACxB,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE;YACb,IAAI;YACJ,MAAM;YACN,QAAQ;YACR,eAAe;YACf,WAAW;YACX,oBAAoB;YACpB,0BAA0B;YAC1B,YAAY;YACZ,UAAU;SACX;KACF;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,qCAAqC;QAC/C,UAAU,EAAE,qCAAqC;QACjD,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,qCAAqC;QACjD,UAAU,EAAE,yBAAyB;QACrC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE;YACb,IAAI;YACJ,MAAM;YACN,QAAQ;YACR,aAAa;YACb,oBAAoB;YACpB,WAAW;YACX,mBAAmB;YACnB,WAAW;SACZ;KACF;IACD,EAAE,EAAE;QACF,QAAQ,EAAE,8BAA8B;QACxC,UAAU,EAAE,8BAA8B;QAC1C,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,8BAA8B;QAC1C,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC;KAC9E;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,wCAAwC;QAClD,UAAU,EAAE,wCAAwC;QACpD,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,wCAAwC;QACpD,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,WAAW;QACxB,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE;YACb,IAAI;YACJ,MAAM;YACN,MAAM;YACN,eAAe;YACf,YAAY;YACZ,UAAU;YACV,gBAAgB;SACjB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,UAA8B;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,iCAAiC,UAAU,EAAE,CAC9C,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAyB,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;IACxC,OAAO,KAA8B,CAAC;AACxC,CAAC;AAOD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAA8B;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAChG,CAAC"}

package/dist/mcp-server/tools/utils/media-types.d.ts

@@ -0,0 +1,19 @@
+export interface SnapchatMediaItem {
+    id?: string;
+    media_status?: string;
+}
+export interface SnapchatMediaUploadResponse {
+    request_status?: string;
+    media?: Array<{
+        sub_request_status?: string;
+        media?: SnapchatMediaItem;
+    }>;
+}
+export interface SnapchatMediaGetResponse {
+    request_status?: string;
+    media?: Array<{
+        sub_request_status?: string;
+        media?: SnapchatMediaItem;
+    }>;
+}
+//# sourceMappingURL=media-types.d.ts.map

package/dist/mcp-server/tools/utils/media-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-types.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/media-types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,CAAC,CAAC;CACJ"}

package/dist/mcp-server/tools/utils/media-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=media-types.js.map

package/dist/mcp-server/tools/utils/media-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-types.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/media-types.ts"],"names":[],"mappings":""}

package/dist/mcp-server/tools/utils/resolve-session.d.ts

@@ -0,0 +1,4 @@
+import { type SessionServices } from "../../../services/session-services.js";
+import type { SdkContext } from "@cesteral/shared";
+export declare function resolveSessionServices(sdkContext?: SdkContext): SessionServices;
+//# sourceMappingURL=resolve-session.d.ts.map

package/dist/mcp-server/tools/utils/resolve-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,eAAe,CAE/E"}

package/dist/mcp-server/tools/utils/resolve-session.js

@@ -0,0 +1,6 @@
+import { resolveSessionServicesFromStore } from "@cesteral/shared";
+import { sessionServiceStore } from "../../../services/session-services.js";
+export function resolveSessionServices(sdkContext) {
+    return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/mcp-server/tools/utils/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

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

@@ -0,0 +1,61 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "snapchat-bearer" | "jwt" | "none";
+    snapchatApiBaseUrl: string;
+    snapchatApiVersion: string;
+    snapchatRateLimitPerMinute: number;
+    snapchatReportPollIntervalMs: number;
+    snapchatReportMaxPollAttempts: number;
+    snapchatVideoUploadPollIntervalMs: number;
+    snapchatVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    snapchatAccessToken?: string | undefined;
+    snapchatAdAccountId?: string | undefined;
+    snapchatOrgId?: string | undefined;
+    snapchatAppId?: string | undefined;
+    snapchatAppSecret?: string | undefined;
+    snapchatRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "snapchat-bearer" | "jwt" | "none";
+    snapchatApiBaseUrl: string;
+    snapchatApiVersion: string;
+    snapchatRateLimitPerMinute: number;
+    snapchatReportPollIntervalMs: number;
+    snapchatReportMaxPollAttempts: number;
+    snapchatVideoUploadPollIntervalMs: number;
+    snapchatVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    snapchatAccessToken?: string | undefined;
+    snapchatAdAccountId?: string | undefined;
+    snapchatOrgId?: string | undefined;
+    snapchatAppId?: string | undefined;
+    snapchatAppSecret?: string | undefined;
+    snapchatRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

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

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

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

@@ -0,0 +1,105 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { SnapchatBearerAuthStrategy } from "../../auth/snapchat-auth-strategy.js";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: config.mcpAuthMode === "snapchat-bearer"
+            ? new SnapchatBearerAuthStrategy(config.snapchatApiBaseUrl, logger)
+            : createAuthStrategy(config.mcpAuthMode, {
+                jwtSecret: config.mcpAuthSecretKey,
+                logger,
+            }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "X-Snapchat-Advertiser-Id",
+            "X-Snapchat-Org-Id",
+            "X-Snapchat-App-Id",
+            "X-Snapchat-App-Secret",
+            "X-Snapchat-Refresh-Token",
+        ],
+        authErrorHint: config.mcpAuthMode === "snapchat-bearer"
+            ? "Provide a Snapchat access token via Authorization: Bearer <token> header and ad account ID via X-Snapchat-Advertiser-Id header."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.platformAuthAdapter;
+            if (adapter) {
+                const cfg = appConfig;
+                const services = createSessionServices(adapter, {
+                    baseUrl: cfg.snapchatApiBaseUrl,
+                    reportPollIntervalMs: cfg.snapchatReportPollIntervalMs,
+                    reportMaxPollAttempts: cfg.snapchatReportMaxPollAttempts,
+                }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
+                const cfg = appConfig;
+                const snapchatAdAccountId = cfg.snapchatAdAccountId;
+                if (cfg.snapchatAppId &&
+                    cfg.snapchatAppSecret &&
+                    cfg.snapchatRefreshToken &&
+                    snapchatAdAccountId) {
+                    const { SnapchatRefreshTokenAdapter } = await import("../../auth/snapchat-auth-adapter.js");
+                    const envAdapter = new SnapchatRefreshTokenAdapter({
+                        appId: cfg.snapchatAppId,
+                        appSecret: cfg.snapchatAppSecret,
+                        refreshToken: cfg.snapchatRefreshToken,
+                    }, snapchatAdAccountId, cfg.snapchatApiBaseUrl, cfg.snapchatOrgId ?? "");
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfg.snapchatApiBaseUrl,
+                        reportPollIntervalMs: cfg.snapchatReportPollIntervalMs,
+                        reportMaxPollAttempts: cfg.snapchatReportMaxPollAttempts,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                const snapchatToken = cfg.snapchatAccessToken;
+                if (snapchatToken && snapchatAdAccountId) {
+                    const { SnapchatAccessTokenAdapter } = await import("../../auth/snapchat-auth-adapter.js");
+                    const envAdapter = new SnapchatAccessTokenAdapter(snapchatToken, snapchatAdAccountId, cfg.snapchatApiBaseUrl, cfg.snapchatOrgId ?? "");
+                    await envAdapter.validate();
+                    const cfgFallback = appConfig;
+                    const services = createSessionServices(envAdapter, {
+                        baseUrl: cfgFallback.snapchatApiBaseUrl,
+                        reportPollIntervalMs: cfgFallback.snapchatReportPollIntervalMs,
+                        reportMaxPollAttempts: cfgFallback.snapchatReportMaxPollAttempts,
+                    }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (appConfig.mcpAuthMode !== "none") {
+                    return {
+                        services: null,
+                        error: {
+                            message: "Snapchat access token and ad account ID required. Set SNAPCHAT_ACCESS_TOKEN and SNAPCHAT_AD_ACCOUNT_ID env vars, or use MCP_AUTH_MODE=snapchat-bearer.",
+                            status: 400,
+                        },
+                    };
+                }
+                return { services: null };
+            }
+            return {
+                services: null,
+                error: {
+                    message: "Snapchat API credentials required for this server.",
+                    status: 400,
+                },
+            };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("snapchat-mcp"),
+    };
+}
+export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
+//# sourceMappingURL=streamable-http-transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAGlB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,SAAS,mBAAmB,CAAC,MAAiB,EAAE,MAAc;IAC5D,OAAO;QACL,YAAY,EACV,MAAM,CAAC,WAAW,KAAK,iBAAiB;YACtC,CAAC,CAAC,IAAI,0BAA0B,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC;YACnE,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAuB,EAAE;gBACjD,SAAS,EAAE,MAAM,CAAC,gBAAgB;gBAClC,MAAM;aACP,CAAC;QACR,gBAAgB,EAAE;YAChB,cAAc;YACd,eAAe;YACf,gBAAgB;YAChB,sBAAsB;YACtB,0BAA0B;YAC1B,mBAAmB;YACnB,mBAAmB;YACnB,uBAAuB;YACvB,0BAA0B;SAC3B;QACD,aAAa,EACX,MAAM,CAAC,WAAW,KAAK,iBAAiB;YACtC,CAAC,CAAC,iIAAiI;YACnI,CAAC,CAAC,2DAA2D;QACjE,mBAAmB;QACnB,WAAW;QACX,KAAK,CAAC,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG;YAE9D,MAAM,OAAO,GAAG,UAAU,CAAC,mBAAsD,CAAC;YAClF,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,SAAsB,CAAC;gBACnC,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,EACP;oBACE,OAAO,EAAE,GAAG,CAAC,kBAAkB;oBAC/B,oBAAoB,EAAE,GAAG,CAAC,4BAA4B;oBACtD,qBAAqB,EAAE,GAAG,CAAC,6BAA6B;iBACzD,EACD,GAAG,EACH,WAAW,CACZ,CAAC;gBACF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;gBAC/E,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,CAAC;YAGD,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,IAAI,SAAS,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;gBACxE,MAAM,GAAG,GAAG,SAAsB,CAAC;gBACnC,MAAM,mBAAmB,GAAG,GAAG,CAAC,mBAAmB,CAAC;gBAGpD,IACE,GAAG,CAAC,aAAa;oBACjB,GAAG,CAAC,iBAAiB;oBACrB,GAAG,CAAC,oBAAoB;oBACxB,mBAAmB,EACnB,CAAC;oBACD,MAAM,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAClD,qCAAqC,CACtC,CAAC;oBACF,MAAM,UAAU,GAAG,IAAI,2BAA2B,CAChD;wBACE,KAAK,EAAE,GAAG,CAAC,aAAa;wBACxB,SAAS,EAAE,GAAG,CAAC,iBAAiB;wBAChC,YAAY,EAAE,GAAG,CAAC,oBAAoB;qBACvC,EACD,mBAAmB,EACnB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,aAAa,IAAI,EAAE,CACxB,CAAC;oBACF,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;oBAC5B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,UAAU,EACV;wBACE,OAAO,EAAE,GAAG,CAAC,kBAAkB;wBAC/B,oBAAoB,EAAE,GAAG,CAAC,4BAA4B;wBACtD,qBAAqB,EAAE,GAAG,CAAC,6BAA6B;qBACzD,EACD,GAAG,EACH,WAAW,CACZ,CAAC;oBACF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;oBAC/E,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,CAAC;gBAGD,MAAM,aAAa,GAAG,GAAG,CAAC,mBAAmB,CAAC;gBAC9C,IAAI,aAAa,IAAI,mBAAmB,EAAE,CAAC;oBACzC,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CACjD,qCAAqC,CACtC,CAAC;oBACF,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAC/C,aAAa,EACb,mBAAmB,EACnB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,aAAa,IAAI,EAAE,CACxB,CAAC;oBACF,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;oBAC5B,MAAM,WAAW,GAAG,SAAsB,CAAC;oBAC3C,MAAM,QAAQ,GAAG,qBAAqB,CACpC,UAAU,EACV;wBACE,OAAO,EAAE,WAAW,CAAC,kBAAkB;wBACvC,oBAAoB,EAAE,WAAW,CAAC,4BAA4B;wBAC9D,qBAAqB,EAAE,WAAW,CAAC,6BAA6B;qBACjE,EACD,GAAG,EACH,WAAW,CACZ,CAAC;oBACF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;oBAC/E,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtB,CAAC;gBACD,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;oBACrC,OAAO;wBACL,QAAQ,EAAE,IAAI;wBACd,KAAK,EAAE;4BACL,OAAO,EACL,wJAAwJ;4BAC1J,MAAM,EAAE,GAAY;yBACrB;qBACF,CAAC;gBACJ,CAAC;gBAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5B,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,OAAO,EAAE,oDAAoD;oBAC7D,MAAM,EAAE,GAAY;iBACrB;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS;YAC7C,OAAO,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,eAAe,EAAE,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ;QAC3E,UAAU,EAAE,qBAAqB,CAAC,cAAc,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,GACnD,0BAA0B,CAAY,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { Logger } from "pino";
+import type { SnapchatAuthAdapter } from "../auth/snapchat-auth-adapter.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { ReportCsvStore, SessionServiceStore } from "@cesteral/shared";
+export { SessionServiceStore } from "@cesteral/shared";
+import { SnapchatService } from "./snapchat/snapchat-service.js";
+import { SnapchatReportingService } from "./snapchat/snapchat-reporting-service.js";
+export interface SessionServices {
+    snapchatService: SnapchatService;
+    snapchatReportingService: SnapchatReportingService;
+}
+export interface SnapchatSessionConfig {
+    baseUrl: string;
+    reportPollIntervalMs: number;
+    reportMaxPollAttempts: number;
+}
+export declare function createSessionServices(authAdapter: SnapchatAuthAdapter, config: SnapchatSessionConfig, logger: Logger, rateLimiter: RateLimiter): SessionServices;
+export declare const sessionServiceStore: SessionServiceStore<SessionServices>;
+export declare const reportCsvStore: ReportCsvStore;
+//# sourceMappingURL=session-services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-services.d.ts","sourceRoot":"","sources":["../../src/services/session-services.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAEL,cAAc,EACd,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,wBAAwB,EAAE,wBAAwB,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,eAAe,CAqBjB;AAED,eAAO,MAAM,mBAAmB,sCAA6C,CAAC;AAO9E,eAAO,MAAM,cAAc,gBAIzB,CAAC"}

package/dist/services/session-services.js

@@ -0,0 +1,23 @@
+import { deleteSpilledObjectsForSession, ReportCsvStore, SessionServiceStore, } from "@cesteral/shared";
+export { SessionServiceStore } from "@cesteral/shared";
+import { SnapchatHttpClient } from "./snapchat/snapchat-http-client.js";
+import { SnapchatService } from "./snapchat/snapchat-service.js";
+import { SnapchatReportingService } from "./snapchat/snapchat-reporting-service.js";
+export function createSessionServices(authAdapter, config, logger, rateLimiter) {
+    const httpClient = new SnapchatHttpClient(authAdapter, config.baseUrl, logger);
+    const snapchatService = new SnapchatService(httpClient, authAdapter.orgId, authAdapter.adAccountId, rateLimiter);
+    const snapchatReportingService = new SnapchatReportingService(rateLimiter, httpClient, authAdapter.adAccountId, logger, config.reportPollIntervalMs, config.reportMaxPollAttempts);
+    return {
+        snapchatService,
+        snapchatReportingService,
+    };
+}
+export const sessionServiceStore = new SessionServiceStore();
+export const reportCsvStore = new ReportCsvStore({
+    mirror: { bucketResolver: () => process.env.REPORT_SPILL_BUCKET },
+});
+sessionServiceStore.onDelete((sessionId) => {
+    void deleteSpilledObjectsForSession("snapchat", sessionId);
+    reportCsvStore.clearForSession(sessionId);
+});
+//# sourceMappingURL=session-services.js.map