cli-meta-ads 0.1.0

package/dist/domain/launch-service.d.ts

@@ -0,0 +1,200 @@
+import type { LaunchSpec } from "../validators/launch-spec.js";
+import type { MetaAdsService } from "./meta-ads-service.js";
+type LaunchStepKind = "campaign.create" | "adset.create" | "asset.image.upload" | "asset.video.upload" | "asset.video.wait" | "creative.create" | "ad.create";
+export interface LaunchStep {
+    detail: string;
+    id: string;
+    kind: LaunchStepKind;
+    ref: string;
+    status: "pending" | "completed";
+}
+export interface LaunchReceipt {
+    version: 1;
+    accountId: string;
+    created: {
+        ads: Record<string, {
+            id: string;
+        }>;
+        adSets: Record<string, {
+            id: string;
+        }>;
+        assets: Record<string, {
+            kind: "image";
+            imageHash: string;
+            name?: string | undefined;
+        } | {
+            kind: "video";
+            name?: string | undefined;
+            status?: string | undefined;
+            videoId: string;
+        }>;
+        campaign?: {
+            id: string;
+            ref: string;
+        } | undefined;
+        creatives: Record<string, {
+            id: string;
+        }>;
+    };
+    executionId: string;
+    lastError?: {
+        message: string;
+        stepId: string;
+    } | undefined;
+    receiptPath: string;
+    spec: LaunchSpec;
+    specPath: string;
+    status: "running" | "waiting_for_video" | "completed" | "failed";
+    steps: LaunchStep[];
+    updatedAt: string;
+}
+export declare function buildLaunchSteps(spec: LaunchSpec): LaunchStep[];
+export declare class LaunchService {
+    private readonly service;
+    constructor(service: MetaAdsService);
+    buildPlan(accountId: string, specPath: string, spec: LaunchSpec): {
+        data: {
+            accountId: string;
+            specPath: string;
+            steps: LaunchStep[];
+            summary: {
+                ads: number;
+                adSets: number;
+                assets: number;
+                creatives: number;
+            };
+        };
+        warnings: string[];
+    };
+    validate(accountId: string, specPath: string, spec: LaunchSpec): {
+        data: {
+            accountId: string;
+            specPath: string;
+            summary: {
+                ads: number;
+                adSets: number;
+                assets: number;
+                campaignRef: string;
+                creatives: number;
+            };
+            valid: boolean;
+        };
+        warnings: string[];
+    };
+    apply(options: {
+        accountId: string;
+        receiptPath?: string | undefined;
+        spec: LaunchSpec;
+        specPath: string;
+    }): Promise<{
+        data: {
+            created: {
+                ads: {
+                    id: string;
+                    ref: string;
+                }[];
+                adSets: {
+                    id: string;
+                    ref: string;
+                }[];
+                assets: ({
+                    kind: "image";
+                    imageHash: string;
+                    name?: string | undefined;
+                    ref: string;
+                } | {
+                    kind: "video";
+                    name?: string | undefined;
+                    status?: string | undefined;
+                    videoId: string;
+                    ref: string;
+                })[];
+                campaign: {
+                    id: string;
+                    ref: string;
+                } | undefined;
+                creatives: {
+                    id: string;
+                    ref: string;
+                }[];
+            };
+            executionId: string;
+            receiptPath: string;
+            status: "failed" | "completed" | "running" | "waiting_for_video";
+        };
+        warnings: string[];
+    }>;
+    previewResume(receiptPath: string): Promise<{
+        created: {
+            ads: {
+                id: string;
+                ref: string;
+            }[];
+            adSets: {
+                id: string;
+                ref: string;
+            }[];
+            assets: ({
+                kind: "image";
+                imageHash: string;
+                name?: string | undefined;
+                ref: string;
+            } | {
+                kind: "video";
+                name?: string | undefined;
+                status?: string | undefined;
+                videoId: string;
+                ref: string;
+            })[];
+            campaign: {
+                id: string;
+                ref: string;
+            } | undefined;
+            creatives: {
+                id: string;
+                ref: string;
+            }[];
+        };
+        executionId: string;
+        pendingSteps: LaunchStep[];
+        receiptPath: string;
+        status: "failed" | "completed" | "running" | "waiting_for_video";
+    }>;
+    resume(receiptPath: string): Promise<{
+        created: {
+            ads: {
+                id: string;
+                ref: string;
+            }[];
+            adSets: {
+                id: string;
+                ref: string;
+            }[];
+            assets: ({
+                kind: "image";
+                imageHash: string;
+                name?: string | undefined;
+                ref: string;
+            } | {
+                kind: "video";
+                name?: string | undefined;
+                status?: string | undefined;
+                videoId: string;
+                ref: string;
+            })[];
+            campaign: {
+                id: string;
+                ref: string;
+            } | undefined;
+            creatives: {
+                id: string;
+                ref: string;
+            }[];
+        };
+        executionId: string;
+        pendingSteps: LaunchStep[];
+        receiptPath: string;
+        status: "failed" | "completed" | "running" | "waiting_for_video";
+    }>;
+}
+export {};