@robinmordasiewicz/f5xc-auth 1.0.0

package/dist/auth/http-client.js

@@ -0,0 +1,255 @@
+/**
+ * Authenticated HTTP Client for F5 Distributed Cloud API
+ *
+ * Provides a configured Axios client for making authenticated API requests.
+ * Supports both API token and P12 certificate (mTLS) authentication.
+ */
+import axios from "axios";
+import https from "https";
+import { AuthMode } from "./credential-manager.js";
+import { logger } from "../utils/logging.js";
+import { F5XCApiError, AuthenticationError, wrapSSLError } from "../utils/errors.js";
+/**
+ * Default HTTP client configuration
+ */
+const DEFAULT_CONFIG = {
+    timeout: 30000, // 30 seconds
+    headers: {},
+    debug: false,
+};
+/**
+ * HTTP Client for F5XC API
+ *
+ * Creates and manages an authenticated Axios instance for making
+ * API requests to F5 Distributed Cloud.
+ */
+export class HttpClient {
+    client = null;
+    credentialManager;
+    config;
+    constructor(credentialManager, config = {}) {
+        this.credentialManager = credentialManager;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (this.credentialManager.isAuthenticated()) {
+            this.client = this.createClient();
+        }
+    }
+    /**
+     * Build HTTPS agent options from credential manager TLS configuration
+     * Handles SSL/TLS configuration including insecure mode and custom CA
+     */
+    buildHttpsAgentOptions() {
+        const options = {
+            rejectUnauthorized: true, // Secure default
+        };
+        // Check for custom CA bundle
+        const caBundle = this.credentialManager.getCaBundle();
+        if (caBundle) {
+            options.ca = caBundle;
+            logger.info("Using custom CA bundle for TLS verification");
+        }
+        // Check for insecure mode (staging/development ONLY)
+        const tlsInsecure = this.credentialManager.getTlsInsecure();
+        if (tlsInsecure) {
+            options.rejectUnauthorized = false;
+            // Output to stderr for maximum visibility (always shown, even if logs are filtered)
+            const apiUrl = this.credentialManager.getApiUrl() ?? "unknown";
+            console.error("\n\x1b[33m⚠️  WARNING: TLS certificate verification is DISABLED\x1b[0m");
+            console.error(`   URL: ${apiUrl}`);
+            console.error("   This should ONLY be used for staging/development environments!");
+            console.error("   Consider using F5XC_CA_BUNDLE for a more secure solution.\n");
+            logger.warn("TLS certificate verification DISABLED - this is insecure and should only be used for staging/development");
+        }
+        return options;
+    }
+    /**
+     * Create configured Axios client
+     */
+    createClient() {
+        const authMode = this.credentialManager.getAuthMode();
+        const baseURL = this.credentialManager.getApiUrl();
+        if (!baseURL) {
+            throw new AuthenticationError("API URL not configured");
+        }
+        const axiosConfig = {
+            baseURL,
+            timeout: this.config.timeout,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                ...this.config.headers,
+            },
+        };
+        // Get TLS configuration options
+        const tlsOptions = this.buildHttpsAgentOptions();
+        // Configure authentication
+        if (authMode === AuthMode.TOKEN) {
+            const token = this.credentialManager.getToken();
+            if (!token) {
+                throw new AuthenticationError("API token not configured");
+            }
+            axiosConfig.headers = {
+                ...axiosConfig.headers,
+                Authorization: `APIToken ${token}`,
+            };
+            // Apply TLS configuration for token auth (needed for custom CA or insecure mode)
+            if (tlsOptions.ca || !tlsOptions.rejectUnauthorized) {
+                axiosConfig.httpsAgent = new https.Agent(tlsOptions);
+            }
+        }
+        else if (authMode === AuthMode.CERTIFICATE) {
+            const p12Buffer = this.credentialManager.getP12Certificate();
+            const cert = this.credentialManager.getCert();
+            const key = this.credentialManager.getKey();
+            if (p12Buffer) {
+                // Create HTTPS agent with P12 certificate for mTLS
+                // F5XC P12 certificates typically don't require a password
+                axiosConfig.httpsAgent = new https.Agent({
+                    ...tlsOptions,
+                    pfx: p12Buffer,
+                });
+            }
+            else if (cert && key) {
+                // Create HTTPS agent with separate cert/key for mTLS
+                axiosConfig.httpsAgent = new https.Agent({
+                    ...tlsOptions,
+                    cert,
+                    key,
+                });
+            }
+            else {
+                throw new AuthenticationError("Certificate not loaded - provide P12 bundle or cert/key pair");
+            }
+        }
+        const client = axios.create(axiosConfig);
+        // Add request interceptor for logging
+        client.interceptors.request.use((config) => {
+            // Add request timestamp for duration calculation
+            config.metadata = {
+                startTime: Date.now(),
+            };
+            if (this.config.debug) {
+                logger.debug("API Request", {
+                    method: config.method?.toUpperCase(),
+                    url: config.url,
+                    baseURL: config.baseURL,
+                });
+            }
+            return config;
+        }, (error) => {
+            logger.error("Request interceptor error", { error });
+            return Promise.reject(error);
+        });
+        // Add response interceptor for logging and error handling
+        client.interceptors.response.use((response) => {
+            const config = response.config;
+            const duration = config.metadata ? Date.now() - config.metadata.startTime : 0;
+            if (this.config.debug) {
+                logger.debug("API Response", {
+                    status: response.status,
+                    url: response.config.url,
+                    duration: `${duration}ms`,
+                });
+            }
+            return response;
+        }, (error) => {
+            if (axios.isAxiosError(error)) {
+                // Check for SSL/TLS certificate errors first
+                const errorCode = error.code?.toLowerCase() ?? "";
+                const errorMessage = error.message.toLowerCase();
+                if (errorCode === "err_tls_cert_altname_invalid" ||
+                    errorCode === "unable_to_verify_leaf_signature" ||
+                    errorCode === "depth_zero_self_signed_cert" ||
+                    errorCode === "cert_has_expired" ||
+                    errorMessage.includes("certificate") ||
+                    errorMessage.includes("altnames") ||
+                    errorMessage.includes("self signed")) {
+                    // Wrap SSL error with actionable guidance
+                    throw wrapSSLError(error, baseURL);
+                }
+                const status = error.response?.status;
+                const message = error.response?.data?.message ?? error.message;
+                logger.error("API Error", {
+                    status,
+                    message,
+                    url: error.config?.url,
+                });
+                // Transform to F5XC API error
+                throw new F5XCApiError(message, status, error.response?.data);
+            }
+            throw error;
+        });
+        logger.info("HTTP client created", {
+            baseURL,
+            authMode,
+            timeout: this.config.timeout,
+        });
+        return client;
+    }
+    /**
+     * Check if the client is available (authenticated mode)
+     */
+    isAvailable() {
+        return this.client !== null;
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path, config) {
+        return this.request("GET", path, undefined, config);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, data, config) {
+        return this.request("POST", path, data, config);
+    }
+    /**
+     * Make a PUT request
+     */
+    async put(path, data, config) {
+        return this.request("PUT", path, data, config);
+    }
+    /**
+     * Make a DELETE request
+     */
+    async delete(path, config) {
+        return this.request("DELETE", path, undefined, config);
+    }
+    /**
+     * Make a generic request
+     */
+    async request(method, path, data, config) {
+        if (!this.client) {
+            throw new AuthenticationError("HTTP client not available - server is in documentation mode. " +
+                "Set F5XC_API_URL and F5XC_API_TOKEN (or F5XC_P12_BUNDLE for certificate auth) to enable API execution.");
+        }
+        const startTime = Date.now();
+        const response = await this.client.request({
+            method,
+            url: path,
+            data,
+            ...config,
+        });
+        const duration = Date.now() - startTime;
+        return {
+            data: response.data,
+            status: response.status,
+            headers: response.headers,
+            duration,
+        };
+    }
+    /**
+     * Get the underlying Axios instance
+     */
+    getAxiosInstance() {
+        return this.client;
+    }
+}
+/**
+ * Create HTTP client from credential manager
+ */
+export function createHttpClient(credentialManager, config) {
+    return new HttpClient(credentialManager, config);
+}
+//# sourceMappingURL=http-client.js.map

