keepkey-vault-sdk 1.2.6 → 2.0.1

package/dist/src/index.d.ts

@@ -1,42 +0,0 @@
-/**
- * KeepKey SDK v2 with Automatic Version Detection
- *
- * This SDK automatically detects whether it's connecting to a v1 or v2 API
- * and routes requests accordingly.
- *
- * Usage:
- *
- * ```typescript
- * import { createSDKConfig } from '@keepkey/keepkey-sdk';
- *
- * // Automatic version detection (recommended)
- * const config = createSDKConfig({
- *   basePath: 'http://localhost:1646'
- * });
- *
- * // Get version info
- * const versionInfo = await config.getVersionInfo();
- * console.log(`API version: ${versionInfo.apiVersion}`);
- * console.log(`Supported chains: ${versionInfo.supportedChains.length}`);
- *
- * // Manual version override (skip detection)
- * const config = createSDKConfigWithVersion(2, {
- *   basePath: 'http://localhost:1646'
- * });
- * ```
- */
-export type { KeepKeySdkConfig } from './KeepKeySdk';
-export { KeepKeySdk } from './KeepKeySdk';
-export * from './generated/v2';
-export { VersionRouter } from './middleware/version-router';
-export type { OpenAPISpec } from './spec-loader';
-export { SpecLoader } from './spec-loader';
-export type { ApiVersionInfo } from './version-detector';
-export { VersionDetector } from './version-detector';
-export type { DeviceStatus } from './device-status';
-export { DeviceStatusChecker } from './device-status';
-export type { SDKConfigurationParameters } from './sdk-config';
-export { createSDKConfig, createSDKConfigWithVersion, SDKConfiguration } from './sdk-config';
-export type { FetchLike, HttpError } from './fetch';
-export { createFetchWrapper, environment, getEnvironmentFetch, resolveFetch } from './fetch';
-export type { Configuration, ConfigurationParameters } from './generated/v2/runtime';

package/dist/src/index.js

