@cesteral/snapchat-mcp 1.0.0

package/dist/auth/snapchat-auth-adapter.js

@@ -0,0 +1,127 @@
+import { extractHeader, fetchWithTimeout, fingerprintCredentials, JsonRpcErrorCode, McpError, OAuth2RefreshAdapterBase, } from "@cesteral/shared";
+async function fetchSnapchatUserId(token, baseUrl) {
+    const response = await fetchWithTimeout(`${baseUrl}/v1/me`, 10_000, undefined, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => "");
+        throw new McpError(JsonRpcErrorCode.Unauthorized, `Snapchat token validation HTTP error: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
+    }
+    const data = (await response.json());
+    return data.me?.id ?? "unknown";
+}
+export class SnapchatAccessTokenAdapter {
+    accessToken;
+    _adAccountId;
+    baseUrl;
+    _orgId;
+    validated = false;
+    _userId = "";
+    constructor(accessToken, _adAccountId, baseUrl = "https://adsapi.snapchat.com", _orgId = "") {
+        this.accessToken = accessToken;
+        this._adAccountId = _adAccountId;
+        this.baseUrl = baseUrl;
+        this._orgId = _orgId;
+    }
+    get userId() {
+        return this._userId;
+    }
+    get adAccountId() {
+        return this._adAccountId;
+    }
+    get orgId() {
+        return this._orgId;
+    }
+    async getAccessToken() {
+        return this.accessToken;
+    }
+    async validate() {
+        if (this.validated)
+            return;
+        this._userId = await fetchSnapchatUserId(this.accessToken, this.baseUrl);
+        this.validated = true;
+    }
+}
+export class SnapchatRefreshTokenAdapter extends OAuth2RefreshAdapterBase {
+    _adAccountId;
+    baseUrl;
+    _orgId;
+    _userId = "";
+    constructor(credentials, _adAccountId, baseUrl = "https://adsapi.snapchat.com", _orgId = "") {
+        super({
+            platformName: "Snapchat",
+            credentials,
+            requestToken: async (refreshToken) => {
+                const response = await fetchWithTimeout("https://accounts.snapchat.com/login/oauth2/access_token", 10_000, undefined, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+                    body: new URLSearchParams({
+                        grant_type: "refresh_token",
+                        client_id: credentials.appId,
+                        client_secret: credentials.appSecret,
+                        refresh_token: refreshToken,
+                    }).toString(),
+                });
+                if (!response.ok) {
+                    const errorBody = await response.text().catch(() => "");
+                    throw new McpError(JsonRpcErrorCode.InternalError, `Snapchat token refresh failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
+                }
+                return (await response.json());
+            },
+        });
+        this._adAccountId = _adAccountId;
+        this.baseUrl = baseUrl;
+        this._orgId = _orgId;
+    }
+    get userId() {
+        return this._userId;
+    }
+    get adAccountId() {
+        return this._adAccountId;
+    }
+    get orgId() {
+        return this._orgId;
+    }
+    async validate() {
+        const token = await this.getAccessToken();
+        this._userId = await fetchSnapchatUserId(token, this.baseUrl);
+    }
+}
+export function parseSnapchatRefreshCredentialsFromHeaders(headers) {
+    const appId = extractHeader(headers, "x-snapchat-app-id");
+    const appSecret = extractHeader(headers, "x-snapchat-app-secret");
+    const refreshToken = extractHeader(headers, "x-snapchat-refresh-token");
+    if (!appId || !appSecret || !refreshToken) {
+        return undefined;
+    }
+    return { appId, appSecret, refreshToken };
+}
+export function parseSnapchatTokenFromHeaders(headers) {
+    const authHeader = extractHeader(headers, "authorization");
+    if (!authHeader) {
+        throw new McpError(JsonRpcErrorCode.Unauthorized, "Missing required Authorization header");
+    }
+    const match = authHeader.match(/^Bearer\s+(.+)$/i);
+    if (!match || !match[1]) {
+        throw new McpError(JsonRpcErrorCode.Unauthorized, "Authorization header must use Bearer scheme");
+    }
+    return match[1];
+}
+export function getSnapchatAdvertiserIdFromHeaders(headers) {
+    const adAccountId = extractHeader(headers, "x-snapchat-advertiser-id");
+    if (!adAccountId) {
+        throw new McpError(JsonRpcErrorCode.InvalidRequest, "Missing required X-Snapchat-Advertiser-Id header");
+    }
+    return adAccountId;
+}
+export function getSnapchatOrgIdFromHeaders(headers) {
+    return extractHeader(headers, "x-snapchat-org-id") ?? "";
+}
+export function getSnapchatCredentialFingerprint(accessToken, adAccountId) {
+    return fingerprintCredentials(accessToken, adAccountId);
+}
+//# sourceMappingURL=snapchat-auth-adapter.js.map

