perspectapi-ts-sdk 7.2.2 → 7.2.4

package/dist/{chunk-Z2LA2IWQ.mjs → chunk-UFVZ7CRS.mjs}

@@ -18,10 +18,20 @@ var HttpClient = class {
   defaultHeaders;
   timeout;
   retries;
+  debug;
+  /**
+   * Debug-only logger. Off by default so request URLs, params, headers, and
+   * response bodies (emails, profiles, orders, Stripe identifiers) never
+   * leak into host logs. Opt in explicitly via `config.debug`.
+   */
+  dbg(...args) {
+    if (this.debug) console["log"](...args);
+  }
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
     this.retries = config.retries || 3;
+    this.debug = config.debug ?? false;
     this.defaultHeaders = {
       "Content-Type": "application/json",
       "User-Agent": "perspectapi-ts-sdk/1.0.0",
@@ -66,15 +76,15 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    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}`);
+    this.dbg(`[HTTP Client] ====== Request Details ======`);
+    this.dbg(`[HTTP Client] Method: ${options.method || "GET"}`);
+    this.dbg(`[HTTP Client] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client] Endpoint: ${endpoint}`);
+    this.dbg(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      this.dbg(`[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}"`);
+        this.dbg(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
       }
     }
     const safeHeaders = { ...requestOptions.headers };
