perspectapi-ts-sdk 6.0.0 → 6.0.1

package/dist/index.d.mts

@@ -3341,6 +3341,11 @@ interface V2OrderCreateParams {
     referral_code?: string;
     referrer_site_user_id?: string;
 }
+interface V2OrderFulfillmentUpdate {
+    fulfillment_status: string;
+    tracking_number?: string;
+    notes?: string;
+}
 interface V2OrderCreateResult extends V2Object {
     object: "checkout_session";
     checkout_url: string | null;
@@ -3594,6 +3599,71 @@ interface V2WebhookCreateParams {
 }
 interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
 }
+interface V2SiteUserSubscription extends V2Object {
+    object: "site_user_subscription";
+    site_user_id: string;
+    provider: string | null;
+    provider_subscription_id: string | null;
+    plan_name: string | null;
+    plan_id: string | null;
+    status: string;
+    amount: number | null;
+    currency: string | null;
+    billing_interval: string | null;
+    billing_interval_count: number | null;
+    current_period_start: string | null;
+    current_period_end: string | null;
+    trial_start: string | null;
+    trial_end: string | null;
+    canceled_at: string | null;
+    cancel_at_period_end: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2SubscriptionPauseParams {
+    resumes_at?: number;
+}
+interface V2SubscriptionCancelParams {
+    mode?: "immediate" | "period_end" | "scheduled";
+    cancel_at?: string;
+}
+interface V2SubscriptionChangePlanParams {
+    product_id: string;
+}
+interface V2CancelSubscriptionResult {
+    object: "subscription_cancel_result";
+    mode: string;
+    status: string;
+    cancel_at_period_end: boolean;
+    effective_at: string | null;
+    scheduled_cancel_at: string | null;
+    message: string;
+}
+interface V2CreditTransaction extends V2Object {
+    object: "credit_transaction";
+    site_user_id: string;
+    amount_cents: number;
+    balance_after_cents: number;
+    type: string;
+    description: string | null;
+    reference_id: string | null;
+    reference_type: string | null;
+    created_at: string | null;
+}
+interface V2CreditBalance {
+    object: "credit_balance";
+    balance_cents: number;
+    transactions?: V2CreditTransaction[];
+}
+interface V2GrantCreditParams {
+    amount_cents: number;
+    description: string;
+}
+interface V2GrantCreditResult {
+    object: "grant_credit_result";
+    new_balance_cents: number;
+}
 
 /**
  * v2 Base Client — cursor pagination, expand support, caching, typed errors.
@@ -3742,6 +3812,8 @@ declare class OrdersV2Client extends BaseV2Client {
      * dance — v2 is API-key-only and requires no CSRF token.
      */
     create(siteName: string, data: V2OrderCreateParams): Promise<V2OrderCreateResult>;
+    /** Update fulfillment status, tracking number, and/or notes on an order. */
+    updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
 }
 
 /**
@@ -3912,6 +3984,54 @@ declare class WebhooksV2Client extends BaseV2Client {
     del(siteName: string, id: string): Promise<V2Deleted>;
 }
 
+/**
+ * v2 Subscriptions Client — lifecycle operations for site user subscriptions.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+declare class SubscriptionsV2Client extends BaseV2Client {
+    /** List all subscriptions for the authenticated user. */
+    listMySubscriptions(siteName: string): Promise<V2List<V2SiteUserSubscription>>;
+    /** Pause a subscription. */
+    pauseSubscription(siteName: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
+    /** Resume a paused subscription. */
+    resumeSubscription(siteName: string, subId: string): Promise<V2SiteUserSubscription>;
+    /** Cancel a subscription. */
+    cancelSubscription(siteName: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
+    /** Change the plan (price) of a subscription. */
+    changeSubscriptionPlan(siteName: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
+    /** List subscriptions for a specific user (admin). */
+    listUserSubscriptions(siteName: string, userId: string): Promise<V2List<V2SiteUserSubscription>>;
+    /** Pause a user's subscription (admin). */
+    pauseUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
+    /** Resume a user's paused subscription (admin). */
+    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>;
+}
+
+/**
+ * v2 Credits Client — balance queries and admin grant operations.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+declare class CreditsV2Client extends BaseV2Client {
+    /** Get the current credit balance for the authenticated user. */
+    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    /** Get credit balance and transaction history for the authenticated user. */
+    getMyCredits(siteName: string): 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). */
+    grantCredit(siteName: string, userId: string, data: V2GrantCreditParams): Promise<V2GrantCreditResult>;
+}
+
 /**
  * PerspectAPI v2 SDK Client
  *
@@ -3942,6 +4062,8 @@ declare class PerspectApiV2Client {
     readonly sites: SitesV2Client;
     readonly apiKeys: ApiKeysV2Client;
     readonly webhooks: WebhooksV2Client;
+    readonly subscriptions: SubscriptionsV2Client;
+    readonly credits: CreditsV2Client;
     constructor(config: PerspectApiV2Config);
     /** Update the JWT token for authenticated requests. */
     setAuth(jwt: string): void;
