perspectapi-ts-sdk 5.4.0 → 5.4.4

package/dist/index.d.mts

@@ -3804,6 +3804,8 @@ interface ImageTransformOptions {
         bottom?: number;
         left?: number;
     };
+    /** URL prefix for image transform paths. Defaults to '/_image'. */
+    imageUrlPrefix?: string;
 }
 interface ResponsiveImageSizes {
     thumbnail: ImageTransformOptions;

package/dist/index.d.ts

@@ -3804,6 +3804,8 @@ interface ImageTransformOptions {
         bottom?: number;
         left?: number;
     };
+    /** URL prefix for image transform paths. Defaults to '/_image'. */
+    imageUrlPrefix?: string;
 }
 interface ResponsiveImageSizes {
     thumbnail: ImageTransformOptions;

package/dist/index.js

@@ -3380,6 +3380,13 @@ var BaseV2Client = class {
    * We unwrap accordingly.
    */
   extractData(response) {
+    if ("object" in response && typeof response.object === "string") {
+      const payload2 = response;
+      if (payload2.error && typeof payload2.error === "object" && "type" in payload2.error) {
+        throw this.toError(response);
+      }
+      return response;
+    }
     const payload = response.data;
     if (payload && typeof payload === "object" && "error" in payload) {
       const errObj = payload.error;
@@ -3911,7 +3918,8 @@ function buildImageUrl(baseUrl, mediaPath, options) {
     }
   }
   const queryString = params.join(",");
-  return `/cdn-cgi/image/${queryString}/${sourceUrl}`;
+  const prefix = options?.imageUrlPrefix ?? "/_image";
+  return `${prefix}/${queryString}/${sourceUrl}`;
 }
 function generateResponsiveUrls(baseUrl, mediaPath, sizes = DEFAULT_IMAGE_SIZES) {
   return {

package/dist/index.mjs

@@ -3312,6 +3312,13 @@ var BaseV2Client = class {
    * We unwrap accordingly.
    */
   extractData(response) {
+    if ("object" in response && typeof response.object === "string") {
+      const payload2 = response;
+      if (payload2.error && typeof payload2.error === "object" && "type" in payload2.error) {
+        throw this.toError(response);
+      }
+      return response;
+    }
     const payload = response.data;
     if (payload && typeof payload === "object" && "error" in payload) {
       const errObj = payload.error;
@@ -3843,7 +3850,8 @@ function buildImageUrl(baseUrl, mediaPath, options) {
     }
   }
   const queryString = params.join(",");
-  return `/cdn-cgi/image/${queryString}/${sourceUrl}`;
+  const prefix = options?.imageUrlPrefix ?? "/_image";
+  return `${prefix}/${queryString}/${sourceUrl}`;
 }
 function generateResponsiveUrls(baseUrl, mediaPath, sizes = DEFAULT_IMAGE_SIZES) {
   return {

package/package.json

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

package/src/utils/image-transform.ts

@@ -23,6 +23,8 @@ export interface ImageTransformOptions {
     bottom?: number;
     left?: number;
   };
+  /** URL prefix for image transform paths. Defaults to '/_image'. */
+  imageUrlPrefix?: string;
 }
 
 export interface ResponsiveImageSizes {
@@ -127,10 +129,8 @@ export function buildImageUrl(
 
   const queryString = params.join(',');
 
-  // Cloudflare Image Resizing URL format:
-  // /cdn-cgi/image/{options}/{source-image-url}
-  // Note: This only works on Cloudflare zones with Image Resizing enabled
-  return `/cdn-cgi/image/${queryString}/${sourceUrl}`;
+  const prefix = options?.imageUrlPrefix ?? '/_image';
+  return `${prefix}/${queryString}/${sourceUrl}`;
 }
 
 /**

package/src/v2/client/base-v2-client.ts

@@ -68,6 +68,20 @@ export abstract class BaseV2Client {
    * We unwrap accordingly.
    */
   private extractData<T>(response: { data?: unknown; success?: boolean; error?: unknown; message?: string }): T {
+    // When the v2 API returns an object with an `object` key (e.g. list responses
+    // like { object: "list", data: [...], has_more: ... }), the shared HttpClient
+    // passes it through as-is because it detects a `data` key. In that case the
+    // *entire* response is the v2 payload — return it directly instead of
+    // double-unwrapping via `.data`.
+    if ('object' in response && typeof (response as any).object === 'string') {
+      // Still check for v2 error bodies nested inside
+      const payload = response as any;
+      if (payload.error && typeof payload.error === 'object' && 'type' in payload.error) {
+        throw this.toError(response);
+      }
+      return response as unknown as T;
+    }
+
     const payload = response.data as any;
 
     // Check if the API returned a v2 error body