agrs-sequelize-sdk 1.4.59 → 1.4.60

package/models/CampaignCreationLogV2.js

@@ -1,392 +1,392 @@
-// models/CampaignCreationLogV2.js
-module.exports = (sequelize, DataTypes) => {
-  const CampaignCreationLogV2 = sequelize.define(
-    "CampaignCreationLogV2",
-    {
-      id: {
-        type: DataTypes.INTEGER,
-        primaryKey: true,
-        autoIncrement: true,
-      },
-      original_log_id: {
-        type: DataTypes.INTEGER,
-        allowNull: true,
-        unique: true,
-        comment: "ID from CampaignCreationLog (V1) - prevents duplicates",
-      },
-      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",
-      },
-
-      // Location & Targeting
-      country: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-      },
-      countries: {
-        type: DataTypes.ARRAY(DataTypes.TEXT),
-        allowNull: true,
-      },
-      country_type: {
-        type: DataTypes.ENUM("ww", "mix"),
-        allowNull: true,
-        comment:
-          "Computed: ww (has WW), mix (multiple countries without WW), or NULL (single country)",
-      },
-
-      // Campaign identifiers
-      feed_campaign_id: {
-        type: DataTypes.STRING,
-        allowNull: true,
-      },
-      facebook_campaign_id: {
-        type: DataTypes.STRING,
-        allowNull: true,
-      },
-      campaign_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-      facebook_campaign_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-
-      // Feed & Provider
-      feed_provider: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      feed_name: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Display name (e.g., 'predicto.ai' -> 'Predicto')",
-      },
-
-      // User & Account
-      media_buyer: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      assignee: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      user_name: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-        comment: "Full name from user mapping",
-      },
-      account_id: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      account_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "From AdAccount table",
-      },
-
-      // Campaign metadata
-      vertical: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      platform: {
-        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,
-      },
-      domain: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-
-      // Keywords & Content
-      keywords: {
-        type: DataTypes.ARRAY(DataTypes.TEXT),
-        allowNull: true,
-      },
-      main_keyword: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-      article_style: {
-        type: DataTypes.STRING(50),
-        allowNull: true,
-        comment: "black, blue, green, white",
-      },
-      ads_category: {
-        type: DataTypes.STRING(10),
-        allowNull: true,
-        comment: "l (Low), m (Medium), h (High)",
-      },
-      ad_title: {
-        type: DataTypes.STRING(500),
-        allowNull: true,
-      },
-      notes: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-      },
-      free_text: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-      },
-
-      // Facebook Campaign Settings
-      pixel_id: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      pixel_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-      pixel_event: {
-        type: DataTypes.STRING(50),
-        allowNull: true,
-      },
-      bid_strategy: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      daily_budget: {
-        type: DataTypes.DECIMAL(10, 2),
-        allowNull: true,
-      },
-      bid_amount: {
-        type: DataTypes.DECIMAL(10, 2),
-        allowNull: true,
-      },
-      optimization_goal: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      special_ad_categories: {
-        type: DataTypes.ARRAY(DataTypes.TEXT),
-        allowNull: true,
-        comment: "Array of categories (CREDIT, HOUSING, EMPLOYMENT)",
-      },
-
-      // Page info
-      page_id: {
-        type: DataTypes.UUID,
-        allowNull: true,
-      },
-      page_code: {
-        type: DataTypes.STRING(100),
-        allowNull: true,
-      },
-      page_name: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-
-      // Article/Content
-      agrs_aid: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "Article ID",
-      },
-      article_id: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-        comment: "For Mine/Predicto feeds",
-      },
-
-      // Error handling
-      error_message: {
-        type: DataTypes.TEXT,
-        allowNull: true,
-      },
-      error_user_title: {
-        type: DataTypes.STRING(255),
-        allowNull: true,
-      },
-      error_code: {
-        type: DataTypes.STRING(50),
-        allowNull: true,
-      },
-      error_subcode: {
-        type: DataTypes.STRING(50),
-        allowNull: true,
-      },
-
-      // JSON fields for backward compatibility
-      details: {
-        type: DataTypes.JSONB,
-        allowNull: true,
-        comment: "For backward compatibility and complex nested data",
-      },
-      original_request_data: {
-        type: DataTypes.JSONB,
-        allowNull: true,
-        comment: "Full original request for reference",
-      },
-      facebook_response: {
-        type: DataTypes.JSONB,
-        allowNull: true,
-        comment: "Facebook API response",
-      },
-    },
-    {
-      tableName: "CampaignCreationLogsV2",
-      timestamps: true,
-      createdAt: "created_at",
-      updatedAt: "updated_at",
-      indexes: [
-        { fields: ["original_log_id"], unique: true }, // Prevent duplicate V1 logs
-        { fields: ["process_id"] },
-        { fields: ["status"] },
-        { fields: ["country"] },
-        { fields: ["countries"], using: "gin" },
-        { fields: ["country_type"] },
-        { fields: ["feed_provider"] },
-        { fields: ["media_buyer"] },
-        { fields: ["account_id"] },
-        { fields: ["vertical"] },
-        { fields: ["keywords"], using: "gin" },
-        { fields: [{ name: "created_at", order: "DESC" }] },
-        {
-          fields: [
-            "process_id",
-            "status",
-            { name: "created_at", order: "DESC" },
-          ],
-        },
-        { fields: ["status", "country"] },
-        { fields: ["feed_provider", "status"] },
-        { fields: ["media_buyer", "status"] },
-        { fields: ["account_id", "status"] },
-        { fields: ["vertical", "feed_provider"] },
-        { fields: ["details"], using: "gin" },
-        { fields: ["platform_code"] },
-        // Partial indexes for the hourly Tarzo reconciler (steps 2/5 and 3/5
-        // in reconcilerService.js). Both steps filter on:
-        //   status='IN_PROGRESS'
-        //   AND details->>'ai_stage'='tarzo_awaiting_materialization'
-        // Predicate is equality — NOT `LIKE 'tarzo_%'` — because Postgres's
-        // partial-index prover doesn't cross equality→LIKE, so a LIKE-predicate
-        // index would be ignored (verified in prod 2026-07-19). Equality
-        // matches the queries verbatim, so the planner picks these up.
-        //
-        // Column choices:
-        //   - feed_campaign_id: drives the nested-loop join to
-        //     rsoc_feed_campaigns.AGRS_CID in step 2/5.
-        //   - created_at: powers the stale age filter in step 3/5.
-        //
-        // Self-pruning: rows leave the index as soon as status flips to
-        // COMPLETED/FAILED, so index size stays proportional to in-flight
-        // rows only.
-        {
-          name: "idx_v2_awaiting_by_feed_campaign",
-          fields: ["feed_campaign_id"],
-          where: sequelize.literal(
-            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
-          ),
-        },
-        {
-          name: "idx_v2_awaiting_created_at",
-          fields: [{ name: "created_at", order: "DESC" }],
-          where: sequelize.literal(
-            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
-          ),
-        },
-        // Partial index for the ai_campaign_queue backfill query in step 2/5
-        // (completeAdoptedAwaitingLogs's third UPDATE). After the awaiting log
-        // flips to COMPLETED, ai_stage becomes 'tarzo_materialized_and_adopted'
-        // and the queue's facebook_campaign_id gets backfilled by joining V2
-        // to ai_campaign_queue via process_id.
-        //
-        // Without this, the query bitmap-scans by status='COMPLETED' (returns
-        // 1.2M rows), then filters ai_stage in memory (rejects 1.18M) → 175s
-        // seq scan, 60s timeout in prod (verified 2026-07-19).
-        //
-        // Composite (process_id, feed_campaign_id) supports both the join to
-        // ai_campaign_queue.creation_logs_process_id AND the further join to
-        // rsoc_feed_campaigns.AGRS_CID.
-        {
-          name: "idx_v2_adopted_by_process",
-          fields: ["process_id", "feed_campaign_id"],
-          where: sequelize.literal(
-            `status = 'COMPLETED' AND (details->>'ai_stage') = 'tarzo_materialized_and_adopted'`
-          ),
-        },
-        // Partial index for the ai_campaign_queue "queue-flip-to-failed" query
-        // in step 3/5 (failStaleAwaitingLogs's third UPDATE). After a V2 log
-        // gets flipped to FAILED with ai_stage='tarzo_awaited_but_never_
-        // materialized', the corresponding queue row must also flip to
-        // 'failed' by joining V2 → ai_campaign_queue via process_id.
-        //
-        // Without this, the query used the plain status index → scanned 266K
-        // FAILED rows → filtered ai_stage in memory (kept 212) → 72.9s and
-        // hit 60s statement_timeout (verified 2026-07-19).
-        //
-        // Same shape as idx_v2_adopted_by_process, mirrored for the FAILED-
-        // never-materialized end-state.
-        {
-          name: "idx_v2_awaited_never_materialized_by_process",
-          fields: ["process_id"],
-          where: sequelize.literal(
-            `status = 'FAILED' AND (details->>'ai_stage') = 'tarzo_awaited_but_never_materialized'`
-          ),
-        },
-      ],
-    }
-  );
-
-  CampaignCreationLogV2.associate = (models) => {
-    if (models.CampaignCreationLog) {
-      CampaignCreationLogV2.belongsTo(models.CampaignCreationLog, {
-        foreignKey: "process_id",
-        targetKey: "process_id",
-        as: "OriginalLog",
-        constraints: false,
-      });
-    }
-
-    if (models.AdAccount) {
-      CampaignCreationLogV2.belongsTo(models.AdAccount, {
-        foreignKey: "account_id",
-        targetKey: "AdAccountID",
-        as: "Account",
-        constraints: false,
-      });
-    }
-
-    if (models.Pages) {
-      CampaignCreationLogV2.belongsTo(models.Pages, {
-        foreignKey: "page_code",
-        targetKey: "code",
-        as: "Page",
-        constraints: false,
-      });
-    }
-  };
-
-  return CampaignCreationLogV2;
-};
+// models/CampaignCreationLogV2.js
+module.exports = (sequelize, DataTypes) => {
+  const CampaignCreationLogV2 = sequelize.define(
+    "CampaignCreationLogV2",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      original_log_id: {
+        type: DataTypes.INTEGER,
+        allowNull: true,
+        unique: true,
+        comment: "ID from CampaignCreationLog (V1) - prevents duplicates",
+      },
+      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",
+      },
+
+      // Location & Targeting
+      country: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+      countries: {
+        type: DataTypes.ARRAY(DataTypes.TEXT),
+        allowNull: true,
+      },
+      country_type: {
+        type: DataTypes.ENUM("ww", "mix"),
+        allowNull: true,
+        comment:
+          "Computed: ww (has WW), mix (multiple countries without WW), or NULL (single country)",
+      },
+
+      // Campaign identifiers
+      feed_campaign_id: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      facebook_campaign_id: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      campaign_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+      facebook_campaign_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+
+      // Feed & Provider
+      feed_provider: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      feed_name: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Display name (e.g., 'predicto.ai' -> 'Predicto')",
+      },
+
+      // User & Account
+      media_buyer: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      assignee: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      user_name: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+        comment: "Full name from user mapping",
+      },
+      account_id: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      account_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "From AdAccount table",
+      },
+
+      // Campaign metadata
+      vertical: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      platform: {
+        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,
+      },
+      domain: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+
+      // Keywords & Content
+      keywords: {
+        type: DataTypes.ARRAY(DataTypes.TEXT),
+        allowNull: true,
+      },
+      main_keyword: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+      article_style: {
+        type: DataTypes.STRING(50),
+        allowNull: true,
+        comment: "black, blue, green, white",
+      },
+      ads_category: {
+        type: DataTypes.STRING(10),
+        allowNull: true,
+        comment: "l (Low), m (Medium), h (High)",
+      },
+      ad_title: {
+        type: DataTypes.STRING(500),
+        allowNull: true,
+      },
+      notes: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+      free_text: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+
+      // Facebook Campaign Settings
+      pixel_id: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      pixel_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+      pixel_event: {
+        type: DataTypes.STRING(50),
+        allowNull: true,
+      },
+      bid_strategy: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      daily_budget: {
+        type: DataTypes.DECIMAL(10, 2),
+        allowNull: true,
+      },
+      bid_amount: {
+        type: DataTypes.DECIMAL(10, 2),
+        allowNull: true,
+      },
+      optimization_goal: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      special_ad_categories: {
+        type: DataTypes.ARRAY(DataTypes.TEXT),
+        allowNull: true,
+        comment: "Array of categories (CREDIT, HOUSING, EMPLOYMENT)",
+      },
+
+      // Page info
+      page_id: {
+        type: DataTypes.UUID,
+        allowNull: true,
+      },
+      page_code: {
+        type: DataTypes.STRING(100),
+        allowNull: true,
+      },
+      page_name: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+
+      // Article/Content
+      agrs_aid: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "Article ID",
+      },
+      article_id: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "For Mine/Predicto feeds",
+      },
+
+      // Error handling
+      error_message: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+      error_user_title: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+      },
+      error_code: {
+        type: DataTypes.STRING(50),
+        allowNull: true,
+      },
+      error_subcode: {
+        type: DataTypes.STRING(50),
+        allowNull: true,
+      },
+
+      // JSON fields for backward compatibility
+      details: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        comment: "For backward compatibility and complex nested data",
+      },
+      original_request_data: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        comment: "Full original request for reference",
+      },
+      facebook_response: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        comment: "Facebook API response",
+      },
+    },
+    {
+      tableName: "CampaignCreationLogsV2",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+      indexes: [
+        { fields: ["original_log_id"], unique: true }, // Prevent duplicate V1 logs
+        { fields: ["process_id"] },
+        { fields: ["status"] },
+        { fields: ["country"] },
+        { fields: ["countries"], using: "gin" },
+        { fields: ["country_type"] },
+        { fields: ["feed_provider"] },
+        { fields: ["media_buyer"] },
+        { fields: ["account_id"] },
+        { fields: ["vertical"] },
+        { fields: ["keywords"], using: "gin" },
+        { fields: [{ name: "created_at", order: "DESC" }] },
+        {
+          fields: [
+            "process_id",
+            "status",
+            { name: "created_at", order: "DESC" },
+          ],
+        },
+        { fields: ["status", "country"] },
+        { fields: ["feed_provider", "status"] },
+        { fields: ["media_buyer", "status"] },
+        { fields: ["account_id", "status"] },
+        { fields: ["vertical", "feed_provider"] },
+        { fields: ["details"], using: "gin" },
+        { fields: ["platform_code"] },
+        // Partial indexes for the hourly Tarzo reconciler (steps 2/5 and 3/5
+        // in reconcilerService.js). Both steps filter on:
+        //   status='IN_PROGRESS'
+        //   AND details->>'ai_stage'='tarzo_awaiting_materialization'
+        // Predicate is equality — NOT `LIKE 'tarzo_%'` — because Postgres's
+        // partial-index prover doesn't cross equality→LIKE, so a LIKE-predicate
+        // index would be ignored (verified in prod 2026-07-19). Equality
+        // matches the queries verbatim, so the planner picks these up.
+        //
+        // Column choices:
+        //   - feed_campaign_id: drives the nested-loop join to
+        //     rsoc_feed_campaigns.AGRS_CID in step 2/5.
+        //   - created_at: powers the stale age filter in step 3/5.
+        //
+        // Self-pruning: rows leave the index as soon as status flips to
+        // COMPLETED/FAILED, so index size stays proportional to in-flight
+        // rows only.
+        {
+          name: "idx_v2_awaiting_by_feed_campaign",
+          fields: ["feed_campaign_id"],
+          where: sequelize.literal(
+            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
+          ),
+        },
+        {
+          name: "idx_v2_awaiting_created_at",
+          fields: [{ name: "created_at", order: "DESC" }],
+          where: sequelize.literal(
+            `status = 'IN_PROGRESS' AND (details->>'ai_stage') = 'tarzo_awaiting_materialization'`
+          ),
+        },
+        // Partial index for the ai_campaign_queue backfill query in step 2/5
+        // (completeAdoptedAwaitingLogs's third UPDATE). After the awaiting log
+        // flips to COMPLETED, ai_stage becomes 'tarzo_materialized_and_adopted'
+        // and the queue's facebook_campaign_id gets backfilled by joining V2
+        // to ai_campaign_queue via process_id.
+        //
+        // Without this, the query bitmap-scans by status='COMPLETED' (returns
+        // 1.2M rows), then filters ai_stage in memory (rejects 1.18M) → 175s
+        // seq scan, 60s timeout in prod (verified 2026-07-19).
+        //
+        // Composite (process_id, feed_campaign_id) supports both the join to
+        // ai_campaign_queue.creation_logs_process_id AND the further join to
+        // rsoc_feed_campaigns.AGRS_CID.
+        {
+          name: "idx_v2_adopted_by_process",
+          fields: ["process_id", "feed_campaign_id"],
+          where: sequelize.literal(
+            `status = 'COMPLETED' AND (details->>'ai_stage') = 'tarzo_materialized_and_adopted'`
+          ),
+        },
+        // Partial index for the ai_campaign_queue "queue-flip-to-failed" query
+        // in step 3/5 (failStaleAwaitingLogs's third UPDATE). After a V2 log
+        // gets flipped to FAILED with ai_stage='tarzo_awaited_but_never_
+        // materialized', the corresponding queue row must also flip to
+        // 'failed' by joining V2 → ai_campaign_queue via process_id.
+        //
+        // Without this, the query used the plain status index → scanned 266K
+        // FAILED rows → filtered ai_stage in memory (kept 212) → 72.9s and
+        // hit 60s statement_timeout (verified 2026-07-19).
+        //
+        // Same shape as idx_v2_adopted_by_process, mirrored for the FAILED-
+        // never-materialized end-state.
+        {
+          name: "idx_v2_awaited_never_materialized_by_process",
+          fields: ["process_id"],
+          where: sequelize.literal(
+            `status = 'FAILED' AND (details->>'ai_stage') = 'tarzo_awaited_but_never_materialized'`
+          ),
+        },
+      ],
+    }
+  );
+
+  CampaignCreationLogV2.associate = (models) => {
+    if (models.CampaignCreationLog) {
+      CampaignCreationLogV2.belongsTo(models.CampaignCreationLog, {
+        foreignKey: "process_id",
+        targetKey: "process_id",
+        as: "OriginalLog",
+        constraints: false,
+      });
+    }
+
+    if (models.AdAccount) {
+      CampaignCreationLogV2.belongsTo(models.AdAccount, {
+        foreignKey: "account_id",
+        targetKey: "AdAccountID",
+        as: "Account",
+        constraints: false,
+      });
+    }
+
+    if (models.Pages) {
+      CampaignCreationLogV2.belongsTo(models.Pages, {
+        foreignKey: "page_code",
+        targetKey: "code",
+        as: "Page",
+        constraints: false,
+      });
+    }
+  };
+
+  return CampaignCreationLogV2;
+};