ultraenv 1.0.0

package/dist/chunk-IGFVP24Q.js

@@ -0,0 +1,91 @@
+import {
+  writeFile
+} from "./chunk-3VYXPTYV.js";
+
+// src/typegen/declaration.ts
+var DEFAULT_HEADER = "// Auto-generated by ultraenv \u2014 DO NOT EDIT";
+function schemaTypeToTsType(schema) {
+  const r = schema;
+  const schemaType = r.type;
+  if (schemaType === "string" && Array.isArray(r.enum) && r.enum.length > 0) {
+    return r.enum.map((v) => `'${v}'`).join(" | ");
+  }
+  if (schemaType === "enum" && Array.isArray(r.values) && r.values.length > 0) {
+    return r.values.map((v) => `'${v}'`).join(" | ");
+  }
+  return "string";
+}
+function generateJSDoc(key, schema) {
+  const r = schema;
+  const lines = ["/**"];
+  if (schema.description !== void 0) {
+    lines.push(` * ${schema.description}`);
+  } else {
+    lines.push(` * ${key}`);
+  }
+  if (r.isSecret === true) {
+    lines.push(" * @secret");
+  }
+  const hasDefault = schema.default !== void 0 || r.hasDefault === true;
+  if (hasDefault) {
+    const rawDefault = r.rawDefaultValue;
+    const defaultVal = r.isSecret === true ? "[REDACTED]" : rawDefault ?? String(schema.default ?? "");
+    lines.push(` * @default ${defaultVal}`);
+  }
+  if (r.isDeprecated === true) {
+    const msg = r.deprecationMessage;
+    lines.push(` * @deprecated ${msg ?? "This variable is deprecated"}`);
+  }
+  lines.push(" */");
+  return lines.join("\n");
+}
+async function generateDeclaration(vars, schema, outputPath, options) {
+  const content = generateDeclarationContent(vars, schema, options);
+  if (outputPath !== void 0) {
+    await writeFile(outputPath, content);
+  }
+  return content;
+}
+function generateDeclarationContent(vars, schema, options) {
+  const includeJSDoc = options?.jsdoc ?? true;
+  const indent = options?.indent ?? 4;
+  const indentStr = " ".repeat(indent);
+  const header = options?.header ?? DEFAULT_HEADER;
+  const lines = [];
+  lines.push(header);
+  lines.push("");
+  const allKeys = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(vars)) {
+    allKeys.add(key);
+  }
+  if (schema !== void 0) {
+    for (const key of Object.keys(schema)) {
+      allKeys.add(key);
+    }
+  }
+  const sortedKeys = Array.from(allKeys).sort();
+  lines.push("declare namespace NodeJS {");
+  lines.push(`${indentStr}interface ProcessEnv {`);
+  for (const key of sortedKeys) {
+    const schemaEntry = schema !== void 0 ? schema[key] : void 0;
+    if (includeJSDoc && schemaEntry !== void 0) {
+      lines.push("");
+      lines.push(`${indentStr}${indentStr}${generateJSDoc(key, schemaEntry)}`);
+    }
+    const tsType = schemaEntry !== void 0 ? schemaTypeToTsType(schemaEntry) : "string";
+    const r = schemaEntry;
+    const isOptional = schemaEntry === void 0 || schemaEntry.optional === true || schemaEntry.default !== void 0 || r?.hasDefault === true;
+    const optionalMarker = isOptional ? "?" : "";
+    lines.push(`${indentStr}${indentStr}${key}${optionalMarker}: ${tsType};`);
+  }
+  lines.push(`${indentStr}}`);
+  lines.push("}");
+  lines.push("");
+  lines.push("export {};");
+  return lines.join("\n");
+}
+
+export {
+  generateDeclaration,
+  generateDeclarationContent
+};

package/dist/chunk-IKPTKALB.js

