whale-code 6.5.6 → 6.5.8

package/dist/server/handlers/meta-ads-delete-publish-sync.test.js

@@ -0,0 +1,282 @@
+// meta-ads-delete-publish-sync.test.ts — Tests for delete, publish, and sync actions
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, seedTracked, cleanup, TEST_STORE, RUN_PREFIX } from "./__test-utils__/test-db.js";
+import { randomUUID } from "node:crypto";
+const originalFetch = globalThis.fetch;
+const mockFetch = vi.fn((...args) => originalFetch(...args));
+import { handleMetaAds } from "./meta-ads.js";
+const AD_ACCOUNT_ID = "act_123456789";
+const ACCESS_TOKEN = "EAAtest_access_token_123";
+const PAGE_ID = "page_987654321";
+const sb = getTestClient();
+function makeIntegrationRow(overrides = {}) {
+  return {
+    id: randomUUID(),
+    store_id: TEST_STORE,
+    app_id: `test_app_${RUN_PREFIX}`,
+    access_token_encrypted: ACCESS_TOKEN,
+    ad_account_id: AD_ACCOUNT_ID,
+    page_id: PAGE_ID,
+    pixel_id: "pixel_111",
+    instagram_business_id: "ig_222",
+    token_expires_at: "2027-01-01T00:00:00Z",
+    status: "active",
+    ...overrides
+  };
+}
+async function setupMetaIntegration(overrides = {}) {
+  await seedTracked("meta_integrations", [makeIntegrationRow(overrides)]);
+}
+function mockMetaFetchSuccess(responseData = {
+  id: "12345"
+}) {
+  mockFetch.mockImplementation((...args) => {
+    const url = typeof args[0] === "string" ? args[0] : args[0]?.url;
+    if (url && url.includes("graph.facebook.com")) {
+      return Promise.resolve({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(responseData),
+        text: () => Promise.resolve(JSON.stringify(responseData))
+      });
+    }
+    return originalFetch(...args);
+  });
+}
+function mockMetaFetchError(status = 400, errorBody) {
+  const body = errorBody || {
+    error: {
+      message: "Invalid parameter",
+      code: 100
+    }
+  };
+  mockFetch.mockImplementation((...args) => {
+    const url = typeof args[0] === "string" ? args[0] : args[0]?.url;
+    if (url && url.includes("graph.facebook.com")) {
+      return Promise.resolve({
+        ok: false,
+        status,
+        json: () => Promise.resolve(body),
+        text: () => Promise.resolve(JSON.stringify(body))
+      });
+    }
+    return originalFetch(...args);
+  });
+}
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — delete, publish, sync", () => {
+  beforeEach(async () => {
+    vi.restoreAllMocks();
+    vi.clearAllMocks();
+    mockFetch.mockImplementation((...args) => originalFetch(...args));
+    globalThis.fetch = mockFetch;
+    await sb.from("meta_ads").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_ad_sets").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_campaigns").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_integrations").delete().eq("store_id", TEST_STORE).then(() => {});
+  });
+  afterEach(async () => {
+    globalThis.fetch = originalFetch;
+    vi.restoreAllMocks();
+    await cleanup();
+    await sb.from("meta_ads").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_ad_sets").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_campaigns").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_integrations").delete().eq("store_id", TEST_STORE).then(() => {});
+  });
+  describe("action: delete", () => {
+    it("deletes a campaign (local only for draft)", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_delcamp`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} DelCamp`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "delete",
+        id: camp.id,
+        type: "campaign"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data.deleted).toBe(camp.id);
+      expect(data.type).toBe("campaign");
+    });
+    it("returns error when id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "delete",
+        type: "campaign"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("id required");
+    });
+    it("returns error when type is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "delete",
+        id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("type required");
+    });
+    it("returns error for invalid type", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "delete",
+        id: "x",
+        type: "invalid"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Invalid type");
+    });
+    it("attempts Meta API delete for published items", async () => {
+      await setupMetaIntegration();
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: "123456789",
+        meta_account_id: AD_ACCOUNT_ID,
+        name: `${RUN_PREFIX} Published`,
+        objective: "OUTCOME_AWARENESS",
+        status: "ACTIVE"
+      }]);
+      mockMetaFetchSuccess({
+        success: true
+      });
+      const result = await handleMetaAds(sb, {
+        action: "delete",
+        id: camp.id,
+        type: "campaign"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data.meta_deleted).toBe(true);
+    });
+  });
+  describe("action: publish", () => {
+    it("returns error when type is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "publish",
+        id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("type required");
+    });
+    it("returns error when id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "publish",
+        type: "campaign"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("id required");
+    });
+    it("returns error for invalid type", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "publish",
+        type: "invalid",
+        id: "x"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Invalid type");
+    });
+    it("publishes a campaign to Meta", async () => {
+      await setupMetaIntegration();
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_pub`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} ToPub`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      mockMetaFetchSuccess({
+        id: "99988877766"
+      });
+      const result = await handleMetaAds(sb, {
+        action: "publish",
+        type: "campaign",
+        id: camp.id
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when Meta API fails during publish", async () => {
+      await setupMetaIntegration();
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_failpub`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} FailPub`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      mockMetaFetchError(400, {
+        error: {
+          message: "Invalid parameter",
+          code: 100
+        }
+      });
+      const result = await handleMetaAds(sb, {
+        action: "publish",
+        type: "campaign",
+        id: camp.id
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+  });
+  describe("action: sync", () => {
+    it("returns error when campaign_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "sync"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("campaign_id required");
+    });
+    it("returns error for unpublished campaign", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_sync`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} Sync`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "sync",
+        campaign_id: camp.id
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("not published");
+    });
+    it("syncs stats from Meta for published campaign", async () => {
+      await setupMetaIntegration();
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: "99988877766",
+        meta_account_id: AD_ACCOUNT_ID,
+        name: `${RUN_PREFIX} LiveSync`,
+        objective: "OUTCOME_AWARENESS",
+        status: "ACTIVE"
+      }]);
+      mockMetaFetchSuccess({
+        name: "Live Campaign",
+        status: "ACTIVE",
+        effective_status: "ACTIVE",
+        daily_budget: "5000",
+        data: [{
+          spend: "123.45",
+          impressions: "10000",
+          clicks: "500"
+        }]
+      });
+      const result = await handleMetaAds(sb, {
+        action: "sync",
+        campaign_id: camp.id
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+  });
+});

package/dist/server/handlers/meta-ads-graph-api.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Meta Ads — Graph API low-level helpers, credentials, and page token management.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+import { type MetaIntegration } from "./meta-ads-types.js";
+/** RFC 3986 percent-encode. */
+export declare function enc(v: string): string;
+/**
+ * Parse Meta API error responses into human-readable messages.
+ * Extracts error_user_msg when available (much better than raw JSON).
+ */
+export declare function parseMetaError(body: string, path: string, status: number): string;
+/** GET from Meta Graph API with auto-pagination. */
+export declare function graphGet(path: string, fields: string, token: string, extra?: string): Promise<Record<string, unknown>>;
+/** POST to Meta Graph API with form encoding. */
+export declare function graphPost(path: string, params: Record<string, unknown>, token: string): Promise<Record<string, unknown>>;
+/** DELETE from Meta Graph API. */
+export declare function graphDelete(path: string, token: string): Promise<Record<string, unknown>>;
+export declare function getIntegration(sb: SupabaseClient, storeId: string): Promise<MetaIntegration>;
+/**
+ * Exchange user access token for a Page Access Token.
+ * Required for lead forms, page-level APIs, and some creative operations.
+ * Cached for 5 minutes.
+ */
+export declare function getPageToken(int: MetaIntegration): Promise<string>;

package/dist/server/handlers/meta-ads-graph-api.js

@@ -0,0 +1,155 @@
+/**
+ * Meta Ads — Graph API low-level helpers, credentials, and page token management.
+ */
+
+import { META_BASE } from "./meta-ads-types.js";
+
+// ============================================================================
+// GRAPH API — low-level Meta helpers
+// ============================================================================
+
+/** RFC 3986 percent-encode. */
+export function enc(v) {
+  return encodeURIComponent(v);
+}
+
+/** Build form-encoded body from params object + access_token. */
+function formBody(params, token) {
+  const parts = [`access_token=${enc(token)}`];
+  for (const [k, v] of Object.entries(params)) {
+    if (v === null || v === undefined) continue;
+    parts.push(`${k}=${enc(typeof v === "object" ? JSON.stringify(v) : String(v))}`);
+  }
+  return parts.join("&");
+}
+
+/**
+ * Parse Meta API error responses into human-readable messages.
+ * Extracts error_user_msg when available (much better than raw JSON).
+ */
+export function parseMetaError(body, path, status) {
+  try {
+    const json = JSON.parse(body);
+    const err = json.error || {};
+    const userMsg = err.error_user_msg || err.message || "Unknown error";
+    const code = err.code ? ` (code ${err.code})` : "";
+    return `Meta API ${path}: ${userMsg}${code}`;
+  } catch {
+    return `Meta API ${path}: ${status} — ${body.slice(0, 300)}`;
+  }
+}
+
+/** GET from Meta Graph API with auto-pagination. */
+export async function graphGet(path, fields, token, extra) {
+  let url = `${META_BASE}/${path}?fields=${fields}&access_token=${enc(token)}&limit=200`;
+  if (extra) url += `&${extra}`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(parseMetaError(body, path, res.status));
+  }
+  const page1 = await res.json();
+
+  // Single-object response — return as-is
+  if (!Array.isArray(page1.data)) return page1;
+
+  // List response — paginate up to 20 pages
+  const all = [...page1.data];
+  let next = page1.paging?.next;
+  let pages = 1;
+  while (next && pages < 20) {
+    const r = await fetch(next);
+    if (!r.ok) break;
+    const j = await r.json();
+    if (Array.isArray(j.data)) all.push(...j.data);
+    next = j.paging?.next;
+    pages++;
+  }
+  return {
+    data: all
+  };
+}
+
+/** POST to Meta Graph API with form encoding. */
+export async function graphPost(path, params, token) {
+  const res = await fetch(`${META_BASE}/${path}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body: formBody(params, token)
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(parseMetaError(body, path, res.status));
+  }
+  return await res.json();
+}
+
+/** DELETE from Meta Graph API. */
+export async function graphDelete(path, token) {
+  const res = await fetch(`${META_BASE}/${path}?access_token=${enc(token)}`, {
+    method: "DELETE"
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(parseMetaError(body, path, res.status));
+  }
+  return await res.json();
+}
+
+// ============================================================================
+// CREDENTIALS
+// ============================================================================
+
+export async function getIntegration(sb, storeId) {
+  const {
+    data,
+    error
+  } = await sb.from("meta_integrations").select("access_token_encrypted, ad_account_id, business_id, page_id, pixel_id, instagram_business_id, token_expires_at, status").eq("store_id", storeId).limit(1).single();
+  if (error || !data?.access_token_encrypted || !data?.ad_account_id) {
+    throw new Error("Meta not connected. Go to Settings → Meta Connection to link your account.");
+  }
+  // Warn if token is expired (but still return it — some operations may work with refresh)
+  if (data.token_expires_at) {
+    const expiresAt = new Date(data.token_expires_at);
+    if (expiresAt < new Date()) {
+      throw new Error(`Meta access token expired at ${expiresAt.toISOString()}. Reconnect in the CRM app (Settings → Meta Connection).`);
+    }
+  }
+  return {
+    accessToken: data.access_token_encrypted,
+    adAccountId: data.ad_account_id,
+    businessId: data.business_id || null,
+    pageId: data.page_id || null,
+    pixelId: data.pixel_id || null,
+    instagramAccountId: data.instagram_business_id || null,
+    tokenExpiresAt: data.token_expires_at || null
+  };
+}
+
+/** Page Access Token cache (user token → page token). Avoids re-fetching every call. */
+const pageTokenCache = new Map();
+
+/**
+ * Exchange user access token for a Page Access Token.
+ * Required for lead forms, page-level APIs, and some creative operations.
+ * Cached for 5 minutes.
+ */
+export async function getPageToken(int) {
+  if (!int.pageId) throw new Error("No Facebook Page linked. Add page_id in Meta Connection settings.");
+  const cacheKey = `${int.pageId}:${int.accessToken.slice(-10)}`;
+  const cached = pageTokenCache.get(cacheKey);
+  if (cached && Date.now() - cached.fetchedAt < 300_000) return cached.token;
+  const result = await graphGet(int.pageId, "access_token", int.accessToken);
+  const pageToken = result.access_token;
+  if (!pageToken) throw new Error("Could not get Page Access Token. Ensure your token has pages_manage_ads permission.");
+  pageTokenCache.set(cacheKey, {
+    token: pageToken,
+    fetchedAt: Date.now()
+  });
+  // Evict old entries
+  if (pageTokenCache.size > 20) pageTokenCache.delete([...pageTokenCache.keys()][0]);
+  return pageToken;
+}
+//# sourceMappingURL=meta-ads-graph-api.js.map

package/dist/server/handlers/meta-ads-graph-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-ads-graph-api.js","names":["META_BASE","enc","v","encodeURIComponent","formBody","params","token","parts","k","Object","entries","undefined","push","JSON","stringify","String","join","parseMetaError","body","path","status","json","parse","err","error","userMsg","error_user_msg","message","code","slice","graphGet","fields","extra","url","res","fetch","ok","text","Error","page1","Array","isArray","data","all","next","paging","pages","r","j","graphPost","method","headers","graphDelete","getIntegration","sb","storeId","from","select","eq","limit","single","access_token_encrypted","ad_account_id","token_expires_at","expiresAt","Date","toISOString","accessToken","adAccountId","businessId","business_id","pageId","page_id","pixelId","pixel_id","instagramAccountId","instagram_business_id","tokenExpiresAt","pageTokenCache","Map","getPageToken","int","cacheKey","cached","get","now","fetchedAt","result","pageToken","access_token","set","size","delete","keys"],"sources":["../../../src/server/handlers/meta-ads-graph-api.ts"],"sourcesContent":["/**\n * Meta Ads — Graph API low-level helpers, credentials, and page token management.\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { META_BASE, type MetaIntegration } from \"./meta-ads-types.js\";\n\n// ============================================================================\n// GRAPH API — low-level Meta helpers\n// ============================================================================\n\n/** RFC 3986 percent-encode. */\nexport function enc(v: string): string {\n  return encodeURIComponent(v);\n}\n\n/** Build form-encoded body from params object + access_token. */\nfunction formBody(params: Record<string, unknown>, token: string): string {\n  const parts: string[] = [`access_token=${enc(token)}`];\n  for (const [k, v] of Object.entries(params)) {\n    if (v === null || v === undefined) continue;\n    parts.push(`${k}=${enc(typeof v === \"object\" ? JSON.stringify(v) : String(v))}`);\n  }\n  return parts.join(\"&\");\n}\n\n/**\n * Parse Meta API error responses into human-readable messages.\n * Extracts error_user_msg when available (much better than raw JSON).\n */\nexport function parseMetaError(body: string, path: string, status: number): string {\n  try {\n    const json = JSON.parse(body);\n    const err = json.error || {};\n    const userMsg = err.error_user_msg || err.message || \"Unknown error\";\n    const code = err.code ? ` (code ${err.code})` : \"\";\n    return `Meta API ${path}: ${userMsg}${code}`;\n  } catch {\n    return `Meta API ${path}: ${status} — ${body.slice(0, 300)}`;\n  }\n}\n\n/** GET from Meta Graph API with auto-pagination. */\nexport async function graphGet(\n  path: string,\n  fields: string,\n  token: string,\n  extra?: string,\n): Promise<Record<string, unknown>> {\n  let url = `${META_BASE}/${path}?fields=${fields}&access_token=${enc(token)}&limit=200`;\n  if (extra) url += `&${extra}`;\n\n  const res = await fetch(url);\n  if (!res.ok) {\n    const body = await res.text();\n    throw new Error(parseMetaError(body, path, res.status));\n  }\n  const page1 = (await res.json()) as Record<string, unknown>;\n\n  // Single-object response — return as-is\n  if (!Array.isArray(page1.data)) return page1;\n\n  // List response — paginate up to 20 pages\n  const all = [...(page1.data as Record<string, unknown>[])];\n  let next = (page1.paging as Record<string, unknown>)?.next as string | undefined;\n  let pages = 1;\n  while (next && pages < 20) {\n    const r = await fetch(next);\n    if (!r.ok) break;\n    const j = (await r.json()) as Record<string, unknown>;\n    if (Array.isArray(j.data)) all.push(...(j.data as Record<string, unknown>[]));\n    next = (j.paging as Record<string, unknown>)?.next as string | undefined;\n    pages++;\n  }\n  return { data: all };\n}\n\n/** POST to Meta Graph API with form encoding. */\nexport async function graphPost(\n  path: string,\n  params: Record<string, unknown>,\n  token: string,\n): Promise<Record<string, unknown>> {\n  const res = await fetch(`${META_BASE}/${path}`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n    body: formBody(params, token),\n  });\n  if (!res.ok) {\n    const body = await res.text();\n    throw new Error(parseMetaError(body, path, res.status));\n  }\n  return (await res.json()) as Record<string, unknown>;\n}\n\n/** DELETE from Meta Graph API. */\nexport async function graphDelete(\n  path: string,\n  token: string,\n): Promise<Record<string, unknown>> {\n  const res = await fetch(`${META_BASE}/${path}?access_token=${enc(token)}`, {\n    method: \"DELETE\",\n  });\n  if (!res.ok) {\n    const body = await res.text();\n    throw new Error(parseMetaError(body, path, res.status));\n  }\n  return (await res.json()) as Record<string, unknown>;\n}\n\n// ============================================================================\n// CREDENTIALS\n// ============================================================================\n\nexport async function getIntegration(sb: SupabaseClient, storeId: string): Promise<MetaIntegration> {\n  const { data, error } = await sb\n    .from(\"meta_integrations\")\n    .select(\"access_token_encrypted, ad_account_id, business_id, page_id, pixel_id, instagram_business_id, token_expires_at, status\")\n    .eq(\"store_id\", storeId)\n    .limit(1)\n    .single();\n  if (error || !data?.access_token_encrypted || !data?.ad_account_id) {\n    throw new Error(\"Meta not connected. Go to Settings → Meta Connection to link your account.\");\n  }\n  // Warn if token is expired (but still return it — some operations may work with refresh)\n  if (data.token_expires_at) {\n    const expiresAt = new Date(data.token_expires_at);\n    if (expiresAt < new Date()) {\n      throw new Error(`Meta access token expired at ${expiresAt.toISOString()}. Reconnect in the CRM app (Settings → Meta Connection).`);\n    }\n  }\n  return {\n    accessToken: data.access_token_encrypted,\n    adAccountId: data.ad_account_id,\n    businessId: data.business_id || null,\n    pageId: data.page_id || null,\n    pixelId: data.pixel_id || null,\n    instagramAccountId: data.instagram_business_id || null,\n    tokenExpiresAt: data.token_expires_at || null,\n  };\n}\n\n/** Page Access Token cache (user token → page token). Avoids re-fetching every call. */\nconst pageTokenCache = new Map<string, { token: string; fetchedAt: number }>();\n\n/**\n * Exchange user access token for a Page Access Token.\n * Required for lead forms, page-level APIs, and some creative operations.\n * Cached for 5 minutes.\n */\nexport async function getPageToken(int: MetaIntegration): Promise<string> {\n  if (!int.pageId) throw new Error(\"No Facebook Page linked. Add page_id in Meta Connection settings.\");\n\n  const cacheKey = `${int.pageId}:${int.accessToken.slice(-10)}`;\n  const cached = pageTokenCache.get(cacheKey);\n  if (cached && Date.now() - cached.fetchedAt < 300_000) return cached.token;\n\n  const result = await graphGet(int.pageId, \"access_token\", int.accessToken);\n  const pageToken = result.access_token as string;\n  if (!pageToken) throw new Error(\"Could not get Page Access Token. Ensure your token has pages_manage_ads permission.\");\n\n  pageTokenCache.set(cacheKey, { token: pageToken, fetchedAt: Date.now() });\n  // Evict old entries\n  if (pageTokenCache.size > 20) pageTokenCache.delete([...pageTokenCache.keys()][0]);\n\n  return pageToken;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/handlers/meta-ads-insights.test.js

@@ -0,0 +1,80 @@
+// meta-ads-insights.test.ts — Tests for handleMetaAds insights_breakdown and ad_preview
+// (Split from meta-ads-publish.test.ts)
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { HAS_TEST_DB, getTestClient, seedTracked, cleanup, TEST_STORE, RUN_PREFIX } from "./__test-utils__/test-db.js";
+import { randomUUID } from "node:crypto";
+const originalFetch = globalThis.fetch;
+const mockFetch = vi.fn((...args) => originalFetch(...args));
+import { handleMetaAds } from "./meta-ads.js";
+const sb = getTestClient();
+
+// ---------------------------------------------------------------------------
+// Tests — Insights Breakdown & Ad Preview
+// ---------------------------------------------------------------------------
+
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — insights & preview", () => {
+  beforeEach(async () => {
+    vi.restoreAllMocks();
+    vi.clearAllMocks();
+    mockFetch.mockImplementation((...args) => originalFetch(...args));
+    globalThis.fetch = mockFetch;
+    await sb.from("meta_ads").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_ad_sets").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_campaigns").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_integrations").delete().eq("store_id", TEST_STORE).then(() => {});
+  });
+  afterEach(async () => {
+    globalThis.fetch = originalFetch;
+    vi.restoreAllMocks();
+    await cleanup();
+    await sb.from("meta_ads").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_ad_sets").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_campaigns").delete().eq("store_id", TEST_STORE).then(() => {});
+    await sb.from("meta_integrations").delete().eq("store_id", TEST_STORE).then(() => {});
+  });
+
+  // ========================================================================
+  // INSIGHTS_BREAKDOWN
+  // ========================================================================
+
+  describe("action: insights_breakdown", () => {
+    it("returns error when no ID is provided", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "insights_breakdown"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+    it("returns error for unpublished entity", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_ins`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} Insights`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "insights_breakdown",
+        campaign_id: camp.id
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("not published");
+    });
+  });
+
+  // ========================================================================
+  // AD_PREVIEW
+  // ========================================================================
+
+  describe("action: ad_preview", () => {
+    it("returns error when ad_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "ad_preview"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("ad_id required");
+    });
+  });
+});