agrs-sequelize-sdk 1.4.19 → 1.4.22

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

@@ -0,0 +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");
+  },
+};

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

@@ -0,0 +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";`
+      );
+    }
+  },
+};

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

@@ -0,0 +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";'
+    );
+  },
+};

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

@@ -0,0 +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";'
+    );
+  },
+};

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

@@ -0,0 +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"
+    );
+  },
+};

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

@@ -0,0 +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"
+    );
+  },
+};

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

@@ -0,0 +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");
+  },
+};

package/migrations/2026-05-18-create-canonical-insights.js

@@ -0,0 +1,84 @@
+"use strict";
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.createTable("canonical_insights", {
+      id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      platform: {
+        type: Sequelize.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      },
+      entity_type: {
+        type: Sequelize.ENUM("campaign", "adset", "ad"),
+        allowNull: false,
+      },
+      entity_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      date: {
+        type: Sequelize.DATEONLY,
+        allowNull: false,
+      },
+      impressions: {
+        type: Sequelize.BIGINT,
+        defaultValue: 0,
+      },
+      clicks: {
+        type: Sequelize.BIGINT,
+        defaultValue: 0,
+      },
+      spend: {
+        type: Sequelize.DECIMAL(14, 4),
+        defaultValue: 0,
+      },
+      conversions: {
+        type: Sequelize.BIGINT,
+        defaultValue: 0,
+      },
+      revenue: {
+        type: Sequelize.DECIMAL(14, 4),
+        defaultValue: 0,
+      },
+      raw_payload: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex(
+      "canonical_insights",
+      ["platform", "entity_type", "entity_id", "date"],
+      {
+        unique: true,
+        name: "canonical_insights_unique_per_entity_date",
+      }
+    );
+
+    await queryInterface.addIndex("canonical_insights", ["platform", "date"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.dropTable("canonical_insights");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_canonical_insights_platform";'
+    );
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_canonical_insights_entity_type";'
+    );
+  },
+};

package/migrations/2026-05-18-create-snapchat-public-profiles.js

@@ -0,0 +1,68 @@
+"use strict";
+
+/**
+ * Creates the `snapchat_public_profiles` rotation pool used by
+ * `assetResolver.getDefaultAssetForPlatform({ platform: 'snp' })`.
+ *
+ * Additive-only: no foreign keys, no touching of existing tables.
+ * Safe to apply on production. Pre-seed environments fall back to the
+ * `SNAPCHAT_DEFAULT_PUBLIC_PROFILE_ID` env var until rows exist.
+ */
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.createTable("snapchat_public_profiles", {
+      id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      public_profile_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+        unique: true,
+      },
+      name: {
+        type: Sequelize.STRING(255),
+        allowNull: true,
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.STRING(16),
+        allowNull: false,
+        defaultValue: "active",
+      },
+      tier: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 1,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.literal("CURRENT_TIMESTAMP"),
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.literal("CURRENT_TIMESTAMP"),
+      },
+    });
+
+    await queryInterface.addIndex(
+      "snapchat_public_profiles",
+      ["ad_account_id", "status"],
+      { name: "snapchat_public_profiles_ad_account_status_idx" }
+    );
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex(
+      "snapchat_public_profiles",
+      "snapchat_public_profiles_ad_account_status_idx"
+    );
+    await queryInterface.dropTable("snapchat_public_profiles");
+  },
+};

package/migrations/2026-05-18-create-tiktok-identities.js

@@ -0,0 +1,71 @@
+"use strict";
+
+/**
+ * Creates the `tiktok_identities` rotation pool used by
+ * `assetResolver.getDefaultAssetForPlatform({ platform: 'tt' })`.
+ *
+ * Additive-only: no foreign keys, no touching of existing tables.
+ * Safe to apply on production. Pre-seed environments fall back to the
+ * `TIKTOK_DEFAULT_IDENTITY_ID` env var until rows exist.
+ */
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    await queryInterface.createTable("tiktok_identities", {
+      id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      identity_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+        unique: true,
+      },
+      identity_type: {
+        type: Sequelize.STRING(32),
+        allowNull: false,
+        defaultValue: "CUSTOMIZED_USER",
+      },
+      name: {
+        type: Sequelize.STRING(255),
+        allowNull: true,
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.STRING(16),
+        allowNull: false,
+        defaultValue: "active",
+      },
+      tier: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 1,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.literal("CURRENT_TIMESTAMP"),
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.literal("CURRENT_TIMESTAMP"),
+      },
+    });
+
+    await queryInterface.addIndex("tiktok_identities", ["ad_account_id", "status"], {
+      name: "tiktok_identities_ad_account_status_idx",
+    });
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.removeIndex(
+      "tiktok_identities",
+      "tiktok_identities_ad_account_status_idx"
+    );
+    await queryInterface.dropTable("tiktok_identities");
+  },
+};

package/migrations/2026-05-18-create-tiktok-snapchat-campaigns.js

@@ -0,0 +1,143 @@
+"use strict";
+
+// Additive migration — creates two new tables to mirror TikTok and Snapchat
+// campaign state in the local DB. No FKs to existing tables; loose coupling
+// keeps platform isolation. Reporting joins to canonical_insights at the MV
+// layer (see dashboard migration 003-multi-platform-performance-view.sql).
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    // ----- TikTok Campaigns -----
+    await queryInterface.createTable("tiktok_campaigns", {
+      campaign_id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        allowNull: false,
+      },
+      campaign_name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      objective_type: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      budget_mode: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "BUDGET_MODE_DAY or BUDGET_MODE_LIFETIME (TikTok native)",
+      },
+      daily_budget_usd: {
+        type: Sequelize.DECIMAL(12, 6),
+        allowNull: true,
+        comment: "Normalized USD value (TikTok returns native USD float)",
+      },
+      operation_status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "ENABLE or DISABLE (TikTok native)",
+      },
+      special_industries: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+        comment: "JSON-serialized array of special industry tags",
+      },
+      schedule_start_time: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      schedule_end_time: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      synced_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("tiktok_campaigns", ["ad_account_id"]);
+    await queryInterface.addIndex("tiktok_campaigns", ["created_at"]);
+    await queryInterface.addIndex("tiktok_campaigns", ["operation_status"]);
+
+    // ----- Snapchat Campaigns -----
+    await queryInterface.createTable("snapchat_campaigns", {
+      id: {
+        type: Sequelize.STRING(36),
+        primaryKey: true,
+        allowNull: false,
+        comment: "Snapchat UUID",
+      },
+      name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.STRING(50),
+        allowNull: false,
+        comment: "ACTIVE or PAUSED (Snap native)",
+      },
+      objective: {
+        type: Sequelize.STRING(255),
+        allowNull: true,
+      },
+      daily_budget_micro: {
+        type: Sequelize.BIGINT,
+        allowNull: true,
+      },
+      lifetime_spend_cap_micro: {
+        type: Sequelize.BIGINT,
+        allowNull: true,
+      },
+      timezone: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      start_time: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      end_time: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      synced_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    await queryInterface.addIndex("snapchat_campaigns", ["ad_account_id"]);
+    await queryInterface.addIndex("snapchat_campaigns", ["created_at"]);
+    await queryInterface.addIndex("snapchat_campaigns", ["status"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.dropTable("snapchat_campaigns");
+    await queryInterface.dropTable("tiktok_campaigns");
+  },
+};