@@ -1,66 +0,0 @@
-"use strict";
-/**
- * KeepKey SDK v2 with Automatic Version Detection
- *
- * This SDK automatically detects whether it's connecting to a v1 or v2 API
- * and routes requests accordingly.
- *
- * Usage:
- *
- * ```typescript
- * import { createSDKConfig } from '@keepkey/keepkey-sdk';
- *
- * // Automatic version detection (recommended)
- * const config = createSDKConfig({
- *   basePath: 'http://localhost:1646'
- * });
- *
- * // Get version info
- * const versionInfo = await config.getVersionInfo();
- * console.log(`API version: ${versionInfo.apiVersion}`);
- * console.log(`Supported chains: ${versionInfo.supportedChains.length}`);
- *
- * // Manual version override (skip detection)
- * const config = createSDKConfigWithVersion(2, {
- *   basePath: 'http://localhost:1646'
- * });
- * ```
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveFetch = exports.getEnvironmentFetch = exports.environment = exports.createFetchWrapper = exports.SDKConfiguration = exports.createSDKConfigWithVersion = exports.createSDKConfig = exports.DeviceStatusChecker = exports.VersionDetector = exports.SpecLoader = exports.VersionRouter = exports.KeepKeySdk = void 0;
-var KeepKeySdk_1 = require("./KeepKeySdk");
-Object.defineProperty(exports, "KeepKeySdk", { enumerable: true, get: function () { return KeepKeySdk_1.KeepKeySdk; } });
-// Export generated API (v2 by default for backward compatibility)
-__exportStar(require("./generated/v2"), exports);
-// Export version detection
-var version_router_1 = require("./middleware/version-router");
-Object.defineProperty(exports, "VersionRouter", { enumerable: true, get: function () { return version_router_1.VersionRouter; } });
-var spec_loader_1 = require("./spec-loader");
-Object.defineProperty(exports, "SpecLoader", { enumerable: true, get: function () { return spec_loader_1.SpecLoader; } });
-var version_detector_1 = require("./version-detector");
-Object.defineProperty(exports, "VersionDetector", { enumerable: true, get: function () { return version_detector_1.VersionDetector; } });
-var device_status_1 = require("./device-status");
-Object.defineProperty(exports, "DeviceStatusChecker", { enumerable: true, get: function () { return device_status_1.DeviceStatusChecker; } });
-var sdk_config_1 = require("./sdk-config");
-Object.defineProperty(exports, "createSDKConfig", { enumerable: true, get: function () { return sdk_config_1.createSDKConfig; } });
-Object.defineProperty(exports, "createSDKConfigWithVersion", { enumerable: true, get: function () { return sdk_config_1.createSDKConfigWithVersion; } });
-Object.defineProperty(exports, "SDKConfiguration", { enumerable: true, get: function () { return sdk_config_1.SDKConfiguration; } });
-var fetch_1 = require("./fetch");
-Object.defineProperty(exports, "createFetchWrapper", { enumerable: true, get: function () { return fetch_1.createFetchWrapper; } });
-Object.defineProperty(exports, "environment", { enumerable: true, get: function () { return fetch_1.environment; } });
-Object.defineProperty(exports, "getEnvironmentFetch", { enumerable: true, get: function () { return fetch_1.getEnvironmentFetch; } });
-Object.defineProperty(exports, "resolveFetch", { enumerable: true, get: function () { return fetch_1.resolveFetch; } });

package/dist/src/middleware/version-router.d.ts

@@ -1,46 +0,0 @@
-/**
- * Version-Aware Request Router
- *
- * Routes endpoints based on detected API version with intelligent fallback.
- */
-import type { ApiVersionInfo } from '../version-detector';
-export declare class VersionRouter {
-    private apiVersionInfo;
-    constructor(apiVersionInfo: ApiVersionInfo);
-    /**
-     * Routes endpoint based on API version.
-     * Falls back to v1 endpoint if v2 unavailable.
-     *
-     * @param v1Endpoint - The v1 API endpoint path
-     * @param v2Endpoint - Optional v2 API endpoint path
-     * @returns The appropriate endpoint to use
-     */
-    routeEndpoint(v1Endpoint: string, v2Endpoint?: string): string;
-    /**
-     * Checks if a feature/chain is supported by current API version.
-     *
-     * @param feature - Feature or chain identifier to check
-     * @returns true if supported, false otherwise
-     */
-    isFeatureSupported(feature: string): boolean;
-    /**
-     * Checks if a string is a chain identifier
-     */
-    private isChainIdentifier;
-    /**
-     * Matches a CAIP-2 network ID with a chain symbol
-     */
-    private matchesChain;
-    /**
-     * Gets current API version
-     */
-    getApiVersion(): number;
-    /**
-     * Gets version info
-     */
-    getVersionInfo(): ApiVersionInfo;
-    /**
-     * Updates version info (e.g., after re-detection)
-     */
-    updateVersionInfo(apiVersionInfo: ApiVersionInfo): void;
-}

package/dist/src/middleware/version-router.js

