perspectapi-ts-sdk 1.1.1

package/dist/index.d.ts

@@ -0,0 +1,1770 @@
+/**
+ * Core types and interfaces for PerspectAPI SDK
+ */
+interface ApiResponse<T = any> {
+    data?: T;
+    message?: string;
+    error?: string;
+    success?: boolean;
+}
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+}
+interface PaginatedResponse<T> extends ApiResponse<T[]> {
+    pagination?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+interface SignUpRequest {
+    email: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+}
+interface SignInRequest {
+    email: string;
+    password: string;
+}
+interface AuthResponse {
+    message: string;
+    user?: User;
+    token?: string;
+}
+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;
+}
+type ContentStatus = 'draft' | 'publish' | 'private' | 'trash';
+type ContentType = 'post' | 'page';
+interface Content {
+    id: number;
+    pageTitle: string;
+    pageContent: string;
+    contentMarkdown?: string;
+    custom?: Record<string, any>;
+    slug?: string;
+    pageStatus: ContentStatus;
+    pageType: ContentType;
+    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;
+}
+interface Category {
+    id: number;
+    name: string;
+    slug: string;
+    description?: string;
+    parentId?: number;
+    organizationId?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+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 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[][];
+    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 {
+    name: string;
+    description?: string;
+    price: number;
+    currency?: string;
+    sku?: string;
+    isActive?: boolean;
+}
+interface ProductQueryParams extends PaginationParams {
+    organizationId?: number;
+    isActive?: boolean;
+    search?: string;
+    category?: string | string[];
+    category_id?: number | string | Array<number | string>;
+}
+interface BlogPost {
+    id: string | number;
+    slug: string;
+    slug_prefix?: string;
+    page_type?: string;
+    title: string;
+    content?: string;
+    excerpt?: string;
+    image?: string;
+    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;
+}
+interface Webhook {
+    id: string;
+    name: string;
+    url: string;
+    provider: string;
+    events: string[];
+    isActive: boolean;
+    secret?: string;
+    organizationId?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateWebhookRequest {
+    name: string;
+    url: string;
+    provider: string;
+    events: string[];
+    isActive?: boolean;
+    secret?: string;
+}
+type CheckoutMetadataValue = string | number | boolean | null | CheckoutMetadataValue[] | {
+    [key: string]: CheckoutMetadataValue;
+};
+type CheckoutMetadata = Record<string, CheckoutMetadataValue>;
+interface CreateCheckoutSessionRequest {
+    priceId?: string;
+    quantity?: number;
+    line_items?: Array<{
+        price?: string;
+        quantity: 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;
+    metadata?: CheckoutMetadata;
+    mode?: 'payment' | 'subscription' | 'setup';
+    automatic_tax?: {
+        enabled: boolean;
+    };
+    shipping_address_collection?: {
+        allowed_countries: string[];
+    };
+    billing_address_collection?: 'auto' | 'required';
+}
+interface CheckoutSession {
+    id: string;
+    url: string;
+    status: string;
+}
+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;
+    turnstileToken?: string;
+}
+interface ApiError {
+    message: string;
+    code?: string;
+    status?: number;
+    details?: any;
+}
+interface PerspectApiConfig {
+    baseUrl: string;
+    apiKey?: string;
+    jwt?: string;
+    timeout?: number;
+    retries?: number;
+    headers?: Record<string, string>;
+}
+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;
+}
+
+/**
+ * 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;
+    /**
+     * 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): Promise<ApiResponse<T>>;
+    /**
+     * PUT request
+     */
+    put<T = any>(endpoint: string, body?: any): Promise<ApiResponse<T>>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(endpoint: string): Promise<ApiResponse<T>>;
+    /**
+     * PATCH request
+     */
+    patch<T = any>(endpoint: string, body?: any): 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;
+
+/**
+ * Base client class for PerspectAPI SDK
+ */
+
+declare abstract class BaseClient {
+    protected http: HttpClient;
+    protected basePath: string;
+    constructor(http: HttpClient, basePath: string);
+    /**
+     * Build a site-scoped endpoint relative to the API base path
+     */
+    protected siteScopedEndpoint(siteName: string, endpoint?: string, options?: {
+        includeSitesSegment?: boolean;
+    }): string;
+    /**
+     * Build endpoint path
+     */
+    protected buildPath(endpoint: string): string;
+    /**
+     * Handle paginated responses
+     */
+    protected getPaginated<T>(endpoint: string, params?: Record<string, any>): Promise<ApiResponse<T[]>>;
+    /**
+     * Handle single resource responses
+     */
+    protected getSingle<T>(endpoint: string): Promise<ApiResponse<T>>;
+    /**
+     * Handle create operations
+     */
+    protected create<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    /**
+     * Handle update operations
+     */
+    protected update<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    /**
+     * Handle partial update operations
+     */
+    protected patch<T, R = T>(endpoint: string, data: T): Promise<ApiResponse<R>>;
+    /**
+     * Handle delete operations
+     */
+    protected delete<T = any>(endpoint: string): Promise<ApiResponse<T>>;
+}
+
+/**
+ * Authentication client for PerspectAPI SDK
+ */
+
+declare class AuthClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get CSRF token
+     */
+    getCsrfToken(): Promise<ApiResponse<{
+        token: string;
+    }>>;
+    /**
+     * Sign up a new user
+     */
+    signUp(data: SignUpRequest): Promise<ApiResponse<{
+        message: string;
+        userId: string;
+    }>>;
+    /**
+     * Sign in user
+     */
+    signIn(data: SignInRequest): Promise<ApiResponse<AuthResponse>>;
+    /**
+     * Activate user account
+     */
+    activateAccount(activationKey: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Request password reset
+     */
+    forgotPassword(email: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Reset password with token
+     */
+    resetPassword(resetToken: string, password: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get current user profile
+     */
+    getUserProfile(): Promise<ApiResponse<{
+        user: User;
+    }>>;
+    /**
+     * Sign out (clear local auth)
+     */
+    signOut(): void;
+}
+
+/**
+ * Content Management client for PerspectAPI SDK
+ */
+
+declare class ContentClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all content with pagination and filtering for a site
+     */
+    getContent(siteName: string, params?: ContentQueryParams): Promise<PaginatedResponse<Content>>;
+    /**
+     * Get content by ID
+     */
+    getContentById(id: number): Promise<ApiResponse<Content>>;
+    /**
+     * Get content by slug for a site
+     */
+    getContentBySlug(siteName: string, slug: string): Promise<ApiResponse<Content>>;
+    /**
+     * Create new content
+     */
+    createContent(data: CreateContentRequest): Promise<ApiResponse<Content>>;
+    /**
+     * Update content
+     */
+    updateContent(id: number, data: UpdateContentRequest): Promise<ApiResponse<Content>>;
+    /**
+     * Partially update content
+     */
+    patchContent(id: number, data: Partial<UpdateContentRequest>): Promise<ApiResponse<Content>>;
+    /**
+     * Delete content
+     */
+    deleteContent(id: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Publish content
+     */
+    publishContent(id: number): Promise<ApiResponse<Content>>;
+    /**
+     * Unpublish content
+     */
+    unpublishContent(id: number): Promise<ApiResponse<Content>>;
+    /**
+     * Move content to trash
+     */
+    trashContent(id: number): Promise<ApiResponse<Content>>;
+    /**
+     * Restore content from trash
+     */
+    restoreContent(id: number): Promise<ApiResponse<Content>>;
+    /**
+     * Get content revisions
+     */
+    getContentRevisions(id: number): Promise<ApiResponse<Content[]>>;
+    /**
+     * Duplicate content
+     */
+    duplicateContent(id: number): Promise<ApiResponse<Content>>;
+}
+
+/**
+ * API Keys Management client for PerspectAPI SDK
+ */
+
+declare class ApiKeysClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all API keys
+     */
+    getApiKeys(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<ApiKey>>;
+    /**
+     * Get API key by ID
+     */
+    getApiKeyById(id: string): Promise<ApiResponse<ApiKey>>;
+    /**
+     * Create new API key
+     */
+    createApiKey(data: CreateApiKeyRequest): Promise<ApiResponse<ApiKey & {
+        key: string;
+    }>>;
+    /**
+     * Update API key
+     */
+    updateApiKey(id: string, data: UpdateApiKeyRequest): Promise<ApiResponse<ApiKey>>;
+    /**
+     * Delete API key
+     */
+    deleteApiKey(id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Regenerate API key
+     */
+    regenerateApiKey(id: string): Promise<ApiResponse<ApiKey & {
+        key: string;
+    }>>;
+    /**
+     * Activate API key
+     */
+    activateApiKey(id: string): Promise<ApiResponse<ApiKey>>;
+    /**
+     * Deactivate API key
+     */
+    deactivateApiKey(id: string): Promise<ApiResponse<ApiKey>>;
+    /**
+     * Get API key usage statistics
+     */
+    getApiKeyStats(id: string): Promise<ApiResponse<{
+        totalRequests: number;
+        requestsToday: number;
+        requestsThisMonth: number;
+        lastUsedAt?: string;
+    }>>;
+    /**
+     * Test API key validity
+     */
+    testApiKey(key: string): Promise<ApiResponse<{
+        valid: boolean;
+        keyId?: string;
+        permissions?: string[];
+        expiresAt?: string;
+    }>>;
+}
+
+/**
+ * Organizations Management client for PerspectAPI SDK
+ */
+
+declare class OrganizationsClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all organizations
+     */
+    getOrganizations(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Organization>>;
+    /**
+     * Get organization by ID
+     */
+    getOrganizationById(id: number): Promise<ApiResponse<Organization>>;
+    /**
+     * Create new organization
+     */
+    createOrganization(data: CreateOrganizationRequest): Promise<ApiResponse<Organization>>;
+    /**
+     * Update organization
+     */
+    updateOrganization(id: number, data: Partial<CreateOrganizationRequest>): Promise<ApiResponse<Organization>>;
+    /**
+     * Delete organization
+     */
+    deleteOrganization(id: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get organization members
+     */
+    getOrganizationMembers(id: number): Promise<ApiResponse<Array<{
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        role: string;
+        joinedAt: string;
+    }>>>;
+    /**
+     * Add member to organization
+     */
+    addOrganizationMember(id: number, data: {
+        email: string;
+        role: string;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Update organization member role
+     */
+    updateOrganizationMember(id: number, userId: string, data: {
+        role: string;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Remove member from organization
+     */
+    removeOrganizationMember(id: number, userId: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get organization settings
+     */
+    getOrganizationSettings(id: number): Promise<ApiResponse<Record<string, any>>>;
+    /**
+     * Update organization settings
+     */
+    updateOrganizationSettings(id: number, settings: Record<string, any>): Promise<ApiResponse<Record<string, any>>>;
+}
+
+/**
+ * Sites Management client for PerspectAPI SDK
+ */
+
+declare class SitesClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all sites
+     */
+    getSites(params?: {
+        page?: number;
+        limit?: number;
+        organizationId?: number;
+    }): Promise<PaginatedResponse<Site>>;
+    /**
+     * Get site by ID
+     */
+    getSiteById(id: number): Promise<ApiResponse<Site>>;
+    /**
+     * Get site by name
+     */
+    getSiteByName(name: string): Promise<ApiResponse<Site>>;
+    /**
+     * Create new site
+     */
+    createSite(data: CreateSiteRequest): Promise<ApiResponse<Site>>;
+    /**
+     * Update site
+     */
+    updateSite(id: number, data: Partial<CreateSiteRequest>): Promise<ApiResponse<Site>>;
+    /**
+     * Delete site
+     */
+    deleteSite(id: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Activate site
+     */
+    activateSite(id: number): Promise<ApiResponse<Site>>;
+    /**
+     * Deactivate site
+     */
+    deactivateSite(id: number): Promise<ApiResponse<Site>>;
+    /**
+     * Get site configuration
+     */
+    getSiteConfig(id: number): Promise<ApiResponse<Record<string, any>>>;
+    /**
+     * Update site configuration
+     */
+    updateSiteConfig(id: number, config: Record<string, any>): Promise<ApiResponse<Record<string, any>>>;
+    /**
+     * Get site analytics
+     */
+    getSiteAnalytics(id: number, params?: {
+        startDate?: string;
+        endDate?: string;
+        metrics?: string[];
+    }): Promise<ApiResponse<{
+        pageViews: number;
+        uniqueVisitors: number;
+        bounceRate: number;
+        avgSessionDuration: number;
+        topPages: Array<{
+            path: string;
+            views: number;
+        }>;
+    }>>;
+    /**
+     * Get site domains
+     */
+    getSiteDomains(id: number): Promise<ApiResponse<Array<{
+        domain: string;
+        isPrimary: boolean;
+        isVerified: boolean;
+        createdAt: string;
+    }>>>;
+    /**
+     * Add domain to site
+     */
+    addSiteDomain(id: number, data: {
+        domain: string;
+        isPrimary?: boolean;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Remove domain from site
+     */
+    removeSiteDomain(id: number, domain: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Verify domain ownership
+     */
+    verifySiteDomain(id: number, domain: string): Promise<ApiResponse<{
+        verified: boolean;
+        verificationMethod: string;
+        verificationValue: string;
+    }>>;
+}
+
+/**
+ * Products Management client for PerspectAPI SDK
+ */
+
+declare class ProductsClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all products for a site
+     */
+    getProducts(siteName: string, params?: ProductQueryParams): Promise<PaginatedResponse<Product>>;
+    /**
+     * Get product by ID
+     */
+    getProductById(id: number): Promise<ApiResponse<Product>>;
+    /**
+     * Get product by SKU
+     */
+    getProductBySku(sku: string): Promise<ApiResponse<Product>>;
+    /**
+     * Get product by slug and site name
+     */
+    getProductBySlug(siteName: string, slug: string): Promise<ApiResponse<Product & {
+        variants?: any[];
+    }>>;
+    /**
+     * Create new product
+     */
+    createProduct(data: CreateProductRequest): Promise<ApiResponse<Product>>;
+    /**
+     * Update product
+     */
+    updateProduct(id: number, data: Partial<CreateProductRequest>): Promise<ApiResponse<Product>>;
+    /**
+     * Delete product
+     */
+    deleteProduct(id: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Activate product
+     */
+    activateProduct(id: number): Promise<ApiResponse<Product>>;
+    /**
+     * Deactivate product
+     */
+    deactivateProduct(id: number): Promise<ApiResponse<Product>>;
+    /**
+     * Get product variants
+     */
+    getProductVariants(id: number): Promise<ApiResponse<Array<{
+        id: number;
+        name: string;
+        sku: string;
+        price: number;
+        inventory: number;
+        attributes: Record<string, any>;
+    }>>>;
+    /**
+     * Add product variant
+     */
+    addProductVariant(id: number, data: {
+        name: string;
+        sku: string;
+        price: number;
+        inventory?: number;
+        attributes?: Record<string, any>;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Update product variant
+     */
+    updateProductVariant(id: number, variantId: number, data: {
+        name?: string;
+        sku?: string;
+        price?: number;
+        inventory?: number;
+        attributes?: Record<string, any>;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Delete product variant
+     */
+    deleteProductVariant(id: number, variantId: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get product inventory
+     */
+    getProductInventory(id: number): Promise<ApiResponse<{
+        totalStock: number;
+        availableStock: number;
+        reservedStock: number;
+        lowStockThreshold: number;
+        isLowStock: boolean;
+    }>>;
+    /**
+     * Update product inventory
+     */
+    updateProductInventory(id: number, data: {
+        quantity: number;
+        operation: 'add' | 'subtract' | 'set';
+        reason?: string;
+    }): Promise<ApiResponse<{
+        message: string;
+        newQuantity: number;
+    }>>;
+    /**
+     * Get product categories
+     */
+    getProductCategories(id: number): Promise<ApiResponse<Array<{
+        id: number;
+        name: string;
+        slug: string;
+    }>>>;
+    /**
+     * Add product to category
+     */
+    addProductToCategory(id: number, categoryId: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Remove product from category
+     */
+    removeProductFromCategory(id: number, categoryId: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get products by category slug
+     */
+    getProductsByCategorySlug(siteName: string, categorySlug: string, params?: {
+        page?: number;
+        limit?: number;
+        published?: boolean;
+        search?: string;
+    }): Promise<ApiResponse<{
+        data: Product[];
+        category: {
+            id: number;
+            name: string;
+            slug: string;
+            description?: string;
+        };
+        meta: {
+            count: number;
+            limit?: number;
+            offset?: number;
+        };
+    }>>;
+}
+
+/**
+ * Categories Management client for PerspectAPI SDK
+ */
+
+declare class CategoriesClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all categories
+     */
+    getCategories(params?: {
+        page?: number;
+        limit?: number;
+        parentId?: number;
+        organizationId?: number;
+    }): Promise<PaginatedResponse<Category>>;
+    /**
+     * Get category by ID
+     */
+    getCategoryById(id: number): Promise<ApiResponse<Category>>;
+    /**
+     * Get category by slug
+     */
+    getCategoryBySlug(slug: string): Promise<ApiResponse<Category>>;
+    /**
+     * Get product category by slug (for products)
+     */
+    getProductCategoryBySlug(siteName: string, slug: string): Promise<ApiResponse<Category>>;
+    /**
+     * Create new category
+     */
+    createCategory(data: CreateCategoryRequest): Promise<ApiResponse<Category>>;
+    /**
+     * Update category
+     */
+    updateCategory(id: number, data: Partial<CreateCategoryRequest>): Promise<ApiResponse<Category>>;
+    /**
+     * Delete category
+     */
+    deleteCategory(id: number): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Get category tree (hierarchical structure)
+     */
+    getCategoryTree(rootId?: number): Promise<ApiResponse<Array<Category & {
+        children: Category[];
+    }>>>;
+    /**
+     * Get category children
+     */
+    getCategoryChildren(id: number): Promise<ApiResponse<Category[]>>;
+    /**
+     * Get category parent
+     */
+    getCategoryParent(id: number): Promise<ApiResponse<Category | null>>;
+    /**
+     * Move category to new parent
+     */
+    moveCategoryToParent(id: number, parentId: number | null): Promise<ApiResponse<Category>>;
+    /**
+     * Get category breadcrumb path
+     */
+    getCategoryBreadcrumb(id: number): Promise<ApiResponse<Array<{
+        id: number;
+        name: string;
+        slug: string;
+    }>>>;
+    /**
+     * Get category content/products
+     */
+    getCategoryContent(id: number, params?: {
+        page?: number;
+        limit?: number;
+        type?: 'content' | 'products' | 'all';
+    }): Promise<ApiResponse<{
+        content: any[];
+        products: any[];
+        total: number;
+    }>>;
+    /**
+     * Bulk update category order
+     */
+    updateCategoryOrder(updates: Array<{
+        id: number;
+        order: number;
+        parentId?: number;
+    }>): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Search categories
+     */
+    searchCategories(query: string, params?: {
+        limit?: number;
+        organizationId?: number;
+    }): Promise<ApiResponse<Category[]>>;
+}
+
+/**
+ * Webhooks Management client for PerspectAPI SDK
+ */
+
+declare class WebhooksClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get all webhooks
+     */
+    getWebhooks(params?: {
+        page?: number;
+        limit?: number;
+        provider?: string;
+        isActive?: boolean;
+    }): Promise<PaginatedResponse<Webhook>>;
+    /**
+     * Get webhook by ID
+     */
+    getWebhookById(id: string): Promise<ApiResponse<Webhook>>;
+    /**
+     * Create new webhook
+     */
+    createWebhook(data: CreateWebhookRequest): Promise<ApiResponse<Webhook>>;
+    /**
+     * Update webhook
+     */
+    updateWebhook(id: string, data: Partial<CreateWebhookRequest>): Promise<ApiResponse<Webhook>>;
+    /**
+     * Delete webhook
+     */
+    deleteWebhook(id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Activate webhook
+     */
+    activateWebhook(id: string): Promise<ApiResponse<Webhook>>;
+    /**
+     * Deactivate webhook
+     */
+    deactivateWebhook(id: string): Promise<ApiResponse<Webhook>>;
+    /**
+     * Test webhook
+     */
+    testWebhook(id: string, data?: any): Promise<ApiResponse<{
+        success: boolean;
+        statusCode: number;
+        response: any;
+        duration: number;
+    }>>;
+    /**
+     * Get webhook events
+     */
+    getWebhookEvents(id: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: 'pending' | 'processing' | 'completed' | 'failed';
+        startDate?: string;
+        endDate?: string;
+    }): Promise<PaginatedResponse<{
+        id: string;
+        eventType: string;
+        status: string;
+        payload: any;
+        response?: any;
+        attempts: number;
+        createdAt: string;
+        processedAt?: string;
+    }>>;
+    /**
+     * Get webhook logs
+     */
+    getWebhookLogs(id: string, params?: {
+        page?: number;
+        limit?: number;
+        level?: 'info' | 'warn' | 'error';
+        startDate?: string;
+        endDate?: string;
+    }): Promise<PaginatedResponse<{
+        id: string;
+        level: string;
+        message: string;
+        metadata?: any;
+        createdAt: string;
+    }>>;
+    /**
+     * Get webhook statistics
+     */
+    getWebhookStats(id?: string): Promise<ApiResponse<{
+        totalWebhooks: number;
+        activeWebhooks: number;
+        totalEvents: number;
+        successfulEvents: number;
+        failedEvents: number;
+        averageResponseTime: number;
+        eventsByProvider: Record<string, number>;
+        recentActivity: Array<{
+            date: string;
+            events: number;
+            successes: number;
+            failures: number;
+        }>;
+    }>>;
+    /**
+     * Get supported webhook providers
+     */
+    getWebhookProviders(): Promise<ApiResponse<Array<{
+        name: string;
+        displayName: string;
+        description: string;
+        supportedEvents: string[];
+        configurationFields: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            description: string;
+        }>;
+    }>>>;
+    /**
+     * Retry failed webhook event
+     */
+    retryWebhookEvent(webhookId: string, eventId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Bulk retry failed webhook events
+     */
+    bulkRetryWebhookEvents(webhookId: string, eventIds: string[]): Promise<ApiResponse<{
+        success: boolean;
+        retriedCount: number;
+        failedCount: number;
+    }>>;
+    /**
+     * Get webhook delivery attempts
+     */
+    getWebhookDeliveryAttempts(webhookId: string, eventId: string): Promise<ApiResponse<Array<{
+        id: string;
+        attempt: number;
+        statusCode: number;
+        response: any;
+        duration: number;
+        createdAt: string;
+    }>>>;
+}
+
+/**
+ * Checkout/Stripe client for PerspectAPI SDK
+ */
+
+declare class CheckoutClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Get CSRF token for a specific site
+     * @param siteName - The site name to get CSRF token for
+     */
+    getCsrfToken(siteName: string): Promise<ApiResponse<{
+        csrf_token: string;
+        site_id: string;
+        site_name: string;
+    }>>;
+    /**
+     * Create Stripe checkout session with CSRF protection
+     * @param siteName - The site name for the checkout session
+     * @param data - Checkout session data (can include priceId for single item or line_items for multiple)
+     * @param csrfToken - Optional CSRF token (if not provided, will fetch automatically)
+     */
+    createCheckoutSession(siteName: string, data: CreateCheckoutSessionRequest, csrfToken?: string): Promise<ApiResponse<CheckoutSession>>;
+    /**
+     * Get checkout session by ID
+     */
+    getCheckoutSession(sessionId: string): Promise<ApiResponse<{
+        id: string;
+        status: string;
+        paymentStatus: string;
+        customerEmail?: string;
+        amountTotal: number;
+        currency: string;
+        metadata?: Record<string, string>;
+        createdAt: string;
+        expiresAt: string;
+    }>>;
+    /**
+     * Get checkout sessions for organization
+     */
+    getCheckoutSessions(params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+        customerEmail?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ApiResponse<Array<{
+        id: string;
+        status: string;
+        paymentStatus: string;
+        customerEmail?: string;
+        amountTotal: number;
+        currency: string;
+        createdAt: string;
+    }>>>;
+    /**
+     * Cancel checkout session
+     */
+    cancelCheckoutSession(sessionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Expire checkout session
+     */
+    expireCheckoutSession(sessionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Get Stripe publishable key
+     */
+    getStripePublishableKey(): Promise<ApiResponse<{
+        publishableKey: string;
+        mode: 'test' | 'live';
+    }>>;
+    /**
+     * Create payment intent (for custom checkout flows)
+     */
+    createPaymentIntent(data: {
+        amount: number;
+        currency: string;
+        customerEmail?: string;
+        metadata?: Record<string, string>;
+        paymentMethodTypes?: string[];
+    }): Promise<ApiResponse<{
+        clientSecret: string;
+        id: string;
+        status: string;
+    }>>;
+    /**
+     * Confirm payment intent
+     */
+    confirmPaymentIntent(paymentIntentId: string, data: {
+        paymentMethodId: string;
+        returnUrl?: string;
+    }): Promise<ApiResponse<{
+        success: boolean;
+        status: string;
+        nextAction?: any;
+    }>>;
+    /**
+     * Get payment methods for customer
+     */
+    getPaymentMethods(customerId: string): Promise<ApiResponse<Array<{
+        id: string;
+        type: string;
+        card?: {
+            brand: string;
+            last4: string;
+            expMonth: number;
+            expYear: number;
+        };
+        createdAt: string;
+    }>>>;
+    /**
+     * Create customer
+     */
+    createCustomer(data: {
+        email: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }): Promise<ApiResponse<{
+        id: string;
+        email: string;
+        name?: string;
+        createdAt: string;
+    }>>;
+    /**
+     * Get customer by ID
+     */
+    getCustomer(customerId: string): Promise<ApiResponse<{
+        id: string;
+        email: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+        createdAt: string;
+    }>>;
+    /**
+     * Update customer
+     */
+    updateCustomer(customerId: string, data: {
+        email?: string;
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, string>;
+    }): Promise<ApiResponse<{
+        id: string;
+        email: string;
+        name?: string;
+        updatedAt: string;
+    }>>;
+    /**
+     * Get invoices for customer
+     */
+    getCustomerInvoices(customerId: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+    }): Promise<ApiResponse<Array<{
+        id: string;
+        number: string;
+        status: string;
+        amountPaid: number;
+        amountDue: number;
+        currency: string;
+        dueDate?: string;
+        createdAt: string;
+    }>>>;
+}
+
+/**
+ * Contact Forms client for PerspectAPI SDK
+ */
+
+declare class ContactClient extends BaseClient {
+    constructor(http: any);
+    /**
+     * Build a contact endpoint scoped to a site (without /sites prefix)
+     */
+    private contactEndpoint;
+    /**
+     * Submit contact form
+     */
+    submitContact(siteName: string, data: CreateContactRequest): Promise<ApiResponse<{
+        id: string;
+        message: string;
+        status: string;
+    }>>;
+    /**
+     * Get contact submission status
+     */
+    getContactStatus(siteName: string, id: string): Promise<ApiResponse<{
+        id: string;
+        status: string;
+        submittedAt: string;
+        processedAt?: string;
+    }>>;
+    /**
+     * Get all contact submissions (admin only)
+     */
+    getContactSubmissions(siteName: string, params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+        startDate?: string;
+        endDate?: string;
+        search?: string;
+    }): Promise<PaginatedResponse<ContactSubmission>>;
+    /**
+     * Get contact submission by ID (admin only)
+     */
+    getContactSubmissionById(siteName: string, id: string): Promise<ApiResponse<ContactSubmission & {
+        ipAddress?: string;
+        userAgent?: string;
+        metadata?: Record<string, any>;
+    }>>;
+    /**
+     * Update contact submission status (admin only)
+     */
+    updateContactStatus(siteName: string, id: string, status: string, notes?: string): Promise<ApiResponse<{
+        message: string;
+        status: string;
+    }>>;
+    /**
+     * Mark contact as read (admin only)
+     */
+    markContactAsRead(siteName: string, id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Mark contact as unread (admin only)
+     */
+    markContactAsUnread(siteName: string, id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Archive contact submission (admin only)
+     */
+    archiveContact(siteName: string, id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Delete contact submission (admin only)
+     */
+    deleteContact(siteName: string, id: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    /**
+     * Bulk update contact submissions (admin only)
+     */
+    bulkUpdateContacts(siteName: string, data: {
+        ids: string[];
+        status?: string;
+        action: 'mark_read' | 'mark_unread' | 'archive' | 'delete';
+    }): Promise<ApiResponse<{
+        success: boolean;
+        updatedCount: number;
+        failedCount: number;
+    }>>;
+    /**
+     * Get contact form statistics (admin only)
+     */
+    getContactStats(siteName: string, params?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ApiResponse<{
+        totalSubmissions: number;
+        unreadSubmissions: number;
+        readSubmissions: number;
+        archivedSubmissions: number;
+        submissionsByDay: Array<{
+            date: string;
+            count: number;
+        }>;
+        submissionsByStatus: Record<string, number>;
+        averageResponseTime?: number;
+    }>>;
+    /**
+     * Export contact submissions (admin only)
+     */
+    exportContacts(siteName: string, params?: {
+        format?: 'csv' | 'json' | 'xlsx';
+        startDate?: string;
+        endDate?: string;
+        status?: string;
+    }): Promise<ApiResponse<{
+        downloadUrl: string;
+        expiresAt: string;
+    }>>;
+    /**
+     * Get contact form configuration
+     */
+    getContactConfig(siteName: string): Promise<ApiResponse<{
+        turnstileEnabled: boolean;
+        rateLimitEnabled: boolean;
+        rateLimitWindow: number;
+        rateLimitMax: number;
+        requiredFields: string[];
+        customFields?: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            label: string;
+        }>;
+    }>>;
+    /**
+     * Update contact form configuration (admin only)
+     */
+    updateContactConfig(siteName: string, data: {
+        turnstileEnabled?: boolean;
+        rateLimitEnabled?: boolean;
+        rateLimitWindow?: number;
+        rateLimitMax?: number;
+        requiredFields?: string[];
+        customFields?: Array<{
+            name: string;
+            type: string;
+            required: boolean;
+            label: string;
+        }>;
+    }): Promise<ApiResponse<{
+        message: string;
+    }>>;
+}
+
+/**
+ * Main PerspectAPI SDK Client
+ * Cloudflare Workers compatible TypeScript SDK
+ */
+
+declare class PerspectApiClient {
+    private http;
+    readonly auth: AuthClient;
+    readonly content: ContentClient;
+    readonly apiKeys: ApiKeysClient;
+    readonly organizations: OrganizationsClient;
+    readonly sites: SitesClient;
+    readonly products: ProductsClient;
+    readonly categories: CategoriesClient;
+    readonly webhooks: WebhooksClient;
+    readonly checkout: CheckoutClient;
+    readonly contact: ContactClient;
+    constructor(config: PerspectApiConfig);
+    /**
+     * Update authentication token
+     */
+    setAuth(jwt: string): void;
+    /**
+     * Update API key
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Clear authentication
+     */
+    clearAuth(): void;
+    /**
+     * Health check endpoint
+     */
+    health(): Promise<ApiResponse<{
+        status: string;
+        timestamp: string;
+        version?: string;
+        uptime?: number;
+    }>>;
+    /**
+     * Get API version info
+     */
+    getVersion(): Promise<ApiResponse<{
+        version: string;
+        buildDate: string;
+        gitCommit?: string;
+    }>>;
+    /**
+     * Get API status and statistics
+     */
+    getStatus(): Promise<ApiResponse<{
+        status: string;
+        database: {
+            connected: boolean;
+            latency?: number;
+        };
+        cache: {
+            connected: boolean;
+            hitRate?: number;
+        };
+        queues: {
+            connected: boolean;
+            pendingJobs?: number;
+        };
+        uptime: number;
+        requestsPerMinute: number;
+    }>>;
+    /**
+     * Test API connectivity and authentication
+     */
+    test(): Promise<ApiResponse<{
+        success: boolean;
+        authenticated: boolean;
+        user?: {
+            id: string;
+            email: string;
+        };
+        permissions?: string[];
+        timestamp: string;
+    }>>;
+    /**
+     * Get CSRF token (for form submissions)
+     * @param siteName - Optional site name for site-specific token (recommended for development)
+     */
+    getCsrfToken(siteName?: string): Promise<ApiResponse<{
+        token?: string;
+        csrf_token?: string;
+        site_id?: string;
+        site_name?: string;
+    }>>;
+    /**
+     * Validate CSRF token
+     */
+    validateCsrfToken(token: string): Promise<ApiResponse<{
+        valid: boolean;
+        message?: string;
+    }>>;
+}
+/**
+ * Create a new PerspectAPI client instance
+ */
+declare function createPerspectApiClient(config: PerspectApiConfig): PerspectApiClient;
+
+/**
+ * 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.
+ */
+
+/**
+ * Logger interface so consumers can supply custom logging behaviour (or noop).
+ */
+interface LoaderLogger {
+    debug?(...args: unknown[]): void;
+    info?(...args: unknown[]): void;
+    warn?(...args: unknown[]): void;
+    error?(...args: unknown[]): void;
+}
+/**
+ * Transform a PerspectAPI product payload into a friendlier shape for UI layers.
+ */
+declare const transformProduct: (perspectProduct: any, logger?: LoaderLogger) => Product;
+/**
+ * Transform PerspectAPI content payload to a simplified BlogPost structure.
+ */
+declare const transformContent: (perspectContent: Content | (Content & Record<string, unknown>)) => BlogPost;
+interface LoaderOptions {
+    /**
+     * Pre-configured PerspectAPI client. Pass null/undefined to force fallback behaviour.
+     */
+    client?: PerspectApiClient | null;
+    /**
+     * Site name used for API calls and fallback data generation.
+     */
+    siteName: string;
+    /**
+     * Optional logger to capture debug/warn/error output.
+     */
+    logger?: LoaderLogger;
+    /**
+     * Optional fallback datasets.
+     */
+    fallbackProducts?: Product[];
+    fallbackPosts?: BlogPost[];
+    /**
+     * Limit for list fetching (defaults to 100).
+     */
+    limit?: number;
+}
+interface LoadProductsOptions extends LoaderOptions {
+    /**
+     * Optional search term applied server-side.
+     */
+    search?: string;
+    /**
+     * Offset for manual pagination.
+     */
+    offset?: number;
+    /**
+     * Filter products by category name (case-insensitive). Accepts a single name or multiple names.
+     */
+    category?: string | string[];
+    /**
+     * Filter products by category IDs (mixed string/number values supported).
+     */
+    categoryIds?: Array<number | string>;
+}
+/**
+ * Load products for a site with graceful fallbacks.
+ */
+declare function loadProducts(options: LoadProductsOptions): Promise<Product[]>;
+interface LoadProductBySlugOptions extends LoaderOptions {
+    slug: string;
+}
+/**
+ * Load single product by slug.
+ */
+declare function loadProductBySlug(options: LoadProductBySlugOptions): Promise<Product | null>;
+interface LoadContentOptions extends LoaderOptions {
+    /**
+      * Additional query parameters for content filtering.
+      */
+    params?: Partial<{
+        page_status: string;
+        page_type: string;
+        limit: number;
+        search: string;
+    }>;
+}
+/**
+ * Load published pages for a site.
+ */
+declare function loadPages(options: LoadContentOptions): Promise<BlogPost[]>;
+/**
+ * Load published blog posts for a site.
+ */
+declare function loadPosts(options: LoadContentOptions): Promise<BlogPost[]>;
+interface LoadContentBySlugOptions extends LoaderOptions {
+    slug: string;
+}
+/**
+ * Load a single content item (post or page) by slug.
+ */
+declare function loadContentBySlug(options: LoadContentBySlugOptions): Promise<BlogPost | null>;
+/**
+ * Load all published content (pages + posts).
+ */
+declare function loadAllContent(options: LoaderOptions): Promise<BlogPost[]>;
+interface CheckoutSessionOptions {
+    client?: PerspectApiClient | null;
+    siteName: string;
+    items: Array<{
+        productId: string;
+        quantity: number;
+    }>;
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    mode?: 'live' | 'test';
+    logger?: LoaderLogger;
+    fallbackProducts?: Product[];
+    metadata?: CheckoutMetadata;
+    /**
+     * Optional resolver to convert a product record into a Stripe price ID.
+     */
+    priceIdResolver?: (product: Product, mode: 'live' | 'test') => string | undefined;
+}
+/**
+ * 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.
+ */
+declare function createCheckoutSession(options: CheckoutSessionOptions): Promise<ApiResponse<CheckoutSession> | {
+    error: string;
+}>;
+
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, ContactClient, type ContactSubmission, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, HttpClient, type HttpMethod, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformProduct };