agrs-sequelize-sdk 1.4.52 → 1.4.53

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

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