perspectapi-ts-sdk 3.5.0 → 3.5.1

package/README.md

@@ -93,7 +93,7 @@ import { PerspectApiClient } from 'perspectapi-ts-sdk';
 import { myCacheAdapter } from './cache-adapter';
 
 const perspect = new PerspectApiClient({
-  baseUrl: 'https://api.perspect.co',
+  baseUrl: 'https://api.perspect.comm',
   apiKey: env.PERSPECT_API_KEY,
   cache: {
     adapter: myCacheAdapter,
@@ -248,7 +248,7 @@ const media = product.data.media?.[0];
 
 if (media) {
   // Generate all responsive sizes automatically
-  const urls = transformMediaItem('https://api.perspect.co', media);
+  const urls = transformMediaItem('https://api.perspect.comm', media);
   
   console.log(urls.thumbnail);  // 150x150 cover crop
   console.log(urls.small);      // 400px wide
@@ -259,7 +259,7 @@ if (media) {
 
 // Or build custom transformations
 const customUrl = buildImageUrl(
-  'https://api.perspect.co',
+  'https://api.perspect.comm',
   'media/mysite/photo.jpg',
   {
     width: 400,

package/dist/index.d.mts

@@ -2416,6 +2416,15 @@ declare class SiteUsersClient extends BaseClient {
     changeSubscriptionPlan(siteName: string, subscriptionId: string, productId: number, csrfToken?: string): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Create a Stripe Billing Portal session for updating payment methods
+     * @param siteName - The site name
+     * @param returnUrl - URL to redirect back to after portal session
+     * @param csrfToken - CSRF token (required)
+     */
+    createBillingPortalSession(siteName: string, returnUrl: string, csrfToken?: string): Promise<ApiResponse<{
+        url: string;
+    }>>;
     /**
      * Get linked newsletter subscriptions
      * @param siteName - The site name
@@ -2769,7 +2778,7 @@ declare const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes;
 /**
  * Build Cloudflare Image Resizing URL
  *
- * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.co")
+ * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.comm")
  * @param mediaPath - The path to the media file (e.g., "media/site/image.jpg")
  * @param options - Transform options
  * @returns Cloudflare Image Resizing URL
@@ -2777,11 +2786,11 @@ declare const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes;
  * @example
  * ```typescript
  * const url = buildImageUrl(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   { width: 400, format: 'webp', quality: 85 }
  * );
- * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.co/media/mysite/photo.jpg'
+ * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.comm/media/mysite/photo.jpg'
  * ```
  */
 declare function buildImageUrl(baseUrl: string, mediaPath: string, options?: ImageTransformOptions): string;
@@ -2791,7 +2800,7 @@ declare function buildImageUrl(baseUrl: string, mediaPath: string, options?: Ima
  * @example
  * ```typescript
  * const urls = generateResponsiveUrls(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg'
  * );
  * // Returns: { thumbnail: '...', small: '...', medium: '...', large: '...', original: '...' }
@@ -2804,7 +2813,7 @@ declare function generateResponsiveUrls(baseUrl: string, mediaPath: string, size
  * @example
  * ```typescript
  * const srcset = generateSrcSet(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   [400, 800, 1200]
  * );
@@ -2831,7 +2840,7 @@ declare function generateSizesAttribute(breakpoints?: Array<{
  * @example
  * ```typescript
  * const html = generateResponsiveImageHtml(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   'My photo',
  *   { className: 'rounded-lg', loading: 'lazy' }
@@ -2857,7 +2866,7 @@ declare function generateResponsiveImageHtml(baseUrl: string, mediaPath: string,
  * const media = product.data.media?.[0];
  *
  * if (media) {
- *   const urls = transformMediaItem('https://api.perspect.co', media);
+ *   const urls = transformMediaItem('https://api.perspect.comm', media);
  *   console.log(urls.thumbnail); // Cloudflare-transformed thumbnail URL
  * }
  * ```

package/dist/index.d.ts

@@ -2416,6 +2416,15 @@ declare class SiteUsersClient extends BaseClient {
     changeSubscriptionPlan(siteName: string, subscriptionId: string, productId: number, csrfToken?: string): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Create a Stripe Billing Portal session for updating payment methods
+     * @param siteName - The site name
+     * @param returnUrl - URL to redirect back to after portal session
+     * @param csrfToken - CSRF token (required)
+     */
+    createBillingPortalSession(siteName: string, returnUrl: string, csrfToken?: string): Promise<ApiResponse<{
+        url: string;
+    }>>;
     /**
      * Get linked newsletter subscriptions
      * @param siteName - The site name
@@ -2769,7 +2778,7 @@ declare const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes;
 /**
  * Build Cloudflare Image Resizing URL
  *
- * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.co")
+ * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.comm")
  * @param mediaPath - The path to the media file (e.g., "media/site/image.jpg")
  * @param options - Transform options
  * @returns Cloudflare Image Resizing URL
@@ -2777,11 +2786,11 @@ declare const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes;
  * @example
  * ```typescript
  * const url = buildImageUrl(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   { width: 400, format: 'webp', quality: 85 }
  * );
- * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.co/media/mysite/photo.jpg'
+ * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.comm/media/mysite/photo.jpg'
  * ```
  */
 declare function buildImageUrl(baseUrl: string, mediaPath: string, options?: ImageTransformOptions): string;
@@ -2791,7 +2800,7 @@ declare function buildImageUrl(baseUrl: string, mediaPath: string, options?: Ima
  * @example
  * ```typescript
  * const urls = generateResponsiveUrls(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg'
  * );
  * // Returns: { thumbnail: '...', small: '...', medium: '...', large: '...', original: '...' }
@@ -2804,7 +2813,7 @@ declare function generateResponsiveUrls(baseUrl: string, mediaPath: string, size
  * @example
  * ```typescript
  * const srcset = generateSrcSet(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   [400, 800, 1200]
  * );
@@ -2831,7 +2840,7 @@ declare function generateSizesAttribute(breakpoints?: Array<{
  * @example
  * ```typescript
  * const html = generateResponsiveImageHtml(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   'My photo',
  *   { className: 'rounded-lg', loading: 'lazy' }
@@ -2857,7 +2866,7 @@ declare function generateResponsiveImageHtml(baseUrl: string, mediaPath: string,
  * const media = product.data.media?.[0];
  *
  * if (media) {
- *   const urls = transformMediaItem('https://api.perspect.co', media);
+ *   const urls = transformMediaItem('https://api.perspect.comm', media);
  *   console.log(urls.thumbnail); // Cloudflare-transformed thumbnail URL
  * }
  * ```

package/dist/index.js

@@ -2529,6 +2529,19 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Create a Stripe Billing Portal session for updating payment methods
+   * @param siteName - The site name
+   * @param returnUrl - URL to redirect back to after portal session
+   * @param csrfToken - CSRF token (required)
+   */
+  async createBillingPortalSession(siteName, returnUrl, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, "/users/me/billing-portal"),
+      { return_url: returnUrl },
+      csrfToken
+    );
+  }
   /**
    * Get linked newsletter subscriptions
    * @param siteName - The site name

package/dist/index.mjs

@@ -2466,6 +2466,19 @@ var SiteUsersClient = class extends BaseClient {
       csrfToken
     );
   }
+  /**
+   * Create a Stripe Billing Portal session for updating payment methods
+   * @param siteName - The site name
+   * @param returnUrl - URL to redirect back to after portal session
+   * @param csrfToken - CSRF token (required)
+   */
+  async createBillingPortalSession(siteName, returnUrl, csrfToken) {
+    return this.create(
+      this.siteUserEndpoint(siteName, "/users/me/billing-portal"),
+      { return_url: returnUrl },
+      csrfToken
+    );
+  }
   /**
    * Get linked newsletter subscriptions
    * @param siteName - The site name

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/site-users-client.ts

@@ -355,6 +355,24 @@ export class SiteUsersClient extends BaseClient {
     );
   }
 
+  /**
+   * Create a Stripe Billing Portal session for updating payment methods
+   * @param siteName - The site name
+   * @param returnUrl - URL to redirect back to after portal session
+   * @param csrfToken - CSRF token (required)
+   */
+  async createBillingPortalSession(
+    siteName: string,
+    returnUrl: string,
+    csrfToken?: string
+  ): Promise<ApiResponse<{ url: string }>> {
+    return this.create<{ return_url: string }, { url: string }>(
+      this.siteUserEndpoint(siteName, '/users/me/billing-portal'),
+      { return_url: returnUrl },
+      csrfToken
+    );
+  }
+
   /**
    * Get linked newsletter subscriptions
    * @param siteName - The site name

package/src/utils/image-transform.ts

@@ -70,7 +70,7 @@ export const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes = {
 /**
  * Build Cloudflare Image Resizing URL
  *
- * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.co")
+ * @param baseUrl - The base URL of your API (e.g., "https://api.perspect.comm")
  * @param mediaPath - The path to the media file (e.g., "media/site/image.jpg")
  * @param options - Transform options
  * @returns Cloudflare Image Resizing URL
@@ -78,11 +78,11 @@ export const DEFAULT_IMAGE_SIZES: ResponsiveImageSizes = {
  * @example
  * ```typescript
  * const url = buildImageUrl(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   { width: 400, format: 'webp', quality: 85 }
  * );
- * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.co/media/mysite/photo.jpg'
+ * // Returns: '/cdn-cgi/image/width=400,format=webp,quality=85/https://api.perspect.comm/media/mysite/photo.jpg'
  * ```
  */
 export function buildImageUrl(
@@ -139,7 +139,7 @@ export function buildImageUrl(
  * @example
  * ```typescript
  * const urls = generateResponsiveUrls(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg'
  * );
  * // Returns: { thumbnail: '...', small: '...', medium: '...', large: '...', original: '...' }
@@ -165,7 +165,7 @@ export function generateResponsiveUrls(
  * @example
  * ```typescript
  * const srcset = generateSrcSet(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   [400, 800, 1200]
  * );
@@ -220,7 +220,7 @@ export function generateSizesAttribute(
  * @example
  * ```typescript
  * const html = generateResponsiveImageHtml(
- *   'https://api.perspect.co',
+ *   'https://api.perspect.comm',
  *   'media/mysite/photo.jpg',
  *   'My photo',
  *   { className: 'rounded-lg', loading: 'lazy' }
@@ -271,7 +271,7 @@ export function generateResponsiveImageHtml(
  * const media = product.data.media?.[0];
  * 
  * if (media) {
- *   const urls = transformMediaItem('https://api.perspect.co', media);
+ *   const urls = transformMediaItem('https://api.perspect.comm', media);
  *   console.log(urls.thumbnail); // Cloudflare-transformed thumbnail URL
  * }
  * ```