pesafy 0.0.2 → 0.2.0

package/dist/adapters/fastify.d.ts

@@ -1,82 +1,18 @@
-import { A as TransactionStatusResult, D as MpesaConfig, T as AccountBalanceResult, b as B2BExpressCheckoutCallback, f as C2BValidationPayload, g as B2CDisbursementResult, o as ReversalResult, p as C2BValidationResponse, r as TaxRemittanceResult, s as C2BConfirmationPayload, y as B2CResult } from "../types.js";
-import { t as Mpesa } from "../index.js";
-import { FastifyPluginAsync } from "fastify";
+import { i as Mpesa, n as StkFailurePayload, r as StkSuccessPayload, t as MpesaAdapterConfig } from "../types.js";
+import * as _$fastify from "fastify";
 
 //#region src/adapters/fastify.d.ts
-interface MpesaFastifyConfig extends MpesaConfig {
-  callbackUrl: string;
-  resultUrl?: string;
-  queueTimeoutUrl?: string;
-  skipIPCheck?: boolean;
-  webhookSecret?: string;
-  requireHMAC?: boolean;
-  signatureHeader?: string;
-  routePrefix?: string;
-  balance?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  reversal?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-  };
-  txStatus?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-  };
-  tax?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  b2c?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  c2b?: {
-    shortCode?: string;
-    confirmationUrl?: string;
-    validationUrl?: string;
-    responseType?: 'Completed' | 'Cancelled';
-    apiVersion?: 'v1' | 'v2';
-  };
-  b2b?: {
-    receiverShortCode?: string;
-    callbackUrl?: string;
-  };
-  onStkSuccess?: (data: StkSuccessPayload) => Awaitable<void>;
-  onStkFailure?: (data: StkFailurePayload) => Awaitable<void>;
-  onC2BValidation?: (payload: C2BValidationPayload) => Awaitable<C2BValidationResponse>;
-  onC2BConfirmation?: (payload: C2BConfirmationPayload) => Awaitable<void>;
-  onAccountBalanceResult?: (result: AccountBalanceResult) => Awaitable<void>;
-  onReversalResult?: (result: ReversalResult) => Awaitable<void>;
-  onTxStatusResult?: (result: TransactionStatusResult) => Awaitable<void>;
-  onTaxResult?: (result: TaxRemittanceResult) => Awaitable<void>;
-  onB2BCheckoutCallback?: (cb: B2BExpressCheckoutCallback) => Awaitable<void>;
-  onB2CResult?: (result: B2CResult) => Awaitable<void>;
-  onB2CDisbursementResult?: (result: B2CDisbursementResult) => Awaitable<void>;
-}
-type Awaitable<T> = T | Promise<T>;
-interface StkSuccessPayload {
-  receiptNumber: string | null;
-  amount: number | null;
-  phone: string | null;
-  checkoutRequestId: string;
-  merchantRequestId: string;
-}
-interface StkFailurePayload {
-  resultCode: number;
-  resultDesc: string;
-  checkoutRequestId: string;
-  merchantRequestId: string;
-}
-declare const registerMpesaPlugin: FastifyPluginAsync<MpesaFastifyConfig>;
+type MpesaFastifyConfig = MpesaAdapterConfig;
+/**
+ * Fastify plugin — register all M-PESA routes.
+ * Wrapped with fastify-plugin so decorators are visible to the parent scope.
+ */
+declare const registerMpesaPlugin: _$fastify.FastifyPluginAsync<MpesaAdapterConfig>;
 declare module 'fastify' {
   interface FastifyInstance {
     mpesa: Mpesa;
   }
 }
 //#endregion
-export { MpesaFastifyConfig, StkFailurePayload, StkSuccessPayload, registerMpesaPlugin };
+export { MpesaFastifyConfig, type StkFailurePayload, type StkSuccessPayload, registerMpesaPlugin };
+//# sourceMappingURL=fastify.d.ts.map

package/dist/adapters/fastify.js

