voltenv-sdk 1.0.0 → 1.1.1

package/README.md

@@ -0,0 +1,62 @@
+# VoltEnv Node.js SDK
+
+TypeScript SDK for VoltEnv - The Environment Variable Management System.
+
+## Installation
+
+```bash
+npm install voltenv-sdk
+```
+
+## Usage
+
+### Initialization
+
+```typescript
+import VoltEnv from 'voltenv-sdk';
+
+const voltenv = new VoltEnv({
+  apiKey: 'your_api_key',
+  // Optional
+  baseURL: 'https://api.voltenv.com', // Defaults to official API
+  cache: true, // Enable local caching (default: true)
+  timeout: 5000 // Request timeout in ms
+});
+```
+
+### Get a Variable
+
+```typescript
+// Get a specific variable from an environment
+const port = await voltenv.get('development', 'PORT', '3000');
+console.log(port); // Returns value or default '3000'
+```
+
+### Get All Variables
+
+```typescript
+// Get all variables for an environment
+const variables = await voltenv.all('development');
+console.log(variables);
+// { PORT: "3000", DB_HOST: "localhost", ... }
+```
+
+### Set a Variable
+
+```typescript
+await voltenv.set('development', 'API_KEY', 'secret-value');
+```
+
+### Delete a Variable
+
+```typescript
+await voltenv.delete('development', 'API_KEY');
+```
+
+### Caching
+The SDK includes a built-in LRU cache to minimize API requests. You can manually sync/refresh the cache:
+
+```typescript
+// Force refresh all variables for an environment from the server
+await voltenv.sync('development');
+```

package/dist/index.d.ts

@@ -2,11 +2,24 @@ import { VoltEnvOptions } from './utilities/errorHandler';
 export declare class VoltEnv {
     private httpClient;
     private cacheService;
+    private resolvedPrefix;
     /**
      * Initialize the VoltEnv SDK
      * @param options Configuration options or API key string
      */
     constructor(options: VoltEnvOptions | string);
+    /**
+     * Resolve the prefix based on framework or explicit option
+     */
+    private resolvePrefix;
+    /**
+     * Try to detect the framework from package.json
+     */
+    private detectFramework;
+    /**
+     * Apply prefix to a key if it's missing
+     */
+    private applyPrefix;
     /**
      * Get a variable from a specific environment
      * @param environment The environment name (e.g., 'production', 'development')
@@ -28,6 +41,21 @@ export declare class VoltEnv {
      * @param value The variable value
      */
     set(environment: string, key: string, value: string): Promise<void>;
+    /**
+     * Set a secret variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The secret value
+     */
+    setSecret(environment: string, key: string, value: string): Promise<void>;
+    /**
+     * Watch for changes in an environment
+     * @param environment The environment name
+     * @param callback Function to call when changes occur
+     * @param interval Polling interval in milliseconds (default: 30000)
+     * @returns A function to stop watching
+     */
+    watch(environment: string, callback: (variables: Record<string, string>) => void, interval?: number): () => void;
     /**
      * Set multiple variables at once
      * @param environment The environment name
@@ -46,11 +74,52 @@ export declare class VoltEnv {
      * @param keys Array of keys to delete
      */
     deleteMany(environment: string, keys: string[]): Promise<void>;
+    /**
+     * Get metadata for a specific variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    getMetadata(environment: string, key: string): Promise<Record<string, any>>;
+    /**
+     * Get the audit history of a variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    getHistory(environment: string, key: string): Promise<any[]>;
+    /**
+     * Export all variables in an environment to a .env file
+     * @param environment The environment name
+     * @param filePath Path to the .env file to create/overwrite
+     */
+    exportToEnvFile(environment: string, filePath: string): Promise<void>;
+    /**
+     * Load variables from a .env file and set them in an environment
+     * @param environment The environment name
+     * @param filePath Path to the .env file to read from
+     */
+    loadFromEnvFile(environment: string, filePath: string): Promise<void>;
     /**
      * List all environments accessible by this API key
      * @returns Array of environment names
      */
     listEnvironments(): Promise<string[]>;
+    /**
+     * Create a new environment
+     * @param name The name of the environment
+     * @param options Optional configuration for the environment
+     */
+    createEnvironment(name: string, options?: Record<string, any>): Promise<void>;
+    /**
+     * Update an existing environment
+     * @param name The current name of the environment
+     * @param update Data to update (e.g., { name: 'new-name' })
+     */
+    updateEnvironment(name: string, update: Record<string, any>): Promise<void>;
+    /**
+     * Delete an environment
+     * @param name The name of the environment to delete
+     */
+    deleteEnvironment(name: string): Promise<void>;
     /**
      * Sync/refresh variables from server (bypassing cache)
      *If an environment is provided, it only syncs that environment.
@@ -58,6 +127,17 @@ export declare class VoltEnv {
      * @param environment Optional environment to sync
      */
     sync(environment?: string): Promise<void>;
+    /**
+     * Get all cached keys (for debugging)
+     */
+    getCacheKeys(): string[];
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
 }
 export default VoltEnv;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,6 +1,41 @@
 "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.VoltEnv = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const errorHandler_1 = require("./utilities/errorHandler");
 const httpClient_1 = require("./utilities/httpClient");
 const cacheService_1 = require("./utilities/cacheService");
