agrs-sequelize-sdk 1.4.22 → 1.4.24

package/.worktrees/ad-review-status/models/AiArticleRetryQueue.js

@@ -0,0 +1,157 @@
+module.exports = (sequelize, DataTypes) => {
+  const AiArticleRetryQueue = sequelize.define(
+    "AiArticleRetryQueue",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      agrs_cid: {
+        type: DataTypes.STRING(255),
+        allowNull: false,
+        field: "agrs_cid",
+        comment: "AGRS Campaign ID (links to the campaign combo)",
+      },
+      process_id: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        field: "process_id",
+        comment: "Root process_id from createAICampaign",
+      },
+      controller_process_id: {
+        type: DataTypes.UUID,
+        allowNull: true,
+        field: "controller_process_id",
+        comment: "Per-campaign process_id (for CampaignCreationLog)",
+      },
+      feed_provider: {
+        type: DataTypes.STRING(100),
+        allowNull: false,
+        field: "feed_provider",
+        comment: "Normalized feed name: Mine - RSOC, Predicto - RSOC, etc.",
+      },
+      article_creation_payload: {
+        type: DataTypes.JSONB,
+        allowNull: false,
+        field: "article_creation_payload",
+        comment: "Exact params to pass to createMineArticle/createPredictoArticle/etc.",
+      },
+      original_payload: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        field: "original_payload",
+        comment: "Full original_payload from createAICampaign (preset, feed config, AI settings, combo values)",
+      },
+      generated_assets: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        field: "generated_assets",
+        comment: "Already-generated assets: { headlines, primaryTexts, bannerFiles, keywords }",
+      },
+      campaign_context: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        field: "campaign_context",
+        comment: "Additional context needed to resume campaign flow after article succeeds",
+      },
+      status: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+        defaultValue: "pending",
+        validate: {
+          isIn: [["pending", "processing", "completed", "failed", "abandoned"]],
+        },
+      },
+      retry_count: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+        field: "retry_count",
+      },
+      max_retries: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 10,
+        field: "max_retries",
+      },
+      next_retry_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+        field: "next_retry_at",
+        comment: "When the next retry should be attempted",
+      },
+      last_error: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        field: "last_error",
+      },
+      last_attempt_at: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        field: "last_attempt_at",
+      },
+      created_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+        defaultValue: DataTypes.NOW,
+        field: "created_at",
+      },
+      completed_at: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        field: "completed_at",
+      },
+      article_id: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        field: "article_id",
+        comment: "AGRSAID of created article (populated on success)",
+      },
+      article_url: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        field: "article_url",
+        comment: "URL of created article (populated on success)",
+      },
+      platform: {
+        type: DataTypes.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        defaultValue: "fb",
+        field: "platform",
+        comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      },
+    },
+    {
+      tableName: "ai_article_retry_queue",
+      timestamps: false,
+      indexes: [
+        {
+          fields: ["status", "next_retry_at"],
+          name: "idx_article_retry_status_next",
+        },
+        {
+          fields: ["agrs_cid"],
+        },
+        {
+          fields: ["feed_provider"],
+        },
+        {
+          fields: ["process_id"],
+        },
+        {
+          fields: ["controller_process_id"],
+        },
+        {
+          fields: ["created_at"],
+        },
+      ],
+    }
+  );
+
+  AiArticleRetryQueue.associate = (models) => {
+    // No associations needed for now
+  };
+
+  return AiArticleRetryQueue;
+};

package/.worktrees/ad-review-status/models/AiCreationRetryQueue.js

