Scripts Host

The Scripts Host service provides centralized hosting and delivery of Sesamy JavaScript libraries with vendor-specific configuration, version control, and plugin scripts.

Overview

The Scripts Host service allows you to easily integrate Sesamy functionality into your website by serving pre-configured JavaScript bundles. This eliminates the need for manual script installation and configuration management.

Key Features

• Version Control: Serve specific versions (stable, latest, or version numbers) of Sesamy libraries
• Vendor Configuration: Automatic bundling of vendor-specific settings and customizations
• Plugin Scripts: Additional functionality through modular scripts
• CDN Delivery: Fast, reliable delivery through Cloudflare's global CDN
• Automatic Updates: Easy migration to new versions without code changes

Script URLs

Sesamy JS Bundle

The easiest way to add Sesamy JS to your website:

<script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/stable"></script>

Replace YOUR_VENDOR_ID with your vendor identifier provided by Sesamy.

Individual Scripts

You can also load individual components:

<!-- Sesamy JS Library -->
<script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/sesamy-js/stable"></script>

<!-- Sesamy Components -->
<script
  type="module"
  src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/sesamy-components/stable"
></script>

Configuration

The Scripts Host automatically includes your vendor's configuration, eliminating the need for manual setup. Your configuration includes:

• Content selectors for paywalls and articles
• Authentication settings
• Custom transformations
• Analytics integrations
• Plugin scripts

Available Plugins

Plugin scripts extend Sesamy JS functionality with additional features:

• Amplitude - User identification for Amplitude analytics
• Labrador Tags - Dynamic pass injection from Labrador CMS
• Meta Tracking - Facebook Pixel authentication tracking
• Dachser - Custom Dachser integration
• Triggerbee - Forwards Sesamy events to Triggerbee

Plugins can be enabled per-publisher in the vendor config, or per-page via the ?plugins= query parameter on the bundle URL (e.g. ?plugins=triggerbee,amplitude). Names listed in both load only once.

Version Management

Available Versions

• stable - The latest stable release (recommended for production)
• latest - The most recent release (may include breaking changes)
• Specific version - e.g., 1.2.3 for exact version control

Version Examples

<!-- Use stable version -->
<script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/stable"></script>

<!-- Use specific version -->
<script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/1.2.3"></script>

<!-- Use latest (development only) -->
<script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/latest"></script>

Integration Examples

Basic Setup

<!DOCTYPE html>
<html>
  <head>
    <title>My Website</title>
    <!-- Load Sesamy JS Bundle -->
    <script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/stable"></script>
  </head>
  <body>
    <h1>Premium Content</h1>
    <div data-sesamy-paywall="article-123">
      <p>This content requires payment...</p>
    </div>

    <script>
      // Sesamy JS is automatically initialized with your vendor configuration
      window.addEventListener('sesamyJsReady', () => {
        console.log('Sesamy JS ready!');
      });
    </script>
  </body>
</html>

Custom Configuration

If you need additional customization beyond your vendor defaults:

<!DOCTYPE html>
<html>
  <head>
    <title>My Website</title>
    <script type="module" src="https://scripts.sesamy.com/s/YOUR_VENDOR_ID/bundle/stable"></script>
    <script type="application/json" id="sesamy-js">
      {
        "customSetting": "value"
      }
    </script>
  </head>
  <body>
    <!-- Your content -->
  </body>
</html>

Benefits Over Manual Installation

Feature	Scripts Host	Manual Installation
Configuration	Automatic	Manual setup required
Updates	Automatic	Manual version management
CDN	Global Cloudflare CDN	Your own hosting
Maintenance	Zero maintenance	Version conflicts possible
Customization	Vendor-specific bundles	Custom build process
Plugins	Easy integration	Manual script coordination

API Reference

Endpoints

• GET /s/:vendorId/bundle/:tag - Complete bundle with configuration
• GET /s/:vendorId/sesamy-js/:tag - Sesamy JS library only
• GET /s/:vendorId/sesamy-components/:tag - Components library only

Parameters

• vendorId: Your unique vendor identifier
• tag: Version tag (stable, latest, or specific version)

Response Headers

• Cache-Control: Appropriate caching headers for CDN optimization
• Content-Type: application/javascript

Troubleshooting

Script Not Loading

1. Verify your vendorId is correct
2. Check that your vendor account is active
3. Ensure the version tag exists

Configuration Issues

1. Contact Sesamy support if your vendor configuration needs updates
2. Check browser console for JavaScript errors
3. Verify your website's Content Security Policy allows the scripts domain

Version Conflicts

If you experience issues after updates:

1. Temporarily use a specific version number instead of stable
2. Check the changelog for breaking changes
3. Update your integration code if necessary

Support

For issues with the Scripts Host service:

• Check your vendor configuration in the Sesamy dashboard
• Review the browser console for error messages
• Contact Sesamy support with your vendor ID and specific error details