@fhirfly-io/terminology 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,991 @@
+/**
+ * Response shape options for controlling the level of detail returned.
+ */
+type ResponseShape = "compact" | "standard" | "full";
+/**
+ * Include options for additional data in responses.
+ */
+type IncludeOption = "display";
+/**
+ * Common options for all lookup methods.
+ */
+interface LookupOptions {
+    /** Response detail level. Default: "standard" */
+    shape?: ResponseShape;
+    /** Include additional fields like pre-formatted display strings */
+    include?: IncludeOption[];
+}
+/**
+ * Common options for batch lookup methods.
+ */
+interface BatchLookupOptions extends LookupOptions {
+    /** Maximum codes per batch (default: 100, max: 500) */
+    batchSize?: number;
+}
+/**
+ * Legal/licensing information included in responses.
+ */
+interface LegalInfo {
+    license: string;
+    attribution?: string;
+    source_url?: string;
+}
+/**
+ * Metadata included in all API responses.
+ */
+interface ResponseMeta {
+    legal: LegalInfo;
+    shape: ResponseShape;
+    api_version: string;
+}
+/**
+ * Standard API response wrapper.
+ */
+interface ApiResponse<T> {
+    data: T;
+    meta: ResponseMeta;
+}
+/**
+ * Batch response item - either success or not found.
+ */
+interface BatchResultItem<T> {
+    code: string;
+    found: boolean;
+    data?: T;
+    error?: string;
+}
+/**
+ * Batch response wrapper.
+ */
+interface BatchResponse<T> {
+    results: BatchResultItem<T>[];
+    meta: ResponseMeta & {
+        total: number;
+        found: number;
+        not_found: number;
+    };
+}
+/**
+ * Display field that may be included when include=display is specified.
+ */
+interface DisplayField {
+    display?: string;
+}
+
+/**
+ * HTTP client configuration.
+ */
+interface HttpClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    userAgent?: string;
+}
+/**
+ * Internal HTTP client for making API requests.
+ */
+declare class HttpClient {
+    private readonly config;
+    constructor(config: HttpClientConfig);
+    /**
+     * Build query string from options.
+     */
+    private buildQueryString;
+    /**
+     * Parse error response from API.
+     */
+    private parseErrorResponse;
+    /**
+     * Sleep for a given number of milliseconds.
+     */
+    private sleep;
+    /**
+     * Make an HTTP request with retries.
+     */
+    private request;
+    /**
+     * Make a GET request.
+     */
+    get<T>(endpoint: string, options?: LookupOptions): Promise<T>;
+    /**
+     * Make a POST request.
+     */
+    post<T>(endpoint: string, body: unknown, options?: LookupOptions): Promise<T>;
+}
+
+/**
+ * Active ingredient in a drug product.
+ */
+interface ActiveIngredient {
+    name: string;
+    strength?: string;
+    unit?: string;
+}
+/**
+ * Packaging information for an NDC.
+ */
+interface NdcPackaging {
+    ndc: string;
+    description?: string;
+    package_ndc?: string;
+}
+/**
+ * NDC lookup result - compact shape.
+ */
+interface NdcCompact extends DisplayField {
+    ndc: string;
+    ndc11: string;
+    product_name: string;
+    labeler_name: string;
+}
+/**
+ * NDC lookup result - standard shape.
+ */
+interface NdcStandard extends NdcCompact {
+    generic_name?: string;
+    dosage_form?: string;
+    route?: string;
+    active_ingredients: ActiveIngredient[];
+    dea_schedule?: string;
+    marketing_status?: string;
+}
+/**
+ * NDC lookup result - full shape.
+ */
+interface NdcFull extends NdcStandard {
+    application_number?: string;
+    product_type?: string;
+    marketing_start_date?: string;
+    marketing_end_date?: string;
+    listing_expiration_date?: string;
+    pharm_class?: string[];
+    packaging?: NdcPackaging[];
+}
+/**
+ * NDC response type based on shape.
+ */
+type NdcData = NdcCompact | NdcStandard | NdcFull;
+
+/**
+ * NDC (National Drug Code) API endpoint.
+ */
+declare class NdcEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single NDC code.
+     *
+     * @param code - NDC code (10-digit, 11-digit, or hyphenated format)
+     * @param options - Response shape and include options
+     * @returns NDC data
+     *
+     * @example
+     * ```ts
+     * const ndc = await client.ndc.lookup("0069-0151-01");
+     * console.log(ndc.data.product_name); // "Lipitor"
+     * ```
+     */
+    lookup(code: string, options?: LookupOptions): Promise<ApiResponse<NdcData>>;
+    /**
+     * Look up multiple NDC codes in a single request.
+     *
+     * @param codes - Array of NDC codes (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each code
+     *
+     * @example
+     * ```ts
+     * const results = await client.ndc.lookupMany([
+     *   "0069-0151-01",
+     *   "0069-0151-02",
+     *   "invalid-code"
+     * ]);
+     *
+     * for (const item of results.results) {
+     *   if (item.found) {
+     *     console.log(item.data.product_name);
+     *   } else {
+     *     console.log(`Not found: ${item.code}`);
+     *   }
+     * }
+     * ```
+     */
+    lookupMany(codes: string[], options?: BatchLookupOptions): Promise<BatchResponse<NdcData>>;
+}
+
+/**
+ * Provider address information.
+ */
+interface NpiAddress {
+    address_1?: string;
+    address_2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+    telephone?: string;
+    fax?: string;
+}
+/**
+ * Provider taxonomy/specialty information.
+ */
+interface NpiTaxonomy {
+    code: string;
+    description?: string;
+    primary?: boolean;
+    state?: string;
+    license?: string;
+}
+/**
+ * Other identifier (non-NPI) for a provider.
+ */
+interface NpiIdentifier {
+    identifier: string;
+    type?: string;
+    state?: string;
+    issuer?: string;
+}
+/**
+ * NPI lookup result - compact shape.
+ */
+interface NpiCompact extends DisplayField {
+    npi: string;
+    entity_type: "individual" | "organization";
+    name: string;
+    /** For individuals: first name */
+    first_name?: string;
+    /** For individuals: last name */
+    last_name?: string;
+    /** For organizations: organization name */
+    organization_name?: string;
+}
+/**
+ * NPI lookup result - standard shape.
+ */
+interface NpiStandard extends NpiCompact {
+    credential?: string;
+    gender?: string;
+    sole_proprietor?: boolean;
+    enumeration_date?: string;
+    last_updated?: string;
+    status?: string;
+    primary_taxonomy?: NpiTaxonomy;
+    practice_address?: NpiAddress;
+}
+/**
+ * NPI lookup result - full shape.
+ */
+interface NpiFull extends NpiStandard {
+    mailing_address?: NpiAddress;
+    taxonomies?: NpiTaxonomy[];
+    identifiers?: NpiIdentifier[];
+    other_names?: Array<{
+        type: string;
+        name: string;
+    }>;
+    deactivation_date?: string;
+    reactivation_date?: string;
+}
+/**
+ * NPI response type based on shape.
+ */
+type NpiData = NpiCompact | NpiStandard | NpiFull;
+
+/**
+ * NPI (National Provider Identifier) API endpoint.
+ */
+declare class NpiEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single NPI.
+     *
+     * @param npi - 10-digit NPI number
+     * @param options - Response shape and include options
+     * @returns NPI data
+     *
+     * @example
+     * ```ts
+     * const npi = await client.npi.lookup("1234567890");
+     * console.log(npi.data.name);
+     * ```
+     */
+    lookup(npi: string, options?: LookupOptions): Promise<ApiResponse<NpiData>>;
+    /**
+     * Look up multiple NPIs in a single request.
+     *
+     * @param npis - Array of 10-digit NPI numbers (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each NPI
+     *
+     * @example
+     * ```ts
+     * const results = await client.npi.lookupMany([
+     *   "1234567890",
+     *   "0987654321"
+     * ]);
+     * ```
+     */
+    lookupMany(npis: string[], options?: BatchLookupOptions): Promise<BatchResponse<NpiData>>;
+}
+
+/**
+ * RxNorm term type (TTY).
+ */
+type RxTermType = "IN" | "PIN" | "MIN" | "SCDC" | "SCDF" | "SCDG" | "SCD" | "GPCK" | "BN" | "SBDC" | "SBDF" | "SBDG" | "SBD" | "BPCK" | "PSN" | "SY" | "TMSY" | "DF" | "ET" | "DFG";
+/**
+ * RxNorm lookup result - compact shape.
+ */
+interface RxNormCompact extends DisplayField {
+    rxcui: string;
+    name: string;
+    tty: RxTermType;
+}
+/**
+ * RxNorm lookup result - standard shape.
+ */
+interface RxNormStandard extends RxNormCompact {
+    synonym?: string;
+    suppress?: string;
+    language?: string;
+    prescribable?: boolean;
+    ingredients?: Array<{
+        rxcui: string;
+        name: string;
+    }>;
+}
+/**
+ * RxNorm lookup result - full shape.
+ */
+interface RxNormFull extends RxNormStandard {
+    dose_form?: {
+        rxcui: string;
+        name: string;
+    };
+    brands?: Array<{
+        rxcui: string;
+        name: string;
+    }>;
+    related?: Array<{
+        rxcui: string;
+        name: string;
+        tty: RxTermType;
+        relation: string;
+    }>;
+    ndcs?: string[];
+}
+/**
+ * RxNorm response type based on shape.
+ */
+type RxNormData = RxNormCompact | RxNormStandard | RxNormFull;
+
+/**
+ * RxNorm API endpoint.
+ */
+declare class RxNormEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single RxCUI.
+     *
+     * @param rxcui - RxNorm Concept Unique Identifier
+     * @param options - Response shape and include options
+     * @returns RxNorm data
+     *
+     * @example
+     * ```ts
+     * const rx = await client.rxnorm.lookup("213169");
+     * console.log(rx.data.name); // "atorvastatin 10 MG Oral Tablet"
+     * ```
+     */
+    lookup(rxcui: string, options?: LookupOptions): Promise<ApiResponse<RxNormData>>;
+    /**
+     * Look up multiple RxCUIs in a single request.
+     *
+     * @param rxcuis - Array of RxCUIs (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each RxCUI
+     */
+    lookupMany(rxcuis: string[], options?: BatchLookupOptions): Promise<BatchResponse<RxNormData>>;
+}
+
+/**
+ * LOINC lookup result - compact shape.
+ */
+interface LoincCompact extends DisplayField {
+    loinc_num: string;
+    long_common_name: string;
+    component: string;
+}
+/**
+ * LOINC lookup result - standard shape.
+ */
+interface LoincStandard extends LoincCompact {
+    short_name?: string;
+    class?: string;
+    class_type?: number;
+    property?: string;
+    time_aspect?: string;
+    system?: string;
+    scale_type?: string;
+    method_type?: string;
+    status?: string;
+    order_obs?: string;
+}
+/**
+ * LOINC lookup result - full shape.
+ */
+interface LoincFull extends LoincStandard {
+    definition_description?: string;
+    consumer_name?: string;
+    survey_question_text?: string;
+    survey_question_source?: string;
+    units_required?: string;
+    submitted_units?: string;
+    related_names_2?: string;
+    example_units?: string;
+    example_ucum_units?: string;
+    example_si_ucum_units?: string;
+    status_reason?: string;
+    status_text?: string;
+    change_reason_public?: string;
+    common_test_rank?: number;
+    common_order_rank?: number;
+    hl7_field_subfield_id?: string;
+    external_copyright_notice?: string;
+    panel_type?: string;
+    ask_at_order_entry?: string;
+    associated_observations?: string;
+    version_first_released?: string;
+    version_last_changed?: string;
+}
+/**
+ * LOINC response type based on shape.
+ */
+type LoincData = LoincCompact | LoincStandard | LoincFull;
+
+/**
+ * LOINC API endpoint.
+ */
+declare class LoincEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single LOINC code.
+     *
+     * @param loincNum - LOINC number (e.g., "2345-7")
+     * @param options - Response shape and include options
+     * @returns LOINC data
+     *
+     * @example
+     * ```ts
+     * const loinc = await client.loinc.lookup("2345-7");
+     * console.log(loinc.data.long_common_name); // "Glucose [Mass/volume] in Serum or Plasma"
+     * ```
+     */
+    lookup(loincNum: string, options?: LookupOptions): Promise<ApiResponse<LoincData>>;
+    /**
+     * Look up multiple LOINC codes in a single request.
+     *
+     * @param loincNums - Array of LOINC numbers (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each LOINC
+     */
+    lookupMany(loincNums: string[], options?: BatchLookupOptions): Promise<BatchResponse<LoincData>>;
+}
+
+/**
+ * ICD-10 code type.
+ */
+type Icd10Type = "cm" | "pcs";
+/**
+ * ICD-10 lookup result - compact shape.
+ */
+interface Icd10Compact extends DisplayField {
+    code: string;
+    type: Icd10Type;
+    description: string;
+}
+/**
+ * ICD-10 lookup result - standard shape.
+ */
+interface Icd10Standard extends Icd10Compact {
+    long_description?: string;
+    chapter?: string;
+    chapter_description?: string;
+    section?: string;
+    section_description?: string;
+    billable?: boolean;
+    /** ICD-10-CM specific */
+    is_header?: boolean;
+    /** ICD-10-PCS specific */
+    body_system?: string;
+    root_operation?: string;
+}
+/**
+ * ICD-10 lookup result - full shape.
+ */
+interface Icd10Full extends Icd10Standard {
+    /** ICD-10-CM specific */
+    includes?: string[];
+    excludes1?: string[];
+    excludes2?: string[];
+    code_first?: string[];
+    use_additional?: string[];
+    /** ICD-10-PCS specific */
+    approach?: string;
+    device?: string;
+    qualifier?: string;
+    /** Effective dates */
+    effective_date?: string;
+    end_date?: string;
+}
+/**
+ * ICD-10 response type based on shape.
+ */
+type Icd10Data = Icd10Compact | Icd10Standard | Icd10Full;
+
+/**
+ * ICD-10 API endpoint.
+ */
+declare class Icd10Endpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single ICD-10-CM code (diagnoses).
+     *
+     * @param code - ICD-10-CM code (e.g., "E11.9")
+     * @param options - Response shape and include options
+     * @returns ICD-10 data
+     *
+     * @example
+     * ```ts
+     * const icd = await client.icd10.lookupCm("E11.9");
+     * console.log(icd.data.description); // "Type 2 diabetes mellitus without complications"
+     * ```
+     */
+    lookupCm(code: string, options?: LookupOptions): Promise<ApiResponse<Icd10Data>>;
+    /**
+     * Look up a single ICD-10-PCS code (procedures).
+     *
+     * @param code - ICD-10-PCS code (e.g., "0BJ08ZZ")
+     * @param options - Response shape and include options
+     * @returns ICD-10 data
+     *
+     * @example
+     * ```ts
+     * const icd = await client.icd10.lookupPcs("0BJ08ZZ");
+     * console.log(icd.data.description);
+     * ```
+     */
+    lookupPcs(code: string, options?: LookupOptions): Promise<ApiResponse<Icd10Data>>;
+    /**
+     * Look up multiple ICD-10-CM codes in a single request.
+     *
+     * @param codes - Array of ICD-10-CM codes (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each code
+     */
+    lookupCmMany(codes: string[], options?: BatchLookupOptions): Promise<BatchResponse<Icd10Data>>;
+    /**
+     * Look up multiple ICD-10-PCS codes in a single request.
+     *
+     * @param codes - Array of ICD-10-PCS codes (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each code
+     */
+    lookupPcsMany(codes: string[], options?: BatchLookupOptions): Promise<BatchResponse<Icd10Data>>;
+}
+
+/**
+ * CVX vaccine code lookup result - compact shape.
+ */
+interface CvxCompact extends DisplayField {
+    cvx_code: string;
+    short_description: string;
+}
+/**
+ * CVX vaccine code lookup result - standard shape.
+ */
+interface CvxStandard extends CvxCompact {
+    full_vaccine_name: string;
+    notes?: string;
+    status: "Active" | "Inactive" | "Never Active" | "Pending";
+    last_updated?: string;
+}
+/**
+ * CVX vaccine code lookup result - full shape.
+ */
+interface CvxFull extends CvxStandard {
+    vaccine_group?: string;
+    cdc_product_name?: string;
+    dose_number?: string;
+    forecast_vaccine_group?: string;
+}
+/**
+ * CVX response type based on shape.
+ */
+type CvxData = CvxCompact | CvxStandard | CvxFull;
+
+/**
+ * CVX (Vaccine Codes) API endpoint.
+ */
+declare class CvxEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single CVX code.
+     *
+     * @param cvxCode - CVX vaccine code
+     * @param options - Response shape and include options
+     * @returns CVX data
+     *
+     * @example
+     * ```ts
+     * const cvx = await client.cvx.lookup("208");
+     * console.log(cvx.data.short_description); // "COVID-19, mRNA, LNP-S, PF, 30 mcg/0.3 mL dose"
+     * ```
+     */
+    lookup(cvxCode: string, options?: LookupOptions): Promise<ApiResponse<CvxData>>;
+    /**
+     * Look up multiple CVX codes in a single request.
+     *
+     * @param cvxCodes - Array of CVX codes (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each code
+     */
+    lookupMany(cvxCodes: string[], options?: BatchLookupOptions): Promise<BatchResponse<CvxData>>;
+}
+
+/**
+ * MVX vaccine manufacturer lookup result - compact shape.
+ */
+interface MvxCompact extends DisplayField {
+    mvx_code: string;
+    manufacturer_name: string;
+}
+/**
+ * MVX vaccine manufacturer lookup result - standard shape.
+ */
+interface MvxStandard extends MvxCompact {
+    notes?: string;
+    status: "Active" | "Inactive";
+    last_updated?: string;
+}
+/**
+ * MVX vaccine manufacturer lookup result - full shape.
+ */
+interface MvxFull extends MvxStandard {
+    vaccines?: Array<{
+        cvx_code: string;
+        vaccine_name: string;
+    }>;
+}
+/**
+ * MVX response type based on shape.
+ */
+type MvxData = MvxCompact | MvxStandard | MvxFull;
+
+/**
+ * MVX (Vaccine Manufacturer Codes) API endpoint.
+ */
+declare class MvxEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up a single MVX code.
+     *
+     * @param mvxCode - MVX manufacturer code
+     * @param options - Response shape and include options
+     * @returns MVX data
+     *
+     * @example
+     * ```ts
+     * const mvx = await client.mvx.lookup("PFR");
+     * console.log(mvx.data.manufacturer_name); // "Pfizer, Inc"
+     * ```
+     */
+    lookup(mvxCode: string, options?: LookupOptions): Promise<ApiResponse<MvxData>>;
+    /**
+     * Look up multiple MVX codes in a single request.
+     *
+     * @param mvxCodes - Array of MVX codes (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each code
+     */
+    lookupMany(mvxCodes: string[], options?: BatchLookupOptions): Promise<BatchResponse<MvxData>>;
+}
+
+/**
+ * FDA Label lookup result - compact shape.
+ */
+interface FdaLabelCompact extends DisplayField {
+    set_id: string;
+    product_name: string;
+    labeler_name: string;
+}
+/**
+ * FDA Label lookup result - standard shape.
+ */
+interface FdaLabelStandard extends FdaLabelCompact {
+    version?: number;
+    effective_time?: string;
+    product_type?: string;
+    route?: string[];
+    substance_name?: string[];
+    indications_and_usage?: string;
+    dosage_and_administration?: string;
+}
+/**
+ * FDA Label lookup result - full shape.
+ */
+interface FdaLabelFull extends FdaLabelStandard {
+    spl_id?: string;
+    document_type?: string;
+    warnings?: string;
+    precautions?: string;
+    contraindications?: string;
+    adverse_reactions?: string;
+    drug_interactions?: string;
+    overdosage?: string;
+    clinical_pharmacology?: string;
+    mechanism_of_action?: string;
+    pharmacodynamics?: string;
+    pharmacokinetics?: string;
+    how_supplied?: string;
+    storage_and_handling?: string;
+    boxed_warning?: string;
+    pregnancy?: string;
+    nursing_mothers?: string;
+    pediatric_use?: string;
+    geriatric_use?: string;
+}
+/**
+ * FDA Label response type based on shape.
+ */
+type FdaLabelData = FdaLabelCompact | FdaLabelStandard | FdaLabelFull;
+
+/**
+ * FDA Labels API endpoint.
+ */
+declare class FdaLabelsEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Look up FDA label by Set ID.
+     *
+     * @param setId - FDA SPL Set ID
+     * @param options - Response shape and include options
+     * @returns FDA Label data
+     *
+     * @example
+     * ```ts
+     * const label = await client.fdaLabels.lookup("abc123-def456");
+     * console.log(label.data.indications_and_usage);
+     * ```
+     */
+    lookup(setId: string, options?: LookupOptions): Promise<ApiResponse<FdaLabelData>>;
+    /**
+     * Look up FDA label by NDC code.
+     *
+     * @param ndc - NDC code
+     * @param options - Response shape and include options
+     * @returns FDA Label data
+     *
+     * @example
+     * ```ts
+     * const label = await client.fdaLabels.lookupByNdc("0069-0151-01");
+     * console.log(label.data.product_name);
+     * ```
+     */
+    lookupByNdc(ndc: string, options?: LookupOptions): Promise<ApiResponse<FdaLabelData>>;
+    /**
+     * Look up multiple FDA labels by Set IDs in a single request.
+     *
+     * @param setIds - Array of Set IDs (max 500)
+     * @param options - Response shape, include, and batch options
+     * @returns Batch response with results for each Set ID
+     */
+    lookupMany(setIds: string[], options?: BatchLookupOptions): Promise<BatchResponse<FdaLabelData>>;
+}
+
+/**
+ * Configuration options for the FHIRfly client.
+ */
+interface FhirflyConfig {
+    /**
+     * Your FHIRfly API key.
+     * Get one at https://fhirfly.io/dashboard
+     */
+    apiKey: string;
+    /**
+     * Base URL for the API.
+     * @default "https://api.fhirfly.io"
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retry attempts for failed requests.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay between retries in milliseconds (exponential backoff).
+     * @default 1000
+     */
+    retryDelay?: number;
+}
+/**
+ * FHIRfly API client.
+ *
+ * Provides access to healthcare reference data including drug codes (NDC, RxNorm),
+ * provider identifiers (NPI), lab codes (LOINC), diagnosis codes (ICD-10),
+ * vaccine codes (CVX, MVX), and FDA drug labels.
+ *
+ * @example
+ * ```ts
+ * import { Fhirfly } from "@fhirfly/sdk";
+ *
+ * const client = new Fhirfly({ apiKey: "your-api-key" });
+ *
+ * // Look up a drug by NDC
+ * const ndc = await client.ndc.lookup("0069-0151-01");
+ * console.log(ndc.data.product_name); // "Lipitor"
+ *
+ * // Look up a provider by NPI
+ * const npi = await client.npi.lookup("1234567890");
+ * console.log(npi.data.name);
+ *
+ * // Batch lookups
+ * const results = await client.ndc.lookupMany([
+ *   "0069-0151-01",
+ *   "0069-0151-02"
+ * ]);
+ * ```
+ */
+declare class Fhirfly {
+    private readonly http;
+    /**
+     * NDC (National Drug Code) lookups.
+     */
+    readonly ndc: NdcEndpoint;
+    /**
+     * NPI (National Provider Identifier) lookups.
+     */
+    readonly npi: NpiEndpoint;
+    /**
+     * RxNorm drug terminology lookups.
+     */
+    readonly rxnorm: RxNormEndpoint;
+    /**
+     * LOINC laboratory and clinical observation code lookups.
+     */
+    readonly loinc: LoincEndpoint;
+    /**
+     * ICD-10 diagnosis and procedure code lookups.
+     */
+    readonly icd10: Icd10Endpoint;
+    /**
+     * CVX vaccine code lookups.
+     */
+    readonly cvx: CvxEndpoint;
+    /**
+     * MVX vaccine manufacturer code lookups.
+     */
+    readonly mvx: MvxEndpoint;
+    /**
+     * FDA drug label lookups.
+     */
+    readonly fdaLabels: FdaLabelsEndpoint;
+    /**
+     * Create a new FHIRfly client.
+     *
+     * @param config - Client configuration
+     * @throws {Error} If apiKey is not provided
+     */
+    constructor(config: FhirflyConfig);
+}
+
+/**
+ * Base error class for all FHIRfly SDK errors.
+ */
+declare class FhirflyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when the API returns an error response.
+ */
+declare class ApiError extends FhirflyError {
+    readonly statusCode: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, statusCode: number, code?: string, details?: unknown);
+}
+/**
+ * Error thrown when authentication fails (401).
+ */
+declare class AuthenticationError extends ApiError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when a resource is not found (404).
+ */
+declare class NotFoundError extends ApiError {
+    readonly code_type: string;
+    readonly code_value: string;
+    constructor(codeType: string, codeValue: string);
+}
+/**
+ * Error thrown when the request is invalid (400).
+ */
+declare class ValidationError extends ApiError {
+    readonly field?: string;
+    constructor(message: string, field?: string);
+}
+/**
+ * Error thrown when rate limited (429).
+ */
+declare class RateLimitError extends ApiError {
+    readonly retryAfter?: number;
+    readonly limit?: number;
+    readonly remaining?: number;
+    readonly reset?: Date;
+    constructor(message?: string, retryAfter?: number, limit?: number, remaining?: number, reset?: Date);
+}
+/**
+ * Error thrown when quota is exceeded (429 with quota context).
+ */
+declare class QuotaExceededError extends ApiError {
+    readonly quotaLimit?: number;
+    readonly quotaUsed?: number;
+    readonly quotaResetDate?: Date;
+    constructor(message?: string, quotaLimit?: number, quotaUsed?: number, quotaResetDate?: Date);
+}
+/**
+ * Error thrown when the server returns a 5xx error.
+ */
+declare class ServerError extends ApiError {
+    constructor(message?: string, statusCode?: number);
+}
+/**
+ * Error thrown when a network error occurs.
+ */
+declare class NetworkError extends FhirflyError {
+    readonly cause?: Error;
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Error thrown when a request times out.
+ */
+declare class TimeoutError extends FhirflyError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+
+export { type ActiveIngredient, ApiError, type ApiResponse, AuthenticationError, type BatchLookupOptions, type BatchResponse, type BatchResultItem, type CvxCompact, type CvxData, type CvxFull, type CvxStandard, type DisplayField, type FdaLabelCompact, type FdaLabelData, type FdaLabelFull, type FdaLabelStandard, Fhirfly, type FhirflyConfig, FhirflyError, type Icd10Compact, type Icd10Data, type Icd10Full, type Icd10Standard, type Icd10Type, type IncludeOption, type LegalInfo, type LoincCompact, type LoincData, type LoincFull, type LoincStandard, type LookupOptions, type MvxCompact, type MvxData, type MvxFull, type MvxStandard, type NdcCompact, type NdcData, type NdcFull, type NdcPackaging, type NdcStandard, NetworkError, NotFoundError, type NpiAddress, type NpiCompact, type NpiData, type NpiFull, type NpiIdentifier, type NpiStandard, type NpiTaxonomy, QuotaExceededError, RateLimitError, type ResponseMeta, type ResponseShape, type RxNormCompact, type RxNormData, type RxNormFull, type RxNormStandard, type RxTermType, ServerError, TimeoutError, ValidationError };