agrs-sequelize-sdk 1.4.56 → 1.4.57

package/migrations/2026-05-17-add-platform-to-pages.js

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("Pages", "platform", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: false,
-      defaultValue: "fb",
-      comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-  },
-
-  down: async (queryInterface, Sequelize) => {
-    await queryInterface.removeColumn("Pages", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_Pages_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("Pages", "platform", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: false,
+      defaultValue: "fb",
+      comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+  },
+
+  down: async (queryInterface, Sequelize) => {
+    await queryInterface.removeColumn("Pages", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_Pages_platform";'
+    );
+  },
+};

package/migrations/2026-05-17-add-platform-to-presets.js

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("Presets", "platform", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: false,
-      defaultValue: "fb",
-      comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-  },
-
-  down: async (queryInterface, Sequelize) => {
-    await queryInterface.removeColumn("Presets", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_Presets_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("Presets", "platform", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: false,
+      defaultValue: "fb",
+      comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+  },
+
+  down: async (queryInterface, Sequelize) => {
+    await queryInterface.removeColumn("Presets", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_Presets_platform";'
+    );
+  },
+};

package/migrations/2026-05-18-add-group-id-to-ai-campaign-queue.js

@@ -1,18 +1,18 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("ai_campaign_queue", "group_id", {
-      type: Sequelize.UUID,
-      allowNull: true,
-      comment:
-        "Groups rows created by a single multi-platform fanout request",
-    });
-    await queryInterface.addIndex("ai_campaign_queue", ["group_id"]);
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeIndex("ai_campaign_queue", ["group_id"]);
-    await queryInterface.removeColumn("ai_campaign_queue", "group_id");
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("ai_campaign_queue", "group_id", {
+      type: Sequelize.UUID,
+      allowNull: true,
+      comment:
+        "Groups rows created by a single multi-platform fanout request",
+    });
+    await queryInterface.addIndex("ai_campaign_queue", ["group_id"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex("ai_campaign_queue", ["group_id"]);
+    await queryInterface.removeColumn("ai_campaign_queue", "group_id");
+  },
+};

package/migrations/2026-05-18-add-platform-code-to-creation-logs.js

@@ -1,65 +1,65 @@
-"use strict";
-
-/**
- * CampaignCreationLogs + CampaignCreationLogsV2 normalization (Phase 1):
- *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
- *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
- *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
- *
- * Mapping (case-insensitive on legacy `platform`):
- *   facebook | fb              -> fb
- *   tiktok   | tt              -> tt
- *   snapchat | snap | snp      -> snp
- *   else                        -> fb (safe default)
- */
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    const tables = ["CampaignCreationLogs", "CampaignCreationLogsV2"];
-
-    for (const table of tables) {
-      // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
-      await queryInterface.addColumn(table, "platform_code", {
-        type: Sequelize.ENUM("fb", "tt", "snp"),
-        allowNull: true,
-        comment:
-          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-      });
-
-      // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
-      await queryInterface.sequelize.query(`
-        UPDATE "${table}"
-        SET platform_code = CASE
-          WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_${table}_platform_code"
-          WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_${table}_platform_code"
-          WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_${table}_platform_code"
-          ELSE 'fb'::"enum_${table}_platform_code"
-        END
-        WHERE platform_code IS NULL;
-      `);
-
-      // 3. Enforce NOT NULL + default now that every row has a value.
-      await queryInterface.changeColumn(table, "platform_code", {
-        type: Sequelize.ENUM("fb", "tt", "snp"),
-        allowNull: false,
-        defaultValue: "fb",
-        comment:
-          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-      });
-
-      // 4. Index for filter performance.
-      await queryInterface.addIndex(table, ["platform_code"]);
-    }
-  },
-
-  down: async (queryInterface) => {
-    const tables = ["CampaignCreationLogs", "CampaignCreationLogsV2"];
-
-    for (const table of tables) {
-      await queryInterface.removeIndex(table, ["platform_code"]);
-      await queryInterface.removeColumn(table, "platform_code");
-      await queryInterface.sequelize.query(
-        `DROP TYPE IF EXISTS "enum_${table}_platform_code";`
-      );
-    }
-  },
-};
+"use strict";
+
+/**
+ * CampaignCreationLogs + CampaignCreationLogsV2 normalization (Phase 1):
+ *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
+ *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
+ *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
+ *
+ * Mapping (case-insensitive on legacy `platform`):
+ *   facebook | fb              -> fb
+ *   tiktok   | tt              -> tt
+ *   snapchat | snap | snp      -> snp
+ *   else                        -> fb (safe default)
+ */
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    const tables = ["CampaignCreationLogs", "CampaignCreationLogsV2"];
+
+    for (const table of tables) {
+      // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
+      await queryInterface.addColumn(table, "platform_code", {
+        type: Sequelize.ENUM("fb", "tt", "snp"),
+        allowNull: true,
+        comment:
+          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      });
+
+      // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
+      await queryInterface.sequelize.query(`
+        UPDATE "${table}"
+        SET platform_code = CASE
+          WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_${table}_platform_code"
+          WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_${table}_platform_code"
+          WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_${table}_platform_code"
+          ELSE 'fb'::"enum_${table}_platform_code"
+        END
+        WHERE platform_code IS NULL;
+      `);
+
+      // 3. Enforce NOT NULL + default now that every row has a value.
+      await queryInterface.changeColumn(table, "platform_code", {
+        type: Sequelize.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        defaultValue: "fb",
+        comment:
+          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      });
+
+      // 4. Index for filter performance.
+      await queryInterface.addIndex(table, ["platform_code"]);
+    }
+  },
+
+  down: async (queryInterface) => {
+    const tables = ["CampaignCreationLogs", "CampaignCreationLogsV2"];
+
+    for (const table of tables) {
+      await queryInterface.removeIndex(table, ["platform_code"]);
+      await queryInterface.removeColumn(table, "platform_code");
+      await queryInterface.sequelize.query(
+        `DROP TYPE IF EXISTS "enum_${table}_platform_code";`
+      );
+    }
+  },
+};

