perspectapi-ts-sdk 2.3.0 → 2.3.3

package/dist/index.js

@@ -106,13 +106,25 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    console.log(`[HTTP Client] Making ${options.method || "GET"} request to: ${url}`);
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || "GET"}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    const safeHeaders = { ...requestOptions.headers };
+    if (safeHeaders["Authorization"]) {
+      safeHeaders["Authorization"] = "Bearer [REDACTED]";
+    }
+    if (safeHeaders["X-API-Key"]) {
+      safeHeaders["X-API-Key"] = "[REDACTED]";
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -166,16 +178,26 @@ var HttpClient = class {
    */
   buildUrl(endpoint, params) {
     const url = `${this.baseUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== void 0 && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    return finalUrl;
   }
   /**
    * Build request options
@@ -223,27 +245,42 @@ var HttpClient = class {
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
     const isJson = contentType?.includes("application/json");
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
     let data;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1e3) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in data) {
-        return data;
+        const apiResponse = data;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : "N/A"}`);
+        return apiResponse;
       }
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -778,6 +815,13 @@ var ContentClient = class extends BaseClient {
     const endpoint = this.siteScopedEndpoint(siteName);
     const path = this.buildPath(endpoint);
     const normalizedParams = params ? { ...params } : void 0;
+    console.log("[PerspectAPI Content] Starting content fetch:", {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -797,14 +841,52 @@ var ContentClient = class extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+      console.log("[PerspectAPI Content] Parameters after validation:", {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
-    return this.fetchWithCache(
+    console.log("[PerspectAPI Content] Cache details:", {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+    const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams)
+      async () => {
+        console.log("[PerspectAPI Content] Making HTTP request:", {
+          method: "GET",
+          url: path,
+          params: normalizedParams
+        });
+        const response = await this.http.get(path, normalizedParams);
+        console.log("[PerspectAPI Content] HTTP response received:", {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        if (response.data?.length === 0) {
+          console.warn("[PerspectAPI Content] WARNING: Received 0 results for query:", {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        return response;
+      }
     );
+    console.log("[PerspectAPI Content] Final result:", {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+    return result;
   }
   /**
    * Get content by ID

package/dist/index.mjs

@@ -45,13 +45,25 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    console.log(`[HTTP Client] Making ${options.method || "GET"} request to: ${url}`);
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || "GET"}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    const safeHeaders = { ...requestOptions.headers };
+    if (safeHeaders["Authorization"]) {
+      safeHeaders["Authorization"] = "Bearer [REDACTED]";
+    }
+    if (safeHeaders["X-API-Key"]) {
+      safeHeaders["X-API-Key"] = "[REDACTED]";
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -105,16 +117,26 @@ var HttpClient = class {
    */
   buildUrl(endpoint, params) {
     const url = `${this.baseUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== void 0 && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    return finalUrl;
   }
   /**
    * Build request options
@@ -162,27 +184,42 @@ var HttpClient = class {
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
     const isJson = contentType?.includes("application/json");
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
     let data;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1e3) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in data) {
-        return data;
+        const apiResponse = data;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : "N/A"}`);
+        return apiResponse;
       }
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -717,6 +754,13 @@ var ContentClient = class extends BaseClient {
     const endpoint = this.siteScopedEndpoint(siteName);
     const path = this.buildPath(endpoint);
     const normalizedParams = params ? { ...params } : void 0;
+    console.log("[PerspectAPI Content] Starting content fetch:", {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -736,14 +780,52 @@ var ContentClient = class extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+      console.log("[PerspectAPI Content] Parameters after validation:", {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
-    return this.fetchWithCache(
+    console.log("[PerspectAPI Content] Cache details:", {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+    const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams)
+      async () => {
+        console.log("[PerspectAPI Content] Making HTTP request:", {
+          method: "GET",
+          url: path,
+          params: normalizedParams
+        });
+        const response = await this.http.get(path, normalizedParams);
+        console.log("[PerspectAPI Content] HTTP response received:", {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        if (response.data?.length === 0) {
+          console.warn("[PerspectAPI Content] WARNING: Received 0 results for query:", {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        return response;
+      }
     );
+    console.log("[PerspectAPI Content] Final result:", {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+    return result;
   }
   /**
    * Get content by ID

package/package.json

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

package/src/client/content-client.ts

@@ -34,6 +34,15 @@ export class ContentClient extends BaseClient {
       ? { ...params }
       : undefined;
 
+    // Log initial request parameters
+    console.log('[PerspectAPI Content] Starting content fetch:', {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
+
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -54,15 +63,64 @@ export class ContentClient extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+
+      // Log parameter validation results
+      console.log('[PerspectAPI Content] Parameters after validation:', {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
 
-    return this.fetchWithCache<PaginatedResponse<Content>>(
+    // Log cache information
+    console.log('[PerspectAPI Content] Cache details:', {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+
+    const result = await this.fetchWithCache<PaginatedResponse<Content>>(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams) as Promise<PaginatedResponse<Content>>
+      async () => {
+        console.log('[PerspectAPI Content] Making HTTP request:', {
+          method: 'GET',
+          url: path,
+          params: normalizedParams
+        });
+        
+        const response = await this.http.get(path, normalizedParams) as PaginatedResponse<Content>;
+        
+        console.log('[PerspectAPI Content] HTTP response received:', {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        
+        // Log more details if we got 0 results
+        if (response.data?.length === 0) {
+          console.warn('[PerspectAPI Content] WARNING: Received 0 results for query:', {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        
+        return response;
+      }
     );
+
+    console.log('[PerspectAPI Content] Final result:', {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+
+    return result;
   }
 
   /**

package/src/utils/http-client.ts

@@ -68,14 +68,31 @@ export class HttpClient {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
 
-    // Log the full request details
-    console.log(`[HTTP Client] Making ${options.method || 'GET'} request to: ${url}`);
+    // Enhanced logging for debugging
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || 'GET'}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
+    
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      
+      // Specifically log slug_prefix if present
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] ⚠️ slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    
+    // Log headers (excluding sensitive data)
+    const safeHeaders: Record<string, any> = { ...requestOptions.headers };
+    if (safeHeaders['Authorization']) {
+      safeHeaders['Authorization'] = 'Bearer [REDACTED]';
+    }
+    if (safeHeaders['X-API-Key']) {
+      safeHeaders['X-API-Key'] = '[REDACTED]';
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
 
     let lastError: Error;
     
@@ -146,18 +163,31 @@ export class HttpClient {
   private buildUrl(endpoint: string, params?: Record<string, any>): string {
     const url = `${this.baseUrl}${endpoint.startsWith('/') ? '' : '/'}${endpoint}`;
     
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
+    
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
 
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== undefined && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
 
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    
+    return finalUrl;
   }
 
   /**
@@ -215,20 +245,34 @@ export class HttpClient {
     const contentType = response.headers.get('content-type');
     const isJson = contentType?.includes('application/json');
 
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
+
     let data: any;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
 
+    // Log response data (truncate if too large)
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1000) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1000) + '...');
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
+
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error: ApiError = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data,
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
 
@@ -236,12 +280,16 @@ export class HttpClient {
     if (isJson && typeof data === 'object') {
       // If response has data property, return as-is
       if ('data' in data || 'message' in data || 'error' in data) {
-        return data as ApiResponse<T>;
+        const apiResponse = data as ApiResponse<T>;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : 'N/A'}`);
+        return apiResponse;
       }
       // Otherwise wrap in data property
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data: data as T, success: true };
     }
 
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data: data as T, success: true };
   }