npm - perspectapi-ts-sdk - Versions diffs - 6.5.9 → 7.0.0 - Mend

perspectapi-ts-sdk 6.5.9 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (57) hide show

package/README.md +46 -1011
package/dist/chunk-K3T2AFYA.mjs +1393 -0
package/dist/index-CWvUyMt3.d.mts +2224 -0
package/dist/index-CWvUyMt3.d.ts +2224 -0
package/dist/index.d.mts +130 -2221
package/dist/index.d.ts +130 -2221
package/dist/index.js +8 -2
package/dist/index.mjs +13 -1364
package/dist/v2/index.d.mts +1 -0
package/dist/v2/index.d.ts +1 -0
package/dist/v2/index.js +1419 -0
package/dist/v2/index.mjs +40 -0
package/docs/README.md +15 -0
package/docs/v1-deprecated/README.md +9 -0
package/docs/v1-deprecated/examples/README.md +324 -0
package/docs/v1-deprecated/examples/basic-usage.ts +258 -0
package/docs/v1-deprecated/examples/cloudflare-worker.ts +274 -0
package/docs/v1-deprecated/examples/content-query-with-slug-prefix.ts +237 -0
package/docs/v1-deprecated/examples/image-transforms.ts +200 -0
package/docs/v1-deprecated/examples/site-user-checkout.ts +186 -0
package/docs/v1-deprecated/examples/slug-prefix-examples.ts +491 -0
package/docs/v1-deprecated/legacy-docs/caching.md +667 -0
package/docs/v1-deprecated/legacy-docs/contact.md +1396 -0
package/docs/v1-deprecated/legacy-docs/csrf-protection.md +664 -0
package/docs/v1-deprecated/legacy-docs/image-transforms.md +523 -0
package/docs/v1-deprecated/legacy-docs/loaders.md +304 -0
package/docs/v1-deprecated/legacy-docs/newsletter.md +811 -0
package/docs/v1-deprecated/legacy-docs/site-users.md +817 -0
package/docs/v1-deprecated/legacy-notes/CHANGELOG-CHECKOUT.md +143 -0
package/docs/v1-deprecated/legacy-notes/CSRF-CHECKOUT.md +271 -0
package/docs/v1-deprecated/legacy-notes/IMAGE_TRANSFORMS_PORT.md +298 -0
package/docs/v1-deprecated/sdk-readme.md +1076 -0
package/examples/README.md +19 -0
package/examples/basic-v2.ts +37 -0
package/llms.txt +25 -0
package/package.json +18 -7
package/src/client/api-keys-client.ts +4 -0
package/src/client/auth-client.ts +4 -0
package/src/client/base-client.ts +7 -0
package/src/client/bundles-client.ts +4 -0
package/src/client/categories-client.ts +4 -0
package/src/client/checkout-client.ts +4 -0
package/src/client/contact-client.ts +4 -0
package/src/client/content-client.ts +4 -0
package/src/client/newsletter-client.ts +4 -0
package/src/client/newsletter-management-client.ts +4 -0
package/src/client/organizations-client.ts +4 -0
package/src/client/products-client.ts +4 -0
package/src/client/site-users-client.ts +10 -1
package/src/client/sites-client.ts +4 -0
package/src/client/webhooks-client.ts +4 -0
package/src/deprecation.ts +2 -1
package/src/index.ts +2 -1
package/src/loaders.ts +59 -0
package/src/perspect-api-client.ts +2 -2
package/src/v2/client/orders-client.ts +6 -1
package/src/v2/types.ts +3 -0

package/docs/v1-deprecated/examples/cloudflare-worker.ts ADDED Viewed

