Molecule.dev

@molecule/api-config-env

Provider bond · config · API (Node) · v1.0.2 · Apache-2.0

Environment variables configuration provider

npm install @molecule/api-config-env

npm · Source on GitHub · Implements @molecule/api-config

How it works

@molecule/api-config-env is a provider bond on the API (Node) side: it implements the config core interface (@molecule/api-config) with a concrete vendor or library behind it.

Your code calls the core; you wire this provider once at startup. Swapping vendors later is one line in that wiring, not a rewrite.

import { setProvider } from '@molecule/api-config'
import { provider } from '@molecule/api-config-env'

setProvider(provider)

Works with: @molecule/api-config, @molecule/api-i18n

Reference

Environment configuration provider for molecule.dev.

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

Quick Start

import { setProvider } from '@molecule/api-config'
import { provider } from '@molecule/api-config-env'

setProvider(provider)

Type

provider

Installation

npm install @molecule/api-config-env @molecule/api-config @molecule/api-i18n

API

Constants

envProvider

Environment-based configuration provider.

const envProvider: ConfigProvider

provider

Default environment configuration provider.

const provider: ConfigProvider

Core Interface

Implements @molecule/api-config interface.

Bond Wiring

Setup function to register this provider with the core interface:

import { setProvider } from '@molecule/api-config'
import { provider } from '@molecule/api-config-env'

export function setupConfigEnv(): void {
  setProvider(provider)
}

Injection Notes

Requirements

Peer dependencies:

  • @molecule/api-config ^1.0.1
  • @molecule/api-i18n ^1.0.1

Runtime Dependencies

  • @molecule/api-config

  • @molecule/api-i18n

  • Values are always strings at runtime. get<T>() casts, it does not coerce: get<number>('PORT') returns the string '3000'. Use the core's getNumber() / getBoolean() / getString() helpers from @molecule/api-config for typed reads, or convert explicitly.

  • set() writes back to process.env (stringified) — visible to the whole process, not persisted anywhere.