pixfast 0.1.0

package/README.md

@@ -0,0 +1,101 @@
+# pixfast
+
+Cliente JavaScript para usar a API PixFast com comandos simples em PT-BR e ingles.
+
+```bash
+npm install pixfast
+```
+
+## Uso em PT-BR
+
+```js
+import { criarPixFast } from 'pixfast';
+
+const pixfast = criarPixFast({
+  tokenPixFast: 'TOKEN_DA_SUA_CONTA_PIXFAST',
+  tokenMercadoPago: 'APP_USR_ACCESS_TOKEN_DO_MERCADO_PAGO'
+});
+
+const pix = await pixfast.gerarPix({
+  produto: 'Plano Mensal',
+  idPedido: 'pedido-123',
+  preco: 1.5,
+  emailPagador: 'cliente@exemplo.com',
+  webhookUrl: 'https://seudominio.com/webhook/pix'
+});
+
+console.log(pix.dados.pix.copiaECola);
+```
+
+## Verificar pagamento
+
+```js
+const pagamento = await pixfast.verificarPix(pix.dados.pix.id);
+
+if (pagamento.dados.situacao === 'pago') {
+  console.log('Pode liberar o pedido');
+}
+```
+
+## Uso em ingles
+
+```js
+import { createPixFast } from 'pixfast';
+
+const pixfast = createPixFast({
+  pixFastToken: 'YOUR_PIXFAST_TOKEN',
+  mercadoPagoToken: 'APP_USR_MERCADO_PAGO_ACCESS_TOKEN'
+});
+
+const pix = await pixfast.createPix({
+  product: 'Monthly Plan',
+  orderId: 'order-123',
+  price: 1.5,
+  payerEmail: 'customer@example.com',
+  webhookUrl: 'https://yourdomain.com/webhook/pix'
+});
+
+const paid = await pixfast.isPaid(pix.dados.pix.id);
+console.log(paid);
+```
+
+## Funcoes diretas
+
+```js
+import { gerarPix, verificarPix } from 'pixfast';
+
+const config = {
+  tokenPixFast: 'TOKEN_DA_SUA_CONTA_PIXFAST',
+  tokenMercadoPago: 'APP_USR_ACCESS_TOKEN_DO_MERCADO_PAGO'
+};
+
+const pix = await gerarPix(config, {
+  produto: 'Plano Mensal',
+  idPedido: 'pedido-123',
+  preco: 1.5,
+  emailPagador: 'cliente@exemplo.com'
+});
+
+const pagamento = await verificarPix(config, pix.dados.pix.id);
+```
+
+## Campos aceitos
+
+### `gerarPix` / `createPix`
+
+- `produto`, `product`, `productName`, `descricao`, `description`
+- `idPedido`, `pedidoId`, `orderId`, `externalReference`, `id`
+- `preco`, `valor`, `price`, `amount`
+- `emailPagador`, `payerEmail`, `email`
+- `metadados`, `metadata`
+- `webhookUrl`, `webhook`, `notificationUrl`
+
+Se `webhookUrl` for enviado, o PixFast repassa essa URL ao Mercado Pago na criacao da cobranca. O access token do Mercado Pago e usado somente na requisicao e nao fica armazenado pelo PixFast.
+
+## Compatibilidade
+
+- Node.js 18+ ou navegadores modernos com `fetch`.
+- Modulo ESM: use `import`. CommonJS com `require()` nao e suportado nesta versao.
+- Compatível com a API PixFast atual para gerar PIX e consultar status.
+- Compatível apenas com Mercado Pago como provedor de PIX.
+- PixFast e independente e nao faz parte da equipe do Mercado Pago.

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "pixfast",
+  "version": "0.1.0",
+  "description": "Cliente simples para usar a API PixFast em PT-BR e ingles.",
+  "type": "module",
+  "main": "src/index.js",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "pix",
+    "pixfast",
+    "mercado-pago",
+    "pagamentos"
+  ],
+  "author": "PixFast",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.js

