@sesamy/sesamy-js 1.16.0 → 1.18.0

package/README.md

@@ -337,6 +337,17 @@ Creates a checkout session with Sesamy. This function initializes a checkout pro
     - sku (string): The SKU of the product to be purchased.
     - purchaseOptionsId (string, optional): The ID of the purchase options for the product.
   - language (string, optional): The language for the checkout session. If not set, it will be automatically fetched from the HTML element's `lang` attribute.
+  - redirectUrl (string, optional): The URL to redirect to after the checkout process is completed.
+  - address (Address, optional): The address for the checkout session.
+    - givenName: (string): The given name.
+    - familyName: (string): The family name.
+    - street (string): The street address.
+    - city (string): The city.
+    - zip (string): The postal code.
+    - country (string): The country.
+    - phoneNumber (string, optional): The phone number.
+    - email (string, optional): The email address.
+  - isBusiness (boolean, optional): Indicates if the checkout is for a business.
 
 ### Returns
 
@@ -352,6 +363,8 @@ Promise\<CheckoutResponse\>: A promise that resolves to the response JSON object
 - type (enum): The type of checkout session, currently only 'RECURRING' is supported.
 - currency (string): The currency used for the checkout session.
 - country (string): The country associated with the checkout session.
+- redirectUrl (string, optional): The URL to redirect to after the checkout process is completed.
+- email (string, optional): The email address for the checkout session.
 - language (string): The language used for the checkout session.
 - items (Array of objects): The items included in the checkout session.
   - sku (string): The SKU of the product.
@@ -400,6 +413,147 @@ In this example, a checkout session is created with a single item specified by i
 
 By using the `createCheckout` function, you can easily initialize a checkout process and handle the response from the Sesamy API to complete the transaction.
 
