whale-code 6.5.6 → 6.5.7

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

@@ -0,0 +1,214 @@
+/**
+ * Meta Ads — audience handlers: custom audiences, lookalike audiences
+ */
+
+import { isLocalId } from "./meta-ads-types.js";
+import { graphGet, graphPost, graphDelete, getIntegration } from "./meta-ads-graph-api.js";
+
+// ============================================================================
+// CUSTOM AUDIENCES
+// ============================================================================
+
+export async function handleCreateAudience(sb, args, storeId) {
+  const name = args.name;
+  if (!name) return {
+    success: false,
+    error: "name required"
+  };
+  const int = await getIntegration(sb, storeId);
+  const subtype = args.subtype || "CUSTOM";
+  const metaParams = {
+    name,
+    subtype,
+    description: args.description || "",
+    customer_file_source: args.customer_file_source || "USER_PROVIDED_ONLY"
+  };
+  if (subtype === "WEBSITE") {
+    const pixelForAudience = args.pixel_id || int.pixelId;
+    if (!pixelForAudience) return {
+      success: false,
+      error: "pixel_id required for website audiences"
+    };
+    metaParams.rule = args.rule || {
+      inclusions: {
+        operator: "or",
+        rules: [{
+          event_sources: [{
+            id: pixelForAudience,
+            type: "pixel"
+          }],
+          retention_seconds: (Number(args.retention_days) || 30) * 86400
+        }]
+      }
+    };
+    if (args.retention_days) metaParams.retention_days = Number(args.retention_days);
+    if (args.prefill) metaParams.prefill = true;
+  }
+  if (subtype === "ENGAGEMENT") metaParams.rule = args.rule;
+  const result = await graphPost(`${int.adAccountId}/customaudiences`, metaParams, int.accessToken);
+  const metaAudienceId = result.id;
+  const {
+    data,
+    error
+  } = await sb.from("meta_audiences").insert({
+    store_id: storeId,
+    meta_audience_id: metaAudienceId || null,
+    name,
+    description: args.description || null,
+    audience_type: "custom",
+    subtype,
+    rule: args.rule || null,
+    customer_file_source: args.customer_file_source || null,
+    retention_days: args.retention_days ? Number(args.retention_days) : null
+  }).select().single();
+  if (error) return {
+    success: false,
+    error: error.message
+  };
+  return {
+    success: true,
+    data: {
+      ...data,
+      meta_audience_id: metaAudienceId
+    }
+  };
+}
+export async function handleListAudiences(sb, args, storeId) {
+  const int = await getIntegration(sb, storeId);
+  const fields = "id,name,description,subtype,approximate_count,delivery_status,operation_status,time_created,time_updated";
+  const result = await graphGet(`${int.adAccountId}/customaudiences`, fields, int.accessToken);
+  const audiences = result.data || [];
+  for (const aud of audiences) {
+    await sb.from("meta_audiences").upsert({
+      store_id: storeId,
+      meta_audience_id: aud.id,
+      name: aud.name,
+      description: aud.description || null,
+      subtype: aud.subtype || null,
+      approximate_count: aud.approximate_count ? Number(aud.approximate_count) : null,
+      updated_at: new Date().toISOString()
+    }, {
+      onConflict: "meta_audience_id",
+      ignoreDuplicates: false
+    }).then(() => {});
+  }
+  return {
+    success: true,
+    count: audiences.length,
+    data: audiences
+  };
+}
+export async function handleGetAudience(sb, args, storeId) {
+  const id = args.audience_id || args.id;
+  if (!id) return {
+    success: false,
+    error: "audience_id required"
+  };
+  let metaId = id;
+  if (isLocalId(id)) {
+    const {
+      data
+    } = await sb.from("meta_audiences").select("meta_audience_id").eq("id", id).single();
+    if (!data?.meta_audience_id) return {
+      success: false,
+      error: `Audience not found: ${id}`
+    };
+    metaId = data.meta_audience_id;
+  }
+  const int = await getIntegration(sb, storeId);
+  const result = await graphGet(metaId, "id,name,description,subtype,approximate_count,delivery_status,operation_status,rule,lookalike_spec,time_created,time_updated", int.accessToken);
+  return {
+    success: true,
+    data: result
+  };
+}
+export async function handleDeleteAudience(sb, args, storeId) {
+  const id = args.audience_id || args.id;
+  if (!id) return {
+    success: false,
+    error: "audience_id required"
+  };
+  let metaId = id;
+  if (isLocalId(id)) {
+    const {
+      data
+    } = await sb.from("meta_audiences").select("meta_audience_id").eq("id", id).single();
+    if (data?.meta_audience_id) metaId = data.meta_audience_id;
+  }
+  const int = await getIntegration(sb, storeId);
+  let metaDeleted = false;
+  if (!isLocalId(metaId)) {
+    try {
+      await graphDelete(metaId, int.accessToken);
+      metaDeleted = true;
+    } catch {/* continue */}
+  }
+  if (isLocalId(id)) await sb.from("meta_audiences").delete().eq("id", id);else await sb.from("meta_audiences").delete().eq("meta_audience_id", id).eq("store_id", storeId);
+  return {
+    success: true,
+    data: {
+      deleted: id,
+      meta_deleted: metaDeleted
+    }
+  };
+}
+export async function handleCreateLookalike(sb, args, storeId) {
+  const sourceId = args.source_audience_id || args.source_id;
+  if (!sourceId) return {
+    success: false,
+    error: "source_audience_id required (Meta audience ID)"
+  };
+  const int = await getIntegration(sb, storeId);
+  const name = args.name || `Lookalike \u2014 ${sourceId}`;
+  const country = args.country || "US";
+  const ratio = Number(args.ratio) || 0.01;
+  let sourceMetaId = sourceId;
+  if (isLocalId(sourceId)) {
+    const {
+      data
+    } = await sb.from("meta_audiences").select("meta_audience_id").eq("id", sourceId).single();
+    if (!data?.meta_audience_id) return {
+      success: false,
+      error: `Source audience not found: ${sourceId}`
+    };
+    sourceMetaId = data.meta_audience_id;
+  }
+  const result = await graphPost(`${int.adAccountId}/customaudiences`, {
+    name,
+    subtype: "LOOKALIKE",
+    origin_audience_id: sourceMetaId,
+    lookalike_spec: JSON.stringify({
+      type: "custom_ratio",
+      ratio,
+      country
+    })
+  }, int.accessToken);
+  const metaAudienceId = result.id;
+  const {
+    data,
+    error
+  } = await sb.from("meta_audiences").insert({
+    store_id: storeId,
+    meta_audience_id: metaAudienceId || null,
+    name,
+    audience_type: "lookalike",
+    subtype: "LOOKALIKE",
+    lookalike_spec: {
+      source_id: sourceMetaId,
+      country,
+      ratio
+    }
+  }).select().single();
+  if (error) return {
+    success: false,
+    error: error.message
+  };
+  return {
+    success: true,
+    data: {
+      ...data,
+      meta_audience_id: metaAudienceId
+    }
+  };
+}
+//# sourceMappingURL=meta-ads-audiences.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-ads-audiences.js","names":["isLocalId","graphGet","graphPost","graphDelete","getIntegration","handleCreateAudience","sb","args","storeId","name","success","error","int","subtype","metaParams","description","customer_file_source","pixelForAudience","pixel_id","pixelId","rule","inclusions","operator","rules","event_sources","id","type","retention_seconds","Number","retention_days","prefill","result","adAccountId","accessToken","metaAudienceId","data","from","insert","store_id","meta_audience_id","audience_type","select","single","message","handleListAudiences","fields","audiences","aud","upsert","approximate_count","updated_at","Date","toISOString","onConflict","ignoreDuplicates","then","count","length","handleGetAudience","audience_id","metaId","eq","handleDeleteAudience","metaDeleted","delete","deleted","meta_deleted","handleCreateLookalike","sourceId","source_audience_id","source_id","country","ratio","sourceMetaId","origin_audience_id","lookalike_spec","JSON","stringify"],"sources":["../../../src/server/handlers/meta-ads-audiences.ts"],"sourcesContent":["/**\n * Meta Ads — audience handlers: custom audiences, lookalike audiences\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { isLocalId } from \"./meta-ads-types.js\";\nimport { graphGet, graphPost, graphDelete, getIntegration } from \"./meta-ads-graph-api.js\";\n\n// ============================================================================\n// CUSTOM AUDIENCES\n// ============================================================================\n\nexport async function handleCreateAudience(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const name = args.name as string;\n  if (!name) return { success: false, error: \"name required\" };\n\n  const int = await getIntegration(sb, storeId);\n  const subtype = (args.subtype as string) || \"CUSTOM\";\n\n  const metaParams: Record<string, unknown> = { name, subtype, description: (args.description as string) || \"\", customer_file_source: (args.customer_file_source as string) || \"USER_PROVIDED_ONLY\" };\n\n  if (subtype === \"WEBSITE\") {\n    const pixelForAudience = (args.pixel_id as string) || int.pixelId;\n    if (!pixelForAudience) return { success: false, error: \"pixel_id required for website audiences\" };\n    metaParams.rule = args.rule || { inclusions: { operator: \"or\", rules: [{ event_sources: [{ id: pixelForAudience, type: \"pixel\" }], retention_seconds: (Number(args.retention_days) || 30) * 86400 }] } };\n    if (args.retention_days) metaParams.retention_days = Number(args.retention_days);\n    if (args.prefill) metaParams.prefill = true;\n  }\n  if (subtype === \"ENGAGEMENT\") metaParams.rule = args.rule;\n\n  const result = await graphPost(`${int.adAccountId}/customaudiences`, metaParams, int.accessToken);\n  const metaAudienceId = result.id as string;\n\n  const { data, error } = await sb.from(\"meta_audiences\").insert({\n    store_id: storeId, meta_audience_id: metaAudienceId || null, name,\n    description: (args.description as string) || null, audience_type: \"custom\", subtype,\n    rule: args.rule || null, customer_file_source: (args.customer_file_source as string) || null,\n    retention_days: args.retention_days ? Number(args.retention_days) : null,\n  }).select().single();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: { ...data, meta_audience_id: metaAudienceId } };\n}\n\nexport async function handleListAudiences(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const int = await getIntegration(sb, storeId);\n  const fields = \"id,name,description,subtype,approximate_count,delivery_status,operation_status,time_created,time_updated\";\n  const result = await graphGet(`${int.adAccountId}/customaudiences`, fields, int.accessToken);\n  const audiences = (result.data || []) as Array<Record<string, unknown>>;\n\n  for (const aud of audiences) {\n    await sb.from(\"meta_audiences\").upsert({\n      store_id: storeId, meta_audience_id: aud.id as string, name: aud.name as string,\n      description: (aud.description as string) || null, subtype: (aud.subtype as string) || null,\n      approximate_count: aud.approximate_count ? Number(aud.approximate_count) : null, updated_at: new Date().toISOString(),\n    }, { onConflict: \"meta_audience_id\", ignoreDuplicates: false }).then(() => {});\n  }\n  return { success: true, count: audiences.length, data: audiences };\n}\n\nexport async function handleGetAudience(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const id = (args.audience_id || args.id) as string;\n  if (!id) return { success: false, error: \"audience_id required\" };\n  let metaId = id;\n  if (isLocalId(id)) {\n    const { data } = await sb.from(\"meta_audiences\").select(\"meta_audience_id\").eq(\"id\", id).single();\n    if (!data?.meta_audience_id) return { success: false, error: `Audience not found: ${id}` };\n    metaId = data.meta_audience_id;\n  }\n  const int = await getIntegration(sb, storeId);\n  const result = await graphGet(metaId, \"id,name,description,subtype,approximate_count,delivery_status,operation_status,rule,lookalike_spec,time_created,time_updated\", int.accessToken);\n  return { success: true, data: result };\n}\n\nexport async function handleDeleteAudience(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const id = (args.audience_id || args.id) as string;\n  if (!id) return { success: false, error: \"audience_id required\" };\n  let metaId = id;\n  if (isLocalId(id)) {\n    const { data } = await sb.from(\"meta_audiences\").select(\"meta_audience_id\").eq(\"id\", id).single();\n    if (data?.meta_audience_id) metaId = data.meta_audience_id;\n  }\n  const int = await getIntegration(sb, storeId);\n  let metaDeleted = false;\n  if (!isLocalId(metaId)) { try { await graphDelete(metaId, int.accessToken); metaDeleted = true; } catch { /* continue */ } }\n  if (isLocalId(id)) await sb.from(\"meta_audiences\").delete().eq(\"id\", id);\n  else await sb.from(\"meta_audiences\").delete().eq(\"meta_audience_id\", id).eq(\"store_id\", storeId);\n  return { success: true, data: { deleted: id, meta_deleted: metaDeleted } };\n}\n\nexport async function handleCreateLookalike(sb: SupabaseClient, args: Record<string, unknown>, storeId: string) {\n  const sourceId = (args.source_audience_id || args.source_id) as string;\n  if (!sourceId) return { success: false, error: \"source_audience_id required (Meta audience ID)\" };\n  const int = await getIntegration(sb, storeId);\n  const name = (args.name as string) || `Lookalike \\u2014 ${sourceId}`;\n  const country = (args.country as string) || \"US\";\n  const ratio = Number(args.ratio) || 0.01;\n\n  let sourceMetaId = sourceId;\n  if (isLocalId(sourceId)) {\n    const { data } = await sb.from(\"meta_audiences\").select(\"meta_audience_id\").eq(\"id\", sourceId).single();\n    if (!data?.meta_audience_id) return { success: false, error: `Source audience not found: ${sourceId}` };\n    sourceMetaId = data.meta_audience_id;\n  }\n\n  const result = await graphPost(`${int.adAccountId}/customaudiences`, {\n    name, subtype: \"LOOKALIKE\", origin_audience_id: sourceMetaId,\n    lookalike_spec: JSON.stringify({ type: \"custom_ratio\", ratio, country }),\n  }, int.accessToken);\n  const metaAudienceId = result.id as string;\n\n  const { data, error } = await sb.from(\"meta_audiences\").insert({\n    store_id: storeId, meta_audience_id: metaAudienceId || null, name,\n    audience_type: \"lookalike\", subtype: \"LOOKALIKE\", lookalike_spec: { source_id: sourceMetaId, country, ratio },\n  }).select().single();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: { ...data, meta_audience_id: metaAudienceId } };\n}\n"],"mappings":"AAAA;AACA;AACA;;AAGA,SAASA,SAAS,QAAQ,qBAAqB;AAC/C,SAASC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,EAAEC,cAAc,QAAQ,yBAAyB;;AAE1F;AACA;AACA;;AAEA,OAAO,eAAeC,oBAAoBA,CAACC,EAAkB,EAAEC,IAA6B,EAAEC,OAAe,EAAE;EAC7G,MAAMC,IAAI,GAAGF,IAAI,CAACE,IAAc;EAChC,IAAI,CAACA,IAAI,EAAE,OAAO;IAAEC,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAE;EAAgB,CAAC;EAE5D,MAAMC,GAAG,GAAG,MAAMR,cAAc,CAACE,EAAE,EAAEE,OAAO,CAAC;EAC7C,MAAMK,OAAO,GAAIN,IAAI,CAACM,OAAO,IAAe,QAAQ;EAEpD,MAAMC,UAAmC,GAAG;IAAEL,IAAI;IAAEI,OAAO;IAAEE,WAAW,EAAGR,IAAI,CAACQ,WAAW,IAAe,EAAE;IAAEC,oBAAoB,EAAGT,IAAI,CAACS,oBAAoB,IAAe;EAAqB,CAAC;EAEnM,IAAIH,OAAO,KAAK,SAAS,EAAE;IACzB,MAAMI,gBAAgB,GAAIV,IAAI,CAACW,QAAQ,IAAeN,GAAG,CAACO,OAAO;IACjE,IAAI,CAACF,gBAAgB,EAAE,OAAO;MAAEP,OAAO,EAAE,KAAK;MAAEC,KAAK,EAAE;IAA0C,CAAC;IAClGG,UAAU,CAACM,IAAI,GAAGb,IAAI,CAACa,IAAI,IAAI;MAAEC,UAAU,EAAE;QAAEC,QAAQ,EAAE,IAAI;QAAEC,KAAK,EAAE,CAAC;UAAEC,aAAa,EAAE,CAAC;YAAEC,EAAE,EAAER,gBAAgB;YAAES,IAAI,EAAE;UAAQ,CAAC,CAAC;UAAEC,iBAAiB,EAAE,CAACC,MAAM,CAACrB,IAAI,CAACsB,cAAc,CAAC,IAAI,EAAE,IAAI;QAAM,CAAC;MAAE;IAAE,CAAC;IACxM,IAAItB,IAAI,CAACsB,cAAc,EAAEf,UAAU,CAACe,cAAc,GAAGD,MAAM,CAACrB,IAAI,CAACsB,cAAc,CAAC;IAChF,IAAItB,IAAI,CAACuB,OAAO,EAAEhB,UAAU,CAACgB,OAAO,GAAG,IAAI;EAC7C;EACA,IAAIjB,OAAO,KAAK,YAAY,EAAEC,UAAU,CAACM,IAAI,GAAGb,IAAI,CAACa,IAAI;EAEzD,MAAMW,MAAM,GAAG,MAAM7B,SAAS,CAAC,GAAGU,GAAG,CAACoB,WAAW,kBAAkB,EAAElB,UAAU,EAAEF,GAAG,CAACqB,WAAW,CAAC;EACjG,MAAMC,cAAc,GAAGH,MAAM,CAACN,EAAY;EAE1C,MAAM;IAAEU,IAAI;IAAExB;EAAM,CAAC,GAAG,MAAML,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACC,MAAM,CAAC;IAC7DC,QAAQ,EAAE9B,OAAO;IAAE+B,gBAAgB,EAAEL,cAAc,IAAI,IAAI;IAAEzB,IAAI;IACjEM,WAAW,EAAGR,IAAI,CAACQ,WAAW,IAAe,IAAI;IAAEyB,aAAa,EAAE,QAAQ;IAAE3B,OAAO;IACnFO,IAAI,EAAEb,IAAI,CAACa,IAAI,IAAI,IAAI;IAAEJ,oBAAoB,EAAGT,IAAI,CAACS,oBAAoB,IAAe,IAAI;IAC5Fa,cAAc,EAAEtB,IAAI,CAACsB,cAAc,GAAGD,MAAM,CAACrB,IAAI,CAACsB,cAAc,CAAC,GAAG;EACtE,CAAC,CAAC,CAACY,MAAM,CAAC,CAAC,CAACC,MAAM,CAAC,CAAC;EACpB,IAAI/B,KAAK,EAAE,OAAO;IAAED,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAEA,KAAK,CAACgC;EAAQ,CAAC;EAC1D,OAAO;IAAEjC,OAAO,EAAE,IAAI;IAAEyB,IAAI,EAAE;MAAE,GAAGA,IAAI;MAAEI,gBAAgB,EAAEL;IAAe;EAAE,CAAC;AAC/E;AAEA,OAAO,eAAeU,mBAAmBA,CAACtC,EAAkB,EAAEC,IAA6B,EAAEC,OAAe,EAAE;EAC5G,MAAMI,GAAG,GAAG,MAAMR,cAAc,CAACE,EAAE,EAAEE,OAAO,CAAC;EAC7C,MAAMqC,MAAM,GAAG,0GAA0G;EACzH,MAAMd,MAAM,GAAG,MAAM9B,QAAQ,CAAC,GAAGW,GAAG,CAACoB,WAAW,kBAAkB,EAAEa,MAAM,EAAEjC,GAAG,CAACqB,WAAW,CAAC;EAC5F,MAAMa,SAAS,GAAIf,MAAM,CAACI,IAAI,IAAI,EAAqC;EAEvE,KAAK,MAAMY,GAAG,IAAID,SAAS,EAAE;IAC3B,MAAMxC,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACY,MAAM,CAAC;MACrCV,QAAQ,EAAE9B,OAAO;MAAE+B,gBAAgB,EAAEQ,GAAG,CAACtB,EAAY;MAAEhB,IAAI,EAAEsC,GAAG,CAACtC,IAAc;MAC/EM,WAAW,EAAGgC,GAAG,CAAChC,WAAW,IAAe,IAAI;MAAEF,OAAO,EAAGkC,GAAG,CAAClC,OAAO,IAAe,IAAI;MAC1FoC,iBAAiB,EAAEF,GAAG,CAACE,iBAAiB,GAAGrB,MAAM,CAACmB,GAAG,CAACE,iBAAiB,CAAC,GAAG,IAAI;MAAEC,UAAU,EAAE,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC;IACtH,CAAC,EAAE;MAAEC,UAAU,EAAE,kBAAkB;MAAEC,gBAAgB,EAAE;IAAM,CAAC,CAAC,CAACC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;EAChF;EACA,OAAO;IAAE7C,OAAO,EAAE,IAAI;IAAE8C,KAAK,EAAEV,SAAS,CAACW,MAAM;IAAEtB,IAAI,EAAEW;EAAU,CAAC;AACpE;AAEA,OAAO,eAAeY,iBAAiBA,CAACpD,EAAkB,EAAEC,IAA6B,EAAEC,OAAe,EAAE;EAC1G,MAAMiB,EAAE,GAAIlB,IAAI,CAACoD,WAAW,IAAIpD,IAAI,CAACkB,EAAa;EAClD,IAAI,CAACA,EAAE,EAAE,OAAO;IAAEf,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAE;EAAuB,CAAC;EACjE,IAAIiD,MAAM,GAAGnC,EAAE;EACf,IAAIzB,SAAS,CAACyB,EAAE,CAAC,EAAE;IACjB,MAAM;MAAEU;IAAK,CAAC,GAAG,MAAM7B,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACK,MAAM,CAAC,kBAAkB,CAAC,CAACoB,EAAE,CAAC,IAAI,EAAEpC,EAAE,CAAC,CAACiB,MAAM,CAAC,CAAC;IACjG,IAAI,CAACP,IAAI,EAAEI,gBAAgB,EAAE,OAAO;MAAE7B,OAAO,EAAE,KAAK;MAAEC,KAAK,EAAE,uBAAuBc,EAAE;IAAG,CAAC;IAC1FmC,MAAM,GAAGzB,IAAI,CAACI,gBAAgB;EAChC;EACA,MAAM3B,GAAG,GAAG,MAAMR,cAAc,CAACE,EAAE,EAAEE,OAAO,CAAC;EAC7C,MAAMuB,MAAM,GAAG,MAAM9B,QAAQ,CAAC2D,MAAM,EAAE,8HAA8H,EAAEhD,GAAG,CAACqB,WAAW,CAAC;EACtL,OAAO;IAAEvB,OAAO,EAAE,IAAI;IAAEyB,IAAI,EAAEJ;EAAO,CAAC;AACxC;AAEA,OAAO,eAAe+B,oBAAoBA,CAACxD,EAAkB,EAAEC,IAA6B,EAAEC,OAAe,EAAE;EAC7G,MAAMiB,EAAE,GAAIlB,IAAI,CAACoD,WAAW,IAAIpD,IAAI,CAACkB,EAAa;EAClD,IAAI,CAACA,EAAE,EAAE,OAAO;IAAEf,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAE;EAAuB,CAAC;EACjE,IAAIiD,MAAM,GAAGnC,EAAE;EACf,IAAIzB,SAAS,CAACyB,EAAE,CAAC,EAAE;IACjB,MAAM;MAAEU;IAAK,CAAC,GAAG,MAAM7B,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACK,MAAM,CAAC,kBAAkB,CAAC,CAACoB,EAAE,CAAC,IAAI,EAAEpC,EAAE,CAAC,CAACiB,MAAM,CAAC,CAAC;IACjG,IAAIP,IAAI,EAAEI,gBAAgB,EAAEqB,MAAM,GAAGzB,IAAI,CAACI,gBAAgB;EAC5D;EACA,MAAM3B,GAAG,GAAG,MAAMR,cAAc,CAACE,EAAE,EAAEE,OAAO,CAAC;EAC7C,IAAIuD,WAAW,GAAG,KAAK;EACvB,IAAI,CAAC/D,SAAS,CAAC4D,MAAM,CAAC,EAAE;IAAE,IAAI;MAAE,MAAMzD,WAAW,CAACyD,MAAM,EAAEhD,GAAG,CAACqB,WAAW,CAAC;MAAE8B,WAAW,GAAG,IAAI;IAAE,CAAC,CAAC,MAAM,CAAE;EAAiB;EAC3H,IAAI/D,SAAS,CAACyB,EAAE,CAAC,EAAE,MAAMnB,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAAC4B,MAAM,CAAC,CAAC,CAACH,EAAE,CAAC,IAAI,EAAEpC,EAAE,CAAC,CAAC,KACpE,MAAMnB,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAAC4B,MAAM,CAAC,CAAC,CAACH,EAAE,CAAC,kBAAkB,EAAEpC,EAAE,CAAC,CAACoC,EAAE,CAAC,UAAU,EAAErD,OAAO,CAAC;EAChG,OAAO;IAAEE,OAAO,EAAE,IAAI;IAAEyB,IAAI,EAAE;MAAE8B,OAAO,EAAExC,EAAE;MAAEyC,YAAY,EAAEH;IAAY;EAAE,CAAC;AAC5E;AAEA,OAAO,eAAeI,qBAAqBA,CAAC7D,EAAkB,EAAEC,IAA6B,EAAEC,OAAe,EAAE;EAC9G,MAAM4D,QAAQ,GAAI7D,IAAI,CAAC8D,kBAAkB,IAAI9D,IAAI,CAAC+D,SAAoB;EACtE,IAAI,CAACF,QAAQ,EAAE,OAAO;IAAE1D,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAE;EAAiD,CAAC;EACjG,MAAMC,GAAG,GAAG,MAAMR,cAAc,CAACE,EAAE,EAAEE,OAAO,CAAC;EAC7C,MAAMC,IAAI,GAAIF,IAAI,CAACE,IAAI,IAAe,oBAAoB2D,QAAQ,EAAE;EACpE,MAAMG,OAAO,GAAIhE,IAAI,CAACgE,OAAO,IAAe,IAAI;EAChD,MAAMC,KAAK,GAAG5C,MAAM,CAACrB,IAAI,CAACiE,KAAK,CAAC,IAAI,IAAI;EAExC,IAAIC,YAAY,GAAGL,QAAQ;EAC3B,IAAIpE,SAAS,CAACoE,QAAQ,CAAC,EAAE;IACvB,MAAM;MAAEjC;IAAK,CAAC,GAAG,MAAM7B,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACK,MAAM,CAAC,kBAAkB,CAAC,CAACoB,EAAE,CAAC,IAAI,EAAEO,QAAQ,CAAC,CAAC1B,MAAM,CAAC,CAAC;IACvG,IAAI,CAACP,IAAI,EAAEI,gBAAgB,EAAE,OAAO;MAAE7B,OAAO,EAAE,KAAK;MAAEC,KAAK,EAAE,8BAA8ByD,QAAQ;IAAG,CAAC;IACvGK,YAAY,GAAGtC,IAAI,CAACI,gBAAgB;EACtC;EAEA,MAAMR,MAAM,GAAG,MAAM7B,SAAS,CAAC,GAAGU,GAAG,CAACoB,WAAW,kBAAkB,EAAE;IACnEvB,IAAI;IAAEI,OAAO,EAAE,WAAW;IAAE6D,kBAAkB,EAAED,YAAY;IAC5DE,cAAc,EAAEC,IAAI,CAACC,SAAS,CAAC;MAAEnD,IAAI,EAAE,cAAc;MAAE8C,KAAK;MAAED;IAAQ,CAAC;EACzE,CAAC,EAAE3D,GAAG,CAACqB,WAAW,CAAC;EACnB,MAAMC,cAAc,GAAGH,MAAM,CAACN,EAAY;EAE1C,MAAM;IAAEU,IAAI;IAAExB;EAAM,CAAC,GAAG,MAAML,EAAE,CAAC8B,IAAI,CAAC,gBAAgB,CAAC,CAACC,MAAM,CAAC;IAC7DC,QAAQ,EAAE9B,OAAO;IAAE+B,gBAAgB,EAAEL,cAAc,IAAI,IAAI;IAAEzB,IAAI;IACjE+B,aAAa,EAAE,WAAW;IAAE3B,OAAO,EAAE,WAAW;IAAE8D,cAAc,EAAE;MAAEL,SAAS,EAAEG,YAAY;MAAEF,OAAO;MAAEC;IAAM;EAC9G,CAAC,CAAC,CAAC/B,MAAM,CAAC,CAAC,CAACC,MAAM,CAAC,CAAC;EACpB,IAAI/B,KAAK,EAAE,OAAO;IAAED,OAAO,EAAE,KAAK;IAAEC,KAAK,EAAEA,KAAK,CAACgC;EAAQ,CAAC;EAC1D,OAAO;IAAEjC,OAAO,EAAE,IAAI;IAAEyB,IAAI,EAAE;MAAE,GAAGA,IAAI;MAAEI,gBAAgB,EAAEL;IAAe;EAAE,CAAC;AAC/E","ignoreList":[]}

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

