cli-meta-ads 0.1.0

package/dist/validators/create-spec.js

@@ -0,0 +1,394 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { AppError, ExitCode } from "../utils/errors.js";
+import { normalizeObjectId } from "../utils/ids.js";
+import { hasPlacementFormats, launchCreativeFormatKeys } from "../utils/meta-placement-assets.js";
+export const pausedStatusSchema = z.literal("PAUSED");
+export const nonEmptyStringSchema = z.string().trim().min(1);
+const metaIdSchema = (label) => z.string().trim().min(1).transform((value) => normalizeObjectId(value, label));
+export const campaignObjectiveValues = [
+    "APP_INSTALLS",
+    "BRAND_AWARENESS",
+    "CONVERSIONS",
+    "EVENT_RESPONSES",
+    "LEAD_GENERATION",
+    "LINK_CLICKS",
+    "LOCAL_AWARENESS",
+    "MESSAGES",
+    "OFFER_CLAIMS",
+    "OUTCOME_APP_PROMOTION",
+    "OUTCOME_AWARENESS",
+    "OUTCOME_ENGAGEMENT",
+    "OUTCOME_LEADS",
+    "OUTCOME_SALES",
+    "OUTCOME_TRAFFIC",
+    "PAGE_LIKES",
+    "POST_ENGAGEMENT",
+    "PRODUCT_CATALOG_SALES",
+    "REACH",
+    "STORE_VISITS",
+    "VIDEO_VIEWS"
+];
+export const bidStrategyValues = [
+    "LOWEST_COST_WITHOUT_CAP",
+    "LOWEST_COST_WITH_BID_CAP",
+    "COST_CAP"
+];
+export const optimizationGoalValues = [
+    "APP_INSTALLS",
+    "APP_INSTALLS_AND_OFFSITE_CONVERSIONS",
+    "CONVERSATIONS",
+    "ENGAGED_PAGE_VIEWS",
+    "ENGAGED_USERS",
+    "EVENT_RESPONSES",
+    "IMPRESSIONS",
+    "LANDING_PAGE_VIEWS",
+    "LEAD_GENERATION",
+    "LINK_CLICKS",
+    "OFFSITE_CONVERSIONS",
+    "PAGE_LIKES",
+    "POST_ENGAGEMENT",
+    "QUALITY_CALL",
+    "QUALITY_LEAD",
+    "REACH",
+    "THRUPLAY",
+    "VALUE",
+    "VISIT_INSTAGRAM_PROFILE"
+];
+export const campaignObjectiveSchema = z.enum(campaignObjectiveValues);
+export const bidStrategySchema = z.enum(bidStrategyValues);
+export const optimizationGoalSchema = z.enum(optimizationGoalValues);
+export const callToActionSchema = z.enum(["SHOP_NOW", "LEARN_MORE", "SIGN_UP"]);
+const automationToggleSchema = z.union([z.literal(0), z.literal(1)]);
+function hasCampaignBudget(value) {
+    return value.dailyBudget !== undefined || value.lifetimeBudget !== undefined;
+}
+function normalizeAdvantageAudienceTargeting(value) {
+    if (value.targeting_automation?.advantage_audience !== 1) {
+        return value;
+    }
+    return {
+        ...value,
+        age_max: value.age_max !== undefined && value.age_max < 65 ? 65 : value.age_max,
+        age_min: value.age_min !== undefined && value.age_min > 25 ? 25 : value.age_min
+    };
+}
+const targetingAutomationSchema = z.object({
+    advantage_audience: automationToggleSchema.optional(),
+    individual_setting: z.record(z.string(), automationToggleSchema).optional()
+}).catchall(z.unknown());
+const rawTargetingSpecSchema = z.object({
+    age_max: z.number().int().positive().optional(),
+    age_min: z.number().int().positive().optional(),
+    targeting_automation: targetingAutomationSchema.optional()
+}).catchall(z.unknown()).refine((value) => Object.keys(value).length > 0, "targeting must include at least one key.");
+export const targetingSpecSchema = rawTargetingSpecSchema
+    .transform((value) => normalizeAdvantageAudienceTargeting(value))
+    .superRefine((value, ctx) => {
+    if (value.age_min !== undefined
+        && value.age_max !== undefined
+        && value.age_min > value.age_max) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "targeting.age_min cannot be greater than targeting.age_max."
+        });
+    }
+});
+export const promotedObjectSchema = z.object({
+    applicationId: metaIdSchema("application id").optional(),
+    customConversionId: metaIdSchema("custom conversion id").optional(),
+    customEventType: nonEmptyStringSchema.optional(),
+    eventId: metaIdSchema("event id").optional(),
+    instagramActorId: metaIdSchema("instagram actor id").optional(),
+    objectStoreUrl: z.string().trim().url().optional(),
+    offlineConversionDataSetId: metaIdSchema("offline conversion data set id").optional(),
+    pageId: metaIdSchema("page id").optional(),
+    pixelId: metaIdSchema("pixel id").optional(),
+    productSetId: metaIdSchema("product set id").optional(),
+    whatsappPhoneNumber: nonEmptyStringSchema.optional()
+}).strict().superRefine((value, ctx) => {
+    if (Object.keys(value).length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "promotedObject must include at least one supported field."
+        });
+    }
+});
+const imageCropValuesSchema = z.array(z.number());
+const imageCropsSchema = z.record(z.string(), imageCropValuesSchema);
+export const creativePlatformCustomizationOverrideSchema = z.object({
+    captionIds: z.array(nonEmptyStringSchema).optional(),
+    imageCrops: imageCropsSchema.optional(),
+    imageHash: nonEmptyStringSchema.optional(),
+    imageUrl: z.string().trim().url().optional(),
+    videoId: metaIdSchema("video id").optional()
+}).strict().superRefine((value, ctx) => {
+    if (!value.imageHash && !value.imageUrl && !value.videoId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Platform customization must include imageHash, imageUrl, or videoId."
+        });
+    }
+});
+export const creativeFormatOverrideSchema = z.object({
+    captionIds: z.array(nonEmptyStringSchema).optional(),
+    imageCrops: imageCropsSchema.optional(),
+    imageHash: nonEmptyStringSchema.optional(),
+    imageUrl: z.string().trim().url().optional(),
+    videoId: metaIdSchema("video id").optional()
+}).strict().superRefine((value, ctx) => {
+    if (!value.imageHash && !value.imageUrl && !value.videoId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Format override must include imageHash, imageUrl, or videoId."
+        });
+    }
+});
+export const creativeFormatsSchema = z.object({
+    feed4x5: creativeFormatOverrideSchema.optional(),
+    square1x1: creativeFormatOverrideSchema.optional(),
+    story9x16: creativeFormatOverrideSchema.optional()
+}).strict().superRefine((value, ctx) => {
+    if (!launchCreativeFormatKeys.some((key) => value[key])) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "formats must include at least one supported format override."
+        });
+    }
+});
+export const creativePlatformCustomizationsSchema = z.object({
+    instagram: creativePlatformCustomizationOverrideSchema.optional()
+}).strict().superRefine((value, ctx) => {
+    if (!value.instagram) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "platformCustomizations must include at least one supported platform override."
+        });
+    }
+});
+export const campaignCreateSpecSchema = z.object({
+    bidStrategy: bidStrategySchema.optional(),
+    dailyBudget: z.number().int().positive().optional(),
+    lifetimeBudget: z.number().int().positive().optional(),
+    name: nonEmptyStringSchema,
+    objective: campaignObjectiveSchema,
+    specialAdCategories: z.array(nonEmptyStringSchema).default([]),
+    status: pausedStatusSchema.optional()
+}).strict().superRefine((value, ctx) => {
+    if (value.dailyBudget !== undefined && value.lifetimeBudget !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide either dailyBudget or lifetimeBudget for campaign budget optimization, not both."
+        });
+    }
+    if (value.bidStrategy !== undefined && !hasCampaignBudget(value)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Campaign bidStrategy requires dailyBudget or lifetimeBudget."
+        });
+    }
+});
+export const adSetCreateSpecSchema = z.object({
+    bidAmount: z.number().int().positive().optional(),
+    bidStrategy: bidStrategySchema.optional(),
+    billingEvent: z.enum(["IMPRESSIONS", "CLICKS"]),
+    campaignId: metaIdSchema("campaign id"),
+    dailyBudget: z.number().int().positive().optional(),
+    endTime: nonEmptyStringSchema.optional(),
+    lifetimeBudget: z.number().int().positive().optional(),
+    name: nonEmptyStringSchema,
+    optimizationGoal: optimizationGoalSchema,
+    promotedObject: promotedObjectSchema,
+    startTime: nonEmptyStringSchema.optional(),
+    status: pausedStatusSchema.optional(),
+    targeting: targetingSpecSchema
+}).strict().superRefine((value, ctx) => {
+    if (value.dailyBudget === undefined && value.lifetimeBudget === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Either dailyBudget or lifetimeBudget is required."
+        });
+    }
+    if (value.dailyBudget !== undefined && value.lifetimeBudget !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide either dailyBudget or lifetimeBudget, not both."
+        });
+    }
+    if (value.bidStrategy === "LOWEST_COST_WITHOUT_CAP" && value.bidAmount !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "bidAmount cannot be combined with LOWEST_COST_WITHOUT_CAP."
+        });
+    }
+    if ((value.bidStrategy === "LOWEST_COST_WITH_BID_CAP" || value.bidStrategy === "COST_CAP")
+        && value.bidAmount === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${value.bidStrategy} requires bidAmount.`
+        });
+    }
+    if ((value.optimizationGoal === "OFFSITE_CONVERSIONS" || value.optimizationGoal === "VALUE")
+        && (!value.promotedObject.pixelId || !value.promotedObject.customEventType)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${value.optimizationGoal} requires promotedObject.pixelId and promotedObject.customEventType.`
+        });
+    }
+    if ((value.optimizationGoal === "CONVERSATIONS"
+        || value.optimizationGoal === "LEAD_GENERATION"
+        || value.optimizationGoal === "QUALITY_CALL"
+        || value.optimizationGoal === "QUALITY_LEAD")
+        && !value.promotedObject.pageId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${value.optimizationGoal} requires promotedObject.pageId.`
+        });
+    }
+});
+const imageLinkCreativeSpecSchema = z.object({
+    formats: creativeFormatsSchema.optional(),
+    imageHash: nonEmptyStringSchema.optional(),
+    kind: z.literal("link-image"),
+    linkData: z.object({
+        callToAction: callToActionSchema.optional(),
+        description: nonEmptyStringSchema.optional(),
+        headline: nonEmptyStringSchema.optional(),
+        link: z.string().trim().url(),
+        message: nonEmptyStringSchema
+    }).strict(),
+    name: nonEmptyStringSchema.optional(),
+    pageId: metaIdSchema("page id"),
+    platformCustomizations: creativePlatformCustomizationsSchema.optional(),
+    status: pausedStatusSchema.optional()
+}).strict().superRefine((value, ctx) => {
+    if (!value.imageHash && !hasPlacementFormats(value.formats)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Creative must include imageHash or formats."
+        });
+    }
+    if (value.platformCustomizations && value.formats) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "formats cannot be combined with legacy platformCustomizations."
+        });
+    }
+    if (value.platformCustomizations?.instagram?.videoId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "platformCustomizations.instagram cannot use videoId for link-image creatives."
+        });
+    }
+    launchCreativeFormatKeys.forEach((formatKey) => {
+        const format = value.formats?.[formatKey];
+        if (format?.videoId) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `formats.${formatKey} cannot use videoId for link-image creatives.`
+            });
+        }
+    });
+});
+const videoLinkCreativeSpecSchema = z.object({
+    formats: creativeFormatsSchema.optional(),
+    kind: z.literal("video-link"),
+    name: nonEmptyStringSchema.optional(),
+    pageId: metaIdSchema("page id"),
+    platformCustomizations: creativePlatformCustomizationsSchema.optional(),
+    status: pausedStatusSchema.optional(),
+    videoData: z.object({
+        callToAction: callToActionSchema.optional(),
+        description: nonEmptyStringSchema.optional(),
+        link: z.string().trim().url(),
+        message: nonEmptyStringSchema,
+        title: nonEmptyStringSchema.optional()
+    }).strict(),
+    videoId: metaIdSchema("video id").optional()
+}).strict().superRefine((value, ctx) => {
+    if (!value.videoId && !hasPlacementFormats(value.formats)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Creative must include videoId or formats."
+        });
+    }
+    if (value.platformCustomizations && value.formats) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "formats cannot be combined with legacy platformCustomizations."
+        });
+    }
+    if (value.platformCustomizations?.instagram
+        && (value.platformCustomizations.instagram.imageHash
+            || value.platformCustomizations.instagram.imageUrl
+            || value.platformCustomizations.instagram.imageCrops)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "platformCustomizations.instagram cannot use imageHash, imageUrl, or imageCrops for video-link creatives."
+        });
+    }
+    launchCreativeFormatKeys.forEach((formatKey) => {
+        const format = value.formats?.[formatKey];
+        if (format && (format.imageHash || format.imageUrl || format.imageCrops)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `formats.${formatKey} cannot use imageHash, imageUrl, or imageCrops for video-link creatives.`
+            });
+        }
+    });
+});
+export const creativeCreateSpecSchema = z.discriminatedUnion("kind", [
+    imageLinkCreativeSpecSchema,
+    videoLinkCreativeSpecSchema
+]);
+export const adCreateSpecSchema = z.object({
+    adSetId: metaIdSchema("ad set id"),
+    creativeId: metaIdSchema("creative id"),
+    name: nonEmptyStringSchema,
+    status: pausedStatusSchema.optional()
+}).strict();
+async function ensureFileExists(filePath, label) {
+    const absolutePath = path.resolve(filePath);
+    try {
+        await access(absolutePath);
+        return absolutePath;
+    }
+    catch {
+        throw new AppError(`${label} does not exist: ${filePath}`, ExitCode.Usage, {
+            filePath: absolutePath
+        });
+    }
+}
+export async function resolveExistingFilePath(filePath, label, baseDir) {
+    if (!filePath.trim()) {
+        throw new AppError(`${label} is required.`, ExitCode.Usage);
+    }
+    return ensureFileExists(path.resolve(baseDir ?? process.cwd(), filePath), label);
+}
+export async function readSpecFile(specPath, schema, label) {
+    const absolutePath = await ensureFileExists(specPath, `${label} spec`);
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(absolutePath, "utf8"));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new AppError(`${label} spec must be valid JSON.`, ExitCode.Usage, {
+                specPath: absolutePath
+            });
+        }
+        throw error;
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw new AppError(`${label} spec is invalid.`, ExitCode.Usage, {
+            issues: result.error.issues,
+            specPath: absolutePath
+        });
+    }
+    return {
+        spec: result.data,
+        specPath: absolutePath
+    };
+}

package/dist/validators/launch-spec.d.ts

@@ -0,0 +1,229 @@
+import { z } from "zod";
+export declare const launchSpecSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    campaign: z.ZodObject<{
+        bidStrategy: z.ZodOptional<z.ZodEnum<{
+            LOWEST_COST_WITHOUT_CAP: "LOWEST_COST_WITHOUT_CAP";
+            LOWEST_COST_WITH_BID_CAP: "LOWEST_COST_WITH_BID_CAP";
+            COST_CAP: "COST_CAP";
+        }>>;
+        dailyBudget: z.ZodOptional<z.ZodNumber>;
+        lifetimeBudget: z.ZodOptional<z.ZodNumber>;
+        ref: z.ZodString;
+        name: z.ZodString;
+        objective: z.ZodEnum<{
+            APP_INSTALLS: "APP_INSTALLS";
+            BRAND_AWARENESS: "BRAND_AWARENESS";
+            CONVERSIONS: "CONVERSIONS";
+            EVENT_RESPONSES: "EVENT_RESPONSES";
+            LEAD_GENERATION: "LEAD_GENERATION";
+            LINK_CLICKS: "LINK_CLICKS";
+            LOCAL_AWARENESS: "LOCAL_AWARENESS";
+            MESSAGES: "MESSAGES";
+            OFFER_CLAIMS: "OFFER_CLAIMS";
+            OUTCOME_APP_PROMOTION: "OUTCOME_APP_PROMOTION";
+            OUTCOME_AWARENESS: "OUTCOME_AWARENESS";
+            OUTCOME_ENGAGEMENT: "OUTCOME_ENGAGEMENT";
+            OUTCOME_LEADS: "OUTCOME_LEADS";
+            OUTCOME_SALES: "OUTCOME_SALES";
+            OUTCOME_TRAFFIC: "OUTCOME_TRAFFIC";
+            PAGE_LIKES: "PAGE_LIKES";
+            POST_ENGAGEMENT: "POST_ENGAGEMENT";
+            PRODUCT_CATALOG_SALES: "PRODUCT_CATALOG_SALES";
+            REACH: "REACH";
+            STORE_VISITS: "STORE_VISITS";
+            VIDEO_VIEWS: "VIDEO_VIEWS";
+        }>;
+        specialAdCategories: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        status: z.ZodOptional<z.ZodLiteral<"PAUSED">>;
+    }, z.core.$strict>;
+    adSets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        campaignRef: z.ZodString;
+        bidAmount: z.ZodOptional<z.ZodNumber>;
+        bidStrategy: z.ZodOptional<z.ZodEnum<{
+            LOWEST_COST_WITHOUT_CAP: "LOWEST_COST_WITHOUT_CAP";
+            LOWEST_COST_WITH_BID_CAP: "LOWEST_COST_WITH_BID_CAP";
+            COST_CAP: "COST_CAP";
+        }>>;
+        billingEvent: z.ZodEnum<{
+            IMPRESSIONS: "IMPRESSIONS";
+            CLICKS: "CLICKS";
+        }>;
+        dailyBudget: z.ZodOptional<z.ZodNumber>;
+        endTime: z.ZodOptional<z.ZodString>;
+        lifetimeBudget: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodString;
+        optimizationGoal: z.ZodEnum<{
+            APP_INSTALLS: "APP_INSTALLS";
+            EVENT_RESPONSES: "EVENT_RESPONSES";
+            LEAD_GENERATION: "LEAD_GENERATION";
+            LINK_CLICKS: "LINK_CLICKS";
+            PAGE_LIKES: "PAGE_LIKES";
+            POST_ENGAGEMENT: "POST_ENGAGEMENT";
+            REACH: "REACH";
+            APP_INSTALLS_AND_OFFSITE_CONVERSIONS: "APP_INSTALLS_AND_OFFSITE_CONVERSIONS";
+            CONVERSATIONS: "CONVERSATIONS";
+            ENGAGED_PAGE_VIEWS: "ENGAGED_PAGE_VIEWS";
+            ENGAGED_USERS: "ENGAGED_USERS";
+            IMPRESSIONS: "IMPRESSIONS";
+            LANDING_PAGE_VIEWS: "LANDING_PAGE_VIEWS";
+            OFFSITE_CONVERSIONS: "OFFSITE_CONVERSIONS";
+            QUALITY_CALL: "QUALITY_CALL";
+            QUALITY_LEAD: "QUALITY_LEAD";
+            THRUPLAY: "THRUPLAY";
+            VALUE: "VALUE";
+            VISIT_INSTAGRAM_PROFILE: "VISIT_INSTAGRAM_PROFILE";
+        }>;
+        promotedObject: z.ZodObject<{
+            applicationId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            customConversionId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            customEventType: z.ZodOptional<z.ZodString>;
+            eventId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            instagramActorId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            objectStoreUrl: z.ZodOptional<z.ZodString>;
+            offlineConversionDataSetId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            pageId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            pixelId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            productSetId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            whatsappPhoneNumber: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        startTime: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodLiteral<"PAUSED">>;
+        targeting: z.ZodPipe<z.ZodObject<{
+            age_max: z.ZodOptional<z.ZodNumber>;
+            age_min: z.ZodOptional<z.ZodNumber>;
+            targeting_automation: z.ZodOptional<z.ZodObject<{
+                advantage_audience: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+                individual_setting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>>;
+            }, z.core.$catchall<z.ZodUnknown>>>;
+        }, z.core.$catchall<z.ZodUnknown>>, z.ZodTransform<{
+            [x: string]: unknown;
+            age_max?: number | undefined;
+            age_min?: number | undefined;
+            targeting_automation?: {
+                [x: string]: unknown;
+                advantage_audience?: 0 | 1 | undefined;
+                individual_setting?: Record<string, 0 | 1> | undefined;
+            } | undefined;
+        }, {
+            [x: string]: unknown;
+            age_max?: number | undefined;
+            age_min?: number | undefined;
+            targeting_automation?: {
+                [x: string]: unknown;
+                advantage_audience?: 0 | 1 | undefined;
+                individual_setting?: Record<string, 0 | 1> | undefined;
+            } | undefined;
+        }>>;
+    }, z.core.$strict>>>;
+    assets: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ref: z.ZodString;
+        kind: z.ZodLiteral<"image">;
+        file: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        ref: z.ZodString;
+        kind: z.ZodLiteral<"video">;
+        file: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>>;
+    creatives: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ref: z.ZodString;
+        kind: z.ZodLiteral<"link-image">;
+        assetRef: z.ZodOptional<z.ZodString>;
+        formats: z.ZodOptional<z.ZodObject<{
+            feed4x5: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+            square1x1: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+            story9x16: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        linkData: z.ZodObject<{
+            callToAction: z.ZodOptional<z.ZodEnum<{
+                SHOP_NOW: "SHOP_NOW";
+                LEARN_MORE: "LEARN_MORE";
+                SIGN_UP: "SIGN_UP";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+            headline: z.ZodOptional<z.ZodString>;
+            link: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>;
+        name: z.ZodOptional<z.ZodString>;
+        pageId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        platformCustomizations: z.ZodOptional<z.ZodObject<{
+            instagram: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        status: z.ZodOptional<z.ZodLiteral<"PAUSED">>;
+    }, z.core.$strict>, z.ZodObject<{
+        ref: z.ZodString;
+        kind: z.ZodLiteral<"video-link">;
+        assetRef: z.ZodOptional<z.ZodString>;
+        formats: z.ZodOptional<z.ZodObject<{
+            feed4x5: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+            square1x1: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+            story9x16: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        name: z.ZodOptional<z.ZodString>;
+        pageId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        platformCustomizations: z.ZodOptional<z.ZodObject<{
+            instagram: z.ZodOptional<z.ZodObject<{
+                assetRef: z.ZodString;
+                captionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                imageCrops: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        status: z.ZodOptional<z.ZodLiteral<"PAUSED">>;
+        videoData: z.ZodObject<{
+            callToAction: z.ZodOptional<z.ZodEnum<{
+                SHOP_NOW: "SHOP_NOW";
+                LEARN_MORE: "LEARN_MORE";
+                SIGN_UP: "SIGN_UP";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+            link: z.ZodString;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">>>;
+    ads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        name: z.ZodString;
+        adSetRef: z.ZodString;
+        creativeRef: z.ZodString;
+        status: z.ZodOptional<z.ZodLiteral<"PAUSED">>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type LaunchSpec = z.infer<typeof launchSpecSchema>;
+export declare function readLaunchSpecFile(specPath: string): Promise<{
+    spec: LaunchSpec;
+    specPath: string;
+}>;
+export declare function requireReceiptPath(value: string | undefined): string;