@@ -4308,4 +4430,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, 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 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 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, PerspectApiClient, type PerspectApiConfig, 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, type V2ApiKey, 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 V2Deleted, type V2Error, type V2ErrorType, 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 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 V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2Webhook, type V2WebhookCreateParams, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, 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 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 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, PerspectApiClient, type PerspectApiConfig, 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, 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, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.d.ts

@@ -3341,6 +3341,11 @@ interface V2OrderCreateParams {
     referral_code?: string;
     referrer_site_user_id?: string;
 }
+interface V2OrderFulfillmentUpdate {
+    fulfillment_status: string;
+    tracking_number?: string;
+    notes?: string;
+}
 interface V2OrderCreateResult extends V2Object {
     object: "checkout_session";
     checkout_url: string | null;
@@ -3594,6 +3599,71 @@ interface V2WebhookCreateParams {
 }
 interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
 }
+interface V2SiteUserSubscription extends V2Object {
+    object: "site_user_subscription";
+    site_user_id: string;
+    provider: string | null;
+    provider_subscription_id: string | null;
+    plan_name: string | null;
+    plan_id: string | null;
+    status: string;
+    amount: number | null;
+    currency: string | null;
+    billing_interval: string | null;
+    billing_interval_count: number | null;
+    current_period_start: string | null;
+    current_period_end: string | null;
+    trial_start: string | null;
+    trial_end: string | null;
+    canceled_at: string | null;
+    cancel_at_period_end: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2SubscriptionPauseParams {
+    resumes_at?: number;
+}
+interface V2SubscriptionCancelParams {
+    mode?: "immediate" | "period_end" | "scheduled";
+    cancel_at?: string;
+}
+interface V2SubscriptionChangePlanParams {
+    product_id: string;
+}
+interface V2CancelSubscriptionResult {
+    object: "subscription_cancel_result";
+    mode: string;
+    status: string;
+    cancel_at_period_end: boolean;
+    effective_at: string | null;
+    scheduled_cancel_at: string | null;
+    message: string;
+}
+interface V2CreditTransaction extends V2Object {
+    object: "credit_transaction";
+    site_user_id: string;
+    amount_cents: number;
+    balance_after_cents: number;
+    type: string;
+    description: string | null;
+    reference_id: string | null;
+    reference_type: string | null;
+    created_at: string | null;
+}
+interface V2CreditBalance {
+    object: "credit_balance";
+    balance_cents: number;
+    transactions?: V2CreditTransaction[];
+}
+interface V2GrantCreditParams {
+    amount_cents: number;
+    description: string;
+}
+interface V2GrantCreditResult {
+    object: "grant_credit_result";
+    new_balance_cents: number;
+}
 
 /**
  * v2 Base Client — cursor pagination, expand support, caching, typed errors.
@@ -3742,6 +3812,8 @@ declare class OrdersV2Client extends BaseV2Client {
      * dance — v2 is API-key-only and requires no CSRF token.
      */
     create(siteName: string, data: V2OrderCreateParams): Promise<V2OrderCreateResult>;
+    /** Update fulfillment status, tracking number, and/or notes on an order. */
+    updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
 }
 
 /**
@@ -3912,6 +3984,54 @@ declare class WebhooksV2Client extends BaseV2Client {
     del(siteName: string, id: string): Promise<V2Deleted>;
 }
 
+/**
+ * v2 Subscriptions Client — lifecycle operations for site user subscriptions.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+declare class SubscriptionsV2Client extends BaseV2Client {
+    /** List all subscriptions for the authenticated user. */
+    listMySubscriptions(siteName: string): Promise<V2List<V2SiteUserSubscription>>;
+    /** Pause a subscription. */
+    pauseSubscription(siteName: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
+    /** Resume a paused subscription. */
+    resumeSubscription(siteName: string, subId: string): Promise<V2SiteUserSubscription>;
+    /** Cancel a subscription. */
+    cancelSubscription(siteName: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
+    /** Change the plan (price) of a subscription. */
+    changeSubscriptionPlan(siteName: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
+    /** List subscriptions for a specific user (admin). */
+    listUserSubscriptions(siteName: string, userId: string): Promise<V2List<V2SiteUserSubscription>>;
+    /** Pause a user's subscription (admin). */
+    pauseUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
+    /** Resume a user's paused subscription (admin). */
+    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>;
+}
+
+/**
+ * v2 Credits Client — balance queries and admin grant operations.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+declare class CreditsV2Client extends BaseV2Client {
+    /** Get the current credit balance for the authenticated user. */
+    getMyBalance(siteName: string): Promise<V2CreditBalance>;
+    /** Get credit balance and transaction history for the authenticated user. */
+    getMyCredits(siteName: string): 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). */
+    grantCredit(siteName: string, userId: string, data: V2GrantCreditParams): Promise<V2GrantCreditResult>;
+}
+
 /**
  * PerspectAPI v2 SDK Client
  *
@@ -3942,6 +4062,8 @@ declare class PerspectApiV2Client {
     readonly sites: SitesV2Client;
     readonly apiKeys: ApiKeysV2Client;
     readonly webhooks: WebhooksV2Client;
+    readonly subscriptions: SubscriptionsV2Client;
+    readonly credits: CreditsV2Client;
     constructor(config: PerspectApiV2Config);
     /** Update the JWT token for authenticated requests. */
     setAuth(jwt: string): void;
