@garuhq/node 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to `@garuhq/node` are documented in this file. Format:
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
 
+## [0.15.0] — 2026-05-31
+
+### Added
+
+- **Product writes** — the `Products` resource now wraps the create and update
+  endpoints, not just reads:
+  - `products.create(params)` — `POST /api/products`, returns the created
+    `Product`. Only `name` is required; all other fields fall back to
+    seller/server defaults. Auto-attaches an `X-Idempotency-Key` (override
+    via `params.idempotencyKey`), so the built-in retry can't create a
+    duplicate product.
+  - `products.update(id, params)` — `PATCH /api/products/{id}`, partial update
+    returning the updated `Product`. `id` accepts the numeric id or the
+    product UUID, matching the `/api/products/:id` portal-config methods.
+  - New exported param types `CreateProductParams` and `UpdateProductParams`,
+    covering `name`, `value` (centavos), `description`, `image`, `tags`,
+    `pix`, `boleto`, `creditCard`, `pixAutomatic`, `installments`,
+    `isSubscription`, `subscriptionType`, `unitLabel`, `returnUrl`,
+    `returnUrlButtonText`, and `statementDescriptor`.
+  - Both param types include `pixAutomatic` so you can toggle Pix Automático
+    on the subscription checkout at create/update time.
+
 ## [0.14.0] — 2026-05-31
 
 ### Added

package/dist/index.cjs

