whale-code 6.5.6 → 6.5.7

package/dist/server/handlers/media-utils.js

@@ -0,0 +1,33 @@
+// server/handlers/media-utils.ts — Shared constants, types, and utility functions for media handler
+
+export const BUCKET = "product-images";
+export const ALL_ACTIONS = ["upload", "bulk_upload", "list", "get", "update", "bulk_update", "delete", "bulk_delete", "search", "move", "archive", "unarchive", "tag", "folders_list", "folders_create", "folders_update", "folders_delete", "link_product", "unlink_product", "usage", "analytics", "duplicate", "replace"];
+export const LIST_COLUMNS = "id, file_name, file_url, file_size, file_type, category, folder, status, title, alt_text, custom_tags, usage_count, linked_product_ids, created_at, updated_at";
+export const VALID_CATEGORIES = ["product_photos", "marketing", "menus", "brand", "social_media", "print_marketing", "promotional", "brand_assets", "ai_generated"];
+export const VALID_STATUSES = ["active", "archived", "processing"];
+export const VALID_SORT_COLUMNS = ["created_at", "updated_at", "file_name", "file_size", "usage_count", "title"];
+export const UPDATE_WHITELIST = ["title", "alt_text", "notes", "category", "status", "folder", "custom_tags"];
+// Detect mime type from base64 magic bytes
+export function detectMime(base64) {
+  if (base64.startsWith("iVBORw0KGgo")) return "image/png";
+  if (base64.startsWith("/9j/")) return "image/jpeg";
+  if (base64.startsWith("R0lGOD")) return "image/gif";
+  if (base64.startsWith("UklGR")) return "image/webp";
+  if (base64.startsWith("JVBER")) return "application/pdf";
+  // Blender files start with "BLENDER" -> base64 of "BLENDER" starts with "QkxFTkRFUg"
+  if (base64.startsWith("QkxFTkRFUg")) return "application/x-blender";
+  return "application/octet-stream";
+}
+export function mimeToExt(mime) {
+  const map = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/gif": "gif",
+    "image/webp": "webp",
+    "image/svg+xml": "svg",
+    "application/pdf": "pdf",
+    "application/x-blender": "blend"
+  };
+  return map[mime] || "bin";
+}
+//# sourceMappingURL=media-utils.js.map

