opensecureconf-client 1.0.0 → 2.2.0

package/dist/index.d.mts

@@ -2,9 +2,9 @@
  * OpenSecureConf JavaScript/TypeScript Client
  *
  * A comprehensive REST API client for OpenSecureConf - Encrypted configuration
- * management system with cluster support.
+ * management system with cluster support and HTTPS/SSL.
  *
- * @version 1.0.0
+ * @version 2.2.0
  * @license MIT
  */
 /**
@@ -22,9 +22,9 @@ interface ConfigEntry {
 interface ClusterStatus {
     enabled: boolean;
     mode?: string;
-    nodeid?: string;
-    totalnodes?: number;
-    healthynodes?: number;
+    node_id?: string;
+    total_nodes?: number;
+    healthy_nodes?: number;
 }
 /**
  * Client configuration options
@@ -34,6 +34,7 @@ interface OpenSecureConfOptions {
     userKey: string;
     apiKey?: string;
     timeout?: number;
+    rejectUnauthorized?: boolean;
 }
 /**
  * Custom error class for OpenSecureConf API errors
@@ -45,28 +46,117 @@ declare class OpenSecureConfError extends Error {
 }
 /**
  * OpenSecureConf API Client
+ *
+ * @example
+ * // Basic HTTP usage
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'http://localhost:9000',
+ *   userKey: 'my-secret-key-12345'
+ * });
+ *
+ * @example
+ * // HTTPS with valid certificate
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'https://config.example.com',
+ *   userKey: 'my-secret-key-12345',
+ *   apiKey: 'optional-api-key'
+ * });
+ *
+ * @example
+ * // HTTPS with self-signed certificate (Node.js)
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'https://localhost:9443',
+ *   userKey: 'my-secret-key-12345',
+ *   rejectUnauthorized: false // Accept self-signed certs
+ * });
  */
 declare class OpenSecureConfClient {
     private baseUrl;
     private userKey;
     private apiKey?;
     private timeout;
+    private rejectUnauthorized;
+    private httpsAgent?;
     constructor(options: OpenSecureConfOptions);
+    /**
+     * Setup HTTPS agent for Node.js environment to handle SSL certificates
+     */
+    private setupNodeHttpsAgent;
+    /**
+     * Make HTTP request with HTTPS/SSL support
+     */
     private request;
-    getInfo(): Promise<any>;
+    /**
+     * Get service information
+     */
+    getInfo(): Promise<Record<string, any>>;
+    /**
+     * Create a new configuration entry
+     */
     create(key: string, value: Record<string, any>, category?: string): Promise<ConfigEntry>;
+    /**
+     * Read a configuration entry by key
+     */
     read(key: string): Promise<ConfigEntry>;
+    /**
+     * Update an existing configuration entry
+     */
     update(key: string, value: Record<string, any>, category?: string): Promise<ConfigEntry>;
+    /**
+     * Delete a configuration entry
+     */
     delete(key: string): Promise<{
         message: string;
     }>;
+    /**
+     * List all configurations with optional category filter
+     */
     list(category?: string): Promise<ConfigEntry[]>;
+    /**
+     * Get cluster status
+     */
     getClusterStatus(): Promise<ClusterStatus>;
+    /**
+     * Perform health check
+     */
     healthCheck(): Promise<{
         status: string;
-        nodeid: string;
+        node_id: string;
     }>;
+    /**
+     * Get Prometheus metrics
+     */
     getMetrics(): Promise<string>;
+    /**
+     * Check if configuration key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Count total configurations
+     */
+    count(category?: string): Promise<number>;
+    /**
+     * Bulk create configurations
+     */
+    bulkCreate(configs: Array<{
+        key: string;
+        value: Record<string, any>;
+        category?: string;
+    }>, ignoreErrors?: boolean): Promise<ConfigEntry[]>;
+    /**
+     * Bulk read configurations
+     */
+    bulkRead(keys: string[], ignoreErrors?: boolean): Promise<ConfigEntry[]>;
+    /**
+     * Bulk delete configurations
+     */
+    bulkDelete(keys: string[], ignoreErrors?: boolean): Promise<{
+        deleted: string[];
+        failed: Array<{
+            key: string;
+            error: any;
+        }>;
+    }>;
 }
 
 export { type ClusterStatus, type ConfigEntry, OpenSecureConfClient, OpenSecureConfError, type OpenSecureConfOptions, OpenSecureConfClient as default };