@@ -1,150 +0,0 @@
-"use strict";
-/**
- * Version-Aware Request Router
- *
- * Routes endpoints based on detected API version with intelligent fallback.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VersionRouter = void 0;
-class VersionRouter {
-    constructor(apiVersionInfo) {
-        this.apiVersionInfo = apiVersionInfo;
-    }
-    /**
-     * Routes endpoint based on API version.
-     * Falls back to v1 endpoint if v2 unavailable.
-     *
-     * @param v1Endpoint - The v1 API endpoint path
-     * @param v2Endpoint - Optional v2 API endpoint path
-     * @returns The appropriate endpoint to use
-     */
-    routeEndpoint(v1Endpoint, v2Endpoint) {
-        const apiVersion = this.apiVersionInfo.apiVersion;
-        // If v2 API detected and v2 endpoint provided, use v2
-        if (apiVersion === 2 && v2Endpoint) {
-            console.log(`[VersionRouter] Routing to v2: ${v2Endpoint}`);
-            return v2Endpoint;
-        }
-        // Otherwise use v1 endpoint
-        if (apiVersion === 2 && !v2Endpoint) {
-            console.log(`[VersionRouter] No v2 endpoint available, using v1: ${v1Endpoint}`);
-        }
-        return v1Endpoint;
-    }
-    /**
-     * Checks if a feature/chain is supported by current API version.
-     *
-     * @param feature - Feature or chain identifier to check
-     * @returns true if supported, false otherwise
-     */
-    isFeatureSupported(feature) {
-        const supportedChains = this.apiVersionInfo.supportedChains || [];
-        // Check if it's a known chain identifier (CAIP-2 format or known symbol)
-        if (this.isChainIdentifier(feature)) {
-            // Check both CAIP-2 network ID and symbol formats
-            const isSupported = supportedChains.some(chain => chain === feature || this.matchesChain(chain, feature));
-            if (!isSupported) {
-                console.warn(`[VersionRouter] Chain ${feature} not in supported chains list`);
-            }
-            return isSupported;
-        }
-        // For unknown strings, do a final case-insensitive check against supported chains
-        // This handles any chain symbols we may have missed in our chainSymbols list
-        const normalizedFeature = feature.toUpperCase();
-        const isSupported = supportedChains.some(chain => {
-            // Check exact match (case-insensitive)
-            if (chain.toUpperCase() === normalizedFeature) {
-                return true;
-            }
-            // Check if it matches any known chain symbol via mapping
-            return this.matchesChain(chain, feature);
-        });
-        if (!isSupported) {
-            console.warn(`[VersionRouter] Feature/chain ${feature} not supported`);
-        }
-        return isSupported;
-    }
-    /**
-     * Checks if a string is a chain identifier
-     */
-    isChainIdentifier(value) {
-        // CAIP-2 format: namespace:reference
-        if (value.includes(':')) {
-            return true;
-        }
-        // Common chain symbols
-        const chainSymbols = [
-            'SOL',
-            'TRX',
-            'TON',
-            'ZEC',
-            'BTC',
-            'ETH',
-            'GAIA',
-            'OSMO',
-            'XRP',
-            'LTC',
-            'DOGE',
-            'BCH',
-            'DASH',
-            'DGB',
-            'MATIC',
-            'BASE',
-            'BSC',
-            'MON',
-            'HYPE',
-            'MAYA',
-            'THOR',
-        ];
-        return chainSymbols.includes(value.toUpperCase());
-    }
-    /**
-     * Matches a CAIP-2 network ID with a chain symbol
-     */
-    matchesChain(caipId, symbol) {
-        // Simple mapping of CAIP-2 IDs to common symbols
-        const chainMap = {
-            'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp': 'SOL',
-            'tron:27Lqcw': 'TRX',
-            'ton:-239': 'TON',
-            'bip122:00040fe8ec8471911baa1db1266ea15d': 'ZEC',
-            'bip122:000000000019d6689c085ae165831e93': 'BTC',
-            'eip155:1': 'ETH',
-            'cosmos:cosmoshub-4': 'GAIA',
-            'cosmos:osmosis-1': 'OSMO',
-            'ripple:4109c6f2045fc7eff4cde8f9905d19c2': 'XRP',
-            'bip122:12a765e31ffd4059bada1e25190f6e98': 'LTC',
-            'bip122:00000000001a91e3dace36e2be3bf030': 'DOGE',
-            'bip122:000000000000000000651ef99cb9fcbe': 'BCH',
-            'bip122:000007d91d1254d60e2dd1ae58038307': 'DASH',
-            'bip122:4da631f2ac1bed857bd968c67c913978': 'DGB',
-            'eip155:137': 'MATIC',
-            'eip155:8453': 'BASE',
-            'eip155:56': 'BSC',
-            'eip155:143': 'MON',
-            'eip155:2868': 'HYPE',
-            'cosmos:mayachain-mainnet-v1': 'MAYA',
-            'cosmos:thorchain-mainnet-v1': 'THOR',
-        };
-        return chainMap[caipId]?.toUpperCase() === symbol.toUpperCase();
-    }
-    /**
-     * Gets current API version
-     */
-    getApiVersion() {
-        return this.apiVersionInfo.apiVersion;
-    }
-    /**
-     * Gets version info
-     */
-    getVersionInfo() {
-        return this.apiVersionInfo;
-    }
-    /**
-     * Updates version info (e.g., after re-detection)
-     */
-    updateVersionInfo(apiVersionInfo) {
-        this.apiVersionInfo = apiVersionInfo;
-    }
-}
-exports.VersionRouter = VersionRouter;

