mcp-meta-ads-incrementality 0.2.1 → 0.2.2

package/dist/tools/url-tags.js

@@ -0,0 +1,616 @@
+/**
+ * URL-tags tools — read and update the `url_tags` query-string fragment that
+ * Meta appends to ad clickthrough URLs.
+ *
+ * Why a thin Graph-API client instead of the SDK: the SDK adapter in this repo
+ * is shaped around insights cursors. URL-tags reads/writes are simple REST
+ * calls, so we hit the Graph API directly via fetch.
+ *
+ * Update strategy: create-then-rebind. We tried `POST /{ad-id}` with an
+ * inline creative override (`creative={creative_id, url_tags}`) — Meta returns
+ * success but silently no-ops, leaving the ad on the original creative.
+ * Verified empirically on ad 120243275305000447 (2026-05-05): POST returned
+ * success, read-back showed url_tags unchanged. Meta creatives are effectively
+ * immutable, so the working pattern is:
+ *   1. Read the existing creative's object_story_id (Page-post reference).
+ *   2. POST /act_X/adcreatives with same object_story_id + new url_tags →
+ *      yields a new creative_id.
+ *   3. POST /{ad-id} with creative_id=<new> to rebind.
+ * The ad-id is unchanged. Meta may briefly re-review the ad.
+ */
+import { graphGet, graphPost } from '../lib/graph.js';
+export async function listAdsInCampaign(campaignId, accessToken) {
+    const all = [];
+    let after;
+    do {
+        const params = {
+            fields: 'id,name,status,effective_status,campaign_id,creative{id}',
+            limit: '100',
+        };
+        if (after)
+            params.after = after;
+        const page = await graphGet(`${campaignId}/ads`, accessToken, params);
+        for (const ad of page.data) {
+            all.push({
+                id: ad.id,
+                name: ad.name,
+                status: ad.status,
+                effective_status: ad.effective_status,
+                campaign_id: ad.campaign_id,
+                creative_id: ad.creative?.id ?? '',
+            });
+        }
+        after = page.paging?.next ? page.paging.cursors?.after : undefined;
+    } while (after);
+    return all;
+}
+async function fetchAdsetLearningStage(adsetId, accessToken) {
+    if (!adsetId)
+        return null;
+    try {
+        const r = await graphGet(adsetId, accessToken, { fields: 'learning_stage_info' });
+        if (!r.learning_stage_info)
+            return null;
+        return {
+            status: r.learning_stage_info.status ?? null,
+            last_significant_edit_ts: r.learning_stage_info.last_significant_edit_ts ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function getAdUrlTags(adId, accessToken) {
+    const ad = await graphGet(adId, accessToken, {
+        fields: 'id,name,account_id,campaign_id,adset_id,campaign{id,name},creative{id,url_tags,object_story_id,effective_object_story_id,object_story_spec{link_data{link},video_data{call_to_action}}}',
+    });
+    const link = ad.creative?.object_story_spec?.link_data?.link ??
+        ad.creative?.object_story_spec?.video_data?.call_to_action?.value?.link ??
+        null;
+    const learning = await fetchAdsetLearningStage(ad.adset_id ?? null, accessToken);
+    return {
+        ad_id: ad.id,
+        ad_name: ad.name,
+        account_id: ad.account_id ?? '',
+        campaign_id: ad.campaign_id,
+        campaign_name: ad.campaign?.name ?? '',
+        creative_id: ad.creative?.id ?? '',
+        object_story_id: ad.creative?.object_story_id ?? ad.creative?.effective_object_story_id ?? null,
+        url_tags: ad.creative?.url_tags ?? null,
+        link,
+        learning_stage_info: learning,
+    };
+}
+/**
+ * Update url_tags via create-then-rebind WITH social-feedback preservation.
+ *
+ * The Meta UI itself forks a new creative when url_tags changes (verified by
+ * inspecting Ads Manager network calls 2026-05-05 — the internal payload
+ * shows action_metadata.type=DUPLICATION_UPGRADE and
+ * enable_social_feedback_preservation=true). Meta's relearning trigger is
+ * field-aware: changes to url_tags alone are documented as not resetting
+ * learning, when social-feedback preservation carries forward.
+ *
+ * This implementation replicates that behavior on the public Marketing API:
+ *   1. Read current creative → get object_story_id, account_id, learning_stage_info.
+ *   2. POST /act_X/adcreatives with {object_story_id, url_tags,
+ *      object_story_spec.use_page_actor_override flag implicit} — same
+ *      Page-post reference, only url_tags differs.
+ *   3. POST /{ad-id} with creative_id=<new>.
+ *   4. Re-read learning_stage_info; compare last_significant_edit_ts.
+ *
+ * If last_significant_edit_ts is unchanged, Meta did not consider the edit
+ * significant — confirming learning is preserved. If it advanced to roughly
+ * the time of our write, Meta did trigger a relearning event and the writer
+ * should be considered unsafe for active ads.
+ */
+export async function updateAdUrlTags(adId, newUrlTags, accessToken, dryRun) {
+    const before = await getAdUrlTags(adId, accessToken);
+    if (dryRun) {
+        return {
+            ad_id: before.ad_id,
+            ad_name: before.ad_name,
+            previous_url_tags: before.url_tags,
+            new_url_tags: newUrlTags,
+            previous_creative_id: before.creative_id,
+            new_creative_id: '',
+            changed: before.url_tags !== newUrlTags,
+            learning_before: before.learning_stage_info,
+            learning_after: null,
+            significant_edit_triggered: null,
+        };
+    }
+    if (before.url_tags === newUrlTags) {
+        return {
+            ad_id: before.ad_id,
+            ad_name: before.ad_name,
+            previous_url_tags: before.url_tags,
+            new_url_tags: newUrlTags,
+            previous_creative_id: before.creative_id,
+            new_creative_id: before.creative_id,
+            changed: false,
+            learning_before: before.learning_stage_info,
+            learning_after: before.learning_stage_info,
+            significant_edit_triggered: false,
+        };
+    }
+    if (!before.object_story_id) {
+        throw new Error(`Ad ${adId} creative ${before.creative_id} has no object_story_id; ` +
+            `create-then-rebind path requires a Page-post-backed creative.`);
+    }
+    if (!before.account_id) {
+        throw new Error(`Ad ${adId} did not return account_id.`);
+    }
+    const created = await graphPost(`act_${before.account_id}/adcreatives`, accessToken, {
+        object_story_id: before.object_story_id,
+        url_tags: newUrlTags,
+        name: `${before.ad_name} — url_tags ${new Date().toISOString().slice(0, 10)}`,
+    });
+    await graphPost(adId, accessToken, {
+        creative: JSON.stringify({ creative_id: created.id }),
+    });
+    const after = await getAdUrlTags(adId, accessToken);
+    const beforeTs = before.learning_stage_info?.last_significant_edit_ts ?? null;
+    const afterTs = after.learning_stage_info?.last_significant_edit_ts ?? null;
+    const significantEditTriggered = beforeTs !== null && afterTs !== null ? afterTs > beforeTs : null;
+    return {
+        ad_id: after.ad_id,
+        ad_name: after.ad_name,
+        previous_url_tags: before.url_tags,
+        new_url_tags: after.url_tags ?? newUrlTags,
+        previous_creative_id: before.creative_id,
+        new_creative_id: after.creative_id,
+        changed: before.creative_id !== after.creative_id || before.url_tags !== after.url_tags,
+        learning_before: before.learning_stage_info,
+        learning_after: after.learning_stage_info,
+        significant_edit_triggered: significantEditTriggered,
+    };
+}
+/**
+ * Fetch asset_customization_rules for a creative. Returns the raw array (may be
+ * empty/undefined). Used by the rebind safety check — these are the per-placement
+ * image rules that get silently dropped if the create-then-rebind path doesn't
+ * carry them through.
+ */
+async function fetchCustomizationRules(creativeId, accessToken) {
+    try {
+        const r = await graphGet(creativeId, accessToken, { fields: 'asset_feed_spec{asset_customization_rules}' });
+        return r.asset_feed_spec?.asset_customization_rules ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Swap the lead form on an ad by rebuilding its creative with a new form_id.
+ *
+ * Meta creatives are immutable, so we create-then-rebind:
+ *  1. Read the ad's current creative (full spec — handles both legacy
+ *     object_story_spec and modern asset_feed_spec creatives).
+ *  2. POST /act_X/adcreatives with the same image/text spec but new
+ *     lead_gen_form_id inside the SIGN_UP CTA.
+ *  3. POST /{ad-id} with creative_id=<new> to rebind.
+ *
+ * The ad-id is unchanged. Meta may briefly re-review.
+ */
+export async function swapAdLeadForm(adId, newFormId, accessToken, dryRun, ctaTypeOverride) {
+    const fields = 'id,name,account_id,creative{' +
+        'id,name,url_tags,object_story_id,effective_object_story_id,' +
+        'object_story_spec{page_id,link_data{link,message,name,description,image_hash,call_to_action}},' +
+        'asset_feed_spec{images,bodies,titles,descriptions,link_urls,call_to_action_types,call_to_actions,ad_formats,asset_customization_rules}' +
+        '}';
+    const ad = await graphGet(adId, accessToken, { fields });
+    const creative = ad.creative;
+    if (!creative)
+        throw new Error(`Ad ${adId}: no creative attached.`);
+    if (!ad.account_id)
+        throw new Error(`Ad ${adId}: response missing account_id.`);
+    const previousFormId = creative.object_story_spec?.link_data?.call_to_action?.value?.lead_gen_form_id ??
+        creative.asset_feed_spec?.call_to_actions?.[0]?.value?.lead_gen_form_id ??
+        null;
+    const existingCtaType = creative.object_story_spec?.link_data?.call_to_action?.type ??
+        creative.asset_feed_spec?.call_to_actions?.[0]?.type ??
+        null;
+    const ctaType = ctaTypeOverride ?? existingCtaType ?? 'SIGN_UP';
+    const isAssetFeed = !!creative.asset_feed_spec && (creative.asset_feed_spec.bodies?.length ?? 0) > 0;
+    const mode = isAssetFeed ? 'asset_feed_spec' : 'object_story_spec';
+    if (dryRun) {
+        return {
+            ad_id: ad.id,
+            ad_name: ad.name,
+            previous_creative_id: creative.id,
+            new_creative_id: '',
+            previous_form_id: previousFormId,
+            new_form_id: newFormId,
+            mode,
+            changed: previousFormId !== newFormId,
+        };
+    }
+    if (previousFormId === newFormId) {
+        return {
+            ad_id: ad.id,
+            ad_name: ad.name,
+            previous_creative_id: creative.id,
+            new_creative_id: creative.id,
+            previous_form_id: previousFormId,
+            new_form_id: newFormId,
+            mode,
+            changed: false,
+        };
+    }
+    const acct = ad.account_id.startsWith('act_') ? ad.account_id : `act_${ad.account_id}`;
+    const newCta = { type: ctaType, value: { lead_gen_form_id: newFormId } };
+    const body = {
+        name: `${creative.name ?? ad.name} — form-swap ${new Date().toISOString().slice(0, 10)}`,
+    };
+    if (creative.url_tags)
+        body.url_tags = creative.url_tags;
+    if (isAssetFeed) {
+        const afs = creative.asset_feed_spec;
+        const rebuilt = {
+            images: afs.images ?? [],
+            bodies: afs.bodies ?? [],
+            link_urls: afs.link_urls ?? [],
+            ad_formats: afs.ad_formats ?? ['SINGLE_IMAGE'],
+            call_to_action_types: [ctaType],
+            call_to_actions: [newCta],
+        };
+        if (afs.titles?.length)
+            rebuilt.titles = afs.titles;
+        if (afs.descriptions?.length)
+            rebuilt.descriptions = afs.descriptions;
+        if (afs.asset_customization_rules?.length) {
+            rebuilt.asset_customization_rules = afs.asset_customization_rules;
+        }
+        const oss = creative.object_story_spec;
+        const ossOut = { page_id: oss?.page_id };
+        if (oss?.instagram_actor_id)
+            ossOut.instagram_actor_id = oss.instagram_actor_id;
+        body.object_story_spec = JSON.stringify(ossOut);
+        body.asset_feed_spec = JSON.stringify(rebuilt);
+    }
+    else {
+        const oss = creative.object_story_spec;
+        const ld = oss?.link_data;
+        if (!oss?.page_id || !ld?.link || !ld?.message) {
+            throw new Error(`Ad ${adId} creative ${creative.id}: legacy creative missing page_id/link/message — cannot rebuild for form swap.`);
+        }
+        const linkData = {
+            link: ld.link,
+            message: ld.message,
+            call_to_action: newCta,
+        };
+        if (ld.image_hash)
+            linkData.image_hash = ld.image_hash;
+        if (ld.name)
+            linkData.name = ld.name;
+        if (ld.description)
+            linkData.description = ld.description;
+        const ossOut = { page_id: oss.page_id, link_data: linkData };
+        if (oss.instagram_actor_id)
+            ossOut.instagram_actor_id = oss.instagram_actor_id;
+        body.object_story_spec = JSON.stringify(ossOut);
+    }
+    const created = await graphPost(`${acct}/adcreatives`, accessToken, body);
+    await graphPost(adId, accessToken, {
+        creative: JSON.stringify({ creative_id: created.id }),
+    });
+    return {
+        ad_id: ad.id,
+        ad_name: ad.name,
+        previous_creative_id: creative.id,
+        new_creative_id: created.id,
+        previous_form_id: previousFormId,
+        new_form_id: newFormId,
+        mode,
+        changed: true,
+    };
+}
+/**
+ * Rebind an ad to a different creative_id. Atomic. ad_id stays stable.
+ * Use with createAdCreative to do full ad rebuilds (e.g. swap form + rebuild
+ * text content) without touching the ad_id.
+ *
+ * Safety check: if the OLD creative has `asset_customization_rules` (per-placement
+ * image rules set in Ads Manager UI) and the NEW creative does not carry them
+ * forward, the rebind is REFUSED. This catches the 2026-05-14 RDR class of bug
+ * where multi-variant headline writes silently flattened custom placements by image.
+ * Pass `force=true` to override (e.g. when the new creative deliberately replaces
+ * the placement rules).
+ */
+export async function rebindAdCreative(adId, newCreativeId, accessToken, dryRun, force = false) {
+    const before = await graphGet(adId, accessToken, { fields: 'id,name,creative{id}' });
+    const previousId = before.creative?.id ?? '';
+    if (dryRun || previousId === newCreativeId) {
+        return {
+            ad_id: before.id,
+            ad_name: before.name,
+            previous_creative_id: previousId,
+            new_creative_id: newCreativeId,
+            changed: previousId !== newCreativeId && !dryRun,
+            customization_rules_preserved: null,
+        };
+    }
+    let preserved = null;
+    if (previousId && !force) {
+        const [oldRules, newRules] = await Promise.all([
+            fetchCustomizationRules(previousId, accessToken),
+            fetchCustomizationRules(newCreativeId, accessToken),
+        ]);
+        if (oldRules.length > 0 && newRules.length === 0) {
+            throw new Error(`Refusing to rebind ad ${adId}: previous creative ${previousId} has ${oldRules.length} ` +
+                `asset_customization_rules (per-placement image rules set in Ads Manager UI), but new ` +
+                `creative ${newCreativeId} has none. Rebinding would silently drop custom placements ` +
+                `by image. Either (a) include asset_customization_rules in the new creative, or ` +
+                `(b) pass force=true if this drop is intentional.`);
+        }
+        preserved = oldRules.length === 0 ? null : newRules.length >= oldRules.length;
+    }
+    await graphPost(adId, accessToken, {
+        creative: JSON.stringify({ creative_id: newCreativeId }),
+    });
+    return {
+        ad_id: before.id,
+        ad_name: before.name,
+        previous_creative_id: previousId,
+        new_creative_id: newCreativeId,
+        changed: true,
+        customization_rules_preserved: preserved,
+    };
+}
+/**
+ * Edit text fields (primary texts / headlines / descriptions) on an ad's creative
+ * while PRESERVING images, videos, asset_customization_rules (per-placement image
+ * rules set in Ads Manager UI), call_to_actions, and link_urls.
+ *
+ * For asset_feed_spec ads: replaces only the specified text arrays. Refuses the
+ * edit if the existing asset_customization_rules reference per-text labels
+ * (body_label / title_label / description_label) and the new text count differs
+ * from the old — pass force=true to override (rules may end up referencing
+ * orphaned labels and break the placement targeting).
+ *
+ * For object_story_spec (legacy single-variant) ads: replaces link_data.message
+ * (single primary text), link_data.name (single headline), link_data.description.
+ * The messages/headlines/descriptions arrays must each have length ≤ 1 in that
+ * mode.
+ */
+export async function editCreativeText(adId, edits, accessToken, dryRun, force = false) {
+    if (!edits.messages && !edits.headlines && !edits.descriptions) {
+        throw new Error('editCreativeText: provide at least one of messages, headlines, descriptions.');
+    }
+    // Note: Meta caps multi-variant asset_feed_spec at 5 entries per field, but DCO
+    // creatives with per-placement label customization can legitimately exceed this.
+    // We don't pre-validate the count — Meta will reject on POST if invalid.
+    // instagram_actor_id deprecated for reads in v22+. call_to_actions returns
+    // permission-denied on DCO-style creatives — fetch it best-effort, fall back
+    // to call_to_action_types on the rebuild.
+    const baseFields = 'id,name,account_id,creative{' +
+        'id,name,url_tags,instagram_user_id,' +
+        'object_story_spec{page_id,link_data{link,message,name,description,image_hash,call_to_action}},' +
+        'asset_feed_spec{' +
+        'images{hash,adlabels},videos{video_id,thumbnail_url,adlabels},' +
+        'bodies{text,adlabels},titles{text,adlabels},descriptions{text,adlabels},' +
+        'link_urls{website_url,adlabels},call_to_action_types,' +
+        'ad_formats,optimization_type,asset_customization_rules' +
+        '}' +
+        '}';
+    let ad = await graphGet(adId, accessToken, { fields: baseFields });
+    // Try to also fetch call_to_actions; if denied, proceed without them.
+    try {
+        const withCtas = await graphGet(adId, accessToken, {
+            fields: 'creative{asset_feed_spec{call_to_actions}}',
+        });
+        const ctas = withCtas.creative?.asset_feed_spec?.call_to_actions;
+        if (ad.creative?.asset_feed_spec && ctas?.length) {
+            ad.creative.asset_feed_spec.call_to_actions = ctas;
+        }
+    }
+    catch {
+        // call_to_actions inaccessible (typical on DCO creatives) — skip.
+    }
+    const creative = ad.creative;
+    if (!creative)
+        throw new Error(`Ad ${adId}: no creative attached.`);
+    if (!ad.account_id)
+        throw new Error(`Ad ${adId}: response missing account_id.`);
+    const isAssetFeed = !!creative.asset_feed_spec && (creative.asset_feed_spec.bodies?.length ?? 0) > 0;
+    const mode = isAssetFeed ? 'asset_feed_spec' : 'object_story_spec';
+    const changedFields = [];
+    const acct = ad.account_id.startsWith('act_') ? ad.account_id : `act_${ad.account_id}`;
+    const body = {
+        name: `${creative.name ?? ad.name} — text-edit ${new Date().toISOString().slice(0, 10)}`,
+    };
+    if (creative.url_tags)
+        body.url_tags = creative.url_tags;
+    if (creative.instagram_user_id)
+        body.instagram_user_id = creative.instagram_user_id;
+    let rulesCount = 0;
+    if (isAssetFeed) {
+        const afs = creative.asset_feed_spec;
+        rulesCount = afs.asset_customization_rules?.length ?? 0;
+        // Refuse if rules reference labels we'd be replacing AND the new array length differs.
+        const rulesRefs = JSON.stringify(afs.asset_customization_rules ?? []);
+        const refsBody = rulesRefs.includes('"body_label"');
+        const refsTitle = rulesRefs.includes('"title_label"');
+        const refsDesc = rulesRefs.includes('"description_label"');
+        if (!force) {
+            if (edits.messages && refsBody && edits.messages.length !== (afs.bodies?.length ?? 0)) {
+                throw new Error(`Refusing to edit messages on ad ${adId}: asset_customization_rules reference body_label ` +
+                    `and new length (${edits.messages.length}) differs from existing (${afs.bodies?.length ?? 0}). ` +
+                    `Replacing would orphan label references. Pass force=true to override.`);
+            }
+            if (edits.headlines && refsTitle && edits.headlines.length !== (afs.titles?.length ?? 0)) {
+                throw new Error(`Refusing to edit headlines on ad ${adId}: asset_customization_rules reference title_label ` +
+                    `and new length (${edits.headlines.length}) differs from existing (${afs.titles?.length ?? 0}). ` +
+                    `Pass force=true to override.`);
+            }
+            if (edits.descriptions && refsDesc && edits.descriptions.length !== (afs.descriptions?.length ?? 0)) {
+                throw new Error(`Refusing to edit descriptions on ad ${adId}: asset_customization_rules reference ` +
+                    `description_label and new length (${edits.descriptions.length}) differs from existing ` +
+                    `(${afs.descriptions?.length ?? 0}). Pass force=true to override.`);
+            }
+        }
+        // Build replacement text arrays: keep adlabels[i] when present, swap text[i].
+        const swapText = (existing, newTexts, fieldName) => {
+            if (!newTexts)
+                return existing;
+            changedFields.push(fieldName);
+            return newTexts.map((text, i) => {
+                const out = { text };
+                const lbl = existing?.[i]?.adlabels;
+                if (lbl && Array.isArray(lbl) && lbl.length)
+                    out.adlabels = lbl;
+                return out;
+            });
+        };
+        // Meta returns one entry per (asset, adlabel) pair, but rejects POSTs with
+        // duplicate asset values (subcode 1815629). Group by asset key and merge
+        // adlabels so the rebuilt spec has unique assets with multi-label arrays.
+        const dedupeAssets = (arr, keyFn) => {
+            if (!arr?.length)
+                return arr;
+            const byKey = new Map();
+            for (const a of arr) {
+                const k = keyFn(a);
+                if (!k)
+                    continue;
+                const existing = byKey.get(k);
+                const labels = Array.isArray(a.adlabels) ? a.adlabels : [];
+                if (existing) {
+                    const seen = new Set(existing.adlabels.map((l) => JSON.stringify(l)));
+                    for (const l of labels) {
+                        const s = JSON.stringify(l);
+                        if (!seen.has(s)) {
+                            existing.adlabels.push(l);
+                            seen.add(s);
+                        }
+                    }
+                }
+                else {
+                    byKey.set(k, { ...a, adlabels: [...labels] });
+                }
+            }
+            return Array.from(byKey.values());
+        };
+        const rebuilt = {};
+        const dedupedImages = dedupeAssets(afs.images, (a) => a.hash ?? '');
+        const dedupedVideos = dedupeAssets(afs.videos, (a) => a.video_id ?? '');
+        if (dedupedImages?.length)
+            rebuilt.images = dedupedImages;
+        if (dedupedVideos?.length)
+            rebuilt.videos = dedupedVideos;
+        if (afs.link_urls?.length)
+            rebuilt.link_urls = afs.link_urls;
+        if (afs.call_to_action_types?.length)
+            rebuilt.call_to_action_types = afs.call_to_action_types;
+        if (afs.call_to_actions?.length)
+            rebuilt.call_to_actions = afs.call_to_actions;
+        if (afs.ad_formats?.length)
+            rebuilt.ad_formats = afs.ad_formats;
+        if (afs.optimization_type)
+            rebuilt.optimization_type = afs.optimization_type;
+        const newBodies = swapText(afs.bodies, edits.messages, 'messages');
+        const newTitles = swapText(afs.titles, edits.headlines, 'headlines');
+        const newDescriptions = swapText(afs.descriptions, edits.descriptions, 'descriptions');
+        if (newBodies?.length)
+            rebuilt.bodies = newBodies;
+        if (newTitles?.length)
+            rebuilt.titles = newTitles;
+        if (newDescriptions?.length)
+            rebuilt.descriptions = newDescriptions;
+        if (afs.asset_customization_rules?.length) {
+            rebuilt.asset_customization_rules = afs.asset_customization_rules;
+        }
+        const oss = creative.object_story_spec;
+        const ossOut = { page_id: oss?.page_id };
+        if (oss?.link_data)
+            ossOut.link_data = oss.link_data;
+        body.object_story_spec = JSON.stringify(ossOut);
+        body.asset_feed_spec = JSON.stringify(rebuilt);
+    }
+    else {
+        // Legacy single-variant. Caller may pass 0 or 1 entry per field.
+        const oss = creative.object_story_spec;
+        const ld = oss?.link_data;
+        if (!oss?.page_id || !ld) {
+            throw new Error(`Ad ${adId} creative ${creative.id}: legacy creative missing page_id/link_data.`);
+        }
+        const linkData = { ...ld };
+        const setOne = (newArr, key, label) => {
+            if (!newArr)
+                return;
+            if (newArr.length > 1) {
+                throw new Error(`editCreativeText: ad ${adId} is single-variant (object_story_spec mode); ${label} ` +
+                    `must have ≤1 entry (got ${newArr.length}). Use a multi-variant ad to mix headlines.`);
+            }
+            if (newArr.length === 1) {
+                linkData[key] = newArr[0];
+                changedFields.push(label);
+            }
+        };
+        setOne(edits.messages, 'message', 'messages');
+        setOne(edits.headlines, 'name', 'headlines');
+        setOne(edits.descriptions, 'description', 'descriptions');
+        const ossOut = { page_id: oss.page_id, link_data: linkData };
+        body.object_story_spec = JSON.stringify(ossOut);
+    }
+    if (changedFields.length === 0) {
+        return {
+            ad_id: ad.id,
+            ad_name: ad.name,
+            previous_creative_id: creative.id,
+            new_creative_id: creative.id,
+            mode,
+            changed_fields: [],
+            customization_rules_preserved: rulesCount,
+        };
+    }
+    if (dryRun) {
+        return {
+            ad_id: ad.id,
+            ad_name: ad.name,
+            previous_creative_id: creative.id,
+            new_creative_id: '',
+            mode,
+            changed_fields: changedFields,
+            customization_rules_preserved: rulesCount,
+        };
+    }
+    const created = await graphPost(`${acct}/adcreatives`, accessToken, body);
+    // Rebind WITHOUT force — relies on our own preservation; the safety check
+    // will catch any regression where we accidentally dropped customization rules.
+    await rebindAdCreative(adId, created.id, accessToken, false, false);
+    return {
+        ad_id: ad.id,
+        ad_name: ad.name,
+        previous_creative_id: creative.id,
+        new_creative_id: created.id,
+        mode,
+        changed_fields: changedFields,
+        customization_rules_preserved: rulesCount,
+    };
+}
+export async function renameAd(adId, newName, accessToken, dryRun) {
+    const before = await graphGet(adId, accessToken, {
+        fields: 'id,name',
+    });
+    if (dryRun || before.name === newName) {
+        return {
+            ad_id: before.id,
+            previous_name: before.name,
+            new_name: newName,
+            changed: !dryRun ? false : before.name !== newName,
+        };
+    }
+    await graphPost(adId, accessToken, { name: newName });
+    const after = await graphGet(adId, accessToken, {
+        fields: 'id,name',
+    });
+    return {
+        ad_id: after.id,
+        previous_name: before.name,
+        new_name: after.name,
+        changed: before.name !== after.name,
+    };
+}
+//# sourceMappingURL=url-tags.js.map

package/dist/tools/url-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-tags.js","sourceRoot":"","sources":["../../src/tools/url-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA2BtD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,WAAmB;IAEnB,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,IAAI,KAAyB,CAAC;IAC9B,GAAG,CAAC;QACF,MAAM,MAAM,GAA2B;YACrC,MAAM,EAAE,0DAA0D;YAClE,KAAK,EAAE,KAAK;SACb,CAAC;QACF,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAkB,GAAG,UAAU,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACvF,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,EAAE,CAAC,EAAE;gBACT,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,gBAAgB,EAAE,EAAE,CAAC,gBAAgB;gBACrC,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,WAAW,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC,QAAQ,KAAK,EAAE;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AA2CD,KAAK,UAAU,uBAAuB,CACpC,OAAsB,EACtB,WAAmB;IAEnB,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CACtB,OAAO,EACP,WAAW,EACX,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAClC,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,mBAAmB;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAAC,MAAM,IAAI,IAAI;YAC5C,wBAAwB,EAAE,CAAC,CAAC,mBAAmB,CAAC,wBAAwB,IAAI,IAAI;SACjF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,WAAmB;IAClE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAiB,IAAI,EAAE,WAAW,EAAE;QAC3D,MAAM,EAAE,yLAAyL;KAClM,CAAC,CAAC;IACH,MAAM,IAAI,GACR,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI;QAC/C,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI;QACvE,IAAI,CAAC;IACP,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,EAAE,CAAC,QAAQ,IAAI,IAAI,EAAE,WAAW,CAAC,CAAC;IACjF,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,EAAE;QACZ,OAAO,EAAE,EAAE,CAAC,IAAI;QAChB,UAAU,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE;QAC/B,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,aAAa,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE;QACtC,WAAW,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;QAClC,eAAe,EAAE,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,EAAE,CAAC,QAAQ,EAAE,yBAAyB,IAAI,IAAI;QAC/F,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI;QACvC,IAAI;QACJ,mBAAmB,EAAE,QAAQ;KAC9B,CAAC;AACJ,CAAC;AA4BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,UAAkB,EAClB,WAAmB,EACnB,MAAe;IAEf,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAErD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,MAAM,CAAC,QAAQ;YAClC,YAAY,EAAE,UAAU;YACxB,oBAAoB,EAAE,MAAM,CAAC,WAAW;YACxC,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,UAAU;YACvC,eAAe,EAAE,MAAM,CAAC,mBAAmB;YAC3C,cAAc,EAAE,IAAI;YACpB,0BAA0B,EAAE,IAAI;SACjC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,iBAAiB,EAAE,MAAM,CAAC,QAAQ;YAClC,YAAY,EAAE,UAAU;YACxB,oBAAoB,EAAE,MAAM,CAAC,WAAW;YACxC,eAAe,EAAE,MAAM,CAAC,WAAW;YACnC,OAAO,EAAE,KAAK;YACd,eAAe,EAAE,MAAM,CAAC,mBAAmB;YAC3C,cAAc,EAAE,MAAM,CAAC,mBAAmB;YAC1C,0BAA0B,EAAE,KAAK;SAClC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,MAAM,IAAI,aAAa,MAAM,CAAC,WAAW,2BAA2B;YACpE,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,6BAA6B,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAC7B,OAAO,MAAM,CAAC,UAAU,cAAc,EACtC,WAAW,EACX;QACE,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;KAC9E,CACF,CAAC;IAEF,MAAM,SAAS,CAAmB,IAAI,EAAE,WAAW,EAAE;QACnD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,EAAE,wBAAwB,IAAI,IAAI,CAAC;IAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,EAAE,wBAAwB,IAAI,IAAI,CAAC;IAC5E,MAAM,wBAAwB,GAC5B,QAAQ,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,iBAAiB,EAAE,MAAM,CAAC,QAAQ;QAClC,YAAY,EAAE,KAAK,CAAC,QAAQ,IAAI,UAAU;QAC1C,oBAAoB,EAAE,MAAM,CAAC,WAAW;QACxC,eAAe,EAAE,KAAK,CAAC,WAAW;QAClC,OAAO,EAAE,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QACvF,eAAe,EAAE,MAAM,CAAC,mBAAmB;QAC3C,cAAc,EAAE,KAAK,CAAC,mBAAmB;QACzC,0BAA0B,EAAE,wBAAwB;KACrD,CAAC;AACJ,CAAC;AAgDD;;;;;GAKG;AACH,KAAK,UAAU,uBAAuB,CACpC,UAAkB,EAClB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CACtB,UAAU,EACV,WAAW,EACX,EAAE,MAAM,EAAE,4CAA4C,EAAE,CACzD,CAAC;QACF,OAAO,CAAC,CAAC,eAAe,EAAE,yBAAyB,IAAI,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AASD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,SAAiB,EACjB,WAAmB,EACnB,MAAe,EACf,eAAwB;IAExB,MAAM,MAAM,GACV,8BAA8B;QAC5B,6DAA6D;QAC7D,gGAAgG;QAChG,wIAAwI;QAC1I,GAAG,CAAC;IACN,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAgB,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAExE,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,yBAAyB,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,gCAAgC,CAAC,CAAC;IAEhF,MAAM,cAAc,GAClB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB;QAC9E,QAAQ,CAAC,eAAe,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB;QACvE,IAAI,CAAC;IAEP,MAAM,eAAe,GACnB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI;QAC3D,QAAQ,CAAC,eAAe,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI;QACpD,IAAI,CAAC;IACP,MAAM,OAAO,GAAG,eAAe,IAAI,eAAe,IAAI,SAAS,CAAC;IAEhE,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrG,MAAM,IAAI,GAA4C,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAE5G,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,EAAE,CAAC,EAAE;YACZ,OAAO,EAAE,EAAE,CAAC,IAAI;YAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;YACjC,eAAe,EAAE,EAAE;YACnB,gBAAgB,EAAE,cAAc;YAChC,WAAW,EAAE,SAAS;YACtB,IAAI;YACJ,OAAO,EAAE,cAAc,KAAK,SAAS;SACtC,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,EAAE,CAAC,EAAE;YACZ,OAAO,EAAE,EAAE,CAAC,IAAI;YAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;YACjC,eAAe,EAAE,QAAQ,CAAC,EAAE;YAC5B,gBAAgB,EAAE,cAAc;YAChC,WAAW,EAAE,SAAS;YACtB,IAAI;YACJ,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC;IACvF,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,CAAC;IACzE,MAAM,IAAI,GAA2B;QACnC,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;KACzF,CAAC;IACF,IAAI,QAAQ,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEzD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAgB,CAAC;QACtC,MAAM,OAAO,GAA4B;YACvC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC;YAC9C,oBAAoB,EAAE,CAAC,OAAO,CAAC;YAC/B,eAAe,EAAE,CAAC,MAAM,CAAC;SAC1B,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACpD,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM;YAAE,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;QACtE,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,EAAE,CAAC;YAC1C,OAAO,CAAC,yBAAyB,GAAG,GAAG,CAAC,yBAAyB,CAAC;QACpE,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QACvC,MAAM,MAAM,GAA4B,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAClE,IAAI,GAAG,EAAE,kBAAkB;YAAE,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;QAEhF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QACvC,MAAM,EAAE,GAAG,GAAG,EAAE,SAAS,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,MAAM,IAAI,aAAa,QAAQ,CAAC,EAAE,gFAAgF,CACnH,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAA4B;YACxC,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,cAAc,EAAE,MAAM;SACvB,CAAC;QACF,IAAI,EAAE,CAAC,UAAU;YAAE,QAAQ,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC;QACvD,IAAI,EAAE,CAAC,IAAI;YAAE,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;QACrC,IAAI,EAAE,CAAC,WAAW;YAAE,QAAQ,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC;QAE1D,MAAM,MAAM,GAA4B,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtF,IAAI,GAAG,CAAC,kBAAkB;YAAE,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;QAC/E,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAyB,GAAG,IAAI,cAAc,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAClG,MAAM,SAAS,CAAmB,IAAI,EAAE,WAAW,EAAE;QACnD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,EAAE;QACZ,OAAO,EAAE,EAAE,CAAC,IAAI;QAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;QACjC,eAAe,EAAE,OAAO,CAAC,EAAE;QAC3B,gBAAgB,EAAE,cAAc;QAChC,WAAW,EAAE,SAAS;QACtB,IAAI;QACJ,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAeD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,aAAqB,EACrB,WAAmB,EACnB,MAAe,EACf,QAAiB,KAAK;IAEtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,IAAI,EACJ,WAAW,EACX,EAAE,MAAM,EAAE,sBAAsB,EAAE,CACnC,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,MAAM,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,EAAE;YAChB,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,oBAAoB,EAAE,UAAU;YAChC,eAAe,EAAE,aAAa;YAC9B,OAAO,EAAE,UAAU,KAAK,aAAa,IAAI,CAAC,MAAM;YAChD,6BAA6B,EAAE,IAAI;SACpC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAmB,IAAI,CAAC;IACrC,IAAI,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC;YAChD,uBAAuB,CAAC,aAAa,EAAE,WAAW,CAAC;SACpD,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,uBAAuB,UAAU,QAAQ,QAAQ,CAAC,MAAM,GAAG;gBACxF,uFAAuF;gBACvF,YAAY,aAAa,6DAA6D;gBACtF,iFAAiF;gBACjF,kDAAkD,CACnD,CAAC;QACJ,CAAC;QACD,SAAS,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;IAChF,CAAC;IAED,MAAM,SAAS,CAAmB,IAAI,EAAE,WAAW,EAAE;QACnD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC,IAAI;QACpB,oBAAoB,EAAE,UAAU;QAChC,eAAe,EAAE,aAAa;QAC9B,OAAO,EAAE,IAAI;QACb,6BAA6B,EAAE,SAAS;KACzC,CAAC;AACJ,CAAC;AA4DD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,KAA4B,EAC5B,WAAmB,EACnB,MAAe,EACf,QAAiB,KAAK;IAEtB,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,gFAAgF;IAChF,iFAAiF;IACjF,yEAAyE;IAEzE,2EAA2E;IAC3E,6EAA6E;IAC7E,0CAA0C;IAC1C,MAAM,UAAU,GACd,8BAA8B;QAC5B,qCAAqC;QACrC,gGAAgG;QAChG,kBAAkB;QAChB,gEAAgE;QAChE,0EAA0E;QAC1E,uDAAuD;QACvD,wDAAwD;QAC1D,GAAG;QACL,GAAG,CAAC;IACN,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAgB,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClF,sEAAsE;IACtE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAgB,IAAI,EAAE,WAAW,EAAE;YAChE,MAAM,EAAE,4CAA4C;SACrD,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,CAAC;QACjE,IAAI,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACjD,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,eAAe,GAAG,IAAI,CAAC;QACrD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;IACD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;IAC7B,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,yBAAyB,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,gCAAgC,CAAC,CAAC;IAEhF,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrG,MAAM,IAAI,GAA4C,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC5G,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC;IACvF,MAAM,IAAI,GAA2B;QACnC,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;KACzF,CAAC;IACF,IAAI,QAAQ,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACzD,IAAI,QAAQ,CAAC,iBAAiB;QAAE,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAEpF,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAgB,CAAC;QACtC,UAAU,GAAG,GAAG,CAAC,yBAAyB,EAAE,MAAM,IAAI,CAAC,CAAC;QAExD,uFAAuF;QACvF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;gBACtF,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,mDAAmD;oBAC1F,mBAAmB,KAAK,CAAC,QAAQ,CAAC,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK;oBAChG,uEAAuE,CACxE,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;gBACzF,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,oDAAoD;oBAC5F,mBAAmB,KAAK,CAAC,SAAS,CAAC,MAAM,4BAA4B,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK;oBACjG,8BAA8B,CAC/B,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,IAAI,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;gBACpG,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,wCAAwC;oBACnF,qCAAqC,KAAK,CAAC,YAAY,CAAC,MAAM,0BAA0B;oBACxF,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,iCAAiC,CACnE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8EAA8E;QAC9E,MAAM,QAAQ,GAAG,CACf,QAAoE,EACpE,QAA8B,EAC9B,SAAiB,EACjB,EAAE;YACF,IAAI,CAAC,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC/B,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBAC9B,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,CAAC;gBAC9C,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;gBACpC,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM;oBAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC;gBAChE,OAAO,GAAG,CAAC;YACb,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,2EAA2E;QAC3E,yEAAyE;QACzE,0EAA0E;QAC1E,MAAM,YAAY,GAAG,CACnB,GAAoB,EACpB,KAAuB,EACN,EAAE;YACnB,IAAI,CAAC,GAAG,EAAE,MAAM;gBAAE,OAAO,GAAG,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuC,CAAC;YAC7D,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnB,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACtE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;wBACvB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;wBAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;4BAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;4BAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;wBAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAQ,CAAC;QAC3C,CAAC,CAAC;QAEF,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACxE,IAAI,aAAa,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC;QAC1D,IAAI,aAAa,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC;QAC1D,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM;YAAE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAC7D,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM;YAAE,OAAO,CAAC,oBAAoB,GAAG,GAAG,CAAC,oBAAoB,CAAC;QAC9F,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM;YAAE,OAAO,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;QAC/E,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM;YAAE,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAChE,IAAI,GAAG,CAAC,iBAAiB;YAAE,OAAO,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;QAE7E,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACrE,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACvF,IAAI,SAAS,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;QAClD,IAAI,SAAS,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;QAClD,IAAI,eAAe,EAAE,MAAM;YAAE,OAAO,CAAC,YAAY,GAAG,eAAe,CAAC;QACpE,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,EAAE,CAAC;YAC1C,OAAO,CAAC,yBAAyB,GAAG,GAAG,CAAC,yBAAyB,CAAC;QACpE,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QACvC,MAAM,MAAM,GAA4B,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAClE,IAAI,GAAG,EAAE,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAErD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,iEAAiE;QACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QACvC,MAAM,EAAE,GAAG,GAAG,EAAE,SAAS,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,aAAa,QAAQ,CAAC,EAAE,8CAA8C,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,QAAQ,GAA4B,EAAE,GAAG,EAAE,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,CAAC,MAA4B,EAAE,GAAuC,EAAE,KAAa,EAAE,EAAE;YACtG,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,gDAAgD,KAAK,GAAG;oBACpF,2BAA2B,MAAM,CAAC,MAAM,6CAA6C,CACtF,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC1B,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;QAE1D,MAAM,MAAM,GAA4B,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,KAAK,EAAE,EAAE,CAAC,EAAE;YACZ,OAAO,EAAE,EAAE,CAAC,IAAI;YAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;YACjC,eAAe,EAAE,QAAQ,CAAC,EAAE;YAC5B,IAAI;YACJ,cAAc,EAAE,EAAE;YAClB,6BAA6B,EAAE,UAAU;SAC1C,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,EAAE,CAAC,EAAE;YACZ,OAAO,EAAE,EAAE,CAAC,IAAI;YAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;YACjC,eAAe,EAAE,EAAE;YACnB,IAAI;YACJ,cAAc,EAAE,aAAa;YAC7B,6BAA6B,EAAE,UAAU;SAC1C,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAyB,GAAG,IAAI,cAAc,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAClG,0EAA0E;IAC1E,+EAA+E;IAC/E,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,EAAE;QACZ,OAAO,EAAE,EAAE,CAAC,IAAI;QAChB,oBAAoB,EAAE,QAAQ,CAAC,EAAE;QACjC,eAAe,EAAE,OAAO,CAAC,EAAE;QAC3B,IAAI;QACJ,cAAc,EAAE,aAAa;QAC7B,6BAA6B,EAAE,UAAU;KAC1C,CAAC;AACJ,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,OAAe,EACf,WAAmB,EACnB,MAAe;IAEf,MAAM,MAAM,GAAG,MAAM,QAAQ,CAA+B,IAAI,EAAE,WAAW,EAAE;QAC7E,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,EAAE;YAChB,aAAa,EAAE,MAAM,CAAC,IAAI;YAC1B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;SACnD,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,CAAmB,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAA+B,IAAI,EAAE,WAAW,EAAE;QAC5E,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,aAAa,EAAE,MAAM,CAAC,IAAI;QAC1B,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;KACpC,CAAC;AACJ,CAAC"}