@@ -10,10 +45,11 @@ class VoltEnv {
      * @param options Configuration options or API key string
      */
     constructor(options) {
+        this.resolvedPrefix = '';
         const config = typeof options === 'string'
             ? { apiKey: options }
             : options;
-        const { apiKey, baseURL = 'https://api.voltenv.com', timeout = 5000, cache = true, onError } = config;
+        const { apiKey, baseURL = 'https://api.voltenv.com', timeout = 5000, cache = true, onError, framework, prefix } = config;
         this.httpClient = new httpClient_1.HttpClient({
             apiKey,
             baseURL,
@@ -21,6 +57,53 @@ class VoltEnv {
             onError
         });
         this.cacheService = cache ? new cacheService_1.CacheService() : null;
+        this.resolvedPrefix = this.resolvePrefix(framework, prefix);
+    }
+    /**
+     * Resolve the prefix based on framework or explicit option
+     */
+    resolvePrefix(framework, explicitPrefix) {
+        if (explicitPrefix !== undefined)
+            return explicitPrefix;
+        const fw = framework || this.detectFramework();
+        switch (fw) {
+            case 'vite': return 'VITE_';
+            case 'nextjs': return 'NEXT_PUBLIC_';
+            case 'cra': return 'REACT_APP_';
+            default: return '';
+        }
+    }
+    /**
+     * Try to detect the framework from package.json
+     */
+    detectFramework() {
+        try {
+            const packageJsonPath = path.join(process.cwd(), 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+                if (deps['vite'])
+                    return 'vite';
+                if (deps['next'])
+                    return 'nextjs';
+                if (deps['react-scripts'])
+                    return 'cra';
+            }
+        }
+        catch (error) {
+            // Silently fail and return empty string if package.json cannot be read/parsed
+        }
+        return '';
+    }
+    /**
+     * Apply prefix to a key if it's missing
+     */
+    applyPrefix(key) {
+        if (!this.resolvedPrefix)
+            return key;
+        if (key.startsWith(this.resolvedPrefix))
+            return key;
+        return `${this.resolvedPrefix}${key}`;
     }
     /**
      * Get a variable from a specific environment
@@ -30,12 +113,13 @@ class VoltEnv {
      * @returns The variable value or the default value
      */
     async get(environment, key, defaultValue) {
-        const cacheKey = `${environment}:${key}`;
+        const prefixedKey = this.applyPrefix(key);
+        const cacheKey = `${environment}:${prefixedKey}`;
         if (this.cacheService?.has(cacheKey)) {
             return this.cacheService.get(cacheKey);
         }
         try {
-            const data = await this.httpClient.get(`/v1/variables/${environment}/${key}`);
+            const data = await this.httpClient.get(`/v1/variables/${environment}/${prefixedKey}`);
             const value = data.value;
             if (value && this.cacheService) {
                 this.cacheService.set(cacheKey, value);
@@ -71,24 +155,72 @@ class VoltEnv {
      * @param value The variable value
      */
     async set(environment, key, value) {
-        await this.httpClient.put(`/v1/variables/${environment}/${key}`, {
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.put(`/v1/variables/${environment}/${prefixedKey}`, {
+            value,
+        });
+        if (this.cacheService) {
+            this.cacheService.set(`${environment}:${prefixedKey}`, value);
+        }
+    }
+    /**
+     * Set a secret variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The secret value
+     */
+    async setSecret(environment, key, value) {
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.put(`/v1/variables/${environment}/${prefixedKey}`, {
             value,
+            isSecret: true
         });
         if (this.cacheService) {
-            this.cacheService.set(`${environment}:${key}`, value);
+            this.cacheService.set(`${environment}:${prefixedKey}`, value);
         }
     }
+    /**
+     * Watch for changes in an environment
+     * @param environment The environment name
+     * @param callback Function to call when changes occur
+     * @param interval Polling interval in milliseconds (default: 30000)
+     * @returns A function to stop watching
+     */
+    watch(environment, callback, interval = 30000) {
+        let previousVariables = '';
+        const fetchAndCompare = async () => {
+            try {
+                const variables = await this.getAll(environment);
+                const currentVariables = JSON.stringify(variables);
+                if (currentVariables !== previousVariables) {
+                    previousVariables = currentVariables;
+                    callback(variables);
+                }
+            }
+            catch (error) {
+                console.error(`Error in VoltEnv watcher for ${environment}:`, error);
+            }
+        };
+        // Initial fetch
+        fetchAndCompare();
+        const timer = setInterval(fetchAndCompare, interval);
+        return () => clearInterval(timer);
+    }
     /**
      * Set multiple variables at once
      * @param environment The environment name
      * @param variables A record of key-value pairs to set
      */
     async setMany(environment, variables) {
+        const prefixedVariables = {};
+        Object.entries(variables).forEach(([key, value]) => {
+            prefixedVariables[this.applyPrefix(key)] = value;
+        });
         await this.httpClient.post(`/v1/variables/${environment}/batch`, {
-            variables,
+            variables: prefixedVariables,
         });
         if (this.cacheService) {
-            Object.entries(variables).forEach(([key, value]) => {
+            Object.entries(prefixedVariables).forEach(([key, value]) => {
                 this.cacheService.set(`${environment}:${key}`, value);
             });
         }
@@ -99,9 +231,10 @@ class VoltEnv {
      * @param key The variable key
      */
     async delete(environment, key) {
-        await this.httpClient.delete(`/v1/variables/${environment}/${key}`);
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.delete(`/v1/variables/${environment}/${prefixedKey}`);
         if (this.cacheService) {
-            this.cacheService.delete(`${environment}:${key}`);
+            this.cacheService.delete(`${environment}:${prefixedKey}`);
         }
     }
     /**
@@ -110,15 +243,78 @@ class VoltEnv {
      * @param keys Array of keys to delete
      */
     async deleteMany(environment, keys) {
+        const prefixedKeys = keys.map(k => this.applyPrefix(k));
         await this.httpClient.post(`/v1/variables/${environment}/batch-delete`, {
-            keys,
+            keys: prefixedKeys,
         });
         if (this.cacheService) {
-            keys.forEach(key => {
+            prefixedKeys.forEach(key => {
                 this.cacheService.delete(`${environment}:${key}`);
             });
         }
     }
+    /**
+     * Get metadata for a specific variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async getMetadata(environment, key) {
+        const prefixedKey = this.applyPrefix(key);
+        const data = await this.httpClient.get(`/v1/variables/${environment}/${prefixedKey}/metadata`);
+        return data;
+    }
+    /**
+     * Get the audit history of a variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async getHistory(environment, key) {
+        const prefixedKey = this.applyPrefix(key);
+        const data = await this.httpClient.get(`/v1/variables/${environment}/${prefixedKey}/history`);
+        return data.history;
+    }
+    /**
+     * Export all variables in an environment to a .env file
+     * @param environment The environment name
+     * @param filePath Path to the .env file to create/overwrite
+     */
+    async exportToEnvFile(environment, filePath) {
+        const variables = await this.getAll(environment);
+        const content = Object.entries(variables)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('\n');
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(process.cwd(), filePath);
+        fs.writeFileSync(absolutePath, content, 'utf8');
+    }
+    /**
+     * Load variables from a .env file and set them in an environment
+     * @param environment The environment name
+     * @param filePath Path to the .env file to read from
+     */
+    async loadFromEnvFile(environment, filePath) {
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(process.cwd(), filePath);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`File not found: ${absolutePath}`);
+        }
+        const content = fs.readFileSync(absolutePath, 'utf8');
+        const variables = {};
+        content.split(/\r?\n/).forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine && !trimmedLine.startsWith('#')) {
+                const [key, ...valueParts] = trimmedLine.split('=');
+                if (key) {
+                    variables[key.trim()] = valueParts.join('=').trim();
+                }
+            }
+        });
+        if (Object.keys(variables).length > 0) {
+            await this.setMany(environment, variables);
+        }
+    }
     /**
      * List all environments accessible by this API key
      * @returns Array of environment names
@@ -127,6 +323,35 @@ class VoltEnv {
         const data = await this.httpClient.get('/v1/environments');
         return data.environments;
     }
+    /**
+     * Create a new environment
+     * @param name The name of the environment
+     * @param options Optional configuration for the environment
+     */
+    async createEnvironment(name, options) {
+        await this.httpClient.post('/v1/environments', {
+            name,
+            ...options
+        });
+    }
+    /**
+     * Update an existing environment
+     * @param name The current name of the environment
+     * @param update Data to update (e.g., { name: 'new-name' })
+     */
+    async updateEnvironment(name, update) {
+        await this.httpClient.put(`/v1/environments/${name}`, update);
+    }
+    /**
+     * Delete an environment
+     * @param name The name of the environment to delete
+     */
+    async deleteEnvironment(name) {
+        await this.httpClient.delete(`/v1/environments/${name}`);
+        if (this.cacheService) {
+            this.cacheService.deleteByPrefix(`${name}:`);
+        }
+    }
     /**
      * Sync/refresh variables from server (bypassing cache)
      *If an environment is provided, it only syncs that environment.
@@ -150,6 +375,27 @@ class VoltEnv {
             }
         }
     }
+    /**
+     * Get all cached keys (for debugging)
+     */
+    getCacheKeys() {
+        if (!this.cacheService) {
+            return [];
+        }
+        return Array.from(this.cacheService.keys());
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        if (!this.cacheService) {
+            return { size: 0, keys: [] };
+        }
+        return {
+            size: this.cacheService.size,
+            keys: Array.from(this.cacheService.keys())
+        };
+    }
 }
 exports.VoltEnv = VoltEnv;
 exports.default = VoltEnv;

package/dist/index.js.map

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

package/dist/utilities/cacheService.d.ts

@@ -1,9 +1,12 @@
-/**
- * Simple in-memory cache service implementation
- */
+export interface CacheServiceOptions {
+    max?: number;
+    ttl?: number;
+    maxSize?: number;
+    sizeCalculation?: (value: any, key: string) => number;
+}
 export declare class CacheService {
     private cache;
-    constructor();
+    constructor(options?: CacheServiceOptions);
     /**
      * Get a value from the cache
      */
@@ -11,7 +14,7 @@ export declare class CacheService {
     /**
      * Set a value in the cache
      */
-    set(key: string, value: any): void;
+    set(key: string, value: any, ttl?: number): void;
     /**
      * Check if a key exists in the cache
      */
@@ -19,7 +22,7 @@ export declare class CacheService {
     /**
      * Delete a value from the cache
      */
-    delete(key: string): void;
+    delete(key: string): boolean;
     /**
      * Clear all values from the cache
      */
@@ -28,5 +31,17 @@ export declare class CacheService {
      * Delete all keys starting with a prefix
      */
     deleteByPrefix(prefix: string): void;
+    /**
+     * Get the current size of the cache
+     */
+    get size(): number;
+    /**
+     * Get all keys in the cache
+     */
+    keys(): IterableIterator<string>;
+    /**
+     * Get all values in the cache
+     */
+    values(): IterableIterator<any>;
 }
 //# sourceMappingURL=cacheService.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"cacheService.d.ts","sourceRoot":"","sources":["../../utilities/cacheService.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACzD;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAwB;gBAEzB,OAAO,GAAE,mBAAwB;IAS7C;;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,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC;;OAEG;IACH,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC;CAGlC"}

package/dist/utilities/cacheService.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CacheService = void 0;
-/**
- * Simple in-memory cache service implementation
- */
+const lru_cache_1 = require("lru-cache");
 class CacheService {
-    constructor() {
-        this.cache = new Map();
+    constructor(options = {}) {
+        this.cache = new lru_cache_1.LRUCache({
+            max: options.max ?? 500, // Default: 500 items
+            ttl: options.ttl, // Optional TTL
+            maxSize: options.maxSize, // Optional size limit
+            sizeCalculation: options.sizeCalculation,
+        });
     }
     /**
      * Get a value from the cache
@@ -17,8 +20,13 @@ class CacheService {
     /**
      * Set a value in the cache
      */
-    set(key, value) {
-        this.cache.set(key, value);
+    set(key, value, ttl) {
+        if (ttl !== undefined) {
+            this.cache.set(key, value, { ttl });
+        }
+        else {
+            this.cache.set(key, value);
+        }
     }
     /**
      * Check if a key exists in the cache
@@ -30,7 +38,7 @@ class CacheService {
      * Delete a value from the cache
      */
     delete(key) {
-        this.cache.delete(key);
+        return this.cache.delete(key);
     }
     /**
      * Clear all values from the cache
@@ -42,12 +50,31 @@ class CacheService {
      * Delete all keys starting with a prefix
      */
     deleteByPrefix(prefix) {
-        for (const key of this.cache.keys()) {
+        const keys = Array.from(this.cache.keys());
+        for (const key of keys) {
             if (key.startsWith(prefix)) {
                 this.cache.delete(key);
             }
         }
     }
+    /**
+     * Get the current size of the cache
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get all keys in the cache
+     */
+    keys() {
+        return this.cache.keys();
+    }
+    /**
+     * Get all values in the cache
+     */
+    values() {
+        return this.cache.values();
+    }
 }
 exports.CacheService = CacheService;
 //# sourceMappingURL=cacheService.js.map

package/dist/utilities/cacheService.js.map

@@ -1 +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"}
+{"version":3,"file":"cacheService.js","sourceRoot":"","sources":["../../utilities/cacheService.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AASrC,MAAa,YAAY;IAGrB,YAAY,UAA+B,EAAE;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAQ,CAAC;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,EAAS,qBAAqB;YACrD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAgB,eAAe;YAC/C,OAAO,EAAE,OAAO,CAAC,OAAO,EAAQ,sBAAsB;YACtD,eAAe,EAAE,OAAO,CAAC,eAAe;SAC3C,CAAC,CAAC;IACP,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,EAAE,GAAY;QACrC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,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,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,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;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;CACJ;AAnFD,oCAmFC"}

package/dist/utilities/errorHandler.d.ts

@@ -5,6 +5,8 @@ export interface VoltEnvOptions {
     timeout?: number;
     cache?: boolean;
     onError?: (error: VoltEnvError) => void;
+    framework?: 'vite' | 'nextjs' | 'cra' | 'custom';
+    prefix?: string;
 }
 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 {

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

@@ -1 +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"}
+{"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;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;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.map

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

@@ -1,4 +1,6 @@
 
+import * as fs from 'fs';
+import * as path from 'path';
 import { VoltEnvError, VoltEnvOptions } from './utilities/errorHandler';
 import { HttpClient } from './utilities/httpClient';
 import { CacheService } from './utilities/cacheService';
@@ -6,6 +8,7 @@ import { CacheService } from './utilities/cacheService';
 export class VoltEnv {
     private httpClient: HttpClient;
     private cacheService: CacheService | null;
+    private resolvedPrefix: string = '';
 
     /**
      * Initialize the VoltEnv SDK
@@ -21,7 +24,9 @@ export class VoltEnv {
             baseURL = 'https://api.voltenv.com',
             timeout = 5000,
             cache = true,
-            onError
+            onError,
+            framework,
+            prefix
         } = config;
 
         this.httpClient = new HttpClient({
@@ -32,6 +37,52 @@ export class VoltEnv {
         });
 
         this.cacheService = cache ? new CacheService() : null;
+        this.resolvedPrefix = this.resolvePrefix(framework, prefix);
+    }
+
+    /**
+     * Resolve the prefix based on framework or explicit option
+     */
+    private resolvePrefix(framework?: string, explicitPrefix?: string): string {
+        if (explicitPrefix !== undefined) return explicitPrefix;
+
+        const fw = framework || this.detectFramework();
+
+        switch (fw) {
+            case 'vite': return 'VITE_';
+            case 'nextjs': return 'NEXT_PUBLIC_';
+            case 'cra': return 'REACT_APP_';
+            default: return '';
+        }
+    }
+
+    /**
+     * Try to detect the framework from package.json
+     */
+    private detectFramework(): string {
+        try {
+            const packageJsonPath = path.join(process.cwd(), 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+
+                if (deps['vite']) return 'vite';
+                if (deps['next']) return 'nextjs';
+                if (deps['react-scripts']) return 'cra';
+            }
+        } catch (error) {
+            // Silently fail and return empty string if package.json cannot be read/parsed
+        }
+        return '';
+    }
+
+    /**
+     * Apply prefix to a key if it's missing
+     */
+    private applyPrefix(key: string): string {
+        if (!this.resolvedPrefix) return key;
+        if (key.startsWith(this.resolvedPrefix)) return key;
+        return `${this.resolvedPrefix}${key}`;
     }
 
     /**
@@ -46,7 +97,8 @@ export class VoltEnv {
         key: string,
         defaultValue?: string
     ): Promise<string | undefined> {
-        const cacheKey = `${environment}:${key}`;
+        const prefixedKey = this.applyPrefix(key);
+        const cacheKey = `${environment}:${prefixedKey}`;
 
         if (this.cacheService?.has(cacheKey)) {
             return this.cacheService.get<string>(cacheKey);
@@ -54,7 +106,7 @@ export class VoltEnv {
 
         try {
             const data = await this.httpClient.get<{ value: string }>(
-                `/v1/variables/${environment}/${key}`
+                `/v1/variables/${environment}/${prefixedKey}`
             );
 
             const value = data.value;
@@ -104,15 +156,74 @@ export class VoltEnv {
         key: string,
         value: string
     ): Promise<void> {
-        await this.httpClient.put(`/v1/variables/${environment}/${key}`, {
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.put(`/v1/variables/${environment}/${prefixedKey}`, {
+            value,
+        });
+
+        if (this.cacheService) {
+            this.cacheService.set(`${environment}:${prefixedKey}`, value);
+        }
+    }
+
+    /**
+     * Set a secret variable in a specific environment
+     * @param environment The environment name
+     * @param key The variable key
+     * @param value The secret value
+     */
+    async setSecret(
+        environment: string,
+        key: string,
+        value: string
+    ): Promise<void> {
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.put(`/v1/variables/${environment}/${prefixedKey}`, {
             value,
+            isSecret: true
         });
 
         if (this.cacheService) {
-            this.cacheService.set(`${environment}:${key}`, value);
+            this.cacheService.set(`${environment}:${prefixedKey}`, value);
         }
     }
 
+    /**
+     * Watch for changes in an environment
+     * @param environment The environment name
+     * @param callback Function to call when changes occur
+     * @param interval Polling interval in milliseconds (default: 30000)
+     * @returns A function to stop watching
+     */
+    watch(
+        environment: string,
+        callback: (variables: Record<string, string>) => void,
+        interval: number = 30000
+    ): () => void {
+        let previousVariables: string = '';
+
+        const fetchAndCompare = async () => {
+            try {
+                const variables = await this.getAll(environment);
+                const currentVariables = JSON.stringify(variables);
+
+                if (currentVariables !== previousVariables) {
+                    previousVariables = currentVariables;
+                    callback(variables);
+                }
+            } catch (error) {
+                console.error(`Error in VoltEnv watcher for ${environment}:`, error);
+            }
+        };
+
+        // Initial fetch
+        fetchAndCompare();
+
+        const timer = setInterval(fetchAndCompare, interval);
+
+        return () => clearInterval(timer);
+    }
+
     /**
      * Set multiple variables at once
      * @param environment The environment name
@@ -122,12 +233,17 @@ export class VoltEnv {
         environment: string,
         variables: Record<string, string>
     ): Promise<void> {
+        const prefixedVariables: Record<string, string> = {};
+        Object.entries(variables).forEach(([key, value]) => {
+            prefixedVariables[this.applyPrefix(key)] = value;
+        });
+
         await this.httpClient.post(`/v1/variables/${environment}/batch`, {
-            variables,
+            variables: prefixedVariables,
         });
 
         if (this.cacheService) {
-            Object.entries(variables).forEach(([key, value]) => {
+            Object.entries(prefixedVariables).forEach(([key, value]) => {
                 this.cacheService!.set(`${environment}:${key}`, value);
             });
         }
@@ -139,10 +255,11 @@ export class VoltEnv {
      * @param key The variable key
      */
     async delete(environment: string, key: string): Promise<void> {
-        await this.httpClient.delete(`/v1/variables/${environment}/${key}`);
+        const prefixedKey = this.applyPrefix(key);
+        await this.httpClient.delete(`/v1/variables/${environment}/${prefixedKey}`);
 
         if (this.cacheService) {
-            this.cacheService.delete(`${environment}:${key}`);
+            this.cacheService.delete(`${environment}:${prefixedKey}`);
         }
     }
 
@@ -152,17 +269,94 @@ export class VoltEnv {
      * @param keys Array of keys to delete
      */
     async deleteMany(environment: string, keys: string[]): Promise<void> {
+        const prefixedKeys = keys.map(k => this.applyPrefix(k));
         await this.httpClient.post(`/v1/variables/${environment}/batch-delete`, {
-            keys,
+            keys: prefixedKeys,
         });
 
         if (this.cacheService) {
-            keys.forEach(key => {
+            prefixedKeys.forEach(key => {
                 this.cacheService!.delete(`${environment}:${key}`);
             });
         }
     }
 
+    /**
+     * Get metadata for a specific variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async getMetadata(environment: string, key: string): Promise<Record<string, any>> {
+        const prefixedKey = this.applyPrefix(key);
+        const data = await this.httpClient.get<Record<string, any>>(
+            `/v1/variables/${environment}/${prefixedKey}/metadata`
+        );
+        return data;
+    }
+
+    /**
+     * Get the audit history of a variable
+     * @param environment The environment name
+     * @param key The variable key
+     */
+    async getHistory(environment: string, key: string): Promise<any[]> {
+        const prefixedKey = this.applyPrefix(key);
+        const data = await this.httpClient.get<{ history: any[] }>(
+            `/v1/variables/${environment}/${prefixedKey}/history`
+        );
+        return data.history;
+    }
+
+    /**
+     * Export all variables in an environment to a .env file
+     * @param environment The environment name
+     * @param filePath Path to the .env file to create/overwrite
+     */
+    async exportToEnvFile(environment: string, filePath: string): Promise<void> {
+        const variables = await this.getAll(environment);
+        const content = Object.entries(variables)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('\n');
+
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(process.cwd(), filePath);
+
+        fs.writeFileSync(absolutePath, content, 'utf8');
+    }
+
+    /**
+     * Load variables from a .env file and set them in an environment
+     * @param environment The environment name
+     * @param filePath Path to the .env file to read from
+     */
+    async loadFromEnvFile(environment: string, filePath: string): Promise<void> {
+        const absolutePath = path.isAbsolute(filePath)
+            ? filePath
+            : path.join(process.cwd(), filePath);
+
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`File not found: ${absolutePath}`);
+        }
+
+        const content = fs.readFileSync(absolutePath, 'utf8');
+        const variables: Record<string, string> = {};
+
+        content.split(/\r?\n/).forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine && !trimmedLine.startsWith('#')) {
+                const [key, ...valueParts] = trimmedLine.split('=');
+                if (key) {
+                    variables[key.trim()] = valueParts.join('=').trim();
+                }
+            }
+        });
+
+        if (Object.keys(variables).length > 0) {
+            await this.setMany(environment, variables);
+        }
+    }
+
     /**
      * List all environments accessible by this API key
      * @returns Array of environment names
@@ -174,6 +368,39 @@ export class VoltEnv {
         return data.environments;
     }
 
+    /**
+     * Create a new environment
+     * @param name The name of the environment
+     * @param options Optional configuration for the environment
+     */
+    async createEnvironment(name: string, options?: Record<string, any>): Promise<void> {
+        await this.httpClient.post('/v1/environments', {
+            name,
+            ...options
+        });
+    }
+
+    /**
+     * Update an existing environment
+     * @param name The current name of the environment
+     * @param update Data to update (e.g., { name: 'new-name' })
+     */
+    async updateEnvironment(name: string, update: Record<string, any>): Promise<void> {
+        await this.httpClient.put(`/v1/environments/${name}`, update);
+    }
+
+    /**
+     * Delete an environment
+     * @param name The name of the environment to delete
+     */
+    async deleteEnvironment(name: string): Promise<void> {
+        await this.httpClient.delete(`/v1/environments/${name}`);
+
+        if (this.cacheService) {
+            this.cacheService.deleteByPrefix(`${name}:`);
+        }
+    }
+
     /**
      * Sync/refresh variables from server (bypassing cache)
      *If an environment is provided, it only syncs that environment.
@@ -199,6 +426,29 @@ export class VoltEnv {
             }
         }
     }
+
+    /**
+     * Get all cached keys (for debugging)
+     */
+    getCacheKeys(): string[] {
+        if (!this.cacheService) {
+            return [];
+        }
+        return Array.from(this.cacheService.keys());
+    }
+
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): { size: number; keys: string[] } {
+        if (!this.cacheService) {
+            return { size: 0, keys: [] };
+        }
+        return {
+            size: this.cacheService.size,
+            keys: Array.from(this.cacheService.keys())
+        };
+    }
 }
 
 export default VoltEnv;

package/jest.config.js

@@ -0,0 +1,9 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    testMatch: ['**/tests/**/*.test.ts'],
+    collectCoverage: true,
+    coverageDirectory: 'coverage',
+    coveragePathIgnorePatterns: ['/node_modules/', '/dist/'],
+};

package/package.json

@@ -1,29 +1,36 @@
-{
-  "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"
-  }
-}
+{
+  "name": "voltenv-sdk",
+  "version": "1.1.1",
+  "description": "TypeScript SDK for VoltEnv",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "voltenv",
+    "sdk",
+    "environment-variables"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "axios": "^1.13.2",
+    "lru-cache": "^11.2.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
+    "jest": "^30.2.0",
+    "jest-environment-node": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/utilities/cacheService.ts

@@ -1,11 +1,22 @@
-/**
- * Simple in-memory cache service implementation
- */
+import { LRUCache } from "lru-cache";
+
+export interface CacheServiceOptions {
+    max?: number;           // Maximum number of items
+    ttl?: number;          // Time to live in milliseconds
+    maxSize?: number;      // Maximum size in bytes (optional)
+    sizeCalculation?: (value: any, key: string) => number;
+}
+
 export class CacheService {
-    private cache: Map<string, any>;
+    private cache: LRUCache<string, any>;
 
-    constructor() {
-        this.cache = new Map();
+    constructor(options: CacheServiceOptions = {}) {
+        this.cache = new LRUCache({
+            max: options.max ?? 500,        // Default: 500 items
+            ttl: options.ttl,               // Optional TTL
+            maxSize: options.maxSize,       // Optional size limit
+            sizeCalculation: options.sizeCalculation,
+        });
     }
 
     /**
@@ -18,8 +29,12 @@ export class CacheService {
     /**
      * Set a value in the cache
      */
-    set(key: string, value: any): void {
-        this.cache.set(key, value);
+    set(key: string, value: any, ttl?: number): void {
+        if (ttl !== undefined) {
+            this.cache.set(key, value, { ttl });
+        } else {
+            this.cache.set(key, value);
+        }
     }
 
     /**
@@ -32,8 +47,8 @@ export class CacheService {
     /**
      * Delete a value from the cache
      */
-    delete(key: string): void {
-        this.cache.delete(key);
+    delete(key: string): boolean {
+        return this.cache.delete(key);
     }
 
     /**
@@ -47,10 +62,32 @@ export class CacheService {
      * Delete all keys starting with a prefix
      */
     deleteByPrefix(prefix: string): void {
-        for (const key of this.cache.keys()) {
+        const keys = Array.from(this.cache.keys());
+        for (const key of keys) {
             if (key.startsWith(prefix)) {
                 this.cache.delete(key);
             }
         }
     }
-}
+
+    /**
+     * Get the current size of the cache
+     */
+    get size(): number {
+        return this.cache.size;
+    }
+
+    /**
+     * Get all keys in the cache
+     */
+    keys(): IterableIterator<string> {
+        return this.cache.keys();
+    }
+
+    /**
+     * Get all values in the cache
+     */
+    values(): IterableIterator<any> {
+        return this.cache.values();
+    }
+}

package/utilities/errorHandler.ts

@@ -6,9 +6,11 @@ export interface VoltEnvOptions {
     timeout?: number;
     cache?: boolean;
     onError?: (error: VoltEnvError) => void;
+    framework?: 'vite' | 'nextjs' | 'cra' | 'custom';
+    prefix?: string;
 }
 
-export type VoltEnvErrorCode = 
+export type VoltEnvErrorCode =
     | 'INVALID_API_KEY'
     | 'PERMISSION_DENIED'
     | 'NOT_FOUND'

package/dist/tsconfig.tsbuildinfo

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

package/verify.ts

@@ -1,18 +0,0 @@
-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();