keepkey-vault-sdk 1.2.5 → 2.0.0

package/dist/src/sdk-config.js

@@ -1,145 +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 { createFetchWrapper, getEnvironmentFetch } from './fetch';
-import { Configuration } from './generated/v2/runtime';
-import { VersionRouter } from './middleware/version-router';
-import { VersionDetector } from './version-detector';
-export class SDKConfiguration extends Configuration {
-    constructor(params = {}) {
-        // Create universal fetch wrapper
-        const fetchImpl = params.fetch || getEnvironmentFetch();
-        const fetchWrapper = 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 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 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;
-    }
-}
-/**
- * Create an SDK configuration with automatic version detection
- */
-export function createSDKConfig(params = {}) {
-    return new SDKConfiguration(params);
-}
-/**
- * Create an SDK configuration with manual version override
- */
-export function createSDKConfigWithVersion(apiVersion, params = {}) {
-    return new SDKConfiguration({
-        ...params,
-        apiVersion,
-        autoDetectVersion: false,
-    });
-}

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,53 +0,0 @@
-/**
- * OpenAPI Spec Loader
- *
- * Loads the appropriate OpenAPI spec based on detected API version.
- */
-import v1Spec from '../specs/v1/swagger.json';
-import v2Spec from '../specs/v2/swagger.json';
-export 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 v2Spec;
-        }
-        console.log('[SpecLoader] Loading v1 API spec');
-        return v1Spec;
-    }
-    /**
-     * 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);
-    }
-}

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;
-}

package/dist/src/version-detector.js

@@ -1,100 +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 class VersionDetector {
-    constructor(basePath, fetchFn) {
-        this.cachedVersion = null;
-        this.basePath = basePath.replace(/\/+$/, ''); // Remove trailing slashes
-        this.fetchFn = fetchFn || globalThis.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.
-     */
-    async detectVersion() {
-        // Return cached version if available
-        if (this.cachedVersion) {
-            return this.cachedVersion;
-        }
-        try {
-            const response = await this.fetchFn(`${this.basePath}/spec/swagger.json`, {
-                method: 'GET',
-                headers: {
-                    Accept: 'application/json',
-                },
-            });
-            if (!response.ok) {
-                console.warn(`[VersionDetector] Swagger spec fetch failed with status ${response.status}, defaulting to v1`);
-                return this.defaultToV1();
-            }
-            const spec = await response.json();
-            const specVersion = spec?.info?.version || '0.1.1';
-            // Detect API version based on spec version
-            // v1: version 0.x.x or 1.x.x
-            // v2: version 2.x.x or higher
-            const majorVersion = parseInt(specVersion.split('.')[0], 10);
-            if (majorVersion >= 2) {
-                this.cachedVersion = {
-                    apiVersion: 2,
-                    version: specVersion,
-                    supportedChains: [
-                        'BTC',
-                        'ETH',
-                        'BNB',
-                        'GAIA',
-                        'OSMO',
-                        'MAYA',
-                        'THOR',
-                        'XRP',
-                        'SOL',
-                        'TRX',
-                        'TON',
-                    ], // v2 supports all chains including new ones
-                };
-                console.log(`[VersionDetector] Detected API v2 (spec version ${specVersion})`);
-                return this.cachedVersion;
-            }
-            // v1 API - older chains only (no SOL, TRX, TON)
-            console.log(`[VersionDetector] Detected API v1 (spec version ${specVersion})`);
-            this.cachedVersion = {
-                apiVersion: 1,
-                version: specVersion,
-                supportedChains: ['BTC', 'ETH', 'BNB', 'GAIA', 'OSMO', 'MAYA', 'THOR', 'XRP'],
-            };
-            return this.cachedVersion;
-        }
-        catch (error) {
-            console.warn('[VersionDetector] Version detection failed:', error);
-            console.warn('[VersionDetector] Defaulting to v1');
-            return this.defaultToV1();
-        }
-    }
-    /**
-     * Returns default v1 version info
-     */
-    defaultToV1() {
-        const v1Info = {
-            apiVersion: 1,
-            version: '1.0.0',
-            supportedChains: ['BTC', 'ETH', 'BNB', 'GAIA', 'OSMO', 'MAYA', 'THOR', 'XRP'],
-        };
-        this.cachedVersion = v1Info;
-        return v1Info;
-    }
-    /**
-     * Clears cached version information, forcing re-detection on next call
-     */
-    clearCache() {
-        this.cachedVersion = null;
-    }
-    /**
-     * Returns cached version info without performing detection
-     */
-    getCached() {
-        return this.cachedVersion;
-    }
-}