@qbraid-core/fs 0.11.0

package/README.md

@@ -0,0 +1,44 @@
+# @qbraid-core/fs
+
+File system utilities for qBraid Cloud Services.
+
+This package provides file system-based configuration management and utilities that are separated from the main base package to enable frontend compatibility.
+
+## Features
+
+- `QbraidConfigManager`: Manages qBraid configuration files
+- `IbmConfigManager` : Manage IBM Quantum Platform configuration
+- `ConfigManager`: Abstract base class for configuration management
+- `ensureDirectory`: Directory management utilities
+- File system context managers
+
+## Installation
+
+```bash
+npm install @qbraid-core/fs
+```
+
+## Usage
+
+### QbraidConfigManager
+
+```typescript
+import { QbraidConfigManager } from '@qbraid-core/fs';
+
+const configManager = new QbraidConfigManager();
+const apiKey = configManager.getApiKey();
+```
+
+### IBMConfigManager
+
+```typescript
+import { IBMConfigManager } from '@qbraid-core/fs';
+
+const ibmConfig = new IBMConfigManager();
+const apiKey = ibmConfig.getApiKey();
+const serviceCrn = ibmConfig.getServiceCRN();
+```
+
+## Note
+
+This package requires Node.js environment with file system access. It is not compatible with browser environments.

package/dist/src/client.d.ts

@@ -0,0 +1,6 @@
+import { QbraidSession } from '@qbraid-core/base';
+/**
+ * Check if the current process is running inside qBraid Lab.
+ * This function creates a temporary file and checks if it's mounted in the lab environment.
+ */
+export declare function isRunningInLab(session: QbraidSession): Promise<boolean>;

package/dist/src/client.js

