@drawbridge/drawbridge-utils 0.0.51 → 0.0.52

package/dist/env.cjs

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// lib/env.js
+var env_exports = {};
+__export(env_exports, {
+  assertEnv: () => assertEnv
+});
+module.exports = __toCommonJS(env_exports);
+var assertEnv = (required = [], { env = process.env, exit = true } = {}) => {
+  const missing = (required || []).filter((key) => {
+    const value = env[key];
+    return value === void 0 || value === null || String(value).trim() === "";
+  });
+  if (missing.length === 0) return;
+  const message = "Missing required environment variable" + (missing.length > 1 ? "s" : "") + ": " + missing.join(", ");
+  console.error("[boot] " + message);
+  if (exit) {
+    process.exit(1);
+  }
+  throw new Error(message);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertEnv
+});

package/dist/env.d.cts

@@ -0,0 +1,41 @@
+// Boot-time required-environment-variable validation. A service calls
+// assertEnv(required) as the first thing in index.js so a missing must-have
+// config fails loudly at startup instead of silently degrading at first use
+// (e.g. a missing OAUTH_TOKEN_HMAC_KEY surfacing only as failed socket auth).
+//
+//   const { assertEnv } = require( '@drawbridge/drawbridge-utils/env' );
+//   assertEnv([ 'MONGODB_URI', 'REDIS_URL', 'OAUTH_TOKEN_HMAC_KEY' ]);
+//
+// Reports EVERY missing var in one message (not just the first) and exits the
+// process with code 1. A var counts as missing when unset, null, or an
+// empty/whitespace-only string. Pass { exit : false } to throw instead of
+// exiting (used in tests); pass { env } to validate against a supplied map.
+const assertEnv = ( required = [], { env = process.env, exit = true } = {} ) => {
+
+	const missing = ( required || [] ).filter( ( key ) => {
+
+		const value = env[ key ];
+
+		return value === undefined || value === null || String( value ).trim() === '';
+
+	});
+
+	if( missing.length === 0 ) return;
+
+	const message = 'Missing required environment variable'
+		+ ( missing.length > 1 ? 's' : '' )
+		+ ': ' + missing.join( ', ' );
+
+	console.error( '[boot] ' + message );
+
+	if( exit ){
+
+		process.exit( 1 );
+
+	}
+
+	throw new Error( message );
+
+};
+
+export { assertEnv };

package/dist/env.d.ts

@@ -0,0 +1,41 @@
+// Boot-time required-environment-variable validation. A service calls
+// assertEnv(required) as the first thing in index.js so a missing must-have
+// config fails loudly at startup instead of silently degrading at first use
+// (e.g. a missing OAUTH_TOKEN_HMAC_KEY surfacing only as failed socket auth).
+//
+//   const { assertEnv } = require( '@drawbridge/drawbridge-utils/env' );
+//   assertEnv([ 'MONGODB_URI', 'REDIS_URL', 'OAUTH_TOKEN_HMAC_KEY' ]);
+//
+// Reports EVERY missing var in one message (not just the first) and exits the
+// process with code 1. A var counts as missing when unset, null, or an
+// empty/whitespace-only string. Pass { exit : false } to throw instead of
+// exiting (used in tests); pass { env } to validate against a supplied map.
+const assertEnv = ( required = [], { env = process.env, exit = true } = {} ) => {
+
+	const missing = ( required || [] ).filter( ( key ) => {
+
+		const value = env[ key ];
+
+		return value === undefined || value === null || String( value ).trim() === '';
+
+	});
+
+	if( missing.length === 0 ) return;
+
+	const message = 'Missing required environment variable'
+		+ ( missing.length > 1 ? 's' : '' )
+		+ ': ' + missing.join( ', ' );
+
+	console.error( '[boot] ' + message );
+
+	if( exit ){
+
+		process.exit( 1 );
+
+	}
+
+	throw new Error( message );
+
+};
+
+export { assertEnv };

package/dist/env.js

@@ -0,0 +1,17 @@
+// lib/env.js
+var assertEnv = (required = [], { env = process.env, exit = true } = {}) => {
+  const missing = (required || []).filter((key) => {
+    const value = env[key];
+    return value === void 0 || value === null || String(value).trim() === "";
+  });
+  if (missing.length === 0) return;
+  const message = "Missing required environment variable" + (missing.length > 1 ? "s" : "") + ": " + missing.join(", ");
+  console.error("[boot] " + message);
+  if (exit) {
+    process.exit(1);
+  }
+  throw new Error(message);
+};
+export {
+  assertEnv
+};

package/package.json

@@ -39,6 +39,11 @@
       "import": "./dist/encrypt.js",
       "require": "./dist/encrypt.cjs"
     },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": "./dist/env.js",
+      "require": "./dist/env.cjs"
+    },
     "./axios": {
       "types": "./dist/axios.d.ts",
       "import": "./dist/axios.js",
@@ -130,5 +135,5 @@
     "build": "tsup && npm publish"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.51"
+  "version": "0.0.52"
 }