agrs-sequelize-sdk 1.4.59 → 1.4.61

package/models/CampaignCreationLog.js

@@ -1,340 +1,340 @@
-// models/CampaignCreationLog.js
-module.exports = (sequelize, DataTypes) => {
-  const CampaignCreationLog = sequelize.define(
-    "CampaignCreationLog",
-    {
-      id: {
-        type: DataTypes.INTEGER,
-        primaryKey: true,
-        autoIncrement: true,
-      },
-      process_id: {
-        type: DataTypes.UUID,
-        allowNull: false,
-        comment: "Unique ID for the creation batch process",
-      },
-      status: {
-        type: DataTypes.ENUM(
-          "STARTED",
-          "IN_PROGRESS",
-          "COMPLETED",
-          "FAILED",
-          "PARTIALLY_COMPLETED"
-        ),
-        allowNull: false,
-        defaultValue: "STARTED",
-      },
-      country: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-        comment: "Country being processed",
-      },
-      feed_campaign_id: {
-        type: DataTypes.STRING,
-        allowNull: true,
-        comment: "AGRS_CID of the created feed campaign",
-      },
-      facebook_campaign_id: {
-        type: DataTypes.STRING,
-        allowNull: true,
-        comment: "Facebook campaign ID if created",
-      },
-      details: {
-        type: DataTypes.JSONB,
-        allowNull: true,
-        comment: "Additional details about the process or results",
-      },
-      error_message: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-        comment: "Error message if process failed",
-      },
-      vertical: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Campaign vertical (e.g., babydiapers, veteranbenefits)",
-      },
-      feed_provider: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Feed provider (e.g., predicto.ai, compado)",
-      },
-      media_buyer: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Media buyer/assignee (e.g., dug, ida)",
-      },
-      account_id: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Facebook account ID",
-      },
-      campaign_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "Campaign name",
-      },
-      assignee: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Alternative assignee field",
-      },
-      facebook_campaign_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "Facebook campaign name",
-      },
-      notes: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-        comment: "Campaign notes/freeText",
-      },
-      free_text: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-        comment: "Free text content",
-      },
-      ad_title: {
-        type: DataTypes.STRING(500),
-        allowNull: true,
-        comment: "Ad title",
-      },
-      keywords: {
-        type: DataTypes.ARRAY(DataTypes.TEXT),
-        allowNull: true,
-        comment: "Campaign keywords array",
-      },
-      countries: {
-        type: DataTypes.ARRAY(DataTypes.TEXT),
-        allowNull: true,
-        comment: "Target countries array",
-      },
-      platform: {
-        type: DataTypes.STRING(50),
-        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,
-        comment: "Bid strategy",
-      },
-      daily_budget: {
-        type: DataTypes.DECIMAL(10, 2),
-        allowNull: true,
-        comment: "Daily budget amount",
-      },
-      bid_amount: {
-        type: DataTypes.DECIMAL(10, 2),
-        allowNull: true,
-        comment: "Bid amount",
-      },
-      language: {
-        type: DataTypes.STRING(50),
-        allowNull: true,
-        comment: "Campaign language",
-      },
-      domain: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "Campaign domain",
-      },
-      page_id: {
-        type: DataTypes.UUID,
-        allowNull: true,
-        comment: "Facebook Page ID (UUID from Pages table)",
-      },
-      page_code: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Page code (unique identifier from Pages table)",
-      },
-    },
-    {
-      tableName: "CampaignCreationLogs",
-      timestamps: true,
-      indexes: [
-        // CRITICAL: Main performance index for your DISTINCT ON query
-        {
-          name: "idx_campaign_logs_process_created_desc",
-          fields: ["process_id", { name: "createdAt", order: "DESC" }],
-        },
-        // JSON search optimization for account ID filtering
-        {
-          name: "idx_campaign_logs_details_gin",
-          fields: ["details"],
-          using: "gin",
-        },
-        {
-          name: "idx_campaign_logs_vertical",
-          fields: ["vertical"],
-        },
-        {
-          name: "idx_campaign_logs_feed_provider",
-          fields: ["feed_provider"],
-        },
-        {
-          name: "idx_campaign_logs_media_buyer",
-          fields: ["media_buyer"],
-        },
-        {
-          name: "idx_campaign_logs_account_id",
-          fields: ["account_id"],
-        },
-        {
-          name: "idx_campaign_logs_campaign_name",
-          fields: ["campaign_name"],
-        },
-        {
-          name: "idx_campaign_logs_assignee",
-          fields: ["assignee"],
-        },
-        {
-          name: "idx_campaign_logs_keywords",
-          fields: ["keywords"],
-          using: "gin",
-        },
-        {
-          name: "idx_campaign_logs_countries",
-          fields: ["countries"],
-          using: "gin",
-        },
-        // Composite index for status + country filters
-        {
-          name: "idx_campaign_logs_status_country",
-          fields: ["status", "country"],
-        },
-        {
-          name: "idx_campaign_logs_vertical_status",
-          fields: ["vertical", "status"],
-        },
-        {
-          name: "idx_campaign_logs_feed_provider_status",
-          fields: ["feed_provider", "status"],
-        },
-        {
-          name: "idx_campaign_logs_media_buyer_status",
-          fields: ["media_buyer", "status"],
-        },
-        {
-          name: "idx_campaign_logs_account_id_status",
-          fields: ["account_id", "status"],
-        },
-        {
-          name: "idx_campaign_logs_vertical_feed_provider",
-          fields: ["vertical", "feed_provider"],
-        },
-        {
-          name: "idx_campaign_logs_media_buyer_vertical",
-          fields: ["media_buyer", "vertical"],
-        },
-        {
-          name: "idx_campaign_logs_process_status_created",
-          fields: ["process_id", "status", "createdAt"],
-        },
-        {
-          name: "idx_campaign_logs_created_at_desc",
-          fields: [{ name: "createdAt", order: "DESC" }],
-          comment: "Critical for last day filtering and sorting by date",
-        },
-        {
-          name: "idx_campaign_logs_status_created_at",
-          fields: ["status", { name: "createdAt", order: "DESC" }],
-          comment: "Optimized for filtering by status within date ranges",
-        },
-        {
-          name: "idx_campaign_logs_process_created_at_desc",
-          fields: ["process_id", { name: "createdAt", order: "DESC" }],
-          comment: "Optimized for DISTINCT ON queries with date ordering",
-        },
-        {
-          name: "idx_campaign_logs_account_process",
-          fields: ["account_id", "process_id"],
-          comment: "For process-level account filtering v2",
-        },
-        {
-          name: "idx_campaign_logs_page_id",
-          fields: ["page_id"],
-          comment: "For page filtering",
-        },
-        {
-          name: "idx_campaign_logs_page_code",
-          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"],
-        },
-        {
-          fields: ["status"],
-        },
-        {
-          fields: ["country"],
-        },
-        {
-          fields: ["feed_campaign_id"],
-        },
-        {
-          fields: ["facebook_campaign_id"],
-        },
-        {
-          fields: ["createdAt"],
-        },
-        // Partial index mirroring the V2 side (idx_v2_awaiting_by_feed_campaign).
-        // The hourly Tarzo reconciler runs the SAME awaiting-materialization
-        // WHERE clause against both V1 and V2 (dual-write parity). Without this
-        // index the V1 UPDATE seq-scans 15.8M rows / 11GB and hits the 60s
-        // statement_timeout (verified in prod 2026-07-19: 207s EXPLAIN).
-        //
-        // Composite (feed_campaign_id, createdAt DESC) covers both:
-        //   - step 2/5 join key (rfc.AGRS_CID = l.feed_campaign_id)
-        //   - step 3/5 stale-age filter (l.createdAt < now() - 6h)
-        //
-        // Equality predicate — LIKE would be ignored by the planner (proven
-        // 2026-07-19). Self-pruning: rows drop out on COMPLETED/FAILED flip.
-        {
-          name: "idx_v1_awaiting_by_feed_campaign",
-          fields: ["feed_campaign_id", { name: "createdAt", order: "DESC" }],
-          where: sequelize.literal(
-            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
-          ),
-        },
-      ],
-    }
-  );
-
-  CampaignCreationLog.associate = (models) => {
-    // Add associations if needed
-    if (models.CodefuelCampaign) {
-      CampaignCreationLog.belongsTo(models.CodefuelCampaign, {
-        foreignKey: "feed_campaign_id",
-        targetKey: "AGRSCID",
-        as: "FeedCampaign",
-        constraints: false,
-      });
-    }
-
-    if (models.Pages) {
-      CampaignCreationLog.belongsTo(models.Pages, {
-        foreignKey: "page_code",
-        targetKey: "code",
-        as: "Page",
-        constraints: false,
-      });
-    }
-  };
-
-  return CampaignCreationLog;
-};
+// models/CampaignCreationLog.js
+module.exports = (sequelize, DataTypes) => {
+  const CampaignCreationLog = sequelize.define(
+    "CampaignCreationLog",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      process_id: {
+        type: DataTypes.UUID,
+        allowNull: false,
+        comment: "Unique ID for the creation batch process",
+      },
+      status: {
+        type: DataTypes.ENUM(
+          "STARTED",
+          "IN_PROGRESS",
+          "COMPLETED",
+          "FAILED",
+          "PARTIALLY_COMPLETED"
+        ),
+        allowNull: false,
+        defaultValue: "STARTED",
+      },
+      country: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Country being processed",
+      },
+      feed_campaign_id: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment: "AGRS_CID of the created feed campaign",
+      },
+      facebook_campaign_id: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment: "Facebook campaign ID if created",
+      },
+      details: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        comment: "Additional details about the process or results",
+      },
+      error_message: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Error message if process failed",
+      },
+      vertical: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Campaign vertical (e.g., babydiapers, veteranbenefits)",
+      },
+      feed_provider: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Feed provider (e.g., predicto.ai, compado)",
+      },
+      media_buyer: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Media buyer/assignee (e.g., dug, ida)",
+      },
+      account_id: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Facebook account ID",
+      },
+      campaign_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "Campaign name",
+      },
+      assignee: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Alternative assignee field",
+      },
+      facebook_campaign_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "Facebook campaign name",
+      },
+      notes: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Campaign notes/freeText",
+      },
+      free_text: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Free text content",
+      },
+      ad_title: {
+        type: DataTypes.STRING(500),
+        allowNull: true,
+        comment: "Ad title",
+      },
+      keywords: {
+        type: DataTypes.ARRAY(DataTypes.TEXT),
+        allowNull: true,
+        comment: "Campaign keywords array",
+      },
+      countries: {
+        type: DataTypes.ARRAY(DataTypes.TEXT),
+        allowNull: true,
+        comment: "Target countries array",
+      },
+      platform: {
+        type: DataTypes.STRING(50),
+        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,
+        comment: "Bid strategy",
+      },
+      daily_budget: {
+        type: DataTypes.DECIMAL(10, 2),
+        allowNull: true,
+        comment: "Daily budget amount",
+      },
+      bid_amount: {
+        type: DataTypes.DECIMAL(10, 2),
+        allowNull: true,
+        comment: "Bid amount",
+      },
+      language: {
+        type: DataTypes.STRING(50),
+        allowNull: true,
+        comment: "Campaign language",
+      },
+      domain: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "Campaign domain",
+      },
+      page_id: {
+        type: DataTypes.UUID,
+        allowNull: true,
+        comment: "Facebook Page ID (UUID from Pages table)",
+      },
+      page_code: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Page code (unique identifier from Pages table)",
+      },
+    },
+    {
+      tableName: "CampaignCreationLogs",
+      timestamps: true,
+      indexes: [
+        // CRITICAL: Main performance index for your DISTINCT ON query
+        {
+          name: "idx_campaign_logs_process_created_desc",
+          fields: ["process_id", { name: "createdAt", order: "DESC" }],
+        },
+        // JSON search optimization for account ID filtering
+        {
+          name: "idx_campaign_logs_details_gin",
+          fields: ["details"],
+          using: "gin",
+        },
+        {
+          name: "idx_campaign_logs_vertical",
+          fields: ["vertical"],
+        },
+        {
+          name: "idx_campaign_logs_feed_provider",
+          fields: ["feed_provider"],
+        },
+        {
+          name: "idx_campaign_logs_media_buyer",
+          fields: ["media_buyer"],
+        },
+        {
+          name: "idx_campaign_logs_account_id",
+          fields: ["account_id"],
+        },
+        {
+          name: "idx_campaign_logs_campaign_name",
+          fields: ["campaign_name"],
+        },
+        {
+          name: "idx_campaign_logs_assignee",
+          fields: ["assignee"],
+        },
+        {
+          name: "idx_campaign_logs_keywords",
+          fields: ["keywords"],
+          using: "gin",
+        },
+        {
+          name: "idx_campaign_logs_countries",
+          fields: ["countries"],
+          using: "gin",
+        },
+        // Composite index for status + country filters
+        {
+          name: "idx_campaign_logs_status_country",
+          fields: ["status", "country"],
+        },
+        {
+          name: "idx_campaign_logs_vertical_status",
+          fields: ["vertical", "status"],
+        },
+        {
+          name: "idx_campaign_logs_feed_provider_status",
+          fields: ["feed_provider", "status"],
+        },
+        {
+          name: "idx_campaign_logs_media_buyer_status",
+          fields: ["media_buyer", "status"],
+        },
+        {
+          name: "idx_campaign_logs_account_id_status",
+          fields: ["account_id", "status"],
+        },
+        {
+          name: "idx_campaign_logs_vertical_feed_provider",
+          fields: ["vertical", "feed_provider"],
+        },
+        {
+          name: "idx_campaign_logs_media_buyer_vertical",
+          fields: ["media_buyer", "vertical"],
+        },
+        {
+          name: "idx_campaign_logs_process_status_created",
+          fields: ["process_id", "status", "createdAt"],
+        },
+        {
+          name: "idx_campaign_logs_created_at_desc",
+          fields: [{ name: "createdAt", order: "DESC" }],
+          comment: "Critical for last day filtering and sorting by date",
+        },
+        {
+          name: "idx_campaign_logs_status_created_at",
+          fields: ["status", { name: "createdAt", order: "DESC" }],
+          comment: "Optimized for filtering by status within date ranges",
+        },
+        {
+          name: "idx_campaign_logs_process_created_at_desc",
+          fields: ["process_id", { name: "createdAt", order: "DESC" }],
+          comment: "Optimized for DISTINCT ON queries with date ordering",
+        },
+        {
+          name: "idx_campaign_logs_account_process",
+          fields: ["account_id", "process_id"],
+          comment: "For process-level account filtering v2",
+        },
+        {
+          name: "idx_campaign_logs_page_id",
+          fields: ["page_id"],
+          comment: "For page filtering",
+        },
+        {
+          name: "idx_campaign_logs_page_code",
+          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"],
+        },
+        {
+          fields: ["status"],
+        },
+        {
+          fields: ["country"],
+        },
+        {
+          fields: ["feed_campaign_id"],
+        },
+        {
+          fields: ["facebook_campaign_id"],
+        },
+        {
+          fields: ["createdAt"],
+        },
+        // Partial index mirroring the V2 side (idx_v2_awaiting_by_feed_campaign).
+        // The hourly Tarzo reconciler runs the SAME awaiting-materialization
+        // WHERE clause against both V1 and V2 (dual-write parity). Without this
+        // index the V1 UPDATE seq-scans 15.8M rows / 11GB and hits the 60s
+        // statement_timeout (verified in prod 2026-07-19: 207s EXPLAIN).
+        //
+        // Composite (feed_campaign_id, createdAt DESC) covers both:
+        //   - step 2/5 join key (rfc.AGRS_CID = l.feed_campaign_id)
+        //   - step 3/5 stale-age filter (l.createdAt < now() - 6h)
+        //
+        // Equality predicate — LIKE would be ignored by the planner (proven
+        // 2026-07-19). Self-pruning: rows drop out on COMPLETED/FAILED flip.
+        {
+          name: "idx_v1_awaiting_by_feed_campaign",
+          fields: ["feed_campaign_id", { name: "createdAt", order: "DESC" }],
+          where: sequelize.literal(
+            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
+          ),
+        },
+      ],
+    }
+  );
+
+  CampaignCreationLog.associate = (models) => {
+    // Add associations if needed
+    if (models.CodefuelCampaign) {
+      CampaignCreationLog.belongsTo(models.CodefuelCampaign, {
+        foreignKey: "feed_campaign_id",
+        targetKey: "AGRSCID",
+        as: "FeedCampaign",
+        constraints: false,
+      });
+    }
+
+    if (models.Pages) {
+      CampaignCreationLog.belongsTo(models.Pages, {
+        foreignKey: "page_code",
+        targetKey: "code",
+        as: "Page",
+        constraints: false,
+      });
+    }
+  };
+
+  return CampaignCreationLog;
+};