@@ -0,0 +1,274 @@
+/**
+ * Example Cloudflare Worker using PerspectAPI TypeScript SDK
+ *
+ * @deprecated Historical v1 example. Do not copy into new code. v1 sunsets on
+ * 2026-06-01; use createPerspectApiV2Client from perspectapi-ts-sdk/v2.
+ */
+import { createPerspectApiClient } from '../../../src';
+// Cloudflare Worker environment interface
+interface Env {
+  PERSPECT_API_URL: string;
+  PERSPECT_API_KEY: string;
+  PERSPECT_SITE_NAME?: string;
+}
+// Main worker handler
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
+    // Initialize PerspectAPI client
+    const client = createPerspectApiClient({
+      baseUrl: env.PERSPECT_API_URL,
+      apiKey: env.PERSPECT_API_KEY,
+      timeout: 10000, // 10 seconds for Workers
+      retries: 2      // Fewer retries for Workers
+    });
+    const url = new URL(request.url);
+    const path = url.pathname;
+    try {
+      // Route handling
+      switch (path) {
+        case '/':
+          return handleHome(client);
+        case '/health':
+          return handleHealth(client);
+        case '/content':
+          return handleContent(client, url, env.PERSPECT_SITE_NAME);
+        case '/products':
+          return handleProducts(client, url, env.PERSPECT_SITE_NAME);
+        case '/contact':
+          if (request.method === 'POST') {
+            return handleContactSubmission(client, request, env.PERSPECT_SITE_NAME);
+          }
+          return new Response('Method not allowed', { status: 405 });
+        case '/checkout':
+          if (request.method === 'POST') {
+            return handleCheckout(client, request);
+          }
+          return new Response('Method not allowed', { status: 405 });
+        default:
+          return new Response('Not found', { status: 404 });
+      }
+    } catch (error) {
+      console.error('Worker error:', error);
+      return new Response('Internal server error', { status: 500 });
+    }
+  }
+};
+// Handler functions
+async function handleHome(client: any): Promise<Response> {
+  const html = `
+    <!DOCTYPE html>
+    <html>
+    <head>
+      <title>PerspectAPI SDK Demo</title>
+      <style>
+        body { font-family: Arial, sans-serif; max-width: 800px; margin: 0 auto; padding: 20px; }
+        .endpoint { margin: 10px 0; padding: 10px; background: #f5f5f5; border-radius: 5px; }
+        code { background: #e0e0e0; padding: 2px 4px; border-radius: 3px; }
+      </style>
+    </head>
+    <body>
+      <h1>PerspectAPI TypeScript SDK Demo</h1>
+      <p>This Cloudflare Worker demonstrates the PerspectAPI TypeScript SDK.</p>
+      <h2>Available Endpoints:</h2>
+      <div class="endpoint">
+        <strong>GET /health</strong> - API health check
+      </div>
+      <div class="endpoint">
+        <strong>GET /content</strong> - Get published content<br>
+        <small>Query params: <code>?limit=10&page=1&type=post</code></small>
+      </div>
+      <div class="endpoint">
+        <strong>GET /products</strong> - Get active products<br>
+        <small>Query params: <code>?limit=10&page=1</code></small>
+      </div>
+      <div class="endpoint">
+        <strong>POST /contact</strong> - Submit contact form<br>
+        <small>Body: <code>{"siteName": "...", "name": "...", "email": "...", "message": "..."}</code></small>
+      </div>
+      <div class="endpoint">
+        <strong>POST /checkout</strong> - Create checkout session<br>
+        <small>Body: <code>{"priceId": "...", "successUrl": "...", "cancelUrl": "..."}</code></small>
+      </div>
+    </body>
+    </html>
+  `;
+  return new Response(html, {
+    headers: { 'Content-Type': 'text/html' }
+  });
+}
+async function handleHealth(client: any): Promise<Response> {
+  try {
+    const health = await client.health();
+    return Response.json({
+      success: true,
+      perspectApi: health.data,
+      worker: {
+        timestamp: new Date().toISOString(),
+        region: 'cloudflare-worker'
+      }
+    });
+  } catch (error) {
+    return Response.json({
+      success: false,
+      error: 'Failed to connect to PerspectAPI'
+    }, { status: 500 });
+  }
+}
+async function handleContent(client: any, url: URL, siteNameFromEnv?: string): Promise<Response> {
+  try {
+    const limit = parseInt(url.searchParams.get('limit') || '10');
+    const page = parseInt(url.searchParams.get('page') || '1');
+    const type = url.searchParams.get('type') || undefined;
+    const siteName = siteNameFromEnv || url.searchParams.get('siteName');
+    if (!siteName) {
+      return Response.json({
+        success: false,
+        error: 'Site name is required to fetch content'
+      }, { status: 400 });
+    }
+    const content = await client.content.getContent(siteName, {
+      limit: Math.min(limit, 50), // Cap at 50
+      page: Math.max(page, 1),
+      page_status: 'publish',
+      page_type: type as any
+    });
+    return Response.json({
+      success: true,
+      data: content.data,
+      pagination: content.pagination
+    });
+  } catch (error) {
+    return Response.json({
+      success: false,
+      error: 'Failed to fetch content'
+    }, { status: 500 });
+  }
+}
+async function handleProducts(client: any, url: URL, siteNameFromEnv?: string): Promise<Response> {
+  try {
+    const limit = parseInt(url.searchParams.get('limit') || '10');
+    const page = parseInt(url.searchParams.get('page') || '1');
+    const siteName = siteNameFromEnv || url.searchParams.get('siteName');
+    if (!siteName) {
+      return Response.json({
+        success: false,
+        error: 'Site name is required to fetch products'
+      }, { status: 400 });
+    }
+    const products = await client.products.getProducts(siteName, {
+      limit: Math.min(limit, 50), // Cap at 50
+      page: Math.max(page, 1),
+      isActive: true
+    });
+    return Response.json({
+      success: true,
+      data: products.data,
+      pagination: products.pagination
+    });
+  } catch (error) {
+    return Response.json({
+      success: false,
+      error: 'Failed to fetch products'
+    }, { status: 500 });
+  }
+}
+async function handleContactSubmission(client: any, request: Request, siteNameFromEnv?: string): Promise<Response> {
+  try {
+    const body = await request.json() as any;
+    // Basic validation
+    if (!body.name || !body.email || !body.message) {
+      return Response.json({
+        success: false,
+        error: 'Name, email, and message are required'
+      }, { status: 400 });
+    }
+    const siteName = siteNameFromEnv || body.siteName;
+    if (!siteName) {
+      return Response.json({
+        success: false,
+        error: 'Site name is required for contact submissions'
+      }, { status: 400 });
+    }
+    const submission = await client.contact.submitContact(siteName, {
+      name: body.name,
+      email: body.email,
+      subject: body.subject || 'Contact from Cloudflare Worker',
+      message: body.message
+    });
+    return Response.json({
+      success: true,
+      data: {
+        id: submission.data.id,
+        message: 'Contact form submitted successfully'
+      }
+    });
+  } catch (error) {
+    return Response.json({
+      success: false,
+      error: 'Failed to submit contact form'
+    }, { status: 500 });
+  }
+}
+async function handleCheckout(client: any, request: Request): Promise<Response> {
+  try {
+    const body = await request.json() as any;
+    // Basic validation
+    if (!body.priceId || !body.successUrl || !body.cancelUrl) {
+      return Response.json({
+        success: false,
+        error: 'priceId, successUrl, and cancelUrl are required'
+      }, { status: 400 });
+    }
+    const session = await client.checkout.createCheckoutSession({
+      priceId: body.priceId,
+      successUrl: body.successUrl,
+      cancelUrl: body.cancelUrl,
+      customerEmail: body.customerEmail,
+      metadata: body.metadata
+    });
+    return Response.json({
+      success: true,
+      data: {
+        sessionId: session.data.id,
+        url: session.data.url
+      }
+    });
+  } catch (error) {
+    return Response.json({
+      success: false,
+      error: 'Failed to create checkout session'
+    }, { status: 500 });
+  }
+}

