@robinpath/env

Secure environment variable management with sensitive value redaction and protected system vars

Why use this module?

The env module lets you:

• Get the value of an environment variable
• Check if an environment variable exists
• Get all environment variables (sensitive values are redacted by default)
• Delete an environment variable (protected system vars cannot be deleted)
• Mark an environment variable as sensitive (will be redacted in env.all output)

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/env

Quick Start

No credentials needed — start using it right away:

env.set "API_URL" "https://api.example.com"

Available Functions

| Function | Description | |----------|-------------| | env.get | Get the value of an environment variable | | env.set | Set an environment variable (protected system vars cannot be overwritten) | | env.has | Check if an environment variable exists | | env.all | Get all environment variables (sensitive values are redacted by default) | | env.delete | Delete an environment variable (protected system vars cannot be deleted) | | env.secret | Mark an environment variable as sensitive (will be redacted in env.all output) | | env.load | Load environment variables from a .env file (won't override existing or protected vars) |

Examples

Set an environment variable (protected system vars cannot be overwritten)

env.set "API_URL" "https://api.example.com"

Check if an environment variable exists

env.has "NODE_ENV"

Get all environment variables (sensitive values are redacted by default)

env.all

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/env";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  env.set "API_URL" "https://api.example.com"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT