@mbanq/core-sdk-js 0.20.0 → 0.22.0

package/README.md

@@ -444,8 +444,242 @@ The SDK uses a Command Pattern for all operations. Commands are created using fa
 
 | Command | Description |
 |---------|-------------|
+| `GetCards` | Retrieve all cards for a specific client |
+| `GetCardById` | Get detailed information about a specific card by ID |
+| `GetCardAuthorizations` | List card authorizations with filtering options (status, pagination, sorting) |
+| `GetCardAuthorizationById` | Retrieve detailed information about a specific card authorization including transaction details, merchant information, and optional associations (notes/media) |
 | `SendAuthorizationToCore` | Send card authorization request to core system |
-| `UpdateCardID` | Update card identification information |
+| `UpdateCardID` | Update client card identification information (URL and QR code) |
+| `GetCards` | Retrieve all cards associated with a specific client |
+| `GetCardById` | Get detailed information for a specific card by ID |
+| `GetCardImageUrl` | Get the URL for a card's visual representation/image |
+| `GetCardAuthorizations` | Retrieve all card authorizations with filtering and pagination |
+| `CreateCard` | Create a new debit or credit card (virtual or physical) |
+| `ChangeCardType` | Change the product type of an existing card |
+| `ActivatePhysicalCard` | Activate a physical card that has been issued |
+| `OrderPhysicalCard` | Request fulfillment/shipment of a physical card |
+| `SetPIN` | Generate a secure URL for card PIN changes |
+| `AddCardToMobileWallet` | Provision a card for Apple Pay or Google Pay |
+| `UpdateCardFeature` | Enable/disable card features (POS, online, ATM, international) |
+| `UpdateCardLimit` | Update card limits and velocity rules (purchase and ATM) |
+
+### Card Operations Usage Examples
+
+#### Card Creation and Management
+
+```javascript
+import { 
+  createInstance, 
+  CreateCard, 
+  GetCards, 
+  GetCardById,
+  ChangeCardType,
+  ActivatePhysicalCard,
+  OrderPhysicalCard
+} from '@mbanq/core-sdk-js';
+
+const client = createInstance({
+  secret: 'your-secret',
+  signee: 'YOUR-SIGNEE',
+  baseUrl: 'https://api.cloud.mbanq.com',
+  tenantId: 'your-tenant-id'
+});
+
+// Create a debit card with existing savings account
+const debitCard = await client.request(CreateCard({
+  productId: 123,
+  savingsAccountId: 456789,
+  clientId: 98765
+}));
+
+// Create a credit card
+const creditCard = await client.request(CreateCard({
+  productId: 124,
+  creditAccountId: 456790,
+  userId: 555
+}));
+
+// Get all cards for a client
+const clientCards = await client.request(GetCards(98765));
+console.log('Client cards:', clientCards);
+
+// Get specific card details
+const cardDetails = await client.request(GetCardById(debitCard.id));
+console.log('Card status:', cardDetails.status);
+
+// Change card product type
+await client.request(ChangeCardType(debitCard.id, { productId: 125 }));
+
+// Order physical card for virtual card
+const physicalCard = await client.request(OrderPhysicalCard(debitCard.id));
+
+// Activate physical card once received
+const activation = await client.request(ActivatePhysicalCard(physicalCard.id));
+console.log('Card token:', activation.cardToken);
+```
+
+#### Card Features and Limits
+
+```javascript
+import { 
+  UpdateCardFeature, 
+  UpdateCardLimit 
+} from '@mbanq/core-sdk-js';
+
+// Update card features
+const features = await client.request(UpdateCardFeature(cardId, {
+  posPaymentEnabled: true,
+  onlinePaymentEnabled: true,
+  atmWithdrawalsEnabled: false,
+  internationalPaymentsEnabled: true,
+  blockedCountries: ['US', 'CA']
+}));
+
+// Update card limits and velocity rules
+const limits = await client.request(UpdateCardLimit(cardId, {
+  purchase: [{
+    single: {
+      transactionAmount: 1000,
+      numberOfTransactions: 5
+    },
+    daily: {
+      transactionAmount: 5000,
+      numberOfTransactions: 20
+    },
+    monthly: {
+      transactionAmount: 15000,
+      numberOfTransactions: 100
+    }
+  }],
+  atm: [{
+    daily: {
+      transactionAmount: 2000,
+      numberOfTransactions: 10
+    },
+    weekly: {
+      transactionAmount: 5000,
+      numberOfTransactions: 25
+    }
+  }]
+}));
+```
+
+#### Mobile Wallet Integration
+
+```javascript
+import { AddCardToMobileWallet } from '@mbanq/core-sdk-js';
+
+// Apple Pay provisioning
+const applePaySetup = await client.request(AddCardToMobileWallet(cardId, {
+  walletProvider: 'APPLE_PAY',
+  certificate1: 'apple-cert-1-data',
+  certificate2: 'apple-cert-2-data',
+  nonce: 'apple-nonce-value'
+}));
+
+// Google Pay provisioning
+const googlePaySetup = await client.request(AddCardToMobileWallet(cardId, {
+  walletProvider: 'GOOGLE_PAY',
+  deviceID: 'android-device-id',
+  walletAccountID: 'google-wallet-account-id'
+}));
+
+console.log('Provisioning data:', applePaySetup.data.activationData);
+```
+
+#### Card Authorization Management
+
+```javascript
+import { 
+  GetCardAuthorizations, 
+  SendAuthorizationToCore,
+  GetCardImageUrl,
+  SetPIN
+} from '@mbanq/core-sdk-js';
+
+// Get card authorizations with filtering
+const authorizations = await client.request(GetCardAuthorizations({
+  cardToken: 'card-uuid-token',
+  status: 'ACTIVE',
+  limit: 50,
+  offset: 0,
+  orderBy: 'createdAt',
+  sortOrder: 'desc',
+  isActiveCardAuthorizations: true
+}));
+
+console.log('Total authorizations:', authorizations.totalFilteredRecords);
+console.log('Recent transactions:', authorizations.pageItems);
+
+// Send authorization to core system
+await client.request(SendAuthorizationToCore({
+  card: { 
+    internalCardId: 'card-123', 
+    cardType: 'DEBIT' 
+  },
+  payload: { 
+    amount: 1000, 
+    currency: 'USD',
+    merchant: 'Merchant Name'
+  },
+  flag: 'AUTH_CAPTURE',
+  skipNotification: false
+}));
+
+// Get card image URL for display
+const { imageUrl } = await client.request(GetCardImageUrl(cardId));
+
+// Generate PIN change URL
+const pinSetup = await client.request(SetPIN(cardId));
+console.log('PIN change URL:', pinSetup.data);
+```
+
+#### Card ID and Visual Updates
+
+```javascript
+import { UpdateCardID } from '@mbanq/core-sdk-js';
+
+// Update card identification with custom branding
+await client.request(UpdateCardID({
+  clientId: 98765,
+  businessCardIDURL: 'https://your-brand.com/card-design.png',
+  businessCardIDQRCode: 'base64-encoded-qr-code-data'
+}));
+```
+
+### Card Types and Features
+
+#### Card Types
+- **Debit Cards**: Linked to savings accounts for spending available balance
+- **Credit Cards**: Linked to credit accounts with revolving credit limits
+- **Virtual Cards**: Digital-only cards for online and mobile payments
+- **Physical Cards**: Physical plastic cards with EMV chip and contactless support
+
+#### Supported Mobile Wallets
+- **Apple Pay**: iPhone, iPad, Apple Watch support
+- **Google Pay**: Android devices and Google Wallet integration
+
+#### Card Features Control
+- **POS Payments**: Enable/disable point-of-sale transactions
+- **Online Payments**: Control e-commerce and online purchases
+- **ATM Withdrawals**: Manage cash withdrawal capabilities
+- **International Payments**: Allow/restrict international transactions
+- **Contactless Payments**: Tap-to-pay functionality
+- **Blocked Countries**: Geographically restrict card usage
+
+#### Velocity Limits and Controls
+- **Single Transaction**: Maximum amount per transaction
+- **Daily Limits**: Total amount and transaction count per day
+- **Weekly Limits**: Total amount and transaction count per week
+- **Monthly Limits**: Total amount and transaction count per month
+- **ATM vs Purchase**: Separate limits for ATM withdrawals vs purchases
+
+#### Authorization Management
+- **Real-time Authorizations**: Process card transactions in real-time
+- **Authorization History**: Track all card transaction attempts
+- **Status Tracking**: Monitor authorization statuses (ACTIVE, COMPLETED, REJECTED, etc.)
+- **Filtering and Search**: Find specific transactions by criteria
+- **Merchant Details**: Complete transaction merchant information
 
 #### Card Product Operations
 