package/docs/v1-deprecated/examples/content-query-with-slug-prefix.ts ADDED Viewed

@@ -0,0 +1,237 @@
+/**
+ * Example: Querying content with slug_prefix
+ *
+ * @deprecated Historical v1 example. Do not copy into new code. v1 sunsets on
+ * 2026-06-01; use createPerspectApiV2Client from perspectapi-ts-sdk/v2.
+ *
+ * This example shows how to use the PerspectAPI SDK to fetch content
+ * that will result in a call to:
+ * GET https://api.perspect.comm/api/v1/sites/clinicaldrugtrials?slug_prefix=blog&page_type=post&page_status=publish&limit=25
+ */
+import { PerspectAPIClient } from '../../../src';
+import type { ContentQueryParams } from '../../../src/types';
+// Initialize the client
+const client = new PerspectAPIClient({
+  apiKey: 'your-api-key-here',  // Replace with your actual API key
+  // or use baseUrl if you have a different API endpoint
+  // baseUrl: 'https://api.perspect.comm'
+});
+/**
+ * Example 1: Basic content query with slug_prefix
+ * This will make the exact call you mentioned
+ */
+async function fetchBlogPosts() {
+  console.log('=== Example 1: Fetching blog posts ===\n');
+  try {
+    // Define query parameters
+    const params: ContentQueryParams = {
+      slug_prefix: 'blog',        // Filter by slug prefix
+      page_type: 'post',          // Content type: 'post' or 'page'
+      page_status: 'publish',     // Status: 'draft', 'publish', 'private', 'trash'
+      limit: 25                   // Number of results to return
+    };
+    // Make the API call
+    // This translates to: GET https://api.perspect.comm/api/v1/sites/clinicaldrugtrials?slug_prefix=blog&page_type=post&page_status=publish&limit=25
+    const response = await client.content.getContent('clinicaldrugtrials', params);
+    // Check if the request was successful
+    if (response.success) {
+      console.log(`✅ Successfully fetched ${response.data?.length || 0} posts`);
+      // Log pagination info if available
+      if (response.pagination) {
+        console.log('\nPagination info:');
+        console.log(`  Page: ${response.pagination.page}`);
+        console.log(`  Limit: ${response.pagination.limit}`);
+        console.log(`  Total items: ${response.pagination.total}`);
+        console.log(`  Total pages: ${response.pagination.totalPages}`);
+      }
+      // Display the fetched content
+      if (response.data && response.data.length > 0) {
+        console.log('\nFetched posts:');
+        response.data.forEach((post, index) => {
+          console.log(`\n${index + 1}. ${post.pageTitle || 'Untitled'}`);
+          console.log(`   Slug: ${post.slug_prefix ? `${post.slug_prefix}/${post.slug}` : post.slug}`);
+          console.log(`   Status: ${post.pageStatus}`);
+          console.log(`   Type: ${post.pageType}`);
+          console.log(`   Created: ${post.createdAt}`);
+        });
+      } else {
+        console.warn('\n⚠️ No posts found matching the criteria');
+        console.log('This could mean:');
+        console.log('  1. There are no published posts with slug_prefix "blog"');
+        console.log('  2. The site name might be incorrect');
+        console.log('  3. Authentication might be failing');
+      }
+    } else {
+      console.error('❌ Request failed:', response.error || response.message);
+    }
+  } catch (error) {
+    console.error('❌ Error fetching content:', error);
+  }
+}
+/**
+ * Example 2: Query with pagination
+ */
+async function fetchBlogPostsWithPagination() {
+  console.log('\n=== Example 2: Fetching blog posts with pagination ===\n');
+  try {
+    // Fetch page 2 with 10 items per page
+    const params: ContentQueryParams = {
+      slug_prefix: 'blog',
+      page_type: 'post',
+      page_status: 'publish',
+      limit: 10,
+      page: 2  // Get the second page of results
+    };
+    const response = await client.content.getContent('clinicaldrugtrials', params);
+    if (response.success && response.data) {
+      console.log(`✅ Fetched page 2: ${response.data.length} posts`);
+      // Display titles
+      response.data.forEach(post => {
+        console.log(`  - ${post.pageTitle}`);
+      });
+    }
+  } catch (error) {
+    console.error('❌ Error:', error);
+  }
+}
+/**
+ * Example 3: Query with different slug prefixes
+ */
+async function fetchContentByDifferentPrefixes() {
+  console.log('\n=== Example 3: Fetching content with different slug prefixes ===\n');
+  const prefixes = ['blog', 'news', 'articles', 'resources'];
+  for (const prefix of prefixes) {
+    try {
+      const params: ContentQueryParams = {
+        slug_prefix: prefix,
+        page_type: 'post',
+        page_status: 'publish',
+        limit: 5
+      };
+      const response = await client.content.getContent('clinicaldrugtrials', params);
+      if (response.success) {
+        console.log(`Slug prefix "${prefix}": Found ${response.data?.length || 0} posts`);
+      }
+    } catch (error) {
+      console.error(`Error fetching "${prefix}":`, error);
+    }
+  }
+}
+/**
+ * Example 4: Debugging - See what's actually being sent
+ * The SDK now includes detailed logging to help debug issues
+ */
+async function debugContentQuery() {
+  console.log('\n=== Example 4: Debug mode - See detailed logs ===\n');
+  console.log('With the logging added, you\'ll see:');
+  console.log('  - Initial parameters');
+  console.log('  - URL construction');
+  console.log('  - HTTP request details');
+  console.log('  - Response data\n');
+  try {
+    const params: ContentQueryParams = {
+      slug_prefix: 'blog',
+      page_type: 'post',
+      page_status: 'publish',
+      limit: 25
+    };
+    // This will trigger all the console.log statements we added
+    const response = await client.content.getContent('clinicaldrugtrials', params);
+    // The console will show:
+    // [PerspectAPI Content] Starting content fetch: { ... }
+    // [HTTP Client - URL Builder] Processing params: { ... }
+    // [HTTP Client] ⚠️ slug_prefix detected: "blog"
+    // [HTTP Client - URL Builder] Final URL: https://api.perspect.comm/api/v1/sites/clinicaldrugtrials?slug_prefix=blog&...
+    // [HTTP Client - Response] Status: 200 OK
+    // [PerspectAPI Content] HTTP response received: { ... }
+    if (response.data?.length === 0) {
+      console.log('\n⚠️ Check the logs above to see:');
+      console.log('  - What URL was actually called');
+      console.log('  - What parameters were sent');
+      console.log('  - What the server responded with');
+    }
+  } catch (error) {
+    console.error('Error:', error);
+  }
+}
+/**
+ * Example 5: Alternative approach using different parameters
+ */
+async function fetchAllContent() {
+  console.log('\n=== Example 5: Fetch without slug_prefix to see all content ===\n');
+  try {
+    // Try without slug_prefix to see if there's any content at all
+    const params: ContentQueryParams = {
+      page_type: 'post',
+      page_status: 'publish',
+      limit: 10
+    };
+    const response = await client.content.getContent('clinicaldrugtrials', params);
+    if (response.success && response.data) {
+      console.log(`✅ Found ${response.data.length} posts without slug_prefix filter`);
+      // Show what slug_prefixes are actually in use
+      const prefixes = new Set(response.data.map(post => post.slug_prefix).filter(Boolean));
+      if (prefixes.size > 0) {
+        console.log('\nActual slug_prefixes in the content:');
+        prefixes.forEach(prefix => console.log(`  - ${prefix}`));
+      }
+    }
+  } catch (error) {
+    console.error('Error:', error);
+  }
+}
+// Main execution
+async function main() {
+  console.log('PerspectAPI Content Query Examples');
+  console.log('===================================\n');
+  // Run examples
+  await fetchBlogPosts();
+  await fetchBlogPostsWithPagination();
+  await fetchContentByDifferentPrefixes();
+  await debugContentQuery();
+  await fetchAllContent();
+}
+// Run the examples
+if (require.main === module) {
+  main().catch(console.error);
+}
+// Export functions for use in other scripts
+export {
+  fetchBlogPosts,
+  fetchBlogPostsWithPagination,
+  fetchContentByDifferentPrefixes,
+  debugContentQuery,
+  fetchAllContent
+};

