vr-migrations 1.0.2

package/dist/migrations/006-create-device-payment-plans.js

@@ -0,0 +1,115 @@
+"use strict";
+
+/** @type {import('sequelize').QueryInterface} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("device_payment_plans", {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false
+      },
+      deviceId: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        unique: true,
+        references: {
+          model: "devices",
+          key: "id"
+        },
+        onUpdate: "CASCADE",
+        onDelete: "CASCADE"
+      },
+      userId: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        references: {
+          model: "users",
+          key: "id"
+        },
+        onUpdate: "CASCADE",
+        onDelete: "CASCADE"
+      },
+      pricingSnapshot: {
+        type: Sequelize.JSONB,
+        allowNull: false
+      },
+      totalAmount: {
+        type: Sequelize.FLOAT,
+        allowNull: false
+      },
+      downPayment: {
+        type: Sequelize.FLOAT,
+        allowNull: false
+      },
+      installmentAmount: {
+        type: Sequelize.FLOAT,
+        allowNull: false
+      },
+      installmentFrequency: {
+        type: Sequelize.ENUM("DAILY", "WEEKLY", "MONTHLY"),
+        allowNull: false,
+        defaultValue: "WEEKLY"
+      },
+      paidAmount: {
+        type: Sequelize.FLOAT,
+        allowNull: false,
+        defaultValue: 0
+      },
+      outstandingAmount: {
+        type: Sequelize.FLOAT,
+        allowNull: false
+      },
+      lastPaymentAt: {
+        type: Sequelize.DATE,
+        allowNull: true
+      },
+      nextInstallmentDueAt: {
+        type: Sequelize.DATE,
+        allowNull: true
+      },
+      gracePeriodDays: {
+        type: Sequelize.INTEGER,
+        allowNull: false,
+        defaultValue: 2
+      },
+      autoLockOnMiss: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: true
+      },
+      status: {
+        type: Sequelize.ENUM("ACTIVE", "COMPLETED", "DEFAULTED", "CANCELLED"),
+        allowNull: false,
+        defaultValue: "ACTIVE"
+      },
+      completedAt: {
+        type: Sequelize.DATE,
+        allowNull: true
+      },
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn("NOW")
+      },
+      updatedAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn("NOW")
+      }
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("device_payment_plans");
+
+    // Remove the enums
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_device_payment_plans_status"'
+    );
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_device_payment_plans_installmentFrequency"'
+    );
+  }
+};

package/dist/migrations/007-create-idempotency-records.js

@@ -0,0 +1,61 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("idempotency_records", {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false
+      },
+      key: {
+        type: Sequelize.STRING(128),
+        allowNull: false,
+        unique: true
+      },
+      requestMethod: {
+        type: Sequelize.STRING(10),
+        allowNull: false
+      },
+      requestPath: {
+        type: Sequelize.STRING(255),
+        allowNull: false
+      },
+      requestParams: {
+        type: Sequelize.JSONB,
+        allowNull: true
+      },
+      responseStatusCode: {
+        type: Sequelize.INTEGER,
+        allowNull: true
+      },
+      responseBody: {
+        type: Sequelize.JSONB,
+        allowNull: true
+      },
+      createdAt: {
+        allowNull: false,
+        type: Sequelize.DATE,
+        defaultValue: Sequelize.literal("CURRENT_TIMESTAMP")
+      },
+      expiresAt: {
+        allowNull: false,
+        type: Sequelize.DATE
+      }
+    });
+
+    // Indexes
+    await queryInterface.addIndex("idempotency_records", ["key"], {
+      unique: true
+    });
+    await queryInterface.addIndex("idempotency_records", ["expiresAt"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("idempotency_records");
+    await queryInterface.sequelize.query(
+      "DROP TYPE IF EXISTS enum_idempotency_keys_request_method"
+    );
+  }
+};

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

@@ -0,0 +1,106 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("payments", {
+      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"
+      },
+
+      devicePaymentPlanId: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        references: {
+          model: "device_payment_plans",
+          key: "id"
+        },
+        onUpdate: "CASCADE",
+        onDelete: "RESTRICT"
+      },
+
+      transactionId: {
+        type: Sequelize.UUID,
+        allowNull: true
+      },
+
+      idempotencyKeyId: {
+        type: Sequelize.UUID,
+        allowNull: true,
+        references: {
+          model: "idempotency_records",
+          key: "id"
+        },
+        onUpdate: "CASCADE",
+        onDelete: "SET NULL"
+      },
+
+      amount: {
+        type: Sequelize.FLOAT,
+        allowNull: false
+      },
+
+      provider: {
+        type: Sequelize.ENUM("mtn_momo", "airtel_money"),
+        allowNull: false
+      },
+
+      providerReference: {
+        type: Sequelize.STRING,
+        allowNull: true
+      },
+
+      status: {
+        type: Sequelize.ENUM("pending", "succeeded", "failed"),
+        allowNull: false,
+        defaultValue: "pending"
+      },
+
+      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("payments", ["userId"]);
+    await queryInterface.addIndex("payments", ["devicePaymentPlanId"]);
+    await queryInterface.addIndex("payments", ["status"]);
+    await queryInterface.addIndex("payments", ["provider"]);
+  },
+
+  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-transactions.js

@@ -0,0 +1,80 @@
+"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";'
+    );
+  }
+};

package/dist/migrations/010-create-eventLogs.js

@@ -0,0 +1,117 @@
+"use strict";
+
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable("event_logs", {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false
+      },
+
+      actorType: {
+        type: Sequelize.ENUM("USER", "SYSTEM"),
+        allowNull: false
+      },
+
+      actorId: {
+        type: Sequelize.UUID,
+        allowNull: true
+      },
+
+      action: {
+        type: Sequelize.ENUM(
+          "USER_READ",
+          "USER_UPDATED",
+          "USERS_LISTED",
+          "USER_LOGGED_IN",
+          "ADMIN_FORGOT_PASSWORD",
+          "ADMIN_LOGGED_IN",
+          "ADMIN_LOGGED_OUT",
+          "PASSENGER_ACCOUNT_DEACTIVATED",
+          "PASSENGER_ACCOUNT_DELETED",
+          "AGENT_CREATED_RIDER",
+          "AGENT_UPDATED_RIDER",
+          "ADMIN_CREATED_USER",
+          "ADMIN_UPDATED_USER",
+
+          "PRODUCT_CREATED",
+          "PRODUCT_READ",
+          "PRODUCT_UPDATED",
+          "PRODUCT_DELETED",
+          "PRODUCTS_LISTED",
+
+          "DEVICE_ASSIGNED",
+          "DEVICE_READ",
+          "DEVICE_UPDATED",
+          "DEVICES_LISTED",
+          "DEVICE_REPOSSESSED",
+
+          "DEVICE_PAYMENT_PLAN_CREATED",
+          "DEVICE_PAYMENT_PLAN_READ",
+          "DEVICE_PAYMENT_PLAN_UPDATED",
+          "DEVICE_PAYMENT_DEFAULT_MARKED",
+
+          "PAYMENT_CREATED",
+          "PAYMENT_READ",
+          "PAYMENTS_LISTED",
+
+          "TRANSACTION_READ",
+          "TRANSACTIONS_LISTED",
+
+          "EVENT_LOG_READ",
+          "EVENT_LOGS_LISTED",
+
+          "SECURITY_CLEARANCE_MANAGED",
+          "DEVICE_LOCK_OVERRIDDEN"
+        ),
+        allowNull: false
+      },
+
+      entity: {
+        type: Sequelize.STRING(100),
+        allowNull: false
+      },
+
+      entityId: {
+        type: Sequelize.UUID,
+        allowNull: true
+      },
+
+      metadata: {
+        type: Sequelize.JSONB,
+        allowNull: false,
+        defaultValue: {}
+      },
+
+      ipAddress: {
+        type: Sequelize.STRING(45),
+        allowNull: true
+      },
+
+      userAgent: {
+        type: Sequelize.TEXT,
+        allowNull: true
+      },
+
+      createdAt: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.literal("NOW()")
+      }
+    });
+
+    // Indexes for performance
+    await queryInterface.addIndex("event_logs", ["actorType", "actorId"]);
+    await queryInterface.addIndex("event_logs", ["entity", "entityId"]);
+    await queryInterface.addIndex("event_logs", ["createdAt"]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable("event_logs");
+    await queryInterface.sequelize.query(
+      'DROP TYPE IF EXISTS "enum_event_logs_actorType";'
+    );
+  }
+};

package/dist/migrations/index.js

@@ -0,0 +1 @@
+export * from "../migrations/index.js";

package/dist/migrations/index.ts

@@ -0,0 +1 @@
+// This file exists to enable proper exports

package/dist/reset.d.ts

@@ -0,0 +1 @@
+export declare function reset(): Promise<void>;

package/dist/reset.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reset = reset;
+const db_js_1 = require("./db.js");
+async function reset() {
+    const sequelize = (0, db_js_1.getSequelize)();
+    await sequelize.drop();
+    console.log("⚠️  CENTRALIZED database reset completed");
+}

package/dist/rollback.d.ts

@@ -0,0 +1 @@
+export declare function rollback(steps?: number | "all"): Promise<void>;

package/dist/rollback.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rollback = rollback;
+const umzug_1 = require("umzug");
+const db_1 = require("./db");
+const sequelize_1 = require("sequelize");
+const path_1 = __importDefault(require("path"));
+// const migrationsPath = path.join(__dirname, "../migrations/[0-9]*-*.js");
+const migrationsPath = path_1.default.join(__dirname, "migrations/[0-9]*-*.js");
+async function rollback(steps = 1) {
+    const sequelize = (0, db_1.getSequelize)();
+    const migrator = new umzug_1.Umzug({
+        migrations: {
+            glob: migrationsPath,
+            resolve: ({ name, path: filePath }) => ({
+                name,
+                up: async () => {
+                    const migration = require(filePath);
+                    return migration.up(sequelize.getQueryInterface(), sequelize_1.Sequelize);
+                },
+                down: async () => {
+                    const migration = require(filePath);
+                    return migration.down(sequelize.getQueryInterface());
+                },
+            }),
+        },
+        storage: new umzug_1.SequelizeStorage({ sequelize }),
+        logger: console,
+    });
+    if (steps === "all") {
+        await migrator.down({ to: 0 });
+    }
+    else {
+        await migrator.down({ step: steps });
+    }
+    console.log("✅ Rollback completed");
+}

package/dist/seed.d.ts

@@ -0,0 +1 @@
+export declare function seed(): Promise<void>;

package/dist/seed.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seed = seed;
+const umzug_1 = require("umzug");
+const db_1 = require("./db");
+const sequelize_1 = require("sequelize");
+const path_1 = __importDefault(require("path"));
+// const seedersPath = path.join(__dirname, "../seeders/[0-9]*-*.js");
+const seedersPath = path_1.default.join(__dirname, "seeders/[0-9]*-*.js");
+async function seed() {
+    const sequelize = (0, db_1.getSequelize)();
+    const seeder = new umzug_1.Umzug({
+        migrations: {
+            glob: seedersPath,
+            resolve: ({ name, path: filePath }) => ({
+                name,
+                up: async () => {
+                    const migration = require(filePath);
+                    return migration.up(sequelize.getQueryInterface(), sequelize_1.Sequelize);
+                },
+                down: async () => {
+                    const migration = require(filePath);
+                    return migration.down(sequelize.getQueryInterface());
+                },
+            }),
+        },
+        storage: new umzug_1.SequelizeStorage({
+            sequelize,
+            modelName: "SequelizeSeedMeta",
+        }),
+        logger: console,
+    });
+    await seeder.up();
+    console.log("✅ Seeding completed");
+}

package/dist/seeders/001-security-clearance-demo.js

@@ -0,0 +1,116 @@
+"use strict";
+
+const ALL_PERMISSIONS = [
+  // Users
+  "READ_USER",
+  "UPDATE_USER",
+  "LIST_USERS",
+
+  // Products
+  "CREATE_PRODUCT",
+  "READ_PRODUCT",
+  "UPDATE_PRODUCT",
+  "DELETE_PRODUCT",
+  "LIST_PRODUCTS",
+
+  // Devices
+  "ASSIGN_DEVICE",
+  "READ_DEVICE",
+  "UPDATE_DEVICE",
+  "LIST_DEVICES",
+  "REPOSSESS_DEVICE",
+
+  // Device Payment Plans
+  "CREATE_DEVICE_PAYMENT_PLAN",
+  "READ_DEVICE_PAYMENT_PLAN",
+  "UPDATE_DEVICE_PAYMENT_PLAN",
+  "MARK_PAYMENT_DEFAULT",
+
+  // Payments
+  "CREATE_PAYMENT",
+  "READ_PAYMENT",
+  "LIST_PAYMENTS",
+
+  // Transactions
+  "READ_TRANSACTION",
+  "LIST_TRANSACTIONS",
+
+  // Logs
+  "READ_EVENT_LOG",
+  "LIST_EVENT_LOGS",
+
+  // System / Overrides
+  "MANAGE_SECURITY_CLEARANCE",
+  "OVERRIDE_DEVICE_LOCK"
+];
+
+module.exports = {
+  async up(queryInterface) {
+    const now = new Date();
+
+    await queryInterface.bulkInsert("security_clearances", [
+      {
+        id: "11111111-1111-1111-1111-111111111111",
+        role: "RIDER",
+        description: "Default rider clearance",
+        level: 1,
+        permissions: ALL_PERMISSIONS,
+        isDefault: true,
+        createdAt: now,
+        updatedAt: now
+      },
+      {
+        id: "22222222-2222-2222-2222-222222222222",
+        role: "PASSENGER",
+        description: "Default rider clearance",
+        level: 1,
+        permissions: ALL_PERMISSIONS,
+        isDefault: true,
+        createdAt: now,
+        updatedAt: now
+      },
+      {
+        id: "33333333-3333-3333-3333-333333333333",
+        role: "AGENT",
+        description: "Agent clearance",
+        level: 3,
+        permissions: ALL_PERMISSIONS,
+        isDefault: false,
+        createdAt: now,
+        updatedAt: now
+      },
+      {
+        id: "44444444-4444-4444-4444-444444444444",
+        role: "ADMIN",
+        description: "Admin clearance",
+        level: 7,
+        permissions: ALL_PERMISSIONS,
+        isDefault: false,
+        createdAt: now,
+        updatedAt: now
+      },
+      {
+        id: "55555555-5555-5555-5555-555555555555",
+        role: "SUPER_ADMIN",
+        description: "Super admin clearance",
+        level: 10,
+        permissions: ALL_PERMISSIONS,
+        isDefault: false,
+        createdAt: now,
+        updatedAt: now
+      }
+    ]);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.bulkDelete("securityClearances", {
+      id: [
+        "11111111-1111-1111-1111-111111111111",
+        "22222222-2222-2222-2222-222222222222",
+        "33333333-3333-3333-3333-333333333333",
+        "44444444-4444-4444-4444-444444444444",
+        "55555555-5555-5555-5555-555555555555"
+      ]
+    });
+  }
+};