agrs-sequelize-sdk 1.4.19 → 1.4.21

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

package/migrations/2026-05-18-create-tt-snp-adset-ad-tables.js

@@ -0,0 +1,309 @@
+"use strict";
+
+// Additive migration — creates four new tables to mirror TikTok ad groups/ads
+// and Snapchat ad squads/ads 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 004-multi-platform-ad-level.sql).
+
+module.exports = {
+  up: async (queryInterface, Sequelize) => {
+    // ----- TikTok Ad Groups -----
+    await queryInterface.createTable("tiktok_adgroups", {
+      adgroup_id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        allowNull: false,
+      },
+      adgroup_name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      campaign_id: {
+        type: Sequelize.BIGINT,
+        allowNull: false,
+        comment:
+          "TikTok campaign_id; loose FK to tiktok_campaigns (no DB-level constraint)",
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      placement_type: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "PLACEMENT_TYPE_AUTOMATIC / PLACEMENT_TYPE_NORMAL",
+      },
+      budget_mode: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      budget: {
+        type: Sequelize.DECIMAL(12, 6),
+        allowNull: true,
+      },
+      bid_type: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      bid_price: {
+        type: Sequelize.DECIMAL(12, 6),
+        allowNull: true,
+      },
+      optimize_goal: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      operation_status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "ENABLE or DISABLE (TikTok native)",
+      },
+      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_adgroups", ["campaign_id"]);
+    await queryInterface.addIndex("tiktok_adgroups", ["ad_account_id"]);
+    await queryInterface.addIndex("tiktok_adgroups", ["operation_status"]);
+
+    // ----- TikTok Ads -----
+    await queryInterface.createTable("tiktok_ads", {
+      ad_id: {
+        type: Sequelize.BIGINT,
+        primaryKey: true,
+        allowNull: false,
+      },
+      ad_name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      adgroup_id: {
+        type: Sequelize.BIGINT,
+        allowNull: false,
+        comment:
+          "TikTok adgroup_id; loose FK to tiktok_adgroups (no DB-level constraint)",
+      },
+      campaign_id: {
+        type: Sequelize.BIGINT,
+        allowNull: false,
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(64),
+        allowNull: false,
+      },
+      ad_format: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "SINGLE_VIDEO, SINGLE_IMAGE, etc.",
+      },
+      identity_id: {
+        type: Sequelize.STRING(64),
+        allowNull: true,
+        comment: "TikTok identity (Page equivalent)",
+      },
+      landing_page_url: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+      },
+      display_name: {
+        type: Sequelize.STRING(255),
+        allowNull: true,
+      },
+      operation_status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "ENABLE or DISABLE (TikTok native)",
+      },
+      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_ads", ["adgroup_id"]);
+    await queryInterface.addIndex("tiktok_ads", ["campaign_id"]);
+    await queryInterface.addIndex("tiktok_ads", ["operation_status"]);
+
+    // ----- Snapchat Ad Squads -----
+    await queryInterface.createTable("snapchat_ad_squads", {
+      id: {
+        type: Sequelize.STRING(36),
+        primaryKey: true,
+        allowNull: false,
+        comment: "Snapchat ad squad UUID",
+      },
+      name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      campaign_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+        comment: "Snapchat campaign UUID; loose FK to snapchat_campaigns",
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "ACTIVE or PAUSED (Snap native)",
+      },
+      type: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "SNAP_ADS",
+      },
+      bid_strategy: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      optimization_goal: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      billing_event: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+      },
+      placement_v2: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+        comment: "Snap placement_v2 config (e.g. {config:'AUTOMATIC', ...})",
+      },
+      daily_budget_micro: {
+        type: Sequelize.BIGINT,
+        allowNull: true,
+      },
+      bid_micro: {
+        type: Sequelize.BIGINT,
+        allowNull: true,
+      },
+      targeting: {
+        type: Sequelize.JSONB,
+        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_ad_squads", ["campaign_id"]);
+    await queryInterface.addIndex("snapchat_ad_squads", ["ad_account_id"]);
+    await queryInterface.addIndex("snapchat_ad_squads", ["status"]);
+
+    // ----- Snapchat Ads -----
+    await queryInterface.createTable("snapchat_ads", {
+      id: {
+        type: Sequelize.STRING(36),
+        primaryKey: true,
+        allowNull: false,
+        comment: "Snapchat ad UUID",
+      },
+      name: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      ad_squad_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+        comment: "Snapchat ad squad UUID; loose FK to snapchat_ad_squads",
+      },
+      ad_account_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+      },
+      creative_id: {
+        type: Sequelize.STRING(36),
+        allowNull: false,
+      },
+      status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "ACTIVE or PAUSED (Snap native)",
+      },
+      type: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "SNAP_AD",
+      },
+      review_status: {
+        type: Sequelize.STRING(50),
+        allowNull: true,
+        comment: "Mirrors Plan Q Ad.review_status (e.g. PENDING_REVIEW, APPROVED)",
+      },
+      pending_review_since: {
+        type: Sequelize.DATE,
+        allowNull: true,
+        comment: "Timestamp when ad first entered pending review (Plan Q)",
+      },
+      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_ads", ["ad_squad_id"]);
+    await queryInterface.addIndex("snapchat_ads", ["ad_account_id"]);
+    await queryInterface.addIndex("snapchat_ads", ["status"]);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.dropTable("snapchat_ads");
+    await queryInterface.dropTable("snapchat_ad_squads");
+    await queryInterface.dropTable("tiktok_ads");
+    await queryInterface.dropTable("tiktok_adgroups");
+  },
+};

