ojamoto_models 1.0.14 → 1.0.16

package/migrations/2026000054-create-product-rating.js

@@ -0,0 +1,73 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("product_ratings", {
+      product_rating_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      product_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "products", key: "product_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      buyer_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      rating: {
+        type: Sequelize.TINYINT,
+        allowNull: false,
+      },
+      comment: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+
+    // Add to Product table
+    await queryInterface.addColumn("products", "avg_rating", {
+      type: Sequelize.DECIMAL(3, 2),
+      allowNull: true,
+      after: "revalidation_prompted_at",
+    });
+
+    await queryInterface.addColumn("products", "ratings_count", {
+      type: Sequelize.INTEGER,
+      allowNull: false,
+      defaultValue: 0,
+      after: "avg_rating",
+    });
+
+    await queryInterface.addIndex("product_ratings", ["product_id"]);
+
+    await queryInterface.addIndex(
+      "product_ratings",
+      ["product_id", "buyer_id"],
+      {
+        unique: true,
+        name: "product_ratings_product_buyer_unique",
+      },
+    );
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("product_ratings");
+  },
+};

package/migrations/2026000055-create-notification-preferences.js

@@ -0,0 +1,54 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("notification_preferences", {
+      notification_preference_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      user_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        unique: true,
+        references: { model: "users", key: "user_id" },
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+      },
+      push_enabled: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      in_app_enabled: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      email_enabled: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      sms_enabled: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("notification_preferences");
+  },
+};

package/migrations/2026000056-add-source-to-platform-income.js

@@ -0,0 +1,29 @@
+("use strict");
+
+const { PLATFORM_INCOME_SOURCE } = require("../services/constants");
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.addColumn("platform_incomes", "source", {
+      type: Sequelize.STRING(20),
+      allowNull: true,
+      after: "currency",
+      comment:
+        "Where this income came from: ESCROW_FEE | SUBSCRIPTION | WITHDRAWAL_FEE",
+    });
+
+    await queryInterface.sequelize.query(
+      `UPDATE platform_incomes SET source = :source WHERE source IS NULL`,
+      { replacements: { source: PLATFORM_INCOME_SOURCE.ESCROW_FEE } },
+    );
+
+    await queryInterface.changeColumn("platform_incomes", "source", {
+      type: Sequelize.STRING(20),
+      allowNull: false,
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.removeColumn("platform_incomes", "source");
+  },
+};

package/migrations/2026000057-update-escrowId-to-accept-null-platform-income.js

@@ -0,0 +1,17 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface) {
+    await queryInterface.sequelize.query(`
+      ALTER TABLE platform_incomes
+      MODIFY COLUMN escrow_id INT NULL;
+    `);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.sequelize.query(`
+      ALTER TABLE platform_incomes
+      MODIFY COLUMN escrow_id INT NOT NULL;
+    `);
+  },
+};

package/models/NotificationPreference.js

@@ -0,0 +1,59 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+
+module.exports = (sequelize) => {
+  class NotificationPreference extends Model {
+    static associate(models) {
+      NotificationPreference.belongsTo(models.User, {
+        foreignKey: "user_id",
+        as: "user",
+      });
+    }
+  }
+
+  NotificationPreference.init(
+    {
+      notification_preference_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      user_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        unique: true,
+      },
+      push_enabled: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      in_app_enabled: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      email_enabled: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+      sms_enabled: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+    },
+    {
+      sequelize,
+      modelName: "NotificationPreference",
+      tableName: "notification_preferences",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  NotificationPreference.removeAttribute("id");
+  return NotificationPreference;
+};

package/models/PlatformIncome.js

@@ -1,6 +1,7 @@
 "use strict";
 
 const { Model, DataTypes } = require("sequelize");
+const { PLATFORM_INCOME_SOURCE } = require("../services/constants");
 
 module.exports = (sequelize) => {
   class PlatformIncome extends Model {
@@ -32,8 +33,8 @@ module.exports = (sequelize) => {
       },
       escrow_id: {
         type: DataTypes.INTEGER,
-        allowNull: false,
-        unique: true, // one fee record per escrow — prevents double-crediting the same escrow
+        allowNull: true,
+        unique: true, // enforces uniqueness only among non-null values — multiple NULLs (non-escrow income) are allowed
         references: { model: "escrows", key: "escrow_id" },
         onDelete: "RESTRICT",
       },
@@ -48,6 +49,13 @@ module.exports = (sequelize) => {
         allowNull: false,
         defaultValue: "NGN",
       },
+      source: {
+        type: DataTypes.STRING(20),
+        allowNull: false,
+        validate: { isIn: [Object.values(PLATFORM_INCOME_SOURCE)] },
+        comment:
+          "Where this income came from: ESCROW_FEE | SUBSCRIPTION | WITHDRAWAL_FEE",
+      },
     },
     {
       sequelize,

package/models/Product.js

@@ -35,6 +35,11 @@ module.exports = (sequelize) => {
         foreignKey: "product_id",
         as: "stockAdjustments",
       });
+
+      Product.hasMany(models.ProductRating, {
+        foreignKey: "product_id",
+        as: "productRatings",
+      });
     }
   }
 