package/dist/auth/snapchat-auth-adapter.js.map

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

package/dist/auth/snapchat-auth-strategy.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from "pino";
+import { BearerAuthStrategyBase, type BearerAdapterResult } from "@cesteral/shared";
+export declare class SnapchatBearerAuthStrategy extends BearerAuthStrategyBase {
+    private readonly baseUrl;
+    protected readonly authType = "snapchat-bearer";
+    protected readonly platformName = "Snapchat";
+    constructor(baseUrl: string, logger?: Logger);
+    protected resolveRefreshBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult | null>;
+    protected resolveAccessBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult>;
+    protected getRefreshFingerprint(headers: Record<string, string | string[] | undefined>): string | undefined;
+    protected getTokenFingerprint(headers: Record<string, string | string[] | undefined>): string;
+}
+//# sourceMappingURL=snapchat-auth-strategy.d.ts.map

package/dist/auth/snapchat-auth-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapchat-auth-strategy.d.ts","sourceRoot":"","sources":["../../src/auth/snapchat-auth-strategy.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAWpF,qBAAa,0BAA2B,SAAQ,sBAAsB;IAKlE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,SAAS,CAAC,QAAQ,CAAC,QAAQ,qBAAqB;IAChD,SAAS,CAAC,QAAQ,CAAC,YAAY,cAAc;gBAG1B,OAAO,EAAE,MAAM,EAChC,MAAM,CAAC,EAAE,MAAM;cAKD,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;cAmBtB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS;IAOrB,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM;CAK9F"}

package/dist/auth/snapchat-auth-strategy.js