package/dist/index.d.ts

@@ -2,9 +2,9 @@
  * OpenSecureConf JavaScript/TypeScript Client
  *
  * A comprehensive REST API client for OpenSecureConf - Encrypted configuration
- * management system with cluster support.
+ * management system with cluster support and HTTPS/SSL.
  *
- * @version 1.0.0
+ * @version 2.2.0
  * @license MIT
  */
 /**
@@ -22,9 +22,9 @@ interface ConfigEntry {
 interface ClusterStatus {
     enabled: boolean;
     mode?: string;
-    nodeid?: string;
-    totalnodes?: number;
-    healthynodes?: number;
+    node_id?: string;
+    total_nodes?: number;
+    healthy_nodes?: number;
 }
 /**
  * Client configuration options
@@ -34,6 +34,7 @@ interface OpenSecureConfOptions {
     userKey: string;
     apiKey?: string;
     timeout?: number;
+    rejectUnauthorized?: boolean;
 }
 /**
  * Custom error class for OpenSecureConf API errors
@@ -45,28 +46,117 @@ declare class OpenSecureConfError extends Error {
 }
 /**
  * OpenSecureConf API Client
+ *
+ * @example
+ * // Basic HTTP usage
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'http://localhost:9000',
+ *   userKey: 'my-secret-key-12345'
+ * });
+ *
+ * @example
+ * // HTTPS with valid certificate
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'https://config.example.com',
+ *   userKey: 'my-secret-key-12345',
+ *   apiKey: 'optional-api-key'
+ * });
+ *
+ * @example
+ * // HTTPS with self-signed certificate (Node.js)
+ * const client = new OpenSecureConfClient({
+ *   baseUrl: 'https://localhost:9443',
+ *   userKey: 'my-secret-key-12345',
+ *   rejectUnauthorized: false // Accept self-signed certs
+ * });
  */
 declare class OpenSecureConfClient {
     private baseUrl;
     private userKey;
     private apiKey?;
     private timeout;
+    private rejectUnauthorized;
+    private httpsAgent?;
     constructor(options: OpenSecureConfOptions);
+    /**
+     * Setup HTTPS agent for Node.js environment to handle SSL certificates
+     */
+    private setupNodeHttpsAgent;
+    /**
+     * Make HTTP request with HTTPS/SSL support
+     */
     private request;
-    getInfo(): Promise<any>;
+    /**
+     * Get service information
+     */
+    getInfo(): Promise<Record<string, any>>;
+    /**
+     * Create a new configuration entry
+     */
     create(key: string, value: Record<string, any>, category?: string): Promise<ConfigEntry>;
+    /**
+     * Read a configuration entry by key
+     */
     read(key: string): Promise<ConfigEntry>;
+    /**
+     * Update an existing configuration entry
+     */
     update(key: string, value: Record<string, any>, category?: string): Promise<ConfigEntry>;
+    /**
+     * Delete a configuration entry
+     */
     delete(key: string): Promise<{
         message: string;
     }>;
+    /**
+     * List all configurations with optional category filter
+     */
     list(category?: string): Promise<ConfigEntry[]>;
+    /**
+     * Get cluster status
+     */
     getClusterStatus(): Promise<ClusterStatus>;
+    /**
+     * Perform health check
+     */
     healthCheck(): Promise<{
         status: string;
-        nodeid: string;
+        node_id: string;
     }>;
+    /**
+     * Get Prometheus metrics
+     */
     getMetrics(): Promise<string>;
+    /**
+     * Check if configuration key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Count total configurations
+     */
+    count(category?: string): Promise<number>;
+    /**
+     * Bulk create configurations
+     */
+    bulkCreate(configs: Array<{
+        key: string;
+        value: Record<string, any>;
+        category?: string;
+    }>, ignoreErrors?: boolean): Promise<ConfigEntry[]>;
+    /**
+     * Bulk read configurations
+     */
+    bulkRead(keys: string[], ignoreErrors?: boolean): Promise<ConfigEntry[]>;
+    /**
+     * Bulk delete configurations
+     */
+    bulkDelete(keys: string[], ignoreErrors?: boolean): Promise<{
+        deleted: string[];
+        failed: Array<{
+            key: string;
+            error: any;
+        }>;
+    }>;
 }
 
 export { type ClusterStatus, type ConfigEntry, OpenSecureConfClient, OpenSecureConfError, type OpenSecureConfOptions, OpenSecureConfClient as default };

