perspectapi-ts-sdk 6.5.7 → 7.0.0

package/dist/index.d.ts

@@ -1,2211 +1,24 @@
-/**
- * v1 deprecation constants — kept in sync with the backend's
- * `src/lib/deprecation.ts`.
- *
- * v1 sunsets 2026-06-01. All new integrations must use the v2 client.
- */
-declare const V1_SUNSET_DATE = "2026-06-01";
-declare const V1_DEPRECATION_NOTICE: string;
-
-/**
- * Cache-related types for the PerspectAPI SDK.
- */
-type CacheKeyPart = string | number | boolean | null | undefined | Record<string, unknown> | Array<Record<string, unknown> | string | number | boolean | null | undefined>;
-interface CacheSetOptions {
-    ttlSeconds?: number;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-}
-interface CachePolicy extends CacheSetOptions {
-    skipCache?: boolean;
-}
-interface CacheAdapter {
-    /**
-     * Retrieve a raw cache payload for the given key. Implementations should return
-     * undefined (or null) when the key does not exist or has expired.
-     */
-    get(key: string): Promise<string | undefined | null>;
-    /**
-     * Store a raw payload for the given key. Implementations MAY honour ttlSeconds
-     * natively; the cache manager will also persist expiry timestamps in the payload
-     * for adapters that do not have native TTL support.
-     */
-    set(key: string, value: string, options?: {
-        ttlSeconds?: number;
-    }): Promise<void>;
-    /**
-     * Remove a cached entry.
-     */
-    delete(key: string): Promise<void>;
-    /**
-     * Optional bulk delete implementation.
-     */
-    deleteMany?(keys: string[]): Promise<void>;
-    /**
-     * Optional clear method to wipe all entries for adapters that manage isolated namespaces.
-     */
-    clear?(): Promise<void>;
-}
-interface CacheManagerOptions {
-    defaultTtlSeconds?: number;
-    keyPrefix?: string;
-}
-interface CacheConfig extends CacheManagerOptions {
-    /**
-     * Explicit flag to disable caching. Defaults to false when a cache configuration
-     * is supplied, so caching is considered enabled unless explicitly disabled.
-     */
-    enabled?: boolean;
-    adapter?: CacheAdapter;
-}
-interface CacheInvalidateOptions {
-    keys?: string[];
-    tags?: string[];
-}
-
-/**
- * CacheManager orchestrates cache get/set/invalidate behaviour using a pluggable adapter.
- */
-
-declare class CacheManager {
-    private adapter;
-    private readonly defaultTtlSeconds;
-    private readonly keyPrefix;
-    private readonly enabled;
-    constructor(config?: CacheConfig);
-    isEnabled(): boolean;
-    getKeyPrefix(): string;
-    buildKey(parts: CacheKeyPart[]): string;
-    getOrSet<T>(key: string, resolveValue: () => Promise<T>, policy?: CachePolicy): Promise<T>;
-    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
-    delete(key: string): Promise<void>;
-    invalidate(options: CacheInvalidateOptions): Promise<void>;
-    private namespacedKey;
-    private tagKey;
-    private serialize;
-    private deserialize;
-    private deserializeTagSet;
-    private registerKeyTags;
-    private removeKeyFromTags;
-    private normalizeKeyPart;
-    private normalizeObject;
-}
-
-/**
- * Core types and interfaces for PerspectAPI SDK
- */
-
-interface ApiResponse<T = any> {
-    data?: T;
-    message?: string;
-    error?: string;
-    success: boolean;
-    code?: string;
-}
-interface PaginationParams {
-    page?: number;
-    limit?: number;
-    offset?: number;
-}
-interface PaginatedResponse<T> extends ApiResponse<T[]> {
-    pagination?: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-    };
-}
-interface User {
-    id: string;
-    email: string;
-    firstName?: string;
-    lastName?: string;
-    createdAt?: string;
-    isActive?: boolean;
-}
-interface ApiKey {
-    id: string;
-    name: string;
-    description?: string;
-    permissions: string[];
-    organizationId?: number;
-    siteName?: string;
-    isActive: boolean;
-    createdAt: string;
-    expiresAt?: string;
-    lastUsedAt?: string;
-}
-interface CreateApiKeyRequest {
-    name: string;
-    description?: string;
-    permissions: string[];
-    organizationId?: number;
-    siteName?: string;
-    expiresAt?: string;
-}
-interface UpdateApiKeyRequest {
-    name?: string;
-    description?: string;
-    permissions?: string[];
-    isActive?: boolean;
-}
-interface Organization {
-    id: number;
-    name: string;
-    description?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateOrganizationRequest {
-    name: string;
-    description?: string;
-}
-interface Site {
-    id: number;
-    name: string;
-    domain?: string;
-    managementDomain?: string;
-    description?: string;
-    organizationId: number;
-    isActive: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateSiteRequest {
-    name: string;
-    domain?: string;
-    managementDomain?: string;
-    description?: string;
-    organizationId: number;
-}
-interface NewsletterSubscription {
-    id: string;
-    email: string;
-    name?: string;
-    status: 'pending' | 'confirmed' | 'unsubscribed' | 'bounced' | 'complained';
-    frequency: 'instant' | 'daily' | 'weekly' | 'monthly';
-    topics?: string[];
-    language: string;
-    confirmedAt?: string;
-    unsubscribedAt?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateNewsletterSubscriptionRequest {
-    email: string;
-    name?: string;
-    list_ids?: string[];
-    frequency?: 'instant' | 'daily' | 'weekly' | 'monthly';
-    topics?: string[];
-    language?: string;
-    source?: string;
-    source_url?: string;
-    metadata?: Record<string, any>;
-}
-interface NewsletterList {
-    id: string;
-    list_name: string;
-    slug: string;
-    description?: string;
-    is_default: boolean;
-    subscriber_count?: number;
-}
-interface NewsletterCampaignSummary {
-    id: string;
-    campaign_name: string;
-    slug: string;
-    slug_prefix?: string | null;
-    subject: string;
-    preview_text?: string | null;
-    status: string;
-    sent_at?: string | null;
-    completed_at?: string | null;
-    created_at: string;
-    updated_at: string;
-}
-interface NewsletterCampaignDetail extends NewsletterCampaignSummary {
-    markdown_content?: string | null;
-    html_content?: string | null;
-    text_content?: string | null;
-    excerpt?: string | null;
-}
-interface NewsletterCampaignListResponse {
-    items: NewsletterCampaignSummary[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        pages: number;
-    };
-}
-interface NewsletterPreferences {
-    frequency?: 'instant' | 'daily' | 'weekly' | 'monthly';
-    topics?: string[];
-    language?: string;
-    email_format?: 'html' | 'text' | 'both';
-    timezone?: string;
-    track_opens?: boolean;
-    track_clicks?: boolean;
-}
-interface NewsletterStatusResponse {
-    success: boolean;
-    code?: string;
-    subscribed: boolean;
-    status: string;
-    frequency?: string;
-    created_at?: string;
-    confirmed_at?: string;
-}
-interface NewsletterSubscribeResponse {
-    success: boolean;
-    code: string;
-    message: string;
-    status: string;
-    subscription_id?: string;
-}
-interface NewsletterConfirmResponse {
-    success: boolean;
-    code: string;
-    message: string;
-    status?: string;
-    subscription?: {
-        email: string;
-        name?: string;
-        frequency: string;
-    };
-}
-interface NewsletterUnsubscribeRequest {
-    token?: string;
-    email?: string;
-    reason?: string;
-}
-interface NewsletterUnsubscribeResponse {
-    success: boolean;
-    code: string;
-    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 {
-    id: number;
-    pageTitle: string;
-    pageContent: string;
-    contentMarkdown?: string;
-    custom?: Record<string, any>;
-    slug?: string;
-    slug_prefix?: string;
-    pageStatus: ContentStatus;
-    pageType: ContentType;
-    media?: MediaItem[] | MediaItem[][];
-    image?: string;
-    userId?: number;
-    organizationId?: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateContentRequest {
-    page_title: string;
-    page_content: string;
-    content_markdown?: string;
-    custom?: Record<string, any>;
-    slug?: string;
-    page_status?: ContentStatus;
-    page_type?: ContentType;
-}
-interface UpdateContentRequest extends Partial<CreateContentRequest> {
-}
-interface ContentQueryParams extends PaginationParams {
-    page_status?: ContentStatus;
-    page_type?: ContentType;
-    search?: string;
-    user_id?: number;
-    slug_prefix?: string;
-    recent?: number;
-}
-interface Category {
-    id: number;
-    name: string;
-    slug: string;
-    description?: string;
-    parentId?: number;
-    organizationId?: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CategorySummary {
-    id: number;
-    name: string;
-    slug: string;
-    description?: string;
-}
-interface ContentCategoryResponse {
-    category: CategorySummary;
-    items: Content[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        pages: number;
-    };
-}
-interface CreateCategoryRequest {
-    name: string;
-    slug?: string;
-    description?: string;
-    parentId?: number;
-}
-interface MediaItem {
-    media_id: string;
-    attachment_id: number;
-    file_name: string;
-    link: string;
-    content_type: string;
-    width: number;
-    height: number;
-    filesize: number;
-    r2_key: string;
-    site_name: string;
-}
-interface ProductSkuMediaItem {
-    id?: string;
-    media_id: string;
-    file_name?: string;
-    fileName?: string;
-    link?: string;
-    url?: string;
-    content_type?: string;
-    contentType?: string;
-    width?: number;
-    height?: number;
-    filesize?: number;
-    r2_key?: string;
-    site_name?: string;
-}
-interface ProductSkuOption {
-    name: string;
-    key: string;
-    value: string;
-    label: string;
-    value_id: number;
-}
-interface ProductSku {
-    sku_id: number;
-    sku?: string | null;
-    combination_key: string;
-    media_id?: string | null;
-    media?: ProductSkuMediaItem | null;
-    options?: ProductSkuOption[];
-    unit_amount?: number;
-    currency?: string;
-    quantity_available?: number | null;
-    price?: number;
-    sale_price?: number;
-    stock_quantity?: number;
-    value_ids: number[];
-    created_at?: string;
-    updated_at?: string;
-    [key: string]: any;
-}
-interface Product {
-    id: number | string;
-    name?: string;
-    product?: string;
-    description?: string;
-    description_markdown?: string;
-    price?: number;
-    currency?: string;
-    sku?: string;
-    slug?: string;
-    slug_prefix?: string;
-    image?: string;
-    media?: MediaItem[] | MediaItem[][];
-    skus?: ProductSku[];
-    isActive?: boolean;
-    organizationId?: number;
-    createdAt?: string;
-    updatedAt?: string;
-    gateway_product_id_live?: string;
-    gateway_product_id_test?: string;
-    stripe_product_id_live?: string;
-    stripe_product_id_test?: string;
-    [key: string]: any;
-}
-interface CreateProductRequest {
-    product: string;
-    name?: string;
-    description?: string;
-    excerpt?: string;
-    price: number;
-    unit_amount: number;
-    currency?: string;
-    sku?: string;
-    slug?: string;
-    slug_prefix?: string;
-    published?: boolean;
-    custom?: Record<string, any>;
-    recurring?: {
-        interval: "day" | "week" | "month" | "year";
-        interval_count?: number;
-    };
-    stock_quantity?: number | null;
-    isActive?: boolean;
-}
-interface CreateProductSkuRequest {
-    sku?: string | null;
-    media_id?: string | null;
-    unit_amount?: number;
-    currency?: string;
-    quantity_available?: number | null;
-    price?: number | null;
-    stock_quantity?: number | null;
-    sale_price?: number | null;
-    published?: boolean;
-    gateway_price_id_test?: string | null;
-    gateway_price_id_live?: string | null;
-    value_ids: number[];
-}
-interface ProductQueryParams extends PaginationParams {
-    organizationId?: number;
-    isActive?: boolean;
-    search?: string;
-    category?: string | string[];
-    category_id?: number | string | Array<number | string>;
-    slug_prefix?: string;
-}
-interface BlogPost {
-    id: string | number;
-    slug: string;
-    slug_prefix?: string;
-    page_type?: string;
-    title: string;
-    content?: string;
-    excerpt?: string;
-    image?: string;
-    media?: MediaItem[] | MediaItem[][];
-    published?: boolean;
-    created_at?: string;
-    updated_at?: string;
-    description?: string;
-    published_date?: string;
-    author?: string;
-    tags?: string[];
-    [key: string]: any;
-}
-interface PaymentGateway {
-    id: number;
-    name: string;
-    provider: string;
-    isActive: boolean;
-    configuration: Record<string, any>;
-    organizationId?: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreatePaymentGatewayRequest {
-    name: string;
-    provider: string;
-    configuration: Record<string, any>;
-    isActive?: boolean;
-}
-type WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
-interface Webhook {
-    id: string;
-    name: string;
-    url: string;
-    provider: string;
-    events: WebhookEventType[];
-    isActive: boolean;
-    secret?: string;
-    organizationId?: number;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateWebhookRequest {
-    name: string;
-    url: string;
-    provider: string;
-    events: WebhookEventType[];
-    isActive?: boolean;
-    secret?: string;
-}
-type CheckoutMetadataValue = string | number | boolean | null | CheckoutMetadataValue[] | {
-    [key: string]: CheckoutMetadataValue;
-};
-type CheckoutMetadata = Record<string, CheckoutMetadataValue>;
-type CheckoutTaxStrategy = 'disabled' | 'gateway_auto' | 'manual_rates' | 'external_service';
-type CheckoutTaxExemptionStatus = 'none' | 'exempt' | 'reverse_charge';
-interface CheckoutAddress {
-    line1?: string;
-    line2?: string;
-    city?: string;
-    state?: string;
-    postal_code?: string;
-    country?: string;
-}
-interface CheckoutTaxCustomerExemptionRequest {
-    status?: CheckoutTaxExemptionStatus;
-    reason?: string;
-    tax_id?: string;
-    tax_id_type?: string;
-    certificate_url?: string;
-    metadata?: Record<string, any>;
-    expires_at?: string;
-}
-interface CheckoutTaxRequest {
-    strategy?: CheckoutTaxStrategy;
-    customer_identifier?: string;
-    customer_profile_id?: string;
-    customer_display_name?: string;
-    allow_exemption?: boolean;
-    require_tax_id?: boolean;
-    save_profile?: boolean;
-    customer_exemption?: CheckoutTaxCustomerExemptionRequest;
-    manual_rate_percent?: number;
-    manual_rate_map?: Record<string, number>;
-    external_service?: {
-        provider: string;
-        config?: Record<string, any>;
-    };
-    metadata?: Record<string, any>;
-}
-interface CreateCheckoutSessionRequest {
-    priceId?: string;
-    quantity?: number;
-    line_items?: Array<{
-        price?: string;
-        quantity: number;
-        sku_id?: number;
-        product_id?: number;
-        price_data?: {
-            currency: string;
-            product_data: {
-                name: string;
-                description?: string;
-                images?: string[];
-            };
-            unit_amount: number;
-        };
-    }>;
-    success_url: string;
-    cancel_url: string;
-    successUrl?: string;
-    cancelUrl?: string;
-    customer_email?: string;
-    customerEmail?: string;
-    site_user_id?: string;
-    referral_code?: string;
-    referrer_site_user_id?: string;
-    currency?: string;
-    metadata?: CheckoutMetadata;
-    mode?: 'payment' | 'subscription' | 'setup';
-    automatic_tax?: {
-        enabled: boolean;
-    };
-    shipping_address_collection?: {
-        allowed_countries: string[];
-    };
-    billing_address_collection?: 'auto' | 'required';
-    shipping_amount?: number;
-    shippingAmount?: number;
-    shipping_address?: CheckoutAddress;
-    shippingAddress?: CheckoutAddress;
-    billing_address?: CheckoutAddress;
-    billingAddress?: CheckoutAddress;
-    tax?: CheckoutTaxRequest;
-}
-interface CheckoutTaxBreakdownItem {
-    jurisdiction: string;
-    rate_percent: number;
-    tax_amount: number;
-    taxable_amount: number;
-    source: 'manual_map' | 'manual_percent' | 'gateway' | 'external';
-}
-interface CheckoutSessionTax {
-    amount: number;
-    currency: string;
-    strategy: CheckoutTaxStrategy;
-    exemption_applied: boolean;
-    exemption_status: CheckoutTaxExemptionStatus;
-    breakdown?: CheckoutTaxBreakdownItem[] | null;
-}
-interface CheckoutSession {
-    id: string;
-    url: string;
-    status: string;
-    payment_status?: string;
-    tax?: CheckoutSessionTax | null;
-}
-interface ContactSubmission {
-    id: string;
-    name: string;
-    email: string;
-    subject?: string;
-    message: string;
-    status: string;
-    createdAt: string;
-}
-interface CreateContactRequest {
-    name: string;
-    email: string;
-    subject?: string;
-    message: string;
-}
-interface ContactSubmitResponse {
-    success: boolean;
-    code: string;
-    contact_id: string;
-    message: string;
-    status: string;
-}
-interface ContactStatusResponse {
-    success: boolean;
-    code: string;
-    contact_id: string;
-    status: string;
-    submitted_at: string;
-    processed_at?: string;
-    metadata?: Record<string, any>;
-}
-interface SiteUser {
-    id: string;
-    email: string;
-    first_name?: string;
-    last_name?: string;
-    avatar_url?: string;
-    status: 'active' | 'suspended' | 'pending_verification';
-    email_verified: boolean;
-    waitlist: boolean;
-    metadata?: Record<string, any>;
-    created_at: string;
-    last_login_at?: string;
-}
-interface SiteUserProfile {
-    [key: string]: {
-        value: any;
-        updated_at: string;
-    };
-}
-interface SiteUserSubscription {
-    id: string;
-    provider: string;
-    provider_subscription_id?: string;
-    plan_name?: string;
-    plan_id?: string;
-    status: 'active' | 'past_due' | 'canceled' | 'paused' | 'trialing' | 'expired' | 'incomplete';
-    amount?: number;
-    currency?: string;
-    billing_interval?: string;
-    billing_interval_count?: number;
-    current_period_start?: string;
-    current_period_end?: string;
-    trial_start?: string;
-    trial_end?: string;
-    canceled_at?: string;
-    cancel_at_period_end: boolean;
-    created_at: string;
-    updated_at: string;
-}
-interface SiteUserOrder {
-    session_id: string;
-    order_id?: string;
-    customer_email?: string;
-    amount_total: number;
-    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;
-    balance_after_cents: number;
-    type: string;
-    description: string | null;
-    created_at: string;
-}
-interface CreditBalance {
-    balance_cents: number;
-}
-interface CreditBalanceWithTransactions extends CreditBalance {
-    transactions: CreditTransaction[];
-}
-interface GrantCreditRequest {
-    amount_cents: number;
-    description: string;
-}
-interface RequestOtpRequest {
-    email: string;
-    waitlist?: boolean;
-    metadata?: Record<string, any>;
-}
-interface VerifyOtpRequest {
-    email: string;
-    code: string;
-}
-interface VerifyOtpResponse {
-    success: boolean;
-    token: string;
-    user: {
-        id: string;
-        email: string;
-        first_name?: string;
-        last_name?: string;
-        avatar_url?: string;
-    };
-}
-interface UpdateSiteUserRequest {
-    first_name?: string;
-    last_name?: string;
-    avatar_url?: string;
-    metadata?: Record<string, any>;
-}
-interface SetProfileValueRequest {
-    value: string;
-}
-interface ProductBundleGroup {
-    bundle_group_id: number;
-    product_id: number;
-    name: string;
-    description?: string;
-    quantity: number;
-    position: number;
-    created_at: string;
-    updated_at: string;
-}
-interface CreateBundleGroupRequest {
-    name: string;
-    description?: string;
-    quantity: number;
-    position?: number;
-}
-interface BundleCollection {
-    collection_id: number;
-    site_id: string;
-    site_name: string;
-    name: string;
-    description?: string;
-    available_from?: string;
-    available_until?: string;
-    custom?: Record<string, any> | string | null;
-    published: number;
-    created_at: string;
-    updated_at: string;
-}
-interface CreateBundleCollectionRequest {
-    name: string;
-    description?: string;
-    available_from?: string;
-    available_until?: string;
-    custom?: Record<string, any> | null;
-    published?: number;
-}
-interface BundleCollectionItem {
-    id: number;
-    collection_id: number;
-    product_id: number;
-    max_quantity?: number;
-    position: number;
-    created_at: string;
-    updated_at: string;
-}
-interface BundleCollectionItemWithProduct extends BundleCollectionItem {
-    product_name: string;
-    slug: string;
-    unit_amount: number;
-    currency: string;
-    image_url?: string;
-}
-interface AddCollectionItemRequest {
-    product_id: number;
-    max_quantity?: number;
-    position?: number;
-}
-interface ApiError {
-    message: string;
-    code?: string;
-    status?: number;
-    details?: any;
-}
-declare class PerspectApiError extends Error implements ApiError {
-    code?: string;
-    status?: number;
-    details?: any;
-    constructor({ message, code, status, details }: ApiError);
-}
-interface PerspectApiConfig {
-    baseUrl: string;
-    apiKey?: string;
-    jwt?: string;
-    timeout?: number;
-    retries?: number;
-    headers?: Record<string, string>;
-    cache?: CacheConfig;
-}
-type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-interface RequestOptions {
-    method?: HttpMethod;
-    headers?: Record<string, string>;
-    body?: any;
-    params?: Record<string, string | number | boolean>;
-    timeout?: number;
-    csrfToken?: string;
-}
-
-/**
- * HTTP Client for PerspectAPI SDK
- * Cloudflare Workers compatible - uses native fetch API
- */
-
-declare class HttpClient {
-    private baseUrl;
-    private defaultHeaders;
-    private timeout;
-    private retries;
-    constructor(config: PerspectApiConfig);
-    /**
-     * Update authentication token
-     */
-    setAuth(jwt: string): void;
-    /**
-     * Update API key
-     */
-    setApiKey(apiKey: string): void;
-    /**
-     * Whether this client currently has a site-user/admin bearer token attached.
-     * Bearer-scoped GETs must not share cache entries across callers.
-     */
-    hasBearerAuth(): boolean;
-    /**
-     * Remove authentication
-     */
-    clearAuth(): void;
-    /**
-     * Make HTTP request with retry logic
-     */
-    request<T = any>(endpoint: string, options?: RequestOptions): Promise<ApiResponse<T>>;
-    /**
-     * GET request
-     */
-    get<T = any>(endpoint: string, params?: Record<string, any>): Promise<ApiResponse<T>>;
-    /**
-     * POST request
-     */
-    post<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
-    /**
-     * PUT request
-     */
-    put<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
-    /**
-     * DELETE request
-     */
-    delete<T = any>(endpoint: string, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
-    /**
-     * PATCH request
-     */
-    patch<T = any>(endpoint: string, body?: any, options?: Partial<RequestOptions>): Promise<ApiResponse<T>>;
-    /**
-     * Build full URL with query parameters
-     */
-    private buildUrl;
-    /**
-     * Build request options
-     */
-    private buildRequestOptions;
-    /**
-     * Fetch with timeout support
-     */
-    private fetchWithTimeout;
-    /**
-     * Handle response and errors
-     */
-    private handleResponse;
-    /**
-     * Delay utility for retries
-     */
-    private delay;
-}
-/**
- * Create API Error from unknown error
- */
-declare function createApiError(error: unknown): ApiError;
-
-/**
- * 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 V2Media extends V2Object {
-    object: "media";
-    file_name: string;
-    url: string;
-    content_type: string | null;
-    width: number | null;
-    height: number | null;
-    filesize: number | null;
-    caption: string | null;
-    alt_text: string | null;
-}
-interface V2Content extends V2Object {
-    object: "content";
-    title: string;
-    content: string;
-    markdown: string | null;
-    excerpt: 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;
-    media: V2Media[];
-    scheduled_at: string | null;
-    published_at: string;
-    updated_at: string;
-}
-interface V2ContentCreateParams {
-    title: string;
-    content: string;
-    markdown?: string;
-    excerpt?: 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;
-    category?: 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;
-    gateway_product_id_test: string | null;
-    gateway_product_id_live: string | null;
-    gateway_price_id_test: string | null;
-    gateway_price_id_live: string | null;
-    media: V2Media[];
-    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;
-    custom: Record<string, unknown> | 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;
-    custom?: Record<string, unknown> | 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 V2OrderLineItemPriceData {
-    currency: string;
-    product_data: {
-        name: string;
-        description?: string;
-        images?: string[];
-    };
-    unit_amount: number;
-}
-interface V2OrderLineItem {
-    sku_id?: number;
-    product_id?: string | 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";
-    deferred_subscription_product_id?: string | number;
-    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 V2OrderFulfillmentUpdate {
-    fulfillment_status: string;
-    tracking_number?: string;
-    notes?: 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;
-    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>;
-}
-/**
- * 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;
-    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 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;
-    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;
-}
-type V2WebhookEventType = "content.created" | "content.updated" | "content.published" | "content.unpublished" | "content.deleted" | "newsletter.created" | "newsletter.updated" | "newsletter.published" | "newsletter.sent" | "newsletter.deleted" | "product.created" | "product.updated" | "product.deleted" | "product.stock_changed" | "order.paid" | "category.created" | "category.updated" | "category.deleted" | "site.updated" | "site.settings_changed" | "ab.flag_started" | "ab.flag_paused" | "ab.flag_resumed" | "ab.flag_stopped" | "ab.flag_updated" | "ab.config_warmup" | (string & Record<never, never>);
-interface V2Webhook extends V2Object {
-    object: "webhook";
-    url: string;
-    description: string | null;
-    events: V2WebhookEventType[] | null;
-    is_active: boolean;
-    created_at: string | null;
-    updated_at: string | null;
-}
-interface V2WebhookCreateParams {
-    url: string;
-    description?: string;
-    events?: V2WebhookEventType[];
-    is_active?: boolean;
-}
-interface V2WebhookUpdateParams extends Partial<V2WebhookCreateParams> {
-}
-interface V2SiteUserSubscription extends V2Object {
-    object: "site_user_subscription";
-    site_user_id: string;
-    provider: string | null;
-    provider_subscription_id: string | null;
-    plan_name: string | null;
-    plan_id: string | null;
-    status: string;
-    amount: number | null;
-    currency: string | null;
-    billing_interval: string | null;
-    billing_interval_count: number | null;
-    current_period_start: string | null;
-    current_period_end: string | null;
-    trial_start: string | null;
-    trial_end: string | null;
-    canceled_at: string | null;
-    cancel_at_period_end: boolean;
-    metadata: Record<string, unknown> | null;
-    created_at: string | null;
-    updated_at: string | null;
-}
-interface V2SubscriptionPauseParams {
-    resumes_at?: number;
-}
-interface V2SubscriptionCancelParams {
-    mode?: "immediate" | "period_end" | "scheduled";
-    cancel_at?: string;
-}
-interface V2SubscriptionChangePlanParams {
-    product_id: string;
-}
-interface V2CancelSubscriptionResult {
-    object: "subscription_cancel_result";
-    mode: string;
-    status: string;
-    cancel_at_period_end: boolean;
-    effective_at: string | null;
-    scheduled_cancel_at: string | null;
-    message: string;
-}
-interface V2CreditTransaction extends V2Object {
-    object: "credit_transaction";
-    site_user_id: string;
-    amount_cents: number;
-    balance_after_cents: number;
-    type: string;
-    description: string | null;
-    reference_id: string | null;
-    reference_type: string | null;
-    created_at: string | null;
-}
-interface V2CreditBalance {
-    object: "credit_balance";
-    balance_cents: number;
-    transactions?: V2CreditTransaction[];
-}
-interface V2GrantCreditParams {
-    amount_cents: number;
-    description: string;
-}
-interface V2GrantCreditResult {
-    object: "grant_credit_result";
-    new_balance_cents: number;
-}
-
-/**
- * v2 Base Client — cursor pagination, expand support, caching, typed errors.
- */
-
-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;
-    protected cache?: CacheManager;
-    constructor(http: HttpClient, basePath: string, cache?: CacheManager);
-    protected buildPath(endpoint: string): string;
-    protected sitePath(siteName: string, resource: string, suffix?: string): string;
-    private toParams;
-    /**
-     * Extract v2 payload from HttpClient response.
-     *
-     * The shared HttpClient wraps responses in a v1-style { success, data } envelope.
-     * v2 API responses don't have a `success` field — the HttpClient already throws
-     * on HTTP errors, so if we reach this point the request succeeded.
-     *
-     * The HttpClient may return the v2 payload nested under `data` (when the response
-     * JSON contains a `data` key, which v2 list responses do) or as a direct wrap.
-     * We unwrap accordingly.
-     */
-    private extractData;
-    /** GET a single resource, with optional caching. */
-    protected getOne<T>(path: string, params?: object, cachePolicy?: CachePolicy): Promise<T>;
-    /** GET a list of resources with cursor pagination, with optional caching. */
-    protected getList<T>(path: string, params?: object, cachePolicy?: CachePolicy): 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>;
-    /** 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. */
-    private fetchWithCache;
-    /** Invalidate cache entries by keys or tags. */
-    protected invalidateCache(options: CacheInvalidateOptions): Promise<void>;
-    private buildCacheKey;
-    /**
-     * 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, cachePolicy?: CachePolicy): Promise<V2List<V2Content>>;
-    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;
-}
-
-/**
- * v2 Products Client
- */
-
-declare class ProductsV2Client extends BaseV2Client {
-    list(siteName: string, params?: V2ProductListParams, cachePolicy?: CachePolicy): Promise<V2List<V2Product>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2ProductListParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Product, void, unknown>;
-    get(siteName: string, idOrSlug: string, cachePolicy?: CachePolicy): 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;
-    }, cachePolicy?: CachePolicy): Promise<V2List<V2Category>>;
-    get(siteName: string, id: string, cachePolicy?: CachePolicy): 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>>;
-    listAutoPaginated(siteName: string, params?: Omit<V2PaginationParams, 'starting_after' | 'ending_before'>): AsyncGenerator<V2Collection, void, unknown>;
-    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)
- *
- * `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>;
-    /** Update fulfillment status, tracking number, and/or notes on an order. */
-    updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
-}
-
-/**
- * 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 {
-    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>;
-    getProfileForUser(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2SiteUserProfile>;
-    update(siteName: string, id: string, data: V2SiteUserUpdateParams): Promise<V2SiteUser>;
-    /**
-     * Load the currently-authenticated site user's canonical record plus their
-     * profile KV map. Requires `client.setAuth(jwt)` to have been called with
-     * the token returned from `verifyOtp`.
-     */
-    getMe(siteName: string, cachePolicy?: CachePolicy): Promise<V2SiteUserWithProfile>;
-    /** Update the authenticated user's own fields. */
-    updateMe(siteName: string, data: V2SiteUserMeUpdateParams): Promise<V2SiteUser>;
-    /** Fetch the profile KV map as a dedicated `site_user_profile` envelope. */
-    getProfile(siteName: string, cachePolicy?: CachePolicy): 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>;
-}
-
-/**
- * v2 Newsletter Client
- */
-
-declare class NewsletterV2Client extends BaseV2Client {
-    subscribe(siteName: string, data: {
-        email: string;
-        name?: string;
-        list_ids?: string[];
-        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>;
-    trackOpen(siteName: string, token: string): Promise<V2NewsletterTrackingResponse>;
-    trackClick(siteName: string, token: string, url: string): Promise<V2NewsletterTrackingResponse>;
-    listSubscriptions(siteName: string, params?: V2PaginationParams & {
-        status?: string;
-    }, cachePolicy?: CachePolicy): Promise<V2List<V2NewsletterSubscription>>;
-    getSubscription(siteName: string, id: string, cachePolicy?: CachePolicy): Promise<V2NewsletterSubscription>;
-    listLists(siteName: string, cachePolicy?: CachePolicy): Promise<V2List<V2NewsletterList>>;
-    listCampaigns(siteName: string, params?: V2PaginationParams & {
-        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>;
-}
-
-/**
- * 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>;
-}
+import { H as HttpClient, C as CacheManager, A as ApiResponse, a as CachePolicy, b as CacheInvalidateOptions, U as User, c as ContentQueryParams, P as PaginatedResponse, d as Content, e as ContentCategoryResponse, f as CreateContentRequest, g as UpdateContentRequest, h as ApiKey, i as CreateApiKeyRequest, j as UpdateApiKeyRequest, O as Organization, k as CreateOrganizationRequest, S as Site, l as CreateSiteRequest, m as ProductQueryParams, n as Product, o as CreateProductRequest, p as ProductSku, q as CreateProductSkuRequest, r as Category, s as CreateCategoryRequest, W as Webhook, t as CreateWebhookRequest, u as CreateCheckoutSessionRequest, v as CheckoutSession, w as CreateContactRequest, x as ContactSubmitResponse, y as ContactStatusResponse, z as ContactSubmission, B as CreateNewsletterSubscriptionRequest, N as NewsletterSubscribeResponse, D as NewsletterConfirmResponse, E as NewsletterUnsubscribeRequest, F as NewsletterUnsubscribeResponse, G as NewsletterPreferences, I as NewsletterList, J as NewsletterCampaignListResponse, K as NewsletterCampaignDetail, L as NewsletterStatusResponse, M as NewsletterManagementSubscriptionsListResponse, Q as NewsletterManagementSubscription, R as NewsletterSubscriptionSyncRequest, T as NewsletterSubscriptionSyncResponse, V as NewsletterSubscriptionsBulkUpdateRequest, X as NewsletterSubscriptionsBulkUpdateResponse, Y as NewsletterSubscriptionMembershipUpdateRequest, Z as NewsletterSubscriptionsImportRequest, _ as NewsletterSubscriptionsImportResponse, $ as NewsletterManagementList, a0 as NewsletterManagementSeries, a1 as NewsletterManagementCampaignListResponse, a2 as NewsletterManagementCampaign, a3 as NewsletterCampaignTestSendRequest, a4 as NewsletterCampaignTestSendResponse, a5 as NewsletterManagementStatsResponse, a6 as NewsletterExportCreateRequest, a7 as NewsletterExportCreateResponse, a8 as RequestOtpRequest, a9 as VerifyOtpRequest, aa as VerifyOtpResponse, ab as SiteUser, ac as SiteUserProfile, ad as UpdateSiteUserRequest, ae as SiteUserOrder, af as SiteUserSubscription, ag as CancelSubscriptionRequest, ah as CancelSubscriptionResponse, ai as CreditBalance, aj as CreditBalanceWithTransactions, ak as GrantCreditRequest, al as ProductBundleGroup, am as CreateBundleGroupRequest, an as BundleCollection, ao as BundleCollectionItemWithProduct, ap as CreateBundleCollectionRequest, aq as AddCollectionItemRequest, ar as BundleCollectionItem, as as PerspectApiConfig, at as CacheAdapter, au as BlogPost, av as CheckoutMetadata, aw as CheckoutAddress, ax as CheckoutTaxRequest } from './index-CWvUyMt3.js';
+export { aE as ApiError, aD as CacheConfig, aG as CategorySummary, b$ as CheckoutMetadataValue, c4 as CheckoutSessionTax, c3 as CheckoutTaxBreakdownItem, c2 as CheckoutTaxCustomerExemptionRequest, c1 as CheckoutTaxExemptionStatus, c0 as CheckoutTaxStrategy, bV as ContentStatus, bW as ContentType, bZ as CreatePaymentGatewayRequest, c6 as CreditTransaction, c7 as HttpMethod, aF as MediaItem, aJ as NewsletterCampaignSummary, aK as NewsletterManagementListMembership, aP as NewsletterManagementPagination, aI as NewsletterSubscription, aN as NewsletterSubscriptionImportRowRequest, aL as NewsletterSubscriptionsBulkAction, aM as NewsletterSubscriptionsBulkOutcome, aO as NewsletterSubscriptionsImportRowResult, bU as PaginationParams, aH as PaymentGateway, aC as PerspectApiError, ay as PerspectApiV2Client, aA as PerspectV2Error, bX as ProductSkuMediaItem, bY as ProductSkuOption, c8 as RequestOptions, aQ as SetProfileValueRequest, c5 as SubscriptionCancellationMode, bE as V2ApiKey, bP as V2CancelSubscriptionResult, b4 as V2Category, b5 as V2CategoryCreateParams, b6 as V2CategoryUpdateParams, b7 as V2Collection, b9 as V2CollectionCreateParams, b8 as V2CollectionItem, ba as V2CollectionUpdateParams, bB as V2ContactSubmission, aY as V2Content, aZ as V2ContentCreateParams, a$ as V2ContentListParams, a_ as V2ContentUpdateParams, bR as V2CreditBalance, bQ as V2CreditTransaction, aT as V2Deleted, aU as V2Error, aV as V2ErrorType, bS as V2GrantCreditParams, bT as V2GrantCreditResult, aS as V2List, aX as V2Media, bs as V2NewsletterCampaign, bz as V2NewsletterImportRequest, bA as V2NewsletterImportResult, br as V2NewsletterList, bu as V2NewsletterListCreateParams, bv as V2NewsletterListUpdateParams, bq as V2NewsletterSubscription, by as V2NewsletterSubscriptionListMembershipUpdate, bw as V2NewsletterSyncInput, bx as V2NewsletterSyncResult, bt as V2NewsletterTrackingResponse, aR as V2Object, bb as V2Order, bf as V2OrderAddress, bh as V2OrderCreateParams, bj as V2OrderCreateResult, bi as V2OrderFulfillmentUpdate, be as V2OrderLineItem, bd as V2OrderLineItemPriceData, bc as V2OrderListParams, bg as V2OrderTaxRequest, bC as V2Organization, aW as V2PaginationParams, b0 as V2Product, b1 as V2ProductCreateParams, b3 as V2ProductListParams, b2 as V2ProductUpdateParams, bD as V2Site, bk as V2SiteUser, bn as V2SiteUserListParams, bm as V2SiteUserMeUpdateParams, bp as V2SiteUserProfile, bJ as V2SiteUserSubscription, bl as V2SiteUserUpdateParams, bo as V2SiteUserWithProfile, bL as V2SubscriptionCancelParams, bM as V2SubscriptionChangePlanParams, bN as V2SubscriptionChargeParams, bO as V2SubscriptionChargeResult, bK as V2SubscriptionPauseParams, bG as V2Webhook, bH as V2WebhookCreateParams, bF as V2WebhookEventType, bI as V2WebhookUpdateParams, b_ as WebhookEventType, aB as createApiError, az as createPerspectApiV2Client } from './index-CWvUyMt3.js';
 
 /**
- * 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>;
-}
-
-/**
- * v2 Subscriptions Client — lifecycle operations for site user subscriptions.
- *
- * Two classes of endpoints:
- *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
- *   - Admin paths require an API key (call `setApiKey(key)` first)
- */
-
-declare class SubscriptionsV2Client extends BaseV2Client {
-    /** List all subscriptions for the authenticated user. */
-    listMySubscriptions(siteName: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
-    /** Pause a subscription. */
-    pauseSubscription(siteName: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
-    /** Resume a paused subscription. */
-    resumeSubscription(siteName: string, subId: string): Promise<V2SiteUserSubscription>;
-    /** Cancel a subscription. */
-    cancelSubscription(siteName: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
-    /** Change the plan (price) of a subscription. */
-    changeSubscriptionPlan(siteName: string, subId: string, params: V2SubscriptionChangePlanParams): Promise<V2SiteUserSubscription>;
-    /** List subscriptions for a specific user (admin). */
-    listUserSubscriptions(siteName: string, userId: string, cachePolicy?: CachePolicy): Promise<V2List<V2SiteUserSubscription>>;
-    /** Pause a user's subscription (admin). */
-    pauseUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionPauseParams): Promise<V2SiteUserSubscription>;
-    /** Resume a user's paused subscription (admin). */
-    resumeUserSubscription(siteName: string, userId: string, subId: string): Promise<V2SiteUserSubscription>;
-    /** Cancel a user's subscription (admin). */
-    cancelUserSubscription(siteName: string, userId: string, subId: string, params?: V2SubscriptionCancelParams): Promise<V2CancelSubscriptionResult>;
-}
-
-/**
- * v2 Credits Client — balance queries and admin grant operations.
+ * v1 deprecation constants — kept in sync with the backend's
+ * `src/lib/deprecation.ts`.
  *
- * Two classes of endpoints:
- *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
- *   - Admin paths require an API key (call `setApiKey(key)` first)
+ * v1 sunsets 2026-06-01. All new integrations must use the v2 client.
  */
-
-declare class CreditsV2Client extends BaseV2Client {
-    /** Get the current credit balance for the authenticated user. */
-    getMyBalance(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
-    /** Get credit balance and transaction history for the authenticated user. */
-    getMyCredits(siteName: string, cachePolicy?: CachePolicy): Promise<V2CreditBalance>;
-    /** Get the credit balance for a specific user (admin). */
-    getUserBalance(siteName: string, userId: string): Promise<V2CreditBalance>;
-    /** Grant credit to a specific user (admin). */
-    grantCredit(siteName: string, userId: string, data: V2GrantCreditParams): Promise<V2GrantCreditResult>;
-}
+declare const V1_SUNSET_DATE = "2026-06-01";
+declare const V1_DEPRECATION_NOTICE: string;
 
 /**
- * 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 });
+ * Base client class for PerspectAPI SDK
  */
 
-interface PerspectApiV2Config extends PerspectApiConfig {
-    cache?: CacheConfig;
-}
-declare class PerspectApiV2Client {
-    private http;
-    readonly cache: CacheManager;
-    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;
-    readonly subscriptions: SubscriptionsV2Client;
-    readonly credits: CreditsV2Client;
-    constructor(config: PerspectApiV2Config);
-    /** 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;
-
 /**
- * Base client class for PerspectAPI SDK
+ * @deprecated v1 base client. v1 sunsets on 2026-06-01. Use
+ * `PerspectApiV2Client` / `createPerspectApiV2Client` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
-
 declare abstract class BaseClient {
     protected http: HttpClient;
     protected basePath: string;
@@ -2268,6 +81,10 @@ declare abstract class BaseClient {
  * Site user OTP methods are on SiteUsersClient.
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use
+ * `PerspectApiV2Client` / `createPerspectApiV2Client` for new integrations.
+ */
 declare class AuthClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2292,6 +109,10 @@ declare class AuthClient extends BaseClient {
  * Content Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.content`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class ContentClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2364,6 +185,10 @@ declare class ContentClient extends BaseClient {
  * API Keys Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.apiKeys` from
+ * `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class ApiKeysClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2431,6 +256,10 @@ declare class ApiKeysClient extends BaseClient {
  * Organizations Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use
+ * `client.organizations` from `PerspectApiV2Client`.
+ */
 declare class OrganizationsClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2506,6 +335,10 @@ declare class OrganizationsClient extends BaseClient {
  * Sites Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.sites`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class SitesClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2609,6 +442,10 @@ declare class SitesClient extends BaseClient {
  * Products Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.products`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class ProductsClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2817,6 +654,10 @@ declare class ProductsClient extends BaseClient {
  * Categories Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.categories`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class CategoriesClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -2887,6 +728,10 @@ declare class CategoriesClient extends BaseClient {
  * Webhooks Management client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.webhooks`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class WebhooksClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -3033,6 +878,10 @@ declare class WebhooksClient extends BaseClient {
  * Checkout/Stripe client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use v2 checkout/orders
+ * surfaces from `PerspectApiV2Client`.
+ */
 declare class CheckoutClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -3206,6 +1055,10 @@ declare class CheckoutClient extends BaseClient {
  * Contact Forms client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.contacts`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class ContactClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -3353,6 +1206,10 @@ declare class ContactClient extends BaseClient {
  * Newsletter subscription client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.newsletter`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class NewsletterClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -3465,6 +1322,10 @@ declare class NewsletterClient extends BaseClient {
  * Strict management surface under /newsletter/management/*
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.newsletter`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class NewsletterManagementClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     private managementEndpoint;
@@ -3628,6 +1489,10 @@ declare class NewsletterManagementClient extends BaseClient {
  * Handles per-site customer accounts (OTP-based auth, profiles, orders, subscriptions)
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use `client.siteUsers`
+ * from `PerspectApiV2Client` / `createPerspectApiV2Client`.
+ */
 declare class SiteUsersClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     /**
@@ -3910,6 +1775,7 @@ declare class SiteUsersClient extends BaseClient {
         fulfillment_status: string;
         tracking_number?: string;
         notes?: string;
+        notify_customer?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;
     }>>;
@@ -3972,6 +1838,10 @@ declare class SiteUsersClient extends BaseClient {
  * Bundles & Collections client for PerspectAPI SDK
  */
 
+/**
+ * @deprecated v1 client. v1 sunsets on 2026-06-01. Use v2 collections and
+ * products clients from `PerspectApiV2Client`.
+ */
 declare class BundlesClient extends BaseClient {
     constructor(http: any, cache?: CacheManager);
     getBundleGroups(siteName: string, productId: number, cachePolicy?: CachePolicy): Promise<ApiResponse<ProductBundleGroup[]>>;
@@ -4009,7 +1879,7 @@ declare class BundlesClient extends BaseClient {
 /**
  * @deprecated v1 client is deprecated and sunsets 2026-06-01. New
  * integrations must use `PerspectApiV2Client` / `createPerspectApiV2Client`
- * from `perspectapi-ts-sdk` (see the `v2-client` reference page).
+ * from `perspectapi-ts-sdk/v2` (see the `v2-client` reference page).
  */
 declare class PerspectApiClient {
     private http;
@@ -4113,7 +1983,7 @@ declare class PerspectApiClient {
  * Create a new PerspectAPI client instance.
  *
  * @deprecated v1 factory is deprecated and sunsets 2026-06-01. Use
- * `createPerspectApiV2Client` for new integrations.
+ * `createPerspectApiV2Client` from `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function createPerspectApiClient(config: PerspectApiConfig): PerspectApiClient;
 
@@ -4383,6 +2253,11 @@ declare function transformMediaItem(baseUrl: string, media: {
  * High-level data loading helpers that wrap the PerspectAPI SDK clients.
  * These helpers provide convenient product and content loading utilities with
  * graceful fallbacks that can be reused across applications.
+ *
+ * @deprecated These helpers are tied to the v1 `PerspectApiClient` and
+ * `/api/v1` route shapes. v1 sunsets on 2026-06-01. New integrations should
+ * use `PerspectApiV2Client` / `createPerspectApiV2Client` from
+ * `perspectapi-ts-sdk/v2` and call v2 resource clients directly.
  */
 
 /**
@@ -4396,12 +2271,21 @@ interface LoaderLogger {
 }
 /**
  * Transform a PerspectAPI product payload into a friendlier shape for UI layers.
+ *
+ * @deprecated Legacy v1 payload transformer. Prefer v2 product response types
+ * from `perspectapi-ts-sdk/v2`.
  */
 declare const transformProduct: (perspectProduct: any, logger?: LoaderLogger) => Product;
 /**
  * Transform PerspectAPI content payload to a simplified BlogPost structure.
+ *
+ * @deprecated Legacy v1 payload transformer. Prefer v2 content response types
+ * from `perspectapi-ts-sdk/v2`.
  */
 declare const transformContent: (perspectContent: Content | (Content & Record<string, unknown>), logger?: LoaderLogger) => BlogPost;
+/**
+ * @deprecated v1 loader options. Use v2 resource clients directly.
+ */
 interface LoaderOptions {
     /**
      * Pre-configured PerspectAPI client. Pass null/undefined to force fallback behaviour.
@@ -4425,6 +2309,9 @@ interface LoaderOptions {
      */
     limit?: number;
 }
+/**
+ * @deprecated v1 loader options. Use `client.products` from v2 directly.
+ */
 interface LoadProductsOptions extends LoaderOptions {
     /**
      * Optional search term applied server-side.
@@ -4445,15 +2332,27 @@ interface LoadProductsOptions extends LoaderOptions {
 }
 /**
  * Load products for a site with graceful fallbacks.
+ *
+ * @deprecated Uses the v1 client. Use `client.products.list(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadProducts(options: LoadProductsOptions): Promise<Product[]>;
+/**
+ * @deprecated v1 loader options. Use `client.products` from v2 directly.
+ */
 interface LoadProductBySlugOptions extends LoaderOptions {
     slug: string;
 }
 /**
  * Load single product by slug.
+ *
+ * @deprecated Uses the v1 client. Use `client.products.get(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadProductBySlug(options: LoadProductBySlugOptions): Promise<Product | null>;
+/**
+ * @deprecated v1 loader options. Use `client.content` from v2 directly.
+ */
 interface LoadContentOptions extends LoaderOptions {
     /**
       * Additional query parameters for content filtering.
@@ -4467,34 +2366,61 @@ interface LoadContentOptions extends LoaderOptions {
 }
 /**
  * Load published pages for a site.
+ *
+ * @deprecated Uses the v1 client. Use `client.content.list(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadPages(options: LoadContentOptions): Promise<BlogPost[]>;
 /**
  * Load published blog posts for a site.
+ *
+ * @deprecated Uses the v1 client. Use `client.content.list(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadPosts(options: LoadContentOptions): Promise<BlogPost[]>;
+/**
+ * @deprecated v1 loader options. Use `client.content` from v2 directly.
+ */
 interface LoadContentBySlugOptions extends LoaderOptions {
     slug: string;
 }
 /**
  * Load a single content item (post or page) by slug.
+ *
+ * @deprecated Uses the v1 client. Use `client.content.get(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadContentBySlug(options: LoadContentBySlugOptions): Promise<BlogPost | null>;
+/**
+ * @deprecated v1 loader options. Use `client.content` from v2 directly.
+ */
 interface LoadBlockBySlugOptions extends LoaderOptions {
     slug: string;
 }
 /**
  * Load published blocks for a site.
+ *
+ * @deprecated Uses the v1 client. Use `client.content.list(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadBlocks(options: LoadContentOptions): Promise<BlogPost[]>;
 /**
  * Load a single block by slug.
+ *
+ * @deprecated Uses the v1 client. Use `client.content.get(...)` from
+ * `perspectapi-ts-sdk/v2` for new integrations.
  */
 declare function loadBlockBySlug(options: LoadBlockBySlugOptions): Promise<BlogPost | null>;
 /**
  * Load all published content (pages + posts).
+ *
+ * @deprecated Uses the v1 client. Use v2 `client.content` reads directly for
+ * new integrations.
  */
 declare function loadAllContent(options: LoaderOptions): Promise<BlogPost[]>;
+/**
+ * @deprecated v1 checkout helper options. Use v2 checkout/orders surfaces.
+ */
 interface CheckoutSessionOptions {
     client?: PerspectApiClient | null;
     siteName: string;
@@ -4537,9 +2463,12 @@ interface CheckoutSessionOptions {
 /**
  * Convenience helper that creates a checkout session by looking up Stripe price IDs
  * from product metadata. Falls back to gateway price IDs if Stripe IDs are missing.
+ *
+ * @deprecated Uses the v1 client. Use v2 checkout/orders surfaces for new
+ * integrations.
  */
 declare function createCheckoutSession(options: CheckoutSessionOptions): Promise<ApiResponse<CheckoutSession> | {
     error: string;
 }>;
 
-export { type AbClient, type AbForRequestResult, type AbVariantResult, type AddCollectionItemRequest, type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, BaseClient, type BlogPost, type BundleCollection, type BundleCollectionItem, type BundleCollectionItemWithProduct, BundlesClient, type CacheAdapter, type CacheConfig, CacheManager, type CancelSubscriptionRequest, type CancelSubscriptionResponse, CategoriesClient, type Category, type CategorySummary, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, CloudflareKVCacheAdapter, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, type ContentCategoryResponse, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateBundleCollectionRequest, type CreateBundleGroupRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreatePerspectAbOptions, type CreateProductRequest, type CreateProductSkuRequest, type CreateSiteRequest, type CreateWebhookRequest, type CreditBalance, type CreditBalanceWithTransactions, type CreditTransaction, DEFAULT_IMAGE_SIZES, type GrantCreditRequest, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type NewsletterCampaignDetail, type NewsletterCampaignListResponse, type NewsletterCampaignSummary, type NewsletterCampaignTestSendRequest, type NewsletterCampaignTestSendResponse, NewsletterClient, type NewsletterConfirmResponse, type NewsletterExportCreateRequest, type NewsletterExportCreateResponse, type NewsletterList, type NewsletterManagementCampaign, type NewsletterManagementCampaignListResponse, NewsletterManagementClient, type NewsletterManagementList, type NewsletterManagementListMembership, type NewsletterManagementPagination, type NewsletterManagementSeries, type NewsletterManagementStatsResponse, type NewsletterManagementSubscription, type NewsletterManagementSubscriptionsListResponse, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterSubscriptionImportRowRequest, type NewsletterSubscriptionMembershipUpdateRequest, type NewsletterSubscriptionSyncRequest, type NewsletterSubscriptionSyncResponse, type NewsletterSubscriptionsBulkAction, type NewsletterSubscriptionsBulkOutcome, type NewsletterSubscriptionsBulkUpdateRequest, type NewsletterSubscriptionsBulkUpdateResponse, type NewsletterSubscriptionsImportRequest, type NewsletterSubscriptionsImportResponse, type NewsletterSubscriptionsImportRowResult, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, type PerspectAb, PerspectApiClient, type PerspectApiConfig, PerspectApiError, PerspectApiV2Client, PerspectV2Error, type Product, type ProductBundleGroup, type ProductQueryParams, type ProductSku, type ProductSkuMediaItem, type ProductSkuOption, ProductsClient, type RequestOptions, type RequestOtpRequest, type ResponsiveImageSizes, type SetProfileValueRequest, type Site, type SiteUser, type SiteUserOrder, type SiteUserProfile, type SiteUserSubscription, SiteUsersClient, SitesClient, type SubscriptionCancellationMode, type UpdateApiKeyRequest, type UpdateContentRequest, type UpdateSiteUserRequest, type User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, type V2ApiKey, type V2CancelSubscriptionResult, type V2Category, type V2CategoryCreateParams, type V2CategoryUpdateParams, type V2Collection, type V2CollectionCreateParams, type V2CollectionItem, type V2CollectionUpdateParams, type V2ContactSubmission, type V2Content, type V2ContentCreateParams, type V2ContentListParams, type V2ContentUpdateParams, type V2CreditBalance, type V2CreditTransaction, type V2Deleted, type V2Error, type V2ErrorType, type V2GrantCreditParams, type V2GrantCreditResult, type V2List, type V2Media, type V2NewsletterCampaign, type V2NewsletterImportRequest, type V2NewsletterImportResult, type V2NewsletterList, type V2NewsletterListCreateParams, type V2NewsletterListUpdateParams, type V2NewsletterSubscription, type V2NewsletterSubscriptionListMembershipUpdate, type V2NewsletterSyncInput, type V2NewsletterSyncResult, type V2NewsletterTrackingResponse, type V2Object, type V2Order, type V2OrderAddress, type V2OrderCreateParams, type V2OrderCreateResult, type V2OrderFulfillmentUpdate, type V2OrderLineItem, type V2OrderLineItemPriceData, type V2OrderListParams, type V2OrderTaxRequest, type V2Organization, type V2PaginationParams, type V2Product, type V2ProductCreateParams, type V2ProductListParams, type V2ProductUpdateParams, type V2Site, type V2SiteUser, type V2SiteUserListParams, type V2SiteUserMeUpdateParams, type V2SiteUserProfile, type V2SiteUserSubscription, type V2SiteUserUpdateParams, type V2SiteUserWithProfile, type V2SubscriptionCancelParams, type V2SubscriptionChangePlanParams, type V2SubscriptionPauseParams, type V2Webhook, type V2WebhookCreateParams, type V2WebhookEventType, type V2WebhookUpdateParams, type VerifyOtpRequest, type VerifyOtpResponse, type Webhook, type WebhookEventType, WebhooksClient, bucketFor, buildImageUrl, createApiError, createCheckoutSession, createPerspectAb, createPerspectApiClient, createPerspectApiV2Client, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };
+export { type AbClient, type AbForRequestResult, type AbVariantResult, AddCollectionItemRequest, ApiKey, ApiKeysClient, ApiResponse, AuthClient, BaseClient, BlogPost, BundleCollection, BundleCollectionItem, BundleCollectionItemWithProduct, BundlesClient, CacheAdapter, CacheManager, CancelSubscriptionRequest, CancelSubscriptionResponse, CategoriesClient, Category, CheckoutAddress, CheckoutClient, CheckoutMetadata, CheckoutSession, type CheckoutSessionOptions, CheckoutTaxRequest, CloudflareKVCacheAdapter, ContactClient, ContactStatusResponse, ContactSubmission, ContactSubmitResponse, Content, ContentCategoryResponse, ContentClient, ContentQueryParams, CreateApiKeyRequest, CreateBundleCollectionRequest, CreateBundleGroupRequest, CreateCategoryRequest, CreateCheckoutSessionRequest, CreateContactRequest, CreateContentRequest, CreateNewsletterSubscriptionRequest, CreateOrganizationRequest, type CreatePerspectAbOptions, CreateProductRequest, CreateProductSkuRequest, CreateSiteRequest, CreateWebhookRequest, CreditBalance, CreditBalanceWithTransactions, DEFAULT_IMAGE_SIZES, GrantCreditRequest, HttpClient, type ImageTransformOptions, InMemoryCacheAdapter, type LoadBlockBySlugOptions, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, NewsletterCampaignDetail, NewsletterCampaignListResponse, NewsletterCampaignTestSendRequest, NewsletterCampaignTestSendResponse, NewsletterClient, NewsletterConfirmResponse, NewsletterExportCreateRequest, NewsletterExportCreateResponse, NewsletterList, NewsletterManagementCampaign, NewsletterManagementCampaignListResponse, NewsletterManagementClient, NewsletterManagementList, NewsletterManagementSeries, NewsletterManagementStatsResponse, NewsletterManagementSubscription, NewsletterManagementSubscriptionsListResponse, NewsletterPreferences, NewsletterStatusResponse, NewsletterSubscribeResponse, NewsletterSubscriptionMembershipUpdateRequest, NewsletterSubscriptionSyncRequest, NewsletterSubscriptionSyncResponse, NewsletterSubscriptionsBulkUpdateRequest, NewsletterSubscriptionsBulkUpdateResponse, NewsletterSubscriptionsImportRequest, NewsletterSubscriptionsImportResponse, NewsletterUnsubscribeRequest, NewsletterUnsubscribeResponse, NoopCacheAdapter, Organization, OrganizationsClient, PaginatedResponse, type PerspectAb, PerspectApiClient, PerspectApiConfig, Product, ProductBundleGroup, ProductQueryParams, ProductSku, ProductsClient, RequestOtpRequest, type ResponsiveImageSizes, Site, SiteUser, SiteUserOrder, SiteUserProfile, SiteUserSubscription, SiteUsersClient, SitesClient, UpdateApiKeyRequest, UpdateContentRequest, UpdateSiteUserRequest, User, V1_DEPRECATION_NOTICE, V1_SUNSET_DATE, VerifyOtpRequest, VerifyOtpResponse, Webhook, WebhooksClient, bucketFor, buildImageUrl, createCheckoutSession, createPerspectAb, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadBlockBySlug, loadBlocks, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct, variantForBucket };