agrs-sequelize-sdk 1.4.51 → 1.4.53

package/migrations/2026-05-17-PIXELS-FOLLOWUP.md

@@ -1,85 +1,85 @@
-# Platform column normalization — follow-on work
-
-## Tables skipped from the 2026-05-17 platform rollout
-
-The following 4 tables were intentionally OMITTED from the 2026-05-17 platform-column
-rollout because each already has a `platform` column of type VARCHAR with
-capitalized values (e.g. "Facebook"). Adding an ENUM column with the same name
-would either fail outright or destructively override existing data.
-
-| Table                          | Existing column type | Existing values seen                                   |
-|--------------------------------|----------------------|--------------------------------------------------------|
-| `Pixels`                       | varchar              | "Facebook", "Tiktok", "Taboola", "Outbrain", "Yahoo"   |
-| `CampaignCreationLogs`         | varchar(50)          | "Facebook", "fb", NULL                                 |
-| `CampaignCreationLogsV2`       | varchar(50)          | "Facebook", "fb", NULL                                 |
-| `rsoc_feed_campaigns`          | varchar              | "Facebook", "fb"                                       |
-
-The rest of the rollout uses lowercase short codes: `fb`, `tt`, `snp`.
-
-## Why we did not "just add another column"
-
-A naive `addColumn("platform")` collides with the existing column name. A naive
-`UPDATE` to lowercase the values would touch production data and is destructive.
-Both violate the safety constraint of this rollout (additive only).
-
-## Recommended path (separate plan)
-
-For each of the 4 tables:
-
-1. Add a new column `platform_code` ENUM('fb','tt','snp','tab','out','yh') NOT NULL DEFAULT 'fb'
-2. Backfill in a single transaction. Example for Pixels:
-   ```sql
-   UPDATE "Pixels" SET platform_code = CASE platform
-     WHEN 'Facebook' THEN 'fb'
-     WHEN 'Tiktok'   THEN 'tt'
-     WHEN 'Taboola'  THEN 'tab'
-     WHEN 'Outbrain' THEN 'out'
-     WHEN 'Yahoo'    THEN 'yh'
-     ELSE 'fb'
-   END;
-   ```
-   For CampaignCreationLogs / CampaignCreationLogsV2 / rsoc_feed_campaigns the
-   backfill is simpler:
-   ```sql
-   UPDATE "CampaignCreationLogs" SET platform_code = CASE LOWER(COALESCE(platform, 'fb'))
-     WHEN 'facebook' THEN 'fb'
-     WHEN 'fb'       THEN 'fb'
-     WHEN 'tiktok'   THEN 'tt'
-     WHEN 'tt'       THEN 'tt'
-     ELSE 'fb'
-   END;
-   ```
-3. Update server code to read `platform_code` for new logic; leave the legacy
-   `platform` column untouched for backward compat.
-4. Eventually deprecate the legacy `platform` column and rename `platform_code`
-   → `platform` once all callers have migrated. That happens in a separate,
-   later cleanup plan.
-
-## Until then
-
-The dashboard's platform adapter (created in the Phase 0 backend plan) MUST
-normalize legacy `platform` values when comparing to the canonical fb/tt/snp
-codes. Example normalizer:
-
-```javascript
-function normalizeLegacyPlatform(legacy) {
-  if (!legacy) return "fb";
-  const map = {
-    Facebook: "fb",
-    facebook: "fb",
-    FB: "fb",
-    fb: "fb",
-    Tiktok: "tt",
-    TikTok: "tt",
-    tiktok: "tt",
-    tt: "tt",
-    Snapchat: "snp",
-    snapchat: "snp",
-    snp: "snp",
-    Taboola: "tab",
-    Outbrain: "out",
-    Yahoo: "yh",
-  };
-  return map[legacy] || "fb";
-}
-```
+# Platform column normalization — follow-on work
+
+## Tables skipped from the 2026-05-17 platform rollout
+
+The following 4 tables were intentionally OMITTED from the 2026-05-17 platform-column
+rollout because each already has a `platform` column of type VARCHAR with
+capitalized values (e.g. "Facebook"). Adding an ENUM column with the same name
+would either fail outright or destructively override existing data.
+
+| Table                          | Existing column type | Existing values seen                                   |
+|--------------------------------|----------------------|--------------------------------------------------------|
+| `Pixels`                       | varchar              | "Facebook", "Tiktok", "Taboola", "Outbrain", "Yahoo"   |
+| `CampaignCreationLogs`         | varchar(50)          | "Facebook", "fb", NULL                                 |
+| `CampaignCreationLogsV2`       | varchar(50)          | "Facebook", "fb", NULL                                 |
+| `rsoc_feed_campaigns`          | varchar              | "Facebook", "fb"                                       |
+
+The rest of the rollout uses lowercase short codes: `fb`, `tt`, `snp`.
+
+## Why we did not "just add another column"
+
+A naive `addColumn("platform")` collides with the existing column name. A naive
+`UPDATE` to lowercase the values would touch production data and is destructive.
+Both violate the safety constraint of this rollout (additive only).
+
+## Recommended path (separate plan)
+
+For each of the 4 tables:
+
+1. Add a new column `platform_code` ENUM('fb','tt','snp','tab','out','yh') NOT NULL DEFAULT 'fb'
+2. Backfill in a single transaction. Example for Pixels:
+   ```sql
+   UPDATE "Pixels" SET platform_code = CASE platform
+     WHEN 'Facebook' THEN 'fb'
+     WHEN 'Tiktok'   THEN 'tt'
+     WHEN 'Taboola'  THEN 'tab'
+     WHEN 'Outbrain' THEN 'out'
+     WHEN 'Yahoo'    THEN 'yh'
+     ELSE 'fb'
+   END;
+   ```
+   For CampaignCreationLogs / CampaignCreationLogsV2 / rsoc_feed_campaigns the
+   backfill is simpler:
+   ```sql
+   UPDATE "CampaignCreationLogs" SET platform_code = CASE LOWER(COALESCE(platform, 'fb'))
+     WHEN 'facebook' THEN 'fb'
+     WHEN 'fb'       THEN 'fb'
+     WHEN 'tiktok'   THEN 'tt'
+     WHEN 'tt'       THEN 'tt'
+     ELSE 'fb'
+   END;
+   ```
+3. Update server code to read `platform_code` for new logic; leave the legacy
+   `platform` column untouched for backward compat.
+4. Eventually deprecate the legacy `platform` column and rename `platform_code`
+   → `platform` once all callers have migrated. That happens in a separate,
+   later cleanup plan.
+
+## Until then
+
+The dashboard's platform adapter (created in the Phase 0 backend plan) MUST
+normalize legacy `platform` values when comparing to the canonical fb/tt/snp
+codes. Example normalizer:
+
+```javascript
+function normalizeLegacyPlatform(legacy) {
+  if (!legacy) return "fb";
+  const map = {
+    Facebook: "fb",
+    facebook: "fb",
+    FB: "fb",
+    fb: "fb",
+    Tiktok: "tt",
+    TikTok: "tt",
+    tiktok: "tt",
+    tt: "tt",
+    Snapchat: "snp",
+    snapchat: "snp",
+    snp: "snp",
+    Taboola: "tab",
+    Outbrain: "out",
+    Yahoo: "yh",
+  };
+  return map[legacy] || "fb";
+}
+```

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("Ad", "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("Ad", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_Ad_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("Ad", "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("Ad", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_Ad_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("AdAccount", "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("AdAccount", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_AdAccount_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("AdAccount", "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("AdAccount", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_AdAccount_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("AdPerformance", "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("AdPerformance", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_AdPerformance_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("AdPerformance", "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("AdPerformance", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_AdPerformance_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("AdSet", "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("AdSet", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_AdSet_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("AdSet", "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("AdSet", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_AdSet_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("AdSetPerformance", "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("AdSetPerformance", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_AdSetPerformance_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("AdSetPerformance", "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("AdSetPerformance", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_AdSetPerformance_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("ai_article_retry_queue", "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("ai_article_retry_queue", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_ai_article_retry_queue_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("ai_article_retry_queue", "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("ai_article_retry_queue", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_ai_article_retry_queue_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("ai_campaign_queue", "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("ai_campaign_queue", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_ai_campaign_queue_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("ai_campaign_queue", "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("ai_campaign_queue", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_ai_campaign_queue_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("articles", "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("articles", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_articles_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("articles", "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("articles", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_articles_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("Campaign", "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("Campaign", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_Campaign_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("Campaign", "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("Campaign", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_Campaign_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("CodefuelCampaigns", "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("CodefuelCampaigns", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_CodefuelCampaigns_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("CodefuelCampaigns", "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("CodefuelCampaigns", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_CodefuelCampaigns_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("dynamic_feeds", "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("dynamic_feeds", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_dynamic_feeds_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("dynamic_feeds", "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("dynamic_feeds", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_dynamic_feeds_platform";'
+    );
+  },
+};

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

@@ -1,19 +1,19 @@
-"use strict";
-
-module.exports = {
-  up: async (queryInterface, Sequelize) => {
-    await queryInterface.addColumn("facebook_retry_queue", "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("facebook_retry_queue", "platform");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_facebook_retry_queue_platform";'
-    );
-  },
-};
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.addColumn("facebook_retry_queue", "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("facebook_retry_queue", "platform");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_facebook_retry_queue_platform";'
+    );
+  },
+};