@pandait.tech/payment-deuna 1.0.0

package/dist/index.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+// src/client.ts
+function createDeUnaClient(config) {
+  const base = config.baseUrl ?? "https://api.deuna.io/v1";
+  const headers = {
+    "X-Client-Id": config.clientId,
+    "X-Client-Secret": config.clientSecret,
+    "Content-Type": "application/json"
+  };
+  return {
+    async prepare(params, mode = "qr") {
+      const res = await fetch(`${base}/payments/prepare`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          orderRef: params.orderRef,
+          amount: params.amount,
+          currency: "USD",
+          description: params.description ?? params.orderRef,
+          mode,
+          webhookUrl: config.webhookUrl,
+          returnUrl: config.returnUrl
+        })
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`DeUna prepare ${res.status}: ${text}`);
+      }
+      return res.json();
+    },
+    async getStatus(orderRef) {
+      const url = `${base}/payments/status?orderRef=${encodeURIComponent(orderRef)}`;
+      const res = await fetch(url, { method: "GET", headers });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`DeUna getStatus ${res.status}: ${text}`);
+      }
+      return res.json();
+    }
+  };
+}
+
+// src/adapter.ts
+var PAID_STATUS = "PAID";
+function toConfirmResult(s) {
+  if (s.status === PAID_STATUS) return { status: "paid", transactionId: s.transactionId };
+  if (s.status === "FAILED" || s.status === "EXPIRED")
+    return { status: "failed", error: s.message ?? s.status };
+  return { status: "pending" };
+}
+function toDeUnaPaymentMethod(client, opts) {
+  const processed = opts?.processedRefs ?? /* @__PURE__ */ new Set();
+  return {
+    id: "deuna",
+    label: "DeUna (wallet QR \xB7 Banco Pichincha)",
+    async prepare(order) {
+      const result = await client.prepare({
+        orderRef: order.id,
+        amount: order.total,
+        description: `Orden ${order.id}`
+      });
+      return {
+        qrPayload: result.qrPayload,
+        paymentUrl: result.paymentUrl,
+        paymentCode: result.paymentCode,
+        transactionId: result.transactionId,
+        orderId: order.id
+      };
+    },
+    async confirm(ref) {
+      if (opts?.onConfirm) return opts.onConfirm(ref);
+      return toConfirmResult(await client.getStatus(ref));
+    },
+    async handleWebhook(payload) {
+      const p = payload;
+      const orderId = p?.orderRef;
+      if (!orderId) return { handled: false };
+      if (processed.has(orderId)) return { handled: true, orderId };
+      const status = p?.status ?? (await client.getStatus(orderId)).status;
+      if (status !== PAID_STATUS) return { handled: false };
+      processed.add(orderId);
+      return { handled: true, orderId };
+    }
+  };
+}
+
+exports.createDeUnaClient = createDeUnaClient;
+exports.toDeUnaPaymentMethod = toDeUnaPaymentMethod;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/adapter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// DeUna (Banco Pichincha) — cliente HTTP mínimo\n// Wallet QR: genera QR dinámico o link de pago y consulta estado del cobro.\n\nexport interface DeUnaConfig {\n  /** Client ID del comercio (DEUNA_CLIENT_ID). */\n  clientId: string;\n  /** Client Secret del comercio (DEUNA_CLIENT_SECRET). */\n  clientSecret: string;\n  /** URL a la que DeUna notificará el resultado del pago (webhook). */\n  webhookUrl: string;\n  /** URL de retorno después del pago (para link/código). */\n  returnUrl: string;\n  /** ponytail: base URL sobreescribible para tests/staging. */\n  baseUrl?: string;\n}\n\nexport interface PrepareParams {\n  /** Referencia única de la orden. */\n  orderRef: string;\n  /** Monto total en la moneda del comercio (USD). */\n  amount: number;\n  /** Descripción del pedido (aparece en la pantalla del wallet). */\n  description?: string;\n}\n\n/** Modos de cobro que DeUna soporta. */\nexport type DeUnaPrepareMode = \"qr\" | \"link\" | \"code\";\n\nexport interface PrepareResponse {\n  /** Payload del QR dinámico (string para que la UI genere la imagen). */\n  qrPayload?: string;\n  /** Link de pago (alternativa al QR). */\n  paymentUrl?: string;\n  /** Código único de 6 dígitos. */\n  paymentCode?: string;\n  /** ID interno de la transacción en DeUna. */\n  transactionId: string;\n}\n\nexport interface TransactionStatus {\n  transactionId: string;\n  orderRef: string;\n  /** \"PAID\" | \"PENDING\" | \"FAILED\" | \"EXPIRED\" */\n  status: string;\n  authorizationCode?: string;\n  message?: string;\n}\n\nexport interface DeUnaClient {\n  /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */\n  prepare(params: PrepareParams, mode?: DeUnaPrepareMode): Promise<PrepareResponse>;\n  /** Consulta el estado actual de la transacción por orderRef. */\n  getStatus(orderRef: string): Promise<TransactionStatus>;\n}\n\nexport function createDeUnaClient(config: DeUnaConfig): DeUnaClient {\n  const base = config.baseUrl ?? \"https://api.deuna.io/v1\";\n  const headers = {\n    \"X-Client-Id\": config.clientId,\n    \"X-Client-Secret\": config.clientSecret,\n    \"Content-Type\": \"application/json\",\n  };\n\n  return {\n    async prepare(params, mode = \"qr\") {\n      const res = await fetch(`${base}/payments/prepare`, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify({\n          orderRef: params.orderRef,\n          amount: params.amount,\n          currency: \"USD\",\n          description: params.description ?? params.orderRef,\n          mode,\n          webhookUrl: config.webhookUrl,\n          returnUrl: config.returnUrl,\n        }),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`DeUna prepare ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PrepareResponse>;\n    },\n\n    async getStatus(orderRef) {\n      const url = `${base}/payments/status?orderRef=${encodeURIComponent(orderRef)}`;\n      const res = await fetch(url, { method: \"GET\", headers });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`DeUna getStatus ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<TransactionStatus>;\n    },\n  };\n}\n","// Tipos estructuralmente compatibles con payment-core (sin importarlo — evita ciclo).\nimport type { Order } from \"@pandait.tech/commerce-core\";\nimport type { DeUnaClient, TransactionStatus } from \"./client.js\";\n\ninterface ConfirmResult {\n  status: \"paid\" | \"pending\" | \"failed\" | \"challenge\";\n  transactionId?: string;\n  redirectUrl?: string;\n  error?: string;\n}\ninterface WebhookResult {\n  handled: boolean;\n  orderId?: string;\n}\ninterface PaymentMethod {\n  id: string;\n  label: string;\n  prepare(order: Order): Promise<Record<string, unknown>>;\n  confirm(ref: string): Promise<ConfirmResult>;\n  handleWebhook(payload: unknown): Promise<WebhookResult>;\n}\n\nconst PAID_STATUS = \"PAID\";\n\nfunction toConfirmResult(s: TransactionStatus): ConfirmResult {\n  if (s.status === PAID_STATUS) return { status: \"paid\", transactionId: s.transactionId };\n  if (s.status === \"FAILED\" || s.status === \"EXPIRED\")\n    return { status: \"failed\", error: s.message ?? s.status };\n  return { status: \"pending\" };\n}\n\nexport interface DeUnaWebhookPayload {\n  orderRef?: string;\n  transactionId?: string;\n  status?: string;\n  authorizationCode?: string;\n}\n\nexport interface DeUnaPaymentMethodOpts {\n  /**\n   * Set inyectable para idempotencia de webhooks.\n   * ponytail: en memoria por defecto; reemplaza con persistencia en DB para multi-instancia.\n   */\n  processedRefs?: Set<string>;\n  /** Override de confirm para entornos sin acceso directo a la API (tests, staging). */\n  onConfirm?: (ref: string) => Promise<ConfirmResult>;\n}\n\nexport function toDeUnaPaymentMethod(\n  client: DeUnaClient,\n  opts?: DeUnaPaymentMethodOpts,\n): PaymentMethod {\n  // ponytail: in-memory; reemplazar con Set persistido en DB en prod multi-instancia\n  const processed = opts?.processedRefs ?? new Set<string>();\n\n  return {\n    id: \"deuna\",\n    label: \"DeUna (wallet QR · Banco Pichincha)\",\n\n    async prepare(order: Order): Promise<Record<string, unknown>> {\n      const result = await client.prepare({\n        orderRef: order.id,\n        amount: order.total,\n        description: `Orden ${order.id}`,\n      });\n      // Devuelve el payload/string del QR — la UI genera la imagen (ponytail: no generar aquí).\n      return {\n        qrPayload: result.qrPayload,\n        paymentUrl: result.paymentUrl,\n        paymentCode: result.paymentCode,\n        transactionId: result.transactionId,\n        orderId: order.id,\n      };\n    },\n\n    async confirm(ref: string): Promise<ConfirmResult> {\n      if (opts?.onConfirm) return opts.onConfirm(ref);\n      return toConfirmResult(await client.getStatus(ref));\n    },\n\n    async handleWebhook(payload: unknown): Promise<WebhookResult> {\n      const p = payload as DeUnaWebhookPayload | null;\n      const orderId = p?.orderRef;\n      if (!orderId) return { handled: false };\n\n      // Idempotencia: misma referencia no se procesa dos veces\n      if (processed.has(orderId)) return { handled: true, orderId };\n\n      // Si el webhook trae el status directamente lo usamos; si no, consultamos\n      const status = p?.status ?? (await client.getStatus(orderId)).status;\n\n      if (status !== PAID_STATUS) return { handled: false };\n\n      processed.add(orderId);\n      return { handled: true, orderId };\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,85 @@
+import { Order } from '@pandait.tech/commerce-core';
+
+interface DeUnaConfig {
+    /** Client ID del comercio (DEUNA_CLIENT_ID). */
+    clientId: string;
+    /** Client Secret del comercio (DEUNA_CLIENT_SECRET). */
+    clientSecret: string;
+    /** URL a la que DeUna notificará el resultado del pago (webhook). */
+    webhookUrl: string;
+    /** URL de retorno después del pago (para link/código). */
+    returnUrl: string;
+    /** ponytail: base URL sobreescribible para tests/staging. */
+    baseUrl?: string;
+}
+interface PrepareParams {
+    /** Referencia única de la orden. */
+    orderRef: string;
+    /** Monto total en la moneda del comercio (USD). */
+    amount: number;
+    /** Descripción del pedido (aparece en la pantalla del wallet). */
+    description?: string;
+}
+/** Modos de cobro que DeUna soporta. */
+type DeUnaPrepareMode = "qr" | "link" | "code";
+interface PrepareResponse {
+    /** Payload del QR dinámico (string para que la UI genere la imagen). */
+    qrPayload?: string;
+    /** Link de pago (alternativa al QR). */
+    paymentUrl?: string;
+    /** Código único de 6 dígitos. */
+    paymentCode?: string;
+    /** ID interno de la transacción en DeUna. */
+    transactionId: string;
+}
+interface TransactionStatus {
+    transactionId: string;
+    orderRef: string;
+    /** "PAID" | "PENDING" | "FAILED" | "EXPIRED" */
+    status: string;
+    authorizationCode?: string;
+    message?: string;
+}
+interface DeUnaClient {
+    /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */
+    prepare(params: PrepareParams, mode?: DeUnaPrepareMode): Promise<PrepareResponse>;
+    /** Consulta el estado actual de la transacción por orderRef. */
+    getStatus(orderRef: string): Promise<TransactionStatus>;
+}
+declare function createDeUnaClient(config: DeUnaConfig): DeUnaClient;
+
+interface ConfirmResult {
+    status: "paid" | "pending" | "failed" | "challenge";
+    transactionId?: string;
+    redirectUrl?: string;
+    error?: string;
+}
+interface WebhookResult {
+    handled: boolean;
+    orderId?: string;
+}
+interface PaymentMethod {
+    id: string;
+    label: string;
+    prepare(order: Order): Promise<Record<string, unknown>>;
+    confirm(ref: string): Promise<ConfirmResult>;
+    handleWebhook(payload: unknown): Promise<WebhookResult>;
+}
+interface DeUnaWebhookPayload {
+    orderRef?: string;
+    transactionId?: string;
+    status?: string;
+    authorizationCode?: string;
+}
+interface DeUnaPaymentMethodOpts {
+    /**
+     * Set inyectable para idempotencia de webhooks.
+     * ponytail: en memoria por defecto; reemplaza con persistencia en DB para multi-instancia.
+     */
+    processedRefs?: Set<string>;
+    /** Override de confirm para entornos sin acceso directo a la API (tests, staging). */
+    onConfirm?: (ref: string) => Promise<ConfirmResult>;
+}
+declare function toDeUnaPaymentMethod(client: DeUnaClient, opts?: DeUnaPaymentMethodOpts): PaymentMethod;
+
+export { type DeUnaClient, type DeUnaConfig, type DeUnaPaymentMethodOpts, type DeUnaPrepareMode, type DeUnaWebhookPayload, type PrepareParams, type PrepareResponse, type TransactionStatus, createDeUnaClient, toDeUnaPaymentMethod };

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+import { Order } from '@pandait.tech/commerce-core';
+
+interface DeUnaConfig {
+    /** Client ID del comercio (DEUNA_CLIENT_ID). */
+    clientId: string;
+    /** Client Secret del comercio (DEUNA_CLIENT_SECRET). */
+    clientSecret: string;
+    /** URL a la que DeUna notificará el resultado del pago (webhook). */
+    webhookUrl: string;
+    /** URL de retorno después del pago (para link/código). */
+    returnUrl: string;
+    /** ponytail: base URL sobreescribible para tests/staging. */
+    baseUrl?: string;
+}
+interface PrepareParams {
+    /** Referencia única de la orden. */
+    orderRef: string;
+    /** Monto total en la moneda del comercio (USD). */
+    amount: number;
+    /** Descripción del pedido (aparece en la pantalla del wallet). */
+    description?: string;
+}
+/** Modos de cobro que DeUna soporta. */
+type DeUnaPrepareMode = "qr" | "link" | "code";
+interface PrepareResponse {
+    /** Payload del QR dinámico (string para que la UI genere la imagen). */
+    qrPayload?: string;
+    /** Link de pago (alternativa al QR). */
+    paymentUrl?: string;
+    /** Código único de 6 dígitos. */
+    paymentCode?: string;
+    /** ID interno de la transacción en DeUna. */
+    transactionId: string;
+}
+interface TransactionStatus {
+    transactionId: string;
+    orderRef: string;
+    /** "PAID" | "PENDING" | "FAILED" | "EXPIRED" */
+    status: string;
+    authorizationCode?: string;
+    message?: string;
+}
+interface DeUnaClient {
+    /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */
+    prepare(params: PrepareParams, mode?: DeUnaPrepareMode): Promise<PrepareResponse>;
+    /** Consulta el estado actual de la transacción por orderRef. */
+    getStatus(orderRef: string): Promise<TransactionStatus>;
+}
+declare function createDeUnaClient(config: DeUnaConfig): DeUnaClient;
+
+interface ConfirmResult {
+    status: "paid" | "pending" | "failed" | "challenge";
+    transactionId?: string;
+    redirectUrl?: string;
+    error?: string;
+}
+interface WebhookResult {
+    handled: boolean;
+    orderId?: string;
+}
+interface PaymentMethod {
+    id: string;
+    label: string;
+    prepare(order: Order): Promise<Record<string, unknown>>;
+    confirm(ref: string): Promise<ConfirmResult>;
+    handleWebhook(payload: unknown): Promise<WebhookResult>;
+}
+interface DeUnaWebhookPayload {
+    orderRef?: string;
+    transactionId?: string;
+    status?: string;
+    authorizationCode?: string;
+}
+interface DeUnaPaymentMethodOpts {
+    /**
+     * Set inyectable para idempotencia de webhooks.
+     * ponytail: en memoria por defecto; reemplaza con persistencia en DB para multi-instancia.
+     */
+    processedRefs?: Set<string>;
+    /** Override de confirm para entornos sin acceso directo a la API (tests, staging). */
+    onConfirm?: (ref: string) => Promise<ConfirmResult>;
+}
+declare function toDeUnaPaymentMethod(client: DeUnaClient, opts?: DeUnaPaymentMethodOpts): PaymentMethod;
+
+export { type DeUnaClient, type DeUnaConfig, type DeUnaPaymentMethodOpts, type DeUnaPrepareMode, type DeUnaWebhookPayload, type PrepareParams, type PrepareResponse, type TransactionStatus, createDeUnaClient, toDeUnaPaymentMethod };