@@ -0,0 +1,87 @@
+"use strict";
+// Copyright (c) 2025, qBraid Development Team
+// All rights reserved.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRunningInLab = isRunningInLab;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const context_1 = require("./context");
+/**
+ * Check if the current process is running inside qBraid Lab.
+ * This function creates a temporary file and checks if it's mounted in the lab environment.
+ */
+async function isRunningInLab(session) {
+    try {
+        const utcDatetime = new Date();
+        const formattedTime = utcDatetime.toISOString().replace(/[-:]/g, '').replace(/\..+/, '');
+        const configDir = path.join(config_1.USER_CONFIG_PATH, '..', 'certs');
+        const filepath = path.join(configDir, formattedTime);
+        let fileCreated = false;
+        return await (0, context_1.ensureDirectory)(configDir, false, async () => {
+            try {
+                // Create empty file with proper error handling
+                await fs.promises.writeFile(filepath, '').catch((error) => {
+                    console.error(`Failed to create test file: ${error.message}`);
+                    throw error;
+                });
+                fileCreated = true;
+                const response = await session.client.get(`/lab/is-mounted/${formattedTime}`);
+                return Boolean(response.data?.isMounted);
+            }
+            finally {
+                if (fileCreated) {
+                    try {
+                        await fs.promises.unlink(filepath);
+                    }
+                    catch (error) {
+                        if (error instanceof Error) {
+                            console.error(`Failed to cleanup test file ${filepath}: ${error.message}`);
+                        }
+                        else {
+                            console.error(`Failed to cleanup test file ${filepath}: Unknown error`);
+                        }
+                    }
+                }
+            }
+        });
+    }
+    catch (error) {
+        console.error('Error in isRunningInLab:', error instanceof Error ? error.message : 'Unknown error');
+        return false;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcvB,wCA2CC;AAvDD,uCAAyB;AACzB,2CAA6B;AAI7B,qCAA4C;AAC5C,uCAA4C;AAE5C;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,OAAsB;IACzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEzF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,yBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,OAAO,MAAM,IAAA,yBAAe,EAAC,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YACxD,IAAI,CAAC;gBACH,+CAA+C;gBAC/C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;oBAC/D,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC9D,MAAM,KAAK,CAAC;gBACd,CAAC,CAAC,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC;gBAEnB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CACvC,mBAAmB,aAAa,EAAE,CACnC,CAAC;gBACF,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3C,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACrC,CAAC;oBAAC,OAAO,KAAc,EAAE,CAAC;wBACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;4BAC3B,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;wBAC7E,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,iBAAiB,CAAC,CAAC;wBAC1E,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CACX,0BAA0B,EAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CACzD,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,40 @@
+import { AuthData, DEFAULT_CONFIG, ConfigData, ConfigManager as BaseConfigManager } from '@qbraid-core/base';
+export declare const DEFAULT_CONFIG_PATH: string;
+export declare const USER_CONFIG_PATH: string;
+export { DEFAULT_CONFIG, ConfigData };
+/**
+ * Filesystem-enabled configuration manager.
+ * Provides concrete implementation of the base ConfigManager with file I/O operations.
+ */
+export declare abstract class FsConfigManager<T> extends BaseConfigManager<T> {
+    protected ensureConfigFileExists(): void;
+    loadConfig(): T;
+    saveConfig(): void;
+}
+/**
+ * Filesystem-enabled qBraid configuration manager.
+ * Provides all the functionality of the base QbraidConfigManager plus file I/O operations.
+ */
+export declare class QbraidConfigManager extends FsConfigManager<ConfigData> {
+    constructor(filePath?: string);
+    protected parseConfig(content: string): ConfigData;
+    protected stringifyConfig(config: ConfigData): string;
+    protected getDefaultConfig(): ConfigData;
+    private initializeDefaultConfig;
+    private deepMerge;
+    getSection(section: string): Record<string, string> | undefined;
+    getValue(section: string, key: string): string | undefined;
+    setValue(section: string, key: string, value: string): void;
+    updateConfig(newConfig: ConfigData): void;
+    removeSection(section: string): void;
+    removeValue(section: string, key: string): void;
+    getApiKey(): string;
+    setApiKey(apiKey: string): void;
+    getRefreshToken(): string;
+    setRefreshToken(refreshToken: string): void;
+    getEmail(): string;
+    setEmail(email: string): void;
+    getUrl(): string;
+    setUrl(url: string): void;
+    getAuthData(): AuthData;
+}

package/dist/src/config.js

@@ -0,0 +1,185 @@
+"use strict";
+// Copyright (c) 2025, qBraid Development Team
+// All rights reserved.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QbraidConfigManager = exports.FsConfigManager = exports.DEFAULT_CONFIG = exports.USER_CONFIG_PATH = exports.DEFAULT_CONFIG_PATH = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const base_1 = require("@qbraid-core/base");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return base_1.DEFAULT_CONFIG; } });
+const ini = __importStar(require("ini"));
+exports.DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.qbraid', 'qbraidrc');
+exports.USER_CONFIG_PATH = process.env.QBRAID_CONFIG_FILE || exports.DEFAULT_CONFIG_PATH;
+/**
+ * Filesystem-enabled configuration manager.
+ * Provides concrete implementation of the base ConfigManager with file I/O operations.
+ */
+class FsConfigManager extends base_1.ConfigManager {
+    ensureConfigFileExists() {
+        console.log('Checking config path:', this.configPath);
+        if (!fs.existsSync(this.configPath)) {
+            const dirPath = path.dirname(this.configPath);
+            if (!fs.existsSync(dirPath)) {
+                fs.mkdirSync(dirPath, { recursive: true });
+            }
+            fs.writeFileSync(this.configPath, '', 'utf-8');
+        }
+    }
+    loadConfig() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const fileContent = fs.readFileSync(this.configPath, 'utf-8');
+                return this.parseConfig(fileContent);
+            }
+            else {
+                console.warn(`Config file not found at ${this.configPath}. Initializing with default config.`);
+                return this.getDefaultConfig();
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                console.error(`Error loading config file: ${error.message}`);
+            }
+            else {
+                console.error(`An unknown error occurred while loading the config file.`);
+            }
+            return this.getDefaultConfig();
+        }
+    }
+    saveConfig() {
+        this.ensureConfigFileExists();
+        try {
+            const configString = this.stringifyConfig(this.config);
+            fs.writeFileSync(this.configPath, configString, 'utf-8');
+        }
+        catch (error) {
+            console.error(`Error saving config file: ${error}`);
+        }
+    }
+}
+exports.FsConfigManager = FsConfigManager;
+/**
+ * Filesystem-enabled qBraid configuration manager.
+ * Provides all the functionality of the base QbraidConfigManager plus file I/O operations.
+ */
+class QbraidConfigManager extends FsConfigManager {
+    constructor(filePath = exports.USER_CONFIG_PATH) {
+        super(filePath);
+        this.initializeDefaultConfig();
+    }
+    parseConfig(content) {
+        return ini.parse(content);
+    }
+    stringifyConfig(config) {
+        return ini.stringify(config);
+    }
+    getDefaultConfig() {
+        return base_1.DEFAULT_CONFIG;
+    }
+    initializeDefaultConfig() {
+        const currentConfig = this.getConfig();
+        const mergedConfig = this.deepMerge(base_1.DEFAULT_CONFIG, currentConfig);
+        this.updateConfig(mergedConfig);
+    }
+    deepMerge(target, source) {
+        const output = { ...target };
+        Object.keys(source).forEach(key => {
+            if (typeof source[key] === 'object' && source[key] !== null) {
+                output[key] = output[key] ? { ...output[key], ...source[key] } : { ...source[key] };
+            }
+        });
+        return output;
+    }
+    // Configuration access methods (same as base implementation)
+    getSection(section) {
+        return this.config[section];
+    }
+    getValue(section, key) {
+        return this.config[section]?.[key];
+    }
+    setValue(section, key, value) {
+        if (!this.config[section]) {
+            this.config[section] = {};
+        }
+        this.config[section][key] = value;
+    }
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+    removeSection(section) {
+        delete this.config[section];
+    }
+    removeValue(section, key) {
+        if (this.config[section]) {
+            delete this.config[section][key];
+        }
+    }
+    // qBraid-specific configuration methods (same as base implementation)
+    getApiKey() {
+        return this.getValue('default', 'api-key') || '';
+    }
+    setApiKey(apiKey) {
+        this.setValue('default', 'api-key', apiKey);
+    }
+    getRefreshToken() {
+        return this.getValue('default', 'refresh-token') || '';
+    }
+    setRefreshToken(refreshToken) {
+        this.setValue('default', 'refresh-token', refreshToken);
+    }
+    getEmail() {
+        return this.getValue('default', 'email') || '';
+    }
+    setEmail(email) {
+        this.setValue('default', 'email', email);
+    }
+    getUrl() {
+        return this.getValue('default', 'url') || base_1.DEFAULT_CONFIG.default.url;
+    }
+    setUrl(url) {
+        this.setValue('default', 'url', url);
+    }
+    getAuthData() {
+        return {
+            apiKey: this.getApiKey(),
+            refreshToken: this.getRefreshToken(),
+            email: this.getEmail(),
+        };
+    }
+}
+exports.QbraidConfigManager = QbraidConfigManager;
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Interface for a disposable resource that can be cleaned up
+ */
+interface Disposable {
+    dispose(): Promise<void>;
+}
+/**
+ * Utility function to handle resource management similar to Python's context manager
+ * @param resource A disposable resource with init and dispose methods
+ * @param fn The function to execute with the managed resource
+ */
+export declare function using<T extends Disposable, R>(resource: T & {
+    init(): Promise<void>;
+}, fn: (resource: T) => Promise<R>): Promise<R>;
+/**
+ * Ensures a directory exists during the execution of a function and optionally cleans it up
+ * @param dirPath Path to the directory
+ * @param removeIfCreated Whether to remove the directory if it was created by this function
+ * @param fn Function to execute while directory is guaranteed to exist
+ */
+export declare function ensureDirectory<R>(dirPath: string, removeIfCreated: boolean, fn: () => Promise<R>): Promise<R>;
+export {};