@@ -0,0 +1,54 @@
+import { BearerAuthStrategyBase } from "@cesteral/shared";
+import { SnapchatAccessTokenAdapter, SnapchatRefreshTokenAdapter, parseSnapchatTokenFromHeaders, parseSnapchatRefreshCredentialsFromHeaders, getSnapchatAdvertiserIdFromHeaders, getSnapchatOrgIdFromHeaders, getSnapchatCredentialFingerprint, } from "./snapchat-auth-adapter.js";
+export class SnapchatBearerAuthStrategy extends BearerAuthStrategyBase {
+    baseUrl;
+    authType = "snapchat-bearer";
+    platformName = "Snapchat";
+    constructor(baseUrl, logger) {
+        super(logger);
+        this.baseUrl = baseUrl;
+    }
+    async resolveRefreshBranch(headers) {
+        const refreshCreds = parseSnapchatRefreshCredentialsFromHeaders(headers);
+        if (!refreshCreds)
+            return null;
+        const adAccountId = getSnapchatAdvertiserIdFromHeaders(headers);
+        const orgId = getSnapchatOrgIdFromHeaders(headers);
+        const adapter = new SnapchatRefreshTokenAdapter(refreshCreds, adAccountId, this.baseUrl, orgId);
+        await adapter.validate();
+        return {
+            adapter,
+            fingerprint: getSnapchatCredentialFingerprint(refreshCreds.appId, adAccountId),
+            userId: adapter.userId,
+            authFlow: "refresh-token",
+            logContext: { adAccountId, orgId },
+        };
+    }
+    async resolveAccessBranch(headers) {
+        const token = parseSnapchatTokenFromHeaders(headers);
+        const adAccountId = getSnapchatAdvertiserIdFromHeaders(headers);
+        const orgId = getSnapchatOrgIdFromHeaders(headers);
+        const adapter = new SnapchatAccessTokenAdapter(token, adAccountId, this.baseUrl, orgId);
+        await adapter.validate();
+        return {
+            adapter,
+            fingerprint: getSnapchatCredentialFingerprint(token, adAccountId),
+            userId: adapter.userId,
+            authFlow: "static-token",
+            logContext: { adAccountId, orgId },
+        };
+    }
+    getRefreshFingerprint(headers) {
+        const refreshCreds = parseSnapchatRefreshCredentialsFromHeaders(headers);
+        if (!refreshCreds)
+            return undefined;
+        const adAccountId = getSnapchatAdvertiserIdFromHeaders(headers);
+        return getSnapchatCredentialFingerprint(refreshCreds.appId, adAccountId);
+    }
+    getTokenFingerprint(headers) {
+        const token = parseSnapchatTokenFromHeaders(headers);
+        const adAccountId = getSnapchatAdvertiserIdFromHeaders(headers);
+        return getSnapchatCredentialFingerprint(token, adAccountId);
+    }
+}
+//# sourceMappingURL=snapchat-auth-strategy.js.map

