perspectapi-ts-sdk 5.0.0 → 5.0.1

package/dist/index.d.mts

@@ -3427,6 +3427,18 @@ declare abstract class BaseV2Client {
     protected buildPath(endpoint: string): string;
     protected sitePath(siteName: string, resource: string, suffix?: string): string;
     private toParams;
+    /**
+     * Extract v2 payload from HttpClient response.
+     *
+     * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+     * v2 API responses don't have a `success` field — the HttpClient already throws
+     * on HTTP errors, so if we reach this point the request succeeded.
+     *
+     * The HttpClient may return the v2 payload nested under `data` (when the response
+     * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+     * We unwrap accordingly.
+     */
+    private extractData;
     /** GET a single resource. */
     protected getOne<T>(path: string, params?: object): Promise<T>;
     /** GET a list of resources with cursor pagination. */

package/dist/index.d.ts

@@ -3427,6 +3427,18 @@ declare abstract class BaseV2Client {
     protected buildPath(endpoint: string): string;
     protected sitePath(siteName: string, resource: string, suffix?: string): string;
     private toParams;
+    /**
+     * Extract v2 payload from HttpClient response.
+     *
+     * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+     * v2 API responses don't have a `success` field — the HttpClient already throws
+     * on HTTP errors, so if we reach this point the request succeeded.
+     *
+     * The HttpClient may return the v2 payload nested under `data` (when the response
+     * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+     * We unwrap accordingly.
+     */
+    private extractData;
     /** GET a single resource. */
     protected getOne<T>(path: string, params?: object): Promise<T>;
     /** GET a list of resources with cursor pagination. */

package/dist/index.js

@@ -3365,45 +3365,51 @@ var BaseV2Client = class {
     }
     return Object.keys(out).length > 0 ? out : void 0;
   }
+  /**
+   * Extract v2 payload from HttpClient response.
+   *
+   * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+   * v2 API responses don't have a `success` field — the HttpClient already throws
+   * on HTTP errors, so if we reach this point the request succeeded.
+   *
+   * The HttpClient may return the v2 payload nested under `data` (when the response
+   * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+   * We unwrap accordingly.
+   */
+  extractData(response) {
+    const payload = response.data;
+    if (payload && typeof payload === "object" && "error" in payload) {
+      const errObj = payload.error;
+      if (errObj && typeof errObj === "object" && "type" in errObj) {
+        throw this.toError(response);
+      }
+    }
+    return payload;
+  }
   /** GET a single resource. */
   async getOne(path, params) {
     const response = await this.http.get(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** GET a list of resources with cursor pagination. */
   async getList(path, params) {
     const response = await this.http.get(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** POST to create a resource. */
   async post(path, body) {
     const response = await this.http.post(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** PATCH to update a resource. */
   async patchOne(path, body) {
     const response = await this.http.patch(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** DELETE a resource. */
   async deleteOne(path) {
     const response = await this.http.delete(path);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /**
    * Auto-paginating async generator.

package/dist/index.mjs

@@ -3298,45 +3298,51 @@ var BaseV2Client = class {
     }
     return Object.keys(out).length > 0 ? out : void 0;
   }
+  /**
+   * Extract v2 payload from HttpClient response.
+   *
+   * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+   * v2 API responses don't have a `success` field — the HttpClient already throws
+   * on HTTP errors, so if we reach this point the request succeeded.
+   *
+   * The HttpClient may return the v2 payload nested under `data` (when the response
+   * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+   * We unwrap accordingly.
+   */
+  extractData(response) {
+    const payload = response.data;
+    if (payload && typeof payload === "object" && "error" in payload) {
+      const errObj = payload.error;
+      if (errObj && typeof errObj === "object" && "type" in errObj) {
+        throw this.toError(response);
+      }
+    }
+    return payload;
+  }
   /** GET a single resource. */
   async getOne(path, params) {
     const response = await this.http.get(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** GET a list of resources with cursor pagination. */
   async getList(path, params) {
     const response = await this.http.get(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** POST to create a resource. */
   async post(path, body) {
     const response = await this.http.post(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** PATCH to update a resource. */
   async patchOne(path, body) {
     const response = await this.http.patch(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /** DELETE a resource. */
   async deleteOne(path) {
     const response = await this.http.delete(path);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data;
+    return this.extractData(response);
   }
   /**
    * Auto-paginating async generator.

package/package.json

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

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

@@ -52,13 +52,35 @@ export abstract class BaseV2Client {
     return Object.keys(out).length > 0 ? out : undefined;
   }
 
+  /**
+   * Extract v2 payload from HttpClient response.
+   *
+   * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
+   * v2 API responses don't have a `success` field — the HttpClient already throws
+   * on HTTP errors, so if we reach this point the request succeeded.
+   *
+   * The HttpClient may return the v2 payload nested under `data` (when the response
+   * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
+   * We unwrap accordingly.
+   */
+  private extractData<T>(response: { data?: unknown; success?: boolean; error?: unknown; message?: string }): T {
+    const payload = response.data as any;
+
+    // Check if the API returned a v2 error body
+    if (payload && typeof payload === 'object' && 'error' in payload) {
+      const errObj = payload.error;
+      if (errObj && typeof errObj === 'object' && 'type' in errObj) {
+        throw this.toError(response);
+      }
+    }
+
+    return payload as T;
+  }
+
   /** GET a single resource. */
   protected async getOne<T>(path: string, params?: object): Promise<T> {
     const response = await this.http.get<T>(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data!;
+    return this.extractData<T>(response);
   }
 
   /** GET a list of resources with cursor pagination. */
@@ -67,37 +89,25 @@ export abstract class BaseV2Client {
     params?: object,
   ): Promise<V2List<T>> {
     const response = await this.http.get<V2List<T>>(path, this.toParams(params));
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data!;
+    return this.extractData<V2List<T>>(response);
   }
 
   /** POST to create a resource. */
   protected async post<T>(path: string, body?: unknown): Promise<T> {
     const response = await this.http.post<T>(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data!;
+    return this.extractData<T>(response);
   }
 
   /** PATCH to update a resource. */
   protected async patchOne<T>(path: string, body?: unknown): Promise<T> {
     const response = await this.http.patch<T>(path, body);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data!;
+    return this.extractData<T>(response);
   }
 
   /** DELETE a resource. */
   protected async deleteOne(path: string): Promise<V2Deleted> {
     const response = await this.http.delete<V2Deleted>(path);
-    if (!response.success) {
-      throw this.toError(response);
-    }
-    return response.data!;
+    return this.extractData<V2Deleted>(response);
   }
 
   /**