package/dist/src/sdk-config.d.ts

@@ -1,85 +0,0 @@
-/**
- * Enhanced SDK Configuration with Version Detection
- *
- * Extends the generated Configuration with automatic API version detection
- * and intelligent routing between v1 and v2 APIs.
- */
-import type { FetchLike } from './fetch';
-import type { ConfigurationParameters } from './generated/v2/runtime';
-import { Configuration } from './generated/v2/runtime';
-import { VersionRouter } from './middleware/version-router';
-import type { ApiVersionInfo } from './version-detector';
-import { VersionDetector } from './version-detector';
-export interface SDKConfigurationParameters extends ConfigurationParameters {
-    /**
-     * Optional fetch implementation for environments without native fetch
-     * (e.g. Node.js <18, React Native)
-     */
-    fetch?: FetchLike;
-    /**
-     * Enable automatic version detection via /api/health endpoint
-     * @default true
-     */
-    autoDetectVersion?: boolean;
-    /**
-     * Manually specify API version (bypasses auto-detection)
-     * @default undefined (auto-detect)
-     */
-    apiVersion?: number;
-    /**
-     * Custom version detector instance
-     * @default undefined (creates new instance)
-     */
-    versionDetector?: VersionDetector;
-}
-export declare class SDKConfiguration extends Configuration {
-    private versionDetector;
-    private versionRouter?;
-    private apiVersionInfo?;
-    private autoDetectVersion;
-    private manualApiVersion?;
-    private versionDetectionPromise?;
-    constructor(params?: SDKConfigurationParameters);
-    /**
-     * Initialize version detection.
-     * This is called automatically when needed, but can be called explicitly for early detection.
-     */
-    initVersionDetection(): Promise<ApiVersionInfo>;
-    private performVersionDetection;
-    /**
-     * Get current API version (may trigger detection if not yet initialized)
-     */
-    getApiVersion(): Promise<number>;
-    /**
-     * Get full version information (may trigger detection if not yet initialized)
-     */
-    getVersionInfo(): Promise<ApiVersionInfo>;
-    /**
-     * Get version router (may trigger detection if not yet initialized)
-     */
-    getVersionRouter(): Promise<VersionRouter>;
-    /**
-     * Check if a feature/chain is supported
-     */
-    isFeatureSupported(feature: string): Promise<boolean>;
-    /**
-     * Clear cached version information and force re-detection
-     */
-    clearVersionCache(): void;
-    /**
-     * Get synchronous API version (returns undefined if not yet detected)
-     */
-    getApiVersionSync(): number | undefined;
-    /**
-     * Check if version detection has completed
-     */
-    isVersionDetected(): boolean;
-}
-/**
- * Create an SDK configuration with automatic version detection
- */
-export declare function createSDKConfig(params?: SDKConfigurationParameters): SDKConfiguration;
-/**
- * Create an SDK configuration with manual version override
- */
-export declare function createSDKConfigWithVersion(apiVersion: number, params?: ConfigurationParameters): SDKConfiguration;

package/dist/src/sdk-config.js

