@sesamy/sesamy-js 1.57.0 → 1.58.0

package/README.md

@@ -174,7 +174,6 @@ These are the available configuration options, with their default values:
     domain: null,        // Optional: custom Auth0 domain (e.g., 'auth.example.com')
     domains: []          // Optional: array of auth domain strings for multi-domain setups
   },
-  enablePaywallSettingsUrlFallback: false,  // Optional: enable fallback to sesamy-paywall settings-url
   content: [
     {
       type: 'article',
@@ -185,6 +184,7 @@ These are the available configuration options, with their default values:
         currency: 'USD'
       },
       paywallUrl: 'https://example.com/paywall',  // Optional: custom paywall URL
+      enablePaywallSettingsUrlFallback: false,  // Optional: enable fallback to sesamy-paywall settings-url
       selectors: {
         article: { selector: 'article' },
         image: { selector: 'img', attribute: 'src' },
@@ -195,9 +195,9 @@ These are the available configuration options, with their default values:
         url: { selector: 'link', attribute: 'href' },
         id: { selector: 'article', attribute: 'data-id' },
         pass: { selector: 'article', attribute: 'data-pass' },
+        }
       }
-    }
-  ],
+    ],
   tranforms: {
     enabled: false,
     rules: []
@@ -1105,7 +1105,7 @@ Creates a checkout session with Sesamy. This function initializes a checkout pro
   - payerEmail (string, optional): Email of the payer (person paying for the purchase).
   - requireAddress (boolean, optional): If true, requires the customer to provide an address during checkout.
   - giftMode (boolean, optional): If true, enables gift mode for the checkout.
-  - metaData (Record<string, string>, optional): Custom metadata to store with the checkout (e.g., { "campaign": "summer2024", "source": "mobile" }).
+  - metadata (Record<string, string>, optional): Custom metadata to store with the checkout (e.g., { "campaign": "summer2024", "source": "mobile" }).
 
 ### Returns
 
@@ -1198,6 +1198,8 @@ const checkout = await sesamy.checkouts.create({
     giftMessage: 'Happy Birthday!',
     giftFrom: 'John',
   },
+});
+```
 
 ### Additional Notes
 
@@ -1639,10 +1641,11 @@ Each field object contains the following properties:
 
 #### `enablePaywallSettingsUrlFallback`
 
-**Type:** `boolean`  
+**Type:** `boolean`
 **Default:** `false`
+**Location:** Per content node in `content[].enablePaywallSettingsUrlFallback`
 
-When enabled, this feature flag allows the content module to fall back to checking for a `settings-url` attribute on `<sesamy-paywall>` elements when no `paywallUrl` is found through the standard detection methods (meta tags or article attributes).
+When enabled on a content node, this feature flag allows the content module to fall back to checking for a `settings-url` attribute on `<sesamy-paywall>` elements when no `paywallUrl` is found through the standard detection methods (meta tags or article attributes).
 
 **Use Case:** This is useful for pages that use the `<sesamy-paywall>` custom element but don't explicitly set the paywall URL in meta tags or on the article element. The paywall component may have a `settings-url` attribute that points to the paywall configuration.
 
@@ -1659,10 +1662,10 @@ When enabled, this feature flag allows the content module to fall back to checki
 // Enable the fallback feature
 {
   clientId: "demo",
-  enablePaywallSettingsUrlFallback: true,
   content: [
     {
       type: 'article',
+      enablePaywallSettingsUrlFallback: true,
       selectors: {
         article: { selector: 'sesamy-article' }
       }
@@ -2888,5 +2891,3 @@ const consumeUrl = client.links.generateConsumeLink(
 
 - **sesamy-js `generateLink`**: Includes authentication token in hash if user is authenticated, automatically includes tracking cookies and attribution data, supports link shortening via TTL
 - **SDK `links.*`**: Pure URL generation without authentication, useful for generating shareable links, links for unauthenticated users, or backend link generation
-
-````