package/dist/index.js

@@ -0,0 +1,88 @@
+// src/client.ts
+function createDeUnaClient(config) {
+  const base = config.baseUrl ?? "https://api.deuna.io/v1";
+  const headers = {
+    "X-Client-Id": config.clientId,
+    "X-Client-Secret": config.clientSecret,
+    "Content-Type": "application/json"
+  };
+  return {
+    async prepare(params, mode = "qr") {
+      const res = await fetch(`${base}/payments/prepare`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          orderRef: params.orderRef,
+          amount: params.amount,
+          currency: "USD",
+          description: params.description ?? params.orderRef,
+          mode,
+          webhookUrl: config.webhookUrl,
+          returnUrl: config.returnUrl
+        })
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`DeUna prepare ${res.status}: ${text}`);
+      }
+      return res.json();
+    },
+    async getStatus(orderRef) {
+      const url = `${base}/payments/status?orderRef=${encodeURIComponent(orderRef)}`;
+      const res = await fetch(url, { method: "GET", headers });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`DeUna getStatus ${res.status}: ${text}`);
+      }
+      return res.json();
+    }
+  };
+}
+
+// src/adapter.ts
+var PAID_STATUS = "PAID";
+function toConfirmResult(s) {
+  if (s.status === PAID_STATUS) return { status: "paid", transactionId: s.transactionId };
+  if (s.status === "FAILED" || s.status === "EXPIRED")
+    return { status: "failed", error: s.message ?? s.status };
+  return { status: "pending" };
+}
+function toDeUnaPaymentMethod(client, opts) {
+  const processed = opts?.processedRefs ?? /* @__PURE__ */ new Set();
+  return {
+    id: "deuna",
+    label: "DeUna (wallet QR \xB7 Banco Pichincha)",
+    async prepare(order) {
+      const result = await client.prepare({
+        orderRef: order.id,
+        amount: order.total,
+        description: `Orden ${order.id}`
+      });
+      return {
+        qrPayload: result.qrPayload,
+        paymentUrl: result.paymentUrl,
+        paymentCode: result.paymentCode,
+        transactionId: result.transactionId,
+        orderId: order.id
+      };
+    },
+    async confirm(ref) {
+      if (opts?.onConfirm) return opts.onConfirm(ref);
+      return toConfirmResult(await client.getStatus(ref));
+    },
+    async handleWebhook(payload) {
+      const p = payload;
+      const orderId = p?.orderRef;
+      if (!orderId) return { handled: false };
+      if (processed.has(orderId)) return { handled: true, orderId };
+      const status = p?.status ?? (await client.getStatus(orderId)).status;
+      if (status !== PAID_STATUS) return { handled: false };
+      processed.add(orderId);
+      return { handled: true, orderId };
+    }
+  };
+}
+
+export { createDeUnaClient, toDeUnaPaymentMethod };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/adapter.ts"],"names":[],"mappings":";AAuDO,SAAS,kBAAkB,MAAA,EAAkC;AAClE,EAAA,MAAM,IAAA,GAAO,OAAO,OAAA,IAAW,yBAAA;AAC/B,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,eAAe,MAAA,CAAO,QAAA;AAAA,IACtB,mBAAmB,MAAA,CAAO,YAAA;AAAA,IAC1B,cAAA,EAAgB;AAAA,GAClB;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,OAAA,CAAQ,MAAA,EAAQ,IAAA,GAAO,IAAA,EAAM;AACjC,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,IAAI,CAAA,iBAAA,CAAA,EAAqB;AAAA,QAClD,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA;AAAA,QACA,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,UACnB,UAAU,MAAA,CAAO,QAAA;AAAA,UACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,UACf,QAAA,EAAU,KAAA;AAAA,UACV,WAAA,EAAa,MAAA,CAAO,WAAA,IAAe,MAAA,CAAO,QAAA;AAAA,UAC1C,IAAA;AAAA,UACA,YAAY,MAAA,CAAO,UAAA;AAAA,UACnB,WAAW,MAAA,CAAO;AAAA,SACnB;AAAA,OACF,CAAA;AACD,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,OAAO,MAAM,GAAA,CAAI,MAAK,CAAE,KAAA,CAAM,MAAM,EAAE,CAAA;AAC5C,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,cAAA,EAAiB,IAAI,MAAM,CAAA,EAAA,EAAK,IAAI,CAAA,CAAE,CAAA;AAAA,MACxD;AACA,MAAA,OAAO,IAAI,IAAA,EAAK;AAAA,IAClB,CAAA;AAAA,IAEA,MAAM,UAAU,QAAA,EAAU;AACxB,MAAA,MAAM,MAAM,CAAA,EAAG,IAAI,CAAA,0BAAA,EAA6B,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAC5E,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,MAAA,EAAQ,KAAA,EAAO,SAAS,CAAA;AACvD,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,OAAO,MAAM,GAAA,CAAI,MAAK,CAAE,KAAA,CAAM,MAAM,EAAE,CAAA;AAC5C,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gBAAA,EAAmB,IAAI,MAAM,CAAA,EAAA,EAAK,IAAI,CAAA,CAAE,CAAA;AAAA,MAC1D;AACA,MAAA,OAAO,IAAI,IAAA,EAAK;AAAA,IAClB;AAAA,GACF;AACF;;;ACzEA,IAAM,WAAA,GAAc,MAAA;AAEpB,SAAS,gBAAgB,CAAA,EAAqC;AAC5D,EAAA,IAAI,CAAA,CAAE,WAAW,WAAA,EAAa,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,aAAA,EAAe,CAAA,CAAE,aAAA,EAAc;AACtF,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,QAAA,IAAY,CAAA,CAAE,MAAA,KAAW,SAAA;AACxC,IAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,OAAO,CAAA,CAAE,OAAA,IAAW,EAAE,MAAA,EAAO;AAC1D,EAAA,OAAO,EAAE,QAAQ,SAAA,EAAU;AAC7B;AAmBO,SAAS,oBAAA,CACd,QACA,IAAA,EACe;AAEf,EAAA,MAAM,SAAA,GAAY,IAAA,EAAM,aAAA,oBAAiB,IAAI,GAAA,EAAY;AAEzD,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,OAAA;AAAA,IACJ,KAAA,EAAO,wCAAA;AAAA,IAEP,MAAM,QAAQ,KAAA,EAAgD;AAC5D,MAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,OAAA,CAAQ;AAAA,QAClC,UAAU,KAAA,CAAM,EAAA;AAAA,QAChB,QAAQ,KAAA,CAAM,KAAA;AAAA,QACd,WAAA,EAAa,CAAA,MAAA,EAAS,KAAA,CAAM,EAAE,CAAA;AAAA,OAC/B,CAAA;AAED,MAAA,OAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,YAAY,MAAA,CAAO,UAAA;AAAA,QACnB,aAAa,MAAA,CAAO,WAAA;AAAA,QACpB,eAAe,MAAA,CAAO,aAAA;AAAA,QACtB,SAAS,KAAA,CAAM;AAAA,OACjB;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,QAAQ,GAAA,EAAqC;AACjD,MAAA,IAAI,IAAA,EAAM,SAAA,EAAW,OAAO,IAAA,CAAK,UAAU,GAAG,CAAA;AAC9C,MAAA,OAAO,eAAA,CAAgB,MAAM,MAAA,CAAO,SAAA,CAAU,GAAG,CAAC,CAAA;AAAA,IACpD,CAAA;AAAA,IAEA,MAAM,cAAc,OAAA,EAA0C;AAC5D,MAAA,MAAM,CAAA,GAAI,OAAA;AACV,MAAA,MAAM,UAAU,CAAA,EAAG,QAAA;AACnB,MAAA,IAAI,CAAC,OAAA,EAAS,OAAO,EAAE,SAAS,KAAA,EAAM;AAGtC,MAAA,IAAI,SAAA,CAAU,IAAI,OAAO,CAAA,SAAU,EAAE,OAAA,EAAS,MAAM,OAAA,EAAQ;AAG5D,MAAA,MAAM,SAAS,CAAA,EAAG,MAAA,IAAA,CAAW,MAAM,MAAA,CAAO,SAAA,CAAU,OAAO,CAAA,EAAG,MAAA;AAE9D,MAAA,IAAI,MAAA,KAAW,WAAA,EAAa,OAAO,EAAE,SAAS,KAAA,EAAM;AAEpD,MAAA,SAAA,CAAU,IAAI,OAAO,CAAA;AACrB,MAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,OAAA,EAAQ;AAAA,IAClC;AAAA,GACF;AACF","file":"index.js","sourcesContent":["// DeUna (Banco Pichincha) — cliente HTTP mínimo\n// Wallet QR: genera QR dinámico o link de pago y consulta estado del cobro.\n\nexport interface DeUnaConfig {\n  /** Client ID del comercio (DEUNA_CLIENT_ID). */\n  clientId: string;\n  /** Client Secret del comercio (DEUNA_CLIENT_SECRET). */\n  clientSecret: string;\n  /** URL a la que DeUna notificará el resultado del pago (webhook). */\n  webhookUrl: string;\n  /** URL de retorno después del pago (para link/código). */\n  returnUrl: string;\n  /** ponytail: base URL sobreescribible para tests/staging. */\n  baseUrl?: string;\n}\n\nexport interface PrepareParams {\n  /** Referencia única de la orden. */\n  orderRef: string;\n  /** Monto total en la moneda del comercio (USD). */\n  amount: number;\n  /** Descripción del pedido (aparece en la pantalla del wallet). */\n  description?: string;\n}\n\n/** Modos de cobro que DeUna soporta. */\nexport type DeUnaPrepareMode = \"qr\" | \"link\" | \"code\";\n\nexport interface PrepareResponse {\n  /** Payload del QR dinámico (string para que la UI genere la imagen). */\n  qrPayload?: string;\n  /** Link de pago (alternativa al QR). */\n  paymentUrl?: string;\n  /** Código único de 6 dígitos. */\n  paymentCode?: string;\n  /** ID interno de la transacción en DeUna. */\n  transactionId: string;\n}\n\nexport interface TransactionStatus {\n  transactionId: string;\n  orderRef: string;\n  /** \"PAID\" | \"PENDING\" | \"FAILED\" | \"EXPIRED\" */\n  status: string;\n  authorizationCode?: string;\n  message?: string;\n}\n\nexport interface DeUnaClient {\n  /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */\n  prepare(params: PrepareParams, mode?: DeUnaPrepareMode): Promise<PrepareResponse>;\n  /** Consulta el estado actual de la transacción por orderRef. */\n  getStatus(orderRef: string): Promise<TransactionStatus>;\n}\n\nexport function createDeUnaClient(config: DeUnaConfig): DeUnaClient {\n  const base = config.baseUrl ?? \"https://api.deuna.io/v1\";\n  const headers = {\n    \"X-Client-Id\": config.clientId,\n    \"X-Client-Secret\": config.clientSecret,\n    \"Content-Type\": \"application/json\",\n  };\n\n  return {\n    async prepare(params, mode = \"qr\") {\n      const res = await fetch(`${base}/payments/prepare`, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify({\n          orderRef: params.orderRef,\n          amount: params.amount,\n          currency: \"USD\",\n          description: params.description ?? params.orderRef,\n          mode,\n          webhookUrl: config.webhookUrl,\n          returnUrl: config.returnUrl,\n        }),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`DeUna prepare ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PrepareResponse>;\n    },\n\n    async getStatus(orderRef) {\n      const url = `${base}/payments/status?orderRef=${encodeURIComponent(orderRef)}`;\n      const res = await fetch(url, { method: \"GET\", headers });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`DeUna getStatus ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<TransactionStatus>;\n    },\n  };\n}\n","// Tipos estructuralmente compatibles con payment-core (sin importarlo — evita ciclo).\nimport type { Order } from \"@pandait.tech/commerce-core\";\nimport type { DeUnaClient, TransactionStatus } from \"./client.js\";\n\ninterface ConfirmResult {\n  status: \"paid\" | \"pending\" | \"failed\" | \"challenge\";\n  transactionId?: string;\n  redirectUrl?: string;\n  error?: string;\n}\ninterface WebhookResult {\n  handled: boolean;\n  orderId?: string;\n}\ninterface PaymentMethod {\n  id: string;\n  label: string;\n  prepare(order: Order): Promise<Record<string, unknown>>;\n  confirm(ref: string): Promise<ConfirmResult>;\n  handleWebhook(payload: unknown): Promise<WebhookResult>;\n}\n\nconst PAID_STATUS = \"PAID\";\n\nfunction toConfirmResult(s: TransactionStatus): ConfirmResult {\n  if (s.status === PAID_STATUS) return { status: \"paid\", transactionId: s.transactionId };\n  if (s.status === \"FAILED\" || s.status === \"EXPIRED\")\n    return { status: \"failed\", error: s.message ?? s.status };\n  return { status: \"pending\" };\n}\n\nexport interface DeUnaWebhookPayload {\n  orderRef?: string;\n  transactionId?: string;\n  status?: string;\n  authorizationCode?: string;\n}\n\nexport interface DeUnaPaymentMethodOpts {\n  /**\n   * Set inyectable para idempotencia de webhooks.\n   * ponytail: en memoria por defecto; reemplaza con persistencia en DB para multi-instancia.\n   */\n  processedRefs?: Set<string>;\n  /** Override de confirm para entornos sin acceso directo a la API (tests, staging). */\n  onConfirm?: (ref: string) => Promise<ConfirmResult>;\n}\n\nexport function toDeUnaPaymentMethod(\n  client: DeUnaClient,\n  opts?: DeUnaPaymentMethodOpts,\n): PaymentMethod {\n  // ponytail: in-memory; reemplazar con Set persistido en DB en prod multi-instancia\n  const processed = opts?.processedRefs ?? new Set<string>();\n\n  return {\n    id: \"deuna\",\n    label: \"DeUna (wallet QR · Banco Pichincha)\",\n\n    async prepare(order: Order): Promise<Record<string, unknown>> {\n      const result = await client.prepare({\n        orderRef: order.id,\n        amount: order.total,\n        description: `Orden ${order.id}`,\n      });\n      // Devuelve el payload/string del QR — la UI genera la imagen (ponytail: no generar aquí).\n      return {\n        qrPayload: result.qrPayload,\n        paymentUrl: result.paymentUrl,\n        paymentCode: result.paymentCode,\n        transactionId: result.transactionId,\n        orderId: order.id,\n      };\n    },\n\n    async confirm(ref: string): Promise<ConfirmResult> {\n      if (opts?.onConfirm) return opts.onConfirm(ref);\n      return toConfirmResult(await client.getStatus(ref));\n    },\n\n    async handleWebhook(payload: unknown): Promise<WebhookResult> {\n      const p = payload as DeUnaWebhookPayload | null;\n      const orderId = p?.orderRef;\n      if (!orderId) return { handled: false };\n\n      // Idempotencia: misma referencia no se procesa dos veces\n      if (processed.has(orderId)) return { handled: true, orderId };\n\n      // Si el webhook trae el status directamente lo usamos; si no, consultamos\n      const status = p?.status ?? (await client.getStatus(orderId)).status;\n\n      if (status !== PAID_STATUS) return { handled: false };\n\n      processed.add(orderId);\n      return { handled: true, orderId };\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@pandait.tech/payment-deuna",
+  "version": "1.0.0",
+  "description": "DeUna (Banco Pichincha) wallet QR payment adapter for panda-commerce-kit. Implements PaymentMethod via QR dinámico, link de pago y código único.",
+  "license": "MIT",
+  "private": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PandaITorg/panda-commerce-kit.git",
+    "directory": "packages/payment-deuna"
+  },
+  "keywords": [
+    "deuna",
+    "banco-pichincha",
+    "wallet",
+    "qr",
+    "payment-gateway",
+    "ecuador",
+    "panda-commerce-kit"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.7.5",
+    "@vitest/coverage-v8": "^4.1.7",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.7",
+    "@pandait.tech/commerce-core": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "clean": "rm -rf dist .turbo"
+  }
+}