package/dist/chunk-5SFHDAQT.mjs

@@ -0,0 +1 @@
+import{a as u,b as p}from"./chunk-2PLZ534I.mjs";var m=n=>{let s=[];if(!n.baseUrl)s.push("baseUrl is required");else if(typeof n.baseUrl!="string")s.push("baseUrl must be a string");else try{new URL(n.baseUrl)}catch{s.push("baseUrl must be a valid URL")}return n.axiosConfig?.timeout!==void 0&&(typeof n.axiosConfig.timeout!="number"||n.axiosConfig.timeout<0)&&s.push("timeout must be a positive number"),s};import C from"axios";import b from"jsonwebtoken";var w=(n,s)=>{if(!n)throw u({message:"Missing JWT secret",code:"missing_jwt_secret"});return b.sign({signee:s},n,{algorithm:"HS512",expiresIn:"1d"})||""},k=async(n,s,a)=>{let o={method:"POST",url:`${n}/oauth/token`,headers:{"Content-Type":"application/x-www-form-urlencoded",tenantId:s},data:a},{data:{access_token:c}}=await C.request(o);return c};var O=n=>{let s=m(n);if(s.length>0)throw u({message:`Invalid configuration: ${s.join(", ")}`,code:"invalid_config"});let a=n,o={accessToken:"",tokenType:"bearer",authConfig:null},c=async(e,t,r)=>{if(a.middlewares)for(let i of a.middlewares)e==="before"&&i.before?await i.before(t):e==="after"&&i.after?await i.after(t,r):e==="onError"&&i.onError&&await i.onError(t,r)},f=e=>{let t={...e,[o.tokenType==="jwt"?"jwtToken":"bearerToken"]:o.accessToken};return o.authConfig?.tenantId&&(t.tenantId=o.authConfig.tenantId),t},d=(e,t)=>t?{...e,axiosConfig:{...e.axiosConfig,...t.timeout&&{timeout:t.timeout},...t.keepAlive!==void 0&&{keepAlive:t.keepAlive},headers:{...e.axiosConfig?.headers,...t.headers}}}:e,l=async e=>{if(e.credential){let t=e.tenantId||a.tenantId;if(!t)throw u({message:"Tenant ID is required when using credential-based authentication",code:"missing_tenant_id"});return{token:await k(a.baseUrl,t,e.credential),type:"bearer"}}else{if(e.signee&&e.secret)return{token:w(e.secret,e.signee||""),type:"jwt"};if(e.bearerToken)return{token:e.bearerToken,type:"bearer"};if(e.jwtToken)return{token:e.jwtToken,type:"jwt"};throw u({message:"No valid authentication method provided in config",code:"missing_authentication"})}};return{connect:async e=>{let{token:t,type:r}=await l(e);o.accessToken=t,o.tokenType=r,o.authConfig=e},request:async(e,t)=>{try{if(await c("before",e),!o.accessToken)throw u({message:"No authentication token found. Please await instance.connect() first.",code:"missing_authentication"});let r=d(a,t);r=f(r);try{let i=await e.execute(r);return await c("after",e,i),i}catch(i){if(p(i)&&i.statusCode===401&&o.authConfig){let{token:T,type:h}=await l(o.authConfig);o.accessToken=T,o.tokenType=h,r=d(a,t),r=f(r);let g=await e.execute(r);return await c("after",e,g),g}else throw await c("onError",e,i),i}}catch(r){throw await c("onError",e,r),r}}}};export{O as a};