package/dist/src/context.js

@@ -0,0 +1,92 @@
+"use strict";
+// Copyright (c) 2025, qBraid Development Team
+// All rights reserved.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.using = using;
+exports.ensureDirectory = ensureDirectory;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Class to manage directory creation and cleanup
+ */
+class DirectoryManager {
+    existed;
+    path;
+    removeIfCreated;
+    constructor(dirPath, removeIfCreated) {
+        this.path = dirPath;
+        this.removeIfCreated = removeIfCreated;
+        this.existed = fs.existsSync(dirPath);
+    }
+    async init() {
+        if (!this.existed) {
+            await fs.promises.mkdir(this.path, { recursive: true });
+        }
+    }
+    async dispose() {
+        if (!this.existed && this.removeIfCreated) {
+            const files = await fs.promises.readdir(this.path);
+            for (const file of files) {
+                await fs.promises.unlink(path.join(this.path, file));
+            }
+            await fs.promises.rmdir(this.path);
+        }
+    }
+}
+/**
+ * Utility function to handle resource management similar to Python's context manager
+ * @param resource A disposable resource with init and dispose methods
+ * @param fn The function to execute with the managed resource
+ */
+async function using(resource, fn) {
+    await resource.init();
+    try {
+        return await fn(resource);
+    }
+    finally {
+        await resource.dispose();
+    }
+}
+/**
+ * Ensures a directory exists during the execution of a function and optionally cleans it up
+ * @param dirPath Path to the directory
+ * @param removeIfCreated Whether to remove the directory if it was created by this function
+ * @param fn Function to execute while directory is guaranteed to exist
+ */
+async function ensureDirectory(dirPath, removeIfCreated, fn) {
+    return using(new DirectoryManager(dirPath, removeIfCreated), async () => await fn());
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDvB,sBAUC;AAQD,0CAMC;AAtED,uCAAyB;AACzB,2CAA6B;AAS7B;;GAEG;AACH,MAAM,gBAAgB;IACZ,OAAO,CAAU;IACjB,IAAI,CAAS;IACb,eAAe,CAAU;IAEjC,YAAY,OAAe,EAAE,eAAwB;QACnD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACI,KAAK,UAAU,KAAK,CACzB,QAAuC,EACvC,EAA+B;IAE/B,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,eAAwB,EACxB,EAAoB;IAEpB,OAAO,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC"}

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

@@ -0,0 +1,24 @@
+import { FsConfigManager } from './config';
+type IBMConfigData = Record<string, Record<string, string | boolean>>;
+export declare const DEFAULT_IBM_CONFIG_PATH: string;
+export declare const IBM_DEFAULT_TOKEN_LIFETIME = 3600000;
+/**
+ * Filesystem-enabled IBM Quantum configuration manager.
+ * Manages IBM Quantum Platform configuration files.
+ */
+export declare class IBMConfigManager extends FsConfigManager<IBMConfigData> {
+    private bearerToken;
+    private tokenFetchTime;
+    constructor(filePath?: string);
+    protected parseConfig(content: string): IBMConfigData;
+    protected stringifyConfig(config: IBMConfigData): string;
+    protected getDefaultConfig(): IBMConfigData;
+    getApiKey(): string;
+    setApiKey(apiKey: string): void;
+    getServiceCRN(): string;
+    setServiceCRN(crn: string): void;
+    getBearerToken(): string;
+    setBearerToken(token: string): void;
+    isBearerTokenExpired(): boolean;
+}
+export {};

package/dist/src/ibm-config.js

@@ -0,0 +1,98 @@
+"use strict";
+// Copyright (c) 2025, qBraid Development Team
+// All rights reserved.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IBMConfigManager = exports.IBM_DEFAULT_TOKEN_LIFETIME = exports.DEFAULT_IBM_CONFIG_PATH = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+exports.DEFAULT_IBM_CONFIG_PATH = path.join(os.homedir(), '.qiskit', 'qiskit-ibm.json');
+exports.IBM_DEFAULT_TOKEN_LIFETIME = 3600_000; // 1 hour in milliseconds
+/**
+ * Filesystem-enabled IBM Quantum configuration manager.
+ * Manages IBM Quantum Platform configuration files.
+ */
+class IBMConfigManager extends config_1.FsConfigManager {
+    bearerToken = '';
+    tokenFetchTime = 0;
+    constructor(filePath) {
+        super(filePath ? filePath : exports.DEFAULT_IBM_CONFIG_PATH);
+    }
+    parseConfig(content) {
+        return JSON.parse(content);
+    }
+    stringifyConfig(config) {
+        return JSON.stringify(config, null, 2);
+    }
+    getDefaultConfig() {
+        return {
+            'default-ibm-quantum-platform': {
+                // latest IBMQ channel, ibm_cloud will be deprecated soon
+                channel: 'ibm_quantum_platform',
+                // Loading account from environment variables
+                // Ref : https://github.com/Qiskit/qiskit-ibm-runtime/tree/main?tab=readme-ov-file#loading-account-from-environment-variables
+                instance: process.env.QISKIT_IBM_INSTANCE ?? '',
+                token: process.env.QISKIT_IBM_TOKEN ?? '',
+                private_endpoint: false,
+                url: 'https://cloud.ibm.com',
+            },
+        };
+    }
+    getApiKey() {
+        return this.config['default-ibm-quantum-platform'].token;
+    }
+    setApiKey(apiKey) {
+        this.config['default-ibm-quantum-platform'].token = apiKey;
+    }
+    getServiceCRN() {
+        return this.config['default-ibm-quantum-platform'].instance;
+    }
+    setServiceCRN(crn) {
+        this.config['default-ibm-quantum-platform'].instance = crn;
+    }
+    getBearerToken() {
+        return this.bearerToken;
+    }
+    setBearerToken(token) {
+        this.bearerToken = token;
+        this.tokenFetchTime = Date.now();
+    }
+    isBearerTokenExpired() {
+        return (this.tokenFetchTime === 0 || Date.now() - this.tokenFetchTime > exports.IBM_DEFAULT_TOKEN_LIFETIME);
+    }
+}
+exports.IBMConfigManager = IBMConfigManager;
+//# sourceMappingURL=ibm-config.js.map

package/dist/src/ibm-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibm-config.js","sourceRoot":"","sources":["../../src/ibm-config.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEvB,uCAAyB;AACzB,2CAA6B;AAE7B,qCAA2C;AAI9B,QAAA,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAChF,QAAA,0BAA0B,GAAG,QAAQ,CAAC,CAAC,yBAAyB;AAE7E;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,wBAA8B;IAC1D,WAAW,GAAW,EAAE,CAAC;IACzB,cAAc,GAAW,CAAC,CAAC;IAEnC,YAAY,QAAiB;QAC3B,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,+BAAuB,CAAC,CAAC;IACvD,CAAC;IAES,WAAW,CAAC,OAAe;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAES,eAAe,CAAC,MAAqB;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAES,gBAAgB;QACxB,OAAO;YACL,8BAA8B,EAAE;gBAC9B,yDAAyD;gBACzD,OAAO,EAAE,sBAAsB;gBAE/B,6CAA6C;gBAC7C,6HAA6H;gBAC7H,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;gBAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE;gBACzC,gBAAgB,EAAE,KAAK;gBACvB,GAAG,EAAE,uBAAuB;aAC7B;SACF,CAAC;IACJ,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,KAAe,CAAC;IACrE,CAAC;IAEM,SAAS,CAAC,MAAc;QAC7B,IAAI,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;IAC7D,CAAC;IAEM,aAAa;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,QAAkB,CAAC;IACxE,CAAC;IAEM,aAAa,CAAC,GAAW;QAC9B,IAAI,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC;IAC7D,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEM,cAAc,CAAC,KAAa;QACjC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAEM,oBAAoB;QACzB,OAAO,CACL,IAAI,CAAC,cAAc,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,kCAA0B,CAC3F,CAAC;IACJ,CAAC;CACF;AA9DD,4CA8DC"}

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module fs
+ */
+export { isRunningInLab } from './client';
+export { FsConfigManager, QbraidConfigManager, DEFAULT_CONFIG_PATH, USER_CONFIG_PATH, } from './config';
+export { IBMConfigManager, DEFAULT_IBM_CONFIG_PATH } from './ibm-config';
+export { ensureDirectory, using } from './context';

package/dist/src/index.js

@@ -0,0 +1,22 @@
+"use strict";
+// Copyright (c) 2025, qBraid Development Team
+// All rights reserved.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.using = exports.ensureDirectory = exports.DEFAULT_IBM_CONFIG_PATH = exports.IBMConfigManager = exports.USER_CONFIG_PATH = exports.DEFAULT_CONFIG_PATH = exports.QbraidConfigManager = exports.FsConfigManager = exports.isRunningInLab = void 0;
+/**
+ * @module fs
+ */
+var client_1 = require("./client");
+Object.defineProperty(exports, "isRunningInLab", { enumerable: true, get: function () { return client_1.isRunningInLab; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "FsConfigManager", { enumerable: true, get: function () { return config_1.FsConfigManager; } });
+Object.defineProperty(exports, "QbraidConfigManager", { enumerable: true, get: function () { return config_1.QbraidConfigManager; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG_PATH", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG_PATH; } });
+Object.defineProperty(exports, "USER_CONFIG_PATH", { enumerable: true, get: function () { return config_1.USER_CONFIG_PATH; } });
+var ibm_config_1 = require("./ibm-config");
+Object.defineProperty(exports, "IBMConfigManager", { enumerable: true, get: function () { return ibm_config_1.IBMConfigManager; } });
+Object.defineProperty(exports, "DEFAULT_IBM_CONFIG_PATH", { enumerable: true, get: function () { return ibm_config_1.DEFAULT_IBM_CONFIG_PATH; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "ensureDirectory", { enumerable: true, get: function () { return context_1.ensureDirectory; } });
+Object.defineProperty(exports, "using", { enumerable: true, get: function () { return context_1.using; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,uBAAuB;;;AAEvB;;GAEG;AACH,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,mCAKkB;AAJhB,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AACnB,0GAAA,gBAAgB,OAAA;AAElB,2CAAyE;AAAhE,8GAAA,gBAAgB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAClD,qCAAmD;AAA1C,0GAAA,eAAe,OAAA;AAAE,gGAAA,KAAK,OAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@qbraid-core/fs",
+  "version": "0.11.0",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "description": "File system utilities for qBraid Cloud Services.",
+  "author": "qBraid Development Team",
+  "license": "Proprietary",
+  "files": [
+    "dist/src"
+  ],
+  "keywords": [
+    "qbraid",
+    "qbraid-core",
+    "qbraid-core-js",
+    "filesystem",
+    "config",
+    "file system",
+    "configuration",
+    "quantum",
+    "quantum computing"
+  ],
+  "repository": {
+    "type": "git",
+    "directory": "packages/fs",
+    "url": "git+https://github.com/qBraid/qbraid-core-js.git"
+  },
+  "homepage": "https://qbraid.github.io/qbraid-core-js/modules/fs.html",
+  "dependencies": {
+    "@qbraid-core/base": "0.11.0",
+    "fs": "^0.0.1-security",
+    "ini": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/ini": "^4.1.1"
+  },
+  "scripts": {
+    "clean": "rimraf dist tsconfig.tsbuildinfo src/_version.ts src/_version.js src/*.d.ts src/*.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.{ts,json}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,json}\"",
+    "docs": "typedoc"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}