@@ -1,151 +0,0 @@
-"use strict";
-/**
- * Enhanced SDK Configuration with Version Detection
- *
- * Extends the generated Configuration with automatic API version detection
- * and intelligent routing between v1 and v2 APIs.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSDKConfigWithVersion = exports.createSDKConfig = exports.SDKConfiguration = void 0;
-const fetch_1 = require("./fetch");
-const runtime_1 = require("./generated/v2/runtime");
-const version_router_1 = require("./middleware/version-router");
-const version_detector_1 = require("./version-detector");
-class SDKConfiguration extends runtime_1.Configuration {
-    constructor(params = {}) {
-        // Create universal fetch wrapper
-        const fetchImpl = params.fetch || (0, fetch_1.getEnvironmentFetch)();
-        const fetchWrapper = (0, fetch_1.createFetchWrapper)(fetchImpl);
-        // Configure with wrapped fetch
-        super({
-            ...params,
-            fetchApi: fetchWrapper,
-        });
-        this.autoDetectVersion = params.autoDetectVersion !== false; // Default to true
-        this.manualApiVersion = params.apiVersion;
-        this.versionDetector =
-            params.versionDetector || new version_detector_1.VersionDetector(this.basePath, fetchWrapper);
-    }
-    /**
-     * Initialize version detection.
-     * This is called automatically when needed, but can be called explicitly for early detection.
-     */
-    async initVersionDetection() {
-        // Return cached version if available
-        if (this.apiVersionInfo) {
-            return this.apiVersionInfo;
-        }
-        // Return in-flight promise if detection is already running
-        if (this.versionDetectionPromise) {
-            return this.versionDetectionPromise;
-        }
-        // Start new detection
-        this.versionDetectionPromise = this.performVersionDetection();
-        try {
-            this.apiVersionInfo = await this.versionDetectionPromise;
-            this.versionRouter = new version_router_1.VersionRouter(this.apiVersionInfo);
-            return this.apiVersionInfo;
-        }
-        finally {
-            this.versionDetectionPromise = undefined;
-        }
-    }
-    async performVersionDetection() {
-        // Manual override takes precedence
-        if (this.manualApiVersion) {
-            console.log(`[SDKConfiguration] Using manual API version: ${this.manualApiVersion}`);
-            return {
-                apiVersion: this.manualApiVersion,
-                version: `${this.manualApiVersion}.0.0`,
-                supportedChains: [],
-            };
-        }
-        // Auto-detect if enabled
-        if (this.autoDetectVersion) {
-            console.log('[SDKConfiguration] Auto-detecting API version...');
-            return await this.versionDetector.detectVersion();
-        }
-        // Default to v1 if auto-detection disabled
-        console.log('[SDKConfiguration] Auto-detection disabled, defaulting to v1');
-        return {
-            apiVersion: 1,
-            version: '1.0.0',
-            supportedChains: [],
-        };
-    }
-    /**
-     * Get current API version (may trigger detection if not yet initialized)
-     */
-    async getApiVersion() {
-        if (!this.apiVersionInfo) {
-            await this.initVersionDetection();
-        }
-        return this.apiVersionInfo.apiVersion;
-    }
-    /**
-     * Get full version information (may trigger detection if not yet initialized)
-     */
-    async getVersionInfo() {
-        if (!this.apiVersionInfo) {
-            await this.initVersionDetection();
-        }
-        return this.apiVersionInfo;
-    }
-    /**
-     * Get version router (may trigger detection if not yet initialized)
-     */
-    async getVersionRouter() {
-        if (!this.versionRouter) {
-            await this.initVersionDetection();
-        }
-        return this.versionRouter;
-    }
-    /**
-     * Check if a feature/chain is supported
-     */
-    async isFeatureSupported(feature) {
-        const router = await this.getVersionRouter();
-        return router.isFeatureSupported(feature);
-    }
-    /**
-     * Clear cached version information and force re-detection
-     */
-    clearVersionCache() {
-        this.apiVersionInfo = undefined;
-        this.versionRouter = undefined;
-        this.versionDetectionPromise = undefined;
-        this.versionDetector.clearCache();
-        console.log('[SDKConfiguration] Version cache cleared');
-    }
-    /**
-     * Get synchronous API version (returns undefined if not yet detected)
-     */
-    getApiVersionSync() {
-        return this.apiVersionInfo?.apiVersion;
-    }
-    /**
-     * Check if version detection has completed
-     */
-    isVersionDetected() {
-        return this.apiVersionInfo !== undefined;
-    }
-}
-exports.SDKConfiguration = SDKConfiguration;
-/**
- * Create an SDK configuration with automatic version detection
- */
-function createSDKConfig(params = {}) {
-    return new SDKConfiguration(params);
-}
-exports.createSDKConfig = createSDKConfig;
-/**
- * Create an SDK configuration with manual version override
- */
-function createSDKConfigWithVersion(apiVersion, params = {}) {
-    return new SDKConfiguration({
-        ...params,
-        apiVersion,
-        autoDetectVersion: false,
-    });
-}
-exports.createSDKConfigWithVersion = createSDKConfigWithVersion;