+## `checkouts.update(id: string, params: Partial<CreateCheckoutParams>)`
+
+Updates a checkout session with Sesamy.
+
+### Parameters
+
+- params (Partial<CreateCheckoutParams>): The updated parameters for the checkout session.
+  - items (Array of objects): An array of items to be included in the checkout.
+    - sku (string): The SKU of the product to be purchased.
+    - purchaseOptionsId (string, optional): The ID of the purchase options for the product.
+  - language (string, optional): The language for the checkout session.
+  - redirectUrl (string, optional): The URL to redirect to after the checkout process is completed.
+  - email (string, optional): The email address for the checkout session.
+  - address (Address, optional): The address for the checkout session.
+    - givenName: (string): The given name.
+    - familyName: (string): The family name.
+    - street (string): The street address.
+    - city (string): The city.
+    - zip (string): The postal code.
+    - country (string): The country.
+    - phoneNumber (string, optional): The phone number.
+    - email (string, optional): The email address.
+  - isBusiness (boolean, optional): Indicates if the checkout is for a business.
+
+### Returns
+
+Promise\<CheckoutResponse\>: A promise that resolves to the response JSON object from the Sesamy API, which contains details about the updated checkout session.
+
+### CheckoutResponse Schema
+
+- id (string): The unique identifier of the checkout session.
+- checkoutUrl (string): The URL for the checkout session.
+- status (enum): The status of the checkout session, can be 'PENDING' or 'PAID'.
+- createdAt (string): The creation timestamp of the checkout session.
+- modifiedAt (string): The last modified timestamp of the checkout session.
+- type (enum): The type of checkout session, currently only 'RECURRING' is supported.
+- currency (string): The currency used for the checkout session.
+- country (string): The country associated with the checkout session.
+- language (string): The language used for the checkout session.
+- items (Array of objects): The items included in the checkout session.
+  - sku (string): The SKU of the product.
+  - purchaseOptionId (string, optional): The ID of the purchase option for the product.
+  - title (string): The title of the product.
+  - cover (string): The cover image URL of the product.
+- itemsOwned (Array of strings): The SKUs of the items already owned by the user.
+- discountCodes (Array of strings): The discount codes applied to the checkout session.
+- paymentOptions (Array of objects): The available payment options.
+  - provider (string): The payment provider.
+  - methods (Array of strings): The payment methods supported by the provider.
+
+### Example
+
+The following example demonstrates how to create a checkout session with Sesamy:
+
+```javascript
+import { updateCheckout } from '@sesamy/sesamy-js';
+
+// Create a checkout session with one item
+const checkoutParams = {
+  email: 'test@example.com',
+};
+
+updateCheckout('checkoutId', checkoutParams)
+  .then(response => {
+    console.log('Checkout session updated:', response);
+  })
+  .catch(error => {
+    console.error('Error updating checkout session:', error);
+  });
+```
+
+In this example, a checkout session is created with a single item specified by its SKU and an optional purchase options ID. The language is set to English (`'en'`), but if not provided, it will default to the language specified in the HTML `lang` attribute.
+
+### Additional Notes
+
+- The `language` parameter is optional. If it is not provided, the language will be determined using the `getLanguage` function, which fetches the language from the `lang` attribute of the HTML document element.
+- The `items` array must contain at least one item with a valid `sku`.
+
+By using the `createCheckout` function, you can easily initialize a checkout process and handle the response from the Sesamy API to complete the transaction.
+
+## `checkouts.get(id: string)`
+
+Retrieves the details of a specific checkout session from Sesamy. This function fetches the checkout session information based on the provided checkout session ID.
+
+### Parameters
+
+- id (string): The unique identifier of the checkout session to retrieve.
+
+### Returns
+
+Promise\<CheckoutResponse\>: A promise that resolves to the response JSON object from the Sesamy API, which contains details about the requested checkout session.
+
+### CheckoutResponse Schema
+
+- id (string): The unique identifier of the checkout session.
+- checkoutUrl (string): The URL for the checkout session.
+- status (enum): The status of the checkout session, can be 'PENDING' or 'PAID'.
+- createdAt (string): The creation timestamp of the checkout session.
+- modifiedAt (string): The last modified timestamp of the checkout session.
+- type (enum): The type of checkout session, currently only 'RECURRING' is supported.
+- currency (string): The currency used for the checkout session.
+- country (string): The country associated with the checkout session.
+- language (string): The language used for the checkout session.
+- items (Array of objects): The items included in the checkout session.
+  - sku (string): The SKU of the product.
+  - purchaseOptionId (string, optional): The ID of the purchase option for the product.
+  - title (string): The title of the product.
+  - cover (string): The cover image URL of the product.
+- itemsOwned (Array of strings): The SKUs of the items already owned by the user.
+- discountCodes (Array of strings): The discount codes applied to the checkout session.
+- paymentOptions (Array of objects): The available payment options.
+  - provider (string): The payment provider.
+  - methods (Array of strings): The payment methods supported by the provider.
+
+### Example
+
+The following example demonstrates how to retrieve the details of a specific checkout session with Sesamy:
+
+```javascript
+import { getCheckout } from '@sesamy/sesamy-js';
+
+// Retrieve the details of a checkout session by ID
+const checkoutId = 'checkout-session-id';
+
+getCheckout(checkoutId)
+  .then(response => {
+    console.log('Checkout session details:', response);
+  })
+  .catch(error => {
+    console.error('Error retrieving checkout session:', error);
+  });
+```
+
+In this example, the details of a specific checkout session are retrieved using its unique ID. The function returns a promise that resolves to the details of the checkout session.
+
+### Additional Notes
+
+- The `id` parameter is required and must be a valid checkout session identifier.
+
+By using the `getCheckout` function, you can easily fetch the details of a specific checkout session from the Sesamy API to view or process the transaction information.
+
 ## Transform
 
 The transform module allows for dynamic content manipulation based on specified rules. This can include inserting, replacing, or removing elements on a webpage.