package/dist/auth/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/auth/http-client.ts"],"names":[],"mappings":"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"}

package/dist/auth/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Auth module exports
+ */
+export * from "./credential-manager.js";
+export * from "./http-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,6 @@
+/**
+ * Auth module exports
+ */
+export * from "./credential-manager.js";
+export * from "./http-client.js";
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Config module exports
+ */
+export * from "./paths.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,5 @@
+/**
+ * Config module exports
+ */
+export * from "./paths.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,36 @@
+/**
+ * XDG Base Directory compliant paths for F5 XC configuration
+ * See: https://specifications.freedesktop.org/basedir/latest/
+ *
+ * This is the single source of truth for all application paths.
+ * All modules should import from here instead of constructing paths directly.
+ *
+ * Default paths:
+ * - Config: ~/.config/f5xc/
+ * - State: ~/.local/state/f5xc/
+ */
+/**
+ * Get XDG-compliant config directory
+ * Config files: settings, profiles, preferences
+ * Default: ~/.config/f5xc
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get XDG-compliant state directory
+ * State files: history, logs, undo history, session state
+ * Default: ~/.local/state/f5xc
+ */
+export declare function getStateDir(): string;
+/**
+ * Centralized path definitions
+ * Use these getters for all file path access throughout the application
+ */
+export declare const paths: {
+    readonly configDir: string;
+    readonly profilesDir: string;
+    readonly activeProfile: string;
+    readonly settings: string;
+    readonly stateDir: string;
+    readonly history: string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;wBAEC,MAAM;0BAGJ,MAAM;4BAGJ,MAAM;uBAGX,MAAM;uBAKN,MAAM;sBAGP,MAAM;CAGtB,CAAC"}

package/dist/config/paths.js

@@ -0,0 +1,68 @@
+/**
+ * XDG Base Directory compliant paths for F5 XC configuration
+ * See: https://specifications.freedesktop.org/basedir/latest/
+ *
+ * This is the single source of truth for all application paths.
+ * All modules should import from here instead of constructing paths directly.
+ *
+ * Default paths:
+ * - Config: ~/.config/f5xc/
+ * - State: ~/.local/state/f5xc/
+ */
+import { homedir } from "os";
+import { join } from "path";
+/**
+ * Application name for XDG-compliant directory structure
+ */
+const APP_NAME = "f5xc";
+/**
+ * Get XDG-compliant config directory
+ * Config files: settings, profiles, preferences
+ * Default: ~/.config/f5xc
+ */
+export function getConfigDir() {
+    const xdgConfig = process.env.XDG_CONFIG_HOME;
+    if (xdgConfig) {
+        return join(xdgConfig, APP_NAME);
+    }
+    return join(homedir(), ".config", APP_NAME);
+}
+/**
+ * Get XDG-compliant state directory
+ * State files: history, logs, undo history, session state
+ * Default: ~/.local/state/f5xc
+ */
+export function getStateDir() {
+    const xdgState = process.env.XDG_STATE_HOME;
+    if (xdgState) {
+        return join(xdgState, APP_NAME);
+    }
+    return join(homedir(), ".local", "state", APP_NAME);
+}
+/**
+ * Centralized path definitions
+ * Use these getters for all file path access throughout the application
+ */
+export const paths = {
+    // Config files (XDG_CONFIG_HOME)
+    get configDir() {
+        return getConfigDir();
+    },
+    get profilesDir() {
+        return join(getConfigDir(), "profiles");
+    },
+    get activeProfile() {
+        return join(getConfigDir(), "active_profile");
+    },
+    get settings() {
+        return join(getConfigDir(), "config.yaml");
+    },
+    // State files (XDG_STATE_HOME)
+    get stateDir() {
+        return getStateDir();
+    },
+    get history() {
+        return join(getStateDir(), "history");
+    },
+};
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,QAAQ,GAAG,MAAM,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,iCAAiC;IACjC,IAAI,SAAS;QACX,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ;QACV,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @robinmordasiewicz/f5xc-auth
+ *
+ * Shared authentication library for F5 Distributed Cloud MCP servers.
+ * Provides XDG-compliant profile management and credential handling.
+ *
+ * @example
+ * ```typescript
+ * import { CredentialManager, ProfileManager, getProfileManager } from '@robinmordasiewicz/f5xc-auth';
+ *
+ * // Initialize credentials
+ * const credentialManager = new CredentialManager();
+ * await credentialManager.initialize();
+ *
+ * if (credentialManager.isAuthenticated()) {
+ *   console.log(`Authenticated as: ${credentialManager.getTenant()}`);
+ * }
+ *
+ * // Manage profiles
+ * const profileManager = getProfileManager();
+ * const profiles = await profileManager.list();
+ * ```
+ */
+export { CredentialManager, AuthMode, AUTH_ENV_VARS, normalizeApiUrl, extractTenantFromUrl, type Credentials, } from "./auth/credential-manager.js";
+export { HttpClient, createHttpClient, type HttpClientConfig, type ApiResponse, } from "./auth/http-client.js";
+export { ProfileManager, getProfileManager, type Profile, type ProfileConfig, type ProfileResult, type ProfileValidationError, } from "./profile/index.js";
+export { paths, getConfigDir, getStateDir } from "./config/paths.js";
+export { logger, createLogger, LogLevel, type LoggerConfig, } from "./utils/logging.js";
+export { F5XCError, AuthenticationError, F5XCApiError, ConfigurationError, SSLCertificateError, wrapSSLError, } from "./utils/errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,KAAK,WAAW,GACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @robinmordasiewicz/f5xc-auth
+ *
+ * Shared authentication library for F5 Distributed Cloud MCP servers.
+ * Provides XDG-compliant profile management and credential handling.
+ *
+ * @example
+ * ```typescript
+ * import { CredentialManager, ProfileManager, getProfileManager } from '@robinmordasiewicz/f5xc-auth';
+ *
+ * // Initialize credentials
+ * const credentialManager = new CredentialManager();
+ * await credentialManager.initialize();
+ *
+ * if (credentialManager.isAuthenticated()) {
+ *   console.log(`Authenticated as: ${credentialManager.getTenant()}`);
+ * }
+ *
+ * // Manage profiles
+ * const profileManager = getProfileManager();
+ * const profiles = await profileManager.list();
+ * ```
+ */
+// Auth module
+export { CredentialManager, AuthMode, AUTH_ENV_VARS, normalizeApiUrl, extractTenantFromUrl, } from "./auth/credential-manager.js";
+export { HttpClient, createHttpClient, } from "./auth/http-client.js";
+// Profile module
+export { ProfileManager, getProfileManager, } from "./profile/index.js";
+// Config module
+export { paths, getConfigDir, getStateDir } from "./config/paths.js";
+// Utils module
+export { logger, createLogger, LogLevel, } from "./utils/logging.js";
+export { F5XCError, AuthenticationError, F5XCApiError, ConfigurationError, SSLCertificateError, wrapSSLError, } from "./utils/errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc;AACd,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,iBAAiB,GAKlB,MAAM,oBAAoB,CAAC;AAE5B,gBAAgB;AAChB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErE,eAAe;AACf,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,GAET,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/profile/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Profile module exports
+ */
+export * from "./types.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profile/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/profile/index.js

@@ -0,0 +1,6 @@
+/**
+ * Profile module exports
+ */
+export * from "./types.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/profile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profile/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/profile/manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ProfileManager - XDG-compliant profile storage and management
+ *
+ * Profiles are stored in ~/.config/f5xc/profiles/ (XDG Base Directory compliant)
+ */
+import type { Profile, ProfileResult } from "./types.js";
+/**
+ * ProfileManager handles profile CRUD operations with secure file storage
+ */
+export declare class ProfileManager {
+    private config;
+    constructor();
+    /**
+     * Ensure config directories exist
+     */
+    ensureDirectories(): Promise<void>;
+    /**
+     * Get path to profile JSON file
+     */
+    private getProfilePath;
+    /**
+     * Validate profile name (alphanumeric, dash, underscore only)
+     */
+    private isValidName;
+    /**
+     * Validate API URL format
+     */
+    private isValidUrl;
+    /**
+     * List all saved profiles
+     */
+    list(): Promise<Profile[]>;
+    /**
+     * Get a profile by name
+     */
+    get(name: string): Promise<Profile | null>;
+    /**
+     * Save a profile (create or update)
+     */
+    save(profile: Profile): Promise<ProfileResult>;
+    /**
+     * Delete a profile by name
+     */
+    delete(name: string): Promise<ProfileResult>;
+    /**
+     * Get the name of the active profile
+     */
+    getActive(): Promise<string | null>;
+    /**
+     * Clear the active profile (used for force delete)
+     */
+    clearActive(): Promise<void>;
+    /**
+     * Set the active profile
+     */
+    setActive(name: string): Promise<ProfileResult>;
+    /**
+     * Get the active profile (full profile data)
+     */
+    getActiveProfile(): Promise<Profile | null>;
+    /**
+     * Check if a profile exists
+     */
+    exists(name: string): Promise<boolean>;
+    /**
+     * Mask sensitive fields for display
+     */
+    maskProfile(profile: Profile): Record<string, string>;
+}
+/**
+ * Get the global ProfileManager instance
+ */
+export declare function getProfileManager(): ProfileManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/profile/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/profile/manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAoBxE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;;IAU9B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAuChC;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA8BhD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IA+CpD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqClD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BrD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQjD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CA8BtD;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}