@commissionsight/sdk 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,977 @@
+/** Lightweight typed client for the CommissionSight API. */
+/** Member status for a period, file-over-file. */
+export type Status = 'green' | 'yellow' | 'red';
+/** Explicit delta flags attached to a member's status for a period. */
+export type Flag = 'NEW' | 'COMMISSION_CHANGED' | 'DATA_CHANGED' | 'DROPPED' | 'REAPPEARED' | 'REAPPEARED_WITH_DELTA' | 'CHARGEBACK';
+/** One chargeback (negative-commission record) enriched with the original payout. */
+export interface ChargebackRow {
+    memberRefId: string;
+    policyRefId: string;
+    memberExternalId: string | null;
+    policyNumber: string | null;
+    planName: string | null;
+    /** The amount clawed back this period (positive magnitude). */
+    chargebackAmount: number;
+    /** Whether the carrier ever paid this policy out. */
+    paidOut: boolean;
+    /** The original payout ("record 0"): when/where the carrier first paid, and how much. */
+    originalPayout: {
+        period: string;
+        amount: number;
+        fileId: string | null;
+        fileName: string | null;
+    } | null;
+    /** Whether the chargeback exactly reverses the original payout. */
+    fullyReversed: boolean;
+}
+export interface ClientOptions {
+    baseUrl: string;
+    token?: string;
+    fetch?: typeof fetch;
+}
+export interface Page<T> {
+    data: T[];
+    pagination?: {
+        limit: number;
+        offset?: number;
+        nextCursor?: number | null;
+        hasMore: boolean;
+    };
+}
+export interface JobSummary {
+    id: string;
+    carrierId: string;
+    periodYear: number;
+    periodMonth: number;
+    fileId: string;
+    r2Key?: string;
+    status: 'queued' | 'processing' | 'completed' | 'failed';
+    stats?: Record<string, number> | null;
+    error?: string | null;
+    webhookUrl?: string | null;
+    /** Number of rows rejected on ingest; download the detail via `downloadExceptions`. */
+    exceptionRowCount?: number;
+    createdAt: number | string;
+    startedAt?: number | string | null;
+    completedAt?: number | string | null;
+}
+export interface FileSummary {
+    id: string;
+    accountId: string;
+    carrierId: string;
+    periodYear: number;
+    periodMonth: number;
+    originalFilename: string;
+    byteSize: number;
+    checksumSha256: string;
+    uploadedAt: number | string;
+    /**
+     * True when this period's delta/status scoring is stale because an earlier
+     * (baseline) period was uploaded out of order. Call `rescoreFile` to refresh
+     * it without re-uploading.
+     */
+    rescoreSuggested?: boolean;
+    /** When set, the raw bytes were purged from object storage (retention). */
+    r2PurgedAt?: number | string | null;
+}
+export interface AdminMetrics {
+    totalJobs: number;
+    jobsLast24h: number;
+    byStatus: Record<string, number>;
+    failures: number;
+    accounts: number;
+    accountsByStatus: Record<string, number>;
+    pendingAccounts: number;
+    users: number;
+    webhooks: Record<string, number>;
+    webhooksPending: number;
+    webhooksFailed: number;
+    recentJobs: {
+        id: string;
+        carrierId: string;
+        periodYear: number;
+        periodMonth: number;
+        status: string;
+        error: string | null;
+        createdAt: number;
+    }[];
+    recentAccounts: {
+        id: string;
+        name: string;
+        status: string;
+        createdAt: number;
+    }[];
+}
+export interface AdminJobDetail {
+    job: JobSummary & {
+        accountId: string;
+        webhookUrl?: string | null;
+        idempotencyKey?: string | null;
+    };
+    carrierName: string | null;
+    account: {
+        name: string;
+        slug: string;
+    } | null;
+    file: {
+        originalFilename: string;
+        byteSize: number;
+        checksumSha256: string;
+        uploadedAt: number | string;
+    } | null;
+    durationMs: number | null;
+    /** True when this job's period scoring is stale (out-of-order baseline). */
+    rescoreSuggested?: boolean;
+}
+export interface AdminLogEvent {
+    id: string;
+    ts: number;
+    level: 'info' | 'warn' | 'error';
+    source: 'job' | 'webhook';
+    message: string;
+    detail: string | null;
+}
+export interface AdminAlert {
+    id: string;
+    severity: 'warning' | 'critical';
+    title: string;
+    detail: string;
+    ts: number;
+}
+export interface AdminLogs {
+    generatedAt: number;
+    events: AdminLogEvent[];
+    alerts: AdminAlert[];
+    pagination?: {
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+}
+/** Per-account admin dashboard: counts + the latest period's summed rollup. */
+export interface AdminAccountOverview {
+    account: {
+        id: string;
+        name: string;
+        slug: string;
+        status: string;
+    };
+    counts: {
+        files: number;
+        jobs: number;
+        users: number;
+    };
+    latestPeriod: string | null;
+    rollup: {
+        memberCount: number;
+        green: number;
+        yellow: number;
+        red: number;
+        new: number;
+        reappeared: number;
+        attritionRate: number;
+        commissionAtRisk: number;
+        commissionOwed: number;
+        chargebackCount: number;
+        chargebackAmount: number;
+    } | null;
+}
+export interface AdminAccountFile {
+    id: string;
+    carrierId: string;
+    periodYear: number;
+    periodMonth: number;
+    originalFilename: string;
+    byteSize: number;
+    uploadedAt: number | string;
+    supersededAt: number | string | null;
+    r2PurgedAt: number | string | null;
+}
+export interface AdminAccountJob {
+    id: string;
+    carrierId: string;
+    periodYear: number;
+    periodMonth: number;
+    status: string;
+    error: string | null;
+    stats: Record<string, number> | null;
+    createdAt: number | string;
+    completedAt: number | string | null;
+}
+export interface AdminAccountUser {
+    id: string;
+    email: string;
+    role: string;
+    createdAt: number | string;
+}
+/** One scheduled-maintenance (cron) pass — admin System tab. */
+export interface AdminCronRun {
+    id: string;
+    ranAt: number;
+    requeued: number;
+    webhooksRedelivered: number;
+    filesPurged: number;
+    jobsCanceled: number;
+    billed: number;
+    durationMs: number;
+}
+export interface AdminCronTask {
+    key: string;
+    title: string;
+    description: string;
+}
+export interface AdminSystemActivity {
+    generatedAt: number;
+    tasks: AdminCronTask[];
+    runs: AdminCronRun[];
+}
+/** Platform billing/revenue summary (admin). Amounts are in cents. */
+export interface AdminRevenueSummary {
+    generatedAt: number;
+    platform: {
+        accounts: {
+            total: number;
+            active: number;
+            pending: number;
+            suspended: number;
+        };
+        users: number;
+        apiKeys: number;
+        carriers: number;
+        /** Distinct monitored members across the platform (latest period per account+carrier). */
+        heartbeats: number;
+    };
+    revenue: {
+        /** Current member counts × the real pricing tiers (projected monthly revenue). */
+        projectedMonthlyCents: number;
+        avgCostPerMemberCents: number;
+        /** Sum of each account's most recent invoice total. */
+        lastCycleBilledCents: number;
+        accountsWithPaymentMethod: number;
+        byPaymentType: Record<'card' | 'us_bank_account' | 'none', {
+            accounts: number;
+            projectedCents: number;
+            lastBilledCents: number;
+        }>;
+    };
+    /** Actual A/R from Stripe, or `{ configured: false }` when Stripe isn't set up. */
+    ar: {
+        configured: true;
+        invoices: number;
+        billedCents: number;
+        paidCents: number;
+        outstandingCents: number;
+        failedCents: number;
+        recentOnly: boolean;
+    } | {
+        configured: false;
+    };
+    carriers: {
+        carrierId: string;
+        name: string;
+        accounts: number;
+        heartbeats: number;
+    }[];
+}
+export interface AdminProvisionResult {
+    provisioned: boolean;
+    alreadyProvisioned?: boolean;
+    createdDatabase?: boolean;
+    migrationsApplied?: number;
+    error?: string;
+}
+export interface ResultRow {
+    /** Internal CommissionSight member id — stable across periods; use it to pull
+     * the member's full journey (`getMemberJourney`). Included on every export. */
+    memberRefId: string;
+    /** Internal CommissionSight policy id (member-scoped). `getPolicyJourney`. */
+    policyRefId: string | null;
+    status: Status;
+    flags: Flag[];
+    commissionAmount: number | null;
+    prevCommissionAmount: number | null;
+    /** Expected-vs-actual shortfall for this member (recoverable), in dollars. 0
+     * when no contracted rate applies. Reconciles to the period's owed rollup. */
+    commissionOwed: number;
+    comparedAgainstPeriod: string | null;
+    memberExternalId: string | null;
+    memberName: string | null;
+    email: string | null;
+    planName: string | null;
+    policyNumber: string | null;
+    premiumAmount: number | null;
+}
+/** An account team member. */
+export interface TeamMember {
+    id: string;
+    email: string;
+    role: 'member' | 'admin';
+    createdAt: number | string;
+}
+/** One audit-trail event. `action` is a dotted verb (e.g. `file.upload`). */
+export interface AuditEvent {
+    id: string;
+    actor: string;
+    action: string;
+    target: string | null;
+    meta: Record<string, unknown> | null;
+    ip: string | null;
+    createdAt: number | string;
+}
+/** One policy line within a journey period. */
+export interface JourneyPolicy {
+    policyRefId: string;
+    policyNumber: string | null;
+    planName: string | null;
+    planCode: string | null;
+    commissionAmount: number;
+    premiumAmount: number | null;
+    effectiveDate: string | null;
+    renewalDate: string | null;
+}
+export interface JourneyDelta {
+    field: string;
+    prevValue: string | null;
+    currValue: string | null;
+}
+/** One period in a member/policy audit journey. */
+export interface JourneyPeriod {
+    period: string;
+    periodYear: number;
+    periodMonth: number;
+    status: Status | null;
+    flags: Flag[];
+    /** True when present on this period's statement; false for a drop-off period
+     * (red, absent from the file). */
+    present: boolean;
+    commissionAmount: number | null;
+    prevCommissionAmount: number | null;
+    premiumAmount: number | null;
+    policies: JourneyPolicy[];
+    file: {
+        fileId: string;
+        fileName: string | null;
+        uploadedAt: number | null;
+    } | null;
+    deltas: JourneyDelta[];
+    firstSeen: boolean;
+}
+/** The full audit history of a member (or a single policy). */
+export interface Journey {
+    memberRefId: string;
+    policyRefId?: string;
+    member: {
+        memberExternalId: string | null;
+        memberName: string | null;
+        email: string | null;
+        carrierId: string;
+    };
+    firstPeriod: string | null;
+    latestPeriod: string | null;
+    periodCount: number;
+    periods: JourneyPeriod[];
+}
+export interface ComparisonRow {
+    memberRefId: string;
+    status: Status;
+    flags: Flag[];
+    commissionAmount: number | null;
+    prevCommissionAmount: number | null;
+    comparedAgainstPeriod: string | null;
+    memberName: string | null;
+    memberExternalId: string | null;
+    policyNumber: string | null;
+}
+export interface BillingDetails {
+    contactName?: string;
+    companyName?: string;
+    email?: string;
+    phone?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+}
+export interface BillingProfile extends BillingDetails {
+    card: {
+        brand: string;
+        last4: string;
+    } | null;
+    paymentMethod?: 'card' | 'us_bank_account' | null;
+    stripeEnabled?: boolean;
+}
+export interface BillingPreview {
+    period: string | null;
+    members: number;
+    pricePerMemberCents: number;
+    amountCents: number;
+    method: 'card' | 'us_bank_account';
+    feeCents: number;
+    totalCents: number;
+    achSavingsCents: number;
+    surcharge?: boolean;
+    dueDate: string | null;
+    custom?: boolean;
+    lastBilledPeriod: string | null;
+}
+export interface CarrierConfigEntry {
+    id: string;
+    version: number;
+    fileType: 'csv' | 'xlsx';
+    accountId: string | null;
+    isActive: boolean;
+    config: Record<string, unknown>;
+}
+export interface AdminAccountBilling {
+    accountId: string;
+    contactName: string | null;
+    companyName: string | null;
+    email: string | null;
+    phone: string | null;
+    addressLine1: string | null;
+    addressLine2: string | null;
+    city: string | null;
+    state: string | null;
+    postalCode: string | null;
+    country: string | null;
+    customRateCents: number | null;
+    surchargeEnabled: boolean;
+    paymentMethodType: 'card' | 'us_bank_account' | null;
+    card: {
+        brand: string;
+        last4: string;
+    } | null;
+    lastBilledPeriod: string | null;
+    lastBilledAmountCents: number | null;
+}
+export interface AdminUser {
+    id: string;
+    email: string;
+    role: 'member' | 'admin';
+    accountId: string | null;
+    accountName?: string | null;
+    createdAt?: number;
+}
+export type StabilityLevel = 'ok' | 'watch' | 'alert';
+export interface DataQualitySignal {
+    carrierId: string;
+    carrierName: string | null;
+    level: StabilityLevel;
+    reason: string;
+    droppedRate: number;
+    newRate: number;
+    churnOverlap: number;
+    red: number;
+    newMembers: number;
+    reappeared: number;
+    present: number;
+}
+export interface DataQualityReport {
+    period: string | null;
+    overall: StabilityLevel;
+    carriers: DataQualitySignal[];
+}
+export interface AttritionPoint {
+    period: string;
+    year: number;
+    month: number;
+    red: number;
+    memberCount: number;
+    attritionRate: number;
+    /** Commission at risk this period (MoM shortfall), in dollars. */
+    commissionAtRisk: number;
+}
+export interface Webhook {
+    id: string;
+    url: string;
+    events: string[];
+}
+export interface ExpectedCommissionRate {
+    id: string;
+    carrierId: string;
+    /** null = the carrier-wide default; a value = a per-plan override. */
+    planCode: string | null;
+    rateType: 'percent_of_premium' | 'flat_per_member';
+    /** Fraction for percent_of_premium (0.20 = 20%); dollars for flat_per_member. */
+    rateValue: number;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    constructor(status: number, message: string, body?: unknown | undefined);
+}
+export interface InferredConfig {
+    config: unknown;
+    confidence: number;
+    headerRow: number;
+    sheets: string[];
+    mapped: {
+        header: string;
+        target: string;
+        score: number;
+    }[];
+    unmapped: string[];
+    notes: string[];
+    preview: {
+        mapped: number;
+        failed: number;
+        rows: unknown[];
+    } | null;
+}
+export declare class CommissionSightClient {
+    private readonly baseUrl;
+    private token;
+    private readonly fetchFn;
+    constructor(opts: ClientOptions);
+    setToken(token: string | undefined): void;
+    private request;
+    /** Like `request` but returns the raw response body as text (e.g. a CSV
+     * download). Errors still surface as `ApiError` from the problem+json body. */
+    private requestText;
+    listCarriers(params?: {
+        withConfig?: boolean;
+    }): Promise<Page<{
+        id: string;
+        name: string;
+        slug: string;
+    }>>;
+    getCarrier(carrierId: string): Promise<{
+        id: string;
+        name: string;
+        slug: string;
+    }>;
+    listConfigs(carrierId: string): Promise<Page<unknown>>;
+    getConfigVersion(carrierId: string, version: number): Promise<unknown>;
+    /** Create an account-scoped carrier config override. */
+    createConfig(carrierId: string, config: unknown): Promise<{
+        id: string;
+        version: number;
+    }>;
+    /** Dry-run a config against a sample file (maps + previews, persists nothing). */
+    testConfig(carrierId: string, config: unknown, file: File | Blob): Promise<{
+        mapped: number;
+        failed: number;
+        rows: unknown[];
+    }>;
+    /** Infer a draft config from a sample file. */
+    inferConfig(carrierId: string, file: File | Blob, opts?: {
+        sheetName?: string;
+    }): Promise<InferredConfig>;
+    uploadFile(input: {
+        file: File | Blob;
+        carrierId: string;
+        periodYear: number;
+        periodMonth: number;
+        webhookUrl?: string;
+        idempotencyKey?: string;
+        /**
+         * Replace an existing statement for this carrier+period. Without it, uploading
+         * over an existing period fails with `409` (`period_exists`); with it, the
+         * existing data is retracted and the corrected file re-ingested atomically
+         * (dropped members leave no orphan rows). The response carries `mode:'replace'`.
+         */
+        replace?: boolean;
+    }): Promise<{
+        jobId: string;
+        fileId: string;
+        status: string;
+        mode?: string;
+    }>;
+    listFiles(params?: {
+        carrierId?: string;
+        limit?: number;
+        cursor?: number;
+    }): Promise<Page<FileSummary>>;
+    getFile(fileId: string): Promise<FileSummary>;
+    /**
+     * Re-process (re-score) a file's period without re-uploading — recomputes
+     * statuses/deltas against the current baseline. Use after uploading an earlier
+     * month out of order (see `FileSummary.rescoreSuggested`).
+     */
+    rescoreFile(fileId: string): Promise<{
+        jobId: string;
+        fileId: string;
+        status: string;
+        mode: string;
+    }>;
+    /**
+     * Retract (unapply) a file's carrier+period — deletes the period's data with no
+     * re-upload and re-scores the following month. Scoped to the whole carrier+period
+     * (all files for it), so a period split across files clears as a unit. Returns
+     * `409` (`already_retracted`) if the file was already retracted/replaced.
+     */
+    retractFile(fileId: string): Promise<{
+        jobId: string;
+        fileId: string;
+        status: string;
+        mode: string;
+    }>;
+    /**
+     * Purge the raw statement bytes from object storage (data retention). The file
+     * row + scored results remain; the file can no longer be re-ingested. Idempotent.
+     */
+    purgeFile(fileId: string): Promise<{
+        fileId: string;
+        purged: boolean;
+    }>;
+    listJobs(params?: {
+        status?: string;
+        carrierId?: string;
+        periodYear?: number;
+        periodMonth?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<Page<JobSummary>>;
+    getJob(jobId: string): Promise<JobSummary>;
+    /** Download the exception file (rejected rows + their errors) for a job as CSV
+     * text. Retained for 30 days; a purged or absent file throws `ApiError` (404). */
+    downloadExceptions(jobId: string): Promise<string>;
+    getJobResults(jobId: string, params?: {
+        status?: string;
+        owedOnly?: boolean;
+        chargeback?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<Page<ResultRow> & {
+        period: {
+            year: number;
+            month: number;
+        };
+    }>;
+    getJobDeltas(jobId: string, params?: {
+        memberRefId?: string;
+        changeType?: string;
+    }): Promise<Page<unknown>>;
+    retryJob(jobId: string): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    listMembers(params?: {
+        carrierId?: string;
+        status?: string;
+        periodYear?: number;
+        periodMonth?: number;
+    }): Promise<Page<unknown>>;
+    getMember(memberRefId: string): Promise<unknown>;
+    getMemberTimeline(memberRefId: string): Promise<Page<unknown>>;
+    /** Full audit journey of a member: every period it appeared, the source file,
+     * commission/premium, status + flags, and field-level changes — in order. */
+    getMemberJourney(memberRefId: string): Promise<Journey>;
+    /** Full audit journey of a single policy (member-scoped). */
+    getPolicyJourney(policyRefId: string): Promise<Journey>;
+    /** Where/when a member was last seen (period + originating file). */
+    getMemberLastSeen(memberRefId: string): Promise<unknown>;
+    /** List the account's members. */
+    listTeam(): Promise<{
+        data: TeamMember[];
+    }>;
+    /** Invite a teammate by email (passwordless — they sign in with a one-time code). */
+    inviteTeammate(email: string): Promise<{
+        status: string;
+        email: string;
+        userId?: string;
+    }>;
+    /** Remove a teammate and revoke their sessions. */
+    removeTeammate(userId: string): Promise<void>;
+    /** Read the account's audit trail (newest first). Filter by `action`. */
+    listAudit(params?: {
+        action?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Page<AuditEvent>>;
+    compare(params: {
+        from: string;
+        to: string;
+        carrierId?: string;
+        granularity?: string;
+    }): Promise<{
+        from: string;
+        to: string;
+        summary: {
+            green: number;
+            yellow: number;
+            red: number;
+            new: number;
+            reappeared: number;
+            total: number;
+        };
+        data: ComparisonRow[];
+    }>;
+    rollup(period?: string, carrierId?: string): Promise<{
+        period: string | null;
+        totals: {
+            memberCount: number;
+            green: number;
+            yellow: number;
+            red: number;
+            new: number;
+            reappeared: number;
+            /** Commission at risk vs the prior period (MoM shortfall), in dollars. */
+            commissionAtRisk: number;
+            /** Of `commissionAtRisk`: prior commission of dropped members. */
+            commissionDropped: number;
+            /** Of `commissionAtRisk`: the decrease for members paid less. */
+            commissionReduced: number;
+            /** Number of still-present members paid less than the prior period. */
+            reducedCount: number;
+            /** Expected-vs-actual commission owed (recoverable), in dollars. */
+            commissionOwed: number;
+            /** Records the owed figure could be computed for (had a rate + inputs). */
+            owedEvaluated: number;
+            /** All records considered for owed (coverage denominator). */
+            owedTotal: number;
+            /** Members with a chargeback (net-negative commission) this period. */
+            chargebackCount: number;
+            /** Total commission clawed back this period (positive magnitude). */
+            chargebackAmount: number;
+        };
+        byCarrier: unknown[];
+    }>;
+    /** Chargebacks for a period, each enriched with the policy's original payout. */
+    listChargebacks(params?: {
+        period?: string;
+        carrierId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        period: string | null;
+        data: ChargebackRow[];
+    } & Page<ChargebackRow>>;
+    attrition(period: string, carrierId?: string): Promise<{
+        attritionRate: number;
+        byCarrier: unknown[];
+    }>;
+    attritionSeries(params?: {
+        months?: number;
+        carrierId?: string;
+    }): Promise<{
+        data: AttritionPoint[];
+    }>;
+    dataQuality(period?: string): Promise<DataQualityReport>;
+    listExpectedRates(carrierId?: string): Promise<{
+        data: ExpectedCommissionRate[];
+    }>;
+    /** Upsert the contracted rate for a carrier (+ optional plan). Re-posting the
+     * same carrier+plan updates it. `rateValue` is a fraction for percent_of_premium.
+     * Returns `rescoredPeriods`: how many already-processed periods were re-scored to
+     * bring their stored "commission owed" totals in line with the new rate. */
+    upsertExpectedRate(input: {
+        carrierId: string;
+        planCode?: string | null;
+        rateType: 'percent_of_premium' | 'flat_per_member';
+        rateValue: number;
+    }): Promise<ExpectedCommissionRate & {
+        rescoredPeriods: number;
+    }>;
+    deleteExpectedRate(id: string): Promise<void>;
+    listWebhooks(): Promise<{
+        data: Webhook[];
+    }>;
+    /** Subscribe to job events. The signing `secret` is returned ONCE on creation. */
+    createWebhook(input: {
+        url: string;
+        events: ('job.completed' | 'job.failed')[];
+    }): Promise<Webhook & {
+        secret: string;
+    }>;
+    deleteWebhook(id: string): Promise<void>;
+    /** The account behind the current token. */
+    me(): Promise<{
+        accountId: string;
+        name: string;
+        status: string;
+    }>;
+    /** Liveness probe (no auth required). */
+    health(): Promise<{
+        status: string;
+        service: string;
+        environment: string;
+    }>;
+    getBilling(): Promise<BillingProfile>;
+    updateBilling(body: BillingDetails): Promise<BillingProfile>;
+    billingPreview(): Promise<BillingPreview>;
+    createSetupIntent(): Promise<{
+        clientSecret: string;
+        publishableKey: string | null;
+        customerId: string;
+    }>;
+    savePaymentMethod(paymentMethodId: string): Promise<{
+        method: string;
+        brand: string | null;
+        last4: string | null;
+    }>;
+    readonly admin: {
+        listAccounts: (status?: "active" | "pending" | "suspended") => Promise<{
+            data: {
+                id: string;
+                name: string;
+                slug: string;
+                status: string;
+                customRateCents?: number | null;
+                provisioned?: boolean;
+            }[];
+        }>;
+        setBillingRate: (accountId: string, rateCents: number | null) => Promise<{
+            accountId: string;
+            customRateCents: number | null;
+        }>;
+        getAccountBilling: (accountId: string) => Promise<AdminAccountBilling>;
+        /** Per-account dashboard: counts + latest-period rollup (members, status mix,
+         * owed, at-risk, chargebacks). */
+        accountOverview: (accountId: string) => Promise<AdminAccountOverview>;
+        accountFiles: (accountId: string, params?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<{
+            data: AdminAccountFile[];
+        }>;
+        accountJobs: (accountId: string, params?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<{
+            data: AdminAccountJob[];
+        }>;
+        accountUsers: (accountId: string) => Promise<{
+            data: AdminAccountUser[];
+        }>;
+        /** Recent scheduled-maintenance (cron) runs + the task schedule — System tab. */
+        cronRuns: (params?: {
+            limit?: number;
+        }) => Promise<AdminSystemActivity>;
+        /** Platform billing/revenue summary — heartbeats, projected revenue, A/R. */
+        revenue: () => Promise<AdminRevenueSummary>;
+        /** Set an account's AI-assistant monthly cap (cents) and pass-through billing. */
+        setAiSettings: (accountId: string, settings: {
+            capCents?: number;
+            passthrough?: boolean;
+        }) => Promise<{
+            accountId: string;
+            capCents?: number;
+            passthrough?: boolean;
+        }>;
+        setSurcharge: (accountId: string, enabled: boolean) => Promise<{
+            accountId: string;
+            surchargeEnabled: boolean;
+        }>;
+        approveAccount: (accountId: string) => Promise<{
+            id: string;
+            status: string;
+            notified: number;
+            provision?: AdminProvisionResult;
+        }>;
+        /** Provision (or re-provision) an account's data store. Pass a connString to
+         * use a database created out of band; omit it to auto-create a Neon DB. */
+        provisionAccount: (accountId: string, connString?: string) => Promise<AdminProvisionResult>;
+        createAccount: (name: string) => Promise<{
+            id: string;
+            name: string;
+            slug: string;
+        }>;
+        /** Purge ALL raw statement bytes for an account from object storage (retention). */
+        purgeAccountFiles: (accountId: string) => Promise<{
+            accountId: string;
+            purged: number;
+        }>;
+        issueToken: (accountId: string, label?: string) => Promise<{
+            tokenId: string;
+            token: string;
+            label: string;
+        }>;
+        /** List an account's API tokens — metadata only (never the secret). */
+        listTokens: (accountId: string) => Promise<{
+            data: {
+                id: string;
+                label: string | null;
+                revoked: boolean;
+                lastUsedAt: number | null;
+                createdAt: number;
+            }[];
+        }>;
+        revokeToken: (tokenId: string) => Promise<{
+            tokenId: string;
+            revoked: boolean;
+        }>;
+        storeCredentials: (accountId: string, body: {
+            connString: string;
+            region?: string;
+        }) => Promise<{
+            accountId: string;
+            stored: boolean;
+        }>;
+        createCarrier: (name: string, slug: string) => Promise<{
+            id: string;
+            name: string;
+            slug: string;
+        }>;
+        renameCarrier: (id: string, name: string, slug?: string) => Promise<{
+            id: string;
+            name: string;
+            slug?: string;
+        }>;
+        /** Onboarding: infer a draft config from a sample statement (CSV/XLSX). */
+        inferConfig: (carrierId: string, file: File | Blob, opts?: {
+            sheetName?: string;
+            fileType?: "csv" | "xlsx";
+        }) => Promise<InferredConfig>;
+        listUsers: () => Promise<{
+            data: AdminUser[];
+        }>;
+        createUser: (body: {
+            email: string;
+            accountId?: string;
+            role?: "member" | "admin";
+        }) => Promise<AdminUser>;
+        /** Update a user's role. A user's account link is immutable (set at invite). */
+        updateUser: (id: string, body: {
+            role: "member" | "admin";
+        }) => Promise<{
+            id: string;
+            updated: boolean;
+        }>;
+        deleteUser: (id: string) => Promise<{
+            id: string;
+            deleted: boolean;
+        }>;
+        createGlobalConfig: (carrierId: string, config: unknown) => Promise<{
+            id: string;
+            version: number;
+        }>;
+        listCarrierConfigs: (carrierId: string) => Promise<{
+            data: CarrierConfigEntry[];
+        }>;
+        updateCarrierConfig: (carrierId: string, configId: string, config: unknown) => Promise<{
+            id: string;
+            version: number;
+            updated: boolean;
+        }>;
+        addAllowlist: (email: string) => Promise<{
+            email: string;
+        }>;
+        listJobs: (params?: {
+            status?: string;
+            limit?: number;
+            offset?: number;
+        }) => Promise<Page<JobSummary & {
+            accountId: string;
+            rescoreSuggested?: boolean;
+        }>>;
+        jobDetail: (jobId: string) => Promise<AdminJobDetail>;
+        retryJob: (jobId: string) => Promise<{
+            jobId: string;
+            status: string;
+        }>;
+        rescoreJob: (jobId: string) => Promise<{
+            jobId: string;
+            status: string;
+            mode: string;
+        }>;
+        metrics: () => Promise<AdminMetrics>;
+        logs: (params?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<AdminLogs>;
+    };
+}
+export declare function query(params: Record<string, string | number | undefined>): string;