perspectapi-ts-sdk 6.5.4 → 6.5.7

package/dist/index.d.mts

@@ -741,12 +741,13 @@ interface CreatePaymentGatewayRequest {
     configuration: Record<string, any>;
     isActive?: boolean;
 }
+type WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
 interface Webhook {
     id: string;
     name: string;
     url: string;
     provider: string;
-    events: string[];
+    events: WebhookEventType[];
     isActive: boolean;
     secret?: string;
     organizationId?: number;
@@ -757,7 +758,7 @@ interface CreateWebhookRequest {
     name: string;
     url: string;
     provider: string;
-    events: string[];
+    events: WebhookEventType[];
     isActive?: boolean;
     secret?: string;
 }
@@ -1125,6 +1126,11 @@ declare class HttpClient {
      * Update API key
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Whether this client currently has a site-user/admin bearer token attached.
+     * Bearer-scoped GETs must not share cache entries across callers.
+     */
+    hasBearerAuth(): boolean;
     /**
      * Remove authentication
      */
@@ -1701,11 +1707,12 @@ interface V2ApiKey extends V2Object {
     created_at: string | null;
     updated_at: string | null;
 }
+type V2WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
 interface V2Webhook extends V2Object {
     object: "webhook";
     url: string;
     description: string | null;
-    events: string[] | null;
+    events: V2WebhookEventType[] | null;
     is_active: boolean;
     created_at: string | null;
     updated_at: string | null;
@@ -1713,7 +1720,7 @@ interface V2Webhook extends V2Object {
 interface V2WebhookCreateParams {
     url: string;
     description?: string;
-    events?: string[];
+    events?: V2WebhookEventType[];
     is_active?: boolean;
 }
 interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
@@ -1967,13 +1974,14 @@ declare class SiteUsersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2SiteUserListParams): Promise<V2List<V2SiteUser>>;
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
+    getProfileForUser(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
     /**
      * Load the currently-authenticated site user's canonical record plus their
      * profile KV map. Requires `client.setAuth(jwt)` to have been called with
      * the token returned from `verifyOtp`.
      */
-    getMe(siteName: string): Promise<V2SiteUserWithProfile>;
+    getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile>;
     /** Update the authenticated user's own fields. */
     updateMe(siteName: string, data: V2SiteUserMeUpdateParams): Promise<V2SiteUser>;
     /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
@@ -2143,9 +2151,9 @@ declare class SubscriptionsV2Client extends BaseV2Client {
 
 declare class CreditsV2Client extends BaseV2Client {
     /** Get the current credit balance for the authenticated user. */
-    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get credit balance and transaction history for the authenticated user. */
-    getMyCredits(siteName: string): Promise<V2CreditBalance>;
+    getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get the credit balance for a specific user (admin). */
     getUserBalance(siteName: string, userId: string): Promise<V2CreditBalance>;
     /** Grant credit to a specific user (admin). */
@@ -4534,4 +4542,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AbClient, type AbForRequestResult, type AbVariantResult, type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheAdapter, type CacheConfig, CacheManager, type CancelSubscriptionRequest, type CancelSubscriptionResponse, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, CloudflareKVCacheAdapter, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreatePerspectAbOptions, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, type NewsletterCampaignTestSendRequest, type NewsletterCampaignTestSendResponse, NewsletterClient, type NewsletterConfirmResponse, type NewsletterExportCreateRequest, type NewsletterExportCreateResponse, type NewsletterList, type NewsletterManagementCampaign, type NewsletterManagementCampaignListResponse, NewsletterManagementClient, type NewsletterManagementList, type NewsletterManagementListMembership, type NewsletterManagementPagination, type NewsletterManagementSeries, type NewsletterManagementStatsResponse, type NewsletterManagementSubscription, type NewsletterManagementSubscriptionsListResponse, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterSubscriptionImportRowRequest, type NewsletterSubscriptionMembershipUpdateRequest, type NewsletterSubscriptionSyncRequest, type NewsletterSubscriptionSyncResponse, type NewsletterSubscriptionsBulkAction, type NewsletterSubscriptionsBulkOutcome, type NewsletterSubscriptionsBulkUpdateRequest, type NewsletterSubscriptionsBulkUpdateResponse, type NewsletterSubscriptionsImportRequest, type NewsletterSubscriptionsImportResponse, type NewsletterSubscriptionsImportRowResult, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, type PerspectAb, PerspectApiClient, type PerspectApiConfig, PerspectApiError, PerspectApiV2Client, PerspectV2Error, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type SubscriptionCancellationMode, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, type V2ApiKey, type V2CancelSubscriptionResult, type V2Category, type V2CategoryCreateParams, type V2CategoryUpdateParams, type V2Collection, type V2CollectionCreateParams, type V2CollectionItem, type V2CollectionUpdateParams, type V2ContactSubmission, type V2Content, type V2ContentCreateParams, type V2ContentListParams, type V2ContentUpdateParams, type V2CreditBalance, type V2CreditTransaction, type V2Deleted, type V2Error, type V2ErrorType, type V2GrantCreditParams, type V2GrantCreditResult, type V2List, type V2Media, type V2NewsletterCampaign, type V2NewsletterImportRequest, type V2NewsletterImportResult, type V2NewsletterList, type V2NewsletterListCreateParams, type V2NewsletterListUpdateParams, type V2NewsletterSubscription, type V2NewsletterSubscriptionListMembershipUpdate, type V2NewsletterSyncInput, type V2NewsletterSyncResult, type V2NewsletterTrackingResponse, type V2Object, type V2Order, type V2OrderAddress, type V2OrderCreateParams, type V2OrderCreateResult, type V2OrderFulfillmentUpdate, type V2OrderLineItem, type V2OrderLineItemPriceData, type V2OrderListParams, type V2OrderTaxRequest, type V2Organization, type V2PaginationParams, type V2Product, type V2ProductCreateParams, type V2ProductListParams, type V2ProductUpdateParams, type V2Site, type V2SiteUser, type V2SiteUserListParams, type V2SiteUserMeUpdateParams, type V2SiteUserProfile, type V2SiteUserSubscription, type V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2SubscriptionCancelParams, type V2SubscriptionChangePlanParams, type V2SubscriptionPauseParams, type V2Webhook, type V2WebhookCreateParams, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, bucketFor, buildImageUrl, createApiError, createCheckoutSession, createPerspectAb, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };
+export { type AbClient, type AbForRequestResult, type AbVariantResult, type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheAdapter, type CacheConfig, CacheManager, type CancelSubscriptionRequest, type CancelSubscriptionResponse, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, CloudflareKVCacheAdapter, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreatePerspectAbOptions, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, type NewsletterCampaignTestSendRequest, type NewsletterCampaignTestSendResponse, NewsletterClient, type NewsletterConfirmResponse, type NewsletterExportCreateRequest, type NewsletterExportCreateResponse, type NewsletterList, type NewsletterManagementCampaign, type NewsletterManagementCampaignListResponse, NewsletterManagementClient, type NewsletterManagementList, type NewsletterManagementListMembership, type NewsletterManagementPagination, type NewsletterManagementSeries, type NewsletterManagementStatsResponse, type NewsletterManagementSubscription, type NewsletterManagementSubscriptionsListResponse, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterSubscriptionImportRowRequest, type NewsletterSubscriptionMembershipUpdateRequest, type NewsletterSubscriptionSyncRequest, type NewsletterSubscriptionSyncResponse, type NewsletterSubscriptionsBulkAction, type NewsletterSubscriptionsBulkOutcome, type NewsletterSubscriptionsBulkUpdateRequest, type NewsletterSubscriptionsBulkUpdateResponse, type NewsletterSubscriptionsImportRequest, type NewsletterSubscriptionsImportResponse, type NewsletterSubscriptionsImportRowResult, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, type PerspectAb, PerspectApiClient, type PerspectApiConfig, PerspectApiError, PerspectApiV2Client, PerspectV2Error, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type SubscriptionCancellationMode, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, type V2ApiKey, type V2CancelSubscriptionResult, type V2Category, type V2CategoryCreateParams, type V2CategoryUpdateParams, type V2Collection, type V2CollectionCreateParams, type V2CollectionItem, type V2CollectionUpdateParams, type V2ContactSubmission, type V2Content, type V2ContentCreateParams, type V2ContentListParams, type V2ContentUpdateParams, type V2CreditBalance, type V2CreditTransaction, type V2Deleted, type V2Error, type V2ErrorType, type V2GrantCreditParams, type V2GrantCreditResult, type V2List, type V2Media, type V2NewsletterCampaign, type V2NewsletterImportRequest, type V2NewsletterImportResult, type V2NewsletterList, type V2NewsletterListCreateParams, type V2NewsletterListUpdateParams, type V2NewsletterSubscription, type V2NewsletterSubscriptionListMembershipUpdate, type V2NewsletterSyncInput, type V2NewsletterSyncResult, type V2NewsletterTrackingResponse, type V2Object, type V2Order, type V2OrderAddress, type V2OrderCreateParams, type V2OrderCreateResult, type V2OrderFulfillmentUpdate, type V2OrderLineItem, type V2OrderLineItemPriceData, type V2OrderListParams, type V2OrderTaxRequest, type V2Organization, type V2PaginationParams, type V2Product, type V2ProductCreateParams, type V2ProductListParams, type V2ProductUpdateParams, type V2Site, type V2SiteUser, type V2SiteUserListParams, type V2SiteUserMeUpdateParams, type V2SiteUserProfile, type V2SiteUserSubscription, type V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2SubscriptionCancelParams, type V2SubscriptionChangePlanParams, type V2SubscriptionPauseParams, type V2Webhook, type V2WebhookCreateParams, type V2WebhookEventType, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, type WebhookEventType, WebhooksClient, bucketFor, buildImageUrl, createApiError, createCheckoutSession, createPerspectAb, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };

package/dist/index.d.ts

@@ -741,12 +741,13 @@ interface CreatePaymentGatewayRequest {
     configuration: Record<string, any>;
     isActive?: boolean;
 }
+type WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
 interface Webhook {
     id: string;
     name: string;
     url: string;
     provider: string;
-    events: string[];
+    events: WebhookEventType[];
     isActive: boolean;
     secret?: string;
     organizationId?: number;
@@ -757,7 +758,7 @@ interface CreateWebhookRequest {
     name: string;
     url: string;
     provider: string;
-    events: string[];
+    events: WebhookEventType[];
     isActive?: boolean;
     secret?: string;
 }
@@ -1125,6 +1126,11 @@ declare class HttpClient {
      * Update API key
      */
     setApiKey(apiKey: string): void;
+    /**
+     * Whether this client currently has a site-user/admin bearer token attached.
+     * Bearer-scoped GETs must not share cache entries across callers.
+     */
+    hasBearerAuth(): boolean;
     /**
      * Remove authentication
      */
@@ -1701,11 +1707,12 @@ interface V2ApiKey extends V2Object {
     created_at: string | null;
     updated_at: string | null;
 }
+type V2WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
 interface V2Webhook extends V2Object {
     object: "webhook";
     url: string;
     description: string | null;
-    events: string[] | null;
+    events: V2WebhookEventType[] | null;
     is_active: boolean;
     created_at: string | null;
     updated_at: string | null;
@@ -1713,7 +1720,7 @@ interface V2Webhook extends V2Object {
 interface V2WebhookCreateParams {
     url: string;
     description?: string;
-    events?: string[];
+    events?: V2WebhookEventType[];
     is_active?: boolean;
 }
 interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
@@ -1967,13 +1974,14 @@ declare class SiteUsersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2SiteUserListParams): Promise<V2List<V2SiteUser>>;
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
+    getProfileForUser(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
     update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
     /**
      * Load the currently-authenticated site user's canonical record plus their
      * profile KV map. Requires `client.setAuth(jwt)` to have been called with
      * the token returned from `verifyOtp`.
      */
-    getMe(siteName: string): Promise<V2SiteUserWithProfile>;
+    getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile>;
     /** Update the authenticated user's own fields. */
     updateMe(siteName: string, data: V2SiteUserMeUpdateParams): Promise<V2SiteUser>;
     /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
@@ -2143,9 +2151,9 @@ declare class SubscriptionsV2Client extends BaseV2Client {
 
 declare class CreditsV2Client extends BaseV2Client {
     /** Get the current credit balance for the authenticated user. */
-    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get credit balance and transaction history for the authenticated user. */
-    getMyCredits(siteName: string): Promise<V2CreditBalance>;
+    getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
     /** Get the credit balance for a specific user (admin). */
     getUserBalance(siteName: string, userId: string): Promise<V2CreditBalance>;
     /** Grant credit to a specific user (admin). */
@@ -4534,4 +4542,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AbClient, type AbForRequestResult, type AbVariantResult, type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheAdapter, type CacheConfig, CacheManager, type CancelSubscriptionRequest, type CancelSubscriptionResponse, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, CloudflareKVCacheAdapter, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreatePerspectAbOptions, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, type NewsletterCampaignTestSendRequest, type NewsletterCampaignTestSendResponse, NewsletterClient, type NewsletterConfirmResponse, type NewsletterExportCreateRequest, type NewsletterExportCreateResponse, type NewsletterList, type NewsletterManagementCampaign, type NewsletterManagementCampaignListResponse, NewsletterManagementClient, type NewsletterManagementList, type NewsletterManagementListMembership, type NewsletterManagementPagination, type NewsletterManagementSeries, type NewsletterManagementStatsResponse, type NewsletterManagementSubscription, type NewsletterManagementSubscriptionsListResponse, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterSubscriptionImportRowRequest, type NewsletterSubscriptionMembershipUpdateRequest, type NewsletterSubscriptionSyncRequest, type NewsletterSubscriptionSyncResponse, type NewsletterSubscriptionsBulkAction, type NewsletterSubscriptionsBulkOutcome, type NewsletterSubscriptionsBulkUpdateRequest, type NewsletterSubscriptionsBulkUpdateResponse, type NewsletterSubscriptionsImportRequest, type NewsletterSubscriptionsImportResponse, type NewsletterSubscriptionsImportRowResult, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, type PerspectAb, PerspectApiClient, type PerspectApiConfig, PerspectApiError, PerspectApiV2Client, PerspectV2Error, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type SubscriptionCancellationMode, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, type V2ApiKey, type V2CancelSubscriptionResult, type V2Category, type V2CategoryCreateParams, type V2CategoryUpdateParams, type V2Collection, type V2CollectionCreateParams, type V2CollectionItem, type V2CollectionUpdateParams, type V2ContactSubmission, type V2Content, type V2ContentCreateParams, type V2ContentListParams, type V2ContentUpdateParams, type V2CreditBalance, type V2CreditTransaction, type V2Deleted, type V2Error, type V2ErrorType, type V2GrantCreditParams, type V2GrantCreditResult, type V2List, type V2Media, type V2NewsletterCampaign, type V2NewsletterImportRequest, type V2NewsletterImportResult, type V2NewsletterList, type V2NewsletterListCreateParams, type V2NewsletterListUpdateParams, type V2NewsletterSubscription, type V2NewsletterSubscriptionListMembershipUpdate, type V2NewsletterSyncInput, type V2NewsletterSyncResult, type V2NewsletterTrackingResponse, type V2Object, type V2Order, type V2OrderAddress, type V2OrderCreateParams, type V2OrderCreateResult, type V2OrderFulfillmentUpdate, type V2OrderLineItem, type V2OrderLineItemPriceData, type V2OrderListParams, type V2OrderTaxRequest, type V2Organization, type V2PaginationParams, type V2Product, type V2ProductCreateParams, type V2ProductListParams, type V2ProductUpdateParams, type V2Site, type V2SiteUser, type V2SiteUserListParams, type V2SiteUserMeUpdateParams, type V2SiteUserProfile, type V2SiteUserSubscription, type V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2SubscriptionCancelParams, type V2SubscriptionChangePlanParams, type V2SubscriptionPauseParams, type V2Webhook, type V2WebhookCreateParams, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, bucketFor, buildImageUrl, createApiError, createCheckoutSession, createPerspectAb, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };
+export { type AbClient, type AbForRequestResult, type AbVariantResult, type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheAdapter, type CacheConfig, CacheManager, type CancelSubscriptionRequest, type CancelSubscriptionResponse, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, CloudflareKVCacheAdapter, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreatePerspectAbOptions, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, type NewsletterCampaignTestSendRequest, type NewsletterCampaignTestSendResponse, NewsletterClient, type NewsletterConfirmResponse, type NewsletterExportCreateRequest, type NewsletterExportCreateResponse, type NewsletterList, type NewsletterManagementCampaign, type NewsletterManagementCampaignListResponse, NewsletterManagementClient, type NewsletterManagementList, type NewsletterManagementListMembership, type NewsletterManagementPagination, type NewsletterManagementSeries, type NewsletterManagementStatsResponse, type NewsletterManagementSubscription, type NewsletterManagementSubscriptionsListResponse, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterSubscriptionImportRowRequest, type NewsletterSubscriptionMembershipUpdateRequest, type NewsletterSubscriptionSyncRequest, type NewsletterSubscriptionSyncResponse, type NewsletterSubscriptionsBulkAction, type NewsletterSubscriptionsBulkOutcome, type NewsletterSubscriptionsBulkUpdateRequest, type NewsletterSubscriptionsBulkUpdateResponse, type NewsletterSubscriptionsImportRequest, type NewsletterSubscriptionsImportResponse, type NewsletterSubscriptionsImportRowResult, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, type PerspectAb, PerspectApiClient, type PerspectApiConfig, PerspectApiError, PerspectApiV2Client, PerspectV2Error, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type SubscriptionCancellationMode, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, type V2ApiKey, type V2CancelSubscriptionResult, type V2Category, type V2CategoryCreateParams, type V2CategoryUpdateParams, type V2Collection, type V2CollectionCreateParams, type V2CollectionItem, type V2CollectionUpdateParams, type V2ContactSubmission, type V2Content, type V2ContentCreateParams, type V2ContentListParams, type V2ContentUpdateParams, type V2CreditBalance, type V2CreditTransaction, type V2Deleted, type V2Error, type V2ErrorType, type V2GrantCreditParams, type V2GrantCreditResult, type V2List, type V2Media, type V2NewsletterCampaign, type V2NewsletterImportRequest, type V2NewsletterImportResult, type V2NewsletterList, type V2NewsletterListCreateParams, type V2NewsletterListUpdateParams, type V2NewsletterSubscription, type V2NewsletterSubscriptionListMembershipUpdate, type V2NewsletterSyncInput, type V2NewsletterSyncResult, type V2NewsletterTrackingResponse, type V2Object, type V2Order, type V2OrderAddress, type V2OrderCreateParams, type V2OrderCreateResult, type V2OrderFulfillmentUpdate, type V2OrderLineItem, type V2OrderLineItemPriceData, type V2OrderListParams, type V2OrderTaxRequest, type V2Organization, type V2PaginationParams, type V2Product, type V2ProductCreateParams, type V2ProductListParams, type V2ProductUpdateParams, type V2Site, type V2SiteUser, type V2SiteUserListParams, type V2SiteUserMeUpdateParams, type V2SiteUserProfile, type V2SiteUserSubscription, type V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2SubscriptionCancelParams, type V2SubscriptionChangePlanParams, type V2SubscriptionPauseParams, type V2Webhook, type V2WebhookCreateParams, type V2WebhookEventType, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, type WebhookEventType, WebhooksClient, bucketFor, buildImageUrl, createApiError, createCheckoutSession, createPerspectAb, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };

package/dist/index.js

@@ -132,6 +132,13 @@ var HttpClient = class {
   setApiKey(apiKey) {
     this.defaultHeaders["X-API-Key"] = apiKey;
   }
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth() {
+    return Boolean(this.defaultHeaders["Authorization"]);
+  }
   /**
    * Remove authentication
    */
@@ -684,7 +691,8 @@ var BaseV2Client = class {
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
   async fetchWithCache(path, params, policy, fetcher) {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);
@@ -1001,6 +1009,9 @@ var OrdersV2Client = class extends BaseV2Client {
 };
 
 // src/v2/client/site-users-client.ts
+function bypassAuthenticatedCache(policy) {
+  return { ...policy, skipCache: true };
+}
 var SiteUsersV2Client = class extends BaseV2Client {
   // --- OTP Auth (public, API-key-scoped) ---
   async requestOtp(siteName, data) {
@@ -1019,6 +1030,13 @@ var SiteUsersV2Client = class extends BaseV2Client {
   async get(siteName, id) {
     return this.getOne(this.sitePath(siteName, "users", id));
   }
+  async getProfileForUser(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${id}/profile`),
+      void 0,
+      cachePolicy
+    );
+  }
   async update(siteName, id, data) {
     return this.patchOne(this.sitePath(siteName, "users", id), data);
   }
@@ -1028,9 +1046,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName) {
+  async getMe(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me")
+      this.sitePath(siteName, "users", "me"),
+      void 0,
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /** Update the authenticated user's own fields. */
@@ -1045,7 +1065,7 @@ var SiteUsersV2Client = class extends BaseV2Client {
     return this.getOne(
       this.sitePath(siteName, "users", "me/profile"),
       void 0,
-      cachePolicy
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /**
@@ -1267,7 +1287,7 @@ var SubscriptionsV2Client = class extends BaseV2Client {
     return this.getList(
       this.sitePath(siteName, "users", "me/subscriptions"),
       void 0,
-      cachePolicy
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Pause a subscription. */
@@ -1332,15 +1352,19 @@ var SubscriptionsV2Client = class extends BaseV2Client {
 var CreditsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName) {
+  async getMyBalance(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits/balance")
+      this.sitePath(siteName, "users", "me/credits/balance"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName) {
+  async getMyCredits(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits")
+      this.sitePath(siteName, "users", "me/credits"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   // --- Admin endpoints (API key) ---
@@ -1488,7 +1512,8 @@ var BaseClient = class {
    * Fetch a GET endpoint with optional caching support.
    */
   async fetchWithCache(endpoint, params, tags, policy, fetcher) {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
     const cacheKey = this.buildCacheKey(endpoint, params);

package/dist/index.mjs

@@ -56,6 +56,13 @@ var HttpClient = class {
   setApiKey(apiKey) {
     this.defaultHeaders["X-API-Key"] = apiKey;
   }
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth() {
+    return Boolean(this.defaultHeaders["Authorization"]);
+  }
   /**
    * Remove authentication
    */
@@ -608,7 +615,8 @@ var BaseV2Client = class {
   }
   /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
   async fetchWithCache(path, params, policy, fetcher) {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);
@@ -925,6 +933,9 @@ var OrdersV2Client = class extends BaseV2Client {
 };
 
 // src/v2/client/site-users-client.ts
+function bypassAuthenticatedCache(policy) {
+  return { ...policy, skipCache: true };
+}
 var SiteUsersV2Client = class extends BaseV2Client {
   // --- OTP Auth (public, API-key-scoped) ---
   async requestOtp(siteName, data) {
@@ -943,6 +954,13 @@ var SiteUsersV2Client = class extends BaseV2Client {
   async get(siteName, id) {
     return this.getOne(this.sitePath(siteName, "users", id));
   }
+  async getProfileForUser(siteName, id, cachePolicy) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${id}/profile`),
+      void 0,
+      cachePolicy
+    );
+  }
   async update(siteName, id, data) {
     return this.patchOne(this.sitePath(siteName, "users", id), data);
   }
@@ -952,9 +970,11 @@ var SiteUsersV2Client = class extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName) {
+  async getMe(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me")
+      this.sitePath(siteName, "users", "me"),
+      void 0,
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /** Update the authenticated user's own fields. */
@@ -969,7 +989,7 @@ var SiteUsersV2Client = class extends BaseV2Client {
     return this.getOne(
       this.sitePath(siteName, "users", "me/profile"),
       void 0,
-      cachePolicy
+      bypassAuthenticatedCache(cachePolicy)
     );
   }
   /**
@@ -1191,7 +1211,7 @@ var SubscriptionsV2Client = class extends BaseV2Client {
     return this.getList(
       this.sitePath(siteName, "users", "me/subscriptions"),
       void 0,
-      cachePolicy
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Pause a subscription. */
@@ -1256,15 +1276,19 @@ var SubscriptionsV2Client = class extends BaseV2Client {
 var CreditsV2Client = class extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName) {
+  async getMyBalance(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits/balance")
+      this.sitePath(siteName, "users", "me/credits/balance"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName) {
+  async getMyCredits(siteName, cachePolicy) {
     return this.getOne(
-      this.sitePath(siteName, "users", "me/credits")
+      this.sitePath(siteName, "users", "me/credits"),
+      void 0,
+      { ...cachePolicy, skipCache: true }
     );
   }
   // --- Admin endpoints (API key) ---
@@ -1412,7 +1436,8 @@ var BaseClient = class {
    * Fetch a GET endpoint with optional caching support.
    */
   async fetchWithCache(endpoint, params, tags, policy, fetcher) {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === "function" && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
     const cacheKey = this.buildCacheKey(endpoint, params);

package/package.json

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

package/src/client/base-client.ts

@@ -115,7 +115,8 @@ export abstract class BaseClient {
     policy: CachePolicy | undefined,
     fetcher: () => Promise<T>
   ): Promise<T> {
-    if (!this.cache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === 'function' && this.http.hasBearerAuth();
+    if (!this.cache || hasBearerAuth) {
       return fetcher();
     }
 

package/src/types/index.ts

@@ -732,12 +732,41 @@ export interface CreatePaymentGatewayRequest {
 }
 
 // Webhooks
+export type WebhookEventType =
+  | "content.created"
+  | "content.updated"
+  | "content.published"
+  | "content.unpublished"
+  | "content.deleted"
+  | "newsletter.created"
+  | "newsletter.updated"
+  | "newsletter.published"
+  | "newsletter.sent"
+  | "newsletter.deleted"
+  | "product.created"
+  | "product.updated"
+  | "product.deleted"
+  | "product.stock_changed"
+  | "order.paid"
+  | "category.created"
+  | "category.updated"
+  | "category.deleted"
+  | "site.updated"
+  | "site.settings_changed"
+  | "ab.flag_started"
+  | "ab.flag_paused"
+  | "ab.flag_resumed"
+  | "ab.flag_stopped"
+  | "ab.flag_updated"
+  | "ab.config_warmup"
+  | (string & Record<never, never>);
+
 export interface Webhook {
   id: string;
   name: string;
   url: string;
   provider: string;
-  events: string[];
+  events: WebhookEventType[];
   isActive: boolean;
   secret?: string;
   organizationId?: number;
@@ -749,7 +778,7 @@ export interface CreateWebhookRequest {
   name: string;
   url: string;
   provider: string;
-  events: string[];
+  events: WebhookEventType[];
   isActive?: boolean;
   secret?: string;
 }

package/src/utils/http-client.ts

@@ -51,6 +51,14 @@ export class HttpClient {
     this.defaultHeaders['X-API-Key'] = apiKey;
   }
 
+  /**
+   * Whether this client currently has a site-user/admin bearer token attached.
+   * Bearer-scoped GETs must not share cache entries across callers.
+   */
+  hasBearerAuth(): boolean {
+    return Boolean(this.defaultHeaders['Authorization']);
+  }
+
   /**
    * Remove authentication
    */

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

@@ -148,7 +148,8 @@ export abstract class BaseV2Client {
     policy: CachePolicy | undefined,
     fetcher: () => Promise<T>,
   ): Promise<T> {
-    if (!this.cache || policy?.skipCache) {
+    const hasBearerAuth = typeof this.http.hasBearerAuth === 'function' && this.http.hasBearerAuth();
+    if (!this.cache || policy?.skipCache || hasBearerAuth) {
       return fetcher();
     }
     const key = this.buildCacheKey(path, params);

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

@@ -7,6 +7,7 @@
  */
 
 import { BaseV2Client } from './base-v2-client';
+import type { CachePolicy } from '../../cache/types';
 import type {
   V2CreditBalance,
   V2GrantCreditParams,
@@ -18,16 +19,20 @@ export class CreditsV2Client extends BaseV2Client {
   // --- Authenticated "me" endpoints (site-user JWT) ---
 
   /** Get the current credit balance for the authenticated user. */
-  async getMyBalance(siteName: string): Promise<V2CreditBalance> {
+  async getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance> {
     return this.getOne<V2CreditBalance>(
       this.sitePath(siteName, 'users', 'me/credits/balance'),
+      undefined,
+      { ...cachePolicy, skipCache: true },
     );
   }
 
   /** Get credit balance and transaction history for the authenticated user. */
-  async getMyCredits(siteName: string): Promise<V2CreditBalance> {
+  async getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance> {
     return this.getOne<V2CreditBalance>(
       this.sitePath(siteName, 'users', 'me/credits'),
+      undefined,
+      { ...cachePolicy, skipCache: true },
     );
   }
 

package/src/v2/client/site-users-client.ts

@@ -31,6 +31,10 @@ export interface V2OtpVerifyResponse extends V2SiteUser {
   token: string;
 }
 
+function bypassAuthenticatedCache(policy?: CachePolicy): CachePolicy {
+  return { ...policy, skipCache: true };
+}
+
 export class SiteUsersV2Client extends BaseV2Client {
 
   // --- OTP Auth (public, API-key-scoped) ---
@@ -63,6 +67,18 @@ export class SiteUsersV2Client extends BaseV2Client {
     return this.getOne<V2SiteUser>(this.sitePath(siteName, 'users', id));
   }
 
+  async getProfileForUser(
+    siteName: string,
+    id: string,
+    cachePolicy?: CachePolicy,
+  ): Promise<V2SiteUserProfile> {
+    return this.getOne<V2SiteUserProfile>(
+      this.sitePath(siteName, 'users', `${id}/profile`),
+      undefined,
+      cachePolicy,
+    );
+  }
+
   async update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser> {
     return this.patchOne<V2SiteUser>(this.sitePath(siteName, 'users', id), data);
   }
@@ -74,9 +90,11 @@ export class SiteUsersV2Client extends BaseV2Client {
    * profile KV map. Requires `client.setAuth(jwt)` to have been called with
    * the token returned from `verifyOtp`.
    */
-  async getMe(siteName: string): Promise<V2SiteUserWithProfile> {
+  async getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile> {
     return this.getOne<V2SiteUserWithProfile>(
       this.sitePath(siteName, 'users', 'me'),
+      undefined,
+      bypassAuthenticatedCache(cachePolicy),
     );
   }
 
@@ -96,7 +114,7 @@ export class SiteUsersV2Client extends BaseV2Client {
     return this.getOne<V2SiteUserProfile>(
       this.sitePath(siteName, 'users', 'me/profile'),
       undefined,
-      cachePolicy,
+      bypassAuthenticatedCache(cachePolicy),
     );
   }
 

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

@@ -29,7 +29,7 @@ export class SubscriptionsV2Client extends BaseV2Client {
     return this.getList<V2SiteUserSubscription>(
       this.sitePath(siteName, 'users', 'me/subscriptions'),
       undefined,
-      cachePolicy,
+      { ...cachePolicy, skipCache: true },
     );
   }
 

package/src/v2/types.ts

@@ -603,11 +603,40 @@ export interface V2ApiKey extends V2Object {
 
 // --- Webhooks ---
 
+export type V2WebhookEventType =
+  | "content.created"
+  | "content.updated"
+  | "content.published"
+  | "content.unpublished"
+  | "content.deleted"
+  | "newsletter.created"
+  | "newsletter.updated"
+  | "newsletter.published"
+  | "newsletter.sent"
+  | "newsletter.deleted"
+  | "product.created"
+  | "product.updated"
+  | "product.deleted"
+  | "product.stock_changed"
+  | "order.paid"
+  | "category.created"
+  | "category.updated"
+  | "category.deleted"
+  | "site.updated"
+  | "site.settings_changed"
+  | "ab.flag_started"
+  | "ab.flag_paused"
+  | "ab.flag_resumed"
+  | "ab.flag_stopped"
+  | "ab.flag_updated"
+  | "ab.config_warmup"
+  | (string & Record<never, never>);
+
 export interface V2Webhook extends V2Object {
   object: "webhook";
   url: string;
   description: string | null;
-  events: string[] | null;
+  events: V2WebhookEventType[] | null;
   is_active: boolean;
   created_at: string | null;
   updated_at: string | null;
@@ -616,7 +645,7 @@ export interface V2Webhook extends V2Object {
 export interface V2WebhookCreateParams {
   url: string;
   description?: string;
-  events?: string[];
+  events?: V2WebhookEventType[];
   is_active?: boolean;
 }