perspectapi-ts-sdk 3.7.0 → 5.0.0

package/dist/index.d.mts

@@ -277,6 +277,239 @@ interface NewsletterUnsubscribeResponse {
     message: string;
     status?: string;
 }
+interface NewsletterManagementListMembership {
+    id: string;
+    list_name: string;
+    slug: string;
+}
+interface NewsletterManagementSubscription {
+    id: string;
+    site_id: string;
+    site_name: string;
+    email: string;
+    name?: string | null;
+    status: 'pending' | 'confirmed' | 'unsubscribed' | 'bounced' | 'complained';
+    confirmation_token?: string | null;
+    unsubscribe_token: string;
+    double_opt_in: boolean;
+    confirmed_at?: string | null;
+    source?: string | null;
+    source_url?: string | null;
+    frequency: 'instant' | 'daily' | 'weekly' | 'monthly';
+    topics?: string[] | string | null;
+    language: string;
+    tags?: string[] | string | null;
+    custom_fields?: Record<string, any> | string | null;
+    notes?: string | null;
+    unsubscribed_at?: string | null;
+    unsubscribe_reason?: string | null;
+    created_at: string;
+    updated_at: string;
+    lists: NewsletterManagementListMembership[];
+}
+interface NewsletterSubscriptionSyncRequest {
+    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, any>;
+    resubscribe_override?: boolean;
+}
+interface NewsletterSubscriptionSyncResponse {
+    applied: boolean;
+    code: 'CREATED' | 'UPDATED' | 'RESUBSCRIBED' | 'ALREADY_UNSUBSCRIBED';
+    skipped_unsubscribed: boolean;
+    resubscribed: boolean;
+    created: boolean;
+    updated: boolean;
+    subscription_id: string;
+    subscription: NewsletterManagementSubscription;
+}
+type NewsletterSubscriptionsBulkAction = 'confirm' | 'unsubscribe' | 'delete' | 'add_to_list' | 'remove_from_list';
+interface NewsletterSubscriptionsBulkUpdateRequest {
+    ids: string[];
+    action: NewsletterSubscriptionsBulkAction;
+    list_id?: string;
+    resubscribe_override?: boolean;
+}
+interface NewsletterSubscriptionsBulkOutcome {
+    id: string;
+    applied: boolean;
+    code: string;
+    error?: string;
+    skipped_unsubscribed?: boolean;
+}
+interface NewsletterSubscriptionsBulkUpdateResponse {
+    succeeded: number;
+    failed: number;
+    skipped_unsubscribed: number;
+    outcomes: NewsletterSubscriptionsBulkOutcome[];
+}
+interface NewsletterSubscriptionMembershipUpdateRequest {
+    mode: 'add' | 'remove' | 'replace';
+    list_ids: string[];
+}
+interface NewsletterSubscriptionImportRowRequest {
+    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, any>;
+    resubscribe_override?: boolean;
+}
+interface NewsletterSubscriptionsImportRequest {
+    rows: NewsletterSubscriptionImportRowRequest[];
+    resubscribe_override?: boolean;
+}
+interface NewsletterSubscriptionsImportRowResult {
+    index: number;
+    email: string;
+    applied: boolean;
+    code: string;
+    skipped_unsubscribed: boolean;
+    resubscribed: boolean;
+    subscription_id: string;
+}
+interface NewsletterSubscriptionsImportResponse {
+    total: number;
+    processed: number;
+    applied: number;
+    created: number;
+    updated: number;
+    resubscribed: number;
+    skipped_unsubscribed: number;
+    rows: NewsletterSubscriptionsImportRowResult[];
+}
+interface NewsletterManagementPagination {
+    page: number;
+    limit: number;
+    total: number;
+    pages: number;
+}
+interface NewsletterManagementSubscriptionsListResponse {
+    items: NewsletterManagementSubscription[];
+    pagination: NewsletterManagementPagination;
+}
+interface NewsletterManagementList extends NewsletterList {
+    site_id: string;
+    site_name: string;
+    description?: string;
+    is_public: boolean;
+    is_default: boolean;
+    double_opt_in: boolean;
+    welcome_email_enabled: boolean;
+    subscriber_count: number;
+    status: 'active' | 'archived';
+    created_at: string;
+    updated_at: string;
+}
+interface NewsletterManagementSeries {
+    id: string;
+    site_id: string;
+    site_name: string;
+    series_name: string;
+    description?: string | null;
+    list_ids?: string | null;
+    from_name?: string | null;
+    from_email?: string | null;
+    reply_to_email?: string | null;
+    subject_prefix?: string | null;
+    cadence: 'manual' | 'daily' | 'weekly' | 'monthly';
+    timezone?: string | null;
+    send_time?: string | null;
+    day_of_week?: number | null;
+    day_of_month?: number | null;
+    status: 'active' | 'paused' | 'archived';
+    last_sent_at?: string | null;
+    next_send_at?: string | null;
+    tags?: string | null;
+    notes?: string | null;
+    created_at: string;
+    updated_at: string;
+    created_by?: string | null;
+}
+interface NewsletterManagementCampaign {
+    id: string;
+    site_id: string;
+    site_name: string;
+    series_id?: string | null;
+    series_name?: string | null;
+    campaign_name: string;
+    slug?: string | null;
+    slug_prefix?: string | null;
+    subject: string;
+    markdown_content?: string | null;
+    template_id?: string | null;
+    list_ids?: string | null;
+    tags?: string | null;
+    notes?: string | null;
+    preview_text?: string | null;
+    from_name?: string | null;
+    from_email?: string | null;
+    reply_to_email?: string | null;
+    status: 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled';
+    scheduled_at?: string | null;
+    sent_at?: string | null;
+    completed_at?: string | null;
+    total_recipients?: number | null;
+    sent_count?: number | null;
+    delivered_count?: number | null;
+    opened_count?: number | null;
+    clicked_count?: number | null;
+    unsubscribed_count?: number | null;
+    bounced_count?: number | null;
+    complained_count?: number | null;
+    created_at: string;
+    updated_at: string;
+}
+interface NewsletterManagementCampaignListResponse {
+    items: NewsletterManagementCampaign[];
+    pagination: NewsletterManagementPagination;
+}
+interface NewsletterCampaignTestSendRequest {
+    to: string | string[];
+    subject?: string | null;
+}
+interface NewsletterCampaignTestSendResponse {
+    sent: number;
+    recipients: string[];
+    campaign_id: string;
+}
+interface NewsletterManagementStatsResponse {
+    total: number;
+    byStatus: Record<string, number>;
+    recentActivity: Array<{
+        date: string;
+        count: number;
+    }>;
+}
+interface NewsletterExportCreateRequest {
+    format?: 'csv' | 'json' | 'xlsx';
+    status?: 'pending' | 'confirmed' | 'unsubscribed' | 'bounced' | 'complained';
+    list_id?: string;
+    search?: string | null;
+}
+interface NewsletterExportCreateResponse {
+    exportId: string;
+    downloadUrl: string;
+    expiresAt: string;
+    format: 'csv' | 'json';
+    rowCount: number;
+}
 type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
 type ContentType = 'post' | 'page' | 'block';
 interface Content {
@@ -683,7 +916,7 @@ interface SiteUserSubscription {
     provider_subscription_id?: string;
     plan_name?: string;
     plan_id?: string;
-    status: 'active' | 'past_due' | 'canceled' | 'paused' | 'trialing' | 'expired';
+    status: 'active' | 'past_due' | 'canceled' | 'paused' | 'trialing' | 'expired' | 'incomplete';
     amount?: number;
     currency?: string;
     billing_interval?: string;
@@ -705,10 +938,30 @@ interface SiteUserOrder {
     currency: string;
     status: string;
     payment_status?: string;
+    fulfillment_status?: string;
     line_items: any[];
     created_at: string;
     completed_at?: string;
 }
+type SubscriptionCancellationMode = 'immediate' | 'period_end' | 'scheduled';
+interface CancelSubscriptionRequest {
+    mode?: SubscriptionCancellationMode;
+    cancel_at?: string;
+    delay_days?: number;
+    delay_hours?: number;
+    delay_minutes?: number;
+}
+interface CancelSubscriptionResponse {
+    success: boolean;
+    message: string;
+    cancellation?: {
+        mode: SubscriptionCancellationMode;
+        status: string;
+        cancel_at_period_end: boolean;
+        effective_at: string | null;
+        scheduled_cancel_at: string | null;
+    };
+}
 interface CreditTransaction {
     id: number;
     amount_cents: number;
@@ -2134,150 +2387,6 @@ declare class NewsletterClient extends BaseClient {
      * Check subscription status by email
      */
     getStatus(siteName: string, email: string): Promise<ApiResponse<NewsletterStatusResponse>>;
-    /**
-     * Get all newsletter subscriptions (admin only)
-     */
-    getSubscriptions(siteName: string, params?: {
-        page?: number;
-        limit?: number;
-        status?: string;
-        list_id?: string;
-        search?: string;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<PaginatedResponse<NewsletterSubscription>>;
-    /**
-     * Get subscription by ID (admin only)
-     */
-    getSubscriptionById(siteName: string, id: string): Promise<ApiResponse<NewsletterSubscription>>;
-    /**
-     * Update subscription status (admin only)
-     */
-    updateSubscriptionStatus(siteName: string, id: string, status: 'confirmed' | 'unsubscribed' | 'bounced' | 'complained', notes?: string): Promise<ApiResponse<{
-        message: string;
-    }>>;
-    /**
-     * Delete subscription (admin only)
-     */
-    deleteSubscription(siteName: string, id: string): Promise<ApiResponse<{
-        message: string;
-    }>>;
-    /**
-     * Bulk update subscriptions (admin only)
-     */
-    bulkUpdateSubscriptions(siteName: string, data: {
-        ids: string[];
-        action: 'confirm' | 'unsubscribe' | 'delete' | 'add_to_list' | 'remove_from_list';
-        list_id?: string;
-    }): Promise<ApiResponse<{
-        success: boolean;
-        updatedCount: number;
-        failedCount: number;
-    }>>;
-    /**
-     * Create newsletter list (admin only)
-     */
-    createList(siteName: string, data: {
-        list_name: string;
-        slug: string;
-        description?: string;
-        is_public?: boolean;
-        is_default?: boolean;
-        double_opt_in?: boolean;
-        welcome_email_enabled?: boolean;
-    }): Promise<ApiResponse<NewsletterList>>;
-    /**
-     * Update newsletter list (admin only)
-     */
-    updateList(siteName: string, listId: string, data: Partial<{
-        list_name: string;
-        description: string;
-        is_public: boolean;
-        is_default: boolean;
-        double_opt_in: boolean;
-        welcome_email_enabled: boolean;
-    }>): Promise<ApiResponse<{
-        message: string;
-    }>>;
-    /**
-     * Delete newsletter list (admin only)
-     */
-    deleteList(siteName: string, listId: string): Promise<ApiResponse<{
-        message: string;
-    }>>;
-    /**
-     * Get newsletter statistics (admin only)
-     */
-    getStatistics(siteName: string, params?: {
-        startDate?: string;
-        endDate?: string;
-        list_id?: string;
-    }): Promise<ApiResponse<{
-        totalSubscribers: number;
-        confirmedSubscribers: number;
-        pendingSubscribers: number;
-        unsubscribedCount: number;
-        bouncedCount: number;
-        subscribersByDay: Array<{
-            date: string;
-            count: number;
-        }>;
-        subscribersByList: Array<{
-            list_id: string;
-            list_name: string;
-            count: number;
-        }>;
-        engagementMetrics: {
-            averageOpenRate: number;
-            averageClickRate: number;
-        };
-    }>>;
-    /**
-     * Export newsletter subscriptions (admin only)
-     */
-    exportSubscriptions(siteName: string, params?: {
-        format?: 'csv' | 'json' | 'xlsx';
-        status?: string;
-        list_id?: string;
-        startDate?: string;
-        endDate?: string;
-    }): Promise<ApiResponse<{
-        downloadUrl: string;
-        expiresAt: string;
-    }>>;
-    /**
-     * Import newsletter subscriptions (admin only)
-     */
-    importSubscriptions(siteName: string, data: {
-        subscriptions: Array<{
-            email: string;
-            name?: string;
-            status?: string;
-            lists?: string[];
-        }>;
-        skip_confirmation?: boolean;
-        update_existing?: boolean;
-    }): Promise<ApiResponse<{
-        imported: number;
-        updated: number;
-        failed: number;
-        errors?: Array<{
-            email: string;
-            error: string;
-        }>;
-    }>>;
-    /**
-     * Send test newsletter (admin only)
-     */
-    sendTestNewsletter(siteName: string, data: {
-        to: string;
-        subject: string;
-        html_content: string;
-        text_content?: string;
-    }): Promise<ApiResponse<{
-        message: string;
-        sent: boolean;
-    }>>;
     /**
      * Track email open event.
      * Called by client sites when their tracking pixel route is hit.
@@ -2312,6 +2421,171 @@ declare class NewsletterClient extends BaseClient {
     private isCachePolicy;
 }
 
+/**
+ * Newsletter management client for PerspectAPI SDK
+ * Strict management surface under /newsletter/management/*
+ */
+
+declare class NewsletterManagementClient extends BaseClient {
+    constructor(http: any, cache?: CacheManager);
+    private managementEndpoint;
+    listSubscriptions(siteName: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: 'pending' | 'confirmed' | 'unsubscribed' | 'bounced' | 'complained';
+        list_id?: string;
+        search?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ApiResponse<NewsletterManagementSubscriptionsListResponse>>;
+    getSubscriptionById(siteName: string, subscriptionId: string): Promise<ApiResponse<NewsletterManagementSubscription>>;
+    getSubscriptionByEmail(siteName: string, email: string): Promise<ApiResponse<NewsletterManagementSubscription>>;
+    syncSubscription(siteName: string, data: NewsletterSubscriptionSyncRequest): Promise<ApiResponse<NewsletterSubscriptionSyncResponse>>;
+    updateSubscription(siteName: string, subscriptionId: string, data: Omit<NewsletterSubscriptionSyncRequest, 'email'>): Promise<ApiResponse<NewsletterSubscriptionSyncResponse>>;
+    deleteSubscription(siteName: string, subscriptionId: string): Promise<ApiResponse<{
+        deleted: boolean;
+        subscription_id: string;
+    }>>;
+    bulkUpdateSubscriptions(siteName: string, data: NewsletterSubscriptionsBulkUpdateRequest): Promise<ApiResponse<NewsletterSubscriptionsBulkUpdateResponse>>;
+    updateSubscriptionListMembership(siteName: string, subscriptionId: string, data: NewsletterSubscriptionMembershipUpdateRequest): Promise<ApiResponse<{
+        subscription: NewsletterManagementSubscription;
+        mode: 'add' | 'remove' | 'replace';
+        list_ids: string[];
+    }>>;
+    importSubscriptions(siteName: string, data: NewsletterSubscriptionsImportRequest): Promise<ApiResponse<NewsletterSubscriptionsImportResponse>>;
+    listLists(siteName: string, params?: {
+        status?: 'active' | 'archived';
+    }): Promise<ApiResponse<{
+        items: NewsletterManagementList[];
+        total: number;
+    }>>;
+    getListById(siteName: string, listId: string): Promise<ApiResponse<NewsletterManagementList>>;
+    createList(siteName: string, data: {
+        list_name: string;
+        slug: string;
+        description?: string | null;
+        is_public?: boolean;
+        is_default?: boolean;
+        double_opt_in?: boolean;
+        welcome_email_enabled?: boolean;
+    }): Promise<ApiResponse<NewsletterManagementList>>;
+    updateList(siteName: string, listId: string, data: Partial<{
+        list_name: string | null;
+        slug: string | null;
+        description: string | null;
+        is_public: boolean;
+        is_default: boolean;
+        double_opt_in: boolean;
+        welcome_email_enabled: boolean;
+        status: 'active' | 'archived';
+    }>): Promise<ApiResponse<NewsletterManagementList>>;
+    deleteList(siteName: string, listId: string): Promise<ApiResponse<{
+        deleted: boolean;
+        list_id: string;
+    }>>;
+    listSeries(siteName: string, params?: {
+        status?: 'active' | 'paused' | 'archived';
+    }): Promise<ApiResponse<{
+        items: NewsletterManagementSeries[];
+        total: number;
+    }>>;
+    getSeriesById(siteName: string, seriesId: string): Promise<ApiResponse<NewsletterManagementSeries>>;
+    createSeries(siteName: string, data: {
+        series_name: string;
+        description?: string | null;
+        status?: 'active' | 'paused' | 'archived';
+        cadence?: 'manual' | 'daily' | 'weekly' | 'monthly';
+        timezone?: string | null;
+        send_time?: string | null;
+        day_of_week?: number | null;
+        day_of_month?: number | null;
+        next_send_at?: string | null;
+        list_ids?: string[];
+        from_name?: string | null;
+        from_email?: string | null;
+        reply_to_email?: string | null;
+        subject_prefix?: string | null;
+        tags?: string[];
+        notes?: string | null;
+    }): Promise<ApiResponse<NewsletterManagementSeries>>;
+    updateSeries(siteName: string, seriesId: string, data: Partial<{
+        series_name: string;
+        description?: string | null;
+        status?: 'active' | 'paused' | 'archived';
+        cadence?: 'manual' | 'daily' | 'weekly' | 'monthly';
+        timezone?: string | null;
+        send_time?: string | null;
+        day_of_week?: number | null;
+        day_of_month?: number | null;
+        next_send_at?: string | null;
+        list_ids?: string[];
+        from_name?: string | null;
+        from_email?: string | null;
+        reply_to_email?: string | null;
+        subject_prefix?: string | null;
+        tags?: string[];
+        notes?: string | null;
+    }>): Promise<ApiResponse<NewsletterManagementSeries>>;
+    deleteSeries(siteName: string, seriesId: string): Promise<ApiResponse<{
+        deleted: boolean;
+        series_id: string;
+    }>>;
+    listCampaigns(siteName: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: 'draft' | 'scheduled' | 'sending' | 'sent' | 'cancelled';
+    }): Promise<ApiResponse<NewsletterManagementCampaignListResponse>>;
+    getCampaignById(siteName: string, campaignId: string): Promise<ApiResponse<NewsletterManagementCampaign>>;
+    createCampaign(siteName: string, data: {
+        campaign_name: string;
+        subject: string;
+        markdown_content: string;
+        slug?: string | null;
+        slug_prefix?: string | null;
+        status?: 'draft' | 'scheduled' | 'cancelled';
+        scheduled_at?: string | null;
+        preview_text?: string | null;
+        from_name?: string | null;
+        from_email?: string | null;
+        reply_to_email?: string | null;
+        template_id?: string | null;
+        series_id?: string | null;
+        list_ids?: string[];
+        tags?: string[];
+        notes?: string | null;
+    }): Promise<ApiResponse<NewsletterManagementCampaign>>;
+    updateCampaign(siteName: string, campaignId: string, data: Partial<{
+        campaign_name: string;
+        subject: string;
+        markdown_content: string;
+        slug?: string | null;
+        slug_prefix?: string | null;
+        status?: 'draft' | 'scheduled' | 'cancelled';
+        scheduled_at?: string | null;
+        preview_text?: string | null;
+        from_name?: string | null;
+        from_email?: string | null;
+        reply_to_email?: string | null;
+        template_id?: string | null;
+        series_id?: string | null;
+        list_ids?: string[];
+        tags?: string[];
+        notes?: string | null;
+    }>): Promise<ApiResponse<NewsletterManagementCampaign>>;
+    deleteCampaign(siteName: string, campaignId: string): Promise<ApiResponse<{
+        deleted: boolean;
+        campaign_id: string;
+    }>>;
+    sendCampaignTest(siteName: string, campaignId: string, data: NewsletterCampaignTestSendRequest): Promise<ApiResponse<NewsletterCampaignTestSendResponse>>;
+    getStats(siteName: string, params?: {
+        startDate?: string;
+        endDate?: string;
+        list_id?: string;
+    }): Promise<ApiResponse<NewsletterManagementStatsResponse>>;
+    createExport(siteName: string, data: NewsletterExportCreateRequest): Promise<ApiResponse<NewsletterExportCreateResponse>>;
+    downloadExport(siteName: string, exportId: string): Promise<ApiResponse<string>>;
+}
+
 /**
  * Site Users client for PerspectAPI SDK
  * Handles per-site customer accounts (OTP-based auth, profiles, orders, subscriptions)
@@ -2467,15 +2741,13 @@ declare class SiteUsersClient extends BaseClient {
         subscription: SiteUserSubscription;
     }>>;
     /**
-     * Cancel a subscription (marks for cancellation at period end)
+     * Cancel a subscription.
      * @param siteName - The site name
      * @param id - Subscription ID
      * @param csrfToken - CSRF token (required)
+     * @param options - Cancellation mode/details
      */
-    cancelSubscription(siteName: string, id: string, csrfToken?: string): Promise<ApiResponse<{
-        success: boolean;
-        message: string;
-    }>>;
+    cancelSubscription(siteName: string, id: string, csrfToken?: string, options?: CancelSubscriptionRequest): Promise<ApiResponse<CancelSubscriptionResponse>>;
     /**
      * Pause a subscription via Stripe pause_collection
      * @param siteName - The site name
@@ -2648,11 +2920,9 @@ declare class SiteUsersClient extends BaseClient {
      * @param siteName - The site name
      * @param userId - User ID
      * @param subscriptionId - Subscription ID
+     * @param options - Cancellation mode/details
      */
-    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
-        success: boolean;
-        message: string;
-    }>>;
+    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string, options?: CancelSubscriptionRequest): Promise<ApiResponse<CancelSubscriptionResponse>>;
     /**
      * Get a user's credit balance (admin only)
      * @param siteName - The site name
@@ -2713,6 +2983,7 @@ declare class PerspectApiClient {
     readonly checkout: CheckoutClient;
     readonly contact: ContactClient;
     readonly newsletter: NewsletterClient;
+    readonly newsletterManagement: NewsletterManagementClient;
     readonly siteUsers: SiteUsersClient;
     readonly bundles: BundlesClient;
     constructor(config: PerspectApiConfig);
@@ -2801,6 +3072,616 @@ declare class PerspectApiClient {
  */
 declare function createPerspectApiClient(config: PerspectApiConfig): PerspectApiClient;
 
+/**
+ * v2 SDK Types — matches the API wire format exactly (snake_case).
+ *
+ * These types reflect the actual JSON returned by /api/v2/ endpoints.
+ * No transformation layer is needed in the SDK.
+ */
+interface V2Object {
+    object: string;
+    id: string;
+}
+interface V2List<T> {
+    object: "list";
+    data: T[];
+    has_more: boolean;
+    url: string;
+}
+interface V2Deleted {
+    object: string;
+    id: string;
+    deleted: true;
+}
+interface V2Error {
+    error: {
+        type: V2ErrorType;
+        code: string;
+        message: string;
+        param?: string;
+    };
+}
+type V2ErrorType = "invalid_request_error" | "authentication_error" | "permission_error" | "not_found_error" | "rate_limit_error" | "api_error";
+interface V2PaginationParams {
+    limit?: number;
+    starting_after?: string;
+    ending_before?: string;
+}
+interface V2Content extends V2Object {
+    object: "content";
+    title: string;
+    content: string;
+    markdown: string | null;
+    slug: string;
+    slug_prefix: string | null;
+    type: "post" | "page" | "block";
+    status: "draft" | "publish" | "private" | "trash" | "scheduled";
+    author: string | null;
+    custom: Record<string, unknown> | null;
+    featured_image?: string | null;
+    scheduled_at: string | null;
+    published_at: string;
+    updated_at: string;
+}
+interface V2ContentCreateParams {
+    title: string;
+    content: string;
+    markdown?: string;
+    custom?: Record<string, unknown>;
+    slug?: string;
+    slug_prefix?: string;
+    published_at?: string;
+    scheduled_at?: string | null;
+    status?: "draft" | "publish" | "private" | "trash" | "scheduled";
+    type?: "post" | "page" | "block";
+}
+interface V2ContentUpdateParams extends Partial<V2ContentCreateParams> {
+}
+interface V2ContentListParams extends V2PaginationParams {
+    status?: "draft" | "publish" | "private" | "trash" | "scheduled";
+    type?: "post" | "page" | "block";
+    search?: string;
+    slug_prefix?: string;
+}
+interface V2Product extends V2Object {
+    object: "product";
+    name: string;
+    description: string | null;
+    excerpt: string | null;
+    meta_description: string | null;
+    price: number;
+    unit_amount: number;
+    currency: string;
+    sku: string | null;
+    slug: string | null;
+    slug_prefix: string | null;
+    published: boolean;
+    stock_quantity: number | null;
+    custom: Record<string, unknown> | null;
+    recurring: {
+        interval: string;
+        interval_count?: number;
+    } | null;
+    tax_behavior: "inclusive" | "exclusive" | "unspecified" | null;
+    category_id: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2ProductCreateParams {
+    name: string;
+    description?: string;
+    excerpt?: string;
+    meta_description?: string;
+    category_id?: string;
+    price: number;
+    unit_amount: number;
+    currency?: string;
+    sku?: string;
+    custom?: Record<string, unknown>;
+    slug?: string;
+    slug_prefix?: string;
+    published?: boolean;
+    stock_quantity?: number | null;
+    recurring?: {
+        interval: "day" | "week" | "month" | "year";
+        interval_count?: number;
+    };
+    tax_behavior?: "inclusive" | "exclusive" | "unspecified";
+    attachment_ids?: number[];
+}
+interface V2ProductUpdateParams extends Partial<V2ProductCreateParams> {
+}
+interface V2ProductListParams extends V2PaginationParams {
+    published?: boolean;
+    category_id?: string;
+    search?: string;
+    slug_prefix?: string;
+}
+interface V2Category extends V2Object {
+    object: "category";
+    name: string;
+    description: string | null;
+    slug: string | null;
+    slug_prefix: string | null;
+    parent_id: string | null;
+    type: "post" | "product" | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2CategoryCreateParams {
+    name: string;
+    description?: string;
+    slug?: string;
+    slug_prefix?: string;
+    parent_id?: string;
+    type?: "post" | "product";
+}
+interface V2CategoryUpdateParams extends Partial<V2CategoryCreateParams> {
+}
+interface V2Collection extends V2Object {
+    object: "collection";
+    name: string;
+    description: string | null;
+    available_from: string | null;
+    available_until: string | null;
+    published: boolean;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2CollectionItem extends V2Object {
+    object: "collection_item";
+    collection_id: string;
+    product_id: string;
+    max_quantity: number | null;
+    position: number;
+}
+interface V2CollectionCreateParams {
+    name: string;
+    description?: string | null;
+    available_from?: string | null;
+    available_until?: string | null;
+    published?: boolean;
+}
+interface V2CollectionUpdateParams extends Partial<V2CollectionCreateParams> {
+}
+interface V2Order extends V2Object {
+    object: "checkout_session";
+    customer_email: string;
+    customer_name: string | null;
+    customer_phone: string | null;
+    customer_details: Record<string, unknown> | null;
+    shipping_details: Record<string, unknown> | null;
+    order_id: string | null;
+    line_items: unknown[] | null;
+    amount_total: number;
+    currency: string;
+    tax_summary: Record<string, unknown> | null;
+    status: string;
+    payment_status: string | null;
+    fulfillment_status: string | null;
+    tracking_number: string | null;
+    notes: string | null;
+    live_mode: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    completed_at: string | null;
+    expires_at: string | null;
+}
+interface V2OrderListParams extends V2PaginationParams {
+    status?: string;
+    customer_email?: string;
+    date_from?: string;
+    date_to?: string;
+}
+interface V2SiteUser extends V2Object {
+    object: "site_user";
+    email: string;
+    email_verified: boolean;
+    first_name: string | null;
+    last_name: string | null;
+    avatar_url: string | null;
+    status: string;
+    waitlist: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string | null;
+    updated_at: string | null;
+    last_login_at: string | null;
+}
+interface V2SiteUserUpdateParams {
+    first_name?: string;
+    last_name?: string;
+    avatar_url?: string;
+    status?: "active" | "suspended" | "pending_verification";
+    metadata?: Record<string, unknown>;
+}
+interface V2SiteUserListParams extends V2PaginationParams {
+    status?: "active" | "suspended" | "pending_verification";
+    email?: string;
+}
+interface V2NewsletterSubscription extends V2Object {
+    object: "newsletter_subscription";
+    email: string;
+    name: string | null;
+    status: string;
+    double_opt_in: boolean;
+    confirmed_at: string | null;
+    source: string | null;
+    frequency: string | null;
+    topics: string[] | null;
+    language: string | null;
+    tags: string[] | null;
+    custom_fields: Record<string, unknown> | null;
+    unsubscribed_at: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2NewsletterList extends V2Object {
+    object: "newsletter_list";
+    name: string;
+    slug: string;
+    description: string | null;
+    is_default: boolean;
+    subscriber_count: number;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2NewsletterCampaign extends V2Object {
+    object: "newsletter_campaign";
+    name: string;
+    slug: string | null;
+    subject: string;
+    preview_text: string | null;
+    status: string;
+    sent_at: string | null;
+    completed_at: string | null;
+    total_recipients: number;
+    sent_count: number;
+    opened_count: number;
+    clicked_count: number;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2ContactSubmission extends V2Object {
+    object: "contact_submission";
+    name: string | null;
+    first_name: string | null;
+    last_name: string | null;
+    email: string;
+    subject: string | null;
+    message: string;
+    phone: string | null;
+    company: string | null;
+    status: string;
+    metadata: Record<string, unknown> | null;
+    created_at: string | null;
+    processed_at: string | null;
+}
+interface V2Organization extends V2Object {
+    object: "organization";
+    name: string;
+    slug: string | null;
+    endpoint_status: string | null;
+    endpoint_url: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2Site extends V2Object {
+    object: "site";
+    name: string;
+    title: string | null;
+    description: string | null;
+    domain: string | null;
+    custom_domain: string | null;
+    organization_id: string | null;
+    tax_enabled: boolean;
+    lifecycle_status: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2ApiKey extends V2Object {
+    object: "api_key";
+    name: string;
+    description: string | null;
+    organization_id: string | null;
+    site_name: string | null;
+    permissions: string[] | null;
+    is_active: boolean;
+    expires_at: string | null;
+    last_used_at: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2Webhook extends V2Object {
+    object: "webhook";
+    url: string;
+    description: string | null;
+    events: string[] | null;
+    is_active: boolean;
+    created_at: string | null;
+    updated_at: string | null;
+}
+interface V2WebhookCreateParams {
+    url: string;
+    description?: string;
+    events?: string[];
+    is_active?: boolean;
+}
+interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
+}
+
+/**
+ * v2 Base Client — cursor pagination, expand support, typed errors.
+ */
+
+declare class PerspectV2Error extends Error {
+    readonly type: string;
+    readonly code: string;
+    readonly param?: string;
+    readonly status: number;
+    constructor(error: V2Error['error'], status: number);
+}
+declare abstract class BaseV2Client {
+    protected http: HttpClient;
+    protected basePath: string;
+    constructor(http: HttpClient, basePath: string);
+    protected buildPath(endpoint: string): string;
+    protected sitePath(siteName: string, resource: string, suffix?: string): string;
+    private toParams;
+    /** GET a single resource. */
+    protected getOne<T>(path: string, params?: object): Promise<T>;
+    /** GET a list of resources with cursor pagination. */
+    protected getList<T>(path: string, params?: object): Promise<V2List<T>>;
+    /** POST to create a resource. */
+    protected post<T>(path: string, body?: unknown): Promise<T>;
+    /** PATCH to update a resource. */
+    protected patchOne<T>(path: string, body?: unknown): Promise<T>;
+    /** DELETE a resource. */
+    protected deleteOne(path: string): Promise<V2Deleted>;
+    /**
+     * Auto-paginating async generator.
+     * Yields every item across all pages.
+     *
+     * Usage:
+     *   for await (const item of client.listAutoPaginate(path, params)) { ... }
+     */
+    protected listAutoPaginate<T extends {
+        id: string;
+    }>(path: string, params?: object): AsyncGenerator<T, void, unknown>;
+    private toError;
+}
+
+/**
+ * v2 Content Client
+ */
+
+declare class ContentV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2ContentListParams): Promise<V2List<V2Content>>;
+    listAutoPaginated(siteName: string, params?: Omit<V2ContentListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Content, void, unknown>;
+    get(siteName: string, idOrSlug: string): 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>;
+}
+
+/**
+ * v2 Products Client
+ */
+
+declare class ProductsV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2ProductListParams): Promise<V2List<V2Product>>;
+    listAutoPaginated(siteName: string, params?: Omit<V2ProductListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Product, void, unknown>;
+    get(siteName: string, idOrSlug: string): Promise<V2Product>;
+    create(siteName: string, data: V2ProductCreateParams): Promise<V2Product>;
+    update(siteName: string, id: string, data: V2ProductUpdateParams): Promise<V2Product>;
+    del(siteName: string, id: string): Promise<V2Deleted>;
+}
+
+/**
+ * v2 Categories Client
+ */
+
+declare class CategoriesV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2PaginationParams & {
+        type?: string;
+    }): Promise<V2List<V2Category>>;
+    get(siteName: string, id: string): Promise<V2Category>;
+    create(siteName: string, data: V2CategoryCreateParams): Promise<V2Category>;
+    update(siteName: string, id: string, data: V2CategoryUpdateParams): Promise<V2Category>;
+    del(siteName: string, id: string): Promise<V2Deleted>;
+}
+
+/**
+ * v2 Collections Client
+ */
+
+declare class CollectionsV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2PaginationParams): Promise<V2List<V2Collection>>;
+    getCurrent(siteName: string): Promise<V2Collection | null>;
+    get(siteName: string, id: string): Promise<V2Collection>;
+    create(siteName: string, data: V2CollectionCreateParams): Promise<V2Collection>;
+    update(siteName: string, id: string, data: V2CollectionUpdateParams): Promise<V2Collection>;
+    del(siteName: string, id: string): Promise<V2Deleted>;
+    listItems(siteName: string, collectionId: string): Promise<V2List<V2CollectionItem>>;
+    addItem(siteName: string, collectionId: string, data: {
+        product_id: string;
+        max_quantity?: number | null;
+        position?: number;
+    }): Promise<V2CollectionItem>;
+    removeItem(siteName: string, collectionId: string, itemId: string): Promise<V2Deleted>;
+}
+
+/**
+ * v2 Orders Client (checkout sessions)
+ */
+
+declare class OrdersV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2OrderListParams): Promise<V2List<V2Order>>;
+    listAutoPaginated(siteName: string, params?: Omit<V2OrderListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Order, void, unknown>;
+    get(siteName: string, id: string): Promise<V2Order>;
+}
+
+/**
+ * v2 Site Users Client
+ */
+
+interface V2OtpRequestResponse {
+    object: 'otp_request';
+    email: string;
+    expires_in: number;
+}
+interface V2OtpVerifyResponse extends V2SiteUser {
+    token: string;
+}
+declare class SiteUsersV2Client extends BaseV2Client {
+    requestOtp(siteName: string, data: {
+        email: string;
+        waitlist?: boolean;
+        metadata?: Record<string, unknown>;
+    }): Promise<V2OtpRequestResponse>;
+    verifyOtp(siteName: string, data: {
+        email: string;
+        code: string;
+    }): Promise<V2OtpVerifyResponse>;
+    list(siteName: string, params?: V2SiteUserListParams): Promise<V2List<V2SiteUser>>;
+    listAutoPaginated(siteName: string, params?: Omit<V2SiteUserListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2SiteUser, void, unknown>;
+    get(siteName: string, id: string): Promise<V2SiteUser>;
+    update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
+}
+
+/**
+ * v2 Newsletter Client
+ */
+
+declare class NewsletterV2Client extends BaseV2Client {
+    subscribe(siteName: string, data: {
+        email: string;
+        name?: string;
+        list_ids?: string[];
+        double_opt_in?: boolean;
+        source?: string;
+        source_url?: string;
+        frequency?: 'instant' | 'daily' | 'weekly' | 'monthly';
+        topics?: string[];
+        language?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<V2NewsletterSubscription>;
+    confirm(siteName: string, token: string): Promise<V2NewsletterSubscription>;
+    unsubscribe(siteName: string, data: {
+        token?: string;
+        email?: string;
+        reason?: string;
+    }): Promise<V2NewsletterSubscription>;
+    listSubscriptions(siteName: string, params?: V2PaginationParams & {
+        status?: string;
+    }): Promise<V2List<V2NewsletterSubscription>>;
+    getSubscription(siteName: string, id: string): Promise<V2NewsletterSubscription>;
+    listLists(siteName: string): Promise<V2List<V2NewsletterList>>;
+    listCampaigns(siteName: string, params?: V2PaginationParams & {
+        status?: string;
+    }): Promise<V2List<V2NewsletterCampaign>>;
+    getCampaign(siteName: string, idOrSlug: string): Promise<V2NewsletterCampaign>;
+}
+
+/**
+ * v2 Contacts Client
+ */
+
+declare class ContactsV2Client extends BaseV2Client {
+    submit(siteName: string, data: {
+        email: string;
+        message: string;
+        name?: string;
+        first_name?: string;
+        last_name?: string;
+        subject?: string;
+        phone?: string;
+        company?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<V2ContactSubmission>;
+    list(siteName: string, params?: V2PaginationParams & {
+        status?: string;
+    }): Promise<V2List<V2ContactSubmission>>;
+    get(siteName: string, id: string): Promise<V2ContactSubmission>;
+}
+
+/**
+ * v2 Organizations Client
+ */
+
+declare class OrganizationsV2Client extends BaseV2Client {
+    list(): Promise<V2List<V2Organization>>;
+    get(id: string): Promise<V2Organization>;
+}
+
+/**
+ * v2 Sites Client
+ */
+
+declare class SitesV2Client extends BaseV2Client {
+    list(params?: V2PaginationParams): Promise<V2List<V2Site>>;
+    get(name: string): Promise<V2Site>;
+}
+
+/**
+ * v2 API Keys Client
+ */
+
+declare class ApiKeysV2Client extends BaseV2Client {
+    list(params?: V2PaginationParams): Promise<V2List<V2ApiKey>>;
+    get(id: string): Promise<V2ApiKey>;
+    del(id: string): Promise<V2Deleted>;
+}
+
+/**
+ * v2 Webhooks Client
+ */
+
+declare class WebhooksV2Client extends BaseV2Client {
+    list(siteName: string, params?: V2PaginationParams): Promise<V2List<V2Webhook>>;
+    get(siteName: string, id: string): Promise<V2Webhook>;
+    create(siteName: string, data: V2WebhookCreateParams): Promise<V2Webhook>;
+    update(siteName: string, id: string, data: V2WebhookUpdateParams): Promise<V2Webhook>;
+    del(siteName: string, id: string): Promise<V2Deleted>;
+}
+
+/**
+ * PerspectAPI v2 SDK Client
+ *
+ * Stripe-style API with consistent envelopes, prefixed IDs,
+ * cursor pagination, and snake_case responses.
+ *
+ * Usage:
+ *   import { PerspectApiV2Client } from 'perspectapi-ts-sdk/v2';
+ *   const client = new PerspectApiV2Client({ baseUrl: '...', apiKey: '...' });
+ *   const posts = await client.content.list('mysite', { type: 'post', limit: 10 });
+ */
+
+declare class PerspectApiV2Client {
+    private http;
+    readonly content: ContentV2Client;
+    readonly products: ProductsV2Client;
+    readonly categories: CategoriesV2Client;
+    readonly collections: CollectionsV2Client;
+    readonly orders: OrdersV2Client;
+    readonly siteUsers: SiteUsersV2Client;
+    readonly newsletter: NewsletterV2Client;
+    readonly contacts: ContactsV2Client;
+    readonly organizations: OrganizationsV2Client;
+    readonly sites: SitesV2Client;
+    readonly apiKeys: ApiKeysV2Client;
+    readonly webhooks: WebhooksV2Client;
+    constructor(config: PerspectApiConfig);
+    /** Update the JWT token for authenticated requests. */
+    setAuth(jwt: string): void;
+    /** Update the API key. */
+    setApiKey(apiKey: string): void;
+    /** Clear authentication. */
+    clearAuth(): void;
+}
+declare function createPerspectApiV2Client(config: PerspectApiConfig): PerspectApiV2Client;
+
 /**
  * Simple in-memory cache adapter primarily suited for development and testing.
  */
@@ -3119,4 +4000,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, 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, 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, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, 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 UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, 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, 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 };