@@ -0,0 +1,136 @@
+// meta-ads-crud-ads.test.ts — Tests for create_ad and create_full CRUD
+
+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 — create_ad, create_full
+// ---------------------------------------------------------------------------
+
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — CRUD ads", () => {
+  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_ad", () => {
+    it("creates an ad linked to an ad set", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_adcamp`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} AdCamp`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const [adSet] = await seedTracked("meta_ad_sets", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_ad_set_id: `local_${RUN_PREFIX}_adset`,
+        meta_campaign_id: camp.id,
+        name: `${RUN_PREFIX} AdSet`,
+        optimization_goal: "REACH",
+        billing_event: "IMPRESSIONS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "create_ad",
+        ad_set_id: adSet.id,
+        name: `${RUN_PREFIX} Main Ad`,
+        headline: "Buy Now",
+        body: "Best deals",
+        image_url: "https://example.com/img.jpg",
+        link_url: "https://example.com"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data).toBeDefined();
+    });
+    it("returns error when ad_set_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad",
+        name: "Ad"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("ad_set_id required");
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad",
+        ad_set_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("name required");
+    });
+    it("returns error when ad set not found", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad",
+        ad_set_id: randomUUID(),
+        name: `${RUN_PREFIX} Ad`
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Ad set not found");
+    });
+  });
+  describe("action: create_full", () => {
+    it("creates campaign + ad set + ad in one call", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_full",
+        name: `${RUN_PREFIX} Full Stack Campaign`,
+        headline: "Big Sale",
+        body: "50% off",
+        image_url: "https://example.com/sale.jpg",
+        link_url: "https://example.com",
+        daily_budget: 50
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data).toHaveProperty("campaign");
+      expect(data).toHaveProperty("ad_set");
+      expect(data).toHaveProperty("ad");
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_full"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("name required");
+    });
+    it("creates as drafts by default (not published)", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_full",
+        name: `${RUN_PREFIX} Draft Campaign`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.published).toBe(false);
+    });
+    it("returns hint about publish when not auto_publish", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_full",
+        name: `${RUN_PREFIX} Hint Test`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      const data = result.data;
+      expect(data.hint).toBeDefined();
+    });
+  });
+});

