@vitrindigital/node 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -214,6 +214,19 @@ var Charges = class {
       idempotencyKey
     });
   }
+  /**
+   * One-click buy: cobra usando o cartão preferido salvo do cliente.
+   * O cliente precisa ter um saved card (vide `customers.savedCard.create`).
+   * Retorna 422 `no_saved_card` se não houver cartão; 422 `card_expired` se vencido.
+   */
+  createWithSavedCard(params) {
+    const { idempotencyKey, ...body } = params;
+    return this.client.request("/charges/charge-saved/", {
+      method: "POST",
+      body,
+      idempotencyKey
+    });
+  }
   retrieve(id) {
     return this.client.request(`/transactions/${id}/`);
   }
@@ -243,11 +256,42 @@ var Charges = class {
 };
 
 // src/resources/customers.ts
+var SavedCardResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Tokeniza + persiste o cartão preferido do cliente (substitui o anterior). */
+  create(customerId, params) {
+    return this.client.request(`/customers/${customerId}/saved-card/`, {
+      method: "POST",
+      body: params
+    });
+  }
+  /** Retorna brand/last4/exp/holder — nunca o token. */
+  retrieve(customerId) {
+    return this.client.request(`/customers/${customerId}/saved-card/`);
+  }
+  delete(customerId) {
+    return this.client.request(`/customers/${customerId}/saved-card/`, {
+      method: "DELETE"
+    });
+  }
+  /** Gera URL assinada (JWT 24h) pro cliente final ver/remover o próprio cartão. */
+  createManagementLink(customerId) {
+    return this.client.request(
+      `/customers/${customerId}/saved-card/management-link/`,
+      { method: "POST" }
+    );
+  }
+};
 var Customers = class {
   constructor(client) {
     this.client = client;
+    this.savedCard = new SavedCardResource(client);
   }
   client;
+  savedCard;
   create(params) {
     return this.client.request("/customers/", {
       method: "POST",
@@ -271,6 +315,13 @@ var Customers = class {
   delete(id) {
     return this.client.request(`/customers/${id}/`, { method: "DELETE" });
   }
+  /** Gera link assinado de recompra one-click (JWT 15min, uso único). */
+  oneClickLink(customerId, params) {
+    return this.client.request(
+      `/customers/${customerId}/one-click-link/`,
+      { method: "POST", body: params }
+    );
+  }
 };
 
 // src/resources/plans.ts

package/dist/index.d.cts

@@ -126,6 +126,27 @@ interface PaginatedList<T> {
     previous: string | null;
     results: T[];
 }
+/** Metadados do cartão salvo de um Customer (one-click buy). Nunca inclui o token. */
+interface SavedCard {
+    brand: string;
+    last4: string;
+    exp_month: number | null;
+    exp_year: number | null;
+    holder_name: string;
+    consent_at: string | null;
+}
+/** Resposta de POST /customers/{id}/saved-card/management-link/. */
+interface SavedCardManagementLink {
+    url: string;
+    token: string;
+    expires_at: string;
+}
+/** Resposta de POST /customers/{id}/one-click-link/. */
+interface OneClickLink {
+    url: string;
+    token: string;
+    expires_at: string;
+}
 /** Response do GET /balance/. */
 interface Balance {
     available: number;
@@ -168,6 +189,15 @@ interface CreateChargeParams {
     /** Idempotency-Key (header) — recomendado pra evitar duplo-débito em retry. */
     idempotencyKey?: string;
 }
+interface CreateChargeWithSavedCardParams {
+    customer_id: string;
+    amount: number | string;
+    description?: string;
+    installments?: number;
+    external_reference?: string;
+    /** Idempotency-Key (header) — recomendado pra evitar duplo-débito em retry. */
+    idempotencyKey?: string;
+}
 interface RefundParams {
     /** Valor parcial em reais. Omitir = reembolso total. */
     amount?: number | string;
@@ -188,6 +218,12 @@ declare class Charges {
     constructor(client: VitrinClient);
     /** Cria uma cobrança avulsa (PIX/Boleto/Cartão). */
     create(params: CreateChargeParams): Promise<Transaction>;
+    /**
+     * One-click buy: cobra usando o cartão preferido salvo do cliente.
+     * O cliente precisa ter um saved card (vide `customers.savedCard.create`).
+     * Retorna 422 `no_saved_card` se não houver cartão; 422 `card_expired` se vencido.
+     */
+    createWithSavedCard(params: CreateChargeWithSavedCardParams): Promise<Transaction>;
     retrieve(id: string): Promise<Transaction>;
     list(params?: ListChargesParams): Promise<PaginatedList<Transaction>>;
     refund(id: string, params: RefundParams): Promise<Transaction>;
@@ -214,8 +250,33 @@ interface CreateCustomerParams {
     state?: string;
 }
 type UpdateCustomerParams = Partial<CreateCustomerParams>;
+interface SaveCardParams {
+    credit_card: {
+        holder_name: string;
+        number: string;
+        expiry_month: string;
+        expiry_year: string;
+        cvv: string;
+    };
+    consent: {
+        accepted_at: string;
+        ip: string;
+    };
+}
+declare class SavedCardResource {
+    private client;
+    constructor(client: VitrinClient);
+    /** Tokeniza + persiste o cartão preferido do cliente (substitui o anterior). */
+    create(customerId: string, params: SaveCardParams): Promise<SavedCard>;
+    /** Retorna brand/last4/exp/holder — nunca o token. */
+    retrieve(customerId: string): Promise<SavedCard>;
+    delete(customerId: string): Promise<void>;
+    /** Gera URL assinada (JWT 24h) pro cliente final ver/remover o próprio cartão. */
+    createManagementLink(customerId: string): Promise<SavedCardManagementLink>;
+}
 declare class Customers {
     private client;
+    readonly savedCard: SavedCardResource;
     constructor(client: VitrinClient);
     create(params: CreateCustomerParams): Promise<Customer>;
     retrieve(id: string): Promise<Customer>;
@@ -225,6 +286,16 @@ declare class Customers {
     }): Promise<PaginatedList<Customer>>;
     update(id: string, params: UpdateCustomerParams): Promise<Customer>;
     delete(id: string): Promise<void>;
+    /** Gera link assinado de recompra one-click (JWT 15min, uso único). */
+    oneClickLink(customerId: string, params: {
+        product_id?: string;
+        plan_id?: string;
+        amount?: string;
+        installments?: number;
+        coupon_code?: string;
+        bump_ids?: string[];
+        expires_in?: number;
+    }): Promise<OneClickLink>;
 }
 
 interface CreatePlanParams {

package/dist/index.d.ts

@@ -126,6 +126,27 @@ interface PaginatedList<T> {
     previous: string | null;
     results: T[];
 }
+/** Metadados do cartão salvo de um Customer (one-click buy). Nunca inclui o token. */
+interface SavedCard {
+    brand: string;
+    last4: string;
+    exp_month: number | null;
+    exp_year: number | null;
+    holder_name: string;
+    consent_at: string | null;
+}
+/** Resposta de POST /customers/{id}/saved-card/management-link/. */
+interface SavedCardManagementLink {
+    url: string;
+    token: string;
+    expires_at: string;
+}
+/** Resposta de POST /customers/{id}/one-click-link/. */
+interface OneClickLink {
+    url: string;
+    token: string;
+    expires_at: string;
+}
 /** Response do GET /balance/. */
 interface Balance {
     available: number;
@@ -168,6 +189,15 @@ interface CreateChargeParams {
     /** Idempotency-Key (header) — recomendado pra evitar duplo-débito em retry. */
     idempotencyKey?: string;
 }
+interface CreateChargeWithSavedCardParams {
+    customer_id: string;
+    amount: number | string;
+    description?: string;
+    installments?: number;
+    external_reference?: string;
+    /** Idempotency-Key (header) — recomendado pra evitar duplo-débito em retry. */
+    idempotencyKey?: string;
+}
 interface RefundParams {
     /** Valor parcial em reais. Omitir = reembolso total. */
     amount?: number | string;
@@ -188,6 +218,12 @@ declare class Charges {
     constructor(client: VitrinClient);
     /** Cria uma cobrança avulsa (PIX/Boleto/Cartão). */
     create(params: CreateChargeParams): Promise<Transaction>;
+    /**
+     * One-click buy: cobra usando o cartão preferido salvo do cliente.
+     * O cliente precisa ter um saved card (vide `customers.savedCard.create`).
+     * Retorna 422 `no_saved_card` se não houver cartão; 422 `card_expired` se vencido.
+     */
+    createWithSavedCard(params: CreateChargeWithSavedCardParams): Promise<Transaction>;
     retrieve(id: string): Promise<Transaction>;
     list(params?: ListChargesParams): Promise<PaginatedList<Transaction>>;
     refund(id: string, params: RefundParams): Promise<Transaction>;
@@ -214,8 +250,33 @@ interface CreateCustomerParams {
     state?: string;
 }
 type UpdateCustomerParams = Partial<CreateCustomerParams>;
+interface SaveCardParams {
+    credit_card: {
+        holder_name: string;
+        number: string;
+        expiry_month: string;
+        expiry_year: string;
+        cvv: string;
+    };
+    consent: {
+        accepted_at: string;
+        ip: string;
+    };
+}
+declare class SavedCardResource {
+    private client;
+    constructor(client: VitrinClient);
+    /** Tokeniza + persiste o cartão preferido do cliente (substitui o anterior). */
+    create(customerId: string, params: SaveCardParams): Promise<SavedCard>;
+    /** Retorna brand/last4/exp/holder — nunca o token. */
+    retrieve(customerId: string): Promise<SavedCard>;
+    delete(customerId: string): Promise<void>;
+    /** Gera URL assinada (JWT 24h) pro cliente final ver/remover o próprio cartão. */
+    createManagementLink(customerId: string): Promise<SavedCardManagementLink>;
+}
 declare class Customers {
     private client;
+    readonly savedCard: SavedCardResource;
     constructor(client: VitrinClient);
     create(params: CreateCustomerParams): Promise<Customer>;
     retrieve(id: string): Promise<Customer>;
@@ -225,6 +286,16 @@ declare class Customers {
     }): Promise<PaginatedList<Customer>>;
     update(id: string, params: UpdateCustomerParams): Promise<Customer>;
     delete(id: string): Promise<void>;
+    /** Gera link assinado de recompra one-click (JWT 15min, uso único). */
+    oneClickLink(customerId: string, params: {
+        product_id?: string;
+        plan_id?: string;
+        amount?: string;
+        installments?: number;
+        coupon_code?: string;
+        bump_ids?: string[];
+        expires_in?: number;
+    }): Promise<OneClickLink>;
 }
 
 interface CreatePlanParams {

package/dist/index.js

@@ -180,6 +180,19 @@ var Charges = class {
       idempotencyKey
     });
   }
+  /**
+   * One-click buy: cobra usando o cartão preferido salvo do cliente.
+   * O cliente precisa ter um saved card (vide `customers.savedCard.create`).
+   * Retorna 422 `no_saved_card` se não houver cartão; 422 `card_expired` se vencido.
+   */
+  createWithSavedCard(params) {
+    const { idempotencyKey, ...body } = params;
+    return this.client.request("/charges/charge-saved/", {
+      method: "POST",
+      body,
+      idempotencyKey
+    });
+  }
   retrieve(id) {
     return this.client.request(`/transactions/${id}/`);
   }
@@ -209,11 +222,42 @@ var Charges = class {
 };
 
 // src/resources/customers.ts
+var SavedCardResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Tokeniza + persiste o cartão preferido do cliente (substitui o anterior). */
+  create(customerId, params) {
+    return this.client.request(`/customers/${customerId}/saved-card/`, {
+      method: "POST",
+      body: params
+    });
+  }
+  /** Retorna brand/last4/exp/holder — nunca o token. */
+  retrieve(customerId) {
+    return this.client.request(`/customers/${customerId}/saved-card/`);
+  }
+  delete(customerId) {
+    return this.client.request(`/customers/${customerId}/saved-card/`, {
+      method: "DELETE"
+    });
+  }
+  /** Gera URL assinada (JWT 24h) pro cliente final ver/remover o próprio cartão. */
+  createManagementLink(customerId) {
+    return this.client.request(
+      `/customers/${customerId}/saved-card/management-link/`,
+      { method: "POST" }
+    );
+  }
+};
 var Customers = class {
   constructor(client) {
     this.client = client;
+    this.savedCard = new SavedCardResource(client);
   }
   client;
+  savedCard;
   create(params) {
     return this.client.request("/customers/", {
       method: "POST",
@@ -237,6 +281,13 @@ var Customers = class {
   delete(id) {
     return this.client.request(`/customers/${id}/`, { method: "DELETE" });
   }
+  /** Gera link assinado de recompra one-click (JWT 15min, uso único). */
+  oneClickLink(customerId, params) {
+    return this.client.request(
+      `/customers/${customerId}/one-click-link/`,
+      { method: "POST", body: params }
+    );
+  }
 };
 
 // src/resources/plans.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitrindigital/node",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SDK oficial Node.js para a API da Vitrin Digital",
   "type": "module",
   "main": "./dist/index.cjs",