package/dist/chunk-ARR7PVSU.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunk6M772WIBjs = require('./chunk-6M772WIB.js');var m=n=>{let s=[];if(!n.baseUrl)s.push("baseUrl is required");else if(typeof n.baseUrl!="string")s.push("baseUrl must be a string");else try{new URL(n.baseUrl)}catch (e2){s.push("baseUrl must be a valid URL")}return _optionalChain([n, 'access', _ => _.axiosConfig, 'optionalAccess', _2 => _2.timeout])!==void 0&&(typeof n.axiosConfig.timeout!="number"||n.axiosConfig.timeout<0)&&s.push("timeout must be a positive number"),s};var _axios = require('axios'); var _axios2 = _interopRequireDefault(_axios);var _jsonwebtoken = require('jsonwebtoken'); var _jsonwebtoken2 = _interopRequireDefault(_jsonwebtoken);var w=(n,s)=>{if(!n)throw _chunk6M772WIBjs.a.call(void 0, {message:"Missing JWT secret",code:"missing_jwt_secret"});return _jsonwebtoken2.default.sign({signee:s},n,{algorithm:"HS512",expiresIn:"1d"})||""},k=async(n,s,a)=>{let o={method:"POST",url:`${n}/oauth/token`,headers:{"Content-Type":"application/x-www-form-urlencoded",tenantId:s},data:a},{data:{access_token:c}}=await _axios2.default.request(o);return c};var O=n=>{let s=m(n);if(s.length>0)throw _chunk6M772WIBjs.a.call(void 0, {message:`Invalid configuration: ${s.join(", ")}`,code:"invalid_config"});let a=n,o={accessToken:"",tokenType:"bearer",authConfig:null},c=async(e,t,r)=>{if(a.middlewares)for(let i of a.middlewares)e==="before"&&i.before?await i.before(t):e==="after"&&i.after?await i.after(t,r):e==="onError"&&i.onError&&await i.onError(t,r)},f=e=>{let t={...e,[o.tokenType==="jwt"?"jwtToken":"bearerToken"]:o.accessToken};return _optionalChain([o, 'access', _3 => _3.authConfig, 'optionalAccess', _4 => _4.tenantId])&&(t.tenantId=o.authConfig.tenantId),t},d=(e,t)=>t?{...e,axiosConfig:{...e.axiosConfig,...t.timeout&&{timeout:t.timeout},...t.keepAlive!==void 0&&{keepAlive:t.keepAlive},headers:{..._optionalChain([e, 'access', _5 => _5.axiosConfig, 'optionalAccess', _6 => _6.headers]),...t.headers}}}:e,l=async e=>{if(e.credential){let t=e.tenantId||a.tenantId;if(!t)throw _chunk6M772WIBjs.a.call(void 0, {message:"Tenant ID is required when using credential-based authentication",code:"missing_tenant_id"});return{token:await k(a.baseUrl,t,e.credential),type:"bearer"}}else{if(e.signee&&e.secret)return{token:w(e.secret,e.signee||""),type:"jwt"};if(e.bearerToken)return{token:e.bearerToken,type:"bearer"};if(e.jwtToken)return{token:e.jwtToken,type:"jwt"};throw _chunk6M772WIBjs.a.call(void 0, {message:"No valid authentication method provided in config",code:"missing_authentication"})}};return{connect:async e=>{let{token:t,type:r}=await l(e);o.accessToken=t,o.tokenType=r,o.authConfig=e},request:async(e,t)=>{try{if(await c("before",e),!o.accessToken)throw _chunk6M772WIBjs.a.call(void 0, {message:"No authentication token found. Please await instance.connect() first.",code:"missing_authentication"});let r=d(a,t);r=f(r);try{let i=await e.execute(r);return await c("after",e,i),i}catch(i){if(_chunk6M772WIBjs.b.call(void 0, i)&&i.statusCode===401&&o.authConfig){let{token:T,type:h}=await l(o.authConfig);o.accessToken=T,o.tokenType=h,r=d(a,t),r=f(r);let g=await e.execute(r);return await c("after",e,g),g}else throw await c("onError",e,i),i}}catch(r){throw await c("onError",e,r),r}}}};exports.a = O;