package/dist/src/spec-loader.d.ts

@@ -1,45 +0,0 @@
-/**
- * OpenAPI Spec Loader
- *
- * Loads the appropriate OpenAPI spec based on detected API version.
- */
-export interface OpenAPISpec {
-    openapi: string;
-    info: {
-        title: string;
-        version: string;
-        [key: string]: any;
-    };
-    servers: {
-        url: string;
-        [key: string]: any;
-    }[];
-    paths: Record<string, any>;
-    components?: Record<string, any>;
-    [key: string]: any;
-}
-export declare class SpecLoader {
-    /**
-     * Loads the appropriate OpenAPI spec based on detected API version
-     */
-    static loadSpec(apiVersion: number): OpenAPISpec;
-    /**
-     * Gets the base path from the spec
-     */
-    static getBasePath(spec: OpenAPISpec): string;
-    /**
-     * Gets spec version information
-     */
-    static getSpecInfo(apiVersion: number): {
-        title: string;
-        version: string;
-    };
-    /**
-     * Checks if a path exists in the spec
-     */
-    static hasPath(apiVersion: number, path: string): boolean;
-    /**
-     * Gets all paths from the spec
-     */
-    static getPaths(apiVersion: number): string[];
-}

package/dist/src/spec-loader.js

@@ -1,60 +0,0 @@
-"use strict";
-/**
- * OpenAPI Spec Loader
- *
- * Loads the appropriate OpenAPI spec based on detected API version.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpecLoader = void 0;
-const swagger_json_1 = __importDefault(require("../specs/v1/swagger.json"));
-const swagger_json_2 = __importDefault(require("../specs/v2/swagger.json"));
-class SpecLoader {
-    /**
-     * Loads the appropriate OpenAPI spec based on detected API version
-     */
-    static loadSpec(apiVersion) {
-        if (apiVersion === 2) {
-            console.log('[SpecLoader] Loading v2 API spec');
-            return swagger_json_2.default;
-        }
-        console.log('[SpecLoader] Loading v1 API spec');
-        return swagger_json_1.default;
-    }
-    /**
-     * Gets the base path from the spec
-     */
-    static getBasePath(spec) {
-        if (spec.servers && spec.servers.length > 0) {
-            return spec.servers[0].url;
-        }
-        return '/api';
-    }
-    /**
-     * Gets spec version information
-     */
-    static getSpecInfo(apiVersion) {
-        const spec = SpecLoader.loadSpec(apiVersion);
-        return {
-            title: spec.info.title,
-            version: spec.info.version,
-        };
-    }
-    /**
-     * Checks if a path exists in the spec
-     */
-    static hasPath(apiVersion, path) {
-        const spec = SpecLoader.loadSpec(apiVersion);
-        return path in spec.paths;
-    }
-    /**
-     * Gets all paths from the spec
-     */
-    static getPaths(apiVersion) {
-        const spec = SpecLoader.loadSpec(apiVersion);
-        return Object.keys(spec.paths);
-    }
-}
-exports.SpecLoader = SpecLoader;

package/dist/src/version-detector.d.ts

@@ -1,35 +0,0 @@
-/**
- * API Version Detection
- *
- * Detects the API version by calling /api/health endpoint.
- * Returns version information or defaults to v1 if detection fails.
- */
-export interface ApiVersionInfo {
-    apiVersion: number;
-    version: string;
-    supportedChains: string[];
-}
-export declare class VersionDetector {
-    private basePath;
-    private cachedVersion;
-    private fetchFn;
-    constructor(basePath: string, fetchFn?: typeof fetch);
-    /**
-     * Detects API version by fetching /spec/swagger.json and reading info.version.
-     * Returns version info or defaults to v1 if detection fails.
-     * Results are cached after first successful detection.
-     */
-    detectVersion(): Promise<ApiVersionInfo>;
-    /**
-     * Returns default v1 version info
-     */
-    private defaultToV1;
-    /**
-     * Clears cached version information, forcing re-detection on next call
-     */
-    clearCache(): void;
-    /**
-     * Returns cached version info without performing detection
-     */
-    getCached(): ApiVersionInfo | null;
-}