ojamoto_models 1.0.13 → 1.0.14

package/migrations/2026000051-create-phone-verification-otps.js

@@ -0,0 +1,47 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("phone_verification_otps", {
+      phone_verification_otp_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",
+      },
+      otp: {
+        type: Sequelize.STRING,
+        allowNull: false,
+        comment: "Hashed before storage",
+      },
+      expires_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      verification_attempts: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+  },
+  async down(queryInterface) {
+    await queryInterface.dropTable("phone_verification_otps");
+  },
+};

package/migrations/2026000052-create-banks.js

@@ -0,0 +1,51 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("banks", {
+      bank_id: {
+        type: Sequelize.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+        allowNull: false,
+      },
+      provider_bank_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        unique: true,
+        comment: "Flutterwave's own bank ID",
+      },
+      bank_name: {
+        type: Sequelize.STRING(150),
+        allowNull: false,
+      },
+      bank_code: {
+        type: Sequelize.STRING(20),
+        allowNull: false,
+        unique: true,
+      },
+      country: {
+        type: Sequelize.STRING(2),
+        allowNull: false,
+        defaultValue: "NG",
+      },
+      is_active: {
+        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("banks");
+  },
+};

package/migrations/2026000053-create-user-bank-accounts.js

@@ -0,0 +1,54 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("user_bank_accounts", {
+      user_bank_account_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",
+        comment: "One verified payout account per user",
+      },
+      bank_id: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        references: { model: "banks", key: "bank_id" },
+        onDelete: "RESTRICT",
+        onUpdate: "CASCADE",
+      },
+      account_number: {
+        type: Sequelize.STRING(20),
+        allowNull: false,
+      },
+      account_name: {
+        type: Sequelize.STRING(150),
+        allowNull: false,
+        comment: "Name returned by the resolve API — used for the match check",
+      },
+      verified_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+      },
+    });
+  },
+  async down(queryInterface) {
+    await queryInterface.dropTable("user_bank_accounts");
+  },
+};

package/models/Bank

@@ -0,0 +1,53 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+
+module.exports = (sequelize) => {
+  class Bank extends Model {
+    static associate() {}
+  }
+
+  Bank.init(
+    {
+      bank_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      provider_bank_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        unique: true,
+      },
+      bank_name: {
+        type: DataTypes.STRING(150),
+        allowNull: false,
+      },
+      bank_code: {
+        type: DataTypes.STRING(20),
+        allowNull: false,
+        unique: true,
+      },
+      country: {
+        type: DataTypes.STRING(2),
+        allowNull: false,
+        defaultValue: "NG",
+      },
+      is_active: {
+        type: DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: true,
+      },
+    },
+    {
+      sequelize,
+      modelName: "Bank",
+      tableName: "banks",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  Bank.removeAttribute("id");
+  return Bank;
+};

package/models/PhoneVerificationOtp.js

@@ -0,0 +1,52 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+
+module.exports = (sequelize) => {
+  class PhoneVerificationOtp extends Model {
+    static associate(models) {
+      PhoneVerificationOtp.belongsTo(models.User, {
+        foreignKey: "user_id",
+        as: "user",
+      });
+    }
+  }
+
+  PhoneVerificationOtp.init(
+    {
+      phone_verification_otp_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      user_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        unique: true,
+      },
+      otp: {
+        type: DataTypes.STRING,
+        allowNull: false,
+      },
+      expires_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+      },
+      verification_attempts: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+      },
+    },
+    {
+      sequelize,
+      modelName: "PhoneVerificationOtp",
+      tableName: "phone_verification_otps",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  PhoneVerificationOtp.removeAttribute("id");
+  return PhoneVerificationOtp;
+};

package/models/SellerProfile.js

@@ -19,6 +19,11 @@ module.exports = (sequelize) => {
         foreignKey: "seller_profile_id",
         as: "badges",
       });
+
+      SellerProfile.hasOne(models.SellerSubscription, {
+        foreignKey: "seller_profile_id",
+        as: "subscription",
+      });
     }
   }
 

package/models/SellerSubscription.js