@@ -84,7 +94,7 @@ var HttpClient = class {
     if (safeHeaders["X-API-Key"]) {
       safeHeaders["X-API-Key"] = "[REDACTED]";
     }
-    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
+    this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -138,25 +148,25 @@ 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}`);
+    this.dbg(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    this.dbg(`[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}`);
+      this.dbg(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
-    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    this.dbg(`[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}`);
+        this.dbg(`[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}`);
+        this.dbg(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
     const finalUrl = `${url}?${searchParams.toString()}`;
-    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
     return finalUrl;
   }
   /**
@@ -205,42 +215,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}`);
+    this.dbg(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    this.dbg(`[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);
+      this.dbg(`[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) + "...");
+      this.dbg(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
     } else {
-      console.log(`[HTTP Client - Response] Data:`, data);
+      this.dbg(`[HTTP Client - Response] Data:`, data);
     }
     if (!response.ok) {
-      console.error(`[HTTP Client - Response] Error response received`);
+      this.dbg(`[HTTP Client - Response] Error response received`);
       const error = new PerspectApiError({
         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);
+      this.dbg(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in 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"}`);
+        this.dbg(`[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`);
+      this.dbg(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
-    console.log(`[HTTP Client - Response] Returning text response`);
+    this.dbg(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -570,7 +580,9 @@ var BaseV2Client = class {
   /** GET a single resource, with optional caching. */
   async getOne(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
@@ -578,29 +590,31 @@ var BaseV2Client = class {
   /** GET a list of resources with cursor pagination, with optional caching. */
   async getList(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
   }
   /** POST to create a resource. */
   async post(path, body) {
-    const response = await this.http.post(path, body);
+    const response = await this.runRequest(() => this.http.post(path, body));
     return this.extractData(response);
   }
   /** PATCH to update a resource. */
   async patchOne(path, body) {
-    const response = await this.http.patch(path, body);
+    const response = await this.runRequest(() => this.http.patch(path, body));
     return this.extractData(response);
   }
   /** PUT to upsert a resource. */
   async putOne(path, body) {
-    const response = await this.http.put(path, body);
+    const response = await this.runRequest(() => this.http.put(path, body));
     return this.extractData(response);
   }
   /** DELETE a resource. */
   async deleteOne(path) {
-    const response = await this.http.delete(path);
+    const response = await this.runRequest(() => this.http.delete(path));
     return this.extractData(response);
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
@@ -656,6 +670,38 @@ var BaseV2Client = class {
       }
     }
   }
+  /**
+   * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+   *
+   * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+   * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+   * that body is `{ error: { type, code, message, param? } }` — the
+   * documented `PerspectV2Error` shape. Anything else (network failures,
+   * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+   * still see the original error. Named `runRequest` rather than `send` to
+   * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+   */
+  async runRequest(call) {
+    try {
+      return await call();
+    } catch (err) {
+      const v2 = this.toV2ErrorFromThrown(err);
+      if (v2) throw v2;
+      throw err;
+    }
+  }
+  toV2ErrorFromThrown(err) {
+    if (!err || typeof err !== "object") return void 0;
+    const e = err;
+    const details = e.details;
+    if (!details || typeof details !== "object") return void 0;
+    const envelope = details.error;
+    if (!envelope || typeof envelope !== "object" || !("type" in envelope) || !("message" in envelope)) {
+      return void 0;
+    }
+    const status = typeof e.status === "number" ? e.status : 500;
+    return new PerspectV2Error(envelope, status);
+  }
   toError(response) {
     const data = response.data;
     const errorObj = data?.error ?? response.error;

package/dist/{index-uyP4WdHB.d.mts → index-DVyssmFb.d.mts}

@@ -1087,6 +1087,11 @@ interface PerspectApiConfig {
     retries?: number;
     headers?: Record<string, string>;
     cache?: CacheConfig;
+    /**
+     * Opt-in verbose HTTP logging (URLs, params, headers, response bodies).
+     * Off by default so PII never leaks into host logs.
+     */
+    debug?: boolean;
 }
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 interface RequestOptions {
@@ -1108,6 +1113,13 @@ declare class HttpClient {
     private defaultHeaders;
     private timeout;
     private retries;
+    private debug;
+    /**
+     * Debug-only logger. Off by default so request URLs, params, headers, and
+     * response bodies (emails, profiles, orders, Stripe identifiers) never
+     * leak into host logs. Opt in explicitly via `config.debug`.
+     */
+    private dbg;
     constructor(config: PerspectApiConfig);
     /**
      * Update authentication token
@@ -1938,6 +1950,19 @@ declare abstract class BaseV2Client {
     protected listAutoPaginate<T extends {
         id: string;
     }>(path: string, params?: object): AsyncGenerator<T, void, unknown>;
+    /**
+     * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+     *
+     * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+     * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+     * that body is `{ error: { type, code, message, param? } }` — the
+     * documented `PerspectV2Error` shape. Anything else (network failures,
+     * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+     * still see the original error. Named `runRequest` rather than `send` to
+     * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+     */
+    private runRequest;
+    private toV2ErrorFromThrown;
     private toError;
 }
 

package/dist/{index-uyP4WdHB.d.ts → index-DVyssmFb.d.ts}

@@ -1087,6 +1087,11 @@ interface PerspectApiConfig {
     retries?: number;
     headers?: Record<string, string>;
     cache?: CacheConfig;
+    /**
+     * Opt-in verbose HTTP logging (URLs, params, headers, response bodies).
+     * Off by default so PII never leaks into host logs.
+     */
+    debug?: boolean;
 }
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 interface RequestOptions {
@@ -1108,6 +1113,13 @@ declare class HttpClient {
     private defaultHeaders;
     private timeout;
     private retries;
+    private debug;
+    /**
+     * Debug-only logger. Off by default so request URLs, params, headers, and
+     * response bodies (emails, profiles, orders, Stripe identifiers) never
+     * leak into host logs. Opt in explicitly via `config.debug`.
+     */
+    private dbg;
     constructor(config: PerspectApiConfig);
     /**
      * Update authentication token
@@ -1938,6 +1950,19 @@ declare abstract class BaseV2Client {
     protected listAutoPaginate<T extends {
         id: string;
     }>(path: string, params?: object): AsyncGenerator<T, void, unknown>;
+    /**
+     * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+     *
+     * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+     * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+     * that body is `{ error: { type, code, message, param? } }` — the
+     * documented `PerspectV2Error` shape. Anything else (network failures,
+     * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+     * still see the original error. Named `runRequest` rather than `send` to
+     * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+     */
+    private runRequest;
+    private toV2ErrorFromThrown;
     private toError;
 }
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-uyP4WdHB.mjs';
-export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-uyP4WdHB.mjs';
+import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-DVyssmFb.mjs';
+export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-DVyssmFb.mjs';
 
 /**
  * v1 deprecation constants — kept in sync with the backend's

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-uyP4WdHB.js';
-export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-uyP4WdHB.js';
+import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-DVyssmFb.js';
+export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, c4 as CheckoutMetadataValue, c9 as CheckoutSessionTax, c8 as CheckoutTaxBreakdownItem, c7 as CheckoutTaxCustomerExemptionRequest, c6 as CheckoutTaxExemptionStatus, c5 as CheckoutTaxStrategy, b_ as ContentStatus, b$ as ContentType, c2 as CreatePaymentGatewayRequest, cb as CreditTransaction, cc as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bZ as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, c0 as ProductSkuMediaItem, c1 as ProductSkuOption, cd as RequestOptions, aQ as SetProfileValueRequest, ca as SubscriptionCancellationMode, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, c3 as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-DVyssmFb.js';
 
 /**
  * v1 deprecation constants — kept in sync with the backend's

package/dist/index.js

@@ -104,10 +104,20 @@ var HttpClient = class {
   defaultHeaders;
   timeout;
   retries;
+  debug;
+  /**
+   * Debug-only logger. Off by default so request URLs, params, headers, and
+   * response bodies (emails, profiles, orders, Stripe identifiers) never
+   * leak into host logs. Opt in explicitly via `config.debug`.
+   */
+  dbg(...args) {
+    if (this.debug) console["log"](...args);
+  }
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
     this.retries = config.retries || 3;
+    this.debug = config.debug ?? false;
     this.defaultHeaders = {
       "Content-Type": "application/json",
       "User-Agent": "perspectapi-ts-sdk/1.0.0",
@@ -152,15 +162,15 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    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}`);
+    this.dbg(`[HTTP Client] ====== Request Details ======`);
+    this.dbg(`[HTTP Client] Method: ${options.method || "GET"}`);
+    this.dbg(`[HTTP Client] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client] Endpoint: ${endpoint}`);
+    this.dbg(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      this.dbg(`[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}"`);
+        this.dbg(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
       }
     }
     const safeHeaders = { ...requestOptions.headers };
@@ -170,7 +180,7 @@ var HttpClient = class {
     if (safeHeaders["X-API-Key"]) {
       safeHeaders["X-API-Key"] = "[REDACTED]";
     }
-    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
+    this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -224,25 +234,25 @@ 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}`);
+    this.dbg(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    this.dbg(`[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}`);
+      this.dbg(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
-    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    this.dbg(`[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}`);
+        this.dbg(`[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}`);
+        this.dbg(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
     const finalUrl = `${url}?${searchParams.toString()}`;
-    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
     return finalUrl;
   }
   /**
@@ -291,42 +301,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}`);
+    this.dbg(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    this.dbg(`[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);
+      this.dbg(`[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) + "...");
+      this.dbg(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
     } else {
-      console.log(`[HTTP Client - Response] Data:`, data);
+      this.dbg(`[HTTP Client - Response] Data:`, data);
     }
     if (!response.ok) {
-      console.error(`[HTTP Client - Response] Error response received`);
+      this.dbg(`[HTTP Client - Response] Error response received`);
       const error = new PerspectApiError({
         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);
+      this.dbg(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in 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"}`);
+        this.dbg(`[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`);
+      this.dbg(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
-    console.log(`[HTTP Client - Response] Returning text response`);
+    this.dbg(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -656,7 +666,9 @@ var BaseV2Client = class {
   /** GET a single resource, with optional caching. */
   async getOne(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
@@ -664,29 +676,31 @@ var BaseV2Client = class {
   /** GET a list of resources with cursor pagination, with optional caching. */
   async getList(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
   }
   /** POST to create a resource. */
   async post(path, body) {
-    const response = await this.http.post(path, body);
+    const response = await this.runRequest(() => this.http.post(path, body));
     return this.extractData(response);
   }
   /** PATCH to update a resource. */
   async patchOne(path, body) {
-    const response = await this.http.patch(path, body);
+    const response = await this.runRequest(() => this.http.patch(path, body));
     return this.extractData(response);
   }
   /** PUT to upsert a resource. */
   async putOne(path, body) {
-    const response = await this.http.put(path, body);
+    const response = await this.runRequest(() => this.http.put(path, body));
     return this.extractData(response);
   }
   /** DELETE a resource. */
   async deleteOne(path) {
-    const response = await this.http.delete(path);
+    const response = await this.runRequest(() => this.http.delete(path));
     return this.extractData(response);
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
@@ -742,6 +756,38 @@ var BaseV2Client = class {
       }
     }
   }
+  /**
+   * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+   *
+   * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+   * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+   * that body is `{ error: { type, code, message, param? } }` — the
+   * documented `PerspectV2Error` shape. Anything else (network failures,
+   * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+   * still see the original error. Named `runRequest` rather than `send` to
+   * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+   */
+  async runRequest(call) {
+    try {
+      return await call();
+    } catch (err) {
+      const v2 = this.toV2ErrorFromThrown(err);
+      if (v2) throw v2;
+      throw err;
+    }
+  }
+  toV2ErrorFromThrown(err) {
+    if (!err || typeof err !== "object") return void 0;
+    const e = err;
+    const details = e.details;
+    if (!details || typeof details !== "object") return void 0;
+    const envelope = details.error;
+    if (!envelope || typeof envelope !== "object" || !("type" in envelope) || !("message" in envelope)) {
+      return void 0;
+    }
+    const status = typeof e.status === "number" ? e.status : 500;
+    return new PerspectV2Error(envelope, status);
+  }
   toError(response) {
     const data = response.data;
     const errorObj = data?.error ?? response.error;

package/dist/index.mjs

@@ -7,7 +7,7 @@ import {
   PerspectV2Error,
   createApiError,
   createPerspectApiV2Client
-} from "./chunk-Z2LA2IWQ.mjs";
+} from "./chunk-UFVZ7CRS.mjs";
 
 // src/deprecation.ts
 var V1_SUNSET_DATE = "2026-06-01";

package/dist/v2/index.d.mts

@@ -1 +1 @@
-export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-uyP4WdHB.mjs';
+export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-DVyssmFb.mjs';

package/dist/v2/index.d.ts

@@ -1 +1 @@
-export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-uyP4WdHB.js';
+export { cq as ApiKeysV2Client, cf as BaseV2Client, ci as CategoriesV2Client, cj as CollectionsV2Client, cn as ContactsV2Client, cg as ContentV2Client, ct as CreditsV2Client, cu as EmailV2Client, cm as NewsletterV2Client, ck as OrdersV2Client, co as OrganizationsV2Client, ay as PerspectApiV2Client, ce as PerspectApiV2Config, aA as PerspectV2Error, ch as ProductsV2Client, cl as SiteUsersV2Client, cp as SitesV2Client, cs as SubscriptionsV2Client, bH as V2ApiKey, bS as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bE as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bU as V2CreditBalance, bT as V2CreditTransaction, aT as V2Deleted, bX as V2EmailSendParams, bY as V2EmailSendResult, aU as V2Error, aV as V2ErrorType, bV as V2GrantCreditParams, bW as V2GrantCreditResult, aS as V2List, aX as V2Media, bv as V2NewsletterCampaign, bC as V2NewsletterImportRequest, bD as V2NewsletterImportResult, bu as V2NewsletterList, bx as V2NewsletterListCreateParams, by as V2NewsletterListUpdateParams, bt as V2NewsletterSubscription, bB as V2NewsletterSubscriptionListMembershipUpdate, bz as V2NewsletterSyncInput, bA as V2NewsletterSyncResult, bw as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bm as V2OrderCreateResult, bj as V2OrderFulfillmentNotificationLineItem, bk as V2OrderFulfillmentNotificationParams, bl as V2OrderFulfillmentNotificationResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bF as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bG as V2Site, bn as V2SiteUser, bq as V2SiteUserListParams, bp as V2SiteUserMeUpdateParams, bs as V2SiteUserProfile, bM as V2SiteUserSubscription, bo as V2SiteUserUpdateParams, br as V2SiteUserWithProfile, bO as V2SubscriptionCancelParams, bP as V2SubscriptionChangePlanParams, bQ as V2SubscriptionChargeParams, bR as V2SubscriptionChargeResult, bN as V2SubscriptionPauseParams, bJ as V2Webhook, bK as V2WebhookCreateParams, bI as V2WebhookEventType, bL as V2WebhookUpdateParams, cr as WebhooksV2Client, az as createPerspectApiV2Client } from '../index-DVyssmFb.js';

package/dist/v2/index.js

@@ -62,10 +62,20 @@ var HttpClient = class {
   defaultHeaders;
   timeout;
   retries;
+  debug;
+  /**
+   * Debug-only logger. Off by default so request URLs, params, headers, and
+   * response bodies (emails, profiles, orders, Stripe identifiers) never
+   * leak into host logs. Opt in explicitly via `config.debug`.
+   */
+  dbg(...args) {
+    if (this.debug) console["log"](...args);
+  }
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
     this.retries = config.retries || 3;
+    this.debug = config.debug ?? false;
     this.defaultHeaders = {
       "Content-Type": "application/json",
       "User-Agent": "perspectapi-ts-sdk/1.0.0",
@@ -110,15 +120,15 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    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}`);
+    this.dbg(`[HTTP Client] ====== Request Details ======`);
+    this.dbg(`[HTTP Client] Method: ${options.method || "GET"}`);
+    this.dbg(`[HTTP Client] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client] Endpoint: ${endpoint}`);
+    this.dbg(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      this.dbg(`[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}"`);
+        this.dbg(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
       }
     }
     const safeHeaders = { ...requestOptions.headers };
@@ -128,7 +138,7 @@ var HttpClient = class {
     if (safeHeaders["X-API-Key"]) {
       safeHeaders["X-API-Key"] = "[REDACTED]";
     }
-    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
+    this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -182,25 +192,25 @@ 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}`);
+    this.dbg(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    this.dbg(`[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}`);
+      this.dbg(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
-    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    this.dbg(`[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}`);
+        this.dbg(`[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}`);
+        this.dbg(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
     const finalUrl = `${url}?${searchParams.toString()}`;
-    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
     return finalUrl;
   }
   /**
@@ -249,42 +259,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}`);
+    this.dbg(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    this.dbg(`[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);
+      this.dbg(`[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) + "...");
+      this.dbg(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
     } else {
-      console.log(`[HTTP Client - Response] Data:`, data);
+      this.dbg(`[HTTP Client - Response] Data:`, data);
     }
     if (!response.ok) {
-      console.error(`[HTTP Client - Response] Error response received`);
+      this.dbg(`[HTTP Client - Response] Error response received`);
       const error = new PerspectApiError({
         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);
+      this.dbg(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in 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"}`);
+        this.dbg(`[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`);
+      this.dbg(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
-    console.log(`[HTTP Client - Response] Returning text response`);
+    this.dbg(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -602,7 +612,9 @@ var BaseV2Client = class {
   /** GET a single resource, with optional caching. */
   async getOne(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
@@ -610,29 +622,31 @@ var BaseV2Client = class {
   /** GET a list of resources with cursor pagination, with optional caching. */
   async getList(path, params, cachePolicy) {
     const fetcher = async () => {
-      const response = await this.http.get(path, this.toParams(params));
+      const response = await this.runRequest(
+        () => this.http.get(path, this.toParams(params))
+      );
       return this.extractData(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
   }
   /** POST to create a resource. */
   async post(path, body) {
-    const response = await this.http.post(path, body);
+    const response = await this.runRequest(() => this.http.post(path, body));
     return this.extractData(response);
   }
   /** PATCH to update a resource. */
   async patchOne(path, body) {
-    const response = await this.http.patch(path, body);
+    const response = await this.runRequest(() => this.http.patch(path, body));
     return this.extractData(response);
   }
   /** PUT to upsert a resource. */
   async putOne(path, body) {
-    const response = await this.http.put(path, body);
+    const response = await this.runRequest(() => this.http.put(path, body));
     return this.extractData(response);
   }
   /** DELETE a resource. */
   async deleteOne(path) {
-    const response = await this.http.delete(path);
+    const response = await this.runRequest(() => this.http.delete(path));
     return this.extractData(response);
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
@@ -688,6 +702,38 @@ var BaseV2Client = class {
       }
     }
   }
+  /**
+   * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+   *
+   * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+   * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+   * that body is `{ error: { type, code, message, param? } }` — the
+   * documented `PerspectV2Error` shape. Anything else (network failures,
+   * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+   * still see the original error. Named `runRequest` rather than `send` to
+   * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+   */
+  async runRequest(call) {
+    try {
+      return await call();
+    } catch (err) {
+      const v2 = this.toV2ErrorFromThrown(err);
+      if (v2) throw v2;
+      throw err;
+    }
+  }
+  toV2ErrorFromThrown(err) {
+    if (!err || typeof err !== "object") return void 0;
+    const e = err;
+    const details = e.details;
+    if (!details || typeof details !== "object") return void 0;
+    const envelope = details.error;
+    if (!envelope || typeof envelope !== "object" || !("type" in envelope) || !("message" in envelope)) {
+      return void 0;
+    }
+    const status = typeof e.status === "number" ? e.status : 500;
+    return new PerspectV2Error(envelope, status);
+  }
   toError(response) {
     const data = response.data;
     const errorObj = data?.error ?? response.error;

package/dist/v2/index.mjs

@@ -18,7 +18,7 @@ import {
   SubscriptionsV2Client,
   WebhooksV2Client,
   createPerspectApiV2Client
-} from "../chunk-Z2LA2IWQ.mjs";
+} from "../chunk-UFVZ7CRS.mjs";
 export {
   ApiKeysV2Client,
   BaseV2Client,

package/package.json

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

package/src/types/index.ts

@@ -1192,6 +1192,11 @@ export interface PerspectApiConfig {
   retries?: number;
   headers?: Record<string, string>;
   cache?: CacheConfig;
+  /**
+   * Opt-in verbose HTTP logging (URLs, params, headers, response bodies).
+   * Off by default so PII never leaks into host logs.
+   */
+  debug?: boolean;
 }
 
 // HTTP Methods

package/src/utils/http-client.ts

@@ -16,11 +16,22 @@ export class HttpClient {
   private defaultHeaders: Record<string, string>;
   private timeout: number;
   private retries: number;
+  private debug: boolean;
+
+  /**
+   * Debug-only logger. Off by default so request URLs, params, headers, and
+   * response bodies (emails, profiles, orders, Stripe identifiers) never
+   * leak into host logs. Opt in explicitly via `config.debug`.
+   */
+  private dbg(...args: unknown[]): void {
+    if (this.debug) console["log"](...args);
+  }
 
   constructor(config: PerspectApiConfig) {
     this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
     this.timeout = config.timeout || 30000;
     this.retries = config.retries || 3;
+    this.debug = config.debug ?? false;
     
     this.defaultHeaders = {
       'Content-Type': 'application/json',
@@ -78,18 +89,18 @@ export class HttpClient {
     const requestOptions = this.buildRequestOptions(options);
 
     // 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}`);
+    this.dbg(`[HTTP Client] ====== Request Details ======`);
+    this.dbg(`[HTTP Client] Method: ${options.method || 'GET'}`);
+    this.dbg(`[HTTP Client] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client] Endpoint: ${endpoint}`);
+    this.dbg(`[HTTP Client] Full URL: ${url}`);
     
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      this.dbg(`[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}"`);
+        this.dbg(`[HTTP Client] ⚠️ slug_prefix detected: "${options.params.slug_prefix}"`);
       }
     }
     
@@ -101,7 +112,7 @@ export class HttpClient {
     if (safeHeaders['X-API-Key']) {
       safeHeaders['X-API-Key'] = '[REDACTED]';
     }
-    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
+    this.dbg(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
 
     let lastError: Error;
     
@@ -172,29 +183,29 @@ 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}`);
+    this.dbg(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    this.dbg(`[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}`);
+      this.dbg(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
 
-    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    this.dbg(`[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}`);
+        this.dbg(`[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}`);
+        this.dbg(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
 
     const finalUrl = `${url}?${searchParams.toString()}`;
-    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    this.dbg(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
     
     return finalUrl;
   }
@@ -254,34 +265,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}`);
+    this.dbg(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    this.dbg(`[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);
+      this.dbg(`[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) + '...');
+      this.dbg(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1000) + '...');
     } else {
-      console.log(`[HTTP Client - Response] Data:`, data);
+      this.dbg(`[HTTP Client - Response] Data:`, data);
     }
 
     if (!response.ok) {
-      console.error(`[HTTP Client - Response] Error response received`);
+      this.dbg(`[HTTP Client - Response] Error response received`);
       const error = new PerspectApiError({
         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);
+      this.dbg(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
 
@@ -290,15 +301,15 @@ export class HttpClient {
       // If response has data property, return as-is
       if ('data' in data || 'message' in data || 'error' in data) {
         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'}`);
+        this.dbg(`[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`);
+      this.dbg(`[HTTP Client - Response] Wrapping response in data property`);
       return { data: data as T, success: true };
     }
 
-    console.log(`[HTTP Client - Response] Returning text response`);
+    this.dbg(`[HTTP Client - Response] Returning text response`);
     return { data: data as T, success: true };
   }
 

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

@@ -98,7 +98,9 @@ export abstract class BaseV2Client {
   /** GET a single resource, with optional caching. */
   protected async getOne<T>(path: string, params?: object, cachePolicy?: CachePolicy): Promise<T> {
     const fetcher = async () => {
-      const response = await this.http.get<T>(path, this.toParams(params));
+      const response = await this.runRequest(() =>
+        this.http.get<T>(path, this.toParams(params)),
+      );
       return this.extractData<T>(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
@@ -111,7 +113,9 @@ export abstract class BaseV2Client {
     cachePolicy?: CachePolicy,
   ): Promise<V2List<T>> {
     const fetcher = async () => {
-      const response = await this.http.get<V2List<T>>(path, this.toParams(params));
+      const response = await this.runRequest(() =>
+        this.http.get<V2List<T>>(path, this.toParams(params)),
+      );
       return this.extractData<V2List<T>>(response);
     };
     return this.fetchWithCache(path, params, cachePolicy, fetcher);
@@ -119,25 +123,25 @@ export abstract class BaseV2Client {
 
   /** POST to create a resource. */
   protected async post<T>(path: string, body?: unknown): Promise<T> {
-    const response = await this.http.post<T>(path, body);
+    const response = await this.runRequest(() => this.http.post<T>(path, body));
     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);
+    const response = await this.runRequest(() => this.http.patch<T>(path, body));
     return this.extractData<T>(response);
   }
 
   /** PUT to upsert a resource. */
   protected async putOne<T>(path: string, body?: unknown): Promise<T> {
-    const response = await this.http.put<T>(path, body);
+    const response = await this.runRequest(() => this.http.put<T>(path, body));
     return this.extractData<T>(response);
   }
 
   /** DELETE a resource. */
   protected async deleteOne(path: string): Promise<V2Deleted> {
-    const response = await this.http.delete<V2Deleted>(path);
+    const response = await this.runRequest(() => this.http.delete<V2Deleted>(path));
     return this.extractData<V2Deleted>(response);
   }
 
@@ -209,6 +213,45 @@ export abstract class BaseV2Client {
     }
   }
 
+  /**
+   * Run an HttpClient call and convert v2 error responses to PerspectV2Error.
+   *
+   * `HttpClient` throws `PerspectApiError` on any non-2xx, with the parsed
+   * body on `.details` and the HTTP status on `.status`. For v2 endpoints
+   * that body is `{ error: { type, code, message, param? } }` — the
+   * documented `PerspectV2Error` shape. Anything else (network failures,
+   * non-JSON bodies, malformed envelopes) is rethrown unchanged so callers
+   * still see the original error. Named `runRequest` rather than `send` to
+   * avoid colliding with subclass domain methods (e.g. EmailV2Client.send).
+   */
+  private async runRequest<R>(call: () => Promise<R>): Promise<R> {
+    try {
+      return await call();
+    } catch (err) {
+      const v2 = this.toV2ErrorFromThrown(err);
+      if (v2) throw v2;
+      throw err;
+    }
+  }
+
+  private toV2ErrorFromThrown(err: unknown): PerspectV2Error | undefined {
+    if (!err || typeof err !== 'object') return undefined;
+    const e = err as { status?: unknown; details?: unknown };
+    const details = e.details;
+    if (!details || typeof details !== 'object') return undefined;
+    const envelope = (details as { error?: unknown }).error;
+    if (
+      !envelope ||
+      typeof envelope !== 'object' ||
+      !('type' in envelope) ||
+      !('message' in envelope)
+    ) {
+      return undefined;
+    }
+    const status = typeof e.status === 'number' ? e.status : 500;
+    return new PerspectV2Error(envelope as V2Error['error'], status);
+  }
+
   private toError(response: { data?: unknown; error?: unknown; message?: string }): PerspectV2Error {
     const data = response.data as Record<string, unknown> | undefined;
     const errorObj = (data?.error ?? response.error) as V2Error['error'] | undefined;