perspectapi-ts-sdk 6.5.9 → 7.0.1

package/dist/index-BL9-AZpq.d.mts

@@ -0,0 +1,2227 @@
+/**
+ * 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;
+    fulfillment_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;
+    /** When true, a terminal fulfillment status triggers a customer email. */
+    notify_customer?: boolean;
+}
+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 V2SubscriptionChargeParams {
+    amount_cents: number;
+    currency?: string;
+    description?: string;
+    idempotency_key: string;
+    metadata?: Record<string, string>;
+}
+interface V2SubscriptionChargeResult {
+    object: "subscription_charge";
+    provider_invoice_id: string | null;
+    provider_invoice_item_id: string | null;
+    provider_payment_intent_id: string | null;
+    status: string | null;
+    paid: boolean;
+    amount_due: number | null;
+    amount_paid: number | null;
+    currency: 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'>, cachePolicy?: CachePolicy): 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.
+     *
+     * Set `notify_customer: true` when moving the order into a terminal
+     * fulfillment state to send the customer fulfillment email.
+     */
+    updateFulfillment(siteName: string, id: string, data: V2OrderFulfillmentUpdate): Promise<V2Order>;
+    private withOrderTags;
+    private buildOrderTags;
+    private normalizeTagPart;
+}
+
+/**
+ * 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>;
+}
+
+/**
+ * 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>;
+    /** Charge a user's subscription once (admin). */
+    chargeUserSubscription(siteName: string, userId: string, subId: string, params: V2SubscriptionChargeParams): Promise<V2SubscriptionChargeResult>;
+}
+
+/**
+ * v2 Credits Client — balance queries and admin grant operations.
+ *
+ * Two classes of endpoints:
+ *   - /me paths require a site-user JWT (call `setAuth(jwt)` first)
+ *   - Admin paths require an API key (call `setApiKey(key)` first)
+ */
+
+declare class CreditsV2Client extends BaseV2Client {
+    /** Get the current credit balance for the authenticated user. */
+    getMyBalance(siteName: string, 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>;
+}
+
+/**
+ * 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 });
+ */
+
+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;
+
+export { type NewsletterManagementList as $, type ApiResponse as A, type CreateNewsletterSubscriptionRequest as B, CacheManager as C, type NewsletterConfirmResponse as D, type NewsletterUnsubscribeRequest as E, type NewsletterUnsubscribeResponse as F, type NewsletterPreferences as G, HttpClient as H, type NewsletterList as I, type NewsletterCampaignListResponse as J, type NewsletterCampaignDetail as K, type NewsletterStatusResponse as L, type NewsletterManagementSubscriptionsListResponse as M, type NewsletterSubscribeResponse as N, type Organization as O, type PaginatedResponse as P, type NewsletterManagementSubscription as Q, type NewsletterSubscriptionSyncRequest as R, type Site as S, type NewsletterSubscriptionSyncResponse as T, type User as U, type NewsletterSubscriptionsBulkUpdateRequest as V, type Webhook as W, type NewsletterSubscriptionsBulkUpdateResponse as X, type NewsletterSubscriptionMembershipUpdateRequest as Y, type NewsletterSubscriptionsImportRequest as Z, type NewsletterSubscriptionsImportResponse as _, type CachePolicy as a, type V2ContentListParams as a$, type NewsletterManagementSeries as a0, type NewsletterManagementCampaignListResponse as a1, type NewsletterManagementCampaign as a2, type NewsletterCampaignTestSendRequest as a3, type NewsletterCampaignTestSendResponse as a4, type NewsletterManagementStatsResponse as a5, type NewsletterExportCreateRequest as a6, type NewsletterExportCreateResponse as a7, type RequestOtpRequest as a8, type VerifyOtpRequest as a9, PerspectV2Error as aA, createApiError as aB, PerspectApiError as aC, type CacheConfig as aD, type ApiError as aE, type MediaItem as aF, type CategorySummary as aG, type PaymentGateway as aH, type NewsletterSubscription as aI, type NewsletterCampaignSummary as aJ, type NewsletterManagementListMembership as aK, type NewsletterSubscriptionsBulkAction as aL, type NewsletterSubscriptionsBulkOutcome as aM, type NewsletterSubscriptionImportRowRequest as aN, type NewsletterSubscriptionsImportRowResult as aO, type NewsletterManagementPagination as aP, type SetProfileValueRequest as aQ, type V2Object as aR, type V2List as aS, type V2Deleted as aT, type V2Error as aU, type V2ErrorType as aV, type V2PaginationParams as aW, type V2Media as aX, type V2Content as aY, type V2ContentCreateParams as aZ, type V2ContentUpdateParams as a_, type VerifyOtpResponse as aa, type SiteUser as ab, type SiteUserProfile as ac, type UpdateSiteUserRequest as ad, type SiteUserOrder as ae, type SiteUserSubscription as af, type CancelSubscriptionRequest as ag, type CancelSubscriptionResponse as ah, type CreditBalance as ai, type CreditBalanceWithTransactions as aj, type GrantCreditRequest as ak, type ProductBundleGroup as al, type CreateBundleGroupRequest as am, type BundleCollection as an, type BundleCollectionItemWithProduct as ao, type CreateBundleCollectionRequest as ap, type AddCollectionItemRequest as aq, type BundleCollectionItem as ar, type PerspectApiConfig as as, type CacheAdapter as at, type BlogPost as au, type CheckoutMetadata as av, type CheckoutAddress as aw, type CheckoutTaxRequest as ax, PerspectApiV2Client as ay, createPerspectApiV2Client as az, type CacheInvalidateOptions as b, type CheckoutMetadataValue as b$, type V2Product as b0, type V2ProductCreateParams as b1, type V2ProductUpdateParams as b2, type V2ProductListParams as b3, type V2Category as b4, type V2CategoryCreateParams as b5, type V2CategoryUpdateParams as b6, type V2Collection as b7, type V2CollectionItem as b8, type V2CollectionCreateParams as b9, type V2NewsletterImportResult as bA, type V2ContactSubmission as bB, type V2Organization as bC, type V2Site as bD, type V2ApiKey as bE, type V2WebhookEventType as bF, type V2Webhook as bG, type V2WebhookCreateParams as bH, type V2WebhookUpdateParams as bI, type V2SiteUserSubscription as bJ, type V2SubscriptionPauseParams as bK, type V2SubscriptionCancelParams as bL, type V2SubscriptionChangePlanParams as bM, type V2SubscriptionChargeParams as bN, type V2SubscriptionChargeResult as bO, type V2CancelSubscriptionResult as bP, type V2CreditTransaction as bQ, type V2CreditBalance as bR, type V2GrantCreditParams as bS, type V2GrantCreditResult as bT, type PaginationParams as bU, type ContentStatus as bV, type ContentType as bW, type ProductSkuMediaItem as bX, type ProductSkuOption as bY, type CreatePaymentGatewayRequest as bZ, type WebhookEventType as b_, type V2CollectionUpdateParams as ba, type V2Order as bb, type V2OrderListParams as bc, type V2OrderLineItemPriceData as bd, type V2OrderLineItem as be, type V2OrderAddress as bf, type V2OrderTaxRequest as bg, type V2OrderCreateParams as bh, type V2OrderFulfillmentUpdate as bi, type V2OrderCreateResult as bj, type V2SiteUser as bk, type V2SiteUserUpdateParams as bl, type V2SiteUserMeUpdateParams as bm, type V2SiteUserListParams as bn, type V2SiteUserWithProfile as bo, type V2SiteUserProfile as bp, type V2NewsletterSubscription as bq, type V2NewsletterList as br, type V2NewsletterCampaign as bs, type V2NewsletterTrackingResponse as bt, type V2NewsletterListCreateParams as bu, type V2NewsletterListUpdateParams as bv, type V2NewsletterSyncInput as bw, type V2NewsletterSyncResult as bx, type V2NewsletterSubscriptionListMembershipUpdate as by, type V2NewsletterImportRequest as bz, type ContentQueryParams as c, type CheckoutTaxStrategy as c0, type CheckoutTaxExemptionStatus as c1, type CheckoutTaxCustomerExemptionRequest as c2, type CheckoutTaxBreakdownItem as c3, type CheckoutSessionTax as c4, type SubscriptionCancellationMode as c5, type CreditTransaction as c6, type HttpMethod as c7, type RequestOptions as c8, type PerspectApiV2Config as c9, BaseV2Client as ca, ContentV2Client as cb, ProductsV2Client as cc, CategoriesV2Client as cd, CollectionsV2Client as ce, OrdersV2Client as cf, SiteUsersV2Client as cg, NewsletterV2Client as ch, ContactsV2Client as ci, OrganizationsV2Client as cj, SitesV2Client as ck, ApiKeysV2Client as cl, WebhooksV2Client as cm, SubscriptionsV2Client as cn, CreditsV2Client as co, type Content as d, type ContentCategoryResponse as e, type CreateContentRequest as f, type UpdateContentRequest as g, type ApiKey as h, type CreateApiKeyRequest as i, type UpdateApiKeyRequest as j, type CreateOrganizationRequest as k, type CreateSiteRequest as l, type ProductQueryParams as m, type Product as n, type CreateProductRequest as o, type ProductSku as p, type CreateProductSkuRequest as q, type Category as r, type CreateCategoryRequest as s, type CreateWebhookRequest as t, type CreateCheckoutSessionRequest as u, type CheckoutSession as v, type CreateContactRequest as w, type ContactSubmitResponse as x, type ContactStatusResponse as y, type ContactSubmission as z };