package/dist/server/handlers/media-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-utils.js","names":["BUCKET","ALL_ACTIONS","LIST_COLUMNS","VALID_CATEGORIES","VALID_STATUSES","VALID_SORT_COLUMNS","UPDATE_WHITELIST","detectMime","base64","startsWith","mimeToExt","mime","map"],"sources":["../../../src/server/handlers/media-utils.ts"],"sourcesContent":["// server/handlers/media-utils.ts — Shared constants, types, and utility functions for media handler\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\n\nexport const BUCKET = \"product-images\";\n\nexport const ALL_ACTIONS = [\n  \"upload\", \"bulk_upload\", \"list\", \"get\", \"update\", \"bulk_update\",\n  \"delete\", \"bulk_delete\", \"search\", \"move\", \"archive\", \"unarchive\",\n  \"tag\", \"folders_list\", \"folders_create\", \"folders_update\", \"folders_delete\",\n  \"link_product\", \"unlink_product\", \"usage\", \"analytics\", \"duplicate\", \"replace\",\n] as const;\n\nexport const LIST_COLUMNS = \"id, file_name, file_url, file_size, file_type, category, folder, status, title, alt_text, custom_tags, usage_count, linked_product_ids, created_at, updated_at\";\n\nexport const VALID_CATEGORIES = [\"product_photos\", \"marketing\", \"menus\", \"brand\", \"social_media\", \"print_marketing\", \"promotional\", \"brand_assets\", \"ai_generated\"];\nexport const VALID_STATUSES = [\"active\", \"archived\", \"processing\"];\nexport const VALID_SORT_COLUMNS = [\"created_at\", \"updated_at\", \"file_name\", \"file_size\", \"usage_count\", \"title\"];\n\nexport const UPDATE_WHITELIST = [\"title\", \"alt_text\", \"notes\", \"category\", \"status\", \"folder\", \"custom_tags\"];\n\nexport type Result = { success: boolean; data?: unknown; error?: string };\n\n// Detect mime type from base64 magic bytes\nexport function detectMime(base64: string): string {\n  if (base64.startsWith(\"iVBORw0KGgo\")) return \"image/png\";\n  if (base64.startsWith(\"/9j/\")) return \"image/jpeg\";\n  if (base64.startsWith(\"R0lGOD\")) return \"image/gif\";\n  if (base64.startsWith(\"UklGR\")) return \"image/webp\";\n  if (base64.startsWith(\"JVBER\")) return \"application/pdf\";\n  // Blender files start with \"BLENDER\" -> base64 of \"BLENDER\" starts with \"QkxFTkRFUg\"\n  if (base64.startsWith(\"QkxFTkRFUg\")) return \"application/x-blender\";\n  return \"application/octet-stream\";\n}\n\nexport function mimeToExt(mime: string): string {\n  const map: Record<string, string> = {\n    \"image/png\": \"png\", \"image/jpeg\": \"jpg\", \"image/gif\": \"gif\",\n    \"image/webp\": \"webp\", \"image/svg+xml\": \"svg\", \"application/pdf\": \"pdf\",\n    \"application/x-blender\": \"blend\",\n  };\n  return map[mime] || \"bin\";\n}\n"],"mappings":"AAAA;;AAIA,OAAO,MAAMA,MAAM,GAAG,gBAAgB;AAEtC,OAAO,MAAMC,WAAW,GAAG,CACzB,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAC/D,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EACjE,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAC3E,cAAc,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CACtE;AAEV,OAAO,MAAMC,YAAY,GAAG,gKAAgK;AAE5L,OAAO,MAAMC,gBAAgB,GAAG,CAAC,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,CAAC;AACnK,OAAO,MAAMC,cAAc,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC;AAClE,OAAO,MAAMC,kBAAkB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,CAAC;AAEhH,OAAO,MAAMC,gBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC;AAI7G;AACA,OAAO,SAASC,UAAUA,CAACC,MAAc,EAAU;EACjD,IAAIA,MAAM,CAACC,UAAU,CAAC,aAAa,CAAC,EAAE,OAAO,WAAW;EACxD,IAAID,MAAM,CAACC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,YAAY;EAClD,IAAID,MAAM,CAACC,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,WAAW;EACnD,IAAID,MAAM,CAACC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,YAAY;EACnD,IAAID,MAAM,CAACC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,iBAAiB;EACxD;EACA,IAAID,MAAM,CAACC,UAAU,CAAC,YAAY,CAAC,EAAE,OAAO,uBAAuB;EACnE,OAAO,0BAA0B;AACnC;AAEA,OAAO,SAASC,SAASA,CAACC,IAAY,EAAU;EAC9C,MAAMC,GAA2B,GAAG;IAClC,WAAW,EAAE,KAAK;IAAE,YAAY,EAAE,KAAK;IAAE,WAAW,EAAE,KAAK;IAC3D,YAAY,EAAE,MAAM;IAAE,eAAe,EAAE,KAAK;IAAE,iBAAiB,EAAE,KAAK;IACtE,uBAAuB,EAAE;EAC3B,CAAC;EACD,OAAOA,GAAG,CAACD,IAAI,CAAC,IAAI,KAAK;AAC3B","ignoreList":[]}

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