@@ -0,0 +1,70 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+const {
+  SUBSCRIPTION_BILLING_TYPE,
+  SUBSCRIPTION_STATUS,
+} = require("../services/constants");
+
+module.exports = (sequelize) => {
+  class SellerSubscription extends Model {
+    static associate(models) {
+      SellerSubscription.belongsTo(models.SellerProfile, {
+        foreignKey: "seller_profile_id",
+        as: "sellerProfile",
+      });
+    }
+  }
+
+  SellerSubscription.init(
+    {
+      seller_subscription_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      seller_profile_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        references: { model: "seller_profiles", key: "seller_profile_id" },
+        onDelete: "CASCADE",
+      },
+      tier: {
+        type: DataTypes.STRING(20),
+        allowNull: false,
+      },
+      billing_type: {
+        type: DataTypes.ENUM(...Object.values(SUBSCRIPTION_BILLING_TYPE)),
+        allowNull: false,
+      },
+      status: {
+        type: DataTypes.ENUM(...Object.values(SUBSCRIPTION_STATUS)),
+        allowNull: false,
+        defaultValue: SUBSCRIPTION_STATUS.ACTIVE,
+      },
+      amount_paid: {
+        type: DataTypes.DECIMAL(15, 2),
+        allowNull: false,
+      },
+      next_billing_date: {
+        type: DataTypes.DATE,
+        allowNull: true,
+        comment: "NULL for ONE_TIME — never bills again",
+      },
+      past_due_since: {
+        type: DataTypes.DATE,
+        allowNull: true,
+      },
+    },
+    {
+      sequelize,
+      modelName: "SellerSubscription",
+      tableName: "seller_subscriptions",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  SellerSubscription.removeAttribute("id");
+  return SellerSubscription;
+};

package/models/User.js

@@ -109,6 +109,12 @@ module.exports = (sequelize) => {
         foreignKey: "user_id",
         as: "wishlist",
       });
+
+      // Bank
+      User.hasOne(models.UserBankAccount, {
+        foreignKey: "user_id",
+        as: "bankAccount",
+      });
     }
   }
 

package/models/UserBankAccount.js

@@ -0,0 +1,58 @@
+"use strict";
+const { Model, DataTypes } = require("sequelize");
+
+module.exports = (sequelize) => {
+  class UserBankAccount extends Model {
+    static associate(models) {
+      UserBankAccount.belongsTo(models.User, {
+        foreignKey: "user_id",
+        as: "user",
+      });
+      UserBankAccount.belongsTo(models.Bank, {
+        foreignKey: "bank_id",
+        as: "bank",
+      });
+    }
+  }
+
+  UserBankAccount.init(
+    {
+      user_bank_account_id: {
+        type: DataTypes.INTEGER,
+        primaryKey: true,
+        autoIncrement: true,
+      },
+      user_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+        unique: true,
+      },
+      bank_id: {
+        type: DataTypes.INTEGER,
+        allowNull: false,
+      },
+      account_number: {
+        type: DataTypes.STRING(20),
+        allowNull: false,
+      },
+      account_name: {
+        type: DataTypes.STRING(150),
+        allowNull: false,
+      },
+      verified_at: {
+        type: DataTypes.DATE,
+        allowNull: false,
+      },
+    },
+    {
+      sequelize,
+      modelName: "UserBankAccount",
+      tableName: "user_bank_accounts",
+      timestamps: true,
+      createdAt: "created_at",
+      updatedAt: "updated_at",
+    },
+  );
+
+  return UserBankAccount;
+};

package/package.json

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

package/services/constants.js

