@pandait.tech/payment-peigo 1.0.0

package/dist/index.cjs

@@ -0,0 +1,98 @@
+'use strict';
+
+// src/client.ts
+function createPeigoClient(config) {
+  const base = config.baseUrl ?? "https://api.peigo.com.ec/v1";
+  const headers = {
+    "X-Api-Key": config.apiKey,
+    "X-Merchant-Id": config.merchantId,
+    "Content-Type": "application/json"
+  };
+  return {
+    async prepare(params) {
+      const res = await fetch(`${base}/payments/charge`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          orderRef: params.orderRef,
+          amount: params.amount,
+          currency: "USD",
+          description: params.description ?? params.orderRef,
+          webhookUrl: config.webhookUrl,
+          returnUrl: config.returnUrl
+        })
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Peigo 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(`Peigo getStatus ${res.status}: ${text}`);
+      }
+      return res.json();
+    }
+  };
+}
+
+// src/adapter.ts
+async function runIdempotentWebhook(orderId, resolveStatus, paidStatus, processedRefs) {
+  if (!orderId) return { handled: false };
+  if (processedRefs.has(orderId)) return { handled: true, orderId };
+  const status = await resolveStatus();
+  if (status !== paidStatus) return { handled: false };
+  processedRefs.add(orderId);
+  return { handled: true, orderId };
+}
+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 toPeigoPaymentMethod(client, opts) {
+  const processed = opts?.processedRefs ?? /* @__PURE__ */ new Set();
+  return {
+    id: "peigo",
+    label: "Peigo (wallet QR \xB7 Banco Guayaquil)",
+    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;
+      return runIdempotentWebhook(
+        orderId,
+        async () => p?.status ?? (await client.getStatus(orderId)).status,
+        PAID_STATUS,
+        processed
+      );
+    }
+  };
+}
+
+exports.createPeigoClient = createPeigoClient;
+exports.toPeigoPaymentMethod = toPeigoPaymentMethod;
+//# 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":["// Peigo (Banco Guayaquil) — cliente HTTP mínimo\n// Wallet QR: genera QR dinámico o link de pago y consulta estado del cobro.\n\nexport interface PeigoConfig {\n  /** API Key del comercio (PEIGO_API_KEY). */\n  apiKey: string;\n  /** ID del comercio (PEIGO_MERCHANT_ID). */\n  merchantId: string;\n  /** URL a la que Peigo notificará el resultado del pago (webhook). */\n  webhookUrl: string;\n  /** URL de retorno después del pago. */\n  returnUrl: string;\n  /** ponytail: base URL sobreescribible para tests/staging. */\n  baseUrl?: string;\n}\n\nexport interface PeigoPrepareParams {\n  /** Referencia única de la orden. */\n  orderRef: string;\n  /** Monto total en USD. */\n  amount: number;\n  /** Descripción del pedido (aparece en la pantalla del wallet). */\n  description?: string;\n}\n\nexport interface PeigoPrepareResponse {\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 Peigo. */\n  transactionId: string;\n}\n\nexport interface PeigoTransactionStatus {\n  transactionId: string;\n  orderRef: string;\n  /** \"PAID\" | \"PENDING\" | \"FAILED\" | \"EXPIRED\" */\n  status: string;\n  authorizationCode?: string;\n  message?: string;\n}\n\nexport interface PeigoClient {\n  /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */\n  prepare(params: PeigoPrepareParams): Promise<PeigoPrepareResponse>;\n  /** Consulta el estado actual de la transacción por orderRef. */\n  getStatus(orderRef: string): Promise<PeigoTransactionStatus>;\n}\n\nexport function createPeigoClient(config: PeigoConfig): PeigoClient {\n  const base = config.baseUrl ?? \"https://api.peigo.com.ec/v1\";\n  const headers = {\n    \"X-Api-Key\": config.apiKey,\n    \"X-Merchant-Id\": config.merchantId,\n    \"Content-Type\": \"application/json\",\n  };\n\n  return {\n    async prepare(params) {\n      const res = await fetch(`${base}/payments/charge`, {\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          webhookUrl: config.webhookUrl,\n          returnUrl: config.returnUrl,\n        }),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`Peigo prepare ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PeigoPrepareResponse>;\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(`Peigo getStatus ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PeigoTransactionStatus>;\n    },\n  };\n}\n","// Tipos estructuralmente compatibles con payment-core (sin importarlo — evita dep de workspace en runtime).\nimport type { Order } from \"@pandait.tech/commerce-core\";\nimport type { PeigoClient, PeigoTransactionStatus } 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\n// Inlinado de payment-core/wallet-qr — ponytail: elimina dep de workspace en runtime.\nasync function runIdempotentWebhook(\n  orderId: string | undefined,\n  resolveStatus: () => Promise<string>,\n  paidStatus: string,\n  processedRefs: Set<string>,\n): Promise<WebhookResult> {\n  if (!orderId) return { handled: false };\n  if (processedRefs.has(orderId)) return { handled: true, orderId };\n  const status = await resolveStatus();\n  if (status !== paidStatus) return { handled: false };\n  processedRefs.add(orderId);\n  return { handled: true, orderId };\n}\n\nconst PAID_STATUS = \"PAID\";\n\nfunction toConfirmResult(s: PeigoTransactionStatus): 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 PeigoWebhookPayload {\n  orderRef?: string;\n  transactionId?: string;\n  status?: string;\n  authorizationCode?: string;\n}\n\nexport interface PeigoPaymentMethodOpts {\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 toPeigoPaymentMethod(\n  client: PeigoClient,\n  opts?: PeigoPaymentMethodOpts,\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: \"peigo\",\n    label: \"Peigo (wallet QR · Banco Guayaquil)\",\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 PeigoWebhookPayload | null;\n      const orderId = p?.orderRef;\n      return runIdempotentWebhook(\n        orderId,\n        async () => p?.status ?? (await client.getStatus(orderId!)).status,\n        PAID_STATUS,\n        processed,\n      );\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,83 @@
+import { Order } from '@pandait.tech/commerce-core';
+
+interface PeigoConfig {
+    /** API Key del comercio (PEIGO_API_KEY). */
+    apiKey: string;
+    /** ID del comercio (PEIGO_MERCHANT_ID). */
+    merchantId: string;
+    /** URL a la que Peigo notificará el resultado del pago (webhook). */
+    webhookUrl: string;
+    /** URL de retorno después del pago. */
+    returnUrl: string;
+    /** ponytail: base URL sobreescribible para tests/staging. */
+    baseUrl?: string;
+}
+interface PeigoPrepareParams {
+    /** Referencia única de la orden. */
+    orderRef: string;
+    /** Monto total en USD. */
+    amount: number;
+    /** Descripción del pedido (aparece en la pantalla del wallet). */
+    description?: string;
+}
+interface PeigoPrepareResponse {
+    /** 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 Peigo. */
+    transactionId: string;
+}
+interface PeigoTransactionStatus {
+    transactionId: string;
+    orderRef: string;
+    /** "PAID" | "PENDING" | "FAILED" | "EXPIRED" */
+    status: string;
+    authorizationCode?: string;
+    message?: string;
+}
+interface PeigoClient {
+    /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */
+    prepare(params: PeigoPrepareParams): Promise<PeigoPrepareResponse>;
+    /** Consulta el estado actual de la transacción por orderRef. */
+    getStatus(orderRef: string): Promise<PeigoTransactionStatus>;
+}
+declare function createPeigoClient(config: PeigoConfig): PeigoClient;
+
+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 PeigoWebhookPayload {
+    orderRef?: string;
+    transactionId?: string;
+    status?: string;
+    authorizationCode?: string;
+}
+interface PeigoPaymentMethodOpts {
+    /**
+     * 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 toPeigoPaymentMethod(client: PeigoClient, opts?: PeigoPaymentMethodOpts): PaymentMethod;
+
+export { type PeigoClient, type PeigoConfig, type PeigoPaymentMethodOpts, type PeigoPrepareParams, type PeigoPrepareResponse, type PeigoTransactionStatus, type PeigoWebhookPayload, createPeigoClient, toPeigoPaymentMethod };

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+import { Order } from '@pandait.tech/commerce-core';
+
+interface PeigoConfig {
+    /** API Key del comercio (PEIGO_API_KEY). */
+    apiKey: string;
+    /** ID del comercio (PEIGO_MERCHANT_ID). */
+    merchantId: string;
+    /** URL a la que Peigo notificará el resultado del pago (webhook). */
+    webhookUrl: string;
+    /** URL de retorno después del pago. */
+    returnUrl: string;
+    /** ponytail: base URL sobreescribible para tests/staging. */
+    baseUrl?: string;
+}
+interface PeigoPrepareParams {
+    /** Referencia única de la orden. */
+    orderRef: string;
+    /** Monto total en USD. */
+    amount: number;
+    /** Descripción del pedido (aparece en la pantalla del wallet). */
+    description?: string;
+}
+interface PeigoPrepareResponse {
+    /** 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 Peigo. */
+    transactionId: string;
+}
+interface PeigoTransactionStatus {
+    transactionId: string;
+    orderRef: string;
+    /** "PAID" | "PENDING" | "FAILED" | "EXPIRED" */
+    status: string;
+    authorizationCode?: string;
+    message?: string;
+}
+interface PeigoClient {
+    /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */
+    prepare(params: PeigoPrepareParams): Promise<PeigoPrepareResponse>;
+    /** Consulta el estado actual de la transacción por orderRef. */
+    getStatus(orderRef: string): Promise<PeigoTransactionStatus>;
+}
+declare function createPeigoClient(config: PeigoConfig): PeigoClient;
+
+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 PeigoWebhookPayload {
+    orderRef?: string;
+    transactionId?: string;
+    status?: string;
+    authorizationCode?: string;
+}
+interface PeigoPaymentMethodOpts {
+    /**
+     * 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 toPeigoPaymentMethod(client: PeigoClient, opts?: PeigoPaymentMethodOpts): PaymentMethod;
+
+export { type PeigoClient, type PeigoConfig, type PeigoPaymentMethodOpts, type PeigoPrepareParams, type PeigoPrepareResponse, type PeigoTransactionStatus, type PeigoWebhookPayload, createPeigoClient, toPeigoPaymentMethod };

package/dist/index.js

@@ -0,0 +1,95 @@
+// src/client.ts
+function createPeigoClient(config) {
+  const base = config.baseUrl ?? "https://api.peigo.com.ec/v1";
+  const headers = {
+    "X-Api-Key": config.apiKey,
+    "X-Merchant-Id": config.merchantId,
+    "Content-Type": "application/json"
+  };
+  return {
+    async prepare(params) {
+      const res = await fetch(`${base}/payments/charge`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          orderRef: params.orderRef,
+          amount: params.amount,
+          currency: "USD",
+          description: params.description ?? params.orderRef,
+          webhookUrl: config.webhookUrl,
+          returnUrl: config.returnUrl
+        })
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Peigo 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(`Peigo getStatus ${res.status}: ${text}`);
+      }
+      return res.json();
+    }
+  };
+}
+
+// src/adapter.ts
+async function runIdempotentWebhook(orderId, resolveStatus, paidStatus, processedRefs) {
+  if (!orderId) return { handled: false };
+  if (processedRefs.has(orderId)) return { handled: true, orderId };
+  const status = await resolveStatus();
+  if (status !== paidStatus) return { handled: false };
+  processedRefs.add(orderId);
+  return { handled: true, orderId };
+}
+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 toPeigoPaymentMethod(client, opts) {
+  const processed = opts?.processedRefs ?? /* @__PURE__ */ new Set();
+  return {
+    id: "peigo",
+    label: "Peigo (wallet QR \xB7 Banco Guayaquil)",
+    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;
+      return runIdempotentWebhook(
+        orderId,
+        async () => p?.status ?? (await client.getStatus(orderId)).status,
+        PAID_STATUS,
+        processed
+      );
+    }
+  };
+}
+
+export { createPeigoClient, toPeigoPaymentMethod };
+//# 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":"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","file":"index.js","sourcesContent":["// Peigo (Banco Guayaquil) — cliente HTTP mínimo\n// Wallet QR: genera QR dinámico o link de pago y consulta estado del cobro.\n\nexport interface PeigoConfig {\n  /** API Key del comercio (PEIGO_API_KEY). */\n  apiKey: string;\n  /** ID del comercio (PEIGO_MERCHANT_ID). */\n  merchantId: string;\n  /** URL a la que Peigo notificará el resultado del pago (webhook). */\n  webhookUrl: string;\n  /** URL de retorno después del pago. */\n  returnUrl: string;\n  /** ponytail: base URL sobreescribible para tests/staging. */\n  baseUrl?: string;\n}\n\nexport interface PeigoPrepareParams {\n  /** Referencia única de la orden. */\n  orderRef: string;\n  /** Monto total en USD. */\n  amount: number;\n  /** Descripción del pedido (aparece en la pantalla del wallet). */\n  description?: string;\n}\n\nexport interface PeigoPrepareResponse {\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 Peigo. */\n  transactionId: string;\n}\n\nexport interface PeigoTransactionStatus {\n  transactionId: string;\n  orderRef: string;\n  /** \"PAID\" | \"PENDING\" | \"FAILED\" | \"EXPIRED\" */\n  status: string;\n  authorizationCode?: string;\n  message?: string;\n}\n\nexport interface PeigoClient {\n  /** Genera un QR dinámico (y opcionalmente link/código) para cobrar la orden. */\n  prepare(params: PeigoPrepareParams): Promise<PeigoPrepareResponse>;\n  /** Consulta el estado actual de la transacción por orderRef. */\n  getStatus(orderRef: string): Promise<PeigoTransactionStatus>;\n}\n\nexport function createPeigoClient(config: PeigoConfig): PeigoClient {\n  const base = config.baseUrl ?? \"https://api.peigo.com.ec/v1\";\n  const headers = {\n    \"X-Api-Key\": config.apiKey,\n    \"X-Merchant-Id\": config.merchantId,\n    \"Content-Type\": \"application/json\",\n  };\n\n  return {\n    async prepare(params) {\n      const res = await fetch(`${base}/payments/charge`, {\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          webhookUrl: config.webhookUrl,\n          returnUrl: config.returnUrl,\n        }),\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => \"\");\n        throw new Error(`Peigo prepare ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PeigoPrepareResponse>;\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(`Peigo getStatus ${res.status}: ${text}`);\n      }\n      return res.json() as Promise<PeigoTransactionStatus>;\n    },\n  };\n}\n","// Tipos estructuralmente compatibles con payment-core (sin importarlo — evita dep de workspace en runtime).\nimport type { Order } from \"@pandait.tech/commerce-core\";\nimport type { PeigoClient, PeigoTransactionStatus } 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\n// Inlinado de payment-core/wallet-qr — ponytail: elimina dep de workspace en runtime.\nasync function runIdempotentWebhook(\n  orderId: string | undefined,\n  resolveStatus: () => Promise<string>,\n  paidStatus: string,\n  processedRefs: Set<string>,\n): Promise<WebhookResult> {\n  if (!orderId) return { handled: false };\n  if (processedRefs.has(orderId)) return { handled: true, orderId };\n  const status = await resolveStatus();\n  if (status !== paidStatus) return { handled: false };\n  processedRefs.add(orderId);\n  return { handled: true, orderId };\n}\n\nconst PAID_STATUS = \"PAID\";\n\nfunction toConfirmResult(s: PeigoTransactionStatus): 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 PeigoWebhookPayload {\n  orderRef?: string;\n  transactionId?: string;\n  status?: string;\n  authorizationCode?: string;\n}\n\nexport interface PeigoPaymentMethodOpts {\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 toPeigoPaymentMethod(\n  client: PeigoClient,\n  opts?: PeigoPaymentMethodOpts,\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: \"peigo\",\n    label: \"Peigo (wallet QR · Banco Guayaquil)\",\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 PeigoWebhookPayload | null;\n      const orderId = p?.orderRef;\n      return runIdempotentWebhook(\n        orderId,\n        async () => p?.status ?? (await client.getStatus(orderId!)).status,\n        PAID_STATUS,\n        processed,\n      );\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@pandait.tech/payment-peigo",
+  "version": "1.0.0",
+  "description": "Peigo (Banco Guayaquil) 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-peigo"
+  },
+  "keywords": [
+    "peigo",
+    "banco-guayaquil",
+    "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/payment-core": "0.0.0",
+    "@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"
+  }
+}