@fire-spark/payments-deuna-widget 0.12.0 → 0.12.2

package/dist/index.d.ts

@@ -99,9 +99,10 @@ type DeunaWidgetOutcome =
   by: "user" | "system";
 };
 /**
- * Implemented once per template with the DEUNA SDK
- * (`@deuna/react-native-sdk` or the Web SDK). It opens the widget with the
- * given order token and resolves with the first final callback.
+ * Implemented once per template with the DEUNA Web SDK (in the page, or in
+ * a `react-native-webview` on React Native) or `@deuna/react-native-sdk`.
+ * It opens the widget with the given order token and resolves with the
+ * first final callback.
  */
 type DeunaWidgetBridge = {
   open(input: DeunaWidgetOpenInput): Promise<DeunaWidgetOutcome>;
@@ -126,6 +127,8 @@ type DeunaOrderState = {
   order_token: string;
   status: DeunaPaymentStatus | (string & {});
   transaction_id?: string | null;
+  /** Processor DEUNA charged with (`payment.data.processor`), if reported. */
+  processor?: string | null;
   /** DEUNA `error.code` (core, `DP-`, `EMA-`…) when the payment failed. */
   error?: {
     code: string | null;
@@ -160,10 +163,27 @@ type DeunaWidgetOptions = {
 };
 /** Processors this method can charge with. */
 declare const deunaProcessorsFor: (method: DeunaWidgetMethod) => ("card" | "daviplata" | "deuna_wallet" | "mercadopago" | "nequi" | "pse")[];
-/** `payments.config.processor`; optional when the method has only one. */
+/**
+ * Processors one charge opens the widget with. `config.processors` lists
+ * the processors the payment enables (same DEUNA credentials); a channel
+ * that shows one option per processor sets the customer's pick in
+ * `config.processor`, which wins: the widget opens only that one. Without
+ * a pick every enabled processor is offered and the customer chooses in
+ * the widget. A legacy payment has only `config.processor`; it is
+ * optional when the method has one processor. Kept in `DEUNA_PROCESSORS`
+ * order.
+ */
+declare const resolveDeunaProcessors: (method: DeunaWidgetMethod, config: Record<string, unknown>) => DeunaProcessor[];
+/** @deprecated Use `resolveDeunaProcessors`: first configured processor. */
 declare const resolveDeunaProcessor: (method: DeunaWidgetMethod, config: Record<string, unknown>) => DeunaProcessor;
-/** `paymentMethods` of `initPaymentWidget` for a processor. */
-declare const deunaWidgetPaymentMethods: (processor: DeunaProcessor) => DeunaWidgetPaymentMethod[];
+/**
+ * `paymentMethods` of `initPaymentWidget`: one entry per widget method, with
+ * the DEUNA processors of every configured processor that uses it. One entry
+ * opens its form directly; several let the customer choose.
+ */
+declare const deunaWidgetPaymentMethods: (processors: DeunaProcessor | readonly DeunaProcessor[]) => DeunaWidgetPaymentMethod[];
+/** Our processor key for the processor DEUNA reports on the order. */
+declare const deunaProcessorFromState: (candidates: readonly DeunaProcessor[], reported: string | null | undefined) => DeunaProcessor | null;
 /**
  * DEUNA Payment Widget for every method (card, Nequi, Mercado Pago, Deuna
  * App Wallet, PSE). Spark tokenizes the DEUNA order with the private key
@@ -300,4 +320,4 @@ declare const deunaStateError: (input: {
   attempt: number;
 }) => StandardPaymentError;
 //#endregion
-export { DEUNA_PROCESSORS, DEUNA_PROCESSOR_KEYS, DEUNA_PROVIDER, DEUNA_WIDGET_POLICY, type DeunaCallbackUrls, type DeunaOrderState, type DeunaPaymentStatus, DeunaProcessor, DeunaStatusMapping, type DeunaTokenizeInput, type DeunaTokenizeOutput, type DeunaWidgetApi, type DeunaWidgetBridge, type DeunaWidgetLanguage, type DeunaWidgetMethod, type DeunaWidgetOpenInput, DeunaWidgetOptions, type DeunaWidgetOutcome, type DeunaWidgetPaymentMethod, deunaDeclinedCode, deunaErrors, deunaProcessorsFor, deunaStateError, deunaWidgetPaymentMethods, deunaWidgetPayments, mapDeunaStatus, orderTokenKey, resolveDeunaProcessor };
+export { DEUNA_PROCESSORS, DEUNA_PROCESSOR_KEYS, DEUNA_PROVIDER, DEUNA_WIDGET_POLICY, type DeunaCallbackUrls, type DeunaOrderState, type DeunaPaymentStatus, DeunaProcessor, DeunaStatusMapping, type DeunaTokenizeInput, type DeunaTokenizeOutput, type DeunaWidgetApi, type DeunaWidgetBridge, type DeunaWidgetLanguage, type DeunaWidgetMethod, type DeunaWidgetOpenInput, DeunaWidgetOptions, type DeunaWidgetOutcome, type DeunaWidgetPaymentMethod, deunaDeclinedCode, deunaErrors, deunaProcessorFromState, deunaProcessorsFor, deunaStateError, deunaWidgetPaymentMethods, deunaWidgetPayments, mapDeunaStatus, orderTokenKey, resolveDeunaProcessor, resolveDeunaProcessors };

package/dist/index.js

@@ -246,26 +246,75 @@ const deunaProcessorsFor = (method) => {
 		return DEUNA_PROCESSORS[key].method === method;
 	});
 };
-/** `payments.config.processor`; optional when the method has only one. */
-const resolveDeunaProcessor = (method, config) => {
-	const allowed = deunaProcessorsFor(method);
-	const value = config.processor;
-	const known = allowed.find((key) => key === value);
-	if (known) return known;
-	const only = allowed.length === 1 ? allowed[0] : void 0;
-	if (value == null && only) return only;
+/** `config.processors`, else the legacy single `config.processor`. */
+const configuredValues = (config) => {
+	if (Array.isArray(config.processors)) return config.processors;
+	return config.processor == null ? [] : [config.processor];
+};
+const unsupported = (method, value) => {
 	const message = `Unsupported DEUNA processor for ${method}: ${String(value)}`;
-	throw fail("INVALID_REQUEST", message);
+	return fail("INVALID_REQUEST", message);
+};
+/**
+* Processors one charge opens the widget with. `config.processors` lists
+* the processors the payment enables (same DEUNA credentials); a channel
+* that shows one option per processor sets the customer's pick in
+* `config.processor`, which wins: the widget opens only that one. Without
+* a pick every enabled processor is offered and the customer chooses in
+* the widget. A legacy payment has only `config.processor`; it is
+* optional when the method has one processor. Kept in `DEUNA_PROCESSORS`
+* order.
+*/
+const resolveDeunaProcessors = (method, config) => {
+	const allowed = deunaProcessorsFor(method);
+	const values = configuredValues(config);
+	const unknown = values.find((value) => !allowed.some((key) => key === value));
+	if (unknown !== void 0) throw unsupported(method, unknown);
+	const enabled = allowed.filter((key) => values.includes(key));
+	if (config.processor != null) {
+		const chosen = allowed.find((key) => key === config.processor);
+		if (!chosen) throw unsupported(method, config.processor);
+		if (enabled.length && !enabled.includes(chosen)) {
+			const message = `DEUNA processor ${chosen} is not enabled for ${method}`;
+			throw fail("INVALID_REQUEST", message);
+		}
+		return [chosen];
+	}
+	if (enabled.length) return enabled;
+	if (allowed.length === 1) return allowed;
+	throw fail("INVALID_REQUEST", `Missing DEUNA processor for ${method}`);
+};
+/** @deprecated Use `resolveDeunaProcessors`: first configured processor. */
+const resolveDeunaProcessor = (method, config) => {
+	return resolveDeunaProcessors(method, config)[0];
+};
+/**
+* `paymentMethods` of `initPaymentWidget`: one entry per widget method, with
+* the DEUNA processors of every configured processor that uses it. One entry
+* opens its form directly; several let the customer choose.
+*/
+const deunaWidgetPaymentMethods = (processors) => {
+	const list = typeof processors === "string" ? [processors] : processors;
+	const entries = [];
+	for (const processor of list) {
+		const entry = DEUNA_PROCESSORS[processor];
+		const found = entries.find((e) => e.paymentMethod === entry.paymentMethod);
+		const target = found ?? { paymentMethod: entry.paymentMethod };
+		if (!found) entries.push(target);
+		if (!entry.processors.length) continue;
+		target.processors = [...target.processors ?? [], ...entry.processors];
+	}
+	return entries;
 };
-/** `paymentMethods` of `initPaymentWidget` for a processor. */
-const deunaWidgetPaymentMethods = (processor) => {
-	const entry = DEUNA_PROCESSORS[processor];
-	const base = { paymentMethod: entry.paymentMethod };
-	if (!entry.processors.length) return [base];
-	return [{
-		...base,
-		processors: [...entry.processors]
-	}];
+/** Our processor key for the processor DEUNA reports on the order. */
+const deunaProcessorFromState = (candidates, reported) => {
+	if (candidates.length === 1) return candidates[0] ?? null;
+	if (!reported) return null;
+	const value = reported.toLowerCase();
+	return candidates.find((key) => {
+		const names = DEUNA_PROCESSORS[key].processors;
+		return key === value || names.includes(value);
+	}) ?? null;
 };
 const publicKeyOf = (config) => {
 	const key = config.public_key;
@@ -273,7 +322,7 @@ const publicKeyOf = (config) => {
 	throw fail("INVALID_CREDENTIALS", "Missing DEUNA public_key");
 };
 /** Card brand and last 4 are not exposed by the widget: no card details. */
-const detailsOf = (charge, reference) => {
+const detailsOf = (charge, processor, reference) => {
 	if (charge.method === "CARD") return null;
 	if (charge.method === "BANK_TRANSFER") return {
 		method: "BANK_TRANSFER",
@@ -281,7 +330,7 @@ const detailsOf = (charge, reference) => {
 	};
 	return {
 		method: "WALLET",
-		wallet: charge.processor,
+		wallet: processor ?? "deuna",
 		reference
 	};
 };
@@ -290,9 +339,12 @@ const toResult = (ctx, charge, state, base) => {
 	const mapped = mapDeunaStatus(state.status, charge.method);
 	const transactionId = state.transaction_id ?? null;
 	const previous = record(base?.metadata.provider);
+	const known = deunaProcessorFromState(charge.processors, state.processor);
+	const kept = typeof previous.processor === "string" ? previous.processor : null;
+	const processor = known ?? kept;
 	const p1 = {
 		order_token: state.order_token,
-		processor: charge.processor
+		processor
 	};
 	const p2 = {
 		status: state.status,
@@ -314,7 +366,7 @@ const toResult = (ctx, charge, state, base) => {
 		provider
 	};
 	const amount = base?.amount ?? ctx.amount.value;
-	const details = detailsOf(charge, reference);
+	const details = detailsOf(charge, processor, reference);
 	if (mapped.status !== "FAILED") return {
 		status: mapped.status,
 		amount,
@@ -369,7 +421,7 @@ const deunaWidgetPayments = (options) => {
 	const chargeOf = (ctx) => {
 		return {
 			method,
-			processor: resolveDeunaProcessor(method, ctx.config)
+			processors: resolveDeunaProcessors(method, ctx.config)
 		};
 	};
 	const orderState = (ctx, orderToken) => {
@@ -426,7 +478,7 @@ const deunaWidgetPayments = (options) => {
 			...t3
 		})).order_token;
 		await ctx.storage.set(orderTokenKey(ctx.attemptReference), orderToken);
-		const paymentMethods = deunaWidgetPaymentMethods(charge.processor);
+		const paymentMethods = deunaWidgetPaymentMethods(charge.processors);
 		const o1 = {
 			publicApiKey,
 			environment: ctx.environment,
@@ -456,6 +508,16 @@ const deunaWidgetPayments = (options) => {
 			status: "CANCELLED"
 		};
 	};
+	/**
+	* A paid DEUNA charge is reversed by Spark with the private key when the
+	* order is cancelled or refunded (`server`); DaviPlata has no refund API
+	* (`manual`). An unpaid one is only dropped on the device.
+	*/
+	const reversalFor = (result) => {
+		if (result.status !== "PAID") return "cancel";
+		if (record(result.metadata.provider).processor === "daviplata") return "manual";
+		return "server";
+	};
 	return {
 		provider: DEUNA_PROVIDER,
 		method,
@@ -463,8 +525,9 @@ const deunaWidgetPayments = (options) => {
 		policy: DEUNA_WIDGET_POLICY,
 		start,
 		query,
-		cancel
+		cancel,
+		reversalFor
 	};
 };
 //#endregion
-export { DEUNA_PROCESSORS, DEUNA_PROCESSOR_KEYS, DEUNA_PROVIDER, DEUNA_WIDGET_POLICY, deunaDeclinedCode, deunaErrors, deunaProcessorsFor, deunaStateError, deunaWidgetPaymentMethods, deunaWidgetPayments, mapDeunaStatus, orderTokenKey, resolveDeunaProcessor };
+export { DEUNA_PROCESSORS, DEUNA_PROCESSOR_KEYS, DEUNA_PROVIDER, DEUNA_WIDGET_POLICY, deunaDeclinedCode, deunaErrors, deunaProcessorFromState, deunaProcessorsFor, deunaStateError, deunaWidgetPaymentMethods, deunaWidgetPayments, mapDeunaStatus, orderTokenKey, resolveDeunaProcessor, resolveDeunaProcessors };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fire-spark/payments-deuna-widget",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "Fire Spark DEUNA Payment Widget adapter: cards, Nequi, Mercado Pago, Deuna App Wallet and DaviPlata, and PSE through the DEUNA checkout",
   "type": "module",
   "sideEffects": false,
@@ -17,8 +17,8 @@
     }
   },
   "dependencies": {
-    "@fire-spark/payments": "^0.12.0",
-    "@fire-spark/types": "^0.12.0"
+    "@fire-spark/payments": "^0.12.2",
+    "@fire-spark/types": "^0.12.2"
   },
   "devDependencies": {
     "tsdown": "^0.22.14",