@@ -0,0 +1,127 @@
+module.exports = (sequelize, DataTypes) => {
+  const AiCreationRetryQueue = sequelize.define(
+    "AiCreationRetryQueue",
+    {
+      id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      agrs_cid: {
+        type: DataTypes.STRING(255),
+        allowNull: false,
+        field: "agrs_cid",
+        comment: "AGRS Campaign ID (links to the campaign combo)",
+      },
+      process_id: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        field: "process_id",
+        comment: "Root process_id from createAICampaign",
+      },
+      controller_process_id: {
+        type: DataTypes.UUID,
+        allowNull: true,
+        field: "controller_process_id",
+        comment: "Per-combination process_id (for CampaignCreationLog)",
+      },
+      feed_provider: {
+        type: DataTypes.STRING(100),
+        allowNull: false,
+        field: "feed_provider",
+        comment: "Normalized feed name: Mine - RSOC, Predicto - RSOC, etc.",
+      },
+      failed_step: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+        field: "failed_step",
+        comment:
+          "Step that failed: keywords, texts, banners, fb_creation, rabbitmq_publish",
+      },
+      original_payload: {
+        type: DataTypes.JSONB,
+        allowNull: false,
+        field: "original_payload",
+        comment: "Full combination payload for retry",
+      },
+      generated_assets: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        defaultValue: {},
+        field: "generated_assets",
+        comment:
+          "Assets generated before failure: { keywords, headlines, primaryTexts, bannerFiles }",
+      },
+      campaign_context: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        defaultValue: {},
+        field: "campaign_context",
+        comment:
+          "Additional context needed to resume campaign flow after retry",
+      },
+      status: {
+        type: DataTypes.STRING(50),
+        allowNull: false,
+        defaultValue: "pending",
+        validate: {
+          isIn: [["pending", "processing", "completed", "failed", "abandoned"]],
+        },
+      },
+      retry_count: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+        field: "retry_count",
+      },
+      max_retries: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 5,
+        field: "max_retries",
+      },
+      next_retry_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+        field: "next_retry_at",
+        comment: "When the next retry should be attempted",
+      },
+      last_error: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        field: "last_error",
+      },
+      last_attempt_at: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        field: "last_attempt_at",
+      },
+      completed_at: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        field: "completed_at",
+      },
+    },
+    {
+      tableName: "ai_creation_retry_queue",
+      timestamps: true,
+      underscored: true,
+      indexes: [
+        {
+          fields: ["status", "next_retry_at"],
+          name: "idx_creation_retry_status_next",
+        },
+        {
+          fields: ["agrs_cid"],
+          name: "idx_creation_retry_agrs_cid",
+        },
+      ],
+    }
+  );
+
+  AiCreationRetryQueue.associate = (models) => {
+    // No associations needed for now
+  };
+
+  return AiCreationRetryQueue;
+};

package/.worktrees/ad-review-status/models/Article.js