@@ -0,0 +1,186 @@
+const DEFAULT_API_URL = 'https://pixfast.squareweb.app';
+
+export class PixFast {
+  constructor(config = {}) {
+    this.apiUrl = cleanUrl(config.apiUrl || config.urlApi || config.endpoint || DEFAULT_API_URL);
+    this.pixFastToken = config.pixFastToken || config.tokenPixFast || config.token;
+    this.mercadoPagoToken = config.mercadoPagoToken || config.tokenMercadoPago || config.accessToken || config.apiKey;
+    this.fetchImpl = config.fetch || globalThis.fetch;
+
+    if (!this.fetchImpl) {
+      throw new Error('Fetch nao disponivel. Use Node.js 18+ ou informe config.fetch.');
+    }
+  }
+
+  configurar(config = {}) {
+    if (config.apiUrl || config.urlApi || config.endpoint) {
+      this.apiUrl = cleanUrl(config.apiUrl || config.urlApi || config.endpoint);
+    }
+
+    if (config.pixFastToken || config.tokenPixFast || config.token) {
+      this.pixFastToken = config.pixFastToken || config.tokenPixFast || config.token;
+    }
+
+    if (config.mercadoPagoToken || config.tokenMercadoPago || config.accessToken || config.apiKey) {
+      this.mercadoPagoToken = config.mercadoPagoToken || config.tokenMercadoPago || config.accessToken || config.apiKey;
+    }
+
+    return this;
+  }
+
+  configure(config = {}) {
+    return this.configurar(config);
+  }
+
+  async gerarPix(input = {}) {
+    return this.createPix(input);
+  }
+
+  async createPix(input = {}) {
+    const body = normalizePixInput(input, this.mercadoPagoToken);
+    return this.request('/api/pix', {
+      method: 'POST',
+      body
+    });
+  }
+
+  async verificarPix(paymentId, input = {}) {
+    return this.checkPix(paymentId, input);
+  }
+
+  async consultarPix(paymentId, input = {}) {
+    return this.checkPix(paymentId, input);
+  }
+
+  async checkPix(paymentId, input = {}) {
+    const id = paymentId || input.paymentId || input.pagamentoId || input.id;
+    if (!id) throw new Error('Informe o paymentId do PIX.');
+
+    return this.request(`/api/pix/${encodeURIComponent(id)}/check`, {
+      method: 'POST',
+      body: {
+        accessToken: input.mercadoPagoToken || input.tokenMercadoPago || input.accessToken || input.apiKey || this.mercadoPagoToken
+      }
+    });
+  }
+
+  async getPix(paymentId, input = {}) {
+    return this.checkPix(paymentId, input);
+  }
+
+  async estaPago(paymentId, input = {}) {
+    const result = await this.checkPix(paymentId, input);
+    return Boolean(result.ok && result.dados?.situacao === 'pago');
+  }
+
+  async isPaid(paymentId, input = {}) {
+    return this.estaPago(paymentId, input);
+  }
+
+  async request(path, options = {}) {
+    this.ensureTokens(options.body);
+
+    const response = await this.fetchImpl(`${this.apiUrl}${path}`, {
+      method: options.method || 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.pixFastToken}`,
+        ...(options.headers || {})
+      },
+      body: options.body ? JSON.stringify(options.body) : undefined
+    });
+
+    const data = await parseResponse(response);
+
+    if (!response.ok || data?.ok === false) {
+      throw new PixFastError(data?.mensagem || 'A API PixFast retornou um erro.', {
+        status: response.status,
+        code: data?.erro,
+        result: data
+      });
+    }
+
+    return data;
+  }
+
+  ensureTokens(body = {}) {
+    if (!this.pixFastToken) {
+      throw new Error('Informe o token PixFast em pixFastToken ou tokenPixFast.');
+    }
+
+    if (!body.accessToken) {
+      throw new Error('Informe o access token do Mercado Pago em mercadoPagoToken, tokenMercadoPago ou accessToken.');
+    }
+  }
+}
+
+export class PixFastError extends Error {
+  constructor(message, details = {}) {
+    super(message);
+    this.name = 'PixFastError';
+    this.status = details.status;
+    this.code = details.code;
+    this.result = details.result;
+  }
+}
+
+export function criarPixFast(config = {}) {
+  return new PixFast(config);
+}
+
+export function createPixFast(config = {}) {
+  return new PixFast(config);
+}
+
+export async function gerarPix(config, input) {
+  return criarPixFast(config).gerarPix(input);
+}
+
+export async function createPix(config, input) {
+  return createPixFast(config).createPix(input);
+}
+
+export async function verificarPix(config, paymentId, input) {
+  return criarPixFast(config).verificarPix(paymentId, input);
+}
+
+export async function checkPix(config, paymentId, input) {
+  return createPixFast(config).checkPix(paymentId, input);
+}
+
+export async function estaPago(config, paymentId, input) {
+  return criarPixFast(config).estaPago(paymentId, input);
+}
+
+export async function isPaid(config, paymentId, input) {
+  return createPixFast(config).isPaid(paymentId, input);
+}
+
+function normalizePixInput(input, defaultMercadoPagoToken) {
+  return {
+    accessToken: input.mercadoPagoToken || input.tokenMercadoPago || input.accessToken || input.apiKey || defaultMercadoPagoToken,
+    produto: input.produto || input.product || input.productName || input.descricao || input.description,
+    idPedido: input.idPedido || input.pedidoId || input.orderId || input.externalReference || input.id,
+    preco: input.preco ?? input.valor ?? input.price ?? input.amount,
+    emailPagador: input.emailPagador || input.payerEmail || input.email,
+    metadados: input.metadados || input.metadata,
+    webhookUrl: input.webhookUrl || input.webhook || input.notificationUrl
+  };
+}
+
+async function parseResponse(response) {
+  const text = await response.text();
+  if (!text) return null;
+
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { ok: false, erro: 'RESPOSTA_INVALIDA', mensagem: text };
+  }
+}
+
+function cleanUrl(value) {
+  return String(value || DEFAULT_API_URL).replace(/\/+$/, '');
+}
+
+export default PixFast;