import type { Interfaces } from '@oclif/core';
import { Command } from '@oclif/core';
import { type ApiTarget } from './lib/api.js';
import type { AnyOperationDefinition, OperationInput, OperationInputIsOptional, OperationPathParamsFor, OperationRequest, OperationResponse } from './lib/contracts/types.js';
import type { Environment } from './lib/config.js';
export type InferredFlags<T extends typeof Command> = Interfaces.InferredFlags<(typeof BaseCommand)['baseFlags'] & T['flags']>;
export type InferredArgs<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
/**
 * Abstract base command for all formant commands.
 * Provides global --env flag, --json support, and authenticated API helpers.
 */
export declare abstract class BaseCommand<T extends typeof Command> extends Command {
    static enableJsonFlag: boolean;
    static baseFlags: {
        dev: Interfaces.BooleanFlag<boolean>;
        stage: Interfaces.BooleanFlag<boolean>;
        toon: Interfaces.BooleanFlag<boolean>;
        full: Interfaces.BooleanFlag<boolean>;
        field: Interfaces.OptionFlag<string[] | undefined, Interfaces.CustomOptions>;
    };
    protected flags: InferredFlags<T>;
    protected args: InferredArgs<T>;
    /** Resolved environment based on --dev / --stage flags. */
    protected get env(): Environment;
    /** Returns true when --toon flag is active. */
    toonEnabled(): boolean;
    /**
     * Returns true when either --json or --toon is active.
     * Overriding this ensures human-readable output is suppressed for both flags,
     * without requiring changes to individual command files.
     */
    jsonEnabled(): boolean;
    /**
     * Called by oclif when jsonEnabled() is true and run() returns successfully.
     * When --toon is active, encodes the result as TOON instead of JSON.
     *
     * Note: must write to process.stdout directly — this.log() is suppressed
     * by oclif whenever jsonEnabled() returns true.
     */
    protected logJson(json: unknown): void;
    init(): Promise<void>;
    /**
     * Make an authenticated GET/POST request to a Formant API.
     * Automatically uses the correct environment from --dev/--stage flags.
     */
    protected api<R = unknown>(target: ApiTarget, path: string, options?: {
        body?: unknown;
        method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
        query?: Record<string, string>;
        timeoutMs?: number;
    }): Promise<R>;
    /**
     * Make an authenticated API request using a typed operation contract.
     */
    protected callOperation<TOperation extends AnyOperationDefinition>(operation: TOperation, ...args: OperationInputIsOptional<OperationPathParamsFor<TOperation>, OperationRequest<TOperation>> extends true ? [input?: OperationInput<OperationPathParamsFor<TOperation>, OperationRequest<TOperation>>] : [input: OperationInput<OperationPathParamsFor<TOperation>, OperationRequest<TOperation>>]): Promise<OperationResponse<TOperation>>;
    /**
     * Make an authenticated API request using a known operation id.
     * Useful for operations that exist in the known operation catalog
     * but do not yet have a strongly-typed key under `operations.*`.
     */
    protected callKnownOperation(operationId: string, input?: {
        body?: unknown;
        pathParams?: Record<string, number | string>;
        query?: Record<string, string>;
        timeoutMs?: number;
    }): Promise<unknown>;
    /**
     * Get the organization ID from the authenticated session.
     * Uses the cached login token so no extra network call if already authenticated.
     */
    protected getOrgId(): Promise<string>;
    protected catch(err: Error & {
        exitCode?: number;
    }): Promise<void>;
    /**
     * Normalize a date string to ISO 8601 datetime format.
     * Accepts both simple dates (2026-01-01) and full datetime strings.
     */
    protected normalizeDateTime(dateStr: string): string;
}