@@ -0,0 +1,78 @@
+// src/middleware/express.ts
+function ultraenvMiddleware(options = {}) {
+  const {
+    exposePublic = true,
+    prefix = "PUBLIC_",
+    additionalPrefixes = [],
+    allowList = [],
+    denyList = [],
+    exposeNodeEnv = true,
+    source = process.env
+  } = options;
+  const allPrefixes = [prefix];
+  for (const p of additionalPrefixes) {
+    allPrefixes.push(p);
+  }
+  const allowSet = new Set(allowList.map((k) => k.toUpperCase()));
+  const denySet = new Set(denyList.map((k) => k.toUpperCase()));
+  const filteredEnv = buildFilteredEnv(
+    source,
+    allPrefixes,
+    allowSet,
+    denySet,
+    exposePublic,
+    exposeNodeEnv
+  );
+  return (_req, _res, next) => {
+    _req.env = filteredEnv;
+    next();
+  };
+}
+function buildFilteredEnv(source, prefixes, allowSet, denySet, exposePublic, exposeNodeEnv) {
+  if (!exposePublic) {
+    return {};
+  }
+  const env = {};
+  for (const [key, value] of Object.entries(source)) {
+    if (value === void 0 || value === "") continue;
+    const upperKey = key.toUpperCase();
+    if (denySet.has(upperKey)) continue;
+    if (allowSet.has(upperKey)) {
+      env[key] = value;
+      continue;
+    }
+    if (exposeNodeEnv && upperKey === "NODE_ENV") {
+      env[key] = value;
+      continue;
+    }
+    for (const p of prefixes) {
+      if (upperKey.startsWith(p.toUpperCase())) {
+        env[key] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
+function healthCheckRoute(options = {}) {
+  const { source = process.env, metadata = {} } = options;
+  return (_req, res) => {
+    const envKeys = Object.keys(source).filter(
+      (k) => source[k] !== void 0 && source[k] !== ""
+    );
+    const nodeEnv = source["NODE_ENV"] ?? "unknown";
+    const response = {
+      status: "ok",
+      loaded: envKeys.length,
+      environment: nodeEnv,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...metadata
+    };
+    res.status(200).json(response);
+  };
+}
+
+export {
+  ultraenvMiddleware,
+  healthCheckRoute
+};

package/dist/chunk-JB7RKV3C.js

@@ -0,0 +1,66 @@
+// src/middleware/fastify.ts
+function ultraenvPlugin(fastify, options = {}, done) {
+  const {
+    expose = true,
+    prefix = "PUBLIC_",
+    additionalPrefixes = [],
+    allowList = [],
+    denyList = [],
+    exposeNodeEnv = true,
+    source = process.env,
+    schema: _schema
+  } = options;
+  if (!expose) {
+    done();
+    return;
+  }
+  const allPrefixes = [prefix];
+  for (const p of additionalPrefixes) {
+    allPrefixes.push(p);
+  }
+  const allowSet = new Set(allowList.map((k) => k.toUpperCase()));
+  const denySet = new Set(denyList.map((k) => k.toUpperCase()));
+  const filteredEnv = buildFastifyEnv(
+    source,
+    allPrefixes,
+    allowSet,
+    denySet,
+    exposeNodeEnv
+  );
+  fastify.decorate("env", filteredEnv);
+  done();
+}
+function buildFastifyEnv(source, prefixes, allowSet, denySet, exposeNodeEnv) {
+  const env = {};
+  for (const [key, value] of Object.entries(source)) {
+    if (value === void 0 || value === "") continue;
+    const upperKey = key.toUpperCase();
+    if (denySet.has(upperKey)) continue;
+    if (allowSet.has(upperKey)) {
+      env[key] = value;
+      continue;
+    }
+    if (exposeNodeEnv && upperKey === "NODE_ENV") {
+      env[key] = value;
+      continue;
+    }
+    for (const p of prefixes) {
+      if (upperKey.startsWith(p.toUpperCase())) {
+        env[key] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
+function createUltraenvPlugin(_opts = {}) {
+  return {
+    name: "ultraenv",
+    handler: ultraenvPlugin
+  };
+}
+
+export {
+  ultraenvPlugin,
+  createUltraenvPlugin
+};