perspectapi-ts-sdk 3.4.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
@@ -2506,6 +2515,61 @@ declare class SiteUsersClient extends BaseClient {
     }): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Get a user's orders (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param params - Pagination params
+     */
+    getUserOrders(siteName: string, userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ApiResponse<{
+        orders: SiteUserOrder[];
+    }>>;
+    /**
+     * Get a user's subscriptions (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserSubscriptions(siteName: string, userId: string): Promise<ApiResponse<{
+        subscriptions: SiteUserSubscription[];
+    }>>;
+    /**
+     * Pause a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     * @param resumesAt - Optional ISO date string when subscription should auto-resume
+     */
+    pauseUserSubscription(siteName: string, userId: string, subscriptionId: string, resumesAt?: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Resume a user's paused subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    resumeUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Cancel a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Get a user's credit balance (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserCreditBalance(siteName: string, userId: string): Promise<ApiResponse<CreditBalance>>;
 }
 
 /**
@@ -2714,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
@@ -2722,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;
@@ -2736,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: '...' }
@@ -2749,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]
  * );
@@ -2776,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' }
@@ -2802,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
@@ -2506,6 +2515,61 @@ declare class SiteUsersClient extends BaseClient {
     }): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Get a user's orders (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param params - Pagination params
+     */
+    getUserOrders(siteName: string, userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ApiResponse<{
+        orders: SiteUserOrder[];
+    }>>;
+    /**
+     * Get a user's subscriptions (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserSubscriptions(siteName: string, userId: string): Promise<ApiResponse<{
+        subscriptions: SiteUserSubscription[];
+    }>>;
+    /**
+     * Pause a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     * @param resumesAt - Optional ISO date string when subscription should auto-resume
+     */
+    pauseUserSubscription(siteName: string, userId: string, subscriptionId: string, resumesAt?: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Resume a user's paused subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    resumeUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Cancel a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Get a user's credit balance (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserCreditBalance(siteName: string, userId: string): Promise<ApiResponse<CreditBalance>>;
 }
 
 /**
@@ -2714,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
@@ -2722,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;
@@ -2736,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: '...' }
@@ -2749,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]
  * );
@@ -2776,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' }
@@ -2802,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
@@ -2637,6 +2650,83 @@ var SiteUsersClient = class extends BaseClient {
       data
     );
   }
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(siteName, userId, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(siteName, userId, subscriptionId, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 };
 
 // src/client/bundles-client.ts

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
@@ -2574,6 +2587,83 @@ var SiteUsersClient = class extends BaseClient {
       data
     );
   }
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(siteName, userId, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(siteName, userId, subscriptionId, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 };
 
 // src/client/bundles-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "3.4.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
@@ -496,4 +514,111 @@ export class SiteUsersClient extends BaseClient {
       data
     );
   }
+
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(
+    siteName: string,
+    userId: string,
+    params?: { limit?: number; offset?: number }
+  ): Promise<ApiResponse<{ orders: SiteUserOrder[] }>> {
+    return this.http.get<{ orders: SiteUserOrder[] }>(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(
+    siteName: string,
+    userId: string
+  ): Promise<ApiResponse<{ subscriptions: SiteUserSubscription[] }>> {
+    return this.getSingle<{ subscriptions: SiteUserSubscription[] }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string,
+    resumesAt?: string
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    const body: Record<string, string> = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create<Record<string, string>, { success: boolean }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    return this.create<Record<string, never>, { success: boolean }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string
+  ): Promise<ApiResponse<{ success: boolean; message: string }>> {
+    return this.create<Record<string, never>, { success: boolean; message: string }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(
+    siteName: string,
+    userId: string
+  ): Promise<ApiResponse<CreditBalance>> {
+    return this.getSingle<CreditBalance>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 }

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
  * }
  * ```