vr-migrations 1.0.39 → 1.0.40

package/dist/migrations/008-create-payments.js

@@ -1,5 +1,7 @@
+// src/database/migrations/XXXXXXXXXXXXXX-create-payments-table.js
 "use strict";
 
+/** @type {import('sequelize-cli').Migration} */
 module.exports = {
   async up(queryInterface, Sequelize) {
     await queryInterface.createTable("payments", {
@@ -9,7 +11,6 @@ module.exports = {
         primaryKey: true,
         allowNull: false,
       },
-
       userId: {
         type: Sequelize.UUID,
         allowNull: false,
@@ -20,23 +21,26 @@ module.exports = {
         onUpdate: "CASCADE",
         onDelete: "RESTRICT",
       },
-
       devicePaymentPlanId: {
         type: Sequelize.UUID,
-        allowNull: false,
+        allowNull: true,
         references: {
           model: "device_payment_plans",
           key: "id",
         },
         onUpdate: "CASCADE",
-        onDelete: "RESTRICT",
+        onDelete: "SET NULL",
       },
-
-      transactionId: {
+      installmentId: {
         type: Sequelize.UUID,
         allowNull: true,
+        references: {
+          model: "installments",
+          key: "id",
+        },
+        onUpdate: "CASCADE",
+        onDelete: "SET NULL",
       },
-
       idempotencyKeyId: {
         type: Sequelize.UUID,
         allowNull: true,
@@ -47,60 +51,92 @@ module.exports = {
         onUpdate: "CASCADE",
         onDelete: "SET NULL",
       },
-
       amount: {
-        type: Sequelize.FLOAT,
+        type: Sequelize.DECIMAL(10, 2),
         allowNull: false,
       },
-
+      currency: {
+        type: Sequelize.STRING(3),
+        allowNull: false,
+        defaultValue: "RWF",
+      },
       provider: {
-        type: Sequelize.ENUM("mtn_momo", "airtel_money"),
+        type: Sequelize.ENUM("MTN_MOMO", "AIRTEL_MONEY", "DPO", "FLUTTERWAVE"),
         allowNull: false,
       },
-
       providerReference: {
-        type: Sequelize.STRING,
+        type: Sequelize.STRING(255),
         allowNull: true,
       },
-
       status: {
-        type: Sequelize.ENUM("PENDING", "SUCCESSFUL", "FAILED"),
+        type: Sequelize.ENUM("PENDING", "SUCCESSFUL", "FAILED", "REFUNDED"),
         allowNull: false,
         defaultValue: "PENDING",
       },
-
+      customerPhone: {
+        type: Sequelize.STRING(20),
+        allowNull: false,
+      },
+      customerName: {
+        type: Sequelize.STRING(100),
+        allowNull: true,
+      },
+      failureReason: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+      },
       metadata: {
         type: Sequelize.JSONB,
         allowNull: false,
         defaultValue: {},
       },
-
+      settledAt: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
       createdAt: {
         type: Sequelize.DATE,
         allowNull: false,
-        defaultValue: Sequelize.fn("NOW"),
+        defaultValue: Sequelize.NOW,
       },
-
       updatedAt: {
         type: Sequelize.DATE,
         allowNull: false,
-        defaultValue: Sequelize.fn("NOW"),
+        defaultValue: Sequelize.NOW,
       },
     });
 
-    await queryInterface.addIndex("payments", ["userId"]);
-    await queryInterface.addIndex("payments", ["devicePaymentPlanId"]);
-    await queryInterface.addIndex("payments", ["status"]);
-    await queryInterface.addIndex("payments", ["provider"]);
+    // Add indexes
+    await queryInterface.addIndex("payments", ["userId"], {
+      name: "payment_user_idx",
+    });
+    await queryInterface.addIndex("payments", ["devicePaymentPlanId"], {
+      name: "payment_plan_idx",
+    });
+    await queryInterface.addIndex("payments", ["installmentId"], {
+      name: "payment_installment_idx",
+    });
+    await queryInterface.addIndex("payments", ["status"], {
+      name: "payment_status_idx",
+    });
+    await queryInterface.addIndex("payments", ["providerReference"], {
+      name: "payment_provider_ref_idx",
+    });
+    await queryInterface.addIndex("payments", ["createdAt"], {
+      name: "payment_created_at_idx",
+    });
+
+    // Add constraint: exactly one of devicePaymentPlanId or installmentId must be non-null
+    // This is handled in the model validation, but can also be added as a CHECK constraint
+    await queryInterface.sequelize.query(`
+      ALTER TABLE "payments" ADD CONSTRAINT "payments_target_check" 
+      CHECK (
+        (("devicePaymentPlanId" IS NOT NULL)::int + ("installmentId" IS NOT NULL)::int) = 1
+      );
+    `);
   },
 
   async down(queryInterface) {
     await queryInterface.dropTable("payments");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_payments_provider";'
-    );
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_payments_status";'
-    );
   },
 };

