perspectapi-ts-sdk 5.4.4 → 6.0.0

package/dist/index.d.mts

@@ -3112,6 +3112,8 @@ interface V2Media extends V2Object {
     width: number | null;
     height: number | null;
     filesize: number | null;
+    caption: string | null;
+    alt_text: string | null;
 }
 interface V2Content extends V2Object {
     object: "content";
@@ -3282,6 +3284,82 @@ interface V2OrderListParams extends V2PaginationParams {
     date_from?: string;
     date_to?: string;
 }
+interface V2OrderLineItemPriceData {
+    currency: string;
+    product_data: {
+        name: string;
+        description?: string;
+        images?: string[];
+    };
+    unit_amount: number;
+}
+interface V2OrderLineItem {
+    sku_id?: number;
+    product_id?: number;
+    price_data?: V2OrderLineItemPriceData;
+    price?: string;
+    quantity: number;
+}
+interface V2OrderAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+}
+interface V2OrderTaxRequest {
+    strategy?: string;
+    customer_identifier?: string;
+    customer_profile_id?: string;
+    customer_display_name?: string;
+    allow_exemption?: boolean;
+    save_profile?: boolean;
+    customer_exemption?: {
+        status?: "none" | "exempt" | "reverse_charge";
+        reason?: string;
+        tax_id?: string;
+        tax_id_type?: string;
+        certificate_url?: string;
+        metadata?: Record<string, unknown>;
+        expires_at?: string;
+    };
+}
+interface V2OrderCreateParams {
+    line_items: V2OrderLineItem[];
+    success_url: string;
+    cancel_url: string;
+    customer_email?: string;
+    site_user_id?: string;
+    mode?: "payment" | "subscription";
+    metadata?: Record<string, string | number | boolean>;
+    tax?: V2OrderTaxRequest;
+    shipping_amount?: number;
+    shipping_address?: V2OrderAddress;
+    billing_address?: V2OrderAddress;
+    currency?: string;
+    referral_code?: string;
+    referrer_site_user_id?: string;
+}
+interface V2OrderCreateResult extends V2Object {
+    object: "checkout_session";
+    checkout_url: string | null;
+    payment_status: string | null;
+    tax: {
+        amount: number;
+        currency: string;
+        strategy: string;
+        exemption_applied: boolean;
+        exemption_status: string;
+        breakdown: Array<{
+            jurisdiction?: string;
+            rate_percent: number;
+            tax_amount: number;
+            taxable_amount: number;
+            source: string;
+        }>;
+    };
+}
 interface V2SiteUser extends V2Object {
     object: "site_user";
     email: string;
@@ -3303,10 +3381,37 @@ interface V2SiteUserUpdateParams {
     status?: "active" | "suspended" | "pending_verification";
     metadata?: Record<string, unknown>;
 }
+/**
+ * Patch shape for the authenticated `/me` endpoint. Unlike the admin update,
+ * end users cannot change their own `status`.
+ */
+interface V2SiteUserMeUpdateParams {
+    first_name?: string;
+    last_name?: string;
+    avatar_url?: string;
+    metadata?: Record<string, unknown>;
+}
 interface V2SiteUserListParams extends V2PaginationParams {
     status?: "active" | "suspended" | "pending_verification";
     email?: string;
 }
+/**
+ * Response shape of `GET /sites/{siteName}/users/me`. Extends V2SiteUser with
+ * a `profile` side-channel populated from the `site_user_profiles` KV table.
+ */
+interface V2SiteUserWithProfile extends V2SiteUser {
+    profile: Record<string, unknown>;
+}
+/**
+ * Standalone profile envelope returned by
+ * `GET|PUT /sites/{siteName}/users/me/profile[/:key]`. Each `data` entry is a
+ * parsed value (arbitrary JSON).
+ */
+interface V2SiteUserProfile {
+    object: "site_user_profile";
+    site_user_id: string;
+    data: Record<string, unknown>;
+}
 interface V2NewsletterSubscription extends V2Object {
     object: "newsletter_subscription";
     email: string;
@@ -3353,6 +3458,75 @@ interface V2NewsletterCampaign extends V2Object {
 interface V2NewsletterTrackingResponse {
     success: boolean;
 }
+interface V2NewsletterListCreateParams {
+    list_name: string;
+    slug: string;
+    description?: string | null;
+    is_public?: boolean;
+    is_default?: boolean;
+    welcome_email_enabled?: boolean;
+}
+interface V2NewsletterListUpdateParams {
+    list_name?: string;
+    slug?: string;
+    description?: string | null;
+    is_public?: boolean;
+    is_default?: boolean;
+    welcome_email_enabled?: boolean;
+    status?: "active" | "archived";
+}
+interface V2NewsletterSyncInput {
+    email: string;
+    name?: string | null;
+    status?: "pending" | "confirmed" | "unsubscribed" | "bounced" | "complained";
+    list_ids?: string[];
+    frequency?: "instant" | "daily" | "weekly" | "monthly";
+    topics?: string[];
+    language?: string | null;
+    source?: string | null;
+    source_url?: string | null;
+    notes?: string | null;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    resubscribe_override?: boolean;
+}
+interface V2NewsletterSyncResult {
+    object: "newsletter_sync_result";
+    applied: boolean;
+    code: "CREATED" | "UPDATED" | "RESUBSCRIBED" | "ALREADY_UNSUBSCRIBED";
+    skipped_unsubscribed: boolean;
+    resubscribed: boolean;
+    created: boolean;
+    updated: boolean;
+    subscription: Record<string, unknown>;
+}
+interface V2NewsletterSubscriptionListMembershipUpdate {
+    mode: "add" | "remove" | "replace";
+    list_ids: string[];
+}
+interface V2NewsletterImportRequest {
+    rows: V2NewsletterSyncInput[];
+    resubscribe_override?: boolean;
+}
+interface V2NewsletterImportResult {
+    object: "newsletter_import_result";
+    total: number;
+    processed: number;
+    applied: number;
+    created: number;
+    updated: number;
+    resubscribed: number;
+    skipped_unsubscribed: number;
+    rows: Array<{
+        index: number;
+        email: string;
+        applied: boolean;
+        code: V2NewsletterSyncResult["code"];
+        skipped_unsubscribed: boolean;
+        resubscribed: boolean;
+        subscription_id: string;
+    }>;
+}
 interface V2ContactSubmission extends V2Object {
     object: "contact_submission";
     name: string | null;
@@ -3460,6 +3634,8 @@ declare abstract class BaseV2Client {
     protected post<T>(path: string, body?: unknown): Promise<T>;
     /** PATCH to update a resource. */
     protected patchOne<T>(path: string, body?: unknown): Promise<T>;
+    /** PUT to upsert a resource. */
+    protected putOne<T>(path: string, body?: unknown): Promise<T>;
     /** DELETE a resource. */
     protected deleteOne(path: string): Promise<V2Deleted>;
     /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
@@ -3486,13 +3662,18 @@ declare abstract class BaseV2Client {
 
 declare class ContentV2Client extends BaseV2Client {
     list(siteName: string, params?: V2ContentListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Content>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2ContentListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Content, void, unknown>;
+    listAutoPaginated(siteName: string, params?: Omit<V2ContentListParams, 'starting_after' | 'ending_before'>, cachePolicy?: CachePolicy): AsyncGenerator<V2Content, void, unknown>;
     get(siteName: string, idOrSlug: string, cachePolicy?: CachePolicy): Promise<V2Content>;
     create(siteName: string, data: V2ContentCreateParams): Promise<V2Content>;
     update(siteName: string, id: string, data: V2ContentUpdateParams): Promise<V2Content>;
     del(siteName: string, id: string): Promise<V2Deleted>;
     publish(siteName: string, id: string): Promise<V2Content>;
     unpublish(siteName: string, id: string): Promise<V2Content>;
+    private withContentTags;
+    private buildContentTags;
+    private normalizeTagPart;
+    private extractSlugPrefix;
+    private isContentId;
 }
 
 /**
@@ -3544,16 +3725,33 @@ declare class CollectionsV2Client extends BaseV2Client {
 
 /**
  * v2 Orders Client (checkout sessions)
+ *
+ * `create()` initiates a Stripe checkout session and returns the checkout URL.
+ * No CSRF token is needed — v2 uses API-key auth only.
  */
 
 declare class OrdersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2OrderListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Order>>;
     listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Order, void, unknown>;
     get(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2Order>;
+    /**
+     * Create a checkout session via Stripe. Returns the session ID and a
+     * `checkout_url` that the client should redirect to (or open in a new tab).
+     *
+     * This replaces the v1 `checkout.createCheckoutSession()` + `getCsrfToken()`
+     * dance — v2 is API-key-only and requires no CSRF token.
+     */
+    create(siteName: string, data: V2OrderCreateParams): Promise<V2OrderCreateResult>;
 }
 
 /**
  * v2 Site Users Client
+ *
+ * Two classes of endpoints:
+ *   - Admin paths (list/get/update/OTP flows) require an API key. Use the
+ *     usual `setApiKey(...)` on the main `PerspectApiV2Client` before calling.
+ *   - `/me*` paths require a site-user JWT (minted by `verifyOtp`). Call
+ *     `setAuth(jwt)` on the main client before calling these.
  */
 
 interface V2OtpRequestResponse {
@@ -3578,6 +3776,23 @@ declare class SiteUsersV2Client extends BaseV2Client {
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
     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>;
+    /** 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. */
+    getProfile(siteName: string): Promise<V2SiteUserProfile>;
+    /**
+     * Set a single profile key. The value is persisted verbatim — callers wanting
+     * structured data should JSON-stringify their value first.
+     */
+    setProfileValue(siteName: string, key: string, value: string): Promise<V2SiteUserProfile>;
+    /** Delete a single profile key. */
+    deleteProfileValue(siteName: string, key: string): Promise<V2Deleted>;
 }
 
 /**
@@ -3613,6 +3828,26 @@ declare class NewsletterV2Client extends BaseV2Client {
         status?: string;
     }, cachePolicy?: CachePolicy): Promise<V2List<V2NewsletterCampaign>>;
     getCampaign(siteName: string, idOrSlug: string, cachePolicy?: CachePolicy): Promise<V2NewsletterCampaign>;
+    createList(siteName: string, data: V2NewsletterListCreateParams): Promise<V2NewsletterList>;
+    updateList(siteName: string, id: string, data: V2NewsletterListUpdateParams): Promise<V2NewsletterList>;
+    deleteList(siteName: string, id: string): Promise<V2Deleted>;
+    /**
+     * Upsert a subscription by email and (optionally) replace its list
+     * memberships. Returns a `newsletter_sync_result` envelope with the
+     * outcome (created / updated / resubscribed / already-unsubscribed).
+     */
+    syncSubscription(siteName: string, data: V2NewsletterSyncInput): Promise<V2NewsletterSyncResult>;
+    /**
+     * Add/remove/replace the list memberships for an existing subscription.
+     * Returns the refreshed subscription record.
+     */
+    updateSubscriptionListMembership(siteName: string, subscriptionId: string, data: V2NewsletterSubscriptionListMembershipUpdate): Promise<V2NewsletterSubscription>;
+    /**
+     * Bulk import subscriptions. Each row is upserted via the same sync
+     * path; `refreshListCounts` is deferred until after all rows are
+     * processed on the server.
+     */
+    importSubscriptions(siteName: string, data: V2NewsletterImportRequest): Promise<V2NewsletterImportResult>;
 }
 
 /**
@@ -4073,4 +4308,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 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 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 };

package/dist/index.d.ts

@@ -3112,6 +3112,8 @@ interface V2Media extends V2Object {
     width: number | null;
     height: number | null;
     filesize: number | null;
+    caption: string | null;
+    alt_text: string | null;
 }
 interface V2Content extends V2Object {
     object: "content";
@@ -3282,6 +3284,82 @@ interface V2OrderListParams extends V2PaginationParams {
     date_from?: string;
     date_to?: string;
 }
+interface V2OrderLineItemPriceData {
+    currency: string;
+    product_data: {
+        name: string;
+        description?: string;
+        images?: string[];
+    };
+    unit_amount: number;
+}
+interface V2OrderLineItem {
+    sku_id?: number;
+    product_id?: number;
+    price_data?: V2OrderLineItemPriceData;
+    price?: string;
+    quantity: number;
+}
+interface V2OrderAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+}
+interface V2OrderTaxRequest {
+    strategy?: string;
+    customer_identifier?: string;
+    customer_profile_id?: string;
+    customer_display_name?: string;
+    allow_exemption?: boolean;
+    save_profile?: boolean;
+    customer_exemption?: {
+        status?: "none" | "exempt" | "reverse_charge";
+        reason?: string;
+        tax_id?: string;
+        tax_id_type?: string;
+        certificate_url?: string;
+        metadata?: Record<string, unknown>;
+        expires_at?: string;
+    };
+}
+interface V2OrderCreateParams {
+    line_items: V2OrderLineItem[];
+    success_url: string;
+    cancel_url: string;
+    customer_email?: string;
+    site_user_id?: string;
+    mode?: "payment" | "subscription";
+    metadata?: Record<string, string | number | boolean>;
+    tax?: V2OrderTaxRequest;
+    shipping_amount?: number;
+    shipping_address?: V2OrderAddress;
+    billing_address?: V2OrderAddress;
+    currency?: string;
+    referral_code?: string;
+    referrer_site_user_id?: string;
+}
+interface V2OrderCreateResult extends V2Object {
+    object: "checkout_session";
+    checkout_url: string | null;
+    payment_status: string | null;
+    tax: {
+        amount: number;
+        currency: string;
+        strategy: string;
+        exemption_applied: boolean;
+        exemption_status: string;
+        breakdown: Array<{
+            jurisdiction?: string;
+            rate_percent: number;
+            tax_amount: number;
+            taxable_amount: number;
+            source: string;
+        }>;
+    };
+}
 interface V2SiteUser extends V2Object {
     object: "site_user";
     email: string;
@@ -3303,10 +3381,37 @@ interface V2SiteUserUpdateParams {
     status?: "active" | "suspended" | "pending_verification";
     metadata?: Record<string, unknown>;
 }
+/**
+ * Patch shape for the authenticated `/me` endpoint. Unlike the admin update,
+ * end users cannot change their own `status`.
+ */
+interface V2SiteUserMeUpdateParams {
+    first_name?: string;
+    last_name?: string;
+    avatar_url?: string;
+    metadata?: Record<string, unknown>;
+}
 interface V2SiteUserListParams extends V2PaginationParams {
     status?: "active" | "suspended" | "pending_verification";
     email?: string;
 }
+/**
+ * Response shape of `GET /sites/{siteName}/users/me`. Extends V2SiteUser with
+ * a `profile` side-channel populated from the `site_user_profiles` KV table.
+ */
+interface V2SiteUserWithProfile extends V2SiteUser {
+    profile: Record<string, unknown>;
+}
+/**
+ * Standalone profile envelope returned by
+ * `GET|PUT /sites/{siteName}/users/me/profile[/:key]`. Each `data` entry is a
+ * parsed value (arbitrary JSON).
+ */
+interface V2SiteUserProfile {
+    object: "site_user_profile";
+    site_user_id: string;
+    data: Record<string, unknown>;
+}
 interface V2NewsletterSubscription extends V2Object {
     object: "newsletter_subscription";
     email: string;
@@ -3353,6 +3458,75 @@ interface V2NewsletterCampaign extends V2Object {
 interface V2NewsletterTrackingResponse {
     success: boolean;
 }
+interface V2NewsletterListCreateParams {
+    list_name: string;
+    slug: string;
+    description?: string | null;
+    is_public?: boolean;
+    is_default?: boolean;
+    welcome_email_enabled?: boolean;
+}
+interface V2NewsletterListUpdateParams {
+    list_name?: string;
+    slug?: string;
+    description?: string | null;
+    is_public?: boolean;
+    is_default?: boolean;
+    welcome_email_enabled?: boolean;
+    status?: "active" | "archived";
+}
+interface V2NewsletterSyncInput {
+    email: string;
+    name?: string | null;
+    status?: "pending" | "confirmed" | "unsubscribed" | "bounced" | "complained";
+    list_ids?: string[];
+    frequency?: "instant" | "daily" | "weekly" | "monthly";
+    topics?: string[];
+    language?: string | null;
+    source?: string | null;
+    source_url?: string | null;
+    notes?: string | null;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    resubscribe_override?: boolean;
+}
+interface V2NewsletterSyncResult {
+    object: "newsletter_sync_result";
+    applied: boolean;
+    code: "CREATED" | "UPDATED" | "RESUBSCRIBED" | "ALREADY_UNSUBSCRIBED";
+    skipped_unsubscribed: boolean;
+    resubscribed: boolean;
+    created: boolean;
+    updated: boolean;
+    subscription: Record<string, unknown>;
+}
+interface V2NewsletterSubscriptionListMembershipUpdate {
+    mode: "add" | "remove" | "replace";
+    list_ids: string[];
+}
+interface V2NewsletterImportRequest {
+    rows: V2NewsletterSyncInput[];
+    resubscribe_override?: boolean;
+}
+interface V2NewsletterImportResult {
+    object: "newsletter_import_result";
+    total: number;
+    processed: number;
+    applied: number;
+    created: number;
+    updated: number;
+    resubscribed: number;
+    skipped_unsubscribed: number;
+    rows: Array<{
+        index: number;
+        email: string;
+        applied: boolean;
+        code: V2NewsletterSyncResult["code"];
+        skipped_unsubscribed: boolean;
+        resubscribed: boolean;
+        subscription_id: string;
+    }>;
+}
 interface V2ContactSubmission extends V2Object {
     object: "contact_submission";
     name: string | null;
@@ -3460,6 +3634,8 @@ declare abstract class BaseV2Client {
     protected post<T>(path: string, body?: unknown): Promise<T>;
     /** PATCH to update a resource. */
     protected patchOne<T>(path: string, body?: unknown): Promise<T>;
+    /** PUT to upsert a resource. */
+    protected putOne<T>(path: string, body?: unknown): Promise<T>;
     /** DELETE a resource. */
     protected deleteOne(path: string): Promise<V2Deleted>;
     /** Fetch with optional cache. Bypasses cache for writes or when no cache is configured. */
@@ -3486,13 +3662,18 @@ declare abstract class BaseV2Client {
 
 declare class ContentV2Client extends BaseV2Client {
     list(siteName: string, params?: V2ContentListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Content>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2ContentListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Content, void, unknown>;
+    listAutoPaginated(siteName: string, params?: Omit<V2ContentListParams, 'starting_after' | 'ending_before'>, cachePolicy?: CachePolicy): AsyncGenerator<V2Content, void, unknown>;
     get(siteName: string, idOrSlug: string, cachePolicy?: CachePolicy): Promise<V2Content>;
     create(siteName: string, data: V2ContentCreateParams): Promise<V2Content>;
     update(siteName: string, id: string, data: V2ContentUpdateParams): Promise<V2Content>;
     del(siteName: string, id: string): Promise<V2Deleted>;
     publish(siteName: string, id: string): Promise<V2Content>;
     unpublish(siteName: string, id: string): Promise<V2Content>;
+    private withContentTags;
+    private buildContentTags;
+    private normalizeTagPart;
+    private extractSlugPrefix;
+    private isContentId;
 }
 
 /**
@@ -3544,16 +3725,33 @@ declare class CollectionsV2Client extends BaseV2Client {
 
 /**
  * v2 Orders Client (checkout sessions)
+ *
+ * `create()` initiates a Stripe checkout session and returns the checkout URL.
+ * No CSRF token is needed — v2 uses API-key auth only.
  */
 
 declare class OrdersV2Client extends BaseV2Client {
     list(siteName: string, params?: V2OrderListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Order>>;
     listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Order, void, unknown>;
     get(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2Order>;
+    /**
+     * Create a checkout session via Stripe. Returns the session ID and a
+     * `checkout_url` that the client should redirect to (or open in a new tab).
+     *
+     * This replaces the v1 `checkout.createCheckoutSession()` + `getCsrfToken()`
+     * dance — v2 is API-key-only and requires no CSRF token.
+     */
+    create(siteName: string, data: V2OrderCreateParams): Promise<V2OrderCreateResult>;
 }
 
 /**
  * v2 Site Users Client
+ *
+ * Two classes of endpoints:
+ *   - Admin paths (list/get/update/OTP flows) require an API key. Use the
+ *     usual `setApiKey(...)` on the main `PerspectApiV2Client` before calling.
+ *   - `/me*` paths require a site-user JWT (minted by `verifyOtp`). Call
+ *     `setAuth(jwt)` on the main client before calling these.
  */
 
 interface V2OtpRequestResponse {
@@ -3578,6 +3776,23 @@ declare class SiteUsersV2Client extends BaseV2Client {
     listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
     get(siteName: string, id: string): Promise<V2SiteUser>;
     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>;
+    /** 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. */
+    getProfile(siteName: string): Promise<V2SiteUserProfile>;
+    /**
+     * Set a single profile key. The value is persisted verbatim — callers wanting
+     * structured data should JSON-stringify their value first.
+     */
+    setProfileValue(siteName: string, key: string, value: string): Promise<V2SiteUserProfile>;
+    /** Delete a single profile key. */
+    deleteProfileValue(siteName: string, key: string): Promise<V2Deleted>;
 }
 
 /**
@@ -3613,6 +3828,26 @@ declare class NewsletterV2Client extends BaseV2Client {
         status?: string;
     }, cachePolicy?: CachePolicy): Promise<V2List<V2NewsletterCampaign>>;
     getCampaign(siteName: string, idOrSlug: string, cachePolicy?: CachePolicy): Promise<V2NewsletterCampaign>;
+    createList(siteName: string, data: V2NewsletterListCreateParams): Promise<V2NewsletterList>;
+    updateList(siteName: string, id: string, data: V2NewsletterListUpdateParams): Promise<V2NewsletterList>;
+    deleteList(siteName: string, id: string): Promise<V2Deleted>;
+    /**
+     * Upsert a subscription by email and (optionally) replace its list
+     * memberships. Returns a `newsletter_sync_result` envelope with the
+     * outcome (created / updated / resubscribed / already-unsubscribed).
+     */
+    syncSubscription(siteName: string, data: V2NewsletterSyncInput): Promise<V2NewsletterSyncResult>;
+    /**
+     * Add/remove/replace the list memberships for an existing subscription.
+     * Returns the refreshed subscription record.
+     */
+    updateSubscriptionListMembership(siteName: string, subscriptionId: string, data: V2NewsletterSubscriptionListMembershipUpdate): Promise<V2NewsletterSubscription>;
+    /**
+     * Bulk import subscriptions. Each row is upserted via the same sync
+     * path; `refreshListCounts` is deferred until after all rows are
+     * processed on the server.
+     */
+    importSubscriptions(siteName: string, data: V2NewsletterImportRequest): Promise<V2NewsletterImportResult>;
 }
 
 /**
@@ -4073,4 +4308,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 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 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 };