@vlandoss/env@0.4.0

Minor Changes

• #24 e814bfa Thanks @rqbazan! - Add json primitive to @vlandoss/env/zod: e.json(schema) decodes a
  JSON-string env var into a validated object and also accepts the decoded
  object from config files / defaults (codec .or(schema), same dual-source
  pattern as e.bool).

@vlandoss/env@0.3.0

Minor Changes

• #22 fd1f5f8 Thanks @rqbazan! - loadConfig (@vlandoss/env/fs) is now synchronous. It loads the config with require() and returns Config<S> directly instead of a Promise, so it works in app code and in config files that tooling loads via require() or bundles to CJS (where a top-level await is rejected).

  Migration — drop the await:

  - const config = await loadConfig(Env);
  + const config = loadConfig(Env);

  await loadConfig(...) still returns the right value at runtime (awaiting a non-promise yields the value), but the await keeps the module asynchronous — so a config file that keeps it still can't be require()d. Remove it.

  Auto-discovery now also covers .cjs / .cts (was: .ts .mts .js .mjs .json). The options form gains an optional cwd so callers can override process.cwd() when the working directory isn't the project root.

  Files are loaded with require(). Runtime requirements by extension:

  • .ts / .mts / .cts — needs native TS stripping (native in Bun/Deno, Node ≥22.18).
  • .mjs / .js / .cjs — needs require(esm) (native in Bun/Deno, Node ≥22.12).
  • .json — works on any supported Node.

  The package's engines is Node ≥22.12 (the require(esm) baseline). The .ts strip requirement is documented per-extension; consumers using only .json/.mjs/.cjs configs aren't blocked by an over-broad floor.

  CJS configs (module.exports = {...}): a CJS exports object that owns a default property name is no longer silently stripped — loadConfig discriminates ESM namespaces by Symbol.toStringTag === "Module" and returns CJS exports as-is, so sibling keys survive.

@vlandoss/env@0.2.1

Patch Changes

• #11 91534e9 Thanks @rqbazan! - Drop the type-fest dependency. PartialDeep is now defined locally in src/lib/types.ts with an equivalent shape, so the public surface of Config<S> and Defaults<S> is unchanged. One fewer transitive dep for consumers.

@vlandoss/env@0.2.0

Minor Changes

• #6 d150a70 Thanks @rqbazan! - BREAKING Rename <ClientEnv /> (in @vlandoss/env/react) to <EnvScript />. The new name stops suggesting client-side use and reflects what the component actually does: emit a <script> tag with the server-resolved env so the browser can read it during SSR or SSG hydration. The entrypoint path (@vlandoss/env/react) is unchanged. The wire format is also unchanged: the DOM id="env" and window.__env global stay identical, so HTML served by an older build continues to hydrate correctly.

  Renames included:

  • Component: ClientEnv → EnvScript
  • Props: ClientEnvProps → EnvScriptProps
  • Constants: CLIENT_ENV_SCRIPT_ID → ENV_SCRIPT_ID, CLIENT_ENV_GLOBAL_ID → ENV_GLOBAL_ID

  Migration: replace <ClientEnv …> with <EnvScript …>. If you imported the constants from the core entrypoint, update those imports too.

• #6 d150a70 Thanks @rqbazan! - BREAKING Rename @vlandoss/env/node to @vlandoss/env/fs. The entrypoint has always been about file-system access on a Node-compatible runtime — the new name reflects that it works on Node, Bun, and Deno (not just Node), and that it does not work on Workers/Edge. The dynamic-import path resolution now uses pathToFileURL so Deno can load absolute paths correctly.

  Migration: replace from "@vlandoss/env/node" with from "@vlandoss/env/fs".

Patch Changes

• #6 d150a70 Thanks @rqbazan! - Replace lodash.merge with defu for the internal merge that combines defaults + config + envOverride. The precedence (env > config > defaults) is unchanged.

  This fixes a silent shallow-merge regression on V8 isolate runtimes (Cloudflare Workers, Vercel Edge, Next.js Edge): lodash.merge relies on isPlainObject, which returns false when the object originates from a different realm than the merger. The fallback path then assigns by reference instead of deep-merging, which caused leaf values present in config (e.g. db.LOGGING: true) to be dropped whenever envOverride touched the same parent branch.

  defu is realm-agnostic and reliably deep-merges in all the runtimes supported by the core.

• #6 d150a70 Thanks @rqbazan! - Polish the package README to match the new docs site language — soften technical references to process.env, separate the optional zod install, and align the tagline with the rest of the documentation.

• #6 d150a70 Thanks @rqbazan! - readEnv() no longer throws ReferenceError on runtimes where process is not defined (e.g. Cloudflare Workers without nodejs_compat). It now returns {} so callers can supply the environment explicitly via defineEnv({ runtimeEnv }) — the idiomatic pattern in Worker fetch(req, env, ctx) handlers. Behavior on Node, Bun, Deno, browsers, and Edge runtimes that polyfill process.env is unchanged.

@vlandoss/env@0.1.2

Patch Changes

• #4 4e05752 Thanks @rqbazan! - Slim down package README and move full documentation to the new Fumadocs site

@vlandoss/env@0.1.1

Patch Changes

• #2 f2d9b91 Thanks @rqbazan! - - Fix homepage URL in package.json after flattening the monorepo (packages/env → package).
  • Add keywords to package.json for npm discoverability.

@vlandoss/env@0.1.0

Minor Changes

• 42c6eb7 Thanks @rqbazan! - Initial public release of @vlandoss/env under the @vlandoss scope.

  Contract-first environment configuration with typed schemas and per-runtime entrypoints:

  • @vlandoss/env — runtime-agnostic core (schema, defineEnv, envName, readEnv).
  • @vlandoss/env/node — loadConfig with auto-discovery or {env} template.
  • @vlandoss/env/vite — envConfig Vite plugin (#config alias + __ENV_NAME__ build-time inject).
  • @vlandoss/env/react — <ClientEnv /> for SSR/SSG.
  • @vlandoss/env/zod — opt-in opinionated Zod primitives (port, host, bool, logLevel, secret).