@@ -0,0 +1,212 @@
+module.exports = (sequelize, DataTypes) => {
+  const Article = sequelize.define(
+    "Article",
+    {
+      providerId: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      keywordId: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment: "ID of the keyword from Predicto keywords API",
+      },
+      requestedFromDashboard: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+        comment:
+          "Indicates if the article was created through our dashboard (true) or imported from external sources (false)",
+      },
+      category: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      AGRSAID: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        unique: true,
+      },
+      articleUrl: {
+        type: DataTypes.STRING(1024),
+        allowNull: true,
+      },
+      feed: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      feedName: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      vertical: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      language: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        defaultValue: "en",
+      },
+      headline: {
+        type: DataTypes.STRING(1000),
+        allowNull: true,
+      },
+      topics: {
+        type: DataTypes.ARRAY(DataTypes.STRING(1000)),
+        allowNull: true,
+      },
+      translatedTopics: {
+        type: DataTypes.ARRAY(DataTypes.STRING(1000)),
+        allowNull: true,
+        comment: "Topics translated to English for display purposes",
+      },
+      mainKeyword: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      predictoKeyword: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment: "Exact keyword sent to Predicto (with suffix for uniqueness). Used for search= URL param.",
+      },
+      keywords: {
+        type: DataTypes.ARRAY(DataTypes.STRING),
+        allowNull: true,
+      },
+      date: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        defaultValue: DataTypes.NOW,
+      },
+      nativeKeyword: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      suggestedKeywords: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      articleExcerpt: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+      articleContent: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+      fbPixelId: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      status: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        defaultValue: "pending",
+      },
+      originalStatus: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        comment: "Original status from Predicto before any mapping",
+      },
+      rejectionReason: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Rejection reason from Predicto when keyword is disapproved",
+      },
+      creationType: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        defaultValue: "slug",
+        validate: {
+          isIn: [["search", "slug", "manual-tonic"]],
+        },
+      },
+      createdAt: {
+        type: DataTypes.DATE,
+        defaultValue: DataTypes.NOW,
+      },
+      updatedAt: {
+        type: DataTypes.DATE,
+        defaultValue: DataTypes.NOW,
+      },
+      buyer: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      country: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      name: {
+        type: DataTypes.STRING,
+        allowNull: true,
+      },
+      submittedToMine: {
+        type: DataTypes.BOOLEAN,
+        allowNull: true,
+        defaultValue: false,
+        comment: "Tracks if article has been submitted to Mine Marketing API in bulk migration"
+      },
+      submittedToMineAt: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        comment: "Timestamp when article was submitted to Mine Marketing"
+      },
+      contentType: {
+        type: DataTypes.STRING,
+        allowNull: true,
+        defaultValue: 'generate',
+        validate: {
+          isIn: [['generate', 'import']]
+        },
+        comment: "Type of content: 'generate' for AI-generated or 'import' from URL"
+      },
+      platform: {
+        type: DataTypes.ENUM("fb", "tt", "snp"),
+        allowNull: false,
+        defaultValue: "fb",
+        comment: "Ad platform identifier: fb=Facebook, tt=TikTok, snp=Snapchat",
+      }
+    },
+    {
+      tableName: "articles",
+      timestamps: true,
+      indexes: [
+        {
+          unique: true,
+          fields: ['providerId', 'feed'],
+          name: 'unique_provider_per_feed'
+        }
+      ]
+    }
+  );
+
+  Article.associate = (models) => {
+    Article.hasMany(models.RSOCFeedCampaign, {
+      foreignKey: "AGRSAID",
+      sourceKey: "AGRSAID",
+      as: "RSOCFeedCampaigns",
+      constraints: false,
+    });
+  };
+
+  Article.prototype.isAvailableForCampaign = function () {
+    return ["approved", "keyword_already_exists"].includes(this.status);
+  };
+
+  // NEW METHODS FOR URL STRUCTURE HANDLING
+  Article.prototype.isUnifiedStructure = function () {
+    return this.url_structure === "unified";
+  };
+
+  Article.prototype.getTargetDomain = function () {
+    return this.target_domain || "sportfoy.com";
+  };
+
+  Article.prototype.isLegacyStructure = function () {
+    return this.url_structure === "legacy";
+  };
+
+  return Article;
+};

package/.worktrees/ad-review-status/models/AutomationRule.js

