perspectapi-ts-sdk 7.2.3 → 7.2.6

package/dist/{chunk-TFN5IR35.mjs → chunk-WD62IBI5.mjs}

@@ -580,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);
@@ -588,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. */
@@ -666,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;
@@ -1359,6 +1395,13 @@ var SubscriptionsV2Client = class extends BaseV2Client {
       params ?? {}
     );
   }
+  /** Change the plan (price) of a user's subscription (admin). */
+  async changeUserSubscriptionPlan(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
   /** Charge a user's subscription once (admin). */
   async chargeUserSubscription(siteName, userId, subId, params) {
     return this.post(

package/dist/{index-hSqTwbPy.d.mts → index-BbTVcEl5.d.mts}

@@ -1950,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;
 }
 
@@ -2266,6 +2279,8 @@ declare class SubscriptionsV2Client extends BaseV2Client {
     resumeUserSubscription(siteName: string, userId: string, subId: string): Promise<V2SiteUserSubscription>;
     /** Cancel a user's subscription (admin). */
     cancelUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
+    /** Change the plan (price) of a user's subscription (admin). */
+    changeUserSubscriptionPlan(siteName: string, userId: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
     /** Charge a user's subscription once (admin). */
     chargeUserSubscription(siteName: string, userId: string, subId: string, params: V2SubscriptionChargeParams): Promise<V2SubscriptionChargeResult>;
 }

package/dist/{index-hSqTwbPy.d.ts → index-BbTVcEl5.d.ts}

@@ -1950,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;
 }
 
@@ -2266,6 +2279,8 @@ declare class SubscriptionsV2Client extends BaseV2Client {
     resumeUserSubscription(siteName: string, userId: string, subId: string): Promise<V2SiteUserSubscription>;
     /** Cancel a user's subscription (admin). */
     cancelUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
+    /** Change the plan (price) of a user's subscription (admin). */
+    changeUserSubscriptionPlan(siteName: string, userId: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
     /** Charge a user's subscription once (admin). */
     chargeUserSubscription(siteName: string, userId: string, subId: string, params: V2SubscriptionChargeParams): Promise<V2SubscriptionChargeResult>;
 }

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-hSqTwbPy.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-hSqTwbPy.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-BbTVcEl5.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-BbTVcEl5.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-hSqTwbPy.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-hSqTwbPy.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-BbTVcEl5.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-BbTVcEl5.js';
 
 /**
  * v1 deprecation constants — kept in sync with the backend's

package/dist/index.js

@@ -666,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);
@@ -674,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. */
@@ -752,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;
@@ -1445,6 +1481,13 @@ var SubscriptionsV2Client = class extends BaseV2Client {
       params ?? {}
     );
   }
+  /** Change the plan (price) of a user's subscription (admin). */
+  async changeUserSubscriptionPlan(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
   /** Charge a user's subscription once (admin). */
   async chargeUserSubscription(siteName, userId, subId, params) {
     return this.post(

package/dist/index.mjs

@@ -7,7 +7,7 @@ import {
   PerspectV2Error,
   createApiError,
   createPerspectApiV2Client
-} from "./chunk-TFN5IR35.mjs";
+} from "./chunk-WD62IBI5.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-hSqTwbPy.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-BbTVcEl5.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-hSqTwbPy.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-BbTVcEl5.js';

package/dist/v2/index.js

@@ -612,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);
@@ -620,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. */
@@ -698,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;
@@ -1391,6 +1427,13 @@ var SubscriptionsV2Client = class extends BaseV2Client {
       params ?? {}
     );
   }
+  /** Change the plan (price) of a user's subscription (admin). */
+  async changeUserSubscriptionPlan(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
   /** Charge a user's subscription once (admin). */
   async chargeUserSubscription(siteName, userId, subId, params) {
     return this.post(

package/dist/v2/index.mjs

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

package/package.json

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

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;

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

@@ -133,6 +133,19 @@ export class SubscriptionsV2Client extends BaseV2Client {
     );
   }
 
+  /** Change the plan (price) of a user's subscription (admin). */
+  async changeUserSubscriptionPlan(
+    siteName: string,
+    userId: string,
+    subId: string,
+    params: V2SubscriptionChangePlanParams,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `${userId}/subscriptions/${subId}/change-plan`),
+      params,
+    );
+  }
+
   /** Charge a user's subscription once (admin). */
   async chargeUserSubscription(
     siteName: string,