voltenv-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { VoltEnvOptions } from './utilities/errorHandler';
+export declare class VoltEnv {
+    private httpClient;
+    private cacheService;
+    /**
+     * Initialize the VoltEnv SDK
+     * @param options Configuration options or API key string
+     */
+    constructor(options: VoltEnvOptions | string);
+    /**
+     * Get a variable from a specific environment
+     * @param environment The environment name (e.g., 'production', 'development')
+     * @param key The variable key
+     * @param defaultValue Optional default value if not found
+     * @returns The variable value or the default value
+     */
+    get(environment: string, key: string, defaultValue?: string): Promise<string | undefined>;
+    /**
+     * Get all variables from an environment
+     * @param environment The environment name
+     * @returns A record of key-value pairs
+     */
+    getAll(environment: string): Promise<Record<string, string>>;
+    /**
+     * Set a variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The variable value
+     */
+    set(environment: string, key: string, value: string): Promise<void>;
+    /**
+     * Set multiple variables at once
+     * @param environment The environment name
+     * @param variables A record of key-value pairs to set
+     */
+    setMany(environment: string, variables: Record<string, string>): Promise<void>;
+    /**
+     * Delete a variable from a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    delete(environment: string, key: string): Promise<void>;
+    /**
+     * Delete multiple variables at once
+     * @param environment The environment name
+     * @param keys Array of keys to delete
+     */
+    deleteMany(environment: string, keys: string[]): Promise<void>;
+    /**
+     * List all environments accessible by this API key
+     * @returns Array of environment names
+     */
+    listEnvironments(): Promise<string[]>;
+    /**
+     * Sync/refresh variables from server (bypassing cache)
+     *If an environment is provided, it only syncs that environment.
+     * If no environment is provided, it lists all environments and syncs them all.
+     * @param environment Optional environment to sync
+     */
+    sync(environment?: string): Promise<void>;
+}
+export default VoltEnv;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAIxE,qBAAa,OAAO;IAChB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;OAGG;gBACS,OAAO,EAAE,cAAc,GAAG,MAAM;IAuB5C;;;;;;OAMG;IACG,GAAG,CACL,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA2B9B;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAgBlE;;;;;OAKG;IACG,GAAG,CACL,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;OAIG;IACG,OAAO,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D;;;;OAIG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAO3C;;;;;OAKG;IACG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlD;AAED,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoltEnv = void 0;
+const errorHandler_1 = require("./utilities/errorHandler");
+const httpClient_1 = require("./utilities/httpClient");
+const cacheService_1 = require("./utilities/cacheService");
+class VoltEnv {
+    /**
+     * Initialize the VoltEnv SDK
+     * @param options Configuration options or API key string
+     */
+    constructor(options) {
+        const config = typeof options === 'string'
+            ? { apiKey: options }
+            : options;
+        const { apiKey, baseURL = 'https://api.voltenv.com', timeout = 5000, cache = true, onError } = config;
+        this.httpClient = new httpClient_1.HttpClient({
+            apiKey,
+            baseURL,
+            timeout,
+            onError
+        });
+        this.cacheService = cache ? new cacheService_1.CacheService() : null;
+    }
+    /**
+     * Get a variable from a specific environment
+     * @param environment The environment name (e.g., 'production', 'development')
+     * @param key The variable key
+     * @param defaultValue Optional default value if not found
+     * @returns The variable value or the default value
+     */
+    async get(environment, key, defaultValue) {
+        const cacheKey = `${environment}:${key}`;
+        if (this.cacheService?.has(cacheKey)) {
+            return this.cacheService.get(cacheKey);
+        }
+        try {
+            const data = await this.httpClient.get(`/v1/variables/${environment}/${key}`);
+            const value = data.value;
+            if (value && this.cacheService) {
+                this.cacheService.set(cacheKey, value);
+            }
+            return value || defaultValue;
+        }
+        catch (error) {
+            if (error instanceof errorHandler_1.VoltEnvError && error.code === 'NOT_FOUND') {
+                return defaultValue;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get all variables from an environment
+     * @param environment The environment name
+     * @returns A record of key-value pairs
+     */
+    async getAll(environment) {
+        const data = await this.httpClient.get(`/v1/variables/${environment}`);
+        const variables = data.variables;
+        if (this.cacheService) {
+            Object.entries(variables).forEach(([key, value]) => {
+                this.cacheService.set(`${environment}:${key}`, value);
+            });
+        }
+        return variables;
+    }
+    /**
+     * Set a variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The variable value
+     */
+    async set(environment, key, value) {
+        await this.httpClient.put(`/v1/variables/${environment}/${key}`, {
+            value,
+        });
+        if (this.cacheService) {
+            this.cacheService.set(`${environment}:${key}`, value);
+        }
+    }
+    /**
+     * Set multiple variables at once
+     * @param environment The environment name
+     * @param variables A record of key-value pairs to set
+     */
+    async setMany(environment, variables) {
+        await this.httpClient.post(`/v1/variables/${environment}/batch`, {
+            variables,
+        });
+        if (this.cacheService) {
+            Object.entries(variables).forEach(([key, value]) => {
+                this.cacheService.set(`${environment}:${key}`, value);
+            });
+        }
+    }
+    /**
+     * Delete a variable from a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async delete(environment, key) {
+        await this.httpClient.delete(`/v1/variables/${environment}/${key}`);
+        if (this.cacheService) {
+            this.cacheService.delete(`${environment}:${key}`);
+        }
+    }
+    /**
+     * Delete multiple variables at once
+     * @param environment The environment name
+     * @param keys Array of keys to delete
+     */
+    async deleteMany(environment, keys) {
+        await this.httpClient.post(`/v1/variables/${environment}/batch-delete`, {
+            keys,
+        });
+        if (this.cacheService) {
+            keys.forEach(key => {
+                this.cacheService.delete(`${environment}:${key}`);
+            });
+        }
+    }
+    /**
+     * List all environments accessible by this API key
+     * @returns Array of environment names
+     */
+    async listEnvironments() {
+        const data = await this.httpClient.get('/v1/environments');
+        return data.environments;
+    }
+    /**
+     * Sync/refresh variables from server (bypassing cache)
+     *If an environment is provided, it only syncs that environment.
+     * If no environment is provided, it lists all environments and syncs them all.
+     * @param environment Optional environment to sync
+     */
+    async sync(environment) {
+        if (environment) {
+            const variables = await this.getAll(environment);
+            if (this.cacheService) {
+                this.cacheService.deleteByPrefix(`${environment}:`);
+                Object.entries(variables).forEach(([key, value]) => {
+                    this.cacheService.set(`${environment}:${key}`, value);
+                });
+            }
+        }
+        else {
+            const environments = await this.listEnvironments();
+            for (const env of environments) {
+                await this.sync(env);
+            }
+        }
+    }
+}
+exports.VoltEnv = VoltEnv;
+exports.default = VoltEnv;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../index.ts","../utilities/cacheservice.ts","../utilities/errorhandler.ts","../utilities/httpclient.ts"],"version":"5.9.3"}

package/dist/utilities/cacheService.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Simple in-memory cache service implementation
+ */
+export declare class CacheService {
+    private cache;
+    constructor();
+    /**
+     * Get a value from the cache
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a value in the cache
+     */
+    set(key: string, value: any): void;
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a value from the cache
+     */
+    delete(key: string): void;
+    /**
+     * Clear all values from the cache
+     */
+    clear(): void;
+    /**
+     * Delete all keys starting with a prefix
+     */
+    deleteByPrefix(prefix: string): void;
+}
+//# sourceMappingURL=cacheService.d.ts.map

package/dist/utilities/cacheService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheService.d.ts","sourceRoot":"","sources":["../../utilities/cacheService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAmB;;IAMhC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIlC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAOvC"}

package/dist/utilities/cacheService.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheService = void 0;
+/**
+ * Simple in-memory cache service implementation
+ */
+class CacheService {
+    constructor() {
+        this.cache = new Map();
+    }
+    /**
+     * Get a value from the cache
+     */
+    get(key) {
+        return this.cache.get(key);
+    }
+    /**
+     * Set a value in the cache
+     */
+    set(key, value) {
+        this.cache.set(key, value);
+    }
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+    /**
+     * Delete a value from the cache
+     */
+    delete(key) {
+        this.cache.delete(key);
+    }
+    /**
+     * Clear all values from the cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Delete all keys starting with a prefix
+     */
+    deleteByPrefix(prefix) {
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+exports.CacheService = CacheService;
+//# sourceMappingURL=cacheService.js.map

package/dist/utilities/cacheService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheService.js","sourceRoot":"","sources":["../../utilities/cacheService.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,YAAY;IAGrB;QACI,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAU;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AApDD,oCAoDC"}

package/dist/utilities/errorHandler.d.ts

@@ -0,0 +1,20 @@
+import { AxiosError } from 'axios';
+export interface VoltEnvOptions {
+    apiKey: string;
+    baseURL?: string;
+    timeout?: number;
+    cache?: boolean;
+    onError?: (error: VoltEnvError) => void;
+}
+export type VoltEnvErrorCode = 'INVALID_API_KEY' | 'PERMISSION_DENIED' | 'NOT_FOUND' | 'RATE_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'REQUEST_ERROR' | 'UNKNOWN_ERROR';
+export declare class VoltEnvError extends Error {
+    code: VoltEnvErrorCode;
+    statusCode?: number | undefined;
+    originalError?: any | undefined;
+    constructor(message: string, code: VoltEnvErrorCode, statusCode?: number | undefined, originalError?: any | undefined);
+}
+/**
+ * Helper function to transform Axios errors into VoltEnvErrors
+ */
+export declare function handleAxiosError(error: AxiosError): VoltEnvError;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utilities/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../utilities/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,WAAW,GACX,qBAAqB,GACrB,cAAc,GACd,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEtB,qBAAa,YAAa,SAAQ,KAAK;IAGxB,IAAI,EAAE,gBAAgB;IACtB,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,GAAG;gBAH1B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,gBAAgB,EACtB,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,GAAG,YAAA;CAMjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CA0ChE"}

package/dist/utilities/errorHandler.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoltEnvError = void 0;
+exports.handleAxiosError = handleAxiosError;
+class VoltEnvError extends Error {
+    constructor(message, code, statusCode, originalError) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.name = 'VoltEnvError';
+        Object.setPrototypeOf(this, VoltEnvError.prototype);
+    }
+}
+exports.VoltEnvError = VoltEnvError;
+/**
+ * Helper function to transform Axios errors into VoltEnvErrors
+ */
+function handleAxiosError(error) {
+    if (error.response) {
+        const { status, data } = error.response;
+        const message = data?.message || error.message;
+        let code = 'UNKNOWN_ERROR';
+        switch (status) {
+            case 401:
+                code = 'INVALID_API_KEY';
+                break;
+            case 403:
+                code = 'PERMISSION_DENIED';
+                break;
+            case 404:
+                code = 'NOT_FOUND';
+                break;
+            case 429:
+                code = 'RATE_LIMIT_EXCEEDED';
+                break;
+            case 500:
+            case 502:
+            case 503:
+                code = 'SERVER_ERROR';
+                break;
+        }
+        return new VoltEnvError(message, code, status, error);
+    }
+    else if (error.request) {
+        return new VoltEnvError('No response from server', 'NETWORK_ERROR', undefined, error);
+    }
+    else {
+        return new VoltEnvError(error.message, 'REQUEST_ERROR', undefined, error);
+    }
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/utilities/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../utilities/errorHandler.ts"],"names":[],"mappings":";;;AAoCA,4CA0CC;AA1DD,MAAa,YAAa,SAAQ,KAAK;IACnC,YACI,OAAe,EACR,IAAsB,EACtB,UAAmB,EACnB,aAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAkB;QACtB,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAM;QAG1B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACJ;AAXD,oCAWC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAiB;IAC9C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QACxC,MAAM,OAAO,GAAI,IAAY,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QACxD,IAAI,IAAI,GAAqB,eAAe,CAAC;QAE7C,QAAQ,MAAM,EAAE,CAAC;YACb,KAAK,GAAG;gBACJ,IAAI,GAAG,iBAAiB,CAAC;gBACzB,MAAM;YACV,KAAK,GAAG;gBACJ,IAAI,GAAG,mBAAmB,CAAC;gBAC3B,MAAM;YACV,KAAK,GAAG;gBACJ,IAAI,GAAG,WAAW,CAAC;gBACnB,MAAM;YACV,KAAK,GAAG;gBACJ,IAAI,GAAG,qBAAqB,CAAC;gBAC7B,MAAM;YACV,KAAK,GAAG,CAAC;YACT,KAAK,GAAG,CAAC;YACT,KAAK,GAAG;gBACJ,IAAI,GAAG,cAAc,CAAC;gBACtB,MAAM;QACd,CAAC;QAED,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,YAAY,CACnB,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,KAAK,CACR,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,OAAO,IAAI,YAAY,CACnB,KAAK,CAAC,OAAO,EACb,eAAe,EACf,SAAS,EACT,KAAK,CACR,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/utilities/httpClient.d.ts

@@ -0,0 +1,18 @@
+import { VoltEnvError } from './errorHandler';
+export interface HttpClientOptions {
+    baseURL: string;
+    apiKey: string;
+    timeout?: number;
+    onError?: (error: VoltEnvError) => void;
+}
+export declare class HttpClient {
+    private client;
+    private options;
+    constructor(options: HttpClientOptions);
+    private setupInterceptors;
+    get<T>(url: string): Promise<T>;
+    post<T>(url: string, data?: any): Promise<T>;
+    put<T>(url: string, data?: any): Promise<T>;
+    delete<T>(url: string): Promise<T>;
+}
+//# sourceMappingURL=httpClient.d.ts.map

package/dist/utilities/httpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.d.ts","sourceRoot":"","sources":["../../utilities/httpClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC3C;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IActC,OAAO,CAAC,iBAAiB;IA0BnB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAK5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3C,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAI3C"}

package/dist/utilities/httpClient.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errorHandler_1 = require("./errorHandler");
+class HttpClient {
+    constructor(options) {
+        this.options = options;
+        this.client = axios_1.default.create({
+            baseURL: options.baseURL,
+            timeout: options.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        this.setupInterceptors();
+    }
+    setupInterceptors() {
+        // Request interceptor - Add API key to all requests
+        this.client.interceptors.request.use((config) => {
+            if (!config.headers) {
+                config.headers = {};
+            }
+            config.headers['Authorization'] = `Bearer ${this.options.apiKey}`;
+            return config;
+        }, (error) => Promise.reject(error));
+        // Response interceptor - Handle errors
+        this.client.interceptors.response.use((response) => response, (error) => {
+            const voltError = (0, errorHandler_1.handleAxiosError)(error);
+            if (this.options.onError) {
+                this.options.onError(voltError);
+            }
+            return Promise.reject(voltError);
+        });
+    }
+    async get(url) {
+        const response = await this.client.get(url);
+        return response.data;
+    }
+    async post(url, data) {
+        const response = await this.client.post(url, data);
+        return response.data;
+    }
+    async put(url, data) {
+        const response = await this.client.put(url, data);
+        return response.data;
+    }
+    async delete(url) {
+        const response = await this.client.delete(url);
+        return response.data;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=httpClient.js.map

package/dist/utilities/httpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.js","sourceRoot":"","sources":["../../utilities/httpClient.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAqF;AACrF,iDAAgE;AAShE,MAAa,UAAU;IAInB,YAAY,OAA0B;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;aACrC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAEO,iBAAiB;QACrB,oDAAoD;QACpD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAChC,CAAC,MAAkC,EAAE,EAAE;YACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,OAAO,GAAG,EAAS,CAAC;YAC/B,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClE,OAAO,MAAM,CAAC;QAClB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CACnC,CAAC;QAEF,uCAAuC;QACvC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACjC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAiB,EAAE,EAAE;YAClB,MAAM,SAAS,GAAG,IAAA,+BAAgB,EAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,GAAW,EAAE,IAAU;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAI,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,IAAU;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAI,GAAG,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,GAAW;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAI,GAAG,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;CACJ;AA/DD,gCA+DC"}

package/index.ts

@@ -0,0 +1,204 @@
+
+import { VoltEnvError, VoltEnvOptions } from './utilities/errorHandler';
+import { HttpClient } from './utilities/httpClient';
+import { CacheService } from './utilities/cacheService';
+
+export class VoltEnv {
+    private httpClient: HttpClient;
+    private cacheService: CacheService | null;
+
+    /**
+     * Initialize the VoltEnv SDK
+     * @param options Configuration options or API key string
+     */
+    constructor(options: VoltEnvOptions | string) {
+        const config = typeof options === 'string'
+            ? { apiKey: options }
+            : options;
+
+        const {
+            apiKey,
+            baseURL = 'https://api.voltenv.com',
+            timeout = 5000,
+            cache = true,
+            onError
+        } = config;
+
+        this.httpClient = new HttpClient({
+            apiKey,
+            baseURL,
+            timeout,
+            onError
+        });
+
+        this.cacheService = cache ? new CacheService() : null;
+    }
+
+    /**
+     * Get a variable from a specific environment
+     * @param environment The environment name (e.g., 'production', 'development')
+     * @param key The variable key
+     * @param defaultValue Optional default value if not found
+     * @returns The variable value or the default value
+     */
+    async get(
+        environment: string,
+        key: string,
+        defaultValue?: string
+    ): Promise<string | undefined> {
+        const cacheKey = `${environment}:${key}`;
+
+        if (this.cacheService?.has(cacheKey)) {
+            return this.cacheService.get<string>(cacheKey);
+        }
+
+        try {
+            const data = await this.httpClient.get<{ value: string }>(
+                `/v1/variables/${environment}/${key}`
+            );
+
+            const value = data.value;
+
+            if (value && this.cacheService) {
+                this.cacheService.set(cacheKey, value);
+            }
+
+            return value || defaultValue;
+        } catch (error) {
+            if (error instanceof VoltEnvError && error.code === 'NOT_FOUND') {
+                return defaultValue;
+            }
+            throw error;
+        }
+    }
+
+    /**
+     * Get all variables from an environment
+     * @param environment The environment name
+     * @returns A record of key-value pairs
+     */
+    async getAll(environment: string): Promise<Record<string, string>> {
+        const data = await this.httpClient.get<{ variables: Record<string, string> }>(
+            `/v1/variables/${environment}`
+        );
+
+        const variables = data.variables;
+
+        if (this.cacheService) {
+            Object.entries(variables).forEach(([key, value]) => {
+                this.cacheService!.set(`${environment}:${key}`, value);
+            });
+        }
+
+        return variables;
+    }
+
+    /**
+     * Set a variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The variable value
+     */
+    async set(
+        environment: string,
+        key: string,
+        value: string
+    ): Promise<void> {
+        await this.httpClient.put(`/v1/variables/${environment}/${key}`, {
+            value,
+        });
+
+        if (this.cacheService) {
+            this.cacheService.set(`${environment}:${key}`, value);
+        }
+    }
+
+    /**
+     * Set multiple variables at once
+     * @param environment The environment name
+     * @param variables A record of key-value pairs to set
+     */
+    async setMany(
+        environment: string,
+        variables: Record<string, string>
+    ): Promise<void> {
+        await this.httpClient.post(`/v1/variables/${environment}/batch`, {
+            variables,
+        });
+
+        if (this.cacheService) {
+            Object.entries(variables).forEach(([key, value]) => {
+                this.cacheService!.set(`${environment}:${key}`, value);
+            });
+        }
+    }
+
+    /**
+     * Delete a variable from a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async delete(environment: string, key: string): Promise<void> {
+        await this.httpClient.delete(`/v1/variables/${environment}/${key}`);
+
+        if (this.cacheService) {
+            this.cacheService.delete(`${environment}:${key}`);
+        }
+    }
+
+    /**
+     * Delete multiple variables at once
+     * @param environment The environment name
+     * @param keys Array of keys to delete
+     */
+    async deleteMany(environment: string, keys: string[]): Promise<void> {
+        await this.httpClient.post(`/v1/variables/${environment}/batch-delete`, {
+            keys,
+        });
+
+        if (this.cacheService) {
+            keys.forEach(key => {
+                this.cacheService!.delete(`${environment}:${key}`);
+            });
+        }
+    }
+
+    /**
+     * List all environments accessible by this API key
+     * @returns Array of environment names
+     */
+    async listEnvironments(): Promise<string[]> {
+        const data = await this.httpClient.get<{ environments: string[] }>(
+            '/v1/environments'
+        );
+        return data.environments;
+    }
+
+    /**
+     * Sync/refresh variables from server (bypassing cache)
+     *If an environment is provided, it only syncs that environment.
+     * If no environment is provided, it lists all environments and syncs them all.
+     * @param environment Optional environment to sync
+     */
+    async sync(environment?: string): Promise<void> {
+        if (environment) {
+            const variables = await this.getAll(environment);
+
+            if (this.cacheService) {
+                this.cacheService.deleteByPrefix(`${environment}:`);
+
+                Object.entries(variables).forEach(([key, value]) => {
+                    this.cacheService!.set(`${environment}:${key}`, value);
+                });
+            }
+        } else {
+            const environments = await this.listEnvironments();
+
+            for (const env of environments) {
+                await this.sync(env);
+            }
+        }
+    }
+}
+
+export default VoltEnv;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "voltenv-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for VoltEnv",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "voltenv",
+    "sdk",
+    "environment-variables"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "axios": "^1.13.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "CommonJS",
+        "lib": [
+            "ES2020"
+        ],
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "outDir": "./dist",
+        "rootDir": "./",
+        "strict": true,
+        "noImplicitAny": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true,
+        "noImplicitThis": true,
+        "alwaysStrict": true,
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "./index.ts",
+        "./utilities/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/utilities/cacheService.ts

@@ -0,0 +1,56 @@
+/**
+ * Simple in-memory cache service implementation
+ */
+export class CacheService {
+    private cache: Map<string, any>;
+
+    constructor() {
+        this.cache = new Map();
+    }
+
+    /**
+     * Get a value from the cache
+     */
+    get<T>(key: string): T | undefined {
+        return this.cache.get(key);
+    }
+
+    /**
+     * Set a value in the cache
+     */
+    set(key: string, value: any): void {
+        this.cache.set(key, value);
+    }
+
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key: string): boolean {
+        return this.cache.has(key);
+    }
+
+    /**
+     * Delete a value from the cache
+     */
+    delete(key: string): void {
+        this.cache.delete(key);
+    }
+
+    /**
+     * Clear all values from the cache
+     */
+    clear(): void {
+        this.cache.clear();
+    }
+
+    /**
+     * Delete all keys starting with a prefix
+     */
+    deleteByPrefix(prefix: string): void {
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}

package/utilities/errorHandler.ts

@@ -0,0 +1,79 @@
+import { AxiosError } from 'axios';
+
+export interface VoltEnvOptions {
+    apiKey: string;
+    baseURL?: string;
+    timeout?: number;
+    cache?: boolean;
+    onError?: (error: VoltEnvError) => void;
+}
+
+export type VoltEnvErrorCode = 
+    | 'INVALID_API_KEY'
+    | 'PERMISSION_DENIED'
+    | 'NOT_FOUND'
+    | 'RATE_LIMIT_EXCEEDED'
+    | 'SERVER_ERROR'
+    | 'NETWORK_ERROR'
+    | 'REQUEST_ERROR'
+    | 'UNKNOWN_ERROR';
+
+export class VoltEnvError extends Error {
+    constructor(
+        message: string,
+        public code: VoltEnvErrorCode,
+        public statusCode?: number,
+        public originalError?: any
+    ) {
+        super(message);
+        this.name = 'VoltEnvError';
+        Object.setPrototypeOf(this, VoltEnvError.prototype);
+    }
+}
+
+/**
+ * Helper function to transform Axios errors into VoltEnvErrors
+ */
+export function handleAxiosError(error: AxiosError): VoltEnvError {
+    if (error.response) {
+        const { status, data } = error.response;
+        const message = (data as any)?.message || error.message;
+        let code: VoltEnvErrorCode = 'UNKNOWN_ERROR';
+
+        switch (status) {
+            case 401:
+                code = 'INVALID_API_KEY';
+                break;
+            case 403:
+                code = 'PERMISSION_DENIED';
+                break;
+            case 404:
+                code = 'NOT_FOUND';
+                break;
+            case 429:
+                code = 'RATE_LIMIT_EXCEEDED';
+                break;
+            case 500:
+            case 502:
+            case 503:
+                code = 'SERVER_ERROR';
+                break;
+        }
+
+        return new VoltEnvError(message, code, status, error);
+    } else if (error.request) {
+        return new VoltEnvError(
+            'No response from server',
+            'NETWORK_ERROR',
+            undefined,
+            error
+        );
+    } else {
+        return new VoltEnvError(
+            error.message,
+            'REQUEST_ERROR',
+            undefined,
+            error
+        );
+    }
+}

package/utilities/httpClient.ts

@@ -0,0 +1,74 @@
+import axios, { AxiosInstance, AxiosError, InternalAxiosRequestConfig } from 'axios';
+import { VoltEnvError, handleAxiosError } from './errorHandler';
+
+export interface HttpClientOptions {
+    baseURL: string;
+    apiKey: string;
+    timeout?: number;
+    onError?: (error: VoltEnvError) => void;
+}
+
+export class HttpClient {
+    private client: AxiosInstance;
+    private options: HttpClientOptions;
+
+    constructor(options: HttpClientOptions) {
+        this.options = options;
+
+        this.client = axios.create({
+            baseURL: options.baseURL,
+            timeout: options.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+
+        this.setupInterceptors();
+    }
+
+    private setupInterceptors(): void {
+        // Request interceptor - Add API key to all requests
+        this.client.interceptors.request.use(
+            (config: InternalAxiosRequestConfig) => {
+                if (!config.headers) {
+                    config.headers = {} as any;
+                }
+                config.headers['Authorization'] = `Bearer ${this.options.apiKey}`;
+                return config;
+            },
+            (error) => Promise.reject(error)
+        );
+
+        // Response interceptor - Handle errors
+        this.client.interceptors.response.use(
+            (response) => response,
+            (error: AxiosError) => {
+                const voltError = handleAxiosError(error);
+                if (this.options.onError) {
+                    this.options.onError(voltError);
+                }
+                return Promise.reject(voltError);
+            }
+        );
+    }
+
+    async get<T>(url: string): Promise<T> {
+        const response = await this.client.get<T>(url);
+        return response.data;
+    }
+
+    async post<T>(url: string, data?: any): Promise<T> {
+        const response = await this.client.post<T>(url, data);
+        return response.data;
+    }
+
+    async put<T>(url: string, data?: any): Promise<T> {
+        const response = await this.client.put<T>(url, data);
+        return response.data;
+    }
+
+    async delete<T>(url: string): Promise<T> {
+        const response = await this.client.delete<T>(url);
+        return response.data;
+    }
+}

package/verify.ts

@@ -0,0 +1,18 @@
+import { VoltEnv } from './index';
+
+async function verify() {
+    try {
+        console.log('Initializing VoltEnv...');
+        const voltEnv = new VoltEnv({
+            apiKey: 'test-api-key',
+            cache: true
+        });
+
+        console.log('VoltEnv initialized successfully.');
+        console.log('Methods available:', Object.getOwnPropertyNames(Object.getPrototypeOf(voltEnv)));
+    } catch (error) {
+        console.error('Verification failed:', error);
+    }
+}
+
+verify();