@garuhq/node 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -337,7 +337,7 @@ var Customers = class {
   }
   http;
   /**
-   * Create a customer and link it to the current seller.
+   * Register a customer for the current seller.
    *
    * @example
    * const customer = await garu.customers.create({
@@ -402,6 +402,30 @@ var Customers = class {
       }).then((r) => r)
     );
   }
+  /**
+   * Set or clear the per-seller billing email override.
+   *
+   * The override is sticky: it takes precedence over the per-seller last-used
+   * email and the global `customer.email` for outbound seller→customer emails,
+   * and is **never** auto-overwritten by subsequent payments or registrations.
+   *
+   * @example
+   * // Set
+   * await garu.customers.setBillingEmailOverride(42, {
+   *   billingEmailOverride: 'cobrancas@empresa.com.br'
+   * });
+   *
+   * // Clear and fall back to the last-used email
+   * await garu.customers.setBillingEmailOverride(42, { billingEmailOverride: null });
+   */
+  async setBillingEmailOverride(id, params) {
+    return this.http.call(
+      (signal) => this.http.client.PATCH(`/api/customers/${id}/billing-email-override`, {
+        body: params,
+        signal
+      }).then((r) => r)
+    );
+  }
   /**
    * Remove a customer from the current seller.
    *

package/dist/index.d.cts

@@ -219,8 +219,22 @@ interface CustomerRecord {
     state?: string | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Resolved billing email used for outbound seller→customer emails:
+     * `billingEmailOverride ?? per-seller email ?? customer.email`.
+     */
+    billingEmail?: string;
+    /** True when a sticky `billingEmailOverride` is set for this seller. */
+    hasBillingEmailOverride?: boolean;
     [key: string]: unknown;
 }
+interface SetBillingEmailOverrideParams {
+    /**
+     * Customer-controlled billing email. Pass `null` to clear and fall back to
+     * the per-seller last-used email or the global `customer.email`.
+     */
+    billingEmailOverride: string | null;
+}
 type CustomerList = PaginatedList<CustomerRecord>;
 interface CreateCustomerParams {
     name: string;
@@ -406,7 +420,7 @@ declare class Customers {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Create a customer and link it to the current seller.
+     * Register a customer for the current seller.
      *
      * @example
      * const customer = await garu.customers.create({
@@ -439,6 +453,23 @@ declare class Customers {
      * const updated = await garu.customers.update(42, { name: 'Maria Santos' });
      */
     update(id: number, params: UpdateCustomerParams): Promise<CustomerRecord>;
+    /**
+     * Set or clear the per-seller billing email override.
+     *
+     * The override is sticky: it takes precedence over the per-seller last-used
+     * email and the global `customer.email` for outbound seller→customer emails,
+     * and is **never** auto-overwritten by subsequent payments or registrations.
+     *
+     * @example
+     * // Set
+     * await garu.customers.setBillingEmailOverride(42, {
+     *   billingEmailOverride: 'cobrancas@empresa.com.br'
+     * });
+     *
+     * // Clear and fall back to the last-used email
+     * await garu.customers.setBillingEmailOverride(42, { billingEmailOverride: null });
+     */
+    setBillingEmailOverride(id: number, params: SetBillingEmailOverrideParams): Promise<CustomerRecord>;
     /**
      * Remove a customer from the current seller.
      *

package/dist/index.d.ts

@@ -219,8 +219,22 @@ interface CustomerRecord {
     state?: string | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Resolved billing email used for outbound seller→customer emails:
+     * `billingEmailOverride ?? per-seller email ?? customer.email`.
+     */
+    billingEmail?: string;
+    /** True when a sticky `billingEmailOverride` is set for this seller. */
+    hasBillingEmailOverride?: boolean;
     [key: string]: unknown;
 }
+interface SetBillingEmailOverrideParams {
+    /**
+     * Customer-controlled billing email. Pass `null` to clear and fall back to
+     * the per-seller last-used email or the global `customer.email`.
+     */
+    billingEmailOverride: string | null;
+}
 type CustomerList = PaginatedList<CustomerRecord>;
 interface CreateCustomerParams {
     name: string;
@@ -406,7 +420,7 @@ declare class Customers {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Create a customer and link it to the current seller.
+     * Register a customer for the current seller.
      *
      * @example
      * const customer = await garu.customers.create({
@@ -439,6 +453,23 @@ declare class Customers {
      * const updated = await garu.customers.update(42, { name: 'Maria Santos' });
      */
     update(id: number, params: UpdateCustomerParams): Promise<CustomerRecord>;
+    /**
+     * Set or clear the per-seller billing email override.
+     *
+     * The override is sticky: it takes precedence over the per-seller last-used
+     * email and the global `customer.email` for outbound seller→customer emails,
+     * and is **never** auto-overwritten by subsequent payments or registrations.
+     *
+     * @example
+     * // Set
+     * await garu.customers.setBillingEmailOverride(42, {
+     *   billingEmailOverride: 'cobrancas@empresa.com.br'
+     * });
+     *
+     * // Clear and fall back to the last-used email
+     * await garu.customers.setBillingEmailOverride(42, { billingEmailOverride: null });
+     */
+    setBillingEmailOverride(id: number, params: SetBillingEmailOverrideParams): Promise<CustomerRecord>;
     /**
      * Remove a customer from the current seller.
      *

package/dist/index.js

@@ -331,7 +331,7 @@ var Customers = class {
   }
   http;
   /**
-   * Create a customer and link it to the current seller.
+   * Register a customer for the current seller.
    *
    * @example
    * const customer = await garu.customers.create({
@@ -396,6 +396,30 @@ var Customers = class {
       }).then((r) => r)
     );
   }
+  /**
+   * Set or clear the per-seller billing email override.
+   *
+   * The override is sticky: it takes precedence over the per-seller last-used
+   * email and the global `customer.email` for outbound seller→customer emails,
+   * and is **never** auto-overwritten by subsequent payments or registrations.
+   *
+   * @example
+   * // Set
+   * await garu.customers.setBillingEmailOverride(42, {
+   *   billingEmailOverride: 'cobrancas@empresa.com.br'
+   * });
+   *
+   * // Clear and fall back to the last-used email
+   * await garu.customers.setBillingEmailOverride(42, { billingEmailOverride: null });
+   */
+  async setBillingEmailOverride(id, params) {
+    return this.http.call(
+      (signal) => this.http.client.PATCH(`/api/customers/${id}/billing-email-override`, {
+        body: params,
+        signal
+      }).then((r) => r)
+    );
+  }
   /**
    * Remove a customer from the current seller.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garuhq/node",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official Node.js / TypeScript SDK for the Garu payment gateway.",
   "license": "MIT",
   "homepage": "https://garu.com.br",