package/dist/server/handlers/meta-ads-crud-campaigns.test.js

@@ -0,0 +1,189 @@
+// meta-ads-crud-campaigns.test.ts — Tests for campaign and ad set CRUD
+
+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 — missing store, unknown action, create_campaign, create_ad_set
+// ---------------------------------------------------------------------------
+
+describe.skipIf(!HAS_TEST_DB)("handleMetaAds — CRUD campaigns", () => {
+  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("missing store_id", () => {
+    it("returns error when store_id is undefined", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "list_campaigns"
+      });
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("store_id required");
+    });
+  });
+  describe("unknown action", () => {
+    it("returns error for invalid action", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "nonexistent"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Unknown action");
+    });
+    it("lists valid actions in error message", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "bad"
+      }, TEST_STORE);
+      expect(result.error).toContain("create_campaign");
+      expect(result.error).toContain("list_campaigns");
+      expect(result.error).toContain("publish");
+    });
+  });
+  describe("action: create_campaign", () => {
+    it("creates a campaign with minimal fields", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} Summer Sale`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data).toBeDefined();
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("name required");
+    });
+    it("sets default objective to OUTCOME_AWARENESS", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} Default Obj`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("accepts custom objective", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} Traffic Campaign`,
+        objective: "OUTCOME_TRAFFIC"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("accepts budget fields", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} Budget Campaign`,
+        daily_budget: 50,
+        lifetime_budget: 1000
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("accepts CBO settings", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} CBO Campaign`,
+        is_cbo: true,
+        campaign_bid_strategy: "LOWEST_COST_WITHOUT_CAP"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+    it("accepts start and stop times", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_campaign",
+        name: `${RUN_PREFIX} Scheduled Campaign`,
+        start_time: "2026-03-01T00:00:00Z",
+        stop_time: "2026-04-01T00:00:00Z"
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+  });
+  describe("action: create_ad_set", () => {
+    it("creates an ad set linked to a campaign", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_camp1`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} Camp`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "create_ad_set",
+        campaign_id: camp.id,
+        name: `${RUN_PREFIX} Main Ad Set`
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+      expect(result.data).toBeDefined();
+    });
+    it("returns error when campaign_id is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad_set",
+        name: "Ad Set"
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("campaign_id required");
+    });
+    it("returns error when name is missing", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad_set",
+        campaign_id: randomUUID()
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("name required");
+    });
+    it("returns error when campaign not found", async () => {
+      const result = await handleMetaAds(sb, {
+        action: "create_ad_set",
+        campaign_id: randomUUID(),
+        name: `${RUN_PREFIX} Ad Set`
+      }, TEST_STORE);
+      expect(result.success).toBe(false);
+      expect(result.error).toContain("Campaign not found");
+    });
+    it("accepts targeting configuration", async () => {
+      const [camp] = await seedTracked("meta_campaigns", [{
+        id: randomUUID(),
+        store_id: TEST_STORE,
+        meta_campaign_id: `local_${RUN_PREFIX}_tgt`,
+        meta_account_id: "draft",
+        name: `${RUN_PREFIX} TgtCamp`,
+        objective: "OUTCOME_AWARENESS",
+        status: "DRAFT"
+      }]);
+      const result = await handleMetaAds(sb, {
+        action: "create_ad_set",
+        campaign_id: camp.id,
+        name: `${RUN_PREFIX} Targeted Set`,
+        targeting: {
+          geo_locations: {
+            countries: ["US"]
+          },
+          age_min: 25,
+          age_max: 55
+        }
+      }, TEST_STORE);
+      expect(result.success).toBe(true);
+    });
+  });
+});