package/migrations/2026-05-18-add-platform-code-to-pixels.js

@@ -1,55 +1,55 @@
-"use strict";
-
-/**
- * Pixels normalization (Phase 1):
- *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
- *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
- *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
- *
- * Mapping (case-insensitive on legacy `platform`):
- *   facebook | fb              -> fb
- *   tiktok   | tt              -> tt
- *   snapchat | snap | snp      -> snp
- *   else                        -> fb (safe default)
- */
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
-    await queryInterface.addColumn("Pixels", "platform_code", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: true,
-      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-
-    // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
-    await queryInterface.sequelize.query(`
-      UPDATE "Pixels"
-      SET platform_code = CASE
-        WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_Pixels_platform_code"
-        WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_Pixels_platform_code"
-        WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_Pixels_platform_code"
-        ELSE 'fb'::"enum_Pixels_platform_code"
-      END
-      WHERE platform_code IS NULL;
-    `);
-
-    // 3. Enforce NOT NULL + default now that every row has a value.
-    await queryInterface.changeColumn("Pixels", "platform_code", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: false,
-      defaultValue: "fb",
-      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-
-    // 4. Index for filter performance.
-    await queryInterface.addIndex("Pixels", ["platform_code"]);
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeIndex("Pixels", ["platform_code"]);
-    await queryInterface.removeColumn("Pixels", "platform_code");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_Pixels_platform_code";'
-    );
-  },
-};
+"use strict";
+
+/**
+ * Pixels normalization (Phase 1):
+ *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
+ *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
+ *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
+ *
+ * Mapping (case-insensitive on legacy `platform`):
+ *   facebook | fb              -> fb
+ *   tiktok   | tt              -> tt
+ *   snapchat | snap | snp      -> snp
+ *   else                        -> fb (safe default)
+ */
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
+    await queryInterface.addColumn("Pixels", "platform_code", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: true,
+      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+
+    // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
+    await queryInterface.sequelize.query(`
+      UPDATE "Pixels"
+      SET platform_code = CASE
+        WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_Pixels_platform_code"
+        WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_Pixels_platform_code"
+        WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_Pixels_platform_code"
+        ELSE 'fb'::"enum_Pixels_platform_code"
+      END
+      WHERE platform_code IS NULL;
+    `);
+
+    // 3. Enforce NOT NULL + default now that every row has a value.
+    await queryInterface.changeColumn("Pixels", "platform_code", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: false,
+      defaultValue: "fb",
+      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+
+    // 4. Index for filter performance.
+    await queryInterface.addIndex("Pixels", ["platform_code"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex("Pixels", ["platform_code"]);
+    await queryInterface.removeColumn("Pixels", "platform_code");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_Pixels_platform_code";'
+    );
+  },
+};

package/migrations/2026-05-18-add-platform-code-to-rsoc-feed-campaigns.js

@@ -1,55 +1,55 @@
-"use strict";
-
-/**
- * rsoc_feed_campaigns normalization (Phase 1):
- *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
- *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
- *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
- *
- * Mapping (case-insensitive on legacy `platform`):
- *   facebook | fb              -> fb
- *   tiktok   | tt              -> tt
- *   snapchat | snap | snp      -> snp
- *   else                        -> fb (safe default)
- */
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
-    await queryInterface.addColumn("rsoc_feed_campaigns", "platform_code", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: true,
-      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-
-    // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
-    await queryInterface.sequelize.query(`
-      UPDATE "rsoc_feed_campaigns"
-      SET platform_code = CASE
-        WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_rsoc_feed_campaigns_platform_code"
-        WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_rsoc_feed_campaigns_platform_code"
-        WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_rsoc_feed_campaigns_platform_code"
-        ELSE 'fb'::"enum_rsoc_feed_campaigns_platform_code"
-      END
-      WHERE platform_code IS NULL;
-    `);
-
-    // 3. Enforce NOT NULL + default now that every row has a value.
-    await queryInterface.changeColumn("rsoc_feed_campaigns", "platform_code", {
-      type: Sequelize.ENUM("fb", "tt", "snp"),
-      allowNull: false,
-      defaultValue: "fb",
-      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
-    });
-
-    // 4. Index for filter performance.
-    await queryInterface.addIndex("rsoc_feed_campaigns", ["platform_code"]);
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeIndex("rsoc_feed_campaigns", ["platform_code"]);
-    await queryInterface.removeColumn("rsoc_feed_campaigns", "platform_code");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_rsoc_feed_campaigns_platform_code";'
-    );
-  },
-};
+"use strict";
+
+/**
+ * rsoc_feed_campaigns normalization (Phase 1):
+ *   - Add canonical `platform_code` ENUM column ('fb' | 'tt' | 'snp').
+ *   - Backfill from legacy VARCHAR `platform` column using case-insensitive mapping.
+ *   - Keep legacy `platform` column untouched (dropped in a follow-up plan).
+ *
+ * Mapping (case-insensitive on legacy `platform`):
+ *   facebook | fb              -> fb
+ *   tiktok   | tt              -> tt
+ *   snapchat | snap | snp      -> snp
+ *   else                        -> fb (safe default)
+ */
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    // 1. Add the new column as nullable so we can backfill before enforcing NOT NULL.
+    await queryInterface.addColumn("rsoc_feed_campaigns", "platform_code", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: true,
+      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+
+    // 2. Backfill from legacy `platform` column (idempotent on platform_code IS NULL).
+    await queryInterface.sequelize.query(`
+      UPDATE "rsoc_feed_campaigns"
+      SET platform_code = CASE
+        WHEN LOWER(platform) IN ('facebook', 'fb') THEN 'fb'::"enum_rsoc_feed_campaigns_platform_code"
+        WHEN LOWER(platform) IN ('tiktok', 'tt') THEN 'tt'::"enum_rsoc_feed_campaigns_platform_code"
+        WHEN LOWER(platform) IN ('snapchat', 'snap', 'snp') THEN 'snp'::"enum_rsoc_feed_campaigns_platform_code"
+        ELSE 'fb'::"enum_rsoc_feed_campaigns_platform_code"
+      END
+      WHERE platform_code IS NULL;
+    `);
+
+    // 3. Enforce NOT NULL + default now that every row has a value.
+    await queryInterface.changeColumn("rsoc_feed_campaigns", "platform_code", {
+      type: Sequelize.ENUM("fb", "tt", "snp"),
+      allowNull: false,
+      defaultValue: "fb",
+      comment: "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+    });
+
+    // 4. Index for filter performance.
+    await queryInterface.addIndex("rsoc_feed_campaigns", ["platform_code"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex("rsoc_feed_campaigns", ["platform_code"]);
+    await queryInterface.removeColumn("rsoc_feed_campaigns", "platform_code");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_rsoc_feed_campaigns_platform_code";'
+    );
+  },
+};

package/migrations/2026-05-18-add-platform-date-index-to-adperformance.js

@@ -1,16 +1,16 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface) => {
-    await queryInterface.addIndex("AdPerformance", ["platform", "Date"], {
-      name: "AdPerformance_platform_Date_idx",
-    });
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeIndex(
-      "AdPerformance",
-      "AdPerformance_platform_Date_idx"
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface) => {
+    await queryInterface.addIndex("AdPerformance", ["platform", "Date"], {
+      name: "AdPerformance_platform_Date_idx",
+    });
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex(
+      "AdPerformance",
+      "AdPerformance_platform_Date_idx"
+    );
+  },
+};

package/migrations/2026-05-18-add-platform-date-index-to-adsetperformance.js

@@ -1,16 +1,16 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface) => {
-    await queryInterface.addIndex("AdSetPerformance", ["platform", "Date"], {
-      name: "AdSetPerformance_platform_Date_idx",
-    });
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeIndex(
-      "AdSetPerformance",
-      "AdSetPerformance_platform_Date_idx"
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface) => {
+    await queryInterface.addIndex("AdSetPerformance", ["platform", "Date"], {
+      name: "AdSetPerformance_platform_Date_idx",
+    });
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex(
+      "AdSetPerformance",
+      "AdSetPerformance_platform_Date_idx"
+    );
+  },
+};