@@ -0,0 +1,173 @@
+module.exports = (sequelize, DataTypes) => {
+  const AutomationRule = sequelize.define(
+    "AutomationRule",
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+      name: {
+        type: DataTypes.STRING,
+        allowNull: false,
+        comment: "Rule name for identification",
+      },
+      description: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+        comment: "Optional description of what this rule does",
+      },
+      isActive: {
+        type: DataTypes.BOOLEAN,
+        defaultValue: true,
+        allowNull: false,
+        comment: "Whether the rule is currently active",
+      },
+      dryRun: {
+        type: DataTypes.BOOLEAN,
+        defaultValue: false,
+        allowNull: false,
+        comment:
+          "If true, rule will evaluate but not execute actions (simulation mode)",
+      },
+      ruleType: {
+        type: DataTypes.ENUM("PAUSE", "BUDGET", "BID", "STATUS", "CUSTOM"),
+        allowNull: true,
+        comment: "Type of rule - determines the action category",
+      },
+      targetLevel: {
+        type: DataTypes.ENUM("CAMPAIGN", "ADSET", "AD"),
+        allowNull: true,
+        comment: "Level at which the rule operates",
+      },
+      scheduleType: {
+        type: DataTypes.ENUM("INTERVAL", "CRON", "MANUAL"),
+        allowNull: true,
+        defaultValue: "MANUAL",
+        comment: "How the rule is triggered",
+      },
+      scheduleConfig: {
+        type: DataTypes.JSONB,
+        allowNull: true,
+        comment:
+          "Schedule configuration (interval minutes, cron expression, etc.)",
+      },
+      gcpJobName: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "GCP Cloud Scheduler job name for this rule",
+      },
+      lastExecuted: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        comment: "When the rule was last executed",
+      },
+      nextExecution: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        comment: "When the rule is scheduled to run next",
+      },
+      executionCount: {
+        type: DataTypes.INTEGER,
+        defaultValue: 0,
+        allowNull: false,
+        comment: "Number of times this rule has been executed",
+      },
+      successCount: {
+        type: DataTypes.INTEGER,
+        defaultValue: 0,
+        allowNull: false,
+        comment: "Number of successful executions",
+      },
+      failureCount: {
+        type: DataTypes.INTEGER,
+        defaultValue: 0,
+        allowNull: false,
+        comment: "Number of failed executions",
+      },
+      createdBy: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "User who created this rule",
+      },
+      updatedBy: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "User who last updated this rule",
+      },
+      mediaBuyer: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        comment: "Media buyer assigned to this rule for permissions",
+      },
+      dateRangeType: {
+        type: DataTypes.ENUM(
+          "LAST_N_DAYS",
+          "CUSTOM_RANGE",
+          "CURRENT_MONTH",
+          "LAST_MONTH"
+        ),
+        allowNull: true,
+        defaultValue: "LAST_N_DAYS",
+        comment: "Type of date range for rule evaluation",
+      },
+      dateRangeValue: {
+        type: DataTypes.INTEGER,
+        allowNull: true,
+        defaultValue: 7,
+        comment: "Number of days for LAST_N_DAYS type",
+      },
+      customStartDate: {
+        type: DataTypes.DATEONLY,
+        allowNull: true,
+        comment: "Custom start date for CUSTOM_RANGE type",
+      },
+      customEndDate: {
+        type: DataTypes.DATEONLY,
+        allowNull: true,
+        comment: "Custom end date for CUSTOM_RANGE type",
+      },
+      allowedAccounts: {
+        type: DataTypes.ARRAY(DataTypes.STRING),
+        allowNull: true,
+        defaultValue: [],
+        comment: "Array of account IDs that this rule can run on",
+      },
+      allowedMediaBuyers: {
+        type: DataTypes.ARRAY(DataTypes.STRING),
+        allowNull: true,
+        defaultValue: [],
+        comment: "Array of media buyer codes that this rule can be assigned to",
+      },
+    },
+    {
+      tableName: "AutomationRules", // New table name
+      timestamps: true,
+    }
+  );
+
+  AutomationRule.associate = (models) => {
+    // A rule has many conditions
+    AutomationRule.hasMany(models.RuleCondition, {
+      foreignKey: "ruleId",
+      as: "conditions",
+      onDelete: "CASCADE",
+    });
+
+    // A rule has many actions
+    AutomationRule.hasMany(models.RuleAction, {
+      foreignKey: "ruleId",
+      as: "actions",
+      onDelete: "CASCADE",
+    });
+
+    // A rule has many execution logs
+    AutomationRule.hasMany(models.RuleExecution, {
+      foreignKey: "ruleId",
+      as: "executions",
+      onDelete: "CASCADE",
+    });
+  };
+
+  return AutomationRule;
+};