@@ -4308,4 +4430,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, 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 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 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, PerspectApiClient, type PerspectApiConfig, 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, type V2ApiKey, 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 V2Deleted, type V2Error, type V2ErrorType, 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 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 V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2Webhook, type V2WebhookCreateParams, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, 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 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 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, PerspectApiClient, type PerspectApiConfig, 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, 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, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.js

@@ -3712,6 +3712,13 @@ var OrdersV2Client = class extends BaseV2Client {
       data
     );
   }
+  /** Update fulfillment status, tracking number, and/or notes on an order. */
+  async updateFulfillment(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "orders", `${id}/fulfillment`),
+      data
+    );
+  }
 };
 
 // src/v2/client/site-users-client.ts
@@ -3971,6 +3978,102 @@ var WebhooksV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/subscriptions-client.ts
+var SubscriptionsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** List all subscriptions for the authenticated user. */
+  async listMySubscriptions(siteName) {
+    return this.getList(
+      this.sitePath(siteName, "users", "me/subscriptions")
+    );
+  }
+  /** Pause a subscription. */
+  async pauseSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a paused subscription. */
+  async resumeSubscription(siteName, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a subscription. */
+  async cancelSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+  /** Change the plan (price) of a subscription. */
+  async changeSubscriptionPlan(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** List subscriptions for a specific user (admin). */
+  async listUserSubscriptions(siteName, userId) {
+    return this.getList(
+      this.sitePath(siteName, "users", `${userId}/subscriptions`)
+    );
+  }
+  /** Pause a user's subscription (admin). */
+  async pauseUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a user's paused subscription (admin). */
+  async resumeUserSubscription(siteName, userId, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a user's subscription (admin). */
+  async cancelUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+};
+
+// src/v2/client/credits-client.ts
+var CreditsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** Get the current credit balance for the authenticated user. */
+  async getMyBalance(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits/balance")
+    );
+  }
+  /** Get credit balance and transaction history for the authenticated user. */
+  async getMyCredits(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits")
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** Get the credit balance for a specific user (admin). */
+  async getUserBalance(siteName, userId) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${userId}/credits/balance`)
+    );
+  }
+  /** Grant credit to a specific user (admin). */
+  async grantCredit(siteName, userId, data) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/credits/grant`),
+      data
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -3987,6 +4090,8 @@ var PerspectApiV2Client = class {
   sites;
   apiKeys;
   webhooks;
+  subscriptions;
+  credits;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -4006,6 +4111,8 @@ var PerspectApiV2Client = class {
     this.sites = new SitesV2Client(this.http, basePath, cache);
     this.apiKeys = new ApiKeysV2Client(this.http, basePath, cache);
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
+    this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
+    this.credits = new CreditsV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {

package/dist/index.mjs

@@ -3644,6 +3644,13 @@ var OrdersV2Client = class extends BaseV2Client {
       data
     );
   }
+  /** Update fulfillment status, tracking number, and/or notes on an order. */
+  async updateFulfillment(siteName, id, data) {
+    return this.patchOne(
+      this.sitePath(siteName, "orders", `${id}/fulfillment`),
+      data
+    );
+  }
 };
 
 // src/v2/client/site-users-client.ts
@@ -3903,6 +3910,102 @@ var WebhooksV2Client = class extends BaseV2Client {
   }
 };
 
+// src/v2/client/subscriptions-client.ts
+var SubscriptionsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** List all subscriptions for the authenticated user. */
+  async listMySubscriptions(siteName) {
+    return this.getList(
+      this.sitePath(siteName, "users", "me/subscriptions")
+    );
+  }
+  /** Pause a subscription. */
+  async pauseSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a paused subscription. */
+  async resumeSubscription(siteName, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a subscription. */
+  async cancelSubscription(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+  /** Change the plan (price) of a subscription. */
+  async changeSubscriptionPlan(siteName, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `me/subscriptions/${subId}/change-plan`),
+      params
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** List subscriptions for a specific user (admin). */
+  async listUserSubscriptions(siteName, userId) {
+    return this.getList(
+      this.sitePath(siteName, "users", `${userId}/subscriptions`)
+    );
+  }
+  /** Pause a user's subscription (admin). */
+  async pauseUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/pause`),
+      params ?? {}
+    );
+  }
+  /** Resume a user's paused subscription (admin). */
+  async resumeUserSubscription(siteName, userId, subId) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/resume`)
+    );
+  }
+  /** Cancel a user's subscription (admin). */
+  async cancelUserSubscription(siteName, userId, subId, params) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/subscriptions/${subId}/cancel`),
+      params ?? {}
+    );
+  }
+};
+
+// src/v2/client/credits-client.ts
+var CreditsV2Client = class extends BaseV2Client {
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+  /** Get the current credit balance for the authenticated user. */
+  async getMyBalance(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits/balance")
+    );
+  }
+  /** Get credit balance and transaction history for the authenticated user. */
+  async getMyCredits(siteName) {
+    return this.getOne(
+      this.sitePath(siteName, "users", "me/credits")
+    );
+  }
+  // --- Admin endpoints (API key) ---
+  /** Get the credit balance for a specific user (admin). */
+  async getUserBalance(siteName, userId) {
+    return this.getOne(
+      this.sitePath(siteName, "users", `${userId}/credits/balance`)
+    );
+  }
+  /** Grant credit to a specific user (admin). */
+  async grantCredit(siteName, userId, data) {
+    return this.post(
+      this.sitePath(siteName, "users", `${userId}/credits/grant`),
+      data
+    );
+  }
+};
+
 // src/v2/index.ts
 var PerspectApiV2Client = class {
   http;
@@ -3919,6 +4022,8 @@ var PerspectApiV2Client = class {
   sites;
   apiKeys;
   webhooks;
+  subscriptions;
+  credits;
   constructor(config) {
     const baseUrl = config.baseUrl.replace(/\/+$/, "");
     const v2BaseUrl = baseUrl.endsWith("/api/v2") ? baseUrl : `${baseUrl}/api/v2`;
@@ -3938,6 +4043,8 @@ var PerspectApiV2Client = class {
     this.sites = new SitesV2Client(this.http, basePath, cache);
     this.apiKeys = new ApiKeysV2Client(this.http, basePath, cache);
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
+    this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
+    this.credits = new CreditsV2Client(this.http, basePath, cache);
   }
   /** Update the JWT token for authenticated requests. */
   setAuth(jwt) {

package/package.json

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

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

@@ -0,0 +1,57 @@
+/**
+ * v2 Credits Client — balance queries and admin grant operations.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+import { BaseV2Client } from './base-v2-client';
+import type {
+  V2CreditBalance,
+  V2GrantCreditParams,
+  V2GrantCreditResult,
+} from '../types';
+
+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> {
+    return this.getOne<V2CreditBalance>(
+      this.sitePath(siteName, 'users', 'me/credits/balance'),
+    );
+  }
+
+  /** Get credit balance and transaction history for the authenticated user. */
+  async getMyCredits(siteName: string): Promise<V2CreditBalance> {
+    return this.getOne<V2CreditBalance>(
+      this.sitePath(siteName, 'users', 'me/credits'),
+    );
+  }
+
+  // --- Admin endpoints (API key) ---
+
+  /** Get the credit balance for a specific user (admin). */
+  async getUserBalance(
+    siteName: string,
+    userId: string,
+  ): Promise<V2CreditBalance> {
+    return this.getOne<V2CreditBalance>(
+      this.sitePath(siteName, 'users', `${userId}/credits/balance`),
+    );
+  }
+
+  /** Grant credit to a specific user (admin). */
+  async grantCredit(
+    siteName: string,
+    userId: string,
+    data: V2GrantCreditParams,
+  ): Promise<V2GrantCreditResult> {
+    return this.post<V2GrantCreditResult>(
+      this.sitePath(siteName, 'users', `${userId}/credits/grant`),
+      data,
+    );
+  }
+}

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

@@ -12,6 +12,7 @@ import type {
   V2OrderListParams,
   V2OrderCreateParams,
   V2OrderCreateResult,
+  V2OrderFulfillmentUpdate,
   V2List,
 } from '../types';
 
@@ -45,4 +46,16 @@ export class OrdersV2Client extends BaseV2Client {
       data,
     );
   }
+
+  /** Update fulfillment status, tracking number, and/or notes on an order. */
+  async updateFulfillment(
+    siteName: string,
+    id: string,
+    data: V2OrderFulfillmentUpdate,
+  ): Promise<V2Order> {
+    return this.patchOne<V2Order>(
+      this.sitePath(siteName, 'orders', `${id}/fulfillment`),
+      data,
+    );
+  }
 }

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

@@ -0,0 +1,126 @@
+/**
+ * v2 Subscriptions Client — lifecycle operations for site user subscriptions.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+import { BaseV2Client } from './base-v2-client';
+import type {
+  V2SiteUserSubscription,
+  V2SubscriptionPauseParams,
+  V2SubscriptionCancelParams,
+  V2SubscriptionChangePlanParams,
+  V2CancelSubscriptionResult,
+  V2List,
+} from '../types';
+
+export class SubscriptionsV2Client extends BaseV2Client {
+
+  // --- Authenticated "me" endpoints (site-user JWT) ---
+
+  /** List all subscriptions for the authenticated user. */
+  async listMySubscriptions(
+    siteName: string,
+  ): Promise<V2List<V2SiteUserSubscription>> {
+    return this.getList<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', 'me/subscriptions'),
+    );
+  }
+
+  /** Pause a subscription. */
+  async pauseSubscription(
+    siteName: string,
+    subId: string,
+    params?: V2SubscriptionPauseParams,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `me/subscriptions/${subId}/pause`),
+      params ?? {},
+    );
+  }
+
+  /** Resume a paused subscription. */
+  async resumeSubscription(
+    siteName: string,
+    subId: string,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `me/subscriptions/${subId}/resume`),
+    );
+  }
+
+  /** Cancel a subscription. */
+  async cancelSubscription(
+    siteName: string,
+    subId: string,
+    params?: V2SubscriptionCancelParams,
+  ): Promise<V2CancelSubscriptionResult> {
+    return this.post<V2CancelSubscriptionResult>(
+      this.sitePath(siteName, 'users', `me/subscriptions/${subId}/cancel`),
+      params ?? {},
+    );
+  }
+
+  /** Change the plan (price) of a subscription. */
+  async changeSubscriptionPlan(
+    siteName: string,
+    subId: string,
+    params: V2SubscriptionChangePlanParams,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `me/subscriptions/${subId}/change-plan`),
+      params,
+    );
+  }
+
+  // --- Admin endpoints (API key) ---
+
+  /** List subscriptions for a specific user (admin). */
+  async listUserSubscriptions(
+    siteName: string,
+    userId: string,
+  ): Promise<V2List<V2SiteUserSubscription>> {
+    return this.getList<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `${userId}/subscriptions`),
+    );
+  }
+
+  /** Pause a user's subscription (admin). */
+  async pauseUserSubscription(
+    siteName: string,
+    userId: string,
+    subId: string,
+    params?: V2SubscriptionPauseParams,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `${userId}/subscriptions/${subId}/pause`),
+      params ?? {},
+    );
+  }
+
+  /** Resume a user's paused subscription (admin). */
+  async resumeUserSubscription(
+    siteName: string,
+    userId: string,
+    subId: string,
+  ): Promise<V2SiteUserSubscription> {
+    return this.post<V2SiteUserSubscription>(
+      this.sitePath(siteName, 'users', `${userId}/subscriptions/${subId}/resume`),
+    );
+  }
+
+  /** Cancel a user's subscription (admin). */
+  async cancelUserSubscription(
+    siteName: string,
+    userId: string,
+    subId: string,
+    params?: V2SubscriptionCancelParams,
+  ): Promise<V2CancelSubscriptionResult> {
+    return this.post<V2CancelSubscriptionResult>(
+      this.sitePath(siteName, 'users', `${userId}/subscriptions/${subId}/cancel`),
+      params ?? {},
+    );
+  }
+}

package/src/v2/index.ts

@@ -27,6 +27,8 @@ import { OrganizationsV2Client } from './client/organizations-client';
 import { SitesV2Client } from './client/sites-client';
 import { ApiKeysV2Client } from './client/api-keys-client';
 import { WebhooksV2Client } from './client/webhooks-client';
+import { SubscriptionsV2Client } from './client/subscriptions-client';
+import { CreditsV2Client } from './client/credits-client';
 
 export interface PerspectApiV2Config extends PerspectApiConfig {
   cache?: CacheConfig;
@@ -48,6 +50,8 @@ export class PerspectApiV2Client {
   readonly sites: SitesV2Client;
   readonly apiKeys: ApiKeysV2Client;
   readonly webhooks: WebhooksV2Client;
+  readonly subscriptions: SubscriptionsV2Client;
+  readonly credits: CreditsV2Client;
 
   constructor(config: PerspectApiV2Config) {
     // Ensure base URL points to /api/v2
@@ -73,6 +77,8 @@ export class PerspectApiV2Client {
     this.sites = new SitesV2Client(this.http, basePath, cache);
     this.apiKeys = new ApiKeysV2Client(this.http, basePath, cache);
     this.webhooks = new WebhooksV2Client(this.http, basePath, cache);
+    this.subscriptions = new SubscriptionsV2Client(this.http, basePath, cache);
+    this.credits = new CreditsV2Client(this.http, basePath, cache);
   }
 
   /** Update the JWT token for authenticated requests. */
@@ -112,3 +118,5 @@ export { OrganizationsV2Client } from './client/organizations-client';
 export { SitesV2Client } from './client/sites-client';
 export { ApiKeysV2Client } from './client/api-keys-client';
 export { WebhooksV2Client } from './client/webhooks-client';
+export { SubscriptionsV2Client } from './client/subscriptions-client';
+export { CreditsV2Client } from './client/credits-client';

package/src/v2/types.ts

@@ -314,6 +314,12 @@ export interface V2OrderCreateParams {
   referrer_site_user_id?: string;
 }
 
+export interface V2OrderFulfillmentUpdate {
+  fulfillment_status: string;
+  tracking_number?: string;
+  notes?: string;
+}
+
 export interface V2OrderCreateResult extends V2Object {
   object: "checkout_session";
   checkout_url: string | null;
@@ -606,3 +612,81 @@ export interface V2WebhookCreateParams {
 }
 
 export interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {}
+
+// --- Site User Subscriptions ---
+
+export interface V2SiteUserSubscription extends V2Object {
+  object: "site_user_subscription";
+  site_user_id: string;
+  provider: string | null;
+  provider_subscription_id: string | null;
+  plan_name: string | null;
+  plan_id: string | null;
+  status: string;
+  amount: number | null;
+  currency: string | null;
+  billing_interval: string | null;
+  billing_interval_count: number | null;
+  current_period_start: string | null;
+  current_period_end: string | null;
+  trial_start: string | null;
+  trial_end: string | null;
+  canceled_at: string | null;
+  cancel_at_period_end: boolean;
+  metadata: Record<string, unknown> | null;
+  created_at: string | null;
+  updated_at: string | null;
+}
+
+export interface V2SubscriptionPauseParams {
+  resumes_at?: number;
+}
+
+export interface V2SubscriptionCancelParams {
+  mode?: "immediate" | "period_end" | "scheduled";
+  cancel_at?: string;
+}
+
+export interface V2SubscriptionChangePlanParams {
+  product_id: string;
+}
+
+export interface V2CancelSubscriptionResult {
+  object: "subscription_cancel_result";
+  mode: string;
+  status: string;
+  cancel_at_period_end: boolean;
+  effective_at: string | null;
+  scheduled_cancel_at: string | null;
+  message: string;
+}
+
+// --- Credits ---
+
+export interface V2CreditTransaction extends V2Object {
+  object: "credit_transaction";
+  site_user_id: string;
+  amount_cents: number;
+  balance_after_cents: number;
+  type: string;
+  description: string | null;
+  reference_id: string | null;
+  reference_type: string | null;
+  created_at: string | null;
+}
+
+export interface V2CreditBalance {
+  object: "credit_balance";
+  balance_cents: number;
+  transactions?: V2CreditTransaction[];
+}
+
+export interface V2GrantCreditParams {
+  amount_cents: number;
+  description: string;
+}
+
+export interface V2GrantCreditResult {
+  object: "grant_credit_result";
+  new_balance_cents: number;
+}