package/dist/index.js

@@ -36,16 +36,38 @@ var OpenSecureConfError = class _OpenSecureConfError extends Error {
     }
   }
 };
+function isNodeEnvironment() {
+  return typeof process !== "undefined" && process.versions != null && process.versions.node != null;
+}
 var OpenSecureConfClient = class {
   constructor(options) {
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.userKey = options.userKey;
     this.apiKey = options.apiKey;
     this.timeout = options.timeout || 3e4;
+    this.rejectUnauthorized = options.rejectUnauthorized !== false;
     if (!this.userKey || this.userKey.length < 8) {
       throw new Error("userKey must be at least 8 characters long");
     }
+    if (isNodeEnvironment() && this.baseUrl.startsWith("https://")) {
+      this.setupNodeHttpsAgent();
+    }
+  }
+  /**
+   * Setup HTTPS agent for Node.js environment to handle SSL certificates
+   */
+  setupNodeHttpsAgent() {
+    try {
+      const https = require("https");
+      this.httpsAgent = new https.Agent({
+        rejectUnauthorized: this.rejectUnauthorized
+      });
+    } catch (error) {
+    }
   }
+  /**
+   * Make HTTP request with HTTPS/SSL support
+   */
   async request(method, endpoint, body) {
     const url = `${this.baseUrl}${endpoint}`;
     const headers = {
@@ -58,12 +80,16 @@ var OpenSecureConfClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
-      const response = await fetch(url, {
+      const fetchOptions = {
         method,
         headers,
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal
-      });
+      };
+      if (this.httpsAgent) {
+        fetchOptions.agent = this.httpsAgent;
+      }
+      const response = await fetch(url, fetchOptions);
       clearTimeout(timeoutId);
       if (!response.ok) {
         let errorDetail;
@@ -97,14 +123,27 @@ var OpenSecureConfClient = class {
             `Request exceeded ${this.timeout}ms`
           );
         }
+        if (error.message.includes("certificate") || error.message.includes("SSL")) {
+          throw new OpenSecureConfError(
+            0,
+            "SSL/TLS error",
+            `${error.message}. For self-signed certificates, set rejectUnauthorized: false`
+          );
+        }
         throw new OpenSecureConfError(0, "Network error", error.message);
       }
       throw error;
     }
   }
+  /**
+   * Get service information
+   */
   async getInfo() {
     return this.request("GET", "/");
   }
