Merge pull request #164 from flowglad/release-please--branches--main--changes--next--components--node

release: 0.19.1

Author: agreea

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.19.0"
+  ".": "0.19.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/flowglad%2Fflowglad-c33de7567de263e6b5dde11d185128cffc46b51220921c663ff21aaa9662e105.yml
-openapi_spec_hash: fa9d7eeda6ebf7419218576074172593
-config_hash: 685a7225f4f24d19cb521bff0da5ef10
+configured_endpoints: 47
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/flowglad%2Fflowglad-2373e020bc9a415249b387fcec33e7dc51910b16bbb31271c6a43dd72b5881ca.yml
+openapi_spec_hash: 3eb536322e3f9a324d7155488a6d2db7
+config_hash: 67ca63fcd5d20f837ad72100ba11dd71

CHANGELOG.md

@@ -1,4 +1,13 @@
 # Changelog
+## 0.19.1 (2025-04-10)
+
+Full Changelog: [v0.19.0...v0.19.1](https://github.com/flowglad/flowglad-node/compare/v0.19.0...v0.19.1)
+
+### Bug Fixes
+
+* **api:** fix missing priceId on CheckoutSessionCreateParams ([e48ce4e](https://github.com/flowglad/flowglad-node/commit/e48ce4e167d67d621b3f517c297ee25f874632c1))
+* **api:** fix refund payment, better types on checkout session creation ([862204c](https://github.com/flowglad/flowglad-node/commit/862204c4cab30f85a91bf9885cddc968ce2c6a24))
+
 ## 0.19.0 (2025-04-10)
 
 Full Changelog: [v0.18.3...v0.19.0](https://github.com/flowglad/flowglad-node/compare/v0.18.3...v0.19.0)

api.md

@@ -128,11 +128,13 @@ Types:
 
 - <code><a href="./src/resources/payments.ts">PaymentRetrieveResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentListResponse</a></code>
+- <code><a href="./src/resources/payments.ts">PaymentRefundResponse</a></code>
 
 Methods:
 
 - <code title="get /api/v1/payments/{id}">client.payments.<a href="./src/resources/payments.ts">retrieve</a>(id) -> PaymentRetrieveResponse</code>
 - <code title="get /api/v1/payments">client.payments.<a href="./src/resources/payments.ts">list</a>({ ...params }) -> PaymentListResponse</code>
+- <code title="post /api/v1/payments/{id}/refund">client.payments.<a href="./src/resources/payments.ts">refund</a>(id, { ...params }) -> PaymentRefundResponse</code>
 
 # PaymentMethods
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowglad/node",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "The official TypeScript library for the Flowglad API",
   "author": "Flowglad <[email protected]>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -85,6 +85,8 @@ import {
 import {
   PaymentListParams,
   PaymentListResponse,
+  PaymentRefundParams,
+  PaymentRefundResponse,
   PaymentRetrieveResponse,
   Payments,
 } from './resources/payments';
@@ -907,7 +909,9 @@ export declare namespace Flowglad {
     Payments as Payments,
     type PaymentRetrieveResponse as PaymentRetrieveResponse,
     type PaymentListResponse as PaymentListResponse,
+    type PaymentRefundResponse as PaymentRefundResponse,
     type PaymentListParams as PaymentListParams,
+    type PaymentRefundParams as PaymentRefundParams,
   };
 
   export {

src/resources/checkout-sessions.ts

@@ -1136,7 +1136,13 @@ export namespace CheckoutSessionListResponse {
 }
 
 export interface CheckoutSessionCreateParams {
-  checkoutSession: {
+  checkoutSession:
+    | CheckoutSessionCreateParams.ProductCheckoutSession
+    | CheckoutSessionCreateParams.AddPaymentMethodCheckoutSession;
+}
+
+export namespace CheckoutSessionCreateParams {
+  export interface ProductCheckoutSession {
     /**
      * The URL to redirect to after the purchase is cancelled or fails
      */
@@ -1152,11 +1158,7 @@ export interface CheckoutSessionCreateParams {
      */
     successUrl: string;
 
-    /**
-     * The type of checkout session to create. Currently only `product` and
-     * `add_payment_method` are supported. All other types will throw an error.
-     */
-    type: 'product' | 'purchase' | 'invoice' | 'add_payment_method';
+    type: 'product';
 
     /**
      * Metadata that will get added to the purchase or subscription created when this
@@ -1172,23 +1174,52 @@ export interface CheckoutSessionCreateParams {
 
     /**
      * The quantity of the purchase or subscription created when this checkout session
-     * succeeds. Ignored if the checkout session is of type `invoice`.
+     * succeeds. Ignored if the checkout session is of type `invoice`. If not provided, defaults to 1.
      */
     quantity?: number;
 
+    /**
+     * The ID of the price the customer shall purchase.
+     */
+    priceId: string;
+  }
+
+  export interface AddPaymentMethodCheckoutSession {
+    /**
+     * The URL to redirect to after the purchase is cancelled or fails
+     */
+    cancelUrl: string;
+
+    /**
+     * The id of the Customer for this purchase session, as defined in your system
+     */
+    customerExternalId: string;
+
+    /**
+     * The URL to redirect to after the purchase is successful
+     */
+    successUrl: string;
+
     /**
      * The id of the subscription that the payment method will be added to as the
      * default payment method.
      */
-    targetSubscriptionId?: string;
+    targetSubscriptionId: string;
+
+    type: 'add_payment_method';
 
     /**
-     * The id of the price to purchase. Required if the checkout session is of type
-     * `product`. Ignored if the checkout session is of type `purchase`, `invoice`, or
-     * `add_payment_method`.
+     * Metadata that will get added to the purchase or subscription created when this
+     * checkout session succeeds. Ignored if the checkout session is of type `invoice`.
      */
-    priceId?: string;
-  };
+    outputMetadata?: Record<string, unknown>;
+
+    /**
+     * The name of the purchase or subscription created when this checkout session
+     * succeeds. Ignored if the checkout session is of type `invoice`.
+     */
+    outputName?: string;
+  }
 }
 
 export interface CheckoutSessionListParams {

src/resources/index.ts

@@ -66,7 +66,9 @@ export {
   Payments,
   type PaymentRetrieveResponse,
   type PaymentListResponse,
+  type PaymentRefundResponse,
   type PaymentListParams,
+  type PaymentRefundParams,
 } from './payments';
 export {
   Prices,