@@ -0,0 +1,46 @@
+/**
+ * Meta Ads — advanced handlers: publish dispatch, sync, insights, ad preview.
+ *
+ * Audience, pixel, rule, lead form, and targeting handlers are in:
+ *   meta-ads-audiences.ts
+ *   meta-ads-pixels-rules.ts
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+export { handleCreateAudience, handleListAudiences, handleGetAudience, handleDeleteAudience, handleCreateLookalike, } from "./meta-ads-audiences.js";
+export { handleCreateLeadForm, handleListLeadForms, handleGetLeads, handleListPixels, handleCreatePixel, handleDeletePixel, handleCreateCustomConversion, handleListCustomConversions, handleCreateRule, handleListRules, handleDeleteRule, handleReachEstimate, handleAudienceInsights, handleSearchTargeting, } from "./meta-ads-pixels-rules.js";
+export declare function handlePublish(sb: SupabaseClient, args: Record<string, unknown>, storeId: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: unknown;
+    error?: undefined;
+}>;
+export declare function handleSync(sb: SupabaseClient, args: Record<string, unknown>, storeId: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: any;
+    error?: undefined;
+}>;
+export declare function handleInsightsBreakdown(sb: SupabaseClient, args: Record<string, unknown>, storeId: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: {};
+    error?: undefined;
+}>;
+export declare function handleAdPreview(sb: SupabaseClient, args: Record<string, unknown>, storeId: string): Promise<{
+    success: boolean;
+    error: string;
+    data?: undefined;
+} | {
+    success: boolean;
+    data: {};
+    error?: undefined;
+}>;

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

@@ -0,0 +1,222 @@
+/**
+ * Meta Ads — advanced handlers: publish dispatch, sync, insights, ad preview.
+ *
+ * Audience, pixel, rule, lead form, and targeting handlers are in:
+ *   meta-ads-audiences.ts
+ *   meta-ads-pixels-rules.ts
+ */
+
+import { isLocalId } from "./meta-ads-types.js";
+import { enc, graphGet, getIntegration } from "./meta-ads-graph-api.js";
+import { publishCampaign, publishAdSet, publishAd } from "./meta-ads-publish.js";
+import { queueSpan, auditRowToSpan } from "../lib/clickhouse-buffer.js";
+
+// Re-export all sub-module handlers so existing imports keep working
+export { handleCreateAudience, handleListAudiences, handleGetAudience, handleDeleteAudience, handleCreateLookalike } from "./meta-ads-audiences.js";
+export { handleCreateLeadForm, handleListLeadForms, handleGetLeads, handleListPixels, handleCreatePixel, handleDeletePixel, handleCreateCustomConversion, handleListCustomConversions, handleCreateRule, handleListRules, handleDeleteRule, handleReachEstimate, handleAudienceInsights, handleSearchTargeting } from "./meta-ads-pixels-rules.js";
+
+// ============================================================================
+// PUBLISH (dispatch)
+// ============================================================================
+
+export async function handlePublish(sb, args, storeId) {
+  const type = args.type;
+  const id = args.id;
+  if (!type) return {
+    success: false,
+    error: "type required (campaign, ad_set, ad)"
+  };
+  if (!id) return {
+    success: false,
+    error: "id required"
+  };
+  let result;
+  switch (type) {
+    case "campaign":
+      result = await publishCampaign(sb, storeId, id);
+      break;
+    case "ad_set":
+      result = await publishAdSet(sb, storeId, id);
+      break;
+    case "ad":
+      result = await publishAd(sb, storeId, id);
+      break;
+    default:
+      return {
+        success: false,
+        error: `Invalid type: ${type}`
+      };
+  }
+
+  // Telemetry
+  queueSpan(auditRowToSpan({
+    store_id: storeId,
+    action: `meta_publish_${type}`,
+    resource_type: `meta_${type === "ad_set" ? "ad_set" : type}`,
+    resource_id: id,
+    details: result,
+    source: "agent_chat",
+    severity: "info",
+    service_name: "agent-server",
+    span_kind: "INTERNAL",
+    status_code: "OK",
+    start_time: new Date().toISOString(),
+    end_time: new Date().toISOString()
+  }));
+  return {
+    success: true,
+    data: result
+  };
+}
+
+// ============================================================================
+// SYNC
+// ============================================================================
+
+export async function handleSync(sb, args, storeId) {
+  const id = args.campaign_id || args.id;
+  if (!id) return {
+    success: false,
+    error: "campaign_id required"
+  };
+  const {
+    data: c
+  } = await sb.from("meta_campaigns").select("meta_campaign_id").eq("id", id).eq("store_id", storeId).single();
+  if (!c) return {
+    success: false,
+    error: `Campaign not found: ${id}`
+  };
+  if (isLocalId(c.meta_campaign_id)) return {
+    success: false,
+    error: "Campaign not published yet. Publish first."
+  };
+  const int = await getIntegration(sb, storeId);
+  const stats = await graphGet(c.meta_campaign_id, "name,status,effective_status,daily_budget,lifetime_budget,budget_remaining,start_time,stop_time", int.accessToken);
+  const u = {
+    last_synced_at: new Date().toISOString()
+  };
+  if (stats.status) u.status = stats.status;
+  if (stats.effective_status) u.effective_status = stats.effective_status;
+  if (stats.daily_budget) u.daily_budget = Number(stats.daily_budget) / 100;
+  if (stats.lifetime_budget) u.lifetime_budget = Number(stats.lifetime_budget) / 100;
+  if (stats.budget_remaining) u.budget_remaining = Number(stats.budget_remaining) / 100;
+  try {
+    const breakdowns = args.breakdowns;
+    let extra = "date_preset=maximum";
+    if (breakdowns) extra += `&breakdowns=${enc(breakdowns)}`;
+    const ins = await graphGet(`${c.meta_campaign_id}/insights`, "spend,impressions,clicks,reach,cpc,cpm,ctr,actions", int.accessToken, extra);
+    const results = ins.data;
+    if (breakdowns && results?.length) {
+      u.raw_insights = results;
+    } else {
+      const d = results?.[0];
+      if (d) {
+        if (d.spend) u.spend = Number(d.spend);
+        if (d.impressions) u.impressions = Number(d.impressions);
+        if (d.clicks) u.clicks = Number(d.clicks);
+        if (d.reach) u.reach = Number(d.reach);
+        if (d.cpc) u.cpc = Number(d.cpc);
+        if (d.cpm) u.cpm = Number(d.cpm);
+        if (d.ctr) u.ctr = Number(d.ctr);
+        u.raw_insights = d;
+      }
+    }
+  } catch {/* insights may not exist yet */}
+  await sb.from("meta_campaigns").update(u).eq("id", id);
+  const {
+    data: refreshed
+  } = await sb.from("meta_campaigns").select("*").eq("id", id).single();
+  return {
+    success: true,
+    data: refreshed
+  };
+}
+
+// ============================================================================
+// INSIGHTS BREAKDOWN
+// ============================================================================
+
+export async function handleInsightsBreakdown(sb, args, storeId) {
+  const id = args.campaign_id || args.ad_set_id || args.ad_id || args.id;
+  if (!id) return {
+    success: false,
+    error: "campaign_id, ad_set_id, or ad_id required"
+  };
+  const breakdowns = args.breakdowns || "age,gender";
+  let metaId = null;
+  if (args.campaign_id || !args.ad_set_id && !args.ad_id) {
+    const {
+      data
+    } = await sb.from("meta_campaigns").select("meta_campaign_id").eq("id", id).eq("store_id", storeId).single();
+    metaId = data?.meta_campaign_id;
+  } else if (args.ad_set_id) {
+    const {
+      data
+    } = await sb.from("meta_ad_sets").select("meta_ad_set_id").eq("id", id).eq("store_id", storeId).single();
+    metaId = data?.meta_ad_set_id;
+  } else if (args.ad_id) {
+    const {
+      data
+    } = await sb.from("meta_ads").select("meta_ad_id").eq("id", id).eq("store_id", storeId).single();
+    metaId = data?.meta_ad_id;
+  }
+  if (!metaId || isLocalId(metaId)) return {
+    success: false,
+    error: "Entity not published yet. Publish first."
+  };
+  const int = await getIntegration(sb, storeId);
+  const datePreset = args.date_preset || "last_30d";
+  const fields = args.fields || "spend,impressions,clicks,reach,cpc,cpm,ctr,actions,cost_per_action_type";
+  const extra = `breakdowns=${enc(breakdowns)}&date_preset=${enc(datePreset)}`;
+  const ins = await graphGet(`${metaId}/insights`, fields, int.accessToken, extra);
+  return {
+    success: true,
+    data: ins.data || []
+  };
+}
+
+// ============================================================================
+// AD PREVIEW
+// ============================================================================
+
+export async function handleAdPreview(sb, args, storeId) {
+  const id = args.ad_id || args.id;
+  if (!id) return {
+    success: false,
+    error: "ad_id required"
+  };
+  const {
+    data: ad
+  } = await sb.from("meta_ads").select("meta_ad_id").eq("id", id).eq("store_id", storeId).single();
+  if (!ad) return {
+    success: false,
+    error: `Ad not found: ${id}`
+  };
+  if (isLocalId(ad.meta_ad_id)) return {
+    success: false,
+    error: "Ad not published yet. Publish first to get preview."
+  };
+  const int = await getIntegration(sb, storeId);
+  const format = args.ad_format || "DESKTOP_FEED_STANDARD";
+  const {
+    META_BASE
+  } = await import("./meta-ads-types.js");
+  const {
+    parseMetaError
+  } = await import("./meta-ads-graph-api.js");
+  const url = `${META_BASE}/${ad.meta_ad_id}/previews?ad_format=${enc(format)}&access_token=${enc(int.accessToken)}`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    const body = await res.text();
+    return {
+      success: false,
+      error: parseMetaError(body, "previews", res.status)
+    };
+  }
+  const json = await res.json();
+  return {
+    success: true,
+    data: json.data || []
+  };
+}
+//# sourceMappingURL=meta-ads-advanced.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-ads-advanced.js","names":["isLocalId","enc","graphGet","getIntegration","publishCampaign","publishAdSet","publishAd","queueSpan","auditRowToSpan","handleCreateAudience","handleListAudiences","handleGetAudience","handleDeleteAudience","handleCreateLookalike","handleCreateLeadForm","handleListLeadForms","handleGetLeads","handleListPixels","handleCreatePixel","handleDeletePixel","handleCreateCustomConversion","handleListCustomConversions","handleCreateRule","handleListRules","handleDeleteRule","handleReachEstimate","handleAudienceInsights","handleSearchTargeting","handlePublish","sb","args","storeId","type","id","success","error","result","store_id","action","resource_type","resource_id","details","source","severity","service_name","span_kind","status_code","start_time","Date","toISOString","end_time","data","handleSync","campaign_id","c","from","select","eq","single","meta_campaign_id","int","stats","accessToken","u","last_synced_at","status","effective_status","daily_budget","Number","lifetime_budget","budget_remaining","breakdowns","extra","ins","results","length","raw_insights","d","spend","impressions","clicks","reach","cpc","cpm","ctr","update","refreshed","handleInsightsBreakdown","ad_set_id","ad_id","metaId","meta_ad_set_id","meta_ad_id","datePreset","date_preset","fields","handleAdPreview","ad","format","ad_format","META_BASE","parseMetaError","url","res","fetch","ok","body","text","json"],"sources":["../../../src/server/handlers/meta-ads-advanced.ts"],"sourcesContent":["/**\n * Meta Ads — advanced handlers: publish dispatch, sync, insights, ad preview.\n *\n * Audience, pixel, rule, lead form, and targeting handlers are in:\n *   meta-ads-audiences.ts\n *   meta-ads-pixels-rules.ts\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { isLocalId } from \"./meta-ads-types.js\";\nimport { enc, graphGet, getIntegration } from \"./meta-ads-graph-api.js\";\nimport { publishCampaign, publishAdSet, publishAd } from \"./meta-ads-publish.js\";\nimport { queueSpan, auditRowToSpan } from \"../lib/clickhouse-buffer.js\";\n\n// Re-export all sub-module handlers so existing imports keep working\nexport {\n  handleCreateAudience,\n  handleListAudiences,\n  handleGetAudience,\n  handleDeleteAudience,\n  handleCreateLookalike,\n} from \"./meta-ads-audiences.js\";\n\nexport {\n  handleCreateLeadForm,\n  handleListLeadForms,\n  handleGetLeads,\n  handleListPixels,\n  handleCreatePixel,\n  handleDeletePixel,\n  handleCreateCustomConversion,\n  handleListCustomConversions,\n  handleCreateRule,\n  handleListRules,\n  handleDeleteRule,\n  handleReachEstimate,\n  handleAudienceInsights,\n  handleSearchTargeting,\n} from \"./meta-ads-pixels-rules.js\";\n\n// ============================================================================\n// PUBLISH (dispatch)\n// ============================================================================\n\nexport async function handlePublish(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const type = args.type as string;\n  const id = args.id as string;\n  if (!type) return { success: false, error: \"type required (campaign, ad_set, ad)\" };\n  if (!id) return { success: false, error: \"id required\" };\n\n  let result: unknown;\n  switch (type) {\n    case \"campaign\": result = await publishCampaign(sb, storeId, id); break;\n    case \"ad_set\": result = await publishAdSet(sb, storeId, id); break;\n    case \"ad\": result = await publishAd(sb, storeId, id); break;\n    default: return { success: false, error: `Invalid type: ${type}` };\n  }\n\n  // Telemetry\n  queueSpan(auditRowToSpan({\n    store_id: storeId, action: `meta_publish_${type}`,\n    resource_type: `meta_${type === \"ad_set\" ? \"ad_set\" : type}`, resource_id: id,\n    details: result, source: \"agent_chat\", severity: \"info\",\n    service_name: \"agent-server\", span_kind: \"INTERNAL\", status_code: \"OK\",\n    start_time: new Date().toISOString(), end_time: new Date().toISOString(),\n  }));\n  return { success: true, data: result };\n}\n\n// ============================================================================\n// SYNC\n// ============================================================================\n\nexport async function handleSync(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const id = (args.campaign_id || args.id) as string;\n  if (!id) return { success: false, error: \"campaign_id required\" };\n\n  const { data: c } = await sb.from(\"meta_campaigns\").select(\"meta_campaign_id\").eq(\"id\", id).eq(\"store_id\", storeId).single();\n  if (!c) return { success: false, error: `Campaign not found: ${id}` };\n  if (isLocalId(c.meta_campaign_id)) return { success: false, error: \"Campaign not published yet. Publish first.\" };\n\n  const int = await getIntegration(sb, storeId);\n  const stats = await graphGet(c.meta_campaign_id, \"name,status,effective_status,daily_budget,lifetime_budget,budget_remaining,start_time,stop_time\", int.accessToken);\n\n  const u: Record<string, unknown> = { last_synced_at: new Date().toISOString() };\n  if (stats.status) u.status = stats.status;\n  if (stats.effective_status) u.effective_status = stats.effective_status;\n  if (stats.daily_budget) u.daily_budget = Number(stats.daily_budget) / 100;\n  if (stats.lifetime_budget) u.lifetime_budget = Number(stats.lifetime_budget) / 100;\n  if (stats.budget_remaining) u.budget_remaining = Number(stats.budget_remaining) / 100;\n\n  try {\n    const breakdowns = args.breakdowns as string | undefined;\n    let extra = \"date_preset=maximum\";\n    if (breakdowns) extra += `&breakdowns=${enc(breakdowns)}`;\n\n    const ins = await graphGet(`${c.meta_campaign_id}/insights`, \"spend,impressions,clicks,reach,cpc,cpm,ctr,actions\", int.accessToken, extra);\n    const results = ins.data as Array<Record<string, unknown>>;\n\n    if (breakdowns && results?.length) {\n      u.raw_insights = results;\n    } else {\n      const d = results?.[0];\n      if (d) {\n        if (d.spend) u.spend = Number(d.spend);\n        if (d.impressions) u.impressions = Number(d.impressions);\n        if (d.clicks) u.clicks = Number(d.clicks);\n        if (d.reach) u.reach = Number(d.reach);\n        if (d.cpc) u.cpc = Number(d.cpc);\n        if (d.cpm) u.cpm = Number(d.cpm);\n        if (d.ctr) u.ctr = Number(d.ctr);\n        u.raw_insights = d;\n      }\n    }\n  } catch { /* insights may not exist yet */ }\n\n  await sb.from(\"meta_campaigns\").update(u).eq(\"id\", id);\n  const { data: refreshed } = await sb.from(\"meta_campaigns\").select(\"*\").eq(\"id\", id).single();\n  return { success: true, data: refreshed };\n}\n\n// ============================================================================\n// INSIGHTS BREAKDOWN\n// ============================================================================\n\nexport async function handleInsightsBreakdown(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const id = (args.campaign_id || args.ad_set_id || args.ad_id || args.id) as string;\n  if (!id) return { success: false, error: \"campaign_id, ad_set_id, or ad_id required\" };\n  const breakdowns = (args.breakdowns as string) || \"age,gender\";\n\n  let metaId: string | null = null;\n  if (args.campaign_id || (!args.ad_set_id && !args.ad_id)) {\n    const { data } = await sb.from(\"meta_campaigns\").select(\"meta_campaign_id\").eq(\"id\", id).eq(\"store_id\", storeId).single();\n    metaId = data?.meta_campaign_id;\n  } else if (args.ad_set_id) {\n    const { data } = await sb.from(\"meta_ad_sets\").select(\"meta_ad_set_id\").eq(\"id\", id).eq(\"store_id\", storeId).single();\n    metaId = data?.meta_ad_set_id;\n  } else if (args.ad_id) {\n    const { data } = await sb.from(\"meta_ads\").select(\"meta_ad_id\").eq(\"id\", id).eq(\"store_id\", storeId).single();\n    metaId = data?.meta_ad_id;\n  }\n\n  if (!metaId || isLocalId(metaId)) return { success: false, error: \"Entity not published yet. Publish first.\" };\n\n  const int = await getIntegration(sb, storeId);\n  const datePreset = (args.date_preset as string) || \"last_30d\";\n  const fields = (args.fields as string) || \"spend,impressions,clicks,reach,cpc,cpm,ctr,actions,cost_per_action_type\";\n\n  const extra = `breakdowns=${enc(breakdowns)}&date_preset=${enc(datePreset)}`;\n  const ins = await graphGet(`${metaId}/insights`, fields, int.accessToken, extra);\n  return { success: true, data: ins.data || [] };\n}\n\n// ============================================================================\n// AD PREVIEW\n// ============================================================================\n\nexport async function handleAdPreview(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const id = (args.ad_id || args.id) as string;\n  if (!id) return { success: false, error: \"ad_id required\" };\n\n  const { data: ad } = await sb.from(\"meta_ads\").select(\"meta_ad_id\").eq(\"id\", id).eq(\"store_id\", storeId).single();\n  if (!ad) return { success: false, error: `Ad not found: ${id}` };\n  if (isLocalId(ad.meta_ad_id)) return { success: false, error: \"Ad not published yet. Publish first to get preview.\" };\n\n  const int = await getIntegration(sb, storeId);\n  const format = (args.ad_format as string) || \"DESKTOP_FEED_STANDARD\";\n\n  const { META_BASE } = await import(\"./meta-ads-types.js\");\n  const { parseMetaError } = await import(\"./meta-ads-graph-api.js\");\n  const url = `${META_BASE}/${ad.meta_ad_id}/previews?ad_format=${enc(format)}&access_token=${enc(int.accessToken)}`;\n  const res = await fetch(url);\n  if (!res.ok) { const body = await res.text(); return { success: false, error: parseMetaError(body, \"previews\", res.status) }; }\n  const json = (await res.json()) as Record<string, unknown>;\n  return { success: true, data: json.data || [] };\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/handlers/meta-ads-audience-rules.test.js

