envis-node 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,56 @@
+# envis-node
+
+-----
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Usage](#usage)
+- [License](#license)
+- [Contact](#contact)
+
+## Overview
+Envisible is a simple, secure secret management platform. The SDK allows users to integrate their secrets (configured [on our web dashboard](https://envisible.netlify.app)) directly into their Node.js code.
+
+## Installation
+
+```console
+cd node-sdk
+npm install
+```
+
+## Usage
+
+1. Sign up for an Envisible account on the dashboard.
+2. Install the SDK and authenticate when prompted (the SDK will open a secure browser window).
+3. Read and manage secrets from any Node.js runtime:
+
+### Fetching a secret
+
+```javascript
+const envis = require("envis-node");
+
+async function main() {
+  const secret = await envis.get("project_id", "secret_name");
+  console.log(secret);
+}
+
+main();
+```
+
+### Logging out
+
+```javascript
+const envis = require("envis-node");
+
+envis.logout();
+```
+
+## License
+
+`envis-node` is released under a private source-available license: you can use the SDK to integrate with [our web dashboard](https://envisible.netlify.app), but the backend platform remains proprietary.
+
+## Contact
+- [Website](https://envisible.netlify.app)
+- [Email](mailto:contact@uarham.me)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "envis-node",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Secure, simple secret management",
   "keywords": [
     "secret",
@@ -10,6 +10,10 @@
   ],
   "license": "ISC",
   "author": "Umair Arham",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/umairx25/Envisible-Clients"
+  },
   "type": "commonjs",
   "main": "src/index.js",
   "scripts": {

package/src/index.js

@@ -1,4 +1,4 @@
-const { get, logout } = require("./main");
+const { get, getMany, getAll, logout } = require("./main");
 const {
   ensureSession,
   loadSession,
@@ -10,6 +10,8 @@ const {
 
 const envis = {
   get,
+  getMany,
+  getAll,
   logout,
   ensureSession,
   loadSession,

package/src/main.js

@@ -28,34 +28,19 @@ async function logout() {
   }
 }
 
-async function get(projectId, secretName) {
-  if (!projectId || !secretName) {
-    throw new Error("Both project id and secret name are required.");
-  }
-
-  const ciToken = process.env.ENVIS_CI_TOKEN;
-  let session = null;
-  if (!ciToken) {
-    await ensureSession();
-    session = await loadSession();
-  }
-
-  const headers = {
+async function buildAuthHeaders() {
+  await ensureSession();
+  const session = await loadSession();
+  return {
+    Authorization: `Bearer ${session.access_token}`,
     "Content-Type": "application/json",
   };
-  if (ciToken) {
-    headers["X-CI-Token"] = ciToken;
-  } else {
-    headers.Authorization = `Bearer ${session.access_token}`;
-  }
-
-  const url = `${BASE_URL}/v1/projects/${encodeURIComponent(
-    projectId
-  )}/secrets/${encodeURIComponent(secretName)}`;
+}
 
+async function fetchJSON(url, options, errorAction, errorContext) {
   let response;
   try {
-    response = await fetch(url, { headers, timeout: 10000 });
+    response = await fetch(url, { timeout: 10000, ...options });
   } catch (error) {
     throw new Error(`Failed to reach Envault API: ${error.message}`);
   }
@@ -68,7 +53,7 @@ async function get(projectId, secretName) {
       detail = error.message;
     }
     throw new Error(
-      `Failed to fetch secret (${response.status || "HTTP error"}): ${
+      `Failed to ${errorAction} (${response.status || "HTTP error"}): ${
         detail || "No response body provided."
       }`
     );
@@ -83,32 +68,118 @@ async function get(projectId, secretName) {
 
   if (!bodyText) {
     throw new Error(
-      "API returned an empty, non-JSON response when fetching secret."
+      `API returned an empty, non-JSON response when ${errorContext || errorAction}.`
     );
   }
 
   try {
-    const payload = JSON.parse(bodyText);
-    if (
-      payload &&
-      typeof payload === "object" &&
-      Object.prototype.hasOwnProperty.call(payload, "value")
-    ) {
-      return payload.value;
-    }
-    return payload;
+    return JSON.parse(bodyText);
   } catch {
     const raw = bodyText.trim();
     if (raw) {
       return { raw };
     }
     throw new Error(
-      "API returned an empty, non-JSON response when fetching secret."
+      `API returned an empty, non-JSON response when ${errorContext || errorAction}.`
     );
   }
 }
 
+async function get(projectId, secretName) {
+  if (!projectId || !secretName) {
+    throw new Error("Both project id and secret name are required.");
+  }
+
+  const headers = await buildAuthHeaders();
+
+  const url = `${BASE_URL}/v1/projects/${encodeURIComponent(
+    projectId
+  )}/secrets/${encodeURIComponent(secretName)}`;
+
+  const payload = await fetchJSON(
+    url,
+    { headers },
+    "fetch secret",
+    "fetching secret"
+  );
+  if (
+    payload &&
+    typeof payload === "object" &&
+    Object.prototype.hasOwnProperty.call(payload, "value")
+  ) {
+    return payload.value;
+  }
+  return payload;
+}
+
+async function getMany(projectId, secretNames) {
+  if (!projectId || !Array.isArray(secretNames)) {
+    throw new Error(
+      "Project id and an array of secret names are required."
+    );
+  }
+  const names = secretNames
+    .map((name) => (typeof name === "string" ? name.trim() : ""))
+    .filter(Boolean);
+  if (names.length === 0) {
+    throw new Error("At least one secret name is required.");
+  }
+
+  const headers = await buildAuthHeaders();
+  const url = `${BASE_URL}/v1/projects/${encodeURIComponent(
+    projectId
+  )}/secrets/batch`;
+
+  const payload = await fetchJSON(
+    url,
+    {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ names }),
+    },
+    "fetch secrets",
+    "fetching secrets"
+  );
+
+  if (
+    payload &&
+    typeof payload === "object" &&
+    Object.prototype.hasOwnProperty.call(payload, "secrets")
+  ) {
+    return payload.secrets;
+  }
+  return payload;
+}
+
+async function getAll(projectId) {
+  if (!projectId) {
+    throw new Error("Project id is required.");
+  }
+
+  const headers = await buildAuthHeaders();
+  const url = `${BASE_URL}/v1/projects/${encodeURIComponent(
+    projectId
+  )}/secrets/all`;
+
+  const payload = await fetchJSON(
+    url,
+    { headers },
+    "fetch secrets",
+    "fetching secrets"
+  );
+  if (
+    payload &&
+    typeof payload === "object" &&
+    Object.prototype.hasOwnProperty.call(payload, "secrets")
+  ) {
+    return payload.secrets;
+  }
+  return payload;
+}
+
 module.exports = {
   get,
+  getMany,
+  getAll,
   logout,
 };

package/src/session.js

@@ -11,76 +11,6 @@ const REQUIRED_SESSION_KEYS = ["access_token", "refresh_token"];
 const WAIT_TIME = 120; // seconds
 const POLL_DELAY_SECONDS = 5;
 
-function findDotEnv(startDir) {
-  let current = startDir;
-  while (current && current !== path.dirname(current)) {
-    const candidate = path.join(current, ".env");
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-    current = path.dirname(current);
-  }
-  const fallback = path.join(startDir, ".env");
-  return fs.existsSync(fallback) ? fallback : null;
-}
-
-function parseDotEnvLine(line) {
-  const trimmed = line.trim();
-  if (!trimmed || trimmed.startsWith("#")) {
-    return null;
-  }
-  const normalized = trimmed.startsWith("export ")
-    ? trimmed.slice(7).trim()
-    : trimmed;
-  const splitIndex = normalized.indexOf("=");
-  if (splitIndex <= 0) {
-    return null;
-  }
-  const key = normalized.slice(0, splitIndex).trim();
-  let value = normalized.slice(splitIndex + 1).trim();
-  if (
-    (value.startsWith('"') && value.endsWith('"')) ||
-    (value.startsWith("'") && value.endsWith("'"))
-  ) {
-    value = value.slice(1, -1);
-  }
-  value = value.replace(/\\n/g, "\n");
-  return { key, value };
-}
-
-function loadDotEnv() {
-  const envPath = findDotEnv(process.cwd());
-  if (!envPath) {
-    return;
-  }
-  let raw;
-  try {
-    raw = fs.readFileSync(envPath, "utf-8");
-  } catch {
-    return;
-  }
-  raw.split(/\r?\n/).forEach((line) => {
-    const parsed = parseDotEnvLine(line);
-    if (!parsed || process.env[parsed.key] !== undefined) {
-      return;
-    }
-    process.env[parsed.key] = parsed.value;
-  });
-}
-
-function isHeadless() {
-  if (process.env.ENVIS_CI_TOKEN) {
-    return true;
-  }
-  try {
-    return !(process.stdin.isTTY && process.stdout.isTTY);
-  } catch {
-    return true;
-  }
-}
-
-loadDotEnv();
-
 function printc(text, color = "white") {
   const colorFn = chalk[color];
   if (typeof colorFn === "function") {
@@ -100,12 +30,12 @@ function getEnvUrl(varName, fallback) {
 
 const BASE_URL = getEnvUrl(
   "ENVIS_API_URL",
-  "https://envis.onrender.com"
+  "https://api.envisible.dev"
 );
 
 const FRONTEND_URL = getEnvUrl(
   "ENVIS_DASH_URL",
-  "https://envisible.netlify.app"
+  "https://envisible.dev"
 );
 
 async function pathExists(targetPath) {
@@ -276,12 +206,6 @@ async function ensureSession() {
     return;
   }
 
-  if (isHeadless()) {
-    throw new Error(
-      "No cached session and headless environment detected. Set ENVIS_CI_TOKEN or run `envis login` on a machine with a browser."
-    );
-  }
-
   const { waitForAuth } = require("./auth");
   let openBrowser;
   try {