interface GetTemplateUrlResponse {
    templateUrl: string | null    // Presigned URL for the template file (expires in 1 hour)
    templateId: string | null     // Unique template identifier
    documentName: string | null   // Name of the document
    _raw: object                  // Full API response (for debugging)
}

interface GetDocumentSourcesResponse {
    sources: Array<{
        documentSourceId: string | null    // Unique identifier of the source record
        documentSourceName: string | null  // Human-readable display name of the source
        referencedText: string | null      // Exact excerpt used to generate the section
        _raw: object                       // Full API response for this source
    }>
}

interface GetDocumentSourceUrlResponse {
    documentSourceUrl: string | null    // Presigned URL to the original source document
    _raw: object                        // Full API response (for debugging)
}

interface GetSectionFromTextResponse {
    sectionId: string | null    // ID of the section containing the highlighted text
    _raw: object                // Full API response (for debugging)
}

interface GetDocumentSectionsResponse {
    sections: Array<{
        sectionId: string | null       // Unique identifier of the section
        sectionTitle: string | null    // Human-readable title of the section
        sectionOrder: number | null    // Display order within the document
        _raw: object                   // Full API response for this section
    }>
}

interface GenerateProxyUrlResponse {
    blob: Blob          // The file content as a Blob
    contentType: string // The content type (e.g. 'application/pdf')
    proxyUrl: string    // The proxy URL used to fetch the file
}

interface GetDocumentPresignedUrlResponse {
    documentUrl: string | null    // Presigned URL for downloading the document file
    _raw: object                  // Full API response (for debugging)
}

interface GetSectionRulesResponse {
    sectionId: string                // The MRT section ID
    rules: SectionRule[]             // Array of rules with resolved source data
}

interface SectionRule {
    ruleId: string | null                   // Unique rule identifier
    ruleType: string | null                 // Rule type (see Rule Types below)
    ruleMode: string | null                 // "dynamic" or "static"
    description: string | null              // Human-readable rule description
    explanation: string | null              // How the rule was applied
    generatedContent: string | null         // The content produced by this rule
    confidenceScore: number | null          // 0-1 confidence score
    orderIndex: number | null               // Execution order within the section (0-based)
    ruleTemplateText: string | null         // Original template text the rule refers to
    templateUrl: string | null              // Presigned URL for the template file (template rules only)
    breadcrumbs: RuleBreadcrumbs | null     // Generation/processing trace (see Breadcrumbs Reference)
    ruleMetadata: RuleMetadata | null       // Structured rule metadata (see Rule Metadata Reference)
    sourceChunk: RuleSourceChunk | null     // Single source chunk (copy_paste/summarize rules)
    sourceChunks: RuleSourceChunk[]         // Multiple source chunks (template rules)
    table: RuleTable | null                 // Associated table data (table rules)
    _raw: Record<string, any>              // Full API response for this rule
}

import {
    getTemplateUrl,
    getDocumentSources,
    getDocumentSourceUrl,
    getSectionFromText,
    getDocumentSections,
    getDocumentPresignedUrl,
    generateProxyUrl,
    getSectionRules,
    createApiClient,
    ArtosAPIError
} from '@artosai/sdk'

import type {
    ApiClient,
    ApiClientConfig,
    ApiCallOptions,
    GetTemplateUrlOptions,
    GetTemplateUrlResponse,
    GetDocumentSourcesOptions,
    GetDocumentSourcesResponse,
    GetDocumentSourceUrlOptions,
    GetDocumentSourceUrlResponse,
    GetSectionFromTextOptions,
    GetSectionFromTextResponse,
    GetDocumentSectionsOptions,
    GetDocumentSectionsResponse,
    GetDocumentPresignedUrlOptions,
    GetDocumentPresignedUrlResponse,
    GenerateProxyUrlOptions,
    GenerateProxyUrlResponse,
    GetSectionRulesOptions,
    GetSectionRulesResponse,
    SectionRule,
    RuleSourceChunk,
    RuleTable,
    DocumentSource,
    DocumentSection
} from '@artosai/sdk'

async function typedExample(): Promise<GetTemplateUrlResponse> {
    const options: GetTemplateUrlOptions = {
        documentId: 'doc-123',
        accessToken: process.env.ARTOS_ACCESS_TOKEN!,
        baseUrl: 'https://api.artosai.com'
    }

    const result: GetTemplateUrlResponse = await getTemplateUrl(options)
    return result
}