/**
 * Public report shape returned by `get_dd_report`. Stable contract — clients
 * (Stripe-billed customers) build dashboards on this. Add fields, never rename.
 *
 * v0.2.0 — extracted nested types into named interfaces so cz-agents-webapp
 * (and any other typed consumer) can import them without redefining.
 * Naming convention:
 *   - SanctionsMatch         — full match object (defined in clients.ts)
 *   - SanctionMatchSummary   — trimmed shape exposed in get_dd_report response
 */
export type RiskSeverity = 'critical' | 'high' | 'medium' | 'low';
export type RiskLevel = 'low' | 'medium' | 'high';
export type VatReliability = 'ANO' | 'NE' | 'NENALEZEN';
export type VatSubjectType = 'PLATCE_DPH' | 'IDENTIFIKOVANA_OSOBA' | 'SKUPINA_DPH' | 'NESPOLEHLIVA_OSOBA' | 'NENALEZEN';
export interface RedFlag {
    /** Stable machine code, e.g. 'INSOLVENCY_ACTIVE'. */
    code: string;
    severity: RiskSeverity;
    /** Contribution to risk score, 0–100. Score caps at 100 total. */
    weight: number;
    /** Human-readable description (Czech). */
    description: string;
    /** Where the data came from, e.g. 'ares', 'sanctions:ofac', 'isir'. */
    source: string;
    /** The raw datapoint that triggered the flag, for audit. */
    evidence?: unknown;
}
/**
 * Trimmed sanctions match shape exposed in get_dd_report response.
 * Distinct from `SanctionsMatch` in clients.ts (full match with entity object).
 */
export interface SanctionMatchSummary {
    source: string;
    list_id: string;
    confidence: number;
    matched_on: string;
    primary_name: string;
    matched_alias?: string;
    list_dobs?: string[];
    subject_dob?: string;
    dob_status: 'match' | 'mismatch' | 'list_missing' | 'subject_missing';
    match_strength: 'strong' | 'possible' | 'weak-name-only';
    nationalities?: string[];
    programs?: string[];
    listed_on?: string;
}
export interface PersonalInsolvency {
    spisova_znacka: string;
    phase?: string;
    url?: string;
}
export interface RegisteredAtGovtOffice {
    signal: 'marker' | 'known_address';
    matched_token?: string;
}
export interface PriorBankruptCompany {
    ico: string;
    name?: string;
    spisova_znacka?: string;
}
export interface StatutoryMember {
    name: string;
    role: string;
    since?: string;
    is_person: boolean;
    /** Date of birth from ARES VR — available for s.r.o. members, usually absent for a.s. */
    datumNarozeni?: string;
    /** Set if the person/entity matches a sanctions list (≥ 85 confidence). */
    sanctions_match?: SanctionMatchSummary;
    /** Sub-IČO if statutory is itself a legal entity. */
    legal_entity_ico?: string;
    /** Set if this person has an active personal insolvency proceeding in ISIR. */
    personal_insolvency?: PersonalInsolvency;
    /** Set if this person's permanent residence is at a municipal office (úřad bydliště). */
    registered_at_govt_office?: RegisteredAtGovtOffice;
    /** Other Czech companies sharing surname that have or had insolvency. */
    prior_bankrupt_companies?: PriorBankruptCompany[];
}
export interface DdCompany {
    name?: string;
    legal_form?: string;
    address?: string;
    registered_on?: string;
    dissolved_on?: string;
    nace_codes?: string[];
    found: boolean;
    /** False when ARES was referenced but the lookup threw (outage) rather than
     *  returning a genuine 404. Distinguishes "ARES unavailable" from "IČO not found". */
    checked?: boolean;
    error?: 'ares_unavailable';
}
export interface DdVat {
    is_payer: boolean;
    dic?: string;
    /** Set when the subject is a member of a Czech VAT group (§ 5a ZDPH).
     *  ADIS reliability is reported under this group DIČ, not under `dic`. */
    dic_sk_dph?: string;
    bank_accounts: string[];
    financial_office?: string;
    /** ADIS reliability classification. Set when ADIS lookup succeeds.
     *  ANO = unreliable payer (red flag), NE = reliable, NENALEZEN = not in VAT registry. */
    reliability?: VatReliability;
    /** Date the subject became unreliable. Set only when reliability === 'ANO'. */
    unreliable_since?: string;
    /** ADIS subject classification (V2). */
    subject_type?: VatSubjectType;
    /** False when ADIS was referenced but could not be queried. */
    checked?: boolean;
    error?: 'adis_unavailable';
}
export interface DdInsolvency {
    has_active_proceeding?: boolean;
    spisova_znacka?: string;
    started_on?: string;
    note?: string;
    checked?: boolean;
    error?: 'isir_unavailable';
}
export interface DdSanctions {
    company_match?: SanctionMatchSummary;
    /** True if any statutory member matched a list (details on each member). */
    any_statutory_match: boolean;
    /** False when sanctions screening was referenced but could not be queried. */
    checked?: boolean;
    error?: 'sanctions_unavailable';
}
export interface DdRiskScore {
    value: number;
    level: RiskLevel;
}
export interface OwnershipNetworkTeaser {
    title: 'Vlastnická a personální síť (z veřejného VR)';
    network_size: number;
    shared_role_link_count: number;
    coverage_pct: number;
    as_of: string | null;
    upgrade_hint: 'Pro plnou síť a signály přejděte na vyšší tarif.';
    text?: 'Síť se připravuje.';
}
export interface EsmOnramp {
    title: 'Skutečný majitel (ESM)';
    copy: [
        'ESM je od 17.12.2025 neveřejný registr.',
        'Povinná osoba má zákonnou povinnost zjistit skutečného majitele (AML zákon 253/2008 Sb.).',
        "Postup: přihlásit se datovou schránkou → podat žádost o dálkový přístup → prokázat identitu na úrovni 'značná'."
    ];
    link: 'https://esm.justice.cz';
    separation: {
        dolozeny_ubo: 'Pouze co klient sám získá z ESM.';
        indikovana_struktura: 'Náš VR odhad z veřejného rejstříku.';
    };
}
export interface DdReport {
    ico: string;
    retrieved_at: string;
    basic_only: boolean;
    company: DdCompany;
    vat: DdVat;
    statutory_body: StatutoryMember[];
    insolvency?: DdInsolvency;
    sanctions: DdSanctions;
    red_flags: RedFlag[];
    risk_score: DdRiskScore;
    ownership_network_teaser: OwnershipNetworkTeaser;
    esm_onramp: EsmOnramp;
}
export interface ChainNode {
    ico: string;
    name?: string;
    /** Path of statutory roles that led here from root, oldest → newest. */
    via?: string[];
    children?: ChainNode[];
    /** Cycle / repeated ICO already visited at lower depth. */
    cycle?: boolean;
    /** Statutory persons whose surname matched too many companies in ARES
     *  (auto-skipped to avoid false-positive explosion on common Czech
     *  surnames like Novák / Zima / Kolář on boards of large public firms). */
    skipped_common_surnames?: Array<{
        name: string;
        total_match_count: number;
    }>;
}
export interface ChainResult {
    root_ico: string;
    tree: ChainNode;
    total_companies: number;
    max_depth: number;
}
//# sourceMappingURL=types.d.ts.map