/**
 * @vorionsys/shared-constants - API Versions
 *
 * Centralized API version management across all services
 * Ensures consistent versioning strategy
 *
 * @see https://cognigate.dev/docs/versioning
 */
export declare enum VersionStatus {
    /** Currently in development, not available */
    DEVELOPMENT = "development",
    /** Available as preview/beta */
    PREVIEW = "preview",
    /** Stable and recommended */
    STABLE = "stable",
    /** Still supported but deprecated */
    DEPRECATED = "deprecated",
    /** No longer supported */
    RETIRED = "retired"
}
export interface ApiVersionDefinition {
    /** Version identifier (e.g., "v1") */
    version: string;
    /** Full version number (e.g., "1.0.0") */
    fullVersion: string;
    /** Release date */
    releaseDate: string;
    /** End of support date (if deprecated/retired) */
    endOfLife?: string;
    /** Current status */
    status: VersionStatus;
    /** Changelog URL */
    changelogUrl?: string;
    /** Migration guide URL (if deprecated) */
    migrationUrl?: string;
}
export declare const COGNIGATE_VERSIONS: Record<string, ApiVersionDefinition>;
export declare const COGNIGATE_CURRENT_VERSION = "v1";
export declare const COGNIGATE_DEFAULT_VERSION = "v1";
export declare const TRUST_API_VERSIONS: Record<string, ApiVersionDefinition>;
export declare const TRUST_CURRENT_VERSION = "v1";
export declare const LOGIC_API_VERSIONS: Record<string, ApiVersionDefinition>;
export declare const LOGIC_CURRENT_VERSION = "v1";
export declare const BASIS_VERSIONS: Record<string, ApiVersionDefinition>;
export declare const BASIS_CURRENT_VERSION = "v1";
export declare const BASIS_SPEC_VERSION = "1.0.0";
export declare const CAR_SPEC_VERSIONS: Record<string, ApiVersionDefinition>;
export declare const CAR_SPEC_CURRENT_VERSION = "v1";
export declare const API_VERSIONS: {
    readonly cognigate: Record<string, ApiVersionDefinition>;
    readonly trust: Record<string, ApiVersionDefinition>;
    readonly logic: Record<string, ApiVersionDefinition>;
    readonly basis: Record<string, ApiVersionDefinition>;
    readonly carSpec: Record<string, ApiVersionDefinition>;
};
/**
 * Get the current stable version for a service
 */
export declare function getCurrentVersion(service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec'): string;
/**
 * Get version definition
 */
export declare function getVersionDefinition(service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec', version: string): ApiVersionDefinition | undefined;
/**
 * Check if a version is still supported
 */
export declare function isVersionSupported(service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec', version: string): boolean;
/**
 * Check if a version is deprecated
 */
export declare function isVersionDeprecated(service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec', version: string): boolean;
/**
 * Get all stable versions for a service
 */
export declare function getStableVersions(service: 'cognigate' | 'trust' | 'logic' | 'basis' | 'carSpec'): ApiVersionDefinition[];
/**
 * Build versioned API URL
 */
export declare function buildApiUrl(baseUrl: string, version: string, path: string): string;
export declare const VERSION_HEADERS: {
    /** Header to request specific API version */
    readonly REQUEST_VERSION: "X-API-Version";
    /** Header indicating actual API version used */
    readonly RESPONSE_VERSION: "X-API-Version";
    /** Header warning about deprecation */
    readonly DEPRECATION_WARNING: "X-Deprecation-Warning";
    /** Header with sunset date */
    readonly SUNSET: "Sunset";
};
//# sourceMappingURL=api-versions.d.ts.map