@singularity-payments/core 1.1.1 → 1.2.0

package/dist/index.d.mts

@@ -262,6 +262,17 @@ interface DynamicQRResponse {
     ResponseDescription: string;
     QRCode: string;
 }
+interface C2BSimulateRequest {
+    amount: number;
+    phoneNumber: string;
+    billRefNumber: string;
+    commandID?: "CustomerPayBillOnline" | "CustomerBuyGoodsOnline";
+}
+interface C2BSimulateResponse {
+    ConversationID: string;
+    OriginatorCoversationID: string;
+    ResponseDescription: string;
+}
 
 interface ParsedCallbackData {
     merchantRequestId: string;
@@ -623,6 +634,10 @@ declare class MpesaClient {
      * Handle B2C callback
      */
     handleB2CCallback(callback: B2CCallback): Promise<object>;
+    /**
+     * Simulate C2B transaction (for testing in sandbox)
+     */
+    simulateC2B(request: C2BSimulateRequest): Promise<C2BSimulateResponse>;
     /**
      * Handle B2B callback
      */
@@ -684,4 +699,4 @@ declare function encryptInitiatorPassword(initiatorPassword: string, certificate
  */
 declare function validateSecurityCredential(credential: string): boolean;
 
-export { type AccountBalanceCallback, type AccountBalanceRequest, type AccountBalanceResponse, type B2BCallback, type B2BCommandID, type B2BRequest, type B2BResponse, type B2CCallback, type B2CCommandID, type B2CRequest, type B2CResponse, type BalanceIdentifierType, type C2BCallback, type C2BRegisterRequest, type C2BRegisterResponse, type CallbackHandlerOptions, type DynamicQRRequest, type DynamicQRResponse, type Environment, type GeneralTransactionStatusRequest, type GeneralTransactionStatusResponse, MpesaApiError, MpesaAuthError, MpesaCallbackHandler, MpesaClient, type MpesaClientOptions, type MpesaConfig, MpesaError, MpesaNetworkError, type MpesaPlugin, MpesaRateLimitError, MpesaTimeoutError, MpesaValidationError, type ParsedC2BCallback, type ParsedCallbackData, RateLimiter, type RateLimiterOptions, type RedisLike, RedisRateLimiter, type RetryOptions, type ReversalCallback, type ReversalRequest, type ReversalResponse, type STKCallback, type STKPushRequest, type STKPushResponse, type TransactionStatusCallback, type TransactionStatusRequest, type TransactionStatusResponse, encryptInitiatorPassword, retryWithBackoff, validateSecurityCredential };
+export { type AccountBalanceCallback, type AccountBalanceRequest, type AccountBalanceResponse, type B2BCallback, type B2BCommandID, type B2BRequest, type B2BResponse, type B2CCallback, type B2CCommandID, type B2CRequest, type B2CResponse, type BalanceIdentifierType, type C2BCallback, type C2BRegisterRequest, type C2BRegisterResponse, type C2BSimulateRequest, type C2BSimulateResponse, type CallbackHandlerOptions, type DynamicQRRequest, type DynamicQRResponse, type Environment, type GeneralTransactionStatusRequest, type GeneralTransactionStatusResponse, MpesaApiError, MpesaAuthError, MpesaCallbackHandler, MpesaClient, type MpesaClientOptions, type MpesaConfig, MpesaError, MpesaNetworkError, type MpesaPlugin, MpesaRateLimitError, MpesaTimeoutError, MpesaValidationError, type ParsedC2BCallback, type ParsedCallbackData, RateLimiter, type RateLimiterOptions, type RedisLike, RedisRateLimiter, type RetryOptions, type ReversalCallback, type ReversalRequest, type ReversalResponse, type STKCallback, type STKPushRequest, type STKPushResponse, type TransactionStatusCallback, type TransactionStatusRequest, type TransactionStatusResponse, encryptInitiatorPassword, retryWithBackoff, validateSecurityCredential };

package/dist/index.d.ts

@@ -262,6 +262,17 @@ interface DynamicQRResponse {
     ResponseDescription: string;
     QRCode: string;
 }
+interface C2BSimulateRequest {
+    amount: number;
+    phoneNumber: string;
+    billRefNumber: string;
+    commandID?: "CustomerPayBillOnline" | "CustomerBuyGoodsOnline";
+}
+interface C2BSimulateResponse {
+    ConversationID: string;
+    OriginatorCoversationID: string;
+    ResponseDescription: string;
+}
 
 interface ParsedCallbackData {
     merchantRequestId: string;
@@ -623,6 +634,10 @@ declare class MpesaClient {
      * Handle B2C callback
      */
     handleB2CCallback(callback: B2CCallback): Promise<object>;
+    /**
+     * Simulate C2B transaction (for testing in sandbox)
+     */
+    simulateC2B(request: C2BSimulateRequest): Promise<C2BSimulateResponse>;
     /**
      * Handle B2B callback
      */
@@ -684,4 +699,4 @@ declare function encryptInitiatorPassword(initiatorPassword: string, certificate
  */
 declare function validateSecurityCredential(credential: string): boolean;
 
-export { type AccountBalanceCallback, type AccountBalanceRequest, type AccountBalanceResponse, type B2BCallback, type B2BCommandID, type B2BRequest, type B2BResponse, type B2CCallback, type B2CCommandID, type B2CRequest, type B2CResponse, type BalanceIdentifierType, type C2BCallback, type C2BRegisterRequest, type C2BRegisterResponse, type CallbackHandlerOptions, type DynamicQRRequest, type DynamicQRResponse, type Environment, type GeneralTransactionStatusRequest, type GeneralTransactionStatusResponse, MpesaApiError, MpesaAuthError, MpesaCallbackHandler, MpesaClient, type MpesaClientOptions, type MpesaConfig, MpesaError, MpesaNetworkError, type MpesaPlugin, MpesaRateLimitError, MpesaTimeoutError, MpesaValidationError, type ParsedC2BCallback, type ParsedCallbackData, RateLimiter, type RateLimiterOptions, type RedisLike, RedisRateLimiter, type RetryOptions, type ReversalCallback, type ReversalRequest, type ReversalResponse, type STKCallback, type STKPushRequest, type STKPushResponse, type TransactionStatusCallback, type TransactionStatusRequest, type TransactionStatusResponse, encryptInitiatorPassword, retryWithBackoff, validateSecurityCredential };
+export { type AccountBalanceCallback, type AccountBalanceRequest, type AccountBalanceResponse, type B2BCallback, type B2BCommandID, type B2BRequest, type B2BResponse, type B2CCallback, type B2CCommandID, type B2CRequest, type B2CResponse, type BalanceIdentifierType, type C2BCallback, type C2BRegisterRequest, type C2BRegisterResponse, type C2BSimulateRequest, type C2BSimulateResponse, type CallbackHandlerOptions, type DynamicQRRequest, type DynamicQRResponse, type Environment, type GeneralTransactionStatusRequest, type GeneralTransactionStatusResponse, MpesaApiError, MpesaAuthError, MpesaCallbackHandler, MpesaClient, type MpesaClientOptions, type MpesaConfig, MpesaError, MpesaNetworkError, type MpesaPlugin, MpesaRateLimitError, MpesaTimeoutError, MpesaValidationError, type ParsedC2BCallback, type ParsedCallbackData, RateLimiter, type RateLimiterOptions, type RedisLike, RedisRateLimiter, type RetryOptions, type ReversalCallback, type ReversalRequest, type ReversalResponse, type STKCallback, type STKPushRequest, type STKPushResponse, type TransactionStatusCallback, type TransactionStatusRequest, type TransactionStatusResponse, encryptInitiatorPassword, retryWithBackoff, validateSecurityCredential };

package/dist/index.js

@@ -1189,6 +1189,35 @@ var MpesaClient = class {
       );
     }
   }
+  /**
+   * Simulate C2B transaction (for testing in sandbox)
+   */
+  async simulateC2B(request) {
+    if (this.config.environment === "production") {
+      throw new MpesaValidationError(
+        "C2B simulation is only available in sandbox environment. In production, C2B transactions come from real customer payments."
+      );
+    }
+    if (request.amount < 1) {
+      throw new MpesaValidationError("Amount must be at least 1 KES");
+    }
+    if (!request.billRefNumber) {
+      throw new MpesaValidationError("Bill reference number is required");
+    }
+    const phone = this.validateAndFormatPhone(request.phoneNumber);
+    const payload = {
+      ShortCode: this.config.shortcode,
+      CommandID: request.commandID || "CustomerPayBillOnline",
+      Amount: Math.floor(request.amount),
+      Msisdn: phone,
+      BillRefNumber: request.billRefNumber
+    };
+    return this.makeRequest(
+      "/mpesa/c2b/v1/simulate",
+      payload,
+      `c2b:simulate:${phone}`
+    );
+  }
   /**
    * Handle B2B callback
    */

package/dist/index.mjs

@@ -1140,6 +1140,35 @@ var MpesaClient = class {
       );
     }
   }
+  /**
+   * Simulate C2B transaction (for testing in sandbox)
+   */
+  async simulateC2B(request) {
+    if (this.config.environment === "production") {
+      throw new MpesaValidationError(
+        "C2B simulation is only available in sandbox environment. In production, C2B transactions come from real customer payments."
+      );
+    }
+    if (request.amount < 1) {
+      throw new MpesaValidationError("Amount must be at least 1 KES");
+    }
+    if (!request.billRefNumber) {
+      throw new MpesaValidationError("Bill reference number is required");
+    }
+    const phone = this.validateAndFormatPhone(request.phoneNumber);
+    const payload = {
+      ShortCode: this.config.shortcode,
+      CommandID: request.commandID || "CustomerPayBillOnline",
+      Amount: Math.floor(request.amount),
+      Msisdn: phone,
+      BillRefNumber: request.billRefNumber
+    };
+    return this.makeRequest(
+      "/mpesa/c2b/v1/simulate",
+      payload,
+      `c2b:simulate:${phone}`
+    );
+  }
   /**
    * Handle B2B callback
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singularity-payments/core",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "publishConfig": {
     "access": "public"
   },