@cowris/paymentdb-client 1.0.6 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cowris/paymentdb-client",
-  "version": "1.0.6",
+  "version": "2.0.0",
   "description": "This is a Prisma  Client package for the Cowris PaymentDB. It provides a simple interface to interact with the Payment database, allowing you to perform CRUD operations on payment and transaction data and related tables.",
   "main": "index.js",
   "private": false,
@@ -23,16 +23,19 @@
   },
   "homepage": "https://github.com/Cowristech/services-paymentdb#readme",
   "dependencies": {
-    "@prisma/client": "^6.6.0",
-    "dotenv": "^16.4.7",
+    "@prisma/adapter-pg": "^7.2.0",
+    "dotenv": "^16.6.1",
+    "pg": "^8.16.3",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "prisma": "^6.6.0"
+    "@types/node": "^25.0.3",
+    "@types/pg": "^8.16.0",
+    "prisma": "^7.2.0"
   },
   "peerDependencies": {
-    "@prisma/client": "^6.6.0",
-    "prisma": "^6.6.0"
+    "@prisma/client": "^7.2.0",
+    "prisma": ""
   },
   "files": [
     "index.js",

package/prisma/schema/currency.prisma

@@ -1,12 +1,16 @@
 model Currency {
-    id         String   @id @default(uuid())
-    name       String   @unique
-    symbol     String
-    code       String?
-    country    String
-    created_at DateTime @default(now())
-    updated_at DateTime @updatedAt
+  id        String   @id @default(uuid())
+  name      String
+  code      String   @unique // NGN, USD, EUR
+  symbol    String   // ₦, $, €
+  country   String
 
-    payment_providers GlobalPaymentProvider[]
-    accounts PaymentAccount[]
+  minor_unit       String   // kobo, cent, e.t.c
+  minor_unit_factor Int      
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+
+  payment_providers GlobalPaymentProvider[]
+  accounts          PaymentAccount[]
 }

package/prisma/schema/funding.prisma

@@ -13,8 +13,9 @@ model Funding {
     id                            String  @id @default(uuid())
     transaction_id                String  @unique
     account_id                    String
+    managed_wallet_id             String?
     status                        String
-    amount                        String
+    amount                        Int
     source_currency_id            String?
     destination_currency_id       String
     sender_account_information_id String? @unique

package/prisma/schema/hold.prisma

@@ -0,0 +1,39 @@
+model Hold {
+    id String @id @default(uuid())
+
+    account_id        String
+    managed_wallet_id String?
+    amount            Int // kobo
+    currency_id       String
+
+    reference String     @unique
+    reason    HoldReason
+
+    status     HoldStatus
+    expires_at DateTime
+
+    // linkage
+    transfer_id       String? // internal transfer
+    payment_intent_id String?
+    webhookEventId    String?
+
+    created_at DateTime @default(now())
+    updated_at DateTime @updatedAt
+
+    @@index([account_id])
+    @@index([status])
+    @@index([expires_at])
+}
+
+enum HoldStatus {
+    ACTIVE
+    CONSUMED
+    RELEASED
+    EXPIRED
+}
+
+enum HoldReason {
+    TRANSFER
+    WITHDRAWAL
+    REVERSAL
+}

package/prisma/schema/managedWallet.prisma

@@ -7,7 +7,8 @@ model ManagedWallet {
     wallet_customer_phone      String?
     account_number             String?
     email                      String?
-    balance                    String  @default("0.00")
+    total_balance              Int     @default(0) // based on currency's smallest unit
+    available_balance          Int     @default(0) // based on currency's smallest unit
     currency_id                String
     global_payment_provider_id String
     type                       String

package/prisma/schema/migrations/20251029145728_remove_unnecessary_unique_constraint/migration.sql

@@ -0,0 +1,24 @@
+/*
+  Warnings:
+
+  - A unique constraint covering the columns `[reference_id]` on the table `Transaction` will be added. If there are existing duplicate values, this will fail.
+  - Made the column `reference_id` on table `Transaction` required. This step will fail if there are existing NULL values in that column.
+
+*/
+-- DropIndex
+DROP INDEX "Transfer_destination_currency_id_key";
+
+-- DropIndex
+DROP INDEX "Transfer_source_currency_id_key";
+
+-- DropIndex
+DROP INDEX "Withdrawal_destination_currency_id_key";
+
+-- DropIndex
+DROP INDEX "Withdrawal_source_currency_id_key";
+
+-- AlterTable
+ALTER TABLE "Transaction" ALTER COLUMN "reference_id" SET NOT NULL;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Transaction_reference_id_key" ON "Transaction"("reference_id");

package/prisma/schema/migrations/20251231010424_init/migration.sql

@@ -0,0 +1,99 @@
+/*
+  Warnings:
+
+  - You are about to drop the `Currency` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Funding` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `GlobalPaymentProvider` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `ManagedWallet` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Otp` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `PaymentAccount` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Reversal` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `SenderAccountInformation` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Transaction` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Transfer` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `TransferDestinationAccountDetails` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Withdrawal` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `WithdrawalDestinationAccountDetails` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `_CurrencyToGlobalPaymentProvider` table. If the table is not empty, all the data it contains will be lost.
+
+*/
+-- DropForeignKey
+ALTER TABLE "Funding" DROP CONSTRAINT "Funding_sender_account_information_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "ManagedWallet" DROP CONSTRAINT "ManagedWallet_account_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "PaymentAccount" DROP CONSTRAINT "PaymentAccount_currency_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_account_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_funding_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_provider_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_reversal_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_transfer_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transaction" DROP CONSTRAINT "Transaction_withdrawal_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Transfer" DROP CONSTRAINT "Transfer_destination_account_details_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Withdrawal" DROP CONSTRAINT "Withdrawal_destination_account_details_id_fkey";
+
+-- DropForeignKey
+ALTER TABLE "_CurrencyToGlobalPaymentProvider" DROP CONSTRAINT "_CurrencyToGlobalPaymentProvider_A_fkey";
+
+-- DropForeignKey
+ALTER TABLE "_CurrencyToGlobalPaymentProvider" DROP CONSTRAINT "_CurrencyToGlobalPaymentProvider_B_fkey";
+
+-- DropTable
+DROP TABLE "Currency";
+
+-- DropTable
+DROP TABLE "Funding";
+
+-- DropTable
+DROP TABLE "GlobalPaymentProvider";
+
+-- DropTable
+DROP TABLE "ManagedWallet";
+
+-- DropTable
+DROP TABLE "Otp";
+
+-- DropTable
+DROP TABLE "PaymentAccount";
+
+-- DropTable
+DROP TABLE "Reversal";
+
+-- DropTable
+DROP TABLE "SenderAccountInformation";
+
+-- DropTable
+DROP TABLE "Transaction";
+
+-- DropTable
+DROP TABLE "Transfer";
+
+-- DropTable
+DROP TABLE "TransferDestinationAccountDetails";
+
+-- DropTable
+DROP TABLE "Withdrawal";
+
+-- DropTable
+DROP TABLE "WithdrawalDestinationAccountDetails";
+
+-- DropTable
+DROP TABLE "_CurrencyToGlobalPaymentProvider";

package/prisma/schema/paymentIntent.prisma

@@ -0,0 +1,26 @@
+model PaymentIntent {
+    id                         String              @id @default(uuid())
+    reference                  String              @unique
+    account_id                 String
+    managed_wallet_id          String?
+    amount                     Int // amount in kobo
+    currency_id                String // NGN, USD, etc
+    global_payment_provider_id String
+    provider_intent_id         String?
+    status                     PaymentIntentStatus
+    metadata                   Json?
+    created_at                 DateTime            @default(now())
+    updated_at                 DateTime            @updatedAt
+
+    webhook_events WebhookEvent[]
+
+    @@index([account_id])
+    @@index([reference])
+}
+
+enum PaymentIntentStatus {
+    PENDING
+    SUCCEEDED
+    FAILED
+    CANCELLED
+}

package/prisma/schema/schema.prisma

@@ -5,5 +5,4 @@ generator client {
 
 datasource db {
   provider = "postgresql"
-  url      = env("PAYMENT_DATABASE_URL")
 }

package/prisma/schema/transfer.prisma

@@ -14,8 +14,8 @@ model Transfer {
     from_account_id                String
     to_account_id                  String?
     destination_account_details_id String? @unique
-    source_currency_id             String  @unique
-    destination_currency_id        String  @unique
+    source_currency_id             String
+    destination_currency_id        String
     amount_in_source_currency      String
     amount_in_destination_currency String
     status                         String

package/prisma/schema/webhookEvent.prisma

@@ -0,0 +1,29 @@
+model WebhookEvent {
+    id              String    @id @default(uuid())
+    provider_id     String
+    event_type      EventType
+    reference       String    @unique
+    provider_event_id String? // Paystack transaction ID
+    payload         Json
+    verified        Boolean   @default(false)
+    processed       Boolean   @default(false)
+    received_at      DateTime  @default(now())
+    processed_at     DateTime?
+
+    payment_intent_id String?
+    paymentIntent   PaymentIntent? @relation(fields: [payment_intent_id], references: [id])
+
+    @@index([reference])
+    @@index([processed])
+}
+
+enum EventType {
+    FUNDING_SUCCESS
+    FUNDING_FAILED
+    WITHDRAWAL_SUCCESS
+    WITHDRAWAL_FAILED
+    REVERSAL_SUCCESS
+    REVERSAL_FAILED
+    TRANSFER_SUCCESS
+    TRANSFER_FAILED
+}

package/prisma/schema/withdrawal.prisma

@@ -16,8 +16,8 @@ model Withdrawal {
     status                    String
 
     destination_account_details_id String? @unique
-    source_currency_id             String  @unique
-    destination_currency_id        String  @unique
+    source_currency_id             String  
+    destination_currency_id        String  
     amount_in_destination_currency String
 
     transaction                 Transaction?

package/prisma/generated/paymentdb/client.d.ts

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

package/prisma/generated/paymentdb/client.js

@@ -1,4 +0,0 @@
-
-/* !!! This is code generated by Prisma. Do not edit directly. !!!
-/* eslint-disable */
-module.exports = { ...require('.') }

package/prisma/generated/paymentdb/default.d.ts

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

package/prisma/generated/paymentdb/default.js

@@ -1,4 +0,0 @@
-
-/* !!! This is code generated by Prisma. Do not edit directly. !!!
-/* eslint-disable */
-module.exports = { ...require('.') }

package/prisma/generated/paymentdb/edge.d.ts

@@ -1 +0,0 @@
-export * from "./default"