package/dist/client/index.d.mts

@@ -1,9 +1,9 @@
-import { C as Config, a as Command, R as RequestOptions } from '../config.d-CmOFH4fX.mjs';
+import { C as Config, A as AuthConfig, a as Command, R as RequestOptions } from '../config.d-3z0BBs0n.mjs';
 import 'graphql';
 import 'axios';
 
 declare const createInstance: (initialConfig: Config) => {
-    connect: () => Promise<void>;
+    connect: (credentials: AuthConfig) => Promise<void>;
     request: <TInput, TOutput>(command: Command<TInput, TOutput>, options?: RequestOptions) => Promise<TOutput | undefined>;
 };
 

package/dist/client/index.d.ts

@@ -1,9 +1,9 @@
-import { C as Config, a as Command, R as RequestOptions } from '../config.d-CmOFH4fX.js';
+import { C as Config, A as AuthConfig, a as Command, R as RequestOptions } from '../config.d-3z0BBs0n.js';
 import 'graphql';
 import 'axios';
 
 declare const createInstance: (initialConfig: Config) => {
-    connect: () => Promise<void>;
+    connect: (credentials: AuthConfig) => Promise<void>;
     request: <TInput, TOutput>(command: Command<TInput, TOutput>, options?: RequestOptions) => Promise<TOutput | undefined>;
 };
 

package/dist/client/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkWTF6KI43js = require('../chunk-WTF6KI43.js');require('../chunk-6M772WIB.js');exports.createInstance = _chunkWTF6KI43js.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkARR7PVSUjs = require('../chunk-ARR7PVSU.js');require('../chunk-6M772WIB.js');exports.createInstance = _chunkARR7PVSUjs.a;

package/dist/client/index.mjs

@@ -1 +1 @@
-import{a}from"../chunk-W7K7QE4S.mjs";import"../chunk-2PLZ534I.mjs";export{a as createInstance};
+import{a}from"../chunk-5SFHDAQT.mjs";import"../chunk-2PLZ534I.mjs";export{a as createInstance};