@@ -0,0 +1,243 @@
+// meta-ads-audience-rules.test.ts — Tests for rules, targeting, reach estimate, error handling
+
+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";
+// ---------------------------------------------------------------------------
+// Mock global fetch for Meta Graph API calls
+// ---------------------------------------------------------------------------
+
+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();
+
+// ---------------------------------------------------------------------------
+// Test data helpers
+// ---------------------------------------------------------------------------
+
+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,
+      error_user_msg: "Something went wrong"
+    }
+  };
+  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);
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Tests — Rules, Targeting, Reach estimate, Error handling
+// ---------------------------------------------------------------------------
+
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — rules/targeting/errors", () => {
+  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: create_rule", () => {
+    it("creates an ad automation rule", async () => {
+      await setupMetaIntegration();
+      mockMetaFetchSuccess({
+        id: "rule_12345"
+      });
+      const result = await handleMetaAds(sb, {
+        action: "create_rule",
+        name: `${RUN_PREFIX} Auto-pause low CTR`,
+        evaluation_spec: {
+          filters: [{
+            field: "impressions",
+            value: 1000,
+            operator: "GREATER_THAN"
+          }, {
+            field: "ctr",
+            value: 0.5,
+            operator: "LESS_THAN"
+          }]
+        },
+        execution_spec: {
+          execution_type: "PAUSE"
+        }
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_rule",
+        evaluation_spec: {},
+        execution_spec: {}
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("name required");
+    });
+    it("returns error when evaluation_spec is missing", async () => {
+      await setupMetaIntegration();
+      const result = await handleMetaAds(sb, {
+        action: "create_rule",
+        name: `${RUN_PREFIX} Rule`,
+        execution_spec: {}
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("evaluation_spec required");
+    });
+    it("returns error when execution_spec is missing", async () => {
+      await setupMetaIntegration();
+      const result = await handleMetaAds(sb, {
+        action: "create_rule",
+        name: `${RUN_PREFIX} Rule`,
+        evaluation_spec: {}
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("execution_spec required");
+    });
+  });
+  describe("action: search_targeting", () => {
+    it("searches for interests", async () => {
+      await setupMetaIntegration();
+      mockMetaFetchSuccess({
+        data: [{
+          id: "6003139266461",
+          name: "Fitness and wellness"
+        }]
+      });
+      const result = await handleMetaAds(sb, {
+        action: "search_targeting",
+        query: "fitness"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when query is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "search_targeting"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("query required");
+    });
+    it("returns error on Meta API failure", async () => {
+      await setupMetaIntegration();
+      mockMetaFetchError(400);
+      const result = await handleMetaAds(sb, {
+        action: "search_targeting",
+        query: "invalid"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+    });
+  });
+  describe("action: reach_estimate", () => {
+    it("returns reach estimate for targeting spec", async () => {
+      await setupMetaIntegration();
+      mockMetaFetchSuccess({
+        data: [{
+          daily_outcomes_curve: [{
+            spend: 10,
+            reach: 5000
+          }],
+          estimate_dau: 15000,
+          estimate_ready: true
+        }]
+      });
+      const result = await handleMetaAds(sb, {
+        action: "reach_estimate",
+        targeting: {
+          geo_locations: {
+            countries: ["US"]
+          },
+          age_min: 25,
+          age_max: 55
+        }
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("returns error when targeting is missing", async () => {
+      await setupMetaIntegration();
+      const result = await handleMetaAds(sb, {
+        action: "reach_estimate"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("targeting required");
+    });
+  });
+  describe("Meta API error handling", () => {
+    it("handles missing Meta integration gracefully", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "list_audiences"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Meta not connected");
+    });
+    it("handles expired token", async () => {
+      await seedTracked("meta_integrations", [makeIntegrationRow({
+        token_expires_at: "2020-01-01T00:00:00Z"
+      })]);
+      const result = await handleMetaAds(sb, {
+        action: "list_audiences"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("expired");
+    });
+  });
+});