whale-code 6.5.6 → 6.5.7

package/dist/server/handlers/meta-ads-targeting.js

@@ -0,0 +1,323 @@
+/**
+ * Meta Ads — targeting builder: location/interest resolution + targeting spec construction.
+ */
+
+import { META_BASE } from "./meta-ads-types.js";
+import { enc } from "./meta-ads-graph-api.js";
+
+// ============================================================================
+// AUDIENCE ID RESOLUTION
+// ============================================================================
+
+export async function resolveAudienceIds(sb, ids) {
+  if (!ids.length) return [];
+  const {
+    data
+  } = await sb.from("meta_audiences").select("id, meta_audience_id").in("id", ids);
+  return (data || []).filter(r => r.meta_audience_id).map(r => ({
+    id: r.meta_audience_id
+  }));
+}
+
+// ============================================================================
+// LOCATION RESOLUTION
+// ============================================================================
+
+/**
+ * Resolve natural-language location strings to Meta geo_locations.
+ * Accepts: ["Charlotte, NC", "US", "New York", "90210"]
+ * Returns: { countries: [...], cities: [...], regions: [...], zips: [...] }
+ */
+export async function resolveLocations(int, locations) {
+  const geo = {};
+  const countries = [];
+  const regions = [];
+  const cities = [];
+  const zips = [];
+  for (const loc of locations) {
+    const trimmed = loc.trim();
+    if (!trimmed) continue;
+
+    // 2-letter country code
+    if (/^[A-Z]{2}$/i.test(trimmed)) {
+      countries.push(trimmed.toUpperCase());
+      continue;
+    }
+
+    // ZIP code (5-digit US)
+    if (/^\d{5}$/.test(trimmed)) {
+      try {
+        const url = `${META_BASE}/search?type=adgeolocation&q=${enc(trimmed)}&location_types=["zip"]&access_token=${enc(int.accessToken)}&limit=1`;
+        const res = await fetch(url);
+        if (res.ok) {
+          const json = await res.json();
+          const results = json.data;
+          if (results?.[0]?.key) {
+            zips.push({
+              key: results[0].key
+            });
+            continue;
+          }
+        }
+      } catch {/* fall through to general search */}
+      zips.push({
+        key: trimmed
+      });
+      continue;
+    }
+
+    // General search — let Meta figure out if it's a city, region, etc.
+    try {
+      const url = `${META_BASE}/search?type=adgeolocation&q=${enc(trimmed)}&access_token=${enc(int.accessToken)}&limit=3`;
+      const res = await fetch(url);
+      if (!res.ok) continue;
+      const json = await res.json();
+      const results = json.data;
+      if (!results?.length) continue;
+      const best = results[0];
+      const key = best.key;
+      const type = best.type;
+      switch (type) {
+        case "country":
+          countries.push(key);
+          break;
+        case "region":
+          regions.push({
+            key
+          });
+          break;
+        case "city":
+          cities.push({
+            key,
+            radius: 25,
+            distance_unit: "mile"
+          });
+          break;
+        case "zip":
+          zips.push({
+            key
+          });
+          break;
+        case "geo_market":
+          geo.geo_markets || (geo.geo_markets = []);
+          geo.geo_markets.push({
+            key
+          });
+          break;
+        default:
+          if (key) cities.push({
+            key,
+            radius: 25,
+            distance_unit: "mile"
+          });
+      }
+    } catch {/* skip unresolvable locations */}
+  }
+  if (countries.length) geo.countries = countries;
+  if (regions.length) geo.regions = regions;
+  if (cities.length) geo.cities = cities;
+  if (zips.length) geo.zips = zips;
+
+  // Fallback: if nothing resolved, default to US
+  if (!Object.keys(geo).length) geo.countries = ["US"];
+  return geo;
+}
+
+// ============================================================================
+// INTEREST RESOLUTION
+// ============================================================================
+
+/**
+ * Resolve natural-language interest strings to Meta interest IDs.
+ * Accepts: ["streetwear", "hip hop music", "cannabis"]
+ */
+export async function resolveInterests(int, interests) {
+  const resolved = [];
+  for (const term of interests) {
+    const trimmed = term.trim();
+    if (!trimmed) continue;
+    try {
+      const url = `${META_BASE}/search?type=adinterest&q=${enc(trimmed)}&access_token=${enc(int.accessToken)}&limit=3`;
+      const res = await fetch(url);
+      if (!res.ok) continue;
+      const json = await res.json();
+      const results = json.data;
+      if (results?.length) {
+        const best = results[0];
+        if (best.id && best.name) {
+          resolved.push({
+            id: String(best.id),
+            name: best.name
+          });
+        }
+      }
+    } catch {/* skip unresolvable interests */}
+  }
+  return resolved;
+}
+
+// ============================================================================
+// TARGETING SPEC BUILDER
+// ============================================================================
+
+/**
+ * Convert targeting args → Meta API targeting spec.
+ * Accepts THREE formats (auto-detected).
+ */
+export async function buildTargeting(sb, raw, int) {
+  const fallback = {
+    geo_locations: {
+      countries: ["US"]
+    },
+    targeting_automation: {
+      advantage_audience: 0
+    }
+  };
+  let t;
+  if (!raw) return fallback;
+  if (typeof raw === "string") {
+    try {
+      t = JSON.parse(raw);
+    } catch {
+      return fallback;
+    }
+  } else {
+    t = raw;
+  }
+
+  // Already in Meta format (synced from Meta) — ensure advantage_audience is set
+  if (t.geo_locations) {
+    if (!t.targeting_automation) {
+      const advVal = t.advantage_audience === true || t.advantage_audience === 1 ? 1 : 0;
+      t.targeting_automation = {
+        advantage_audience: advVal
+      };
+    }
+    return t;
+  }
+  const result = {};
+
+  // === LOCATIONS ===
+  const simpleLocs = t.locations;
+  if (Array.isArray(simpleLocs) && simpleLocs.length > 0 && typeof simpleLocs[0] === "string" && int) {
+    result.geo_locations = await resolveLocations(int, simpleLocs);
+  } else {
+    const locs = t.locations_v2;
+    if (Array.isArray(locs) && locs.length > 0) {
+      const geo = {};
+      const countries = [];
+      const regions = [];
+      const cities = [];
+      const zips = [];
+      const markets = [];
+      for (const loc of locs) {
+        if (!loc.key || !loc.type) continue;
+        switch (loc.type) {
+          case "country":
+            countries.push(loc.key);
+            break;
+          case "region":
+            regions.push({
+              key: loc.key
+            });
+            break;
+          case "city":
+            cities.push({
+              key: loc.key
+            });
+            break;
+          case "zip":
+            zips.push({
+              key: loc.key
+            });
+            break;
+          case "geo_market":
+            markets.push({
+              key: loc.key
+            });
+            break;
+          default:
+            countries.push(loc.key);
+        }
+      }
+      if (countries.length) geo.countries = countries;
+      if (regions.length) geo.regions = regions;
+      if (cities.length) geo.cities = cities;
+      if (zips.length) geo.zips = zips;
+      if (markets.length) geo.geo_markets = markets;
+      result.geo_locations = geo;
+    } else if (typeof t.locations === "string" && t.locations) {
+      result.geo_locations = {
+        countries: t.locations.split(",").map(s => s.trim().toUpperCase())
+      };
+    } else {
+      result.geo_locations = {
+        countries: ["US"]
+      };
+    }
+  }
+
+  // === DEMOGRAPHICS ===
+  if (t.age_min != null) result.age_min = Math.max(Number(t.age_min) || 18, 13);
+  if (t.age_max != null) result.age_max = Math.min(Number(t.age_max) || 65, 65);
+  if (t.genders === "male") result.genders = [1];else if (t.genders === "female") result.genders = [2];
+
+  // === INTERESTS ===
+  const simpleInts = t.interests;
+  if (Array.isArray(simpleInts) && simpleInts.length > 0 && typeof simpleInts[0] === "string" && int) {
+    const resolved = await resolveInterests(int, simpleInts);
+    if (resolved.length) result.flexible_spec = [{
+      interests: resolved
+    }];
+  } else {
+    const ints = t.interests_v2;
+    if (Array.isArray(ints) && ints.length > 0) {
+      const valid = ints.filter(i => i.id && i.name).map(i => ({
+        id: i.id,
+        name: i.name
+      }));
+      if (valid.length) result.flexible_spec = [{
+        interests: valid
+      }];
+    }
+  }
+
+  // === CUSTOM AUDIENCES ===
+  if (typeof t.custom_audiences === "string" && t.custom_audiences) {
+    const resolved = await resolveAudienceIds(sb, t.custom_audiences.split(",").map(s => s.trim()));
+    if (resolved.length) result.custom_audiences = resolved;
+  } else if (Array.isArray(t.custom_audiences)) {
+    result.custom_audiences = t.custom_audiences;
+  }
+
+  // === EXCLUDED AUDIENCES ===
+  if (typeof t.excluded_custom_audiences === "string" && t.excluded_custom_audiences) {
+    const resolved = await resolveAudienceIds(sb, t.excluded_custom_audiences.split(",").map(s => s.trim()));
+    if (resolved.length) result.excluded_custom_audiences = resolved;
+  }
+
+  // === Advantage audience flag ===
+  const advAud = t.advantage_audience === true || t.advantage_audience === 1 ? 1 : 0;
+  result.targeting_automation = {
+    advantage_audience: advAud
+  };
+
+  // === PUBLISHER PLATFORMS (placement control) ===
+  if (Array.isArray(t.publisher_platforms)) {
+    result.publisher_platforms = t.publisher_platforms;
+  }
+  if (Array.isArray(t.facebook_positions)) {
+    result.facebook_positions = t.facebook_positions;
+  }
+  if (Array.isArray(t.instagram_positions)) {
+    result.instagram_positions = t.instagram_positions;
+  }
+  if (Array.isArray(t.audience_network_positions)) {
+    result.audience_network_positions = t.audience_network_positions;
+  }
+  if (Array.isArray(t.messenger_positions)) {
+    result.messenger_positions = t.messenger_positions;
+  }
+  return result;
+}
+//# sourceMappingURL=meta-ads-targeting.js.map