@@ -1,14 +1,6 @@
 "use strict";
 
 module.exports = {
-  // - Generic status IDs (legacy support) ──────────────────────────────────
-  STATUS_ID: {
-    ACTIVE: 1,
-    INACTIVE: 2,
-    DELETED: 3,
-    BLOCKED: 4,
-  },
-
   // - users.status ─────────────────────────────────────────────────────────
   USER_STATUS: {
     ACTIVE: "ACTIVE",
@@ -22,6 +14,14 @@ module.exports = {
     SELLER: "SELLER",
   },
 
+  // - addresses.label ───────────────────────────────────────────────────────────
+  ADDRESS_LABEL: {
+    HOME: "HOME",
+    BUSINESS: "BUSINESS",
+    PICKUP: "PICKUP",
+    OTHER: "OTHER",
+  },
+
   // - seller_profiles.user_type ───────────────────────────────────────────────────────────
   SELLER_TYPE: {
     INDIVIDUAL: "INDIVIDUAL",
@@ -36,27 +36,44 @@ module.exports = {
     PREMIUM_SELLER: "PREMIUM_SELLER",
   },
 
-  // - addresses.label ───────────────────────────────────────────────────────────
-  ADDRESS_LABEL: {
-    HOME: "HOME",
-    BUSINESS: "BUSINESS",
-    PICKUP: "PICKUP",
-    OTHER: "OTHER",
+  // - seller_profiles.verification_status ──────────────────────────────────
+  SELLER_VERIFICATION_STATUS: {
+    UNVERIFIED: "UNVERIFIED",
+    VERIFIED: "VERIFIED",
+    SUSPENDED: "SUSPENDED",
   },
 
-  // - admin_users.role ─────────────────────────────────────────────────────
-  ADMIN_ROLE: {
-    SUPPORT_AGENT: "SUPPORT_AGENT",
-    SENIOR_REVIEWER: "SENIOR_REVIEWER",
-    SUPER_ADMIN: "SUPER_ADMIN",
+  // - seller_profiles.tier ─────────────────────────────────────────────────
+  SELLER_TIER: {
+    TIER_1: "TIER_1",
+    TIER_2: "TIER_2",
+    TIER_3: "TIER_3",
   },
 
-  // - admin_users.status ───────────────────────────────────────────────────
-  ADMIN_STATUS: {
+  SELLER_TIER_CONFIG: {
+    TIER_1: { fee_percentage: 0.05, listing_limit: 10, requires_kyc: false },
+    TIER_2: { fee_percentage: 0.045, listing_limit: 100, requires_kyc: true },
+    TIER_3: { fee_percentage: 0.04, listing_limit: null, requires_kyc: true },
+  },
+
+  SELLER_TIER_PRICING: {
+    TIER_2: { one_time: 50000, recurring: 5000 },
+    TIER_3: { one_time: 100000, recurring: 10000 },
+  },
+
+  SUBSCRIPTION_BILLING_TYPE: {
+    ONE_TIME: "ONE_TIME",
+    RECURRING: "RECURRING",
+  },
+
+  SUBSCRIPTION_STATUS: {
     ACTIVE: "ACTIVE",
-    SUSPENDED: "SUSPENDED",
+    PAST_DUE: "PAST_DUE",
+    CANCELLED: "CANCELLED",
   },
 
+  RECURRING_GRACE_PERIOD_DAYS: 3,
+
   // - kyc_verifications.verification_status ────────────────────────────────
   KYC_STATUS: {
     PENDING: "PENDING",
@@ -71,34 +88,17 @@ module.exports = {
     QOREID: "QOREID",
   },
 
-  // - seller_profiles.verification_status ──────────────────────────────────
-  SELLER_VERIFICATION_STATUS: {
-    UNVERIFIED: "UNVERIFIED",
-    VERIFIED: "VERIFIED",
-    SUSPENDED: "SUSPENDED",
-  },
-
-  // Wallet funding fee - passed on to the user at top-up time 0.8%
-  FUNDING_FEE_PERCENTAGE: 0.008,
-
-  // - seller_profiles.tier ─────────────────────────────────────────────────
-  SELLER_TIER: {
-    TIER_1: "TIER_1",
-    TIER_2: "TIER_2",
-    TIER_3: "TIER_3",
-  },
-
-  SELLER_TIER_CONFIG: {
-    TIER_1: { fee_percentage: 0.05, listing_limit: 10, requires_kyc: false },
-    TIER_2: { fee_percentage: 0.045, listing_limit: 100, requires_kyc: true },
-    TIER_3: { fee_percentage: 0.04, listing_limit: null, requires_kyc: true },
-  },
-
   PIN_LOCK: {
     MAX_ATTEMPTS_BEFORE_LOCK: 3,
     LOCK_DURATION_HOURS: 24,
   },
 
+  PHONE_OTP: {
+    MAX_ATTEMPTS: 3,
+    EXPIRY_MINUTES: 5,
+    RESEND_COOLDOWN_SECONDS: 60,
+  },
+
   // - products.condition ───────────────────────────────────────────────────
   PRODUCT_CONDITION: {
     NEW: "NEW",
@@ -114,6 +114,61 @@ module.exports = {
     REMOVED: "REMOVED",
   },
 
+  PRODUCT_CATEGORY: {
+    ENGINE: "ENGINE",
+    TRANSMISSION: "TRANSMISSION",
+    BRAKE_SYSTEM: "BRAKE_SYSTEM",
+    SUSPENSION_STEERING: "SUSPENSION_STEERING",
+    ELECTRICAL_BATTERY: "ELECTRICAL_BATTERY",
+    BODY_PARTS: "BODY_PARTS",
+    EXHAUST_SYSTEM: "EXHAUST_SYSTEM",
+    COOLING_SYSTEM: "COOLING_SYSTEM",
+    FUEL_SYSTEM: "FUEL_SYSTEM",
+    WHEELS_TYRES: "WHEELS_TYRES",
+    INTERIOR_ACCESSORIES: "INTERIOR_ACCESSORIES",
+    EXTERIOR_ACCESSORIES: "EXTERIOR_ACCESSORIES",
+    LIGHTING: "LIGHTING",
+    AC_HEATING: "AC_HEATING",
+    FILTERS: "FILTERS",
+    BELTS_HOSES: "BELTS_HOSES",
+    TOOLS_EQUIPMENT: "TOOLS_EQUIPMENT",
+    OILS_FLUIDS: "OILS_FLUIDS",
+    OTHERS: "OTHERS",
+  },
+
+  PRODUCT_BRAND: {
+    TOYOTA: "TOYOTA",
+    HONDA: "HONDA",
+    LEXUS: "LEXUS",
+    NISSAN: "NISSAN",
+    MERCEDES_BENZ: "MERCEDES_BENZ",
+    BMW: "BMW",
+    FORD: "FORD",
+    HYUNDAI: "HYUNDAI",
+    KIA: "KIA",
+    MAZDA: "MAZDA",
+    MITSUBISHI: "MITSUBISHI",
+    VOLKSWAGEN: "VOLKSWAGEN",
+    PEUGEOT: "PEUGEOT",
+    ACURA: "ACURA",
+    INFINITI: "INFINITI",
+    CHEVROLET: "CHEVROLET",
+    LAND_ROVER: "LAND_ROVER",
+    JEEP: "JEEP",
+    AUDI: "AUDI",
+    VOLVO: "VOLVO",
+    SUZUKI: "SUZUKI",
+    MACK: "MACK",
+    SCANIA: "SCANIA",
+    MAN: "MAN",
+    IVECO: "IVECO",
+    DAF: "DAF",
+    HOWO: "HOWO",
+    BOSCH: "BOSCH",
+    DENSO: "DENSO",
+    OTHERS: "OTHERS",
+  },
+
   // - wallet_transactions.type ─────────────────────────────────────────────
   WALLET_TRANSACTION_TYPE: {
     DEPOSIT: "DEPOSIT",
@@ -131,6 +186,9 @@ module.exports = {
     EXPIRED: "EXPIRED",
   },
 
+  // Wallet funding fee - passed on to the user at top-up time 0.8%
+  FUNDING_FEE_PERCENTAGE: 0.008,
+
   // - escrows.status ───────────────────────────────────────────────────────
   ESCROW_STATUS: {
     PENDING: "PENDING",
@@ -179,6 +237,13 @@ module.exports = {
     DELIVERED: "DELIVERED",
   },
 
+  // TBD
+  LOGISTICS_PROVIDER: {
+    GIG: "GIG",
+    DHL: "DHL",
+    FEDEX: "FedEx",
+  },
+
   // - webhook_logs.status ──────────────────────────────────────────────────
   WEBHOOK_STATUS: {
     ACCEPTED: "ACCEPTED",
@@ -187,10 +252,32 @@ module.exports = {
 
   STOCK_ADJUSTMENT_TYPE: {
     RESTOCK: "RESTOCK",
+    SALE_ONLINE: "SALE_ONLINE",
     SALE_OFFLINE: "SALE_OFFLINE",
     DAMAGE: "DAMAGE",
     CORRECTION: "CORRECTION",
     BULK_UPDATE: "BULK_UPDATE",
     OTHER: "OTHER",
   },
+
+  // - Generic status IDs (legacy support) ──────────────────────────────────
+  STATUS_ID: {
+    ACTIVE: 1,
+    INACTIVE: 2,
+    DELETED: 3,
+    BLOCKED: 4,
+  },
+
+  // - admin_users.role ─────────────────────────────────────────────────────
+  ADMIN_ROLE: {
+    SUPPORT_AGENT: "SUPPORT_AGENT",
+    SENIOR_REVIEWER: "SENIOR_REVIEWER",
+    SUPER_ADMIN: "SUPER_ADMIN",
+  },
+
+  // - admin_users.status ───────────────────────────────────────────────────
+  ADMIN_STATUS: {
+    ACTIVE: "ACTIVE",
+    SUSPENDED: "SUSPENDED",
+  },
 };