@@ -480,9 +480,12 @@ var ProductPortalConfigResource = class {
    */
   async get(productId) {
     return this.http.call(
-      (signal) => this.http.client.GET(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.GET(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /**
@@ -500,19 +503,25 @@ var ProductPortalConfigResource = class {
    */
   async set(productId, params) {
     return this.http.call(
-      (signal) => this.http.client.POST(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: params,
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.POST(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: params,
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /** Same merge semantics as `set` — alias for HTTP-PATCH-prefering callers. */
   async patch(productId, params) {
     return this.http.call(
-      (signal) => this.http.client.PATCH(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: params,
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.PATCH(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: params,
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /**
@@ -525,10 +534,13 @@ var ProductPortalConfigResource = class {
    */
   async clear(productId) {
     return this.http.call(
-      (signal) => this.http.client.DELETE(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: {},
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.DELETE(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: {},
+          signal
+        }
+      ).then((r) => r)
     );
   }
 };
@@ -574,6 +586,61 @@ var Products = class {
       )
     );
   }
+  /**
+   * Create a product for the authenticated seller. Returns the created
+   * product (HTTP 201). Only `name` is required; everything else falls back
+   * to seller/server defaults.
+   *
+   * Automatically attaches an `X-Idempotency-Key` header — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. This makes the built-in
+   * retry on transient failures safe: a retried POST returns the original
+   * product instead of creating a duplicate.
+   *
+   * @example
+   * const product = await garu.products.create({
+   *   name: 'Plano Mensal',
+   *   value: 4990, // R$ 49,90 in centavos
+   *   description: 'Acesso completo à plataforma',
+   *   pix: true,
+   *   creditCard: true,
+   *   isSubscription: true,
+   *   subscriptionType: 'monthly',
+   *   pixAutomatic: true // expose Pix Automático on the subscription checkout
+   * });
+   */
+  async create(params) {
+    const { idempotencyKey, ...body } = params;
+    const key = idempotencyKey ?? generateIdempotencyKey();
+    return this.http.call(
+      (signal) => this.http.client.POST("/api/products", {
+        body,
+        headers: { "X-Idempotency-Key": key },
+        signal
+      }).then((r) => r)
+    );
+  }
+  /**
+   * Update a product (partial PATCH — only the fields you pass are changed).
+   * Returns the updated product.
+   *
+   * `id` accepts the numeric id or the product UUID — the same identifiers
+   * accepted elsewhere on the `/api/products/:id` path (see
+   * {@link ProductPortalConfigResource}).
+   *
+   * @example
+   * const updated = await garu.products.update('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f', {
+   *   value: 5990,
+   *   pixAutomatic: true // turn on Pix Automático for this product
+   * });
+   */
+  async update(id, params) {
+    return this.http.call(
+      (signal) => this.http.client.PATCH(`/api/products/${encodeURIComponent(String(id))}`, {
+        body: params,
+        signal
+      }).then((r) => r)
+    );
+  }
 };
 
 // src/resources/scheduled-charges.ts

package/dist/index.d.cts

@@ -550,6 +550,57 @@ interface ListProductsParams {
     /** Backend tab filter (e.g. `active`, `archived`). Backend default is used when omitted. */
     tab?: string;
 }
+interface CreateProductParams {
+    name: string;
+    /** Price in centavos (BRL × 100). */
+    value?: number;
+    description?: string;
+    /** HTTPS URL of the product cover image. */
+    image?: string;
+    tags?: string[];
+    pix?: boolean;
+    boleto?: boolean;
+    creditCard?: boolean;
+    /**
+     * Enable Pix Automático (BACEN auto-debit recurring Pix) on the
+     * subscription checkout. Defaults to enabled server-side. Only the
+     * subscription checkout mode reads this flag. See {@link Product.pixAutomatic}.
+     */
+    pixAutomatic?: boolean;
+    /** Max number of installments offered on credit card. */
+    installments?: number;
+    isSubscription?: boolean;
+    subscriptionType?: string;
+    unitLabel?: string;
+    returnUrl?: string;
+    returnUrlButtonText?: string;
+    /** Text shown on the buyer's card/bank statement. */
+    statementDescriptor?: string;
+    /**
+     * Idempotency key for the create request. Defaults to a generated UUIDv4.
+     * Pass your own to make a retry across process restarts safe — the backend
+     * returns the original product instead of creating a duplicate.
+     */
+    idempotencyKey?: string;
+}
+interface UpdateProductParams {
+    name?: string;
+    value?: number;
+    description?: string;
+    image?: string;
+    tags?: string[];
+    pix?: boolean;
+    boleto?: boolean;
+    creditCard?: boolean;
+    pixAutomatic?: boolean;
+    installments?: number;
+    isSubscription?: boolean;
+    subscriptionType?: string;
+    unitLabel?: string;
+    returnUrl?: string;
+    returnUrlButtonText?: string;
+    statementDescriptor?: string;
+}
 interface MetaFeatures {
     subscriptions: boolean;
     checkout_sessions: boolean;
@@ -983,6 +1034,44 @@ declare class Products {
      * const product = await garu.products.get('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f');
      */
     get(uuid: string): Promise<Product>;
+    /**
+     * Create a product for the authenticated seller. Returns the created
+     * product (HTTP 201). Only `name` is required; everything else falls back
+     * to seller/server defaults.
+     *
+     * Automatically attaches an `X-Idempotency-Key` header — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. This makes the built-in
+     * retry on transient failures safe: a retried POST returns the original
+     * product instead of creating a duplicate.
+     *
+     * @example
+     * const product = await garu.products.create({
+     *   name: 'Plano Mensal',
+     *   value: 4990, // R$ 49,90 in centavos
+     *   description: 'Acesso completo à plataforma',
+     *   pix: true,
+     *   creditCard: true,
+     *   isSubscription: true,
+     *   subscriptionType: 'monthly',
+     *   pixAutomatic: true // expose Pix Automático on the subscription checkout
+     * });
+     */
+    create(params: CreateProductParams): Promise<Product>;
+    /**
+     * Update a product (partial PATCH — only the fields you pass are changed).
+     * Returns the updated product.
+     *
+     * `id` accepts the numeric id or the product UUID — the same identifiers
+     * accepted elsewhere on the `/api/products/:id` path (see
+     * {@link ProductPortalConfigResource}).
+     *
+     * @example
+     * const updated = await garu.products.update('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f', {
+     *   value: 5990,
+     *   pixAutomatic: true // turn on Pix Automático for this product
+     * });
+     */
+    update(id: string | number, params: UpdateProductParams): Promise<Product>;
 }
 
 /**
@@ -1391,4 +1480,4 @@ declare class GaruServerError extends GaruAPIError {
     constructor(message: string, status: number, requestId: string | null, body: unknown);
 }
 
-export { type CancelAtPeriodEndScheduledChargeParams, type CancelRecurrenceScheduledChargeParams, type CardInfo, type ChangePaymentMethodScheduledChargeParams, type Charge, type ChargeList, type ChargeNowOutcome, type ChargeNowReason, type ChargeNowResult, type ChargeStatus, type CreateChargeParams, type CreateCustomerParams, type CreateScheduledChargeParams, type Customer, type CustomerList, type CustomerRecord, type FailurePayload, Garu, GaruAPIError, GaruAuthenticationError, GaruConnectionError, GaruError, type GaruErrorCode, type GaruFailureCode, GaruNotFoundError, type GaruOptions, GaruPermissionError, GaruRateLimitError, GaruServerError, GaruSignatureVerificationError, GaruValidationError, type ListChargesParams, type ListCustomersParams, type ListProductsParams, type ListScheduledChargeAttemptsParams, type ListScheduledChargesParams, type ListWebhookEventsParams, type MarkPaidScheduledChargeParams, type MetaFeatures, type MetaResponse, type PaginatedList, type PauseScheduledChargeParams, type PaymentMethod, type PaymentMethodExpiredPayload, type PaymentMethodExpiringPayload, type PostponeScheduledChargeParams, type Product, type ProductList, type ProductPortalConfig, type RecurrenceConfig, type RecurrenceInterval, type RefundChargeParams, type ResendWebhookEventParams, type ScheduledChargeActor, type ScheduledChargeAttempt, type ScheduledChargeAttemptList, type ScheduledChargeAttemptSource, type ScheduledChargeAttemptStatus, type ScheduledChargeDetail, type ScheduledChargeEvent, type ScheduledChargeEventType, type ScheduledChargeLinkedTransaction, type ScheduledChargeList, type ScheduledChargeRecord, type ScheduledChargeStatus, type ScheduledChargeType, type ScheduledPaymentMethod, type SetProductPortalConfigParams, type UpdateCustomerParams, type VerifiedWebhook, type VerifyWebhookParams, type WebhookEvent, type WebhookEventEndpoint, type WebhookEventList, type WebhookEventStatus, type WirePaymentMethodId, webhooks };
+export { type CancelAtPeriodEndScheduledChargeParams, type CancelRecurrenceScheduledChargeParams, type CardInfo, type ChangePaymentMethodScheduledChargeParams, type Charge, type ChargeList, type ChargeNowOutcome, type ChargeNowReason, type ChargeNowResult, type ChargeStatus, type CreateChargeParams, type CreateCustomerParams, type CreateProductParams, type CreateScheduledChargeParams, type Customer, type CustomerList, type CustomerRecord, type FailurePayload, Garu, GaruAPIError, GaruAuthenticationError, GaruConnectionError, GaruError, type GaruErrorCode, type GaruFailureCode, GaruNotFoundError, type GaruOptions, GaruPermissionError, GaruRateLimitError, GaruServerError, GaruSignatureVerificationError, GaruValidationError, type ListChargesParams, type ListCustomersParams, type ListProductsParams, type ListScheduledChargeAttemptsParams, type ListScheduledChargesParams, type ListWebhookEventsParams, type MarkPaidScheduledChargeParams, type MetaFeatures, type MetaResponse, type PaginatedList, type PauseScheduledChargeParams, type PaymentMethod, type PaymentMethodExpiredPayload, type PaymentMethodExpiringPayload, type PostponeScheduledChargeParams, type Product, type ProductList, type ProductPortalConfig, type RecurrenceConfig, type RecurrenceInterval, type RefundChargeParams, type ResendWebhookEventParams, type ScheduledChargeActor, type ScheduledChargeAttempt, type ScheduledChargeAttemptList, type ScheduledChargeAttemptSource, type ScheduledChargeAttemptStatus, type ScheduledChargeDetail, type ScheduledChargeEvent, type ScheduledChargeEventType, type ScheduledChargeLinkedTransaction, type ScheduledChargeList, type ScheduledChargeRecord, type ScheduledChargeStatus, type ScheduledChargeType, type ScheduledPaymentMethod, type SetProductPortalConfigParams, type UpdateCustomerParams, type UpdateProductParams, type VerifiedWebhook, type VerifyWebhookParams, type WebhookEvent, type WebhookEventEndpoint, type WebhookEventList, type WebhookEventStatus, type WirePaymentMethodId, webhooks };

package/dist/index.d.ts

@@ -550,6 +550,57 @@ interface ListProductsParams {
     /** Backend tab filter (e.g. `active`, `archived`). Backend default is used when omitted. */
     tab?: string;
 }
+interface CreateProductParams {
+    name: string;
+    /** Price in centavos (BRL × 100). */
+    value?: number;
+    description?: string;
+    /** HTTPS URL of the product cover image. */
+    image?: string;
+    tags?: string[];
+    pix?: boolean;
+    boleto?: boolean;
+    creditCard?: boolean;
+    /**
+     * Enable Pix Automático (BACEN auto-debit recurring Pix) on the
+     * subscription checkout. Defaults to enabled server-side. Only the
+     * subscription checkout mode reads this flag. See {@link Product.pixAutomatic}.
+     */
+    pixAutomatic?: boolean;
+    /** Max number of installments offered on credit card. */
+    installments?: number;
+    isSubscription?: boolean;
+    subscriptionType?: string;
+    unitLabel?: string;
+    returnUrl?: string;
+    returnUrlButtonText?: string;
+    /** Text shown on the buyer's card/bank statement. */
+    statementDescriptor?: string;
+    /**
+     * Idempotency key for the create request. Defaults to a generated UUIDv4.
+     * Pass your own to make a retry across process restarts safe — the backend
+     * returns the original product instead of creating a duplicate.
+     */
+    idempotencyKey?: string;
+}
+interface UpdateProductParams {
+    name?: string;
+    value?: number;
+    description?: string;
+    image?: string;
+    tags?: string[];
+    pix?: boolean;
+    boleto?: boolean;
+    creditCard?: boolean;
+    pixAutomatic?: boolean;
+    installments?: number;
+    isSubscription?: boolean;
+    subscriptionType?: string;
+    unitLabel?: string;
+    returnUrl?: string;
+    returnUrlButtonText?: string;
+    statementDescriptor?: string;
+}
 interface MetaFeatures {
     subscriptions: boolean;
     checkout_sessions: boolean;
@@ -983,6 +1034,44 @@ declare class Products {
      * const product = await garu.products.get('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f');
      */
     get(uuid: string): Promise<Product>;
+    /**
+     * Create a product for the authenticated seller. Returns the created
+     * product (HTTP 201). Only `name` is required; everything else falls back
+     * to seller/server defaults.
+     *
+     * Automatically attaches an `X-Idempotency-Key` header — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. This makes the built-in
+     * retry on transient failures safe: a retried POST returns the original
+     * product instead of creating a duplicate.
+     *
+     * @example
+     * const product = await garu.products.create({
+     *   name: 'Plano Mensal',
+     *   value: 4990, // R$ 49,90 in centavos
+     *   description: 'Acesso completo à plataforma',
+     *   pix: true,
+     *   creditCard: true,
+     *   isSubscription: true,
+     *   subscriptionType: 'monthly',
+     *   pixAutomatic: true // expose Pix Automático on the subscription checkout
+     * });
+     */
+    create(params: CreateProductParams): Promise<Product>;
+    /**
+     * Update a product (partial PATCH — only the fields you pass are changed).
+     * Returns the updated product.
+     *
+     * `id` accepts the numeric id or the product UUID — the same identifiers
+     * accepted elsewhere on the `/api/products/:id` path (see
+     * {@link ProductPortalConfigResource}).
+     *
+     * @example
+     * const updated = await garu.products.update('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f', {
+     *   value: 5990,
+     *   pixAutomatic: true // turn on Pix Automático for this product
+     * });
+     */
+    update(id: string | number, params: UpdateProductParams): Promise<Product>;
 }
 
 /**
@@ -1391,4 +1480,4 @@ declare class GaruServerError extends GaruAPIError {
     constructor(message: string, status: number, requestId: string | null, body: unknown);
 }
 
-export { type CancelAtPeriodEndScheduledChargeParams, type CancelRecurrenceScheduledChargeParams, type CardInfo, type ChangePaymentMethodScheduledChargeParams, type Charge, type ChargeList, type ChargeNowOutcome, type ChargeNowReason, type ChargeNowResult, type ChargeStatus, type CreateChargeParams, type CreateCustomerParams, type CreateScheduledChargeParams, type Customer, type CustomerList, type CustomerRecord, type FailurePayload, Garu, GaruAPIError, GaruAuthenticationError, GaruConnectionError, GaruError, type GaruErrorCode, type GaruFailureCode, GaruNotFoundError, type GaruOptions, GaruPermissionError, GaruRateLimitError, GaruServerError, GaruSignatureVerificationError, GaruValidationError, type ListChargesParams, type ListCustomersParams, type ListProductsParams, type ListScheduledChargeAttemptsParams, type ListScheduledChargesParams, type ListWebhookEventsParams, type MarkPaidScheduledChargeParams, type MetaFeatures, type MetaResponse, type PaginatedList, type PauseScheduledChargeParams, type PaymentMethod, type PaymentMethodExpiredPayload, type PaymentMethodExpiringPayload, type PostponeScheduledChargeParams, type Product, type ProductList, type ProductPortalConfig, type RecurrenceConfig, type RecurrenceInterval, type RefundChargeParams, type ResendWebhookEventParams, type ScheduledChargeActor, type ScheduledChargeAttempt, type ScheduledChargeAttemptList, type ScheduledChargeAttemptSource, type ScheduledChargeAttemptStatus, type ScheduledChargeDetail, type ScheduledChargeEvent, type ScheduledChargeEventType, type ScheduledChargeLinkedTransaction, type ScheduledChargeList, type ScheduledChargeRecord, type ScheduledChargeStatus, type ScheduledChargeType, type ScheduledPaymentMethod, type SetProductPortalConfigParams, type UpdateCustomerParams, type VerifiedWebhook, type VerifyWebhookParams, type WebhookEvent, type WebhookEventEndpoint, type WebhookEventList, type WebhookEventStatus, type WirePaymentMethodId, webhooks };
+export { type CancelAtPeriodEndScheduledChargeParams, type CancelRecurrenceScheduledChargeParams, type CardInfo, type ChangePaymentMethodScheduledChargeParams, type Charge, type ChargeList, type ChargeNowOutcome, type ChargeNowReason, type ChargeNowResult, type ChargeStatus, type CreateChargeParams, type CreateCustomerParams, type CreateProductParams, type CreateScheduledChargeParams, type Customer, type CustomerList, type CustomerRecord, type FailurePayload, Garu, GaruAPIError, GaruAuthenticationError, GaruConnectionError, GaruError, type GaruErrorCode, type GaruFailureCode, GaruNotFoundError, type GaruOptions, GaruPermissionError, GaruRateLimitError, GaruServerError, GaruSignatureVerificationError, GaruValidationError, type ListChargesParams, type ListCustomersParams, type ListProductsParams, type ListScheduledChargeAttemptsParams, type ListScheduledChargesParams, type ListWebhookEventsParams, type MarkPaidScheduledChargeParams, type MetaFeatures, type MetaResponse, type PaginatedList, type PauseScheduledChargeParams, type PaymentMethod, type PaymentMethodExpiredPayload, type PaymentMethodExpiringPayload, type PostponeScheduledChargeParams, type Product, type ProductList, type ProductPortalConfig, type RecurrenceConfig, type RecurrenceInterval, type RefundChargeParams, type ResendWebhookEventParams, type ScheduledChargeActor, type ScheduledChargeAttempt, type ScheduledChargeAttemptList, type ScheduledChargeAttemptSource, type ScheduledChargeAttemptStatus, type ScheduledChargeDetail, type ScheduledChargeEvent, type ScheduledChargeEventType, type ScheduledChargeLinkedTransaction, type ScheduledChargeList, type ScheduledChargeRecord, type ScheduledChargeStatus, type ScheduledChargeType, type ScheduledPaymentMethod, type SetProductPortalConfigParams, type UpdateCustomerParams, type UpdateProductParams, type VerifiedWebhook, type VerifyWebhookParams, type WebhookEvent, type WebhookEventEndpoint, type WebhookEventList, type WebhookEventStatus, type WirePaymentMethodId, webhooks };

package/dist/index.js

@@ -474,9 +474,12 @@ var ProductPortalConfigResource = class {
    */
   async get(productId) {
     return this.http.call(
-      (signal) => this.http.client.GET(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.GET(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /**
@@ -494,19 +497,25 @@ var ProductPortalConfigResource = class {
    */
   async set(productId, params) {
     return this.http.call(
-      (signal) => this.http.client.POST(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: params,
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.POST(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: params,
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /** Same merge semantics as `set` — alias for HTTP-PATCH-prefering callers. */
   async patch(productId, params) {
     return this.http.call(
-      (signal) => this.http.client.PATCH(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: params,
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.PATCH(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: params,
+          signal
+        }
+      ).then((r) => r)
     );
   }
   /**
@@ -519,10 +528,13 @@ var ProductPortalConfigResource = class {
    */
   async clear(productId) {
     return this.http.call(
-      (signal) => this.http.client.DELETE(`/api/products/${encodeURIComponent(String(productId))}/portal-config`, {
-        body: {},
-        signal
-      }).then((r) => r)
+      (signal) => this.http.client.DELETE(
+        `/api/products/${encodeURIComponent(String(productId))}/portal-config`,
+        {
+          body: {},
+          signal
+        }
+      ).then((r) => r)
     );
   }
 };
@@ -568,6 +580,61 @@ var Products = class {
       )
     );
   }
+  /**
+   * Create a product for the authenticated seller. Returns the created
+   * product (HTTP 201). Only `name` is required; everything else falls back
+   * to seller/server defaults.
+   *
+   * Automatically attaches an `X-Idempotency-Key` header — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. This makes the built-in
+   * retry on transient failures safe: a retried POST returns the original
+   * product instead of creating a duplicate.
+   *
+   * @example
+   * const product = await garu.products.create({
+   *   name: 'Plano Mensal',
+   *   value: 4990, // R$ 49,90 in centavos
+   *   description: 'Acesso completo à plataforma',
+   *   pix: true,
+   *   creditCard: true,
+   *   isSubscription: true,
+   *   subscriptionType: 'monthly',
+   *   pixAutomatic: true // expose Pix Automático on the subscription checkout
+   * });
+   */
+  async create(params) {
+    const { idempotencyKey, ...body } = params;
+    const key = idempotencyKey ?? generateIdempotencyKey();
+    return this.http.call(
+      (signal) => this.http.client.POST("/api/products", {
+        body,
+        headers: { "X-Idempotency-Key": key },
+        signal
+      }).then((r) => r)
+    );
+  }
+  /**
+   * Update a product (partial PATCH — only the fields you pass are changed).
+   * Returns the updated product.
+   *
+   * `id` accepts the numeric id or the product UUID — the same identifiers
+   * accepted elsewhere on the `/api/products/:id` path (see
+   * {@link ProductPortalConfigResource}).
+   *
+   * @example
+   * const updated = await garu.products.update('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f', {
+   *   value: 5990,
+   *   pixAutomatic: true // turn on Pix Automático for this product
+   * });
+   */
+  async update(id, params) {
+    return this.http.call(
+      (signal) => this.http.client.PATCH(`/api/products/${encodeURIComponent(String(id))}`, {
+        body: params,
+        signal
+      }).then((r) => r)
+    );
+  }
 };
 
 // src/resources/scheduled-charges.ts

package/package.json

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