@@ -1 +1,85 @@
-import{t as e}from"../chunk.js";import{A as t,D as n,E as r,O as i,S as a,T as o,_ as s,a as c,b as l,c as u,d,f,g as p,h as m,i as h,j as g,k as _,l as v,m as y,n as b,o as x,p as S,r as C,s as w,t as T,u as E,w as D,x as O,y as k}from"../webhook-guard.js";function A(e){let t=e.headers[`x-forwarded-for`];return typeof t==`string`?t.split(`,`)[0]?.trim()??``:e.ip??``}function j(e,t){return t instanceof g?e.status(t.statusCode??400).send({ok:!1,error:t.code,message:t.message}):e.status(500).send({ok:!1,error:`INTERNAL_ERROR`,message:`Unexpected error`})}function M(...e){return e.find(e=>e?.trim())??``}function N(e,t){e?.().catch(e=>console.error(`[pesafy/fastify] ${t} hook error:`,e))}const P=e(`fastify-plugin`)(async(e,P)=>{let F=new b(P),I=P.routePrefix??``;e.decorate(`mpesa`,F),e.post(`${I}/mpesa/stk/push`,async(e,t)=>{try{let{amount:t,phoneNumber:n,accountReference:r,transactionDesc:i,transactionType:a,partyB:o}=e.body;if(!t||t<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!n)throw new g({code:`VALIDATION_ERROR`,message:`phoneNumber is required`});return{ok:!0,data:await F.stkPush({amount:t,phoneNumber:n,callbackUrl:P.callbackUrl,accountReference:r??`REF-${Date.now().toString(36).toUpperCase()}`,transactionDesc:i??`Payment`,...a===void 0?{}:{transactionType:a},...o===void 0?{}:{partyB:o}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/stk/query`,async(e,t)=>{try{let{checkoutRequestId:t}=e.body;if(!t)throw new g({code:`VALIDATION_ERROR`,message:`checkoutRequestId is required`});return{ok:!0,data:await F.stkQuery({checkoutRequestId:t})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/stk/callback`,async e=>{let t=e.rawBody??(e.body===void 0?void 0:JSON.stringify(e.body));await T(A(e),t,t=>{let n=e.headers[t.toLowerCase()];return Array.isArray(n)?n[0]:n},P);let n=e.body,r=n?.Body?.stkCallback;if(!r)return{ResultCode:0,ResultDesc:`Accepted`};if(x(n)){let t={receiptNumber:c(n),amount:C(n),phone:h(n),checkoutRequestId:r.CheckoutRequestID,merchantRequestId:r.MerchantRequestID};e.log.info(t,`[pesafy] STK success`),N(P.onStkSuccess?()=>Promise.resolve(P.onStkSuccess(t)):void 0,`onStkSuccess`)}else{let t={resultCode:r.ResultCode,resultDesc:r.ResultDesc,checkoutRequestId:r.CheckoutRequestID,merchantRequestId:r.MerchantRequestID};e.log.warn(t,`[pesafy] STK failure`),N(P.onStkFailure?()=>Promise.resolve(P.onStkFailure(t)):void 0,`onStkFailure`)}return{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/c2b/register`,async(e,t)=>{try{let{shortCode:t,confirmationUrl:n,validationUrl:r,responseType:i,apiVersion:a}=e.body,o=t??P.c2b?.shortCode??``,s=n??P.c2b?.confirmationUrl??``,c=r??P.c2b?.validationUrl??``;if(!o)throw new g({code:`VALIDATION_ERROR`,message:`shortCode is required`});if(!s)throw new g({code:`VALIDATION_ERROR`,message:`confirmationUrl is required`});if(!c)throw new g({code:`VALIDATION_ERROR`,message:`validationUrl is required`});return{ok:!0,data:await F.registerC2BUrls({shortCode:o,responseType:i??P.c2b?.responseType??`Completed`,confirmationUrl:s,validationUrl:c,apiVersion:a??P.c2b?.apiVersion??`v2`})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/c2b/simulate`,async(e,t)=>{try{let{commandId:t,amount:n,msisdn:r,billRefNumber:i,shortCode:a}=e.body;if(!t)throw new g({code:`VALIDATION_ERROR`,message:`commandId is required`});if(!n||n<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!r)throw new g({code:`VALIDATION_ERROR`,message:`msisdn is required`});return{ok:!0,data:await F.simulateC2B({shortCode:a??P.c2b?.shortCode??``,commandId:t,amount:n,msisdn:r,apiVersion:P.c2b?.apiVersion??`v2`,...i===void 0?{}:{billRefNumber:i}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/c2b/validation`,async e=>{let t=e.rawBody??(e.body===void 0?void 0:JSON.stringify(e.body));await T(A(e),t,t=>{let n=e.headers[t.toLowerCase()];return Array.isArray(n)?n[0]:n},P);let n=e.body;return P.onC2BValidation?await P.onC2BValidation(n):y()}),e.post(`${I}/mpesa/c2b/confirmation`,async e=>{let t=e.body;return e.log.info({txId:t.TransID,amount:t.TransAmount},`[pesafy] C2B confirmation`),N(P.onC2BConfirmation?()=>Promise.resolve(P.onC2BConfirmation(t)):void 0,`onC2BConfirmation`),{ResultCode:0,ResultDesc:`Success`}}),e.post(`${I}/mpesa/balance/query`,async(e,t)=>{try{let{partyA:t,identifierType:n,remarks:r,resultUrl:i,queueTimeoutUrl:a}=e.body;return{ok:!0,data:await F.accountBalance({partyA:t??P.balance?.partyA??``,identifierType:n??`4`,resultUrl:M(i,P.balance?.resultUrl,P.resultUrl),queueTimeOutUrl:M(a,P.balance?.queueTimeoutUrl,P.queueTimeoutUrl),...r===void 0?{}:{remarks:r}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/balance/result`,async e=>{let n=e.body;if(_(n)){let r=i(n);e.log.info(r?t(r):n,`[pesafy] Account balance result`)}else e.log.warn(n,`[pesafy] Account balance failed`);return N(P.onAccountBalanceResult?()=>Promise.resolve(P.onAccountBalanceResult(n)):void 0,`onAccountBalanceResult`),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/qr/generate`,async(e,t)=>{try{return{ok:!0,data:await F.generateDynamicQR(e.body)}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/reversal/request`,async(e,t)=>{try{let{transactionId:t,receiverParty:n,amount:r,remarks:i,occasion:a,resultUrl:o,queueTimeoutUrl:s}=e.body;if(!t)throw new g({code:`VALIDATION_ERROR`,message:`transactionId is required`});if(!n)throw new g({code:`VALIDATION_ERROR`,message:`receiverParty is required`});if(!r||r<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});return{ok:!0,data:await F.reverseTransaction({transactionId:t,receiverParty:n,amount:r,resultUrl:M(o,P.reversal?.resultUrl,P.resultUrl),queueTimeOutUrl:M(s,P.reversal?.queueTimeoutUrl,P.queueTimeoutUrl),...i===void 0?{}:{remarks:i},...a===void 0?{}:{occasion:a}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/reversal/result`,async e=>{let t=e.body;return f(t)&&(S(t)?e.log.info({txId:d(t)},`[pesafy] Reversal success`):e.log.warn({result:t.Result.ResultDesc},`[pesafy] Reversal failed`),N(P.onReversalResult?()=>Promise.resolve(P.onReversalResult(t)):void 0,`onReversalResult`)),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/tx-status/query`,async(e,t)=>{try{let{transactionId:t,originalConversationId:n,partyA:r,identifierType:i,remarks:a,occasion:o,resultUrl:s,queueTimeoutUrl:c}=e.body;return{ok:!0,data:await F.transactionStatus({...t===void 0?{}:{transactionId:t},...n===void 0?{}:{originalConversationId:n},partyA:r,identifierType:i,resultUrl:M(s,P.txStatus?.resultUrl,P.resultUrl),queueTimeOutUrl:M(c,P.txStatus?.queueTimeoutUrl,P.queueTimeoutUrl),...a===void 0?{}:{remarks:a},...o===void 0?{}:{occasion:o}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/tx-status/result`,async e=>{let t=e.body;return w(t)&&(u(t)?e.log.info({txId:t.Result.TransactionID},`[pesafy] Tx-status success`):e.log.warn({desc:t.Result.ResultDesc},`[pesafy] Tx-status failed`),N(P.onTxStatusResult?()=>Promise.resolve(P.onTxStatusResult(t)):void 0,`onTxStatusResult`)),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/tax/remit`,async(e,t)=>{try{let{amount:t,partyA:n,accountReference:r,remarks:i,partyB:a,queueTimeoutUrl:o,resultUrl:s}=e.body;if(!t||t<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!r)throw new g({code:`VALIDATION_ERROR`,message:`accountReference (KRA PRN) is required`});return{ok:!0,data:await F.remitTax({amount:t,partyA:n??P.tax?.partyA??``,accountReference:r,resultUrl:M(s,P.tax?.resultUrl,P.resultUrl),queueTimeOutUrl:M(o,P.tax?.queueTimeoutUrl,P.queueTimeoutUrl),...a===void 0?{}:{partyB:a},...i===void 0?{}:{remarks:i}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/tax/result`,async e=>{let t=e.body;return v(t)&&(E(t)?e.log.info({txId:t.Result.TransactionID},`[pesafy] Tax success`):e.log.warn({desc:t.Result.ResultDesc},`[pesafy] Tax failed`),N(P.onTaxResult?()=>Promise.resolve(P.onTaxResult(t)):void 0,`onTaxResult`)),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/b2b/checkout`,async(e,t)=>{try{let{primaryShortCode:t,receiverShortCode:n,amount:r,paymentRef:i,partnerName:a,callbackUrl:o,requestRefId:s}=e.body;if(!t)throw new g({code:`VALIDATION_ERROR`,message:`primaryShortCode is required`});if(!r||r<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});let c=n??P.b2b?.receiverShortCode??``,l=o??P.b2b?.callbackUrl??``;if(!c)throw new g({code:`VALIDATION_ERROR`,message:`receiverShortCode is required`});if(!l)throw new g({code:`VALIDATION_ERROR`,message:`callbackUrl is required`});return{ok:!0,data:await F.b2bExpressCheckout({primaryShortCode:t,receiverShortCode:c,amount:r,paymentRef:i,callbackUrl:l,partnerName:a,...s===void 0?{}:{requestRefId:s}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/b2b/callback`,async e=>{let t=e.body;if(!o(t))return e.log.warn(`[pesafy] Unknown B2B callback payload`),{ResultCode:0,ResultDesc:`Accepted`};let i=t;return n(i)?e.log.info({txId:D(i),amount:a(i)},`[pesafy] B2B success`):r(i)?e.log.warn(`[pesafy] B2B cancelled`):e.log.warn({result:i.resultDesc},`[pesafy] B2B failed`),N(P.onB2BCheckoutCallback?()=>Promise.resolve(P.onB2BCheckoutCallback(i)):void 0,`onB2BCheckoutCallback`),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/b2c/payment`,async(e,t)=>{try{let{commandId:t,amount:n,partyA:r,partyB:i,accountReference:a,requester:o,remarks:s,resultUrl:c,queueTimeoutUrl:l}=e.body;if(t!==`BusinessPayToBulk`)throw new g({code:`VALIDATION_ERROR`,message:`commandId must be "BusinessPayToBulk"`});if(!n||n<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!i)throw new g({code:`VALIDATION_ERROR`,message:`partyB is required`});if(!a)throw new g({code:`VALIDATION_ERROR`,message:`accountReference is required`});return{ok:!0,data:await F.b2cPayment({commandId:t,amount:n,partyA:r??P.b2c?.partyA??``,partyB:i,accountReference:a,resultUrl:M(c,P.b2c?.resultUrl,P.resultUrl),queueTimeOutUrl:M(l,P.b2c?.queueTimeoutUrl,P.queueTimeoutUrl),...o===void 0?{}:{requester:o},...s===void 0?{}:{remarks:s}})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/b2c/result`,async e=>{let t=e.body;return l(t)&&(O(t)?e.log.info({txId:k(t),amount:s(t)},`[pesafy] B2C success`):e.log.warn({desc:t.Result.ResultDesc},`[pesafy] B2C failed`),N(P.onB2CResult?()=>Promise.resolve(P.onB2CResult(t)):void 0,`onB2CResult`)),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/b2c/disburse`,async(e,t)=>{try{let{queueTimeoutUrl:t,resultUrl:n,...r}=e.body;return{ok:!0,data:await F.b2cDisbursement({...r,resultUrl:M(n,P.b2c?.resultUrl,P.resultUrl),queueTimeOutUrl:M(t,P.b2c?.queueTimeoutUrl,P.queueTimeoutUrl)})}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/b2c/disburse/result`,async e=>{let t=e.body;return m(t)&&(p(t)?e.log.info({txId:t.Result.TransactionID},`[pesafy] Disbursement success`):e.log.warn({desc:t.Result.ResultDesc},`[pesafy] Disbursement failed`),N(P.onB2CDisbursementResult?()=>Promise.resolve(P.onB2CDisbursementResult(t)):void 0,`onB2CDisbursementResult`)),{ResultCode:0,ResultDesc:`Accepted`}}),e.post(`${I}/mpesa/bills/optin`,async(e,t)=>{try{return{ok:!0,data:await F.billManagerOptIn(e.body)}}catch(e){return j(t,e)}}),e.patch(`${I}/mpesa/bills/optin`,async(e,t)=>{try{return{ok:!0,data:await F.updateOptIn(e.body)}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/bills/invoice`,async(e,t)=>{try{return{ok:!0,data:await F.sendInvoice(e.body)}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/bills/invoice/bulk`,async(e,t)=>{try{return{ok:!0,data:await F.sendBulkInvoices(e.body)}}catch(e){return j(t,e)}}),e.delete(`${I}/mpesa/bills/invoice`,async(e,t)=>{try{return{ok:!0,data:await F.cancelInvoice(e.body)}}catch(e){return j(t,e)}}),e.delete(`${I}/mpesa/bills/invoice/bulk`,async(e,t)=>{try{return{ok:!0,data:await F.cancelBulkInvoices(e.body)}}catch(e){return j(t,e)}}),e.post(`${I}/mpesa/bills/reconcile`,async(e,t)=>{try{return{ok:!0,data:await F.reconcilePayment(e.body)}}catch(e){return j(t,e)}}),e.get(`${I}/mpesa/health`,async()=>({ok:!0,environment:F.environment,ts:new Date().toISOString()}))},{fastify:`>=4.0.0`,name:`pesafy-mpesa`});export{P as registerMpesaPlugin};
+import { a as PesafyError, i as Mpesa, n as getRoutePaths, r as createRouteHandlers, t as ROUTE_DEFINITIONS } from "../route-definitions.js";
+import fp from "fastify-plugin";
+
+//#region src/adapters/shared/mount-fastify.ts
+/** All paths mounted by this adapter (parity anchor). */
+const FASTIFY_ROUTE_PATHS = getRoutePaths();
+function getIP(req) {
+	const xff = req.headers["x-forwarded-for"];
+	if (typeof xff === "string") return xff.split(",")[0]?.trim() ?? "";
+	return req.ip ?? "";
+}
+function getRawBody(req) {
+	const raw = req.rawBody;
+	if (typeof raw === "string") return raw;
+	if (req.body !== void 0) return JSON.stringify(req.body);
+}
+function sendErr(reply, err) {
+	if (err instanceof PesafyError) return reply.status(err.statusCode ?? 400).send({
+		ok: false,
+		error: err.code,
+		message: err.message
+	});
+	return reply.status(500).send({
+		ok: false,
+		error: "INTERNAL_ERROR",
+		message: "Unexpected error"
+	});
+}
+function sendHandlerResult(reply, result, routeId) {
+	if (routeId === "health") return reply.send(result.body);
+	if (result.type === "daraja") return reply.send(result.body);
+	return reply.send({
+		ok: true,
+		data: result.body
+	});
+}
+function buildContext(req) {
+	const rawBody = getRawBody(req);
+	return {
+		body: req.body,
+		...rawBody !== void 0 ? { rawBody } : {},
+		requestIP: getIP(req),
+		getHeader: (name) => {
+			const v = req.headers[name.toLowerCase()];
+			return Array.isArray(v) ? v[0] : v;
+		}
+	};
+}
+const mpesaPlugin = async (app, config) => {
+	const mpesa = new Mpesa(config);
+	const prefix = config.routePrefix ?? "";
+	const handlers = createRouteHandlers(mpesa, config);
+	app.decorate("mpesa", mpesa);
+	for (const route of ROUTE_DEFINITIONS) {
+		const path = `${prefix}${route.path}`;
+		const handler = handlers[route.id];
+		app.route({
+			method: route.method,
+			url: path,
+			handler: async (req, reply) => {
+				try {
+					return sendHandlerResult(reply, await handler(buildContext(req)), route.id);
+				} catch (e) {
+					return sendErr(reply, e);
+				}
+			}
+		});
+	}
+};
+const registerMpesaRoutes = fp(mpesaPlugin, {
+	fastify: ">=4.0.0",
+	name: "pesafy-mpesa"
+});
+
+//#endregion
+//#region src/adapters/fastify.ts
+/**
+* Fastify plugin — register all M-PESA routes.
+* Wrapped with fastify-plugin so decorators are visible to the parent scope.
+*/
+const registerMpesaPlugin = registerMpesaRoutes;
+
+//#endregion
+export { registerMpesaPlugin };
+//# sourceMappingURL=fastify.js.map

package/dist/adapters/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","names":[],"sources":["../../src/adapters/shared/mount-fastify.ts","../../src/adapters/fastify.ts"],"sourcesContent":["import type { FastifyInstance, FastifyPluginAsync, FastifyReply, FastifyRequest } from 'fastify'\nimport fp from 'fastify-plugin'\nimport { Mpesa } from '../../mpesa'\nimport { PesafyError } from '../../utils/errors'\nimport { createRouteHandlers } from './handlers'\nimport { ROUTE_DEFINITIONS, getRoutePaths } from './route-definitions'\n\n/** All paths mounted by this adapter (parity anchor). */\nexport const FASTIFY_ROUTE_PATHS = getRoutePaths()\nimport type { HandlerContext, HandlerResult, MpesaAdapterConfig } from './types'\n\nfunction getIP(req: FastifyRequest): string {\n  const xff = req.headers['x-forwarded-for']\n  if (typeof xff === 'string') return xff.split(',')[0]?.trim() ?? ''\n  return req.ip ?? ''\n}\n\nfunction getRawBody(req: FastifyRequest): string | undefined {\n  const raw = (req as { rawBody?: string }).rawBody\n  if (typeof raw === 'string') return raw\n  if (req.body !== undefined) return JSON.stringify(req.body)\n  return undefined\n}\n\nfunction sendErr(reply: FastifyReply, err: unknown): FastifyReply {\n  if (err instanceof PesafyError) {\n    return reply\n      .status(err.statusCode ?? 400)\n      .send({ ok: false, error: err.code, message: err.message })\n  }\n  return reply.status(500).send({ ok: false, error: 'INTERNAL_ERROR', message: 'Unexpected error' })\n}\n\nfunction sendHandlerResult(\n  reply: FastifyReply,\n  result: HandlerResult,\n  routeId: string,\n): FastifyReply | unknown {\n  if (routeId === 'health') {\n    return reply.send(result.body)\n  }\n  if (result.type === 'daraja') {\n    return reply.send(result.body)\n  }\n  return reply.send({ ok: true, data: result.body })\n}\n\nfunction buildContext(req: FastifyRequest): HandlerContext {\n  const rawBody = getRawBody(req)\n  return {\n    body: req.body,\n    ...(rawBody !== undefined ? { rawBody } : {}),\n    requestIP: getIP(req),\n    getHeader: (name) => {\n      const v = req.headers[name.toLowerCase()]\n      return Array.isArray(v) ? v[0] : v\n    },\n  }\n}\n\nconst mpesaPlugin: FastifyPluginAsync<MpesaAdapterConfig> = async (\n  app: FastifyInstance,\n  config: MpesaAdapterConfig,\n) => {\n  const mpesa = new Mpesa(config)\n  const prefix = config.routePrefix ?? ''\n  const handlers = createRouteHandlers(mpesa, config)\n\n  app.decorate('mpesa', mpesa)\n\n  for (const route of ROUTE_DEFINITIONS) {\n    const path = `${prefix}${route.path}`\n    const handler = handlers[route.id]\n\n    app.route({\n      method: route.method,\n      url: path,\n      handler: async (req, reply) => {\n        try {\n          const result = await handler(buildContext(req))\n          return sendHandlerResult(reply, result, route.id)\n        } catch (e) {\n          return sendErr(reply, e)\n        }\n      },\n    })\n  }\n}\n\nexport const registerMpesaRoutes = fp(mpesaPlugin, {\n  fastify: '>=4.0.0',\n  name: 'pesafy-mpesa',\n})\n","/**\n * @file src/adapters/fastify.ts\n * Fastify adapter for pesafy — full M-PESA Daraja surface.\n *\n * Usage:\n *   import Fastify from 'fastify'\n *   import { registerMpesaPlugin } from 'pesafy/adapters/fastify'\n *\n *   const app = Fastify()\n *   await app.register(registerMpesaPlugin, config)\n */\n\nimport { Mpesa } from '../mpesa'\nimport { registerMpesaRoutes } from './shared/mount-fastify'\nimport type { MpesaAdapterConfig, StkFailurePayload, StkSuccessPayload } from './shared/types'\n\nexport type MpesaFastifyConfig = MpesaAdapterConfig\nexport type { StkSuccessPayload, StkFailurePayload }\n\n/**\n * Fastify plugin — register all M-PESA routes.\n * Wrapped with fastify-plugin so decorators are visible to the parent scope.\n */\nexport const registerMpesaPlugin = registerMpesaRoutes\n\ndeclare module 'fastify' {\n  interface FastifyInstance {\n    mpesa: Mpesa\n  }\n}\n"],"mappings":";;;;;AAQA,MAAa,sBAAsB,eAAe;AAGlD,SAAS,MAAM,KAA6B;CAC1C,MAAM,MAAM,IAAI,QAAQ;AACxB,KAAI,OAAO,QAAQ,SAAU,QAAO,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI;AACjE,QAAO,IAAI,MAAM;;AAGnB,SAAS,WAAW,KAAyC;CAC3D,MAAM,MAAO,IAA6B;AAC1C,KAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,KAAI,IAAI,SAAS,OAAW,QAAO,KAAK,UAAU,IAAI,KAAK;;AAI7D,SAAS,QAAQ,OAAqB,KAA4B;AAChE,KAAI,eAAe,YACjB,QAAO,MACJ,OAAO,IAAI,cAAc,IAAI,CAC7B,KAAK;EAAE,IAAI;EAAO,OAAO,IAAI;EAAM,SAAS,IAAI;EAAS,CAAC;AAE/D,QAAO,MAAM,OAAO,IAAI,CAAC,KAAK;EAAE,IAAI;EAAO,OAAO;EAAkB,SAAS;EAAoB,CAAC;;AAGpG,SAAS,kBACP,OACA,QACA,SACwB;AACxB,KAAI,YAAY,SACd,QAAO,MAAM,KAAK,OAAO,KAAK;AAEhC,KAAI,OAAO,SAAS,SAClB,QAAO,MAAM,KAAK,OAAO,KAAK;AAEhC,QAAO,MAAM,KAAK;EAAE,IAAI;EAAM,MAAM,OAAO;EAAM,CAAC;;AAGpD,SAAS,aAAa,KAAqC;CACzD,MAAM,UAAU,WAAW,IAAI;AAC/B,QAAO;EACL,MAAM,IAAI;EACV,GAAI,YAAY,SAAY,EAAE,SAAS,GAAG,EAAE;EAC5C,WAAW,MAAM,IAAI;EACrB,YAAY,SAAS;GACnB,MAAM,IAAI,IAAI,QAAQ,KAAK,aAAa;AACxC,UAAO,MAAM,QAAQ,EAAE,GAAG,EAAE,KAAK;;EAEpC;;AAGH,MAAM,cAAsD,OAC1D,KACA,WACG;CACH,MAAM,QAAQ,IAAI,MAAM,OAAO;CAC/B,MAAM,SAAS,OAAO,eAAe;CACrC,MAAM,WAAW,oBAAoB,OAAO,OAAO;AAEnD,KAAI,SAAS,SAAS,MAAM;AAE5B,MAAK,MAAM,SAAS,mBAAmB;EACrC,MAAM,OAAO,GAAG,SAAS,MAAM;EAC/B,MAAM,UAAU,SAAS,MAAM;AAE/B,MAAI,MAAM;GACR,QAAQ,MAAM;GACd,KAAK;GACL,SAAS,OAAO,KAAK,UAAU;AAC7B,QAAI;AAEF,YAAO,kBAAkB,OADV,MAAM,QAAQ,aAAa,IAAI,CAAC,EACP,MAAM,GAAG;aAC1C,GAAG;AACV,YAAO,QAAQ,OAAO,EAAE;;;GAG7B,CAAC;;;AAIN,MAAa,sBAAsB,GAAG,aAAa;CACjD,SAAS;CACT,MAAM;CACP,CAAC;;;;;;;;ACrEF,MAAa,sBAAsB"}

package/dist/adapters/hono.d.ts

@@ -1,100 +1,15 @@
-import { A as TransactionStatusResult, D as MpesaConfig, T as AccountBalanceResult, b as B2BExpressCheckoutCallback, f as C2BValidationPayload, g as B2CDisbursementResult, o as ReversalResult, p as C2BValidationResponse, r as TaxRemittanceResult, s as C2BConfirmationPayload, y as B2CResult } from "../types.js";
-import { t as Mpesa } from "../index.js";
+import { i as Mpesa, n as StkFailurePayload, r as StkSuccessPayload, t as MpesaAdapterConfig } from "../types.js";
 import { Hono, MiddlewareHandler } from "hono";
 
 //#region src/adapters/hono.d.ts
-interface MpesaHonoConfig extends MpesaConfig {
-  callbackUrl: string;
-  resultUrl?: string;
-  queueTimeoutUrl?: string;
-  skipIPCheck?: boolean;
-  webhookSecret?: string;
-  requireHMAC?: boolean;
-  signatureHeader?: string;
-  balance?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  reversal?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-  };
-  txStatus?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-  };
-  tax?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  b2c?: {
-    resultUrl?: string;
-    queueTimeoutUrl?: string;
-    partyA?: string;
-  };
-  c2b?: {
-    shortCode?: string;
-    confirmationUrl?: string;
-    validationUrl?: string;
-    responseType?: 'Completed' | 'Cancelled';
-    apiVersion?: 'v1' | 'v2';
-  };
-  b2b?: {
-    receiverShortCode?: string;
-    callbackUrl?: string;
-  };
-  onStkSuccess?: (data: StkSuccessPayload) => Awaitable<void>;
-  onStkFailure?: (data: StkFailurePayload) => Awaitable<void>;
-  onC2BValidation?: (payload: C2BValidationPayload) => Awaitable<C2BValidationResponse>;
-  onC2BConfirmation?: (payload: C2BConfirmationPayload) => Awaitable<void>;
-  onAccountBalanceResult?: (result: AccountBalanceResult) => Awaitable<void>;
-  onReversalResult?: (result: ReversalResult) => Awaitable<void>;
-  onTxStatusResult?: (result: TransactionStatusResult) => Awaitable<void>;
-  onTaxResult?: (result: TaxRemittanceResult) => Awaitable<void>;
-  onB2BCheckoutCallback?: (cb: B2BExpressCheckoutCallback) => Awaitable<void>;
-  onB2CResult?: (result: B2CResult) => Awaitable<void>;
-  onB2CDisbursementResult?: (result: B2CDisbursementResult) => Awaitable<void>;
-}
-type Awaitable<T> = T | Promise<T>;
-interface StkSuccessPayload {
-  receiptNumber: string | null;
-  amount: number | null;
-  phone: string | null;
-  checkoutRequestId: string;
-  merchantRequestId: string;
-}
-interface StkFailurePayload {
-  resultCode: number;
-  resultDesc: string;
-  checkoutRequestId: string;
-  merchantRequestId: string;
-}
+type MpesaHonoConfig = MpesaAdapterConfig;
 /**
  * Creates a Hono app with all M-PESA routes.
  * Mount it on your main app with `app.route('/api', createMpesaHono(config))`.
- *
- * @example
- * import { Hono } from 'hono'
- * import { createMpesaHono } from 'pesafy/adapters/hono'
- *
- * const api = createMpesaHono({
- *   consumerKey: env.MPESA_CONSUMER_KEY,
- *   consumerSecret: env.MPESA_CONSUMER_SECRET,
- *   environment: 'sandbox',
- *   callbackUrl: 'https://yourdomain.com/api/mpesa/stk/callback',
- *   lipaNaMpesaShortCode: '174379',
- *   lipaNaMpesaPassKey: env.MPESA_PASSKEY,
- * })
- *
- * const app = new Hono()
- * app.route('/api', api)
  */
 declare function createMpesaHono(config: MpesaHonoConfig): Hono;
 /**
  * Returns a Hono middleware that injects an Mpesa instance into context.
- * Use when you want to call the SDK directly inside your own route handlers.
  */
 declare function mpesaMiddleware(config: MpesaHonoConfig): MiddlewareHandler;
 declare module 'hono' {
@@ -103,4 +18,5 @@ declare module 'hono' {
   }
 }
 //#endregion
-export { MpesaHonoConfig, StkFailurePayload, StkSuccessPayload, createMpesaHono, mpesaMiddleware };
+export { MpesaHonoConfig, type StkFailurePayload, type StkSuccessPayload, createMpesaHono, createMpesaHono as createMpesaHonoRouter, mpesaMiddleware };
+//# sourceMappingURL=hono.d.ts.map

package/dist/adapters/hono.js

@@ -1 +1,105 @@
-import{t as e}from"../chunk.js";import{A as t,D as n,E as r,O as i,S as a,T as o,_ as s,a as c,b as l,c as u,d,f,g as p,h as m,i as h,j as g,k as _,l as v,m as y,n as b,o as x,p as S,r as C,s as w,t as T,u as E,w as D,x as O,y as k}from"../webhook-guard.js";function A(e){return e.req.header(`x-forwarded-for`)?.split(`,`)[0]?.trim()??e.req.header(`cf-connecting-ip`)??e.req.header(`x-real-ip`)??``}function j(e,t){return e.json({ok:!0,data:t})}function M(e,t){return t instanceof g?e.json({ok:!1,error:t.code,message:t.message},t.statusCode??400):e.json({ok:!1,error:`INTERNAL_ERROR`,message:`Unexpected error`},500)}function N(...e){return e.find(e=>e?.trim())??``}function P(e,t){e?.().catch(e=>console.error(`[pesafy/hono] ${t} hook error:`,e))}function F(F){let{Hono:I}=e(`hono`),L=new I,R=new b(F);return L.use(`*`,async(e,t)=>{e.set(`mpesa`,R),await t()}),L.post(`/mpesa/stk/push`,async e=>{try{let{amount:t,phoneNumber:n,accountReference:r,transactionDesc:i,transactionType:a,partyB:o}=await e.req.json();if(!t||t<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!n)throw new g({code:`VALIDATION_ERROR`,message:`phoneNumber is required`});return j(e,await R.stkPush({amount:t,phoneNumber:n,callbackUrl:F.callbackUrl,accountReference:r??`REF-${Date.now().toString(36).toUpperCase()}`,transactionDesc:i??`Payment`,...a===void 0?{}:{transactionType:a},...o===void 0?{}:{partyB:o}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/stk/query`,async e=>{try{let{checkoutRequestId:t}=await e.req.json();if(!t)throw new g({code:`VALIDATION_ERROR`,message:`checkoutRequestId is required`});return j(e,await R.stkQuery({checkoutRequestId:t}))}catch(t){return M(e,t)}}),L.post(`/mpesa/stk/callback`,async e=>{let t=await e.req.text();await T(A(e),t,t=>e.req.header(t),F);let n=JSON.parse(t),r=n?.Body?.stkCallback;if(!r)return e.json({ResultCode:0,ResultDesc:`Accepted`});if(x(n)){let e={receiptNumber:c(n),amount:C(n),phone:h(n),checkoutRequestId:r.CheckoutRequestID,merchantRequestId:r.MerchantRequestID};console.info(`[pesafy/hono] STK success:`,e),P(F.onStkSuccess?()=>Promise.resolve(F.onStkSuccess(e)):void 0,`onStkSuccess`)}else{let e={resultCode:r.ResultCode,resultDesc:r.ResultDesc,checkoutRequestId:r.CheckoutRequestID,merchantRequestId:r.MerchantRequestID};console.warn(`[pesafy/hono] STK failure:`,e),P(F.onStkFailure?()=>Promise.resolve(F.onStkFailure(e)):void 0,`onStkFailure`)}return e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/c2b/register`,async e=>{try{let{shortCode:t,confirmationUrl:n,validationUrl:r,responseType:i,apiVersion:a}=await e.req.json(),o=t??F.c2b?.shortCode??``,s=n??F.c2b?.confirmationUrl??``,c=r??F.c2b?.validationUrl??``;if(!o)throw new g({code:`VALIDATION_ERROR`,message:`shortCode is required`});if(!s)throw new g({code:`VALIDATION_ERROR`,message:`confirmationUrl is required`});if(!c)throw new g({code:`VALIDATION_ERROR`,message:`validationUrl is required`});return j(e,await R.registerC2BUrls({shortCode:o,responseType:i??F.c2b?.responseType??`Completed`,confirmationUrl:s,validationUrl:c,apiVersion:a??F.c2b?.apiVersion??`v2`}))}catch(t){return M(e,t)}}),L.post(`/mpesa/c2b/simulate`,async e=>{try{let{commandId:t,amount:n,msisdn:r,billRefNumber:i,shortCode:a}=await e.req.json();if(!t)throw new g({code:`VALIDATION_ERROR`,message:`commandId is required`});if(!n||n<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!r)throw new g({code:`VALIDATION_ERROR`,message:`msisdn is required`});return j(e,await R.simulateC2B({shortCode:a??F.c2b?.shortCode??``,commandId:t,amount:n,msisdn:r,apiVersion:F.c2b?.apiVersion??`v2`,...i===void 0?{}:{billRefNumber:i}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/c2b/validation`,async e=>{let t=await e.req.text();await T(A(e),t,t=>e.req.header(t),F);let n=JSON.parse(t),r=F.onC2BValidation?await F.onC2BValidation(n):y();return e.json(r)}),L.post(`/mpesa/c2b/confirmation`,async e=>{let t=await e.req.json();return console.info(`[pesafy/hono] C2B confirmation:`,{txId:t.TransID,amount:t.TransAmount}),P(F.onC2BConfirmation?()=>Promise.resolve(F.onC2BConfirmation(t)):void 0,`onC2BConfirmation`),e.json({ResultCode:0,ResultDesc:`Success`})}),L.post(`/mpesa/qr/generate`,async e=>{try{return j(e,await R.generateDynamicQR(await e.req.json()))}catch(t){return M(e,t)}}),L.post(`/mpesa/balance/query`,async e=>{try{let t=await e.req.json();return j(e,await R.accountBalance({partyA:t.partyA??F.balance?.partyA??``,identifierType:t.identifierType??`4`,resultUrl:N(t.resultUrl,F.balance?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t.queueTimeoutUrl,F.balance?.queueTimeoutUrl,F.queueTimeoutUrl),...t.remarks===void 0?{}:{remarks:t.remarks}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/balance/result`,async e=>{let n=await e.req.json();if(_(n)){let e=i(n);console.info(`[pesafy/hono] Balance result:`,e?t(e):n)}else console.warn(`[pesafy/hono] Balance failed:`,n);return P(F.onAccountBalanceResult?()=>Promise.resolve(F.onAccountBalanceResult(n)):void 0,`onAccountBalanceResult`),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/reversal/request`,async e=>{try{let t=await e.req.json();if(!t.transactionId)throw new g({code:`VALIDATION_ERROR`,message:`transactionId is required`});if(!t.receiverParty)throw new g({code:`VALIDATION_ERROR`,message:`receiverParty is required`});if(!t.amount||t.amount<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});return j(e,await R.reverseTransaction({transactionId:t.transactionId,receiverParty:t.receiverParty,amount:t.amount,resultUrl:N(t.resultUrl,F.reversal?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t.queueTimeoutUrl,F.reversal?.queueTimeoutUrl,F.queueTimeoutUrl),...t.remarks===void 0?{}:{remarks:t.remarks},...t.occasion===void 0?{}:{occasion:t.occasion}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/reversal/result`,async e=>{let t=await e.req.json();return f(t)&&(S(t)?console.info(`[pesafy/hono] Reversal success:`,d(t)):console.warn(`[pesafy/hono] Reversal failed:`,t.Result.ResultDesc),P(F.onReversalResult?()=>Promise.resolve(F.onReversalResult(t)):void 0,`onReversalResult`)),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/tx-status/query`,async e=>{try{let t=await e.req.json();return j(e,await R.transactionStatus({...t.transactionId===void 0?{}:{transactionId:t.transactionId},...t.originalConversationId===void 0?{}:{originalConversationId:t.originalConversationId},partyA:t.partyA,identifierType:t.identifierType,resultUrl:N(t.resultUrl,F.txStatus?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t.queueTimeoutUrl,F.txStatus?.queueTimeoutUrl,F.queueTimeoutUrl),...t.remarks===void 0?{}:{remarks:t.remarks},...t.occasion===void 0?{}:{occasion:t.occasion}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/tx-status/result`,async e=>{let t=await e.req.json();return w(t)&&(u(t)?console.info(`[pesafy/hono] Tx-status success:`,t.Result.TransactionID):console.warn(`[pesafy/hono] Tx-status failed:`,t.Result.ResultDesc),P(F.onTxStatusResult?()=>Promise.resolve(F.onTxStatusResult(t)):void 0,`onTxStatusResult`)),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/tax/remit`,async e=>{try{let t=await e.req.json();if(!t.amount||t.amount<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!t.accountReference)throw new g({code:`VALIDATION_ERROR`,message:`accountReference (KRA PRN) is required`});return j(e,await R.remitTax({amount:t.amount,partyA:t.partyA??F.tax?.partyA??``,accountReference:t.accountReference,resultUrl:N(t.resultUrl,F.tax?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t.queueTimeoutUrl,F.tax?.queueTimeoutUrl,F.queueTimeoutUrl),...t.partyB===void 0?{}:{partyB:t.partyB},...t.remarks===void 0?{}:{remarks:t.remarks}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/tax/result`,async e=>{let t=await e.req.json();return v(t)&&(E(t)?console.info(`[pesafy/hono] Tax success:`,t.Result.TransactionID):console.warn(`[pesafy/hono] Tax failed:`,t.Result.ResultDesc),P(F.onTaxResult?()=>Promise.resolve(F.onTaxResult(t)):void 0,`onTaxResult`)),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/b2b/checkout`,async e=>{try{let t=await e.req.json();if(!t.primaryShortCode)throw new g({code:`VALIDATION_ERROR`,message:`primaryShortCode is required`});if(!t.amount||t.amount<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});let n=t.receiverShortCode??F.b2b?.receiverShortCode??``,r=t.callbackUrl??F.b2b?.callbackUrl??``;if(!n)throw new g({code:`VALIDATION_ERROR`,message:`receiverShortCode is required`});if(!r)throw new g({code:`VALIDATION_ERROR`,message:`callbackUrl is required`});return j(e,await R.b2bExpressCheckout({primaryShortCode:t.primaryShortCode,receiverShortCode:n,amount:t.amount,paymentRef:t.paymentRef,callbackUrl:r,partnerName:t.partnerName,...t.requestRefId===void 0?{}:{requestRefId:t.requestRefId}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/b2b/callback`,async e=>{let t=await e.req.json();if(!o(t))return console.warn(`[pesafy/hono] Unknown B2B callback`),e.json({ResultCode:0,ResultDesc:`Accepted`});let i=t;return n(i)?console.info(`[pesafy/hono] B2B success:`,{txId:D(i),amount:a(i)}):r(i)?console.warn(`[pesafy/hono] B2B cancelled`):console.warn(`[pesafy/hono] B2B failed:`,i.resultDesc),P(F.onB2BCheckoutCallback?()=>Promise.resolve(F.onB2BCheckoutCallback(i)):void 0,`onB2BCheckoutCallback`),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/b2c/payment`,async e=>{try{let t=await e.req.json();if(t.commandId!==`BusinessPayToBulk`)throw new g({code:`VALIDATION_ERROR`,message:`commandId must be "BusinessPayToBulk"`});if(!t.amount||t.amount<=0)throw new g({code:`VALIDATION_ERROR`,message:`amount must be > 0`});if(!t.partyB)throw new g({code:`VALIDATION_ERROR`,message:`partyB is required`});if(!t.accountReference)throw new g({code:`VALIDATION_ERROR`,message:`accountReference is required`});return j(e,await R.b2cPayment({commandId:`BusinessPayToBulk`,amount:t.amount,partyA:t.partyA??F.b2c?.partyA??``,partyB:t.partyB,accountReference:t.accountReference,resultUrl:N(t.resultUrl,F.b2c?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t.queueTimeoutUrl,F.b2c?.queueTimeoutUrl,F.queueTimeoutUrl),...t.requester===void 0?{}:{requester:t.requester},...t.remarks===void 0?{}:{remarks:t.remarks}}))}catch(t){return M(e,t)}}),L.post(`/mpesa/b2c/result`,async e=>{let t=await e.req.json();return l(t)&&(O(t)?console.info(`[pesafy/hono] B2C success:`,{txId:k(t),amount:s(t)}):console.warn(`[pesafy/hono] B2C failed:`,t.Result.ResultDesc),P(F.onB2CResult?()=>Promise.resolve(F.onB2CResult(t)):void 0,`onB2CResult`)),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/b2c/disburse`,async e=>{try{let{queueTimeoutUrl:t,resultUrl:n,...r}=await e.req.json();return j(e,await R.b2cDisbursement({...r,resultUrl:N(n,F.b2c?.resultUrl,F.resultUrl),queueTimeOutUrl:N(t,F.b2c?.queueTimeoutUrl,F.queueTimeoutUrl)}))}catch(t){return M(e,t)}}),L.post(`/mpesa/b2c/disburse/result`,async e=>{let t=await e.req.json();return m(t)&&(p(t)?console.info(`[pesafy/hono] Disbursement success:`,t.Result.TransactionID):console.warn(`[pesafy/hono] Disbursement failed:`,t.Result.ResultDesc),P(F.onB2CDisbursementResult?()=>Promise.resolve(F.onB2CDisbursementResult(t)):void 0,`onB2CDisbursementResult`)),e.json({ResultCode:0,ResultDesc:`Accepted`})}),L.post(`/mpesa/bills/optin`,async e=>{try{return j(e,await R.billManagerOptIn(await e.req.json()))}catch(t){return M(e,t)}}),L.patch(`/mpesa/bills/optin`,async e=>{try{return j(e,await R.updateOptIn(await e.req.json()))}catch(t){return M(e,t)}}),L.post(`/mpesa/bills/invoice`,async e=>{try{return j(e,await R.sendInvoice(await e.req.json()))}catch(t){return M(e,t)}}),L.post(`/mpesa/bills/invoice/bulk`,async e=>{try{return j(e,await R.sendBulkInvoices(await e.req.json()))}catch(t){return M(e,t)}}),L.delete(`/mpesa/bills/invoice`,async e=>{try{return j(e,await R.cancelInvoice(await e.req.json()))}catch(t){return M(e,t)}}),L.delete(`/mpesa/bills/invoice/bulk`,async e=>{try{return j(e,await R.cancelBulkInvoices(await e.req.json()))}catch(t){return M(e,t)}}),L.post(`/mpesa/bills/reconcile`,async e=>{try{return j(e,await R.reconcilePayment(await e.req.json()))}catch(t){return M(e,t)}}),L.get(`/mpesa/health`,e=>e.json({ok:!0,environment:R.environment,ts:new Date().toISOString()})),L}function I(e){let t=new b(e);return async(e,n)=>{e.set(`mpesa`,t),await n()}}export{F as createMpesaHono,I as mpesaMiddleware};
+import { a as PesafyError, i as Mpesa, n as getRoutePaths, r as createRouteHandlers, t as ROUTE_DEFINITIONS } from "../route-definitions.js";
+import { Hono } from "hono";
+
+//#region src/adapters/shared/mount-hono.ts
+const HONO_ROUTE_PATHS = getRoutePaths();
+function getIP(c) {
+	return c.req.header("x-forwarded-for")?.split(",")[0]?.trim() ?? c.req.header("cf-connecting-ip") ?? c.req.header("x-real-ip") ?? "";
+}
+function sendErr(c, err) {
+	if (err instanceof PesafyError) return c.json({
+		ok: false,
+		error: err.code,
+		message: err.message
+	}, err.statusCode ?? 400);
+	return c.json({
+		ok: false,
+		error: "INTERNAL_ERROR",
+		message: "Unexpected error"
+	}, 500);
+}
+function sendHandlerResult(c, result, routeId) {
+	if (routeId === "health") return c.json(result.body);
+	if (result.type === "daraja") return c.json(result.body);
+	return c.json({
+		ok: true,
+		data: result.body
+	});
+}
+async function buildContext(c, isWebhook) {
+	if (isWebhook) {
+		const rawBody = await c.req.text();
+		return {
+			body: JSON.parse(rawBody),
+			rawBody,
+			requestIP: getIP(c),
+			getHeader: (name) => c.req.header(name)
+		};
+	}
+	return {
+		body: c.req.method === "GET" ? void 0 : await c.req.json().catch(() => ({})),
+		requestIP: getIP(c),
+		getHeader: (name) => c.req.header(name)
+	};
+}
+function mountHonoRoutes(config) {
+	const app = new Hono();
+	const mpesa = new Mpesa(config);
+	const prefix = config.routePrefix ?? "";
+	const handlers = createRouteHandlers(mpesa, config);
+	app.use("*", async (c, next) => {
+		c.set("mpesa", mpesa);
+		await next();
+	});
+	for (const route of ROUTE_DEFINITIONS) {
+		const handler = handlers[route.id];
+		const path = `${prefix}${route.path}`;
+		const isWebhook = route.webhook ?? false;
+		const run = async (c) => {
+			try {
+				return sendHandlerResult(c, await handler(await buildContext(c, isWebhook)), route.id);
+			} catch (e) {
+				return sendErr(c, e);
+			}
+		};
+		switch (route.method) {
+			case "GET":
+				app.get(path, run);
+				break;
+			case "POST":
+				app.post(path, run);
+				break;
+			case "PATCH":
+				app.patch(path, run);
+				break;
+			case "DELETE":
+				app.delete(path, run);
+				break;
+		}
+	}
+	return app;
+}
+
+//#endregion
+//#region src/adapters/hono.ts
+/**
+* Creates a Hono app with all M-PESA routes.
+* Mount it on your main app with `app.route('/api', createMpesaHono(config))`.
+*/
+function createMpesaHono(config) {
+	return mountHonoRoutes(config);
+}
+/**
+* Returns a Hono middleware that injects an Mpesa instance into context.
+*/
+function mpesaMiddleware(config) {
+	const mpesa = new Mpesa(config);
+	return async (c, next) => {
+		c.set("mpesa", mpesa);
+		await next();
+	};
+}
+
+//#endregion
+export { createMpesaHono, createMpesaHono as createMpesaHonoRouter, mpesaMiddleware };
+//# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","names":["HonoApp"],"sources":["../../src/adapters/shared/mount-hono.ts","../../src/adapters/hono.ts"],"sourcesContent":["import { Hono as HonoApp, type Context, type Hono } from 'hono'\nimport { Mpesa } from '../../mpesa'\nimport { PesafyError } from '../../utils/errors'\nimport { createRouteHandlers } from './handlers'\nimport { ROUTE_DEFINITIONS, getRoutePaths } from './route-definitions'\n\nexport const HONO_ROUTE_PATHS = getRoutePaths()\nimport type { HandlerContext, HandlerResult, MpesaAdapterConfig } from './types'\n\nfunction getIP(c: Context): string {\n  return (\n    c.req.header('x-forwarded-for')?.split(',')[0]?.trim() ??\n    c.req.header('cf-connecting-ip') ??\n    c.req.header('x-real-ip') ??\n    ''\n  )\n}\n\nfunction sendErr(c: Context, err: unknown): Response {\n  if (err instanceof PesafyError) {\n    return c.json(\n      { ok: false, error: err.code, message: err.message },\n      (err.statusCode ?? 400) as 400 | 401 | 403 | 404 | 422 | 429 | 500,\n    )\n  }\n  return c.json({ ok: false, error: 'INTERNAL_ERROR', message: 'Unexpected error' }, 500)\n}\n\nfunction sendHandlerResult(c: Context, result: HandlerResult, routeId: string): Response {\n  if (routeId === 'health') {\n    return c.json(result.body)\n  }\n  if (result.type === 'daraja') {\n    return c.json(result.body)\n  }\n  return c.json({ ok: true, data: result.body })\n}\n\nasync function buildContext(c: Context, isWebhook: boolean): Promise<HandlerContext> {\n  if (isWebhook) {\n    const rawBody = await c.req.text()\n    return {\n      body: JSON.parse(rawBody) as unknown,\n      rawBody,\n      requestIP: getIP(c),\n      getHeader: (name) => c.req.header(name),\n    }\n  }\n  const body =\n    c.req.method === 'GET' ? undefined : ((await c.req.json().catch(() => ({}))) as unknown)\n  return {\n    body,\n    requestIP: getIP(c),\n    getHeader: (name) => c.req.header(name),\n  }\n}\n\nexport function mountHonoRoutes(config: MpesaAdapterConfig): Hono {\n  const app = new HonoApp()\n  const mpesa = new Mpesa(config)\n  const prefix = config.routePrefix ?? ''\n  const handlers = createRouteHandlers(mpesa, config)\n\n  app.use('*', async (c, next) => {\n    c.set('mpesa', mpesa)\n    await next()\n  })\n\n  for (const route of ROUTE_DEFINITIONS) {\n    const handler = handlers[route.id]\n    const path = `${prefix}${route.path}`\n    const isWebhook = route.webhook ?? false\n\n    const run = async (c: Context) => {\n      try {\n        const ctx = await buildContext(c, isWebhook)\n        const result = await handler(ctx)\n        return sendHandlerResult(c, result, route.id)\n      } catch (e) {\n        return sendErr(c, e)\n      }\n    }\n\n    switch (route.method) {\n      case 'GET':\n        app.get(path, run)\n        break\n      case 'POST':\n        app.post(path, run)\n        break\n      case 'PATCH':\n        app.patch(path, run)\n        break\n      case 'DELETE':\n        app.delete(path, run)\n        break\n    }\n  }\n\n  return app\n}\n","/**\n * @file src/adapters/hono.ts\n * Hono adapter for pesafy — works on Node.js, Bun, Deno, and Cloudflare Workers.\n *\n * Usage:\n *   import { Hono } from 'hono'\n *   import { createMpesaHono } from 'pesafy/adapters/hono'\n *\n *   const app = new Hono()\n *   app.route('/api', createMpesaHono(config))\n */\n\nimport { type Hono, type MiddlewareHandler } from 'hono'\nimport { Mpesa } from '../mpesa'\nimport { mountHonoRoutes } from './shared/mount-hono'\nimport type { MpesaAdapterConfig, StkFailurePayload, StkSuccessPayload } from './shared/types'\n\nexport type MpesaHonoConfig = MpesaAdapterConfig\nexport type { StkSuccessPayload, StkFailurePayload }\n\n/**\n * Creates a Hono app with all M-PESA routes.\n * Mount it on your main app with `app.route('/api', createMpesaHono(config))`.\n */\nexport function createMpesaHono(config: MpesaHonoConfig): Hono {\n  return mountHonoRoutes(config)\n}\n\nexport { createMpesaHono as createMpesaHonoRouter }\n\n/**\n * Returns a Hono middleware that injects an Mpesa instance into context.\n */\nexport function mpesaMiddleware(config: MpesaHonoConfig): MiddlewareHandler {\n  const mpesa = new Mpesa(config)\n  return async (c, next) => {\n    c.set('mpesa', mpesa)\n    await next()\n  }\n}\n\ndeclare module 'hono' {\n  interface ContextVariableMap {\n    mpesa: Mpesa\n  }\n}\n"],"mappings":";;;;AAMA,MAAa,mBAAmB,eAAe;AAG/C,SAAS,MAAM,GAAoB;AACjC,QACE,EAAE,IAAI,OAAO,kBAAkB,EAAE,MAAM,IAAI,CAAC,IAAI,MAAM,IACtD,EAAE,IAAI,OAAO,mBAAmB,IAChC,EAAE,IAAI,OAAO,YAAY,IACzB;;AAIJ,SAAS,QAAQ,GAAY,KAAwB;AACnD,KAAI,eAAe,YACjB,QAAO,EAAE,KACP;EAAE,IAAI;EAAO,OAAO,IAAI;EAAM,SAAS,IAAI;EAAS,EACnD,IAAI,cAAc,IACpB;AAEH,QAAO,EAAE,KAAK;EAAE,IAAI;EAAO,OAAO;EAAkB,SAAS;EAAoB,EAAE,IAAI;;AAGzF,SAAS,kBAAkB,GAAY,QAAuB,SAA2B;AACvF,KAAI,YAAY,SACd,QAAO,EAAE,KAAK,OAAO,KAAK;AAE5B,KAAI,OAAO,SAAS,SAClB,QAAO,EAAE,KAAK,OAAO,KAAK;AAE5B,QAAO,EAAE,KAAK;EAAE,IAAI;EAAM,MAAM,OAAO;EAAM,CAAC;;AAGhD,eAAe,aAAa,GAAY,WAA6C;AACnF,KAAI,WAAW;EACb,MAAM,UAAU,MAAM,EAAE,IAAI,MAAM;AAClC,SAAO;GACL,MAAM,KAAK,MAAM,QAAQ;GACzB;GACA,WAAW,MAAM,EAAE;GACnB,YAAY,SAAS,EAAE,IAAI,OAAO,KAAK;GACxC;;AAIH,QAAO;EACL,MAFA,EAAE,IAAI,WAAW,QAAQ,SAAc,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,EAAE;EAG3E,WAAW,MAAM,EAAE;EACnB,YAAY,SAAS,EAAE,IAAI,OAAO,KAAK;EACxC;;AAGH,SAAgB,gBAAgB,QAAkC;CAChE,MAAM,MAAM,IAAIA,MAAS;CACzB,MAAM,QAAQ,IAAI,MAAM,OAAO;CAC/B,MAAM,SAAS,OAAO,eAAe;CACrC,MAAM,WAAW,oBAAoB,OAAO,OAAO;AAEnD,KAAI,IAAI,KAAK,OAAO,GAAG,SAAS;AAC9B,IAAE,IAAI,SAAS,MAAM;AACrB,QAAM,MAAM;GACZ;AAEF,MAAK,MAAM,SAAS,mBAAmB;EACrC,MAAM,UAAU,SAAS,MAAM;EAC/B,MAAM,OAAO,GAAG,SAAS,MAAM;EAC/B,MAAM,YAAY,MAAM,WAAW;EAEnC,MAAM,MAAM,OAAO,MAAe;AAChC,OAAI;AAGF,WAAO,kBAAkB,GADV,MAAM,QADT,MAAM,aAAa,GAAG,UAAU,CACX,EACG,MAAM,GAAG;YACtC,GAAG;AACV,WAAO,QAAQ,GAAG,EAAE;;;AAIxB,UAAQ,MAAM,QAAd;GACE,KAAK;AACH,QAAI,IAAI,MAAM,IAAI;AAClB;GACF,KAAK;AACH,QAAI,KAAK,MAAM,IAAI;AACnB;GACF,KAAK;AACH,QAAI,MAAM,MAAM,IAAI;AACpB;GACF,KAAK;AACH,QAAI,OAAO,MAAM,IAAI;AACrB;;;AAIN,QAAO;;;;;;;;;AC3ET,SAAgB,gBAAgB,QAA+B;AAC7D,QAAO,gBAAgB,OAAO;;;;;AAQhC,SAAgB,gBAAgB,QAA4C;CAC1E,MAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,QAAO,OAAO,GAAG,SAAS;AACxB,IAAE,IAAI,SAAS,MAAM;AACrB,QAAM,MAAM"}