package/dist/server/handlers/meta-ads-targeting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-ads-targeting.js","names":["META_BASE","enc","resolveAudienceIds","sb","ids","length","data","from","select","in","filter","r","meta_audience_id","map","id","resolveLocations","int","locations","geo","countries","regions","cities","zips","loc","trimmed","trim","test","push","toUpperCase","url","accessToken","res","fetch","ok","json","results","key","best","type","radius","distance_unit","geo_markets","Object","keys","resolveInterests","interests","resolved","term","name","String","buildTargeting","raw","fallback","geo_locations","targeting_automation","advantage_audience","t","JSON","parse","advVal","result","simpleLocs","Array","isArray","locs","locations_v2","markets","split","s","age_min","Math","max","Number","age_max","min","genders","simpleInts","flexible_spec","ints","interests_v2","valid","i","custom_audiences","excluded_custom_audiences","advAud","publisher_platforms","facebook_positions","instagram_positions","audience_network_positions","messenger_positions"],"sources":["../../../src/server/handlers/meta-ads-targeting.ts"],"sourcesContent":["/**\n * Meta Ads — targeting builder: location/interest resolution + targeting spec construction.\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { META_BASE, type MetaIntegration } from \"./meta-ads-types.js\";\nimport { enc } from \"./meta-ads-graph-api.js\";\n\n// ============================================================================\n// AUDIENCE ID RESOLUTION\n// ============================================================================\n\nexport async function resolveAudienceIds(\n  sb: SupabaseClient,\n  ids: string[],\n): Promise<Array<{ id: string }>> {\n  if (!ids.length) return [];\n  const { data } = await sb\n    .from(\"meta_audiences\")\n    .select(\"id, meta_audience_id\")\n    .in(\"id\", ids);\n  return (data || [])\n    .filter((r: { meta_audience_id?: string }) => r.meta_audience_id)\n    .map((r: { meta_audience_id: string }) => ({ id: r.meta_audience_id }));\n}\n\n// ============================================================================\n// LOCATION RESOLUTION\n// ============================================================================\n\n/**\n * Resolve natural-language location strings to Meta geo_locations.\n * Accepts: [\"Charlotte, NC\", \"US\", \"New York\", \"90210\"]\n * Returns: { countries: [...], cities: [...], regions: [...], zips: [...] }\n */\nexport async function resolveLocations(\n  int: MetaIntegration,\n  locations: string[],\n): Promise<Record<string, unknown>> {\n  const geo: Record<string, unknown> = {};\n  const countries: string[] = [];\n  const regions: Array<{ key: string }> = [];\n  const cities: Array<{ key: string; radius?: number; distance_unit?: string }> = [];\n  const zips: Array<{ key: string }> = [];\n\n  for (const loc of locations) {\n    const trimmed = loc.trim();\n    if (!trimmed) continue;\n\n    // 2-letter country code\n    if (/^[A-Z]{2}$/i.test(trimmed)) {\n      countries.push(trimmed.toUpperCase());\n      continue;\n    }\n\n    // ZIP code (5-digit US)\n    if (/^\\d{5}$/.test(trimmed)) {\n      try {\n        const url = `${META_BASE}/search?type=adgeolocation&q=${enc(trimmed)}&location_types=[\"zip\"]&access_token=${enc(int.accessToken)}&limit=1`;\n        const res = await fetch(url);\n        if (res.ok) {\n          const json = (await res.json()) as Record<string, unknown>;\n          const results = json.data as Array<Record<string, unknown>>;\n          if (results?.[0]?.key) {\n            zips.push({ key: results[0].key as string });\n            continue;\n          }\n        }\n      } catch { /* fall through to general search */ }\n      zips.push({ key: trimmed });\n      continue;\n    }\n\n    // General search — let Meta figure out if it's a city, region, etc.\n    try {\n      const url = `${META_BASE}/search?type=adgeolocation&q=${enc(trimmed)}&access_token=${enc(int.accessToken)}&limit=3`;\n      const res = await fetch(url);\n      if (!res.ok) continue;\n      const json = (await res.json()) as Record<string, unknown>;\n      const results = json.data as Array<Record<string, unknown>>;\n      if (!results?.length) continue;\n\n      const best = results[0];\n      const key = best.key as string;\n      const type = best.type as string;\n\n      switch (type) {\n        case \"country\": countries.push(key); break;\n        case \"region\": regions.push({ key }); break;\n        case \"city\": cities.push({ key, radius: 25, distance_unit: \"mile\" }); break;\n        case \"zip\": zips.push({ key }); break;\n        case \"geo_market\": (geo.geo_markets as Array<{ key: string }> || (geo.geo_markets = [])); (geo.geo_markets as Array<{ key: string }>).push({ key }); break;\n        default:\n          if (key) cities.push({ key, radius: 25, distance_unit: \"mile\" });\n      }\n    } catch { /* skip unresolvable locations */ }\n  }\n\n  if (countries.length) geo.countries = countries;\n  if (regions.length) geo.regions = regions;\n  if (cities.length) geo.cities = cities;\n  if (zips.length) geo.zips = zips;\n\n  // Fallback: if nothing resolved, default to US\n  if (!Object.keys(geo).length) geo.countries = [\"US\"];\n\n  return geo;\n}\n\n// ============================================================================\n// INTEREST RESOLUTION\n// ============================================================================\n\n/**\n * Resolve natural-language interest strings to Meta interest IDs.\n * Accepts: [\"streetwear\", \"hip hop music\", \"cannabis\"]\n */\nexport async function resolveInterests(\n  int: MetaIntegration,\n  interests: string[],\n): Promise<Array<{ id: string; name: string }>> {\n  const resolved: Array<{ id: string; name: string }> = [];\n\n  for (const term of interests) {\n    const trimmed = term.trim();\n    if (!trimmed) continue;\n\n    try {\n      const url = `${META_BASE}/search?type=adinterest&q=${enc(trimmed)}&access_token=${enc(int.accessToken)}&limit=3`;\n      const res = await fetch(url);\n      if (!res.ok) continue;\n      const json = (await res.json()) as Record<string, unknown>;\n      const results = json.data as Array<Record<string, unknown>>;\n\n      if (results?.length) {\n        const best = results[0];\n        if (best.id && best.name) {\n          resolved.push({ id: String(best.id), name: best.name as string });\n        }\n      }\n    } catch { /* skip unresolvable interests */ }\n  }\n\n  return resolved;\n}\n\n// ============================================================================\n// TARGETING SPEC BUILDER\n// ============================================================================\n\n/**\n * Convert targeting args → Meta API targeting spec.\n * Accepts THREE formats (auto-detected).\n */\nexport async function buildTargeting(\n  sb: SupabaseClient,\n  raw: Record<string, unknown> | string | null | undefined,\n  int?: MetaIntegration | null,\n): Promise<Record<string, unknown>> {\n  const fallback = {\n    geo_locations: { countries: [\"US\"] },\n    targeting_automation: { advantage_audience: 0 },\n  };\n\n  let t: Record<string, unknown>;\n  if (!raw) return fallback;\n  if (typeof raw === \"string\") {\n    try { t = JSON.parse(raw); } catch { return fallback; }\n  } else {\n    t = raw;\n  }\n\n  // Already in Meta format (synced from Meta) — ensure advantage_audience is set\n  if (t.geo_locations) {\n    if (!t.targeting_automation) {\n      const advVal = t.advantage_audience === true || t.advantage_audience === 1 ? 1 : 0;\n      t.targeting_automation = { advantage_audience: advVal };\n    }\n    return t;\n  }\n\n  const result: Record<string, unknown> = {};\n\n  // === LOCATIONS ===\n  const simpleLocs = t.locations as string[] | undefined;\n  if (Array.isArray(simpleLocs) && simpleLocs.length > 0 && typeof simpleLocs[0] === \"string\" && int) {\n    result.geo_locations = await resolveLocations(int, simpleLocs);\n  } else {\n    const locs = t.locations_v2 as Array<{ key: string; type: string }> | undefined;\n    if (Array.isArray(locs) && locs.length > 0) {\n      const geo: Record<string, unknown> = {};\n      const countries: string[] = [];\n      const regions: Array<{ key: string }> = [];\n      const cities: Array<{ key: string }> = [];\n      const zips: Array<{ key: string }> = [];\n      const markets: Array<{ key: string }> = [];\n\n      for (const loc of locs) {\n        if (!loc.key || !loc.type) continue;\n        switch (loc.type) {\n          case \"country\": countries.push(loc.key); break;\n          case \"region\": regions.push({ key: loc.key }); break;\n          case \"city\": cities.push({ key: loc.key }); break;\n          case \"zip\": zips.push({ key: loc.key }); break;\n          case \"geo_market\": markets.push({ key: loc.key }); break;\n          default: countries.push(loc.key);\n        }\n      }\n      if (countries.length) geo.countries = countries;\n      if (regions.length) geo.regions = regions;\n      if (cities.length) geo.cities = cities;\n      if (zips.length) geo.zips = zips;\n      if (markets.length) geo.geo_markets = markets;\n      result.geo_locations = geo;\n    } else if (typeof t.locations === \"string\" && t.locations) {\n      result.geo_locations = { countries: (t.locations as string).split(\",\").map(s => s.trim().toUpperCase()) };\n    } else {\n      result.geo_locations = { countries: [\"US\"] };\n    }\n  }\n\n  // === DEMOGRAPHICS ===\n  if (t.age_min != null) result.age_min = Math.max(Number(t.age_min) || 18, 13);\n  if (t.age_max != null) result.age_max = Math.min(Number(t.age_max) || 65, 65);\n  if (t.genders === \"male\") result.genders = [1];\n  else if (t.genders === \"female\") result.genders = [2];\n\n  // === INTERESTS ===\n  const simpleInts = t.interests as string[] | undefined;\n  if (Array.isArray(simpleInts) && simpleInts.length > 0 && typeof simpleInts[0] === \"string\" && int) {\n    const resolved = await resolveInterests(int, simpleInts);\n    if (resolved.length) result.flexible_spec = [{ interests: resolved }];\n  } else {\n    const ints = t.interests_v2 as Array<{ id?: string; name?: string }> | undefined;\n    if (Array.isArray(ints) && ints.length > 0) {\n      const valid = ints.filter(i => i.id && i.name).map(i => ({ id: i.id, name: i.name }));\n      if (valid.length) result.flexible_spec = [{ interests: valid }];\n    }\n  }\n\n  // === CUSTOM AUDIENCES ===\n  if (typeof t.custom_audiences === \"string\" && t.custom_audiences) {\n    const resolved = await resolveAudienceIds(sb, t.custom_audiences.split(\",\").map(s => s.trim()));\n    if (resolved.length) result.custom_audiences = resolved;\n  } else if (Array.isArray(t.custom_audiences)) {\n    result.custom_audiences = t.custom_audiences;\n  }\n\n  // === EXCLUDED AUDIENCES ===\n  if (typeof t.excluded_custom_audiences === \"string\" && t.excluded_custom_audiences) {\n    const resolved = await resolveAudienceIds(sb, t.excluded_custom_audiences.split(\",\").map(s => s.trim()));\n    if (resolved.length) result.excluded_custom_audiences = resolved;\n  }\n\n  // === Advantage audience flag ===\n  const advAud = t.advantage_audience === true || t.advantage_audience === 1 ? 1 : 0;\n  result.targeting_automation = { advantage_audience: advAud };\n\n  // === PUBLISHER PLATFORMS (placement control) ===\n  if (Array.isArray(t.publisher_platforms)) {\n    result.publisher_platforms = t.publisher_platforms;\n  }\n  if (Array.isArray(t.facebook_positions)) {\n    result.facebook_positions = t.facebook_positions;\n  }\n  if (Array.isArray(t.instagram_positions)) {\n    result.instagram_positions = t.instagram_positions;\n  }\n  if (Array.isArray(t.audience_network_positions)) {\n    result.audience_network_positions = t.audience_network_positions;\n  }\n  if (Array.isArray(t.messenger_positions)) {\n    result.messenger_positions = t.messenger_positions;\n  }\n\n  return result;\n}\n"],"mappings":"AAAA;AACA;AACA;;AAGA,SAASA,SAAS,QAA8B,qBAAqB;AACrE,SAASC,GAAG,QAAQ,yBAAyB;;AAE7C;AACA;AACA;;AAEA,OAAO,eAAeC,kBAAkBA,CACtCC,EAAkB,EAClBC,GAAa,EACmB;EAChC,IAAI,CAACA,GAAG,CAACC,MAAM,EAAE,OAAO,EAAE;EAC1B,MAAM;IAAEC;EAAK,CAAC,GAAG,MAAMH,EAAE,CACtBI,IAAI,CAAC,gBAAgB,CAAC,CACtBC,MAAM,CAAC,sBAAsB,CAAC,CAC9BC,EAAE,CAAC,IAAI,EAAEL,GAAG,CAAC;EAChB,OAAO,CAACE,IAAI,IAAI,EAAE,EACfI,MAAM,CAAEC,CAAgC,IAAKA,CAAC,CAACC,gBAAgB,CAAC,CAChEC,GAAG,CAAEF,CAA+B,KAAM;IAAEG,EAAE,EAAEH,CAAC,CAACC;EAAiB,CAAC,CAAC,CAAC;AAC3E;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeG,gBAAgBA,CACpCC,GAAoB,EACpBC,SAAmB,EACe;EAClC,MAAMC,GAA4B,GAAG,CAAC,CAAC;EACvC,MAAMC,SAAmB,GAAG,EAAE;EAC9B,MAAMC,OAA+B,GAAG,EAAE;EAC1C,MAAMC,MAAuE,GAAG,EAAE;EAClF,MAAMC,IAA4B,GAAG,EAAE;EAEvC,KAAK,MAAMC,GAAG,IAAIN,SAAS,EAAE;IAC3B,MAAMO,OAAO,GAAGD,GAAG,CAACE,IAAI,CAAC,CAAC;IAC1B,IAAI,CAACD,OAAO,EAAE;;IAEd;IACA,IAAI,aAAa,CAACE,IAAI,CAACF,OAAO,CAAC,EAAE;MAC/BL,SAAS,CAACQ,IAAI,CAACH,OAAO,CAACI,WAAW,CAAC,CAAC,CAAC;MACrC;IACF;;IAEA;IACA,IAAI,SAAS,CAACF,IAAI,CAACF,OAAO,CAAC,EAAE;MAC3B,IAAI;QACF,MAAMK,GAAG,GAAG,GAAG7B,SAAS,gCAAgCC,GAAG,CAACuB,OAAO,CAAC,wCAAwCvB,GAAG,CAACe,GAAG,CAACc,WAAW,CAAC,UAAU;QAC1I,MAAMC,GAAG,GAAG,MAAMC,KAAK,CAACH,GAAG,CAAC;QAC5B,IAAIE,GAAG,CAACE,EAAE,EAAE;UACV,MAAMC,IAAI,GAAI,MAAMH,GAAG,CAACG,IAAI,CAAC,CAA6B;UAC1D,MAAMC,OAAO,GAAGD,IAAI,CAAC5B,IAAsC;UAC3D,IAAI6B,OAAO,GAAG,CAAC,CAAC,EAAEC,GAAG,EAAE;YACrBd,IAAI,CAACK,IAAI,CAAC;cAAES,GAAG,EAAED,OAAO,CAAC,CAAC,CAAC,CAACC;YAAc,CAAC,CAAC;YAC5C;UACF;QACF;MACF,CAAC,CAAC,MAAM,CAAE;MACVd,IAAI,CAACK,IAAI,CAAC;QAAES,GAAG,EAAEZ;MAAQ,CAAC,CAAC;MAC3B;IACF;;IAEA;IACA,IAAI;MACF,MAAMK,GAAG,GAAG,GAAG7B,SAAS,gCAAgCC,GAAG,CAACuB,OAAO,CAAC,iBAAiBvB,GAAG,CAACe,GAAG,CAACc,WAAW,CAAC,UAAU;MACnH,MAAMC,GAAG,GAAG,MAAMC,KAAK,CAACH,GAAG,CAAC;MAC5B,IAAI,CAACE,GAAG,CAACE,EAAE,EAAE;MACb,MAAMC,IAAI,GAAI,MAAMH,GAAG,CAACG,IAAI,CAAC,CAA6B;MAC1D,MAAMC,OAAO,GAAGD,IAAI,CAAC5B,IAAsC;MAC3D,IAAI,CAAC6B,OAAO,EAAE9B,MAAM,EAAE;MAEtB,MAAMgC,IAAI,GAAGF,OAAO,CAAC,CAAC,CAAC;MACvB,MAAMC,GAAG,GAAGC,IAAI,CAACD,GAAa;MAC9B,MAAME,IAAI,GAAGD,IAAI,CAACC,IAAc;MAEhC,QAAQA,IAAI;QACV,KAAK,SAAS;UAAEnB,SAAS,CAACQ,IAAI,CAACS,GAAG,CAAC;UAAE;QACrC,KAAK,QAAQ;UAAEhB,OAAO,CAACO,IAAI,CAAC;YAAES;UAAI,CAAC,CAAC;UAAE;QACtC,KAAK,MAAM;UAAEf,MAAM,CAACM,IAAI,CAAC;YAAES,GAAG;YAAEG,MAAM,EAAE,EAAE;YAAEC,aAAa,EAAE;UAAO,CAAC,CAAC;UAAE;QACtE,KAAK,KAAK;UAAElB,IAAI,CAACK,IAAI,CAAC;YAAES;UAAI,CAAC,CAAC;UAAE;QAChC,KAAK,YAAY;UAAGlB,GAAG,CAACuB,WAAW,KAA+BvB,GAAG,CAACuB,WAAW,GAAG,EAAE,CAAC;UAAIvB,GAAG,CAACuB,WAAW,CAA4Bd,IAAI,CAAC;YAAES;UAAI,CAAC,CAAC;UAAE;QACrJ;UACE,IAAIA,GAAG,EAAEf,MAAM,CAACM,IAAI,CAAC;YAAES,GAAG;YAAEG,MAAM,EAAE,EAAE;YAAEC,aAAa,EAAE;UAAO,CAAC,CAAC;MACpE;IACF,CAAC,CAAC,MAAM,CAAE;EACZ;EAEA,IAAIrB,SAAS,CAACd,MAAM,EAAEa,GAAG,CAACC,SAAS,GAAGA,SAAS;EAC/C,IAAIC,OAAO,CAACf,MAAM,EAAEa,GAAG,CAACE,OAAO,GAAGA,OAAO;EACzC,IAAIC,MAAM,CAAChB,MAAM,EAAEa,GAAG,CAACG,MAAM,GAAGA,MAAM;EACtC,IAAIC,IAAI,CAACjB,MAAM,EAAEa,GAAG,CAACI,IAAI,GAAGA,IAAI;;EAEhC;EACA,IAAI,CAACoB,MAAM,CAACC,IAAI,CAACzB,GAAG,CAAC,CAACb,MAAM,EAAEa,GAAG,CAACC,SAAS,GAAG,CAAC,IAAI,CAAC;EAEpD,OAAOD,GAAG;AACZ;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAe0B,gBAAgBA,CACpC5B,GAAoB,EACpB6B,SAAmB,EAC2B;EAC9C,MAAMC,QAA6C,GAAG,EAAE;EAExD,KAAK,MAAMC,IAAI,IAAIF,SAAS,EAAE;IAC5B,MAAMrB,OAAO,GAAGuB,IAAI,CAACtB,IAAI,CAAC,CAAC;IAC3B,IAAI,CAACD,OAAO,EAAE;IAEd,IAAI;MACF,MAAMK,GAAG,GAAG,GAAG7B,SAAS,6BAA6BC,GAAG,CAACuB,OAAO,CAAC,iBAAiBvB,GAAG,CAACe,GAAG,CAACc,WAAW,CAAC,UAAU;MAChH,MAAMC,GAAG,GAAG,MAAMC,KAAK,CAACH,GAAG,CAAC;MAC5B,IAAI,CAACE,GAAG,CAACE,EAAE,EAAE;MACb,MAAMC,IAAI,GAAI,MAAMH,GAAG,CAACG,IAAI,CAAC,CAA6B;MAC1D,MAAMC,OAAO,GAAGD,IAAI,CAAC5B,IAAsC;MAE3D,IAAI6B,OAAO,EAAE9B,MAAM,EAAE;QACnB,MAAMgC,IAAI,GAAGF,OAAO,CAAC,CAAC,CAAC;QACvB,IAAIE,IAAI,CAACvB,EAAE,IAAIuB,IAAI,CAACW,IAAI,EAAE;UACxBF,QAAQ,CAACnB,IAAI,CAAC;YAAEb,EAAE,EAAEmC,MAAM,CAACZ,IAAI,CAACvB,EAAE,CAAC;YAAEkC,IAAI,EAAEX,IAAI,CAACW;UAAe,CAAC,CAAC;QACnE;MACF;IACF,CAAC,CAAC,MAAM,CAAE;EACZ;EAEA,OAAOF,QAAQ;AACjB;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeI,cAAcA,CAClC/C,EAAkB,EAClBgD,GAAwD,EACxDnC,GAA4B,EACM;EAClC,MAAMoC,QAAQ,GAAG;IACfC,aAAa,EAAE;MAAElC,SAAS,EAAE,CAAC,IAAI;IAAE,CAAC;IACpCmC,oBAAoB,EAAE;MAAEC,kBAAkB,EAAE;IAAE;EAChD,CAAC;EAED,IAAIC,CAA0B;EAC9B,IAAI,CAACL,GAAG,EAAE,OAAOC,QAAQ;EACzB,IAAI,OAAOD,GAAG,KAAK,QAAQ,EAAE;IAC3B,IAAI;MAAEK,CAAC,GAAGC,IAAI,CAACC,KAAK,CAACP,GAAG,CAAC;IAAE,CAAC,CAAC,MAAM;MAAE,OAAOC,QAAQ;IAAE;EACxD,CAAC,MAAM;IACLI,CAAC,GAAGL,GAAG;EACT;;EAEA;EACA,IAAIK,CAAC,CAACH,aAAa,EAAE;IACnB,IAAI,CAACG,CAAC,CAACF,oBAAoB,EAAE;MAC3B,MAAMK,MAAM,GAAGH,CAAC,CAACD,kBAAkB,KAAK,IAAI,IAAIC,CAAC,CAACD,kBAAkB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;MAClFC,CAAC,CAACF,oBAAoB,GAAG;QAAEC,kBAAkB,EAAEI;MAAO,CAAC;IACzD;IACA,OAAOH,CAAC;EACV;EAEA,MAAMI,MAA+B,GAAG,CAAC,CAAC;;EAE1C;EACA,MAAMC,UAAU,GAAGL,CAAC,CAACvC,SAAiC;EACtD,IAAI6C,KAAK,CAACC,OAAO,CAACF,UAAU,CAAC,IAAIA,UAAU,CAACxD,MAAM,GAAG,CAAC,IAAI,OAAOwD,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI7C,GAAG,EAAE;IAClG4C,MAAM,CAACP,aAAa,GAAG,MAAMtC,gBAAgB,CAACC,GAAG,EAAE6C,UAAU,CAAC;EAChE,CAAC,MAAM;IACL,MAAMG,IAAI,GAAGR,CAAC,CAACS,YAAgE;IAC/E,IAAIH,KAAK,CAACC,OAAO,CAACC,IAAI,CAAC,IAAIA,IAAI,CAAC3D,MAAM,GAAG,CAAC,EAAE;MAC1C,MAAMa,GAA4B,GAAG,CAAC,CAAC;MACvC,MAAMC,SAAmB,GAAG,EAAE;MAC9B,MAAMC,OAA+B,GAAG,EAAE;MAC1C,MAAMC,MAA8B,GAAG,EAAE;MACzC,MAAMC,IAA4B,GAAG,EAAE;MACvC,MAAM4C,OAA+B,GAAG,EAAE;MAE1C,KAAK,MAAM3C,GAAG,IAAIyC,IAAI,EAAE;QACtB,IAAI,CAACzC,GAAG,CAACa,GAAG,IAAI,CAACb,GAAG,CAACe,IAAI,EAAE;QAC3B,QAAQf,GAAG,CAACe,IAAI;UACd,KAAK,SAAS;YAAEnB,SAAS,CAACQ,IAAI,CAACJ,GAAG,CAACa,GAAG,CAAC;YAAE;UACzC,KAAK,QAAQ;YAAEhB,OAAO,CAACO,IAAI,CAAC;cAAES,GAAG,EAAEb,GAAG,CAACa;YAAI,CAAC,CAAC;YAAE;UAC/C,KAAK,MAAM;YAAEf,MAAM,CAACM,IAAI,CAAC;cAAES,GAAG,EAAEb,GAAG,CAACa;YAAI,CAAC,CAAC;YAAE;UAC5C,KAAK,KAAK;YAAEd,IAAI,CAACK,IAAI,CAAC;cAAES,GAAG,EAAEb,GAAG,CAACa;YAAI,CAAC,CAAC;YAAE;UACzC,KAAK,YAAY;YAAE8B,OAAO,CAACvC,IAAI,CAAC;cAAES,GAAG,EAAEb,GAAG,CAACa;YAAI,CAAC,CAAC;YAAE;UACnD;YAASjB,SAAS,CAACQ,IAAI,CAACJ,GAAG,CAACa,GAAG,CAAC;QAClC;MACF;MACA,IAAIjB,SAAS,CAACd,MAAM,EAAEa,GAAG,CAACC,SAAS,GAAGA,SAAS;MAC/C,IAAIC,OAAO,CAACf,MAAM,EAAEa,GAAG,CAACE,OAAO,GAAGA,OAAO;MACzC,IAAIC,MAAM,CAAChB,MAAM,EAAEa,GAAG,CAACG,MAAM,GAAGA,MAAM;MACtC,IAAIC,IAAI,CAACjB,MAAM,EAAEa,GAAG,CAACI,IAAI,GAAGA,IAAI;MAChC,IAAI4C,OAAO,CAAC7D,MAAM,EAAEa,GAAG,CAACuB,WAAW,GAAGyB,OAAO;MAC7CN,MAAM,CAACP,aAAa,GAAGnC,GAAG;IAC5B,CAAC,MAAM,IAAI,OAAOsC,CAAC,CAACvC,SAAS,KAAK,QAAQ,IAAIuC,CAAC,CAACvC,SAAS,EAAE;MACzD2C,MAAM,CAACP,aAAa,GAAG;QAAElC,SAAS,EAAGqC,CAAC,CAACvC,SAAS,CAAYkD,KAAK,CAAC,GAAG,CAAC,CAACtD,GAAG,CAACuD,CAAC,IAAIA,CAAC,CAAC3C,IAAI,CAAC,CAAC,CAACG,WAAW,CAAC,CAAC;MAAE,CAAC;IAC3G,CAAC,MAAM;MACLgC,MAAM,CAACP,aAAa,GAAG;QAAElC,SAAS,EAAE,CAAC,IAAI;MAAE,CAAC;IAC9C;EACF;;EAEA;EACA,IAAIqC,CAAC,CAACa,OAAO,IAAI,IAAI,EAAET,MAAM,CAACS,OAAO,GAAGC,IAAI,CAACC,GAAG,CAACC,MAAM,CAAChB,CAAC,CAACa,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;EAC7E,IAAIb,CAAC,CAACiB,OAAO,IAAI,IAAI,EAAEb,MAAM,CAACa,OAAO,GAAGH,IAAI,CAACI,GAAG,CAACF,MAAM,CAAChB,CAAC,CAACiB,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;EAC7E,IAAIjB,CAAC,CAACmB,OAAO,KAAK,MAAM,EAAEf,MAAM,CAACe,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAC1C,IAAInB,CAAC,CAACmB,OAAO,KAAK,QAAQ,EAAEf,MAAM,CAACe,OAAO,GAAG,CAAC,CAAC,CAAC;;EAErD;EACA,MAAMC,UAAU,GAAGpB,CAAC,CAACX,SAAiC;EACtD,IAAIiB,KAAK,CAACC,OAAO,CAACa,UAAU,CAAC,IAAIA,UAAU,CAACvE,MAAM,GAAG,CAAC,IAAI,OAAOuE,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI5D,GAAG,EAAE;IAClG,MAAM8B,QAAQ,GAAG,MAAMF,gBAAgB,CAAC5B,GAAG,EAAE4D,UAAU,CAAC;IACxD,IAAI9B,QAAQ,CAACzC,MAAM,EAAEuD,MAAM,CAACiB,aAAa,GAAG,CAAC;MAAEhC,SAAS,EAAEC;IAAS,CAAC,CAAC;EACvE,CAAC,MAAM;IACL,MAAMgC,IAAI,GAAGtB,CAAC,CAACuB,YAAiE;IAChF,IAAIjB,KAAK,CAACC,OAAO,CAACe,IAAI,CAAC,IAAIA,IAAI,CAACzE,MAAM,GAAG,CAAC,EAAE;MAC1C,MAAM2E,KAAK,GAAGF,IAAI,CAACpE,MAAM,CAACuE,CAAC,IAAIA,CAAC,CAACnE,EAAE,IAAImE,CAAC,CAACjC,IAAI,CAAC,CAACnC,GAAG,CAACoE,CAAC,KAAK;QAAEnE,EAAE,EAAEmE,CAAC,CAACnE,EAAE;QAAEkC,IAAI,EAAEiC,CAAC,CAACjC;MAAK,CAAC,CAAC,CAAC;MACrF,IAAIgC,KAAK,CAAC3E,MAAM,EAAEuD,MAAM,CAACiB,aAAa,GAAG,CAAC;QAAEhC,SAAS,EAAEmC;MAAM,CAAC,CAAC;IACjE;EACF;;EAEA;EACA,IAAI,OAAOxB,CAAC,CAAC0B,gBAAgB,KAAK,QAAQ,IAAI1B,CAAC,CAAC0B,gBAAgB,EAAE;IAChE,MAAMpC,QAAQ,GAAG,MAAM5C,kBAAkB,CAACC,EAAE,EAAEqD,CAAC,CAAC0B,gBAAgB,CAACf,KAAK,CAAC,GAAG,CAAC,CAACtD,GAAG,CAACuD,CAAC,IAAIA,CAAC,CAAC3C,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAIqB,QAAQ,CAACzC,MAAM,EAAEuD,MAAM,CAACsB,gBAAgB,GAAGpC,QAAQ;EACzD,CAAC,MAAM,IAAIgB,KAAK,CAACC,OAAO,CAACP,CAAC,CAAC0B,gBAAgB,CAAC,EAAE;IAC5CtB,MAAM,CAACsB,gBAAgB,GAAG1B,CAAC,CAAC0B,gBAAgB;EAC9C;;EAEA;EACA,IAAI,OAAO1B,CAAC,CAAC2B,yBAAyB,KAAK,QAAQ,IAAI3B,CAAC,CAAC2B,yBAAyB,EAAE;IAClF,MAAMrC,QAAQ,GAAG,MAAM5C,kBAAkB,CAACC,EAAE,EAAEqD,CAAC,CAAC2B,yBAAyB,CAAChB,KAAK,CAAC,GAAG,CAAC,CAACtD,GAAG,CAACuD,CAAC,IAAIA,CAAC,CAAC3C,IAAI,CAAC,CAAC,CAAC,CAAC;IACxG,IAAIqB,QAAQ,CAACzC,MAAM,EAAEuD,MAAM,CAACuB,yBAAyB,GAAGrC,QAAQ;EAClE;;EAEA;EACA,MAAMsC,MAAM,GAAG5B,CAAC,CAACD,kBAAkB,KAAK,IAAI,IAAIC,CAAC,CAACD,kBAAkB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;EAClFK,MAAM,CAACN,oBAAoB,GAAG;IAAEC,kBAAkB,EAAE6B;EAAO,CAAC;;EAE5D;EACA,IAAItB,KAAK,CAACC,OAAO,CAACP,CAAC,CAAC6B,mBAAmB,CAAC,EAAE;IACxCzB,MAAM,CAACyB,mBAAmB,GAAG7B,CAAC,CAAC6B,mBAAmB;EACpD;EACA,IAAIvB,KAAK,CAACC,OAAO,CAACP,CAAC,CAAC8B,kBAAkB,CAAC,EAAE;IACvC1B,MAAM,CAAC0B,kBAAkB,GAAG9B,CAAC,CAAC8B,kBAAkB;EAClD;EACA,IAAIxB,KAAK,CAACC,OAAO,CAACP,CAAC,CAAC+B,mBAAmB,CAAC,EAAE;IACxC3B,MAAM,CAAC2B,mBAAmB,GAAG/B,CAAC,CAAC+B,mBAAmB;EACpD;EACA,IAAIzB,KAAK,CAACC,OAAO,CAACP,CAAC,CAACgC,0BAA0B,CAAC,EAAE;IAC/C5B,MAAM,CAAC4B,0BAA0B,GAAGhC,CAAC,CAACgC,0BAA0B;EAClE;EACA,IAAI1B,KAAK,CAACC,OAAO,CAACP,CAAC,CAACiC,mBAAmB,CAAC,EAAE;IACxC7B,MAAM,CAAC6B,mBAAmB,GAAGjC,CAAC,CAACiC,mBAAmB;EACpD;EAEA,OAAO7B,MAAM;AACf","ignoreList":[]}

package/dist/server/handlers/meta-ads-types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Meta Ads — shared types, constants, and validation helpers.
+ */
+export declare const META_API_VERSION = "v21.0";
+export declare const META_BASE = "https://graph.facebook.com/v21.0";
+/** Valid optimization goals per campaign objective (Meta Marketing API v21). */
+export declare const VALID_GOALS: Record<string, string[]>;
+export interface MetaIntegration {
+    accessToken: string;
+    adAccountId: string;
+    businessId: string | null;
+    pageId: string | null;
+    pixelId: string | null;
+    instagramAccountId: string | null;
+    tokenExpiresAt: string | null;
+}
+export interface Creative {
+    object_type?: string;
+    title?: string;
+    body?: string;
+    image_url?: string;
+    video_url?: string;
+    thumbnail_url?: string;
+    call_to_action?: string;
+    link_url?: string;
+    video_id?: string;
+    page_id?: string;
+    carousel_cards?: CarouselCard[];
+    asset_feed_spec?: Record<string, unknown>;
+    lead_form_id?: string;
+}
+export interface CarouselCard {
+    headline?: string;
+    description?: string;
+    image_url?: string;
+    video_url?: string;
+    link_url?: string;
+    call_to_action?: string;
+}
+/** Default optimization goal per objective. */
+export declare function defaultGoal(objective: string): string;
+/** Validate goal against objective, falling back to the best default. */
+export declare function validateGoal(goal: string, objective: string): string;
+/** Billing event depends on optimization goal. */
+export declare function billingEvent(goal: string): string;
+/** Map any status to Meta-valid status. Meta only accepts ACTIVE/PAUSED/DELETED/ARCHIVED. */
+export declare function metaStatus(status?: string | null): string;
+/** Real Meta IDs are purely numeric. Local/Supabase IDs contain non-digit chars. */
+export declare function isLocalId(id: string | null | undefined): boolean;

package/dist/server/handlers/meta-ads-types.js

@@ -0,0 +1,59 @@
+/**
+ * Meta Ads — shared types, constants, and validation helpers.
+ */
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+export const META_API_VERSION = "v21.0";
+export const META_BASE = `https://graph.facebook.com/${META_API_VERSION}`;
+
+/** Valid optimization goals per campaign objective (Meta Marketing API v21). */
+export const VALID_GOALS = {
+  OUTCOME_AWARENESS: ["REACH", "IMPRESSIONS", "AD_RECALL_LIFT", "THRUPLAY"],
+  OUTCOME_TRAFFIC: ["LINK_CLICKS", "LANDING_PAGE_VIEWS", "REACH", "IMPRESSIONS"],
+  OUTCOME_ENGAGEMENT: ["THRUPLAY", "POST_ENGAGEMENT", "VIDEO_VIEWS", "REACH"],
+  OUTCOME_LEADS: ["LEAD_GENERATION", "LINK_CLICKS", "QUALITY_LEAD", "REACH"],
+  OUTCOME_APP_PROMOTION: ["APP_INSTALLS", "LINK_CLICKS", "APP_EVENTS", "VALUE"],
+  OUTCOME_SALES: ["OFFSITE_CONVERSIONS", "LINK_CLICKS", "VALUE", "REACH"],
+  PRODUCT_CATALOG_SALES: ["OFFSITE_CONVERSIONS", "LINK_CLICKS", "VALUE", "REACH"]
+};
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+// ============================================================================
+// HELPERS
+// ============================================================================
+
+/** Default optimization goal per objective. */
+export function defaultGoal(objective) {
+  return VALID_GOALS[objective]?.[0] ?? "LINK_CLICKS";
+}
+
+/** Validate goal against objective, falling back to the best default. */
+export function validateGoal(goal, objective) {
+  const valid = VALID_GOALS[objective];
+  if (!valid) return goal;
+  return valid.includes(goal) ? goal : valid[0];
+}
+
+/** Billing event depends on optimization goal. */
+export function billingEvent(goal) {
+  return goal === "THRUPLAY" ? "THRUPLAY" : "IMPRESSIONS";
+}
+
+/** Map any status to Meta-valid status. Meta only accepts ACTIVE/PAUSED/DELETED/ARCHIVED. */
+export function metaStatus(status) {
+  if (!status || status === "DRAFT") return "PAUSED";
+  return status;
+}
+
+/** Real Meta IDs are purely numeric. Local/Supabase IDs contain non-digit chars. */
+export function isLocalId(id) {
+  if (!id) return true;
+  return /[^0-9]/.test(id);
+}
+//# sourceMappingURL=meta-ads-types.js.map

package/dist/server/handlers/meta-ads-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-ads-types.js","names":["META_API_VERSION","META_BASE","VALID_GOALS","OUTCOME_AWARENESS","OUTCOME_TRAFFIC","OUTCOME_ENGAGEMENT","OUTCOME_LEADS","OUTCOME_APP_PROMOTION","OUTCOME_SALES","PRODUCT_CATALOG_SALES","defaultGoal","objective","validateGoal","goal","valid","includes","billingEvent","metaStatus","status","isLocalId","id","test"],"sources":["../../../src/server/handlers/meta-ads-types.ts"],"sourcesContent":["/**\n * Meta Ads — shared types, constants, and validation helpers.\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nexport const META_API_VERSION = \"v21.0\";\nexport const META_BASE = `https://graph.facebook.com/${META_API_VERSION}`;\n\n/** Valid optimization goals per campaign objective (Meta Marketing API v21). */\nexport const VALID_GOALS: Record<string, string[]> = {\n  OUTCOME_AWARENESS: [\"REACH\", \"IMPRESSIONS\", \"AD_RECALL_LIFT\", \"THRUPLAY\"],\n  OUTCOME_TRAFFIC: [\"LINK_CLICKS\", \"LANDING_PAGE_VIEWS\", \"REACH\", \"IMPRESSIONS\"],\n  OUTCOME_ENGAGEMENT: [\"THRUPLAY\", \"POST_ENGAGEMENT\", \"VIDEO_VIEWS\", \"REACH\"],\n  OUTCOME_LEADS: [\"LEAD_GENERATION\", \"LINK_CLICKS\", \"QUALITY_LEAD\", \"REACH\"],\n  OUTCOME_APP_PROMOTION: [\"APP_INSTALLS\", \"LINK_CLICKS\", \"APP_EVENTS\", \"VALUE\"],\n  OUTCOME_SALES: [\"OFFSITE_CONVERSIONS\", \"LINK_CLICKS\", \"VALUE\", \"REACH\"],\n  PRODUCT_CATALOG_SALES: [\"OFFSITE_CONVERSIONS\", \"LINK_CLICKS\", \"VALUE\", \"REACH\"],\n};\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface MetaIntegration {\n  accessToken: string;\n  adAccountId: string;\n  businessId: string | null;\n  pageId: string | null;\n  pixelId: string | null;\n  instagramAccountId: string | null;\n  tokenExpiresAt: string | null;\n}\n\nexport interface Creative {\n  object_type?: string;\n  title?: string;\n  body?: string;\n  image_url?: string;\n  video_url?: string;\n  thumbnail_url?: string;\n  call_to_action?: string;\n  link_url?: string;\n  video_id?: string;\n  page_id?: string;\n  carousel_cards?: CarouselCard[];\n  asset_feed_spec?: Record<string, unknown>;\n  lead_form_id?: string;\n}\n\nexport interface CarouselCard {\n  headline?: string;\n  description?: string;\n  image_url?: string;\n  video_url?: string;\n  link_url?: string;\n  call_to_action?: string;\n}\n\n// ============================================================================\n// HELPERS\n// ============================================================================\n\n/** Default optimization goal per objective. */\nexport function defaultGoal(objective: string): string {\n  return VALID_GOALS[objective]?.[0] ?? \"LINK_CLICKS\";\n}\n\n/** Validate goal against objective, falling back to the best default. */\nexport function validateGoal(goal: string, objective: string): string {\n  const valid = VALID_GOALS[objective];\n  if (!valid) return goal;\n  return valid.includes(goal) ? goal : valid[0];\n}\n\n/** Billing event depends on optimization goal. */\nexport function billingEvent(goal: string): string {\n  return goal === \"THRUPLAY\" ? \"THRUPLAY\" : \"IMPRESSIONS\";\n}\n\n/** Map any status to Meta-valid status. Meta only accepts ACTIVE/PAUSED/DELETED/ARCHIVED. */\nexport function metaStatus(status?: string | null): string {\n  if (!status || status === \"DRAFT\") return \"PAUSED\";\n  return status;\n}\n\n/** Real Meta IDs are purely numeric. Local/Supabase IDs contain non-digit chars. */\nexport function isLocalId(id: string | null | undefined): boolean {\n  if (!id) return true;\n  return /[^0-9]/.test(id);\n}\n"],"mappings":"AAAA;AACA;AACA;;AAIA;AACA;AACA;;AAEA,OAAO,MAAMA,gBAAgB,GAAG,OAAO;AACvC,OAAO,MAAMC,SAAS,GAAG,8BAA8BD,gBAAgB,EAAE;;AAEzE;AACA,OAAO,MAAME,WAAqC,GAAG;EACnDC,iBAAiB,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,CAAC;EACzEC,eAAe,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa,CAAC;EAC9EC,kBAAkB,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,OAAO,CAAC;EAC3EC,aAAa,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,CAAC;EAC1EC,qBAAqB,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC;EAC7EC,aAAa,EAAE,CAAC,qBAAqB,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;EACvEC,qBAAqB,EAAE,CAAC,qBAAqB,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO;AAChF,CAAC;;AAED;AACA;AACA;;AAqCA;AACA;AACA;;AAEA;AACA,OAAO,SAASC,WAAWA,CAACC,SAAiB,EAAU;EACrD,OAAOT,WAAW,CAACS,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,aAAa;AACrD;;AAEA;AACA,OAAO,SAASC,YAAYA,CAACC,IAAY,EAAEF,SAAiB,EAAU;EACpE,MAAMG,KAAK,GAAGZ,WAAW,CAACS,SAAS,CAAC;EACpC,IAAI,CAACG,KAAK,EAAE,OAAOD,IAAI;EACvB,OAAOC,KAAK,CAACC,QAAQ,CAACF,IAAI,CAAC,GAAGA,IAAI,GAAGC,KAAK,CAAC,CAAC,CAAC;AAC/C;;AAEA;AACA,OAAO,SAASE,YAAYA,CAACH,IAAY,EAAU;EACjD,OAAOA,IAAI,KAAK,UAAU,GAAG,UAAU,GAAG,aAAa;AACzD;;AAEA;AACA,OAAO,SAASI,UAAUA,CAACC,MAAsB,EAAU;EACzD,IAAI,CAACA,MAAM,IAAIA,MAAM,KAAK,OAAO,EAAE,OAAO,QAAQ;EAClD,OAAOA,MAAM;AACf;;AAEA;AACA,OAAO,SAASC,SAASA,CAACC,EAA6B,EAAW;EAChE,IAAI,CAACA,EAAE,EAAE,OAAO,IAAI;EACpB,OAAO,QAAQ,CAACC,IAAI,CAACD,EAAE,CAAC;AAC1B","ignoreList":[]}

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

@@ -0,0 +1,117 @@
+// meta-ads-update.test.ts — Tests for handleMetaAds update operations
+
+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();
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — update operations", () => {
+  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(() => {});
+  });
+
+  // ========================================================================
+  // UPDATE_CAMPAIGN
+  // ========================================================================
+
+  describe("action: update_campaign", () => {
+    it("updates campaign fields", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_updcamp`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} Old Name`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "update_campaign",
+        campaign_id: camp.id,
+        name: `${RUN_PREFIX} Updated Name`,
+        status: "ACTIVE"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when campaign_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_campaign",
+        name: "Updated"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("campaign_id required");
+    });
+    it("returns error when no fields to update", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_campaign",
+        campaign_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("No fields to update");
+    });
+  });
+
+  // ========================================================================
+  // UPDATE_AD_SET
+  // ========================================================================
+
+  describe("action: update_ad_set", () => {
+    it("returns error when ad_set_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_ad_set",
+        name: "Updated"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("ad_set_id required");
+    });
+    it("returns error when no fields to update", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_ad_set",
+        ad_set_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("No fields to update");
+    });
+  });
+
+  // ========================================================================
+  // UPDATE_AD
+  // ========================================================================
+
+  describe("action: update_ad", () => {
+    it("returns error when ad_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_ad",
+        name: "Updated"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("ad_id required");
+    });
+    it("returns error when no fields to update", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "update_ad",
+        ad_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("No fields to update");
+    });
+  });
+});