+  /**
+   * Create a new configuration entry
+   */
   async create(key, value, category) {
     return this.request("POST", "/configs", {
       key,
@@ -112,35 +151,60 @@ var OpenSecureConfClient = class {
       category
     });
   }
+  /**
+   * Read a configuration entry by key
+   */
   async read(key) {
     return this.request("GET", `/configs/${encodeURIComponent(key)}`);
   }
+  /**
+   * Update an existing configuration entry
+   */
   async update(key, value, category) {
     return this.request("PUT", `/configs/${encodeURIComponent(key)}`, {
       value,
       category
     });
   }
+  /**
+   * Delete a configuration entry
+   */
   async delete(key) {
     return this.request("DELETE", `/configs/${encodeURIComponent(key)}`);
   }
+  /**
+   * List all configurations with optional category filter
+   */
   async list(category) {
     const endpoint = category ? `/configs?category=${encodeURIComponent(category)}` : "/configs";
     return this.request("GET", endpoint);
   }
+  /**
+   * Get cluster status
+   */
   async getClusterStatus() {
     return this.request("GET", "/cluster/status");
   }
+  /**
+   * Perform health check
+   */
   async healthCheck() {
     return this.request("GET", "/cluster/health");
   }
+  /**
+   * Get Prometheus metrics
+   */
   async getMetrics() {
     const url = `${this.baseUrl}/metrics`;
     const headers = {};
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
     }
-    const response = await fetch(url, { headers });
+    const fetchOptions = { headers };
+    if (this.httpsAgent) {
+      fetchOptions.agent = this.httpsAgent;
+    }
+    const response = await fetch(url, fetchOptions);
     if (!response.ok) {
       throw new OpenSecureConfError(
         response.status,
@@ -149,6 +213,84 @@ var OpenSecureConfClient = class {
     }
     return await response.text();
   }
+  /**
+   * Check if configuration key exists
+   */
+  async exists(key) {
+    try {
+      await this.read(key);
+      return true;
+    } catch (error) {
+      if (error instanceof OpenSecureConfError && error.statusCode === 404) {
+        return false;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Count total configurations
+   */
+  async count(category) {
+    const configs = await this.list(category);
+    return configs.length;
+  }
+  /**
+   * Bulk create configurations
+   */
+  async bulkCreate(configs, ignoreErrors = false) {
+    const results = [];
+    const errors = [];
+    for (const config of configs) {
+      try {
+        const result = await this.create(config.key, config.value, config.category);
+        results.push(result);
+      } catch (error) {
+        errors.push({ key: config.key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return results;
+  }
+  /**
+   * Bulk read configurations
+   */
+  async bulkRead(keys, ignoreErrors = false) {
+    const results = [];
+    const errors = [];
+    for (const key of keys) {
+      try {
+        const result = await this.read(key);
+        results.push(result);
+      } catch (error) {
+        errors.push({ key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return results;
+  }
+  /**
+   * Bulk delete configurations
+   */
+  async bulkDelete(keys, ignoreErrors = false) {
+    const deleted = [];
+    const failed = [];
+    for (const key of keys) {
+      try {
+        await this.delete(key);
+        deleted.push(key);
+      } catch (error) {
+        failed.push({ key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return { deleted, failed };
+  }
 };
 var index_default = OpenSecureConfClient;
 // Annotate the CommonJS export names for ESM import in node:
@@ -158,10 +300,10 @@ var index_default = OpenSecureConfClient;
 });
 /**
  * OpenSecureConf JavaScript/TypeScript Client
- *
+ * 
  * A comprehensive REST API client for OpenSecureConf - Encrypted configuration
- * management system with cluster support.
- *
- * @version 1.0.0
+ * management system with cluster support and HTTPS/SSL.
+ * 
+ * @version 2.2.0
  * @license MIT
  */

package/dist/index.mjs

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/index.ts
 var OpenSecureConfError = class _OpenSecureConfError extends Error {
   constructor(statusCode, message, detail) {
@@ -10,16 +17,38 @@ var OpenSecureConfError = class _OpenSecureConfError extends Error {
     }
   }
 };
+function isNodeEnvironment() {
+  return typeof process !== "undefined" && process.versions != null && process.versions.node != null;
+}
 var OpenSecureConfClient = class {
   constructor(options) {
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.userKey = options.userKey;
     this.apiKey = options.apiKey;
     this.timeout = options.timeout || 3e4;
+    this.rejectUnauthorized = options.rejectUnauthorized !== false;
     if (!this.userKey || this.userKey.length < 8) {
       throw new Error("userKey must be at least 8 characters long");
     }
+    if (isNodeEnvironment() && this.baseUrl.startsWith("https://")) {
+      this.setupNodeHttpsAgent();
+    }
+  }
+  /**
+   * Setup HTTPS agent for Node.js environment to handle SSL certificates
+   */
+  setupNodeHttpsAgent() {
+    try {
+      const https = __require("https");
+      this.httpsAgent = new https.Agent({
+        rejectUnauthorized: this.rejectUnauthorized
+      });
+    } catch (error) {
+    }
   }
+  /**
+   * Make HTTP request with HTTPS/SSL support
+   */
   async request(method, endpoint, body) {
     const url = `${this.baseUrl}${endpoint}`;
     const headers = {
@@ -32,12 +61,16 @@ var OpenSecureConfClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
-      const response = await fetch(url, {
+      const fetchOptions = {
         method,
         headers,
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal
-      });
+      };
+      if (this.httpsAgent) {
+        fetchOptions.agent = this.httpsAgent;
+      }
+      const response = await fetch(url, fetchOptions);
       clearTimeout(timeoutId);
       if (!response.ok) {
         let errorDetail;
@@ -71,14 +104,27 @@ var OpenSecureConfClient = class {
             `Request exceeded ${this.timeout}ms`
           );
         }
+        if (error.message.includes("certificate") || error.message.includes("SSL")) {
+          throw new OpenSecureConfError(
+            0,
+            "SSL/TLS error",
+            `${error.message}. For self-signed certificates, set rejectUnauthorized: false`
+          );
+        }
         throw new OpenSecureConfError(0, "Network error", error.message);
       }
       throw error;
     }
   }
+  /**
+   * Get service information
+   */
   async getInfo() {
     return this.request("GET", "/");
   }
+  /**
+   * Create a new configuration entry
+   */
   async create(key, value, category) {
     return this.request("POST", "/configs", {
       key,
@@ -86,35 +132,60 @@ var OpenSecureConfClient = class {
       category
     });
   }
+  /**
+   * Read a configuration entry by key
+   */
   async read(key) {
     return this.request("GET", `/configs/${encodeURIComponent(key)}`);
   }
+  /**
+   * Update an existing configuration entry
+   */
   async update(key, value, category) {
     return this.request("PUT", `/configs/${encodeURIComponent(key)}`, {
       value,
       category
     });
   }
+  /**
+   * Delete a configuration entry
+   */
   async delete(key) {
     return this.request("DELETE", `/configs/${encodeURIComponent(key)}`);
   }
+  /**
+   * List all configurations with optional category filter
+   */
   async list(category) {
     const endpoint = category ? `/configs?category=${encodeURIComponent(category)}` : "/configs";
     return this.request("GET", endpoint);
   }
+  /**
+   * Get cluster status
+   */
   async getClusterStatus() {
     return this.request("GET", "/cluster/status");
   }
+  /**
+   * Perform health check
+   */
   async healthCheck() {
     return this.request("GET", "/cluster/health");
   }
+  /**
+   * Get Prometheus metrics
+   */
   async getMetrics() {
     const url = `${this.baseUrl}/metrics`;
     const headers = {};
     if (this.apiKey) {
       headers["X-API-Key"] = this.apiKey;
     }
-    const response = await fetch(url, { headers });
+    const fetchOptions = { headers };
+    if (this.httpsAgent) {
+      fetchOptions.agent = this.httpsAgent;
+    }
+    const response = await fetch(url, fetchOptions);
     if (!response.ok) {
       throw new OpenSecureConfError(
         response.status,
@@ -123,6 +194,84 @@ var OpenSecureConfClient = class {
     }
     return await response.text();
   }
+  /**
+   * Check if configuration key exists
+   */
+  async exists(key) {
+    try {
+      await this.read(key);
+      return true;
+    } catch (error) {
+      if (error instanceof OpenSecureConfError && error.statusCode === 404) {
+        return false;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Count total configurations
+   */
+  async count(category) {
+    const configs = await this.list(category);
+    return configs.length;
+  }
+  /**
+   * Bulk create configurations
+   */
+  async bulkCreate(configs, ignoreErrors = false) {
+    const results = [];
+    const errors = [];
+    for (const config of configs) {
+      try {
+        const result = await this.create(config.key, config.value, config.category);
+        results.push(result);
+      } catch (error) {
+        errors.push({ key: config.key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return results;
+  }
+  /**
+   * Bulk read configurations
+   */
+  async bulkRead(keys, ignoreErrors = false) {
+    const results = [];
+    const errors = [];
+    for (const key of keys) {
+      try {
+        const result = await this.read(key);
+        results.push(result);
+      } catch (error) {
+        errors.push({ key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return results;
+  }
+  /**
+   * Bulk delete configurations
+   */
+  async bulkDelete(keys, ignoreErrors = false) {
+    const deleted = [];
+    const failed = [];
+    for (const key of keys) {
+      try {
+        await this.delete(key);
+        deleted.push(key);
+      } catch (error) {
+        failed.push({ key, error });
+        if (!ignoreErrors) {
+          throw error;
+        }
+      }
+    }
+    return { deleted, failed };
+  }
 };
 var index_default = OpenSecureConfClient;
 export {
@@ -132,10 +281,10 @@ export {
 };
 /**
  * OpenSecureConf JavaScript/TypeScript Client
- *
+ * 
  * A comprehensive REST API client for OpenSecureConf - Encrypted configuration
- * management system with cluster support.
- *
- * @version 1.0.0
+ * management system with cluster support and HTTPS/SSL.
+ * 
+ * @version 2.2.0
  * @license MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensecureconf-client",
-  "version": "1.0.0",
+  "version": "2.2.0",
   "description": "JavaScript/TypeScript client for OpenSecureConf - Encrypted configuration management REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",