@abacatepay/types 2.0.1 → 2.0.3

package/README.md

@@ -2,41 +2,46 @@
 
 ## AbacatePay API Types
 
-Tipagens oficiais e helpers modernos para integrar com a API da AbacatePay.
+O [@abacatepay/types](https://www.npmjs.com/package/@abacatepay/types) fornece **tipagens oficiais** e **helpers modernos** para trabalhar com a API da AbacatePay de forma **segura**, **previsível** e **alinhada** à documentação oficial.
+
+O pacote é **TypeScript-first** e serve como base para integrações diretas via **fetch**, **SDKs** internos, **CLIs** e validações em **aplicações** backend.
 
 <img src="https://res.cloudinary.com/dkok1obj5/image/upload/v1767631413/avo_clhmaf.png" width="100%" alt="AbacatePay Open Source"/>
 
 ## Instalação
 
-Use com o seu *package manager* favorito
+Use o *package manager* da sua preferência:
 
 </div>
 
 ```bash
 bun add @abacatepay/types
+# ou
 pnpm add @abacatepay/types
+# ou
 npm install @abacatepay/types
 ```
 
 <div align="center">
 
-## Como a AbacatePay API Types documenta
+## Versionamento dos Tipos
 
-Antes de tudo, você deve específicar a versão da API que você deseja importar os tipos. Coloque `/v*` no final da importação, sendo `*` a versão que deseja usar:
+Antes de tudo, você deve especificar a versão da API que deseja usar, adicionando **/v*** na importação:
 
 </div>
 
 ```ts
-import { APICustomer } from '@abacatepay/types/v1'
+import { APICustomer } from '@abacatepay/types/v2';
 ```
 
-
-<p align="center">Para tipos globais como <code>API_BASE_URL</code>, <code>API_VERSION</code>, <code>version</code> e <code>Routes</code>, apenas import normalmente sem a versão.</p>
+<p align="center">Tipos e constantes globais não são versionados e devem ser importados diretamente sem a versão:</p>
 
 ```ts
-import { version } from '@abacatepay/types'
+import { version, API_BASE_URL, API_VERSION } from '@abacatepay/types';
 ```
 
+## Como a AbacatePay API Types documenta
+
 - Prefixo `API*`
 Representa estruturas gerais da API (Objetos retornados, modelos internos etc.).
 
@@ -69,36 +74,33 @@ São campos que não têm definição formal na documentação, mas cujo tipo fo
 
 ```ts
 import {
-	API_BASE,
-	API_VERSION,
-	type APICoupon,
-	type RESTPostCreateCouponBody,
-	Routes,
-} from '@abacatepay/types/v1';
-
-async function createCoupon(body: RESTPostCreateCouponBody) {
-	const path = `${API_BASE_URL}/${API_VERSION}/${Routes.coupon.create}`;
+    Routes,
+    type APICoupon,
+    type RESTPostCreateCouponBody,
+} from '@abacatepay/types/v2';
+import { REST } from '@abacatepay/rest';
 
-	const response = await fetch(path, {
-		method: 'POST',
-		body: JSON.stringify(body),
-	});
+const client = new REST({ secret });
 
-	const data: APICoupon = await response.json();
+async function createCoupon(body: RESTPostCreateCouponBody) {
+    const data = await client.post<APICoupon>(Routes.coupons.create, { body });
 
-	return data;
+    return data;
 }
 ```
 
 <p align="center"><strong>Crie um servidor e escute eventos de Webhooks do Aabacate</strong></p>
 
 ```ts
-import { type WebhookEvent, WebhookEventType } from '@abacatepay/types/v1';
+import { WebhookEvent } from '@abacatepay/zod/v2';
+import { WebhookEventType } from '@abacatepay/types/v2';
 
 Bun.serve({
     routes: {
         async '/webhooks/abacate'(request) {
-            const { data, event }: WebhookEvent = await request.json();
+            const raw = await request.json();
+            
+            const { data, event } = WebhookEvent.parse(raw);
 
             switch (event) {
                 case WebhookEventType.BillingPaid:

package/dist/index.d.ts

@@ -5,3 +5,15 @@ export { API_VERSION, version } from './version';
  * @see {@link https://docs.abacatepay.com/}
  */
 export declare const API_BASE_URL = "https://api.abacatepay.com/";
+/**
+ * Official URL for the AbacatePay API Documentation
+ */
+export declare const ABACATEPAY_DOCS_URL = "https://docs.abacatepay.com/";
+export declare const ABACATEPAY_SHARED_KEY = "t9dXRhHHo3yDEj5pVDYz0frf7q6bMKyMRmxxCPIPp3RCplBfXRxqlC6ZpiWmOqj4L63qEaeUOtrCI8P0VMUgo6iIga2ri9ogaHFs0WIIywSMg0q7RmBfybe1E5XJcfC4IW3alNqym0tXoAKkzvfEjZxV6bE0oG2zJrNNYmUCKZyV0KZ3JS8Votf9EAWWYdiDkMkpbMdPggfh1EqHlVkMiTady6jOR3hyzGEHrIz2Ret0xHKMbiqkr9HS1JhNHDX9";
+/**
+ * Verify whether the signature is valid or not.
+ * @param raw Raw body response (string).
+ * @param signature The content of the`X-Webhook-Signature` header.
+ * @returns A boolean that indicates if the signature is valid.
+ */
+export declare const verifyWebhookSignature: (raw: string, signature: string) => boolean;

package/dist/index.js

@@ -1,7 +1,28 @@
 export { API_VERSION, version } from './version';
+import { createHmac, timingSafeEqual } from 'node:crypto';
 /**
  * Base URL for the AbacatePay API (Version not included).
  *
  * @see {@link https://docs.abacatepay.com/}
  */
 export const API_BASE_URL = 'https://api.abacatepay.com/';
+/**
+ * Official URL for the AbacatePay API Documentation
+ */
+export const ABACATEPAY_DOCS_URL = 'https://docs.abacatepay.com/';
+export const ABACATEPAY_SHARED_KEY = 't9dXRhHHo3yDEj5pVDYz0frf7q6bMKyMRmxxCPIPp3RCplBfXRxqlC6ZpiWmOqj4L63qEaeUOtrCI8P0VMUgo6iIga2ri9ogaHFs0WIIywSMg0q7RmBfybe1E5XJcfC4IW3alNqym0tXoAKkzvfEjZxV6bE0oG2zJrNNYmUCKZyV0KZ3JS8Votf9EAWWYdiDkMkpbMdPggfh1EqHlVkMiTady6jOR3hyzGEHrIz2Ret0xHKMbiqkr9HS1JhNHDX9';
+/**
+ * Verify whether the signature is valid or not.
+ * @param raw Raw body response (string).
+ * @param signature The content of the`X-Webhook-Signature` header.
+ * @returns A boolean that indicates if the signature is valid.
+ */
+export const verifyWebhookSignature = (raw, signature) => {
+    const bodyBuffer = Buffer.from(raw, 'utf8');
+    const expectedSig = createHmac('sha256', ABACATEPAY_SHARED_KEY)
+        .update(bodyBuffer)
+        .digest('base64');
+    const A = Buffer.from(expectedSig);
+    const B = Buffer.from(signature);
+    return A.length === B.length && timingSafeEqual(A, B);
+};

package/dist/v1/rest.d.ts

@@ -86,7 +86,6 @@ export interface RESTPostCreateNewChargeBody {
      */
     customerId?: string;
     /**
-     * /**
      * Your customer's data to create it.
      * The customer object is not mandatory, but when entering any `customer` information, all `name`, `cellphone`, `email` and `taxId` fields are mandatory.
      */

package/dist/v2/entities/coupon.d.ts

@@ -27,7 +27,7 @@ export interface APICoupon {
     /**
      * Counter of how many times the coupon has been used by customers.
      */
-    redeemsCount: 0;
+    redeemsCount: number;
     /**
      * Indicates whether the coupon was created in a development (true) or production (false) environment.
      */

package/dist/v2/entities/subscription.d.ts

@@ -12,7 +12,7 @@ export interface APISubscription {
      */
     amount: number;
     /**
-     * Subscription currenty.
+     * Subscription currency.
      */
     currency: string;
     /**

package/dist/v2/rest.d.ts

@@ -10,12 +10,20 @@ export type APIResponse<Data> = {
      */
     data: Data;
     error: null;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: true;
 } | {
     data: null;
     /**
      * Error message returned from the API.
      */
     error: string;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: false;
 };
 /**
  * Any response returned by the AbacatePay API that has a `pagination` field (Not cursor based).
@@ -26,6 +34,10 @@ export type APIResponseWithPagination<Data> = {
      */
     data: Data;
     error: null;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: true;
     /**
      * Pagination info.
      */
@@ -53,6 +65,10 @@ export type APIResponseWithPagination<Data> = {
      * Error message returned from the API.
      */
     error: string;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: false;
 };
 /**
  * Any response returned by the AbacatePay API that has a `pagination` field and is cursor-based.
@@ -63,6 +79,10 @@ export type APIResponseWithCursorBasedPagination<Data> = {
      */
     data: Data;
     error: null;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: true;
     /**
      * Pagination info.
      */
@@ -90,6 +110,10 @@ export type APIResponseWithCursorBasedPagination<Data> = {
      * Error message returned from the API.
      */
     error: string;
+    /**
+     * Whether the request was successful or not.
+     */
+    success: false;
 };
 /**
  * https://api.abacatepay.com/v2/customers/create

package/dist/v2/utils.d.ts

@@ -17,10 +17,3 @@ export declare function isPayoutFailedWebhookEvent(event: WebhookEvent): event i
  * @returns A boolean that indicates if the webhook is a billing paid webhook.
  */
 export declare function isBillingPaidWebhookEvent(event: WebhookEvent): event is import("./webhook").WebhookBillingPaidEvent;
-/**
- * Verify whether the signature is valid or not.
- * @param raw Raw body response (string).
- * @param signature The content of the`X-Webhook-Signature` header.
- * @returns A boolean that indicates if the signature is valid.
- */
-export declare const verifyWebhookSignature: (raw: string, signature: string) => boolean;

package/dist/v2/utils.js

@@ -1,4 +1,3 @@
-import { createHmac, timingSafeEqual } from 'node:crypto';
 import { WebhookEventType } from './webhook';
 /**
  * A type guard check for `payout.done` webhook events.
@@ -24,19 +23,3 @@ export function isPayoutFailedWebhookEvent(event) {
 export function isBillingPaidWebhookEvent(event) {
     return event.event === WebhookEventType.BillingPaid;
 }
-const ABACATEPAY_PUBLIC_KEY = 't9dXRhHHo3yDEj5pVDYz0frf7q6bMKyMRmxxCPIPp3RCplBfXRxqlC6ZpiWmOqj4L63qEaeUOtrCI8P0VMUgo6iIga2ri9ogaHFs0WIIywSMg0q7RmBfybe1E5XJcfC4IW3alNqym0tXoAKkzvfEjZxV6bE0oG2zJrNNYmUCKZyV0KZ3JS8Votf9EAWWYdiDkMkpbMdPggfh1EqHlVkMiTady6jOR3hyzGEHrIz2Ret0xHKMbiqkr9HS1JhNHDX9';
-/**
- * Verify whether the signature is valid or not.
- * @param raw Raw body response (string).
- * @param signature The content of the`X-Webhook-Signature` header.
- * @returns A boolean that indicates if the signature is valid.
- */
-export const verifyWebhookSignature = (raw, signature) => {
-    const bodyBuffer = Buffer.from(raw, 'utf8');
-    const expectedSig = createHmac('sha256', ABACATEPAY_PUBLIC_KEY)
-        .update(bodyBuffer)
-        .digest('base64');
-    const A = Buffer.from(expectedSig);
-    const B = Buffer.from(signature);
-    return A.length === B.length && timingSafeEqual(A, B);
-};

package/dist/version.d.ts

@@ -1,8 +1,8 @@
 /**
  * Current version of [@abacatepay/types](https://www.npmjs.com/package/@abacatepay/types).
  */
-export declare const version: "2.0.1";
+export declare const version: "2.0.3";
 /**
- * Current version of the AbacatePay API
+ * Current version of the AbacatePay API.
  */
 export declare const API_VERSION: "2";

package/dist/version.js

@@ -2,8 +2,8 @@
 /**
  * Current version of [@abacatepay/types](https://www.npmjs.com/package/@abacatepay/types).
  */
-export const version = '2.0.1';
+export const version = '2.0.3';
 /**
- * Current version of the AbacatePay API
+ * Current version of the AbacatePay API.
  */
 export const API_VERSION = '2';

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "2.0.1",
+	"version": "2.0.3",
 	"name": "@abacatepay/types",
 	"description": "Abacate Pay API typings that are always up to date.",
 	"type": "module",
@@ -46,12 +46,24 @@
 		"build": "bun run gen:version && tsc",
 		"prepublishOnly": "bun run build",
 		"gen:version": "bun run scripts/version.ts",
+		"test": "bun test",
 		"fmt": "bunx biome check --write package.json types && clear"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.8",
 		"typescript": "^5.9.3"
 	},
+	"author": {
+		"name": "AbacatePay",
+		"email": "opensource@abacatepay.com",
+		"url": "https://abacatepay.com"
+	},
+	"maintainers": [
+		{
+			"name": "Almeida",
+			"url": "https://github.com/almeidazs"
+		}
+	],
 	"keywords": [
 		"api",
 		"abacatepay",
@@ -63,6 +75,6 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/almeidazs/ecosystem"
+		"url": "git+https://github.com/AbacatePay/ecosystem.git"
 	}
 }