package/dist/auth/snapchat-auth-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapchat-auth-strategy.js","sourceRoot":"","sources":["../../src/auth/snapchat-auth-strategy.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,0CAA0C,EAC1C,kCAAkC,EAClC,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAKjD;IAJA,QAAQ,GAAG,iBAAiB,CAAC;IAC7B,YAAY,GAAG,UAAU,CAAC;IAE7C,YACmB,OAAe,EAChC,MAAe;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC;QAHG,YAAO,GAAP,OAAO,CAAQ;IAIlC,CAAC;IAES,KAAK,CAAC,oBAAoB,CAClC,OAAsD;QAEtD,MAAM,YAAY,GAAG,0CAA0C,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,2BAA2B,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YAEP,WAAW,EAAE,gCAAgC,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC;YAC9E,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,eAAe;YACzB,UAAU,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SACnC,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,mBAAmB,CACjC,OAAsD;QAEtD,MAAM,KAAK,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,0BAA0B,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,gCAAgC,CAAC,KAAK,EAAE,WAAW,CAAC;YACjE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,cAAc;YACxB,UAAU,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SACnC,CAAC;IACJ,CAAC;IAES,qBAAqB,CAC7B,OAAsD;QAEtD,MAAM,YAAY,GAAG,0CAA0C,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,gCAAgC,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC;IAES,mBAAmB,CAAC,OAAsD;QAClF,MAAM,KAAK,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,gCAAgC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/config/index.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
+    mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    otelEnabled: z.ZodDefault<z.ZodBoolean>;
+    otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
+    otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
+    gcsBucketName: z.ZodOptional<z.ZodString>;
+} & {
+    serviceName: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    otelServiceName: z.ZodDefault<z.ZodString>;
+    mcpAuthMode: z.ZodDefault<z.ZodEnum<["snapchat-bearer", "jwt", "none"]>>;
+    snapchatApiBaseUrl: z.ZodDefault<z.ZodString>;
+    snapchatApiVersion: z.ZodDefault<z.ZodString>;
+    snapchatRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    snapchatAccessToken: z.ZodOptional<z.ZodString>;
+    snapchatAdAccountId: z.ZodOptional<z.ZodString>;
+    snapchatOrgId: z.ZodOptional<z.ZodString>;
+    snapchatAppId: z.ZodOptional<z.ZodString>;
+    snapchatAppSecret: z.ZodOptional<z.ZodString>;
+    snapchatRefreshToken: z.ZodOptional<z.ZodString>;
+    snapchatReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    snapchatReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+    snapchatVideoUploadPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    snapchatVideoUploadMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    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;
+}, {
+    serviceName?: string | undefined;
+    port?: number | undefined;
+    otelServiceName?: string | undefined;
+    mcpAuthMode?: "snapchat-bearer" | "jwt" | "none" | undefined;
+    snapchatApiBaseUrl?: string | undefined;
+    snapchatApiVersion?: string | undefined;
+    snapchatRateLimitPerMinute?: number | undefined;
+    snapchatAccessToken?: string | undefined;
+    snapchatAdAccountId?: string | undefined;
+    snapchatOrgId?: string | undefined;
+    snapchatAppId?: string | undefined;
+    snapchatAppSecret?: string | undefined;
+    snapchatRefreshToken?: string | undefined;
+    snapchatReportPollIntervalMs?: number | undefined;
+    snapchatReportMaxPollAttempts?: number | undefined;
+    snapchatVideoUploadPollIntervalMs?: number | undefined;
+    snapchatVideoUploadMaxPollAttempts?: number | undefined;
+    host?: string | undefined;
+    nodeEnv?: "development" | "production" | "test" | undefined;
+    mcpStatefulSessionTimeoutMs?: number | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    otelEnabled?: boolean | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}>;
+export type AppConfig = z.infer<typeof ConfigSchema>;
+export declare function parseConfig(): AppConfig;
+export declare const mcpConfig: {
+    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;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CA8CvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
+loadDotEnv();
+const ConfigSchema = BaseConfigSchema.extend({
+    serviceName: z.string().default("snapchat-mcp"),
+    port: z.number().int().min(1).max(65535).default(3009),
+    otelServiceName: z.string().default("snapchat-mcp"),
+    mcpAuthMode: z.enum(["snapchat-bearer", "jwt", "none"]).default("snapchat-bearer"),
+    snapchatApiBaseUrl: z.string().url().default("https://adsapi.snapchat.com"),
+    snapchatApiVersion: z.string().default("v1"),
+    snapchatRateLimitPerMinute: z.number().default(10),
+    snapchatAccessToken: z.string().optional(),
+    snapchatAdAccountId: z.string().optional(),
+    snapchatOrgId: z.string().optional(),
+    snapchatAppId: z.string().optional(),
+    snapchatAppSecret: z.string().optional(),
+    snapchatRefreshToken: z.string().optional(),
+    snapchatReportPollIntervalMs: z.number().default(2_000),
+    snapchatReportMaxPollAttempts: z.number().default(30),
+    snapchatVideoUploadPollIntervalMs: z.number().default(20_000),
+    snapchatVideoUploadMaxPollAttempts: z.number().default(30),
+});
+export function parseConfig() {
+    const defaultHost = getDefaultHost();
+    const rawConfig = {
+        ...getBaseEnvConfig(defaultHost),
+        serviceName: process.env.SERVICE_NAME,
+        ...(process.env.SNAPCHAT_MCP_PORT ? { port: Number(process.env.SNAPCHAT_MCP_PORT) } : {}),
+        host: process.env.SNAPCHAT_MCP_HOST || defaultHost,
+        snapchatApiBaseUrl: process.env.SNAPCHAT_API_BASE_URL,
+        snapchatApiVersion: process.env.SNAPCHAT_API_VERSION,
+        snapchatRateLimitPerMinute: process.env.SNAPCHAT_RATE_LIMIT_PER_MINUTE
+            ? Number(process.env.SNAPCHAT_RATE_LIMIT_PER_MINUTE)
+            : undefined,
+        snapchatAccessToken: process.env.SNAPCHAT_ACCESS_TOKEN,
+        snapchatAdAccountId: process.env.SNAPCHAT_AD_ACCOUNT_ID,
+        snapchatOrgId: process.env.SNAPCHAT_ORG_ID,
+        snapchatAppId: process.env.SNAPCHAT_APP_ID,
+        snapchatAppSecret: process.env.SNAPCHAT_APP_SECRET,
+        snapchatRefreshToken: process.env.SNAPCHAT_REFRESH_TOKEN,
+        snapchatReportPollIntervalMs: process.env.SNAPCHAT_REPORT_POLL_INTERVAL_MS
+            ? Number(process.env.SNAPCHAT_REPORT_POLL_INTERVAL_MS)
+            : undefined,
+        snapchatReportMaxPollAttempts: process.env.SNAPCHAT_REPORT_MAX_POLL_ATTEMPTS
+            ? Number(process.env.SNAPCHAT_REPORT_MAX_POLL_ATTEMPTS)
+            : undefined,
+        snapchatVideoUploadPollIntervalMs: process.env.SNAPCHAT_VIDEO_UPLOAD_POLL_INTERVAL_MS
+            ? Number(process.env.SNAPCHAT_VIDEO_UPLOAD_POLL_INTERVAL_MS)
+            : undefined,
+        snapchatVideoUploadMaxPollAttempts: process.env.SNAPCHAT_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS
+            ? Number(process.env.SNAPCHAT_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS)
+            : undefined,
+    };
+    return parseConfigWithSchema(ConfigSchema, rawConfig);
+}
+export const mcpConfig = parseConfig();
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { mcpConfig } from "./config/index.js";
+import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
+import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
+import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
+import { SnapchatAccessTokenAdapter } from "./auth/snapchat-auth-adapter.js";
+import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
+import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
+import { rateLimiter } from "./utils/platform.js";
+const transportMode = detectTransportMode();
+const logger = createServerLogger("snapchat-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const accessToken = mcpConfig.snapchatAccessToken;
+    const adAccountId = mcpConfig.snapchatAdAccountId;
+    if (!accessToken || !adAccountId) {
+        logger.warn("No Snapchat credentials found in env vars. " +
+            "Set SNAPCHAT_ACCESS_TOKEN and SNAPCHAT_AD_ACCOUNT_ID for stdio mode.");
+        return false;
+    }
+    const authAdapter = new SnapchatAccessTokenAdapter(accessToken, adAccountId, mcpConfig.snapchatApiBaseUrl, mcpConfig.snapchatOrgId ?? "");
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, {
+        baseUrl: mcpConfig.snapchatApiBaseUrl,
+        reportPollIntervalMs: mcpConfig.snapchatReportPollIntervalMs,
+        reportMaxPollAttempts: mcpConfig.snapchatReportMaxPollAttempts,
+    }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "snapchat-mcp",
+    config: mcpConfig,
+    logger,
+    transportMode,
+    initOtel: initializeOpenTelemetry,
+    setupStdioSession: setupStdioCredentials,
+    createMcpServer,
+    runStdio: runStdioServer,
+    startHttp: startHttpServer,
+    onShutdown: () => rateLimiter.destroy(),
+}).catch((err) => {
+    logger.fatal({ err }, "Failed to start snapchat-mcp");
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAMjF,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,mBAAmB,CAAC;IAClD,MAAM,WAAW,GAAG,SAAS,CAAC,mBAAmB,CAAC;IAElD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACT,6CAA6C;YAC3C,sEAAsE,CACzE,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,0BAA0B,CAChD,WAAW,EACX,WAAW,EACX,SAAS,CAAC,kBAAkB,EAC5B,SAAS,CAAC,aAAa,IAAI,EAAE,CAC9B,CAAC;IAGF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX;QACE,OAAO,EAAE,SAAS,CAAC,kBAAkB;QACrC,oBAAoB,EAAE,SAAS,CAAC,4BAA4B;QAC5D,qBAAqB,EAAE,SAAS,CAAC,6BAA6B;KAC/D,EACD,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,cAAc;IAC3B,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,8BAA8B,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const bulkOperationsWorkflowPrompt: Prompt;
+export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8GtF"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js

@@ -0,0 +1,127 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "snapchat_bulk_operations_workflow",
+    description: "Guide for performing bulk create, update, and status operations on Snapchat Ads entities",
+    arguments: [
+        {
+            name: "adAccountId",
+            description: "Snapchat Advertiser ID",
+            required: true,
+        },
+        {
+            name: "entityType",
+            description: "Entity type to operate on (campaign, adGroup, ad)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const adAccountId = args?.adAccountId || "{adAccountId}";
+    const entityType = args?.entityType || "campaign";
+    return `# Snapchat Bulk Operations Workflow
+
+## Advertiser ID: \`${adAccountId}\`
+## Entity Type: \`${entityType}\`
+
+---
+
+## Option 1: Bulk Status Update (most common)
+
+Pause, enable, or delete multiple entities in one call:
+
+\`\`\`json
+snapchat_bulk_update_status({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "entityIds": ["ID_1", "ID_2", "ID_3"],
+  "operationStatus": "DISABLE"
+})
+\`\`\`
+
+**Operation status values:**
+- \`ENABLE\` — Activate entities
+- \`DISABLE\` — Pause entities
+- \`DELETE\` — Permanently delete (irreversible!)
+
+---
+
+## Option 2: Bulk Create Entities (up to 50)
+
+Create multiple entities of the same type in one call:
+
+\`\`\`json
+snapchat_bulk_create_entities({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "items": [
+    {
+      "campaign_name": "Campaign A",
+      "objective_type": "TRAFFIC",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 100
+    },
+    {
+      "campaign_name": "Campaign B",
+      "objective_type": "CONVERSIONS",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 200
+    }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 3: Bulk Update Entities (up to 50)
+
+Update specific fields on multiple entities:
+
+\`\`\`json
+snapchat_bulk_update_entities({
+  "entityType": "${entityType}",
+  "adAccountId": "${adAccountId}",
+  "items": [
+    { "entityId": "ID_1", "data": { "budget": 150 } },
+    { "entityId": "ID_2", "data": { "budget": 250 } }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 4: Bulk Bid Adjustment (ad groups only)
+
+Safe read-modify-write bid adjustment:
+
+\`\`\`json
+snapchat_adjust_bids({
+  "adAccountId": "${adAccountId}",
+  "adjustments": [
+    { "adGroupId": "ADGROUP_ID_1", "bidPrice": 1.5 },
+    { "adGroupId": "ADGROUP_ID_2", "bidPrice": 2.0 }
+  ],
+  "reason": "Increase bids to improve delivery"
+})
+\`\`\`
+
+---
+
+## Tips for Bulk Operations
+
+1. **List first**: Use \`snapchat_list_entities\` to get entity IDs before bulk operations
+2. **Validate first**: Use \`snapchat_validate_entity\` to check payloads before bulk create
+3. **Status update is batched**: Snapchat accepts IDs array in one API call
+4. **Create/Update is sequential**: Processed concurrently (5 at a time) by the MCP tool
+5. **Max 50 items**: Per bulk create/update call (more = multiple calls)
+6. **Error handling**: Partial failures are reported — some may succeed while others fail
+
+## Workflow: Pause all campaigns → Adjust → Re-enable
+
+\`\`\`
+1. snapchat_list_entities (get campaign IDs)
+2. snapchat_bulk_update_status (DISABLE all)
+3. snapchat_bulk_update_entities (adjust budgets/settings)
+4. snapchat_bulk_update_status (ENABLE selected)
+\`\`\`
+`;
+}
+//# sourceMappingURL=bulk-operations-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,0FAA0F;IAC5F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,UAAU,CAAC;IAElD,OAAO;;sBAEa,WAAW;oBACb,UAAU;;;;;;;;;;mBAUX,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;;;;mBAmBZ,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0BZ,UAAU;oBACT,WAAW;;;;;;;;;;;;;;;;oBAgBX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B9B,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const campaignSetupWorkflowPrompt: Prompt;
+export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAgBzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAwGrF"}