@singularity-payments/sveltekit 0.1.0 → 1.0.0-alpha.3

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { RequestEvent } from '@sveltejs/kit';
 import { MpesaClient, MpesaConfig, MpesaClientOptions } from '@singularity-payments/core';
-export { AccountBalanceCallback, B2BCallback, C2BCallback, C2BRegisterRequest, C2BRegisterResponse, MpesaClient, MpesaClientOptions, MpesaConfig, ParsedC2BCallback, ParsedCallbackData, ReversalCallback, STKCallback, STKPushRequest, STKPushResponse, TransactionStatusCallback, TransactionStatusRequest, TransactionStatusResponse } from '@singularity-payments/core';
+export { AccountBalanceCallback, AccountBalanceRequest, AccountBalanceResponse, B2BCallback, B2BRequest, B2BResponse, B2CCallback, B2CRequest, B2CResponse, C2BCallback, C2BRegisterRequest, C2BRegisterResponse, CallbackHandlerOptions, DynamicQRRequest, DynamicQRResponse, GeneralTransactionStatusRequest, GeneralTransactionStatusResponse, MpesaClient, MpesaClientOptions, MpesaConfig, ParsedC2BCallback, ParsedCallbackData, ReversalCallback, ReversalRequest, ReversalResponse, STKCallback, STKPushRequest, STKPushResponse, TransactionStatusCallback, TransactionStatusRequest, TransactionStatusResponse } from '@singularity-payments/core';
 
 interface RouteHandler {
     POST: (event: RequestEvent) => Promise<Response>;
@@ -20,10 +20,49 @@ interface MpesaRouteHandlers {
 declare function createMpesaHandlers(client: MpesaClient): MpesaRouteHandlers;
 
 /**
- * Create M-Pesa instance for SvelteKit
+ * Create M-Pesa instance for Nuxt
+ *
+ * @example
+ * ```typescript
+ * // utils/mpesa.ts
+ * import { createMpesa } from "@singularity-payments/nuxt";
+ *
+ * export const mpesa = createMpesa({
+ *   consumerKey: process.env.MPESA_CONSUMER_KEY!,
+ *   consumerSecret: process.env.MPESA_CONSUMER_SECRET!,
+ *   passkey: process.env.MPESA_PASSKEY!,
+ *   shortcode: process.env.MPESA_SHORTCODE!,
+ *   environment: "sandbox",
+ *   callbackUrl: `${process.env.NUXT_PUBLIC_APP_URL}/api/mpesa/callback`
+ * }, {
+ *   callbackOptions: {
+ *     onSuccess: async (data) => {
+ *       console.log("Payment successful:", data);
+ *       // Save to database
+ *     },
+ *     onFailure: async (data) => {
+ *       console.log("Payment failed:", data);
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // server/api/mpesa/[...mpesa].ts
+ * import { mpesa } from "~/utils/mpesa";
+ *
+ * export default mpesa.handlers.catchAll;
+ * ```
  */
 declare function createMpesa(config: MpesaConfig, options?: MpesaClientOptions): {
+    /**
+     * M-Pesa client instance for making API calls
+     */
     client: MpesaClient;
+    /**
+     * Pre-configured Nuxt event handlers for M-Pesa callbacks
+     */
     handlers: MpesaRouteHandlers;
 };
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { RequestEvent } from '@sveltejs/kit';
 import { MpesaClient, MpesaConfig, MpesaClientOptions } from '@singularity-payments/core';
-export { AccountBalanceCallback, B2BCallback, C2BCallback, C2BRegisterRequest, C2BRegisterResponse, MpesaClient, MpesaClientOptions, MpesaConfig, ParsedC2BCallback, ParsedCallbackData, ReversalCallback, STKCallback, STKPushRequest, STKPushResponse, TransactionStatusCallback, TransactionStatusRequest, TransactionStatusResponse } from '@singularity-payments/core';
+export { AccountBalanceCallback, AccountBalanceRequest, AccountBalanceResponse, B2BCallback, B2BRequest, B2BResponse, B2CCallback, B2CRequest, B2CResponse, C2BCallback, C2BRegisterRequest, C2BRegisterResponse, CallbackHandlerOptions, DynamicQRRequest, DynamicQRResponse, GeneralTransactionStatusRequest, GeneralTransactionStatusResponse, MpesaClient, MpesaClientOptions, MpesaConfig, ParsedC2BCallback, ParsedCallbackData, ReversalCallback, ReversalRequest, ReversalResponse, STKCallback, STKPushRequest, STKPushResponse, TransactionStatusCallback, TransactionStatusRequest, TransactionStatusResponse } from '@singularity-payments/core';
 
 interface RouteHandler {
     POST: (event: RequestEvent) => Promise<Response>;
@@ -20,10 +20,49 @@ interface MpesaRouteHandlers {
 declare function createMpesaHandlers(client: MpesaClient): MpesaRouteHandlers;
 
 /**
- * Create M-Pesa instance for SvelteKit
+ * Create M-Pesa instance for Nuxt
+ *
+ * @example
+ * ```typescript
+ * // utils/mpesa.ts
+ * import { createMpesa } from "@singularity-payments/nuxt";
+ *
+ * export const mpesa = createMpesa({
+ *   consumerKey: process.env.MPESA_CONSUMER_KEY!,
+ *   consumerSecret: process.env.MPESA_CONSUMER_SECRET!,
+ *   passkey: process.env.MPESA_PASSKEY!,
+ *   shortcode: process.env.MPESA_SHORTCODE!,
+ *   environment: "sandbox",
+ *   callbackUrl: `${process.env.NUXT_PUBLIC_APP_URL}/api/mpesa/callback`
+ * }, {
+ *   callbackOptions: {
+ *     onSuccess: async (data) => {
+ *       console.log("Payment successful:", data);
+ *       // Save to database
+ *     },
+ *     onFailure: async (data) => {
+ *       console.log("Payment failed:", data);
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // server/api/mpesa/[...mpesa].ts
+ * import { mpesa } from "~/utils/mpesa";
+ *
+ * export default mpesa.handlers.catchAll;
+ * ```
  */
 declare function createMpesa(config: MpesaConfig, options?: MpesaClientOptions): {
+    /**
+     * M-Pesa client instance for making API calls
+     */
     client: MpesaClient;
+    /**
+     * Pre-configured Nuxt event handlers for M-Pesa callbacks
+     */
     handlers: MpesaRouteHandlers;
 };
 

package/dist/index.js

@@ -106,8 +106,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleB2CResult(body, ipAddress);
+          const response = await client.handleB2CCallback(body);
           return (0, import_kit.json)(response, { status: 200 });
         } catch (error) {
           console.error("B2C Result error:", error);
@@ -157,8 +156,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleB2BResult(body, ipAddress);
+          const response = await client.handleB2BCallback(body);
           return (0, import_kit.json)(response, { status: 200 });
         } catch (error) {
           console.error("B2B Result error:", error);
@@ -202,20 +200,16 @@ function createMpesaHandlers(client) {
     },
     /**
      * Account Balance result handler
-     * Handles callbacks from M-Pesa after account balance queries
+     * Handles callbacks from M-Pesa after account balance requests
      */
-    accountBalanceResult: {
+    balanceResult: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleAccountBalanceResult(
-            body,
-            ipAddress
-          );
+          const response = await client.handleAccountBalanceCallback(body);
           return (0, import_kit.json)(response, { status: 200 });
         } catch (error) {
-          console.error("Account Balance Result error:", error);
+          console.error("Balance Result error:", error);
           return (0, import_kit.json)(
             {
               ResultCode: 1,
@@ -228,13 +222,13 @@ function createMpesaHandlers(client) {
     },
     /**
      * Account Balance timeout handler
-     * Handles timeout notifications from M-Pesa for account balance queries
+     * Handles timeout notifications from M-Pesa for account balance requests
      */
-    accountBalanceTimeout: {
+    balanceTimeout: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          console.log("Account Balance Timeout:", body);
+          console.log("Balance Timeout:", body);
           return (0, import_kit.json)(
             {
               ResultCode: 0,
@@ -243,7 +237,7 @@ function createMpesaHandlers(client) {
             { status: 200 }
           );
         } catch (error) {
-          console.error("Account Balance Timeout error:", error);
+          console.error("Balance Timeout error:", error);
           return (0, import_kit.json)(
             {
               ResultCode: 1,
@@ -256,17 +250,13 @@ function createMpesaHandlers(client) {
     },
     /**
      * Transaction Status result handler
-     * Handles callbacks from M-Pesa after transaction status queries
+     * Handles callbacks from M-Pesa after transaction status requests
      */
     transactionStatusResult: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleTransactionStatusResult(
-            body,
-            ipAddress
-          );
+          const response = await client.handleTransactionStatusCallback(body);
           return (0, import_kit.json)(response, { status: 200 });
         } catch (error) {
           console.error("Transaction Status Result error:", error);
@@ -282,7 +272,7 @@ function createMpesaHandlers(client) {
     },
     /**
      * Transaction Status timeout handler
-     * Handles timeout notifications from M-Pesa for transaction status queries
+     * Handles timeout notifications from M-Pesa for transaction status requests
      */
     transactionStatusTimeout: {
       POST: async (event) => {
@@ -316,8 +306,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleReversalResult(body, ipAddress);
+          const response = await client.handleReversalCallback(body);
           return (0, import_kit.json)(response, { status: 200 });
         } catch (error) {
           console.error("Reversal Result error:", error);
@@ -423,10 +412,10 @@ function createMpesaHandlers(client) {
             return handlers.b2bTimeout.POST(event);
           }
           if (lastSegment === "balance-result") {
-            return handlers.accountBalanceResult.POST(event);
+            return handlers.balanceResult.POST(event);
           }
           if (lastSegment === "balance-timeout") {
-            return handlers.accountBalanceTimeout.POST(event);
+            return handlers.balanceTimeout.POST(event);
           }
           if (lastSegment === "status-result") {
             return handlers.transactionStatusResult.POST(event);
@@ -653,7 +642,13 @@ function createMpesa(config, options) {
   const client = new import_core.MpesaClient(config, options);
   const handlers = createMpesaHandlers(client);
   return {
+    /**
+     * M-Pesa client instance for making API calls
+     */
     client,
+    /**
+     * Pre-configured Nuxt event handlers for M-Pesa callbacks
+     */
     handlers
   };
 }

package/dist/index.mjs

@@ -80,8 +80,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleB2CResult(body, ipAddress);
+          const response = await client.handleB2CCallback(body);
           return json(response, { status: 200 });
         } catch (error) {
           console.error("B2C Result error:", error);
@@ -131,8 +130,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleB2BResult(body, ipAddress);
+          const response = await client.handleB2BCallback(body);
           return json(response, { status: 200 });
         } catch (error) {
           console.error("B2B Result error:", error);
@@ -176,20 +174,16 @@ function createMpesaHandlers(client) {
     },
     /**
      * Account Balance result handler
-     * Handles callbacks from M-Pesa after account balance queries
+     * Handles callbacks from M-Pesa after account balance requests
      */
-    accountBalanceResult: {
+    balanceResult: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleAccountBalanceResult(
-            body,
-            ipAddress
-          );
+          const response = await client.handleAccountBalanceCallback(body);
           return json(response, { status: 200 });
         } catch (error) {
-          console.error("Account Balance Result error:", error);
+          console.error("Balance Result error:", error);
           return json(
             {
               ResultCode: 1,
@@ -202,13 +196,13 @@ function createMpesaHandlers(client) {
     },
     /**
      * Account Balance timeout handler
-     * Handles timeout notifications from M-Pesa for account balance queries
+     * Handles timeout notifications from M-Pesa for account balance requests
      */
-    accountBalanceTimeout: {
+    balanceTimeout: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          console.log("Account Balance Timeout:", body);
+          console.log("Balance Timeout:", body);
           return json(
             {
               ResultCode: 0,
@@ -217,7 +211,7 @@ function createMpesaHandlers(client) {
             { status: 200 }
           );
         } catch (error) {
-          console.error("Account Balance Timeout error:", error);
+          console.error("Balance Timeout error:", error);
           return json(
             {
               ResultCode: 1,
@@ -230,17 +224,13 @@ function createMpesaHandlers(client) {
     },
     /**
      * Transaction Status result handler
-     * Handles callbacks from M-Pesa after transaction status queries
+     * Handles callbacks from M-Pesa after transaction status requests
      */
     transactionStatusResult: {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleTransactionStatusResult(
-            body,
-            ipAddress
-          );
+          const response = await client.handleTransactionStatusCallback(body);
           return json(response, { status: 200 });
         } catch (error) {
           console.error("Transaction Status Result error:", error);
@@ -256,7 +246,7 @@ function createMpesaHandlers(client) {
     },
     /**
      * Transaction Status timeout handler
-     * Handles timeout notifications from M-Pesa for transaction status queries
+     * Handles timeout notifications from M-Pesa for transaction status requests
      */
     transactionStatusTimeout: {
       POST: async (event) => {
@@ -290,8 +280,7 @@ function createMpesaHandlers(client) {
       POST: async (event) => {
         try {
           const body = await event.request.json();
-          const ipAddress = event.request.headers.get("x-forwarded-for") || event.request.headers.get("x-real-ip") || void 0;
-          const response = await client.handleReversalResult(body, ipAddress);
+          const response = await client.handleReversalCallback(body);
           return json(response, { status: 200 });
         } catch (error) {
           console.error("Reversal Result error:", error);
@@ -397,10 +386,10 @@ function createMpesaHandlers(client) {
             return handlers.b2bTimeout.POST(event);
           }
           if (lastSegment === "balance-result") {
-            return handlers.accountBalanceResult.POST(event);
+            return handlers.balanceResult.POST(event);
           }
           if (lastSegment === "balance-timeout") {
-            return handlers.accountBalanceTimeout.POST(event);
+            return handlers.balanceTimeout.POST(event);
           }
           if (lastSegment === "status-result") {
             return handlers.transactionStatusResult.POST(event);
@@ -629,7 +618,13 @@ function createMpesa(config, options) {
   const client = new MpesaClient(config, options);
   const handlers = createMpesaHandlers(client);
   return {
+    /**
+     * M-Pesa client instance for making API calls
+     */
     client,
+    /**
+     * Pre-configured Nuxt event handlers for M-Pesa callbacks
+     */
     handlers
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singularity-payments/sveltekit",
-  "version": "0.1.0",
+  "version": "1.0.0-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@sveltejs/kit": "^2.49.2",
-    "@singularity-payments/core": "0.1.0"
+    "@singularity-payments/core": "1.0.0-alpha.3"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",