package/docs/v1-deprecated/examples/image-transforms.ts ADDED Viewed

@@ -0,0 +1,200 @@
+/**
+ * Image Transformation Examples
+ *
+ * @deprecated Historical v1 example. Do not copy into new code. v1 sunsets on
+ * 2026-06-01; use createPerspectApiV2Client from perspectapi-ts-sdk/v2.
+ *
+ * Demonstrates how to use Cloudflare Image Resizing with the SDK
+ */
+import {
+  createPerspectApiClient,
+  transformMediaItem,
+  buildImageUrl,
+  generateResponsiveUrls,
+  generateSrcSet,
+  generateResponsiveImageHtml,
+  type MediaItem
+} from '../../../src';
+const API_URL = process.env.API_URL || 'https://api.perspect.comm';
+const API_KEY = process.env.API_KEY || 'your-api-key';
+const SITE_NAME = process.env.SITE_NAME || 'your-site';
+async function main() {
+  const client = createPerspectApiClient({
+    baseUrl: API_URL,
+    apiKey: API_KEY
+  });
+  console.log('=== Image Transformation Examples ===\n');
+  // Example 1: Transform product images
+  console.log('1. Product Images:');
+  const products = await client.products.getProducts(SITE_NAME, {
+    limit: 5
+  });
+  if (products.data && products.data.length > 0) {
+    const product = products.data[0];
+    const mediaArray = product.media;
+    // Handle both single MediaItem and MediaItem[] array
+    const media = Array.isArray(mediaArray)
+      ? (Array.isArray(mediaArray[0]) ? mediaArray[0][0] : mediaArray[0])
+      : undefined;
+    if (media && !Array.isArray(media)) {
+      console.log(`Product: ${product.name}`);
+      // Generate all responsive sizes
+      const urls = transformMediaItem(API_URL, media);
+      console.log('Responsive URLs:');
+      console.log(`  Thumbnail (150x150): ${urls.thumbnail}`);
+      console.log(`  Small (400px): ${urls.small}`);
+      console.log(`  Medium (800px): ${urls.medium}`);
+      console.log(`  Large (1200px): ${urls.large}`);
+      console.log(`  Original: ${urls.original}`);
+    }
+  }
+  console.log('\n2. Custom Transformations:');
+  // Example 2: Custom single transformation
+  const customUrl = buildImageUrl(
+    API_URL,
+    'media/mysite/photo.jpg',
+    {
+      width: 400,
+      height: 300,
+      fit: 'cover',
+      format: 'webp',
+      quality: 85
+    }
+  );
+  console.log(`Custom URL: ${customUrl}`);
+  // Example 3: Thumbnail with crop
+  const thumbnailUrl = buildImageUrl(
+    API_URL,
+    'media/mysite/photo.jpg',
+    {
+      width: 150,
+      height: 150,
+      fit: 'cover',
+      gravity: 'auto',
+      format: 'auto',
+      quality: 75
+    }
+  );
+  console.log(`Thumbnail: ${thumbnailUrl}`);
+  // Example 4: High DPR (Retina)
+  const retinaUrl = buildImageUrl(
+    API_URL,
+    'media/mysite/photo.jpg',
+    {
+      width: 400,
+      dpr: 2,
+      format: 'auto',
+      quality: 85
+    }
+  );
+  console.log(`Retina (2x): ${retinaUrl}`);
+  console.log('\n3. Responsive Images:');
+  // Example 5: Generate all sizes
+  const responsiveUrls = generateResponsiveUrls(
+    API_URL,
+    'media/mysite/photo.jpg'
+  );
+  console.log('All sizes:', Object.keys(responsiveUrls));
+  // Example 6: Generate srcset
+  const srcset = generateSrcSet(
+    API_URL,
+    'media/mysite/photo.jpg',
+    [400, 800, 1200, 1600]
+  );
+  console.log(`Srcset: ${srcset.substring(0, 100)}...`);
+  // Example 7: Complete HTML
+  const html = generateResponsiveImageHtml(
+    API_URL,
+    'media/mysite/photo.jpg',
+    'Example photo',
+    {
+      className: 'rounded-lg shadow-md',
+      loading: 'lazy',
+      widths: [400, 800, 1200]
+    }
+  );
+  console.log('\n4. Complete HTML:');
+  console.log(html);
+  console.log('\n5. React Component Example:');
+  console.log(`
+import { transformMediaItem, type MediaItem } from 'perspectapi-ts-sdk';
+interface ProductImageProps {
+  media: MediaItem;
+  alt: string;
+}
+export function ProductImage({ media, alt }: ProductImageProps) {
+  const urls = transformMediaItem('${API_URL}', media);
+  return (
+    <img
+      src={urls.medium}
+      srcSet={\`
+        \${urls.small} 400w,
+        \${urls.medium} 800w,
+        \${urls.large} 1200w
+      \`}
+      sizes="(max-width: 640px) 100vw, (max-width: 1024px) 80vw, 60vw"
+      alt={alt}
+      loading="lazy"
+      className="rounded-lg"
+    />
+  );
+}
+  `);
+  console.log('\n6. Use Cases:');
+  console.log(`
+// E-commerce product grid
+const gridThumbnail = buildImageUrl(API_URL, mediaPath, {
+  width: 300,
+  height: 300,
+  fit: 'cover',
+  format: 'auto'
+});
+// Blog featured image
+const featuredImage = buildImageUrl(API_URL, mediaPath, {
+  width: 800,
+  fit: 'scale-down',
+  format: 'auto',
+  quality: 85
+});
+// User avatar
+const avatar = buildImageUrl(API_URL, mediaPath, {
+  width: 40,
+  height: 40,
+  fit: 'cover',
+  format: 'auto'
+});
+// Gallery lightbox
+const lightbox = buildImageUrl(API_URL, mediaPath, {
+  width: 1600,
+  fit: 'scale-down',
+  format: 'auto',
+  quality: 90
+});
+  `);
+}
+main().catch(console.error);