package/models/AICampaignQueue.js

@@ -98,6 +98,12 @@ module.exports = (sequelize, DataTypes) => {
           field: "platform",
           comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
         },
+        group_id: {
+          type: DataTypes.UUID,
+          allowNull: true,
+          field: "group_id",
+          comment: "Groups rows created by a single multi-platform fanout request",
+        },
       },
       {
         tableName: "ai_campaign_queue",
@@ -127,6 +133,9 @@ module.exports = (sequelize, DataTypes) => {
           {
             fields: ["preset_id"],
           },
+          {
+            fields: ["group_id"],
+          },
         ],
       }
     );

package/models/Ad.js

@@ -139,6 +139,18 @@ module.exports = (sequelize, DataTypes) => {
         defaultValue: "fb",
         comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
       },
+      review_status: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment:
+          "Local review status mirror (e.g. PENDING_REVIEW after copy/URL edit on Snap). Cleared by status sync.",
+      },
+      pending_review_since: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        comment:
+          "Timestamp when ad was optimistically flipped to PENDING_REVIEW after a triggering edit. Cleared when upstream review settles.",
+      },
     },
     {
       tableName: "Ad",

package/models/AdPerformance.js

@@ -88,6 +88,10 @@ module.exports = (sequelize, DataTypes) => {
         {
           fields: ["AdID"], // Index on AdID for faster join
         },
+        {
+          name: "AdPerformance_platform_Date_idx",
+          fields: ["platform", "Date"],
+        },
       ],
     }
   );

package/models/AdsetPerformance.js

@@ -115,6 +115,11 @@ module.exports = (sequelize, DataTypes) => {
           fields: ["AdSetID", "Date"],
           // Composite unique index to ensure one record per AdSet per date
         },
+        {
+          name: "AdSetPerformance_platform_Date_idx",
+          fields: ["platform", "Date"],
+          // Composite index for platform-scoped date range queries
+        },
       ],
     }
   );

package/models/CampaignCreationLog.js

@@ -114,6 +114,13 @@ module.exports = (sequelize, DataTypes) => {
         allowNull: true,
         comment: "Platform (e.g., Facebook)",
       },
+      platform_code: {
+        type: DataTypes.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        defaultValue: "fb",
+        comment:
+          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      },
       bid_strategy: {
         type: DataTypes.STRING(100),
         allowNull: true,
@@ -262,6 +269,11 @@ module.exports = (sequelize, DataTypes) => {
           fields: ["page_code"],
           comment: "For page code filtering",
         },
+        {
+          name: "idx_campaign_logs_platform_code",
+          fields: ["platform_code"],
+          comment: "For canonical platform filtering",
+        },
         {
           fields: ["process_id"],
         },

package/models/CampaignCreationLogV2.js

@@ -109,6 +109,13 @@ module.exports = (sequelize, DataTypes) => {
         type: DataTypes.STRING(50),
         allowNull: true,
       },
+      platform_code: {
+        type: DataTypes.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        defaultValue: "fb",
+        comment:
+          "Canonical ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      },
       language: {
         type: DataTypes.STRING(50),
         allowNull: true,
@@ -277,6 +284,7 @@ module.exports = (sequelize, DataTypes) => {
         { fields: ["account_id", "status"] },
         { fields: ["vertical", "feed_provider"] },
         { fields: ["details"], using: "gin" },
+        { fields: ["platform_code"] },
       ],
     }
   );