@qbraid-core/base 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @qbraid-core/base
+
+Base API client used for authentication, requests, and other core functionality for interacting with qBraid Cloud Services.
+
+## Installation
+
+```bash
+npm install @qbraid-core/base
+```
+
+## Usage Example
+
+```typescript
+import { QbraidClient } from '@qbraid-core/base';
+
+const client = new QbraidClient();
+
+const user = await client.getUser();
+
+console.log(`email: ${user.email}`, `role: ${user.role}`);
+```

package/dist/src/_version.d.ts

@@ -0,0 +1 @@
+export declare const version = "0.1.0";

package/dist/src/_version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = void 0;
+// This file is auto-generated. Do not edit manually.
+exports.version = '0.1.0';
+//# sourceMappingURL=_version.js.map

package/dist/src/_version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_version.js","sourceRoot":"","sources":["../../src/_version.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACxC,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,9 @@
+import { Config } from './config';
+import { QbraidSession } from './session';
+import { QbraidUser } from './user';
+export declare class QbraidClient {
+    protected session: QbraidSession;
+    constructor(config?: Config);
+    getUser(): Promise<QbraidUser>;
+    runningInLab(): Promise<boolean>;
+}

package/dist/src/client.js

@@ -0,0 +1,106 @@
+"use strict";
+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.QbraidClient = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const session_1 = require("./session");
+const context_1 = require("./context");
+const config_2 = require("./config");
+class QbraidClient {
+    session;
+    constructor(config = new config_1.ConfigLoader().config) {
+        this.session = new session_1.QbraidSession(config);
+    }
+    async getUser() {
+        const response = await this.session.request('GET', '/identity');
+        return {
+            _id: response.data._id,
+            email: response.data.email,
+            userName: response.data.userName,
+            role: response.data.role,
+            permissionsNodes: response.data.permissionsNodes,
+            metadata: response.data.metadata,
+            diskUsage: {
+                totalGB: response.data.diskUsage.totalGB,
+                quotaGB: response.data.diskUsage.quotaGB,
+                timestamp: new Date(response.data.diskUsage.timestamp),
+            },
+        };
+    }
+    async runningInLab() {
+        try {
+            const utcDatetime = new Date();
+            const formattedTime = utcDatetime.toISOString().replace(/[-:]/g, '').replace(/\..+/, '');
+            const configDir = path.join(config_2.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 this.session.request('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 runningInLab:', error instanceof Error ? error.message : 'Unknown error');
+            return false;
+        }
+    }
+}
+exports.QbraidClient = QbraidClient;
+//# 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":"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"}

package/dist/src/config.d.ts

@@ -0,0 +1,27 @@
+interface ConfigDefaults {
+    section: string;
+    userPool: string;
+    endpointURL: string;
+    path: string;
+}
+export interface Config {
+    baseURL: string;
+    jupyterToken: string | null;
+    authHeaders: Record<string, string>;
+    headers: Record<string, string>;
+}
+export declare const DEFAULT_CONFIG: ConfigDefaults;
+export declare const USER_CONFIG_PATH: string;
+export declare class ConfigLoader {
+    private configPath;
+    private configSection;
+    private _config;
+    private readonly expandedConfigPath;
+    constructor(configPath?: string, configSection?: string);
+    get config(): Config;
+    private loadConfig;
+    private parseConfigSection;
+    private extractConfigValues;
+    private buildAuthHeaders;
+}
+export {};

package/dist/src/config.js

@@ -0,0 +1,109 @@
+"use strict";
+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.ConfigLoader = exports.USER_CONFIG_PATH = exports.DEFAULT_CONFIG = void 0;
+const fs = __importStar(require("fs"));
+const ini = __importStar(require("ini"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function normalizePath(path) {
+    return path.replace(/^~/, os.homedir());
+}
+exports.DEFAULT_CONFIG = {
+    section: 'default',
+    userPool: 'qbraid',
+    endpointURL: 'https://api.qbraid.com/api',
+    path: path.join(os.homedir(), '.qbraid', 'qbraidrc'),
+};
+exports.USER_CONFIG_PATH = normalizePath(process.env.QBRAID_CONFIG_FILE || exports.DEFAULT_CONFIG.path);
+class ConfigLoader {
+    configPath;
+    configSection;
+    _config = null;
+    expandedConfigPath;
+    constructor(configPath = exports.USER_CONFIG_PATH, configSection = exports.DEFAULT_CONFIG.section) {
+        this.configPath = configPath;
+        this.configSection = configSection;
+        this.expandedConfigPath = normalizePath(this.configPath);
+    }
+    get config() {
+        return (this._config ??= this.loadConfig());
+    }
+    loadConfig(configSection = this.configSection) {
+        let section;
+        if (fs.existsSync(this.expandedConfigPath)) {
+            section = this.parseConfigSection(configSection);
+        }
+        const configValues = this.extractConfigValues(section);
+        return {
+            baseURL: configValues.baseURL,
+            jupyterToken: configValues.jupyterToken,
+            headers: { domain: configValues.userPool },
+            authHeaders: this.buildAuthHeaders(configValues),
+        };
+    }
+    parseConfigSection(configSection) {
+        const parsedConfig = ini.parse(fs.readFileSync(this.expandedConfigPath, 'utf-8'));
+        const section = parsedConfig[configSection];
+        if (!section) {
+            throw new Error(`Section [${configSection}] not found in config file: ${this.expandedConfigPath}`);
+        }
+        return section;
+    }
+    extractConfigValues(section) {
+        return {
+            userPool: section?.pool ?? process.env.QBRAID_USER_POOL ?? exports.DEFAULT_CONFIG.userPool,
+            jupyterToken: section?.['jupyter-token'] ?? process.env.JUPYTERHUB_TOKEN ?? null,
+            apiKey: section?.['api-key'] ?? process.env.QBRAID_API_KEY ?? '',
+            refreshToken: section?.['refresh-token'] ?? process.env.REFRESH ?? '',
+            userEmail: section?.email ?? process.env.JUPYTERHUB_USER ?? '',
+            baseURL: section?.url ?? process.env.QBRAID_API_URL ?? exports.DEFAULT_CONFIG.endpointURL,
+        };
+    }
+    buildAuthHeaders(values) {
+        if (values.userEmail && values.refreshToken) {
+            return {
+                email: values.userEmail,
+                'refresh-token': values.refreshToken,
+            };
+        }
+        if (values.apiKey) {
+            return { 'api-key': values.apiKey };
+        }
+        return {};
+    }
+}
+exports.ConfigLoader = ConfigLoader;
+//# 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,90 @@
+"use strict";
+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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,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/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class QbraidError extends Error {
+    constructor(message?: string);
+}

package/dist/src/errors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QbraidError = void 0;
+const DEFAULT_ERROR_MESSAGE = 'An unexpected error occurred while processing your qBraid command. ' +
+    'Please check your input and try again. If the problem persists, ' +
+    'visit https://github.com/qBraid/community/issues to file a bug report.';
+class QbraidError extends Error {
+    constructor(message) {
+        super(message || DEFAULT_ERROR_MESSAGE);
+        this.name = 'QbraidError';
+        // Maintains proper stack trace for where error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, QbraidError);
+        }
+    }
+}
+exports.QbraidError = QbraidError;
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAM,qBAAqB,GACzB,qEAAqE;IACrE,kEAAkE;IAClE,wEAAwE,CAAC;AAE3E,MAAa,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAE1B,iFAAiF;QACjF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAVD,kCAUC"}

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module base
+ */
+export { ConfigLoader } from './config';
+export { QbraidClient } from './client';
+export { QbraidSession } from './session';
+export { QbraidError } from './errors';
+export type { Method } from 'axios';
+export type { QbraidUser, DiskUsage } from './user';
+export type { Config } from './config';

package/dist/src/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QbraidError = exports.QbraidSession = exports.QbraidClient = exports.ConfigLoader = void 0;
+/**
+ * @module base
+ */
+var config_1 = require("./config");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_1.ConfigLoader; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "QbraidClient", { enumerable: true, get: function () { return client_1.QbraidClient; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "QbraidSession", { enumerable: true, get: function () { return session_1.QbraidSession; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "QbraidError", { enumerable: true, get: function () { return errors_1.QbraidError; } });
+//# 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;;GAEG;AACH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

package/dist/src/session.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Module for making requests to the qBraid API.
+ */
+import { AxiosRequestConfig, AxiosResponse, Method } from 'axios';
+import type { Config } from './config';
+export declare class QbraidSession {
+    private readonly config;
+    private readonly client;
+    constructor(config: Config);
+    private createAxiosInstance;
+    private getUserAgent;
+    addUserAgent(userAgent: string): void;
+    private joinUrl;
+    request<T>(method: Method, url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    private getErrorMessage;
+    private maskSensitiveData;
+}

package/dist/src/session.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Module for making requests to the qBraid API.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QbraidSession = void 0;
+const _version_1 = require("./_version");
+const axios_1 = __importDefault(require("axios"));
+const https_1 = require("https");
+const url_1 = require("url");
+const errors_1 = require("./errors");
+class QbraidSession {
+    config;
+    client;
+    constructor(config) {
+        this.config = config;
+        this.client = this.createAxiosInstance();
+    }
+    createAxiosInstance() {
+        const headers = {
+            ...this.config.headers,
+            ...this.config.authHeaders,
+            'User-Agent': this.getUserAgent(),
+        };
+        return axios_1.default.create({
+            baseURL: this.config.baseURL,
+            headers,
+            httpsAgent: new https_1.Agent({ keepAlive: true }),
+        });
+    }
+    getUserAgent() {
+        return `QbraidCoreJs/${_version_1.version}`;
+    }
+    addUserAgent(userAgent) {
+        const currentUserAgent = this.client.defaults.headers['User-Agent'];
+        if (!currentUserAgent.includes(userAgent)) {
+            this.client.defaults.headers['User-Agent'] = `${currentUserAgent} ${userAgent}`.trim();
+        }
+    }
+    joinUrl(baseUrl, path) {
+        const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+        const relativePath = path.startsWith('/') ? path.slice(1) : path;
+        return new url_1.URL(relativePath, base).toString();
+    }
+    async request(method, url, config = {}) {
+        const fullUrl = this.config.baseURL && !url.startsWith('http') ? this.joinUrl(this.config.baseURL, url) : url;
+        try {
+            return await this.client.request({ method, url: fullUrl, ...config });
+        }
+        catch (error) {
+            const message = this.maskSensitiveData(this.getErrorMessage(error));
+            throw new errors_1.QbraidError(message);
+        }
+    }
+    getErrorMessage(error) {
+        if (axios_1.default.isAxiosError(error)) {
+            return `AxiosError: ${error.message}`;
+        }
+        return error instanceof Error ? error.message : String(error);
+    }
+    maskSensitiveData(message) {
+        return Object.values(this.config.authHeaders).reduce((maskedMessage, value) => maskedMessage.replace(value, '...'), message);
+    }
+}
+exports.QbraidSession = QbraidSession;
+//# sourceMappingURL=session.js.map

package/dist/src/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,yCAAqC;AACrC,kDAAwF;AACxF,iCAA8B;AAE9B,6BAA0B;AAC1B,qCAAuC;AAEvC,MAAa,aAAa;IAGK;IAFZ,MAAM,CAAgB;IAEvC,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC3C,CAAC;IAEO,mBAAmB;QACzB,MAAM,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;YACtB,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;SAClC,CAAC;QAEF,OAAO,eAAK,CAAC,MAAM,CAAC;YAClB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO;YACP,UAAU,EAAE,IAAI,aAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAEO,YAAY;QAClB,OAAO,gBAAgB,kBAAO,EAAE,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,SAAiB;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAW,CAAC;QAC9E,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,gBAAgB,IAAI,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,OAAe,EAAE,IAAY;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,OAAO,IAAI,SAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,MAAc,EACd,GAAW,EACX,SAA6B,EAAE;QAE/B,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAEhG,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACpE,MAAM,IAAI,oBAAW,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,KAAc;QACpC,IAAI,eAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,eAAe,KAAK,CAAC,OAAO,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAEO,iBAAiB,CAAC,OAAe;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAClD,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AAnED,sCAmEC"}

package/dist/src/user.d.ts

@@ -0,0 +1,15 @@
+export interface DiskUsage {
+    totalGB: number;
+    quotaGB: number;
+    timestamp: Date;
+}
+export interface QbraidUser {
+    _id: string;
+    email: string;
+    userName: string;
+    role: string;
+    permissionsNodes: string[];
+    diskUsage: DiskUsage;
+    metadata: Record<string, unknown>;
+    [key: string]: unknown;
+}

package/dist/src/user.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user.js.map

package/dist/src/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/user.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@qbraid-core/base",
+  "version": "0.1.0",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "description": "Core functionality for interacting with qBraid Cloud Services.",
+  "author": "qBraid Development Team",
+  "license": "Proprietary",
+  "files": [
+    "dist/src"
+  ],
+  "keywords": [
+    "qbraid",
+    "qbraid-core",
+    "qbraid-core-js",
+    "qbraid base",
+    "qbraid cloud",
+    "qbraid api",
+    "qbraid apis",
+    "cloud",
+    "quantum",
+    "quantum computing"
+  ],
+  "repository": {
+    "type": "git",
+    "directory": "packages/base",
+    "url": "git+https://github.com/qBraid/qbraid-core-js.git"
+  },
+  "homepage": "https://qbraid.github.io/qbraid-core-js/modules/base.html",
+  "dependencies": {
+    "axios": "^1.7.9",
+    "ini": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/ini": "^4.1.1"
+  },
+  "scripts": {
+    "clean": "rimraf dist && rm -f tsconfig.tsbuildinfo && rimraf src/_version.ts",
+    "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"
+  }
+}