@cesteral/cm360-mcp 1.0.0

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

@@ -0,0 +1,260 @@
+import { z } from "zod";
+import { getEntityTypeEnum } from "../utils/entity-mapping.js";
+import { validateEntityResponseFormatter, validateEnumFieldsStructured, buildNextAction, } from "@cesteral/shared";
+const CM360_ENUMS_BY_ENTITY = {
+    campaign: [
+        {
+            field: "archived",
+            hint: "Archive flag (boolean — represented as string in some payloads)",
+        },
+    ],
+    placement: [
+        {
+            field: "compatibility",
+            expectedType: "string",
+            hint: "Placement compatibility platform",
+            suggestedValues: [
+                "DISPLAY",
+                "DISPLAY_INTERSTITIAL",
+                "APP",
+                "APP_INTERSTITIAL",
+                "IN_STREAM_VIDEO",
+                "IN_STREAM_AUDIO",
+            ],
+        },
+        {
+            field: "paymentSource",
+            expectedType: "string",
+            hint: "Who pays for this placement",
+            suggestedValues: ["PLACEMENT_AGENCY_PAID", "PLACEMENT_PUBLISHER_PAID"],
+        },
+        {
+            field: "pricingSchedule.pricingType",
+            expectedType: "string",
+            hint: "Cost structure",
+            suggestedValues: [
+                "PRICING_TYPE_CPM",
+                "PRICING_TYPE_CPC",
+                "PRICING_TYPE_CPA",
+                "PRICING_TYPE_FLAT_RATE_IMPRESSIONS",
+                "PRICING_TYPE_FLAT_RATE_CLICKS",
+                "PRICING_TYPE_CPM_ACTIVEVIEW",
+            ],
+        },
+    ],
+    ad: [
+        {
+            field: "type",
+            expectedType: "string",
+            hint: "Ad type",
+            suggestedValues: [
+                "AD_SERVING_STANDARD_AD",
+                "AD_SERVING_DEFAULT_AD",
+                "AD_SERVING_CLICK_TRACKER",
+                "AD_SERVING_TRACKING",
+                "AD_SERVING_BRAND_SAFE_AD",
+            ],
+        },
+    ],
+    creative: [
+        {
+            field: "type",
+            expectedType: "string",
+            hint: "Creative format",
+            suggestedValues: [
+                "DISPLAY",
+                "DISPLAY_IMAGE_GALLERY",
+                "FLASH_INPAGE",
+                "HTML5_BANNER",
+                "IMAGE",
+                "INSTREAM_VIDEO",
+                "INSTREAM_AUDIO",
+                "REDIRECT",
+                "RICH_MEDIA_DISPLAY_BANNER",
+                "RICH_MEDIA_DISPLAY_EXPANDING",
+                "RICH_MEDIA_INPAGE_FLOATING",
+                "VPAID_LINEAR_VIDEO",
+                "VPAID_NON_LINEAR_VIDEO",
+                "TRACKING_TEXT",
+            ],
+        },
+    ],
+    floodlightActivity: [
+        {
+            field: "countingMethod",
+            expectedType: "string",
+            hint: "How conversions are counted",
+            suggestedValues: [
+                "STANDARD_COUNTING",
+                "UNIQUE_COUNTING",
+                "SESSION_COUNTING",
+                "TRANSACTIONS_COUNTING",
+                "ITEMS_SOLD_COUNTING",
+            ],
+        },
+    ],
+};
+const TOOL_NAME = "cm360_validate_entity";
+const TOOL_TITLE = "Validate CM360 Entity";
+const TOOL_DESCRIPTION = `Dry-run validate a CM360 entity payload without making an API call.
+
+Checks that the data object has the expected structure for the given entity type and mode (create or update). No credentials or profileId required.`;
+export const ValidateEntityInputSchema = z
+    .object({
+    entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to validate"),
+    mode: z
+        .enum(["create", "update"])
+        .describe("Validation mode — create checks for required fields, update checks for id presence"),
+    data: z.record(z.any()).describe("Entity data to validate"),
+})
+    .describe("Parameters for validating a CM360 entity");
+const ValidationIssueSchema = z.object({
+    field: z.string(),
+    code: z.enum(["missing", "wrongType", "invalidValue", "readOnly", "custom"]),
+    message: z.string(),
+    hint: z.string().optional(),
+    suggestedValues: z.array(z.string()).optional(),
+    severity: z.enum(["error", "warning"]).optional(),
+});
+export const ValidateEntityOutputSchema = z
+    .object({
+    valid: z.boolean().describe("Whether the entity data is valid"),
+    entityType: z.string(),
+    mode: z.string(),
+    issues: z.array(ValidationIssueSchema),
+    nextAction: z.string().optional(),
+    timestamp: z.string().datetime(),
+})
+    .describe("Entity validation result");
+export async function validateEntityLogic(input, _context) {
+    const issues = [];
+    const err = (field, code, message) => issues.push({ field, code, message, severity: "error" });
+    const warn = (field, code, message) => issues.push({ field, code, message, severity: "warning" });
+    const enumRules = CM360_ENUMS_BY_ENTITY[input.entityType] ?? [];
+    if (enumRules.length > 0) {
+        issues.push(...validateEnumFieldsStructured(input.data, enumRules));
+        if (input.entityType === "placement" && input.data.pricingSchedule) {
+            const ps = input.data.pricingSchedule;
+            const nestedRule = enumRules.find((r) => r.field === "pricingSchedule.pricingType");
+            if (nestedRule?.suggestedValues && typeof ps.pricingType === "string") {
+                if (!nestedRule.suggestedValues.includes(ps.pricingType)) {
+                    issues.push({
+                        field: "pricingSchedule.pricingType",
+                        code: "invalidValue",
+                        message: `Field "pricingSchedule.pricingType" value "${ps.pricingType}" is not a recognized enum value.`,
+                        hint: nestedRule.hint,
+                        suggestedValues: [...nestedRule.suggestedValues],
+                        severity: "error",
+                    });
+                }
+            }
+        }
+    }
+    if (input.mode === "update" && !input.data.id) {
+        err("id", "missing", "id field is required for update mode (CM360 uses PUT semantics)");
+    }
+    if (input.mode === "create" && input.data.id) {
+        warn("id", "readOnly", "id field is typically auto-generated on create — it will be ignored");
+    }
+    if (!input.data.name &&
+        ["campaign", "placement", "ad", "creative", "site", "floodlightActivity"].includes(input.entityType)) {
+        warn("name", "missing", `name field is typically required for ${input.entityType} entities`);
+    }
+    if (input.entityType === "campaign") {
+        if (!input.data.advertiserId && input.mode === "create") {
+            err("advertiserId", "missing", "advertiserId is required when creating a campaign");
+        }
+    }
+    if (input.entityType === "placement") {
+        if (!input.data.campaignId && input.mode === "create") {
+            err("campaignId", "missing", "campaignId is required when creating a placement");
+        }
+        if (!input.data.siteId && input.mode === "create") {
+            warn("siteId", "missing", "siteId is typically required when creating a placement");
+        }
+    }
+    if (input.entityType === "ad") {
+        if (!input.data.campaignId && input.mode === "create") {
+            err("campaignId", "missing", "campaignId is required when creating an ad");
+        }
+    }
+    if (input.entityType === "floodlightActivity") {
+        if (!input.data.floodlightConfigurationId && input.mode === "create") {
+            err("floodlightConfigurationId", "missing", "floodlightConfigurationId is required when creating a floodlight activity");
+        }
+    }
+    const errorIssues = issues.filter((i) => i.severity !== "warning");
+    let nextAction;
+    if (errorIssues.length > 0) {
+        if (errorIssues.some((i) => i.field === "profileId")) {
+            nextAction = buildNextAction({
+                kind: "discover-account",
+                tool: "cm360_list_user_profiles",
+                field: "profileId",
+            });
+        }
+        else if (errorIssues.some((i) => i.field === "floodlightConfigurationId")) {
+            nextAction = buildNextAction({
+                kind: "list-entity",
+                tool: "cm360_list_entities",
+                entityType: "floodlightConfiguration",
+                field: "floodlightConfigurationId",
+            });
+        }
+        else {
+            nextAction = buildNextAction({
+                kind: "list-entity",
+                tool: "cm360_list_entities",
+                entityType: input.entityType,
+            });
+        }
+    }
+    return {
+        valid: errorIssues.length === 0,
+        entityType: input.entityType,
+        mode: input.mode,
+        issues,
+        ...(nextAction ? { nextAction } : {}),
+        timestamp: new Date().toISOString(),
+    };
+}
+export const validateEntityTool = {
+    name: TOOL_NAME,
+    title: TOOL_TITLE,
+    description: TOOL_DESCRIPTION,
+    inputSchema: ValidateEntityInputSchema,
+    outputSchema: ValidateEntityOutputSchema,
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
+    inputExamples: [
+        {
+            label: "Validate a campaign for creation",
+            input: {
+                entityType: "campaign",
+                mode: "create",
+                data: {
+                    name: "Q1 Brand Campaign",
+                    advertiserId: "789012",
+                },
+            },
+        },
+        {
+            label: "Validate entity for update",
+            input: {
+                entityType: "placement",
+                mode: "update",
+                data: {
+                    id: "111222",
+                    name: "Updated Placement",
+                },
+            },
+        },
+    ],
+    logic: validateEntityLogic,
+    responseFormatter: validateEntityResponseFormatter,
+};
+//# 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,12 @@
+export type CM360EntityType = "campaign" | "placement" | "ad" | "creative" | "site" | "advertiser" | "floodlightActivity" | "floodlightConfiguration";
+export interface CM360EntityConfig {
+    apiCollection: string;
+    idField: string;
+    supportsDelete: boolean;
+}
+export declare function getEntityConfig(entityType: CM360EntityType): CM360EntityConfig;
+export declare function getSupportedEntityTypes(): CM360EntityType[];
+export declare function getEntityTypeEnum(): [string, ...string[]];
+export declare function getDeletableEntityTypes(): CM360EntityType[];
+export declare function getDeletableEntityTypeEnum(): [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":"AAKA,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,WAAW,GACX,IAAI,GACJ,UAAU,GACV,MAAM,GACN,YAAY,GACZ,oBAAoB,GACpB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AA6CD,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,iBAAiB,CAM9E;AAED,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED,wBAAgB,iBAAiB,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGzD;AAED,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAI3D;AAED,wBAAgB,0BAA0B,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAGlE"}

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

@@ -0,0 +1,67 @@
+import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
+const ENTITY_CONFIGS = {
+    campaign: {
+        apiCollection: "campaigns",
+        idField: "id",
+        supportsDelete: false,
+    },
+    placement: {
+        apiCollection: "placements",
+        idField: "id",
+        supportsDelete: false,
+    },
+    ad: {
+        apiCollection: "ads",
+        idField: "id",
+        supportsDelete: false,
+    },
+    creative: {
+        apiCollection: "creatives",
+        idField: "id",
+        supportsDelete: false,
+    },
+    site: {
+        apiCollection: "sites",
+        idField: "id",
+        supportsDelete: false,
+    },
+    advertiser: {
+        apiCollection: "advertisers",
+        idField: "id",
+        supportsDelete: false,
+    },
+    floodlightActivity: {
+        apiCollection: "floodlightActivities",
+        idField: "id",
+        supportsDelete: true,
+    },
+    floodlightConfiguration: {
+        apiCollection: "floodlightConfigurations",
+        idField: "id",
+        supportsDelete: false,
+    },
+};
+export function getEntityConfig(entityType) {
+    const config = ENTITY_CONFIGS[entityType];
+    if (!config) {
+        throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown CM360 entity type: ${entityType}`);
+    }
+    return config;
+}
+export function getSupportedEntityTypes() {
+    return Object.keys(ENTITY_CONFIGS);
+}
+export function getEntityTypeEnum() {
+    const types = getSupportedEntityTypes();
+    return types;
+}
+export function getDeletableEntityTypes() {
+    return Object.entries(ENTITY_CONFIGS)
+        .filter(([, config]) => config.supportsDelete)
+        .map(([type]) => type);
+}
+export function getDeletableEntityTypeEnum() {
+    const types = getDeletableEntityTypes();
+    return types;
+}
+//# 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;AAkB9D,MAAM,cAAc,GAA+C;IACjE,QAAQ,EAAE;QACR,aAAa,EAAE,WAAW;QAC1B,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,SAAS,EAAE;QACT,aAAa,EAAE,YAAY;QAC3B,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,EAAE,EAAE;QACF,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,QAAQ,EAAE;QACR,aAAa,EAAE,WAAW;QAC1B,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,OAAO;QACtB,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,UAAU,EAAE;QACV,aAAa,EAAE,aAAa;QAC5B,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;IACD,kBAAkB,EAAE;QAClB,aAAa,EAAE,sBAAsB;QACrC,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,IAAI;KACrB;IACD,uBAAuB,EAAE;QACvB,aAAa,EAAE,0BAA0B;QACzC,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,UAA2B;IACzD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,8BAA8B,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAsB,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;IACxC,OAAO,KAA8B,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAQ,MAAM,CAAC,OAAO,CAAC,cAAc,CAA4C;SAC9E,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;IACxC,OAAO,KAA8B,CAAC;AACxC,CAAC"}

package/dist/mcp-server/tools/utils/report-config.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+export declare const CM360_REPORT_TYPE_VALUES: readonly ["STANDARD", "REACH", "PATH_TO_CONVERSION", "FLOODLIGHT", "CROSS_MEDIA_REACH"];
+export declare const CM360ReportTypeSchema: z.ZodEnum<["STANDARD", "REACH", "PATH_TO_CONVERSION", "FLOODLIGHT", "CROSS_MEDIA_REACH"]>;
+export declare const CM360DatePresetSchema: z.ZodEnum<["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS", "THIS_MONTH", "LAST_MONTH", "LAST_90_DAYS"]>;
+export type CM360ReportType = z.infer<typeof CM360ReportTypeSchema>;
+export declare const REPORT_CRITERIA_FIELD_BY_TYPE: Record<CM360ReportType, CriteriaField>;
+export declare const REPORT_CRITERIA_FIELDS: CriteriaField[];
+type CriteriaField = "criteria" | "reachCriteria" | "pathToConversionCriteria" | "floodlightCriteria" | "crossMediaReachCriteria";
+type ReportCriteriaValue = Record<string, unknown> | undefined;
+type ReportRequestInput = {
+    name: string;
+    type: CM360ReportType;
+    datePreset?: z.infer<typeof CM360DatePresetSchema>;
+    additionalConfig?: Record<string, unknown>;
+} & Partial<Record<CriteriaField, ReportCriteriaValue>>;
+export declare const genericCriteriaSchema: z.ZodRecord<z.ZodString, z.ZodAny>;
+export declare function validateTypedCriteriaUsage(input: {
+    type: CM360ReportType;
+    datePreset?: z.infer<typeof CM360DatePresetSchema>;
+} & Partial<Record<CriteriaField, ReportCriteriaValue>>, ctx: z.RefinementCtx): void;
+export declare function buildTypedReportConfig(input: ReportRequestInput): Record<string, unknown>;
+export declare function getCriteriaFieldForType(type: CM360ReportType): CriteriaField;
+export declare function ensureReportSupportsBreakdowns(type: CM360ReportType): CriteriaField;
+export declare function getReportCriteriaFromConfig(input: Partial<Record<CriteriaField, ReportCriteriaValue>>, type: CM360ReportType): ReportCriteriaValue;
+export declare function validateScheduleCompatibility(type: CM360ReportType, criteria: ReportCriteriaValue, ctx: z.RefinementCtx, path?: (string | number)[]): void;
+export declare const CM360ScheduleSchema: z.ZodEffects<z.ZodObject<{
+    active: z.ZodDefault<z.ZodBoolean>;
+    every: z.ZodOptional<z.ZodNumber>;
+    repeats: z.ZodEnum<["DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "YEARLY"]>;
+    startDate: z.ZodString;
+    expirationDate: z.ZodOptional<z.ZodString>;
+    repeatsOnWeekDays: z.ZodOptional<z.ZodArray<z.ZodEnum<["SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY"]>, "many">>;
+    runsOnDayOfMonth: z.ZodOptional<z.ZodEnum<["DAY_OF_MONTH", "WEEK_OF_MONTH"]>>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    active: boolean;
+    repeats: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "YEARLY";
+    every?: number | undefined;
+    expirationDate?: string | undefined;
+    repeatsOnWeekDays?: ("SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY")[] | undefined;
+    runsOnDayOfMonth?: "DAY_OF_MONTH" | "WEEK_OF_MONTH" | undefined;
+    timezone?: string | undefined;
+}, {
+    startDate: string;
+    repeats: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "YEARLY";
+    every?: number | undefined;
+    active?: boolean | undefined;
+    expirationDate?: string | undefined;
+    repeatsOnWeekDays?: ("SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY")[] | undefined;
+    runsOnDayOfMonth?: "DAY_OF_MONTH" | "WEEK_OF_MONTH" | undefined;
+    timezone?: string | undefined;
+}>, {
+    startDate: string;
+    active: boolean;
+    repeats: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "YEARLY";
+    every?: number | undefined;
+    expirationDate?: string | undefined;
+    repeatsOnWeekDays?: ("SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY")[] | undefined;
+    runsOnDayOfMonth?: "DAY_OF_MONTH" | "WEEK_OF_MONTH" | undefined;
+    timezone?: string | undefined;
+}, {
+    startDate: string;
+    repeats: "DAILY" | "WEEKLY" | "MONTHLY" | "QUARTERLY" | "YEARLY";
+    every?: number | undefined;
+    active?: boolean | undefined;
+    expirationDate?: string | undefined;
+    repeatsOnWeekDays?: ("SUNDAY" | "MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY")[] | undefined;
+    runsOnDayOfMonth?: "DAY_OF_MONTH" | "WEEK_OF_MONTH" | undefined;
+    timezone?: string | undefined;
+}>;
+export {};
+//# sourceMappingURL=report-config.d.ts.map

package/dist/mcp-server/tools/utils/report-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-config.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/report-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,wBAAwB,yFAM3B,CAAC;AAEX,eAAO,MAAM,qBAAqB,2FAAmC,CAAC;AACtE,eAAO,MAAM,qBAAqB,8HAA6B,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAMhF,CAAC;AAEF,eAAO,MAAM,sBAAsB,iBAA+C,CAAC;AAEnF,KAAK,aAAa,GACd,UAAU,GACV,eAAe,GACf,0BAA0B,GAC1B,oBAAoB,GACpB,yBAAyB,CAAC;AAE9B,KAAK,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAE/D,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB,oCAAoB,CAAC;AAEvD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE;IACL,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,EACvD,GAAG,EAAE,CAAC,CAAC,aAAa,GACnB,IAAI,CAyBN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAE5E;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAOnF;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,EAC1D,IAAI,EAAE,eAAe,GACpB,mBAAmB,CAErB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,mBAAmB,EAC7B,GAAG,EAAE,CAAC,CAAC,aAAa,EACpB,IAAI,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAiB,GACvC,IAAI,CAoBN;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8D5B,CAAC"}

package/dist/mcp-server/tools/utils/report-config.js

@@ -0,0 +1,161 @@
+import { z } from "zod";
+import { resolveDatePreset, DATE_PRESET_VALUES } from "@cesteral/shared";
+export const CM360_REPORT_TYPE_VALUES = [
+    "STANDARD",
+    "REACH",
+    "PATH_TO_CONVERSION",
+    "FLOODLIGHT",
+    "CROSS_MEDIA_REACH",
+];
+export const CM360ReportTypeSchema = z.enum(CM360_REPORT_TYPE_VALUES);
+export const CM360DatePresetSchema = z.enum(DATE_PRESET_VALUES);
+export const REPORT_CRITERIA_FIELD_BY_TYPE = {
+    STANDARD: "criteria",
+    REACH: "reachCriteria",
+    PATH_TO_CONVERSION: "pathToConversionCriteria",
+    FLOODLIGHT: "floodlightCriteria",
+    CROSS_MEDIA_REACH: "crossMediaReachCriteria",
+};
+export const REPORT_CRITERIA_FIELDS = Object.values(REPORT_CRITERIA_FIELD_BY_TYPE);
+export const genericCriteriaSchema = z.record(z.any());
+export function validateTypedCriteriaUsage(input, ctx) {
+    const expectedField = getCriteriaFieldForType(input.type);
+    const providedFields = REPORT_CRITERIA_FIELDS.filter((field) => input[field] !== undefined);
+    for (const field of providedFields) {
+        if (field !== expectedField) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [field],
+                message: `${field} is not valid for report type ${input.type}; use ${expectedField} instead`,
+            });
+        }
+    }
+    if (input.datePreset) {
+        const criteria = input[expectedField];
+        const dateRange = criteria?.dateRange;
+        if (dateRange?.relativeDateRange === "TODAY") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [expectedField, "dateRange", "relativeDateRange"],
+                message: "datePreset cannot be combined with a criteria dateRange of TODAY",
+            });
+        }
+    }
+}
+export function buildTypedReportConfig(input) {
+    const expectedField = getCriteriaFieldForType(input.type);
+    const mergedCriteria = injectDatePreset(input.datePreset, input[expectedField]);
+    const { name: _ignoredName, type: _ignoredType, criteria: _ignoredCriteria, reachCriteria: _ignoredReachCriteria, pathToConversionCriteria: _ignoredPathCriteria, floodlightCriteria: _ignoredFloodlightCriteria, crossMediaReachCriteria: _ignoredCrossMediaCriteria, ...safeAdditionalConfig } = input.additionalConfig ?? {};
+    return {
+        ...safeAdditionalConfig,
+        name: input.name,
+        type: input.type,
+        ...(mergedCriteria ? { [expectedField]: mergedCriteria } : {}),
+    };
+}
+export function getCriteriaFieldForType(type) {
+    return REPORT_CRITERIA_FIELD_BY_TYPE[type];
+}
+export function ensureReportSupportsBreakdowns(type) {
+    if (type === "PATH_TO_CONVERSION") {
+        throw new Error("cm360_get_report_breakdowns does not support PATH_TO_CONVERSION; use the type-specific report criteria fields directly");
+    }
+    return getCriteriaFieldForType(type);
+}
+export function getReportCriteriaFromConfig(input, type) {
+    return input[getCriteriaFieldForType(type)];
+}
+export function validateScheduleCompatibility(type, criteria, ctx, path = ["schedule"]) {
+    const dateRange = criteria?.dateRange;
+    const relativeDateRange = dateRange?.relativeDateRange;
+    if (!relativeDateRange || typeof relativeDateRange !== "string") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path,
+            message: `Scheduled ${type} reports require a relative date range on ${getCriteriaFieldForType(type)}.dateRange.relativeDateRange`,
+        });
+        return;
+    }
+    if (relativeDateRange === "TODAY") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path,
+            message: "CM360 does not allow report schedules when relativeDateRange is TODAY",
+        });
+    }
+}
+export const CM360ScheduleSchema = z
+    .object({
+    active: z.boolean().default(true).describe("Whether the schedule is active"),
+    every: z.number().int().min(1).optional().describe("Frequency multiplier"),
+    repeats: z
+        .enum(["DAILY", "WEEKLY", "MONTHLY", "QUARTERLY", "YEARLY"])
+        .describe("Repeat frequency"),
+    startDate: z.string().describe("Schedule start date (YYYY-MM-DD)"),
+    expirationDate: z.string().optional().describe("Schedule end date (YYYY-MM-DD)"),
+    repeatsOnWeekDays: z
+        .array(z.enum(["SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY"]))
+        .min(1)
+        .optional()
+        .describe("Days of week for WEEKLY schedules"),
+    runsOnDayOfMonth: z
+        .enum(["DAY_OF_MONTH", "WEEK_OF_MONTH"])
+        .optional()
+        .describe("Monthly scheduling mode"),
+    timezone: z.string().optional().describe("Timezone when the report should run"),
+})
+    .superRefine((value, ctx) => {
+    if (value.repeats === "DAILY" || value.repeats === "WEEKLY" || value.repeats === "MONTHLY") {
+        if (value.every === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["every"],
+                message: `every is required when repeats is ${value.repeats}`,
+            });
+        }
+    }
+    if (value.repeats === "WEEKLY") {
+        if (!value.repeatsOnWeekDays || value.repeatsOnWeekDays.length === 0) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["repeatsOnWeekDays"],
+                message: "repeatsOnWeekDays is required when repeats is WEEKLY",
+            });
+        }
+    }
+    else if (value.repeatsOnWeekDays !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["repeatsOnWeekDays"],
+            message: "repeatsOnWeekDays is only valid when repeats is WEEKLY",
+        });
+    }
+    if (value.repeats === "MONTHLY") {
+        if (!value.runsOnDayOfMonth) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["runsOnDayOfMonth"],
+                message: "runsOnDayOfMonth is required when repeats is MONTHLY",
+            });
+        }
+    }
+    else if (value.runsOnDayOfMonth !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["runsOnDayOfMonth"],
+            message: "runsOnDayOfMonth is only valid when repeats is MONTHLY",
+        });
+    }
+});
+function injectDatePreset(datePreset, criteria) {
+    if (!datePreset) {
+        return criteria;
+    }
+    const dateRange = criteria?.dateRange;
+    if (dateRange) {
+        return criteria;
+    }
+    const { startDate, endDate } = resolveDatePreset(datePreset);
+    return { ...(criteria ?? {}), dateRange: { startDate, endDate } };
+}
+//# sourceMappingURL=report-config.js.map

package/dist/mcp-server/tools/utils/report-config.js.map

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

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":"AAIA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,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