package/migrations/2026-05-18-add-review-status-to-ad.js

@@ -1,36 +1,36 @@
-"use strict";
-
-/**
- * Additive migration: add review_status + pending_review_since to Ad.
- *
- * Used by SnapchatStrategy.updateAd to optimistically flip an ad to
- * PENDING_REVIEW immediately after editing copy/URL fields (brand_name,
- * headline, url, landing_page_url) — Snapchat resends those ads to review
- * upstream, and we want the UI to reflect that without waiting for the
- * next status sync cycle.
- *
- * Backward compatible — both columns nullable, no default value, no
- * destructive operations.
- */
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("Ad", "review_status", {
-      type: Sequelize.STRING,
-      allowNull: true,
-      comment:
-        "Local review status mirror (e.g. PENDING_REVIEW after copy/URL edit on Snap). Cleared by status sync.",
-    });
-    await queryInterface.addColumn("Ad", "pending_review_since", {
-      type: Sequelize.DATE,
-      allowNull: true,
-      comment:
-        "Timestamp when ad was optimistically flipped to PENDING_REVIEW after a triggering edit. Cleared when upstream review settles.",
-    });
-  },
-
-  down: async (queryInterface) => {
-    await queryInterface.removeColumn("Ad", "pending_review_since");
-    await queryInterface.removeColumn("Ad", "review_status");
-  },
-};
+"use strict";
+
+/**
+ * Additive migration: add review_status + pending_review_since to Ad.
+ *
+ * Used by SnapchatStrategy.updateAd to optimistically flip an ad to
+ * PENDING_REVIEW immediately after editing copy/URL fields (brand_name,
+ * headline, url, landing_page_url) — Snapchat resends those ads to review
+ * upstream, and we want the UI to reflect that without waiting for the
+ * next status sync cycle.
+ *
+ * Backward compatible — both columns nullable, no default value, no
+ * destructive operations.
+ */
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("Ad", "review_status", {
+      type: Sequelize.STRING,
+      allowNull: true,
+      comment:
+        "Local review status mirror (e.g. PENDING_REVIEW after copy/URL edit on Snap). Cleared by status sync.",
+    });
+    await queryInterface.addColumn("Ad", "pending_review_since", {
+      type: Sequelize.DATE,
+      allowNull: true,
+      comment:
+        "Timestamp when ad was optimistically flipped to PENDING_REVIEW after a triggering edit. Cleared when upstream review settles.",
+    });
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeColumn("Ad", "pending_review_since");
+    await queryInterface.removeColumn("Ad", "review_status");
+  },
+};