@@ -139,6 +144,15 @@ module.exports = (sequelize) => {
         allowNull: true,
         comment: "Timestamp of the last revalidation prompt",
       },
+      avg_rating: {
+        type: DataTypes.DECIMAL(3, 2),
+        allowNull: true,
+      },
+      ratings_count: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+      },
     },
     {
       sequelize,

package/models/ProductRating.js

@@ -0,0 +1,54 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+
+module.exports = (sequelize) => {
+  class ProductRating extends Model {
+    static associate(models) {
+      ProductRating.belongsTo(models.Product, {
+        foreignKey: "product_id",
+        as: "product",
+      });
+      ProductRating.belongsTo(models.User, {
+        foreignKey: "buyer_id",
+        as: "buyer",
+      });
+    }
+  }
+
+  ProductRating.init(
+    {
+      product_rating_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      product_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+      },
+      buyer_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+      },
+      rating: {
+        type: DataTypes.TINYINT,
+        allowNull: false,
+      },
+      comment: {
+        type: DataTypes.TEXT,
+        allowNull: true,
+      },
+    },
+    {
+      sequelize,
+      modelName: "ProductRating",
+      tableName: "product_ratings",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  ProductRating.removeAttribute("id");
+  return ProductRating;
+};

package/models/User.js

@@ -115,6 +115,12 @@ module.exports = (sequelize) => {
         foreignKey: "user_id",
         as: "bankAccount",
       });
+
+      // Notification
+      User.hasOne(models.NotificationPreference, {
+        foreignKey: "user_id",
+        as: "notificationPreference",
+      });
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ojamoto_models",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "main": "index.js",
   "scripts": {
     "migrate:up": "npx sequelize-cli db:migrate",

package/services/constants.js

@@ -94,8 +94,9 @@ module.exports = {
   },
 
   PHONE_OTP: {
+    LENGTH: 6,
     MAX_ATTEMPTS: 3,
-    EXPIRY_MINUTES: 5,
+    EXPIRY_MINUTES: 10,
     RESEND_COOLDOWN_SECONDS: 60,
   },
 
@@ -260,6 +261,25 @@ module.exports = {
     OTHER: "OTHER",
   },
 
+  BANK_NAME_MATCH_THRESHOLD: 0.8, // 80%
+
+  NOTIFICATION_PREFERENCE: {
+    PUSH_NOTIFICATION: "PUSH_NOTIFICATION",
+    IN_APP_NOTIFICATION: "IN_APP_NOTIFICATION",
+    EMAIL: "EMAIL",
+    SMS: "SMS",
+  },
+
+  WITHDRAWAL_FEE_FOR_BUYERS: 50,
+
+  PLATFORM_INCOME_SOURCE: {
+    ESCROW_FEE: "ESCROW_FEE",
+    SUBSCRIPTION: "SUBSCRIPTION",
+    WITHDRAWAL_FEE: "WITHDRAWAL_FEE",
+  },
+
+  ////////////////////////////////////////////////////
+
   // - Generic status IDs (legacy support) ──────────────────────────────────
   STATUS_ID: {
     ACTIVE: 1,