@sesamy/sesamy-js 1.17.0 → 1.18.1

package/README.md

@@ -262,7 +262,7 @@ setToken(accessToken, expiresIn)
 
 ## `generateLink(params: GenerateAccountLink | GenerateConsumeLink)`
 
-Generates a link to a Sesamy hosted service such as account or consume. If the user is authenticated, the link will be signed so that the user can access the service without logging in again.
+Generates a link to a Sesamy-hosted service such as account or consume. If the user is authenticated, the link will be signed so that the user can access the service without logging in again.
 
 ### Parameters
 
@@ -273,6 +273,7 @@ Generates a link to a Sesamy hosted service such as account or consume. If the u
   - shorten (boolean, optional): If true, the link will be shortened.
   - ttl (number, optional): The time-to-live for the shortened link in seconds.
   - redirectUrl (string, optional): The URL to redirect to after the link is accessed.
+  - language (string, optional): The language for the link. If not provided the language will be fetched from the HTML element's `lang` attribute.
 
 ### Returns
 
@@ -337,6 +338,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 +364,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,7 +414,85 @@ 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.
 
-# Services
+## `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)`