package/dist/migrations/009-create-payment-event-logs.js

@@ -0,0 +1,123 @@
+// src/database/migrations/XXXXXXXXXXXXXX-create-payment-event-logs-table.js
+"use strict";
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("payment_event_logs", {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false,
+      },
+      paymentId: {
+        type: Sequelize.UUID,
+        allowNull: true,
+        references: {
+          model: "payments",
+          key: "id",
+        },
+        onUpdate: "CASCADE",
+        onDelete: "SET NULL",
+      },
+      provider: {
+        type: Sequelize.STRING(50),
+        allowNull: false,
+      },
+      direction: {
+        type: Sequelize.ENUM("OUTGOING_REQUEST", "INCOMING_WEBHOOK"),
+        allowNull: false,
+      },
+      action: {
+        type: Sequelize.STRING(50),
+        allowNull: false,
+      },
+      externalId: {
+        type: Sequelize.STRING(255),
+        allowNull: true,
+      },
+      requestPayload: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+      },
+      responsePayload: {
+        type: Sequelize.JSONB,
+        allowNull: true,
+      },
+      statusCode: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+      },
+      status: {
+        type: Sequelize.ENUM("PENDING", "SUCCESS", "FAILED", "RETRIED"),
+        allowNull: false,
+        defaultValue: "PENDING",
+      },
+      error: {
+        type: Sequelize.TEXT,
+        allowNull: true,
+      },
+      durationMs: {
+        type: Sequelize.INTEGER,
+        allowNull: true,
+      },
+      retryCount: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 0,
+      },
+      nextRetryAt: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      processedAt: {
+        type: Sequelize.DATE,
+        allowNull: true,
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.NOW,
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.NOW,
+      },
+    });
+
+    // Add indexes
+    await queryInterface.addIndex("payment_event_logs", ["paymentId"], {
+      name: "payment_event_payment_idx",
+    });
+    await queryInterface.addIndex(
+      "payment_event_logs",
+      ["provider", "externalId"],
+      {
+        name: "payment_event_provider_external_idx",
+      }
+    );
+    await queryInterface.addIndex(
+      "payment_event_logs",
+      ["status", "nextRetryAt"],
+      {
+        name: "payment_event_retry_idx",
+      }
+    );
+    await queryInterface.addIndex("payment_event_logs", ["createdAt"], {
+      name: "payment_event_created_at_idx",
+    });
+    await queryInterface.addIndex(
+      "payment_event_logs",
+      ["direction", "action"],
+      {
+        name: "payment_event_direction_action_idx",
+      }
+    );
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("payment_event_logs");
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vr-migrations",
-  "version": "1.0.39",
+  "version": "1.0.40",
   "description": "Database migration and seeding package for VR applications",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/migrations/009-create-transactions.js

@@ -1,80 +0,0 @@
-"use strict";
-
-module.exports = {
-  async up(queryInterface, Sequelize) {
-    await queryInterface.createTable("transactions", {
-      id: {
-        type: Sequelize.UUID,
-        defaultValue: Sequelize.UUIDV4,
-        primaryKey: true,
-        allowNull: false
-      },
-
-      userId: {
-        type: Sequelize.UUID,
-        allowNull: false,
-        references: {
-          model: "users",
-          key: "id"
-        },
-        onUpdate: "CASCADE",
-        onDelete: "RESTRICT"
-      },
-
-      paymentId: {
-        type: Sequelize.UUID,
-        allowNull: false,
-        references: {
-          model: "payments",
-          key: "id"
-        },
-        onUpdate: "CASCADE",
-        onDelete: "RESTRICT"
-      },
-
-      amount: {
-        type: Sequelize.FLOAT,
-        allowNull: false
-      },
-
-      status: {
-        type: Sequelize.ENUM("succeeded", "failed"),
-        allowNull: false
-      },
-
-      providerReference: {
-        type: Sequelize.STRING,
-        allowNull: false
-      },
-
-      metadata: {
-        type: Sequelize.JSONB,
-        allowNull: false,
-        defaultValue: {}
-      },
-
-      createdAt: {
-        type: Sequelize.DATE,
-        allowNull: false,
-        defaultValue: Sequelize.fn("NOW")
-      },
-
-      updatedAt: {
-        type: Sequelize.DATE,
-        allowNull: false,
-        defaultValue: Sequelize.fn("NOW")
-      }
-    });
-
-    await queryInterface.addIndex("transactions", ["userId"]);
-    await queryInterface.addIndex("transactions", ["paymentId"]);
-    await queryInterface.addIndex("transactions", ["status"]);
-  },
-
-  async down(queryInterface) {
-    await queryInterface.dropTable("transactions");
-    await queryInterface.sequelize.query(
-      'DROP TYPE IF EXISTS "enum_transactions_status";'
-    );
-  }
-};