Freeland

Freeland — Universal System Decoder

Freeland is a lightweight universal decoder that normalizes environment values across platforms (Windows, Linux, macOS, Docker) and formats (json:, b64:, file:, nez:, id:, ...).

"Freeland est le territoire neutre où tous les systèmes se réunissent: Windows, Linux, secrets, fichiers, images, base64… Tout est normalisé ici."

Features

• Plug-and-play registry for system prefixes (json:, b64:, file:, nez:, id:, ...)
• Cross-platform path normalization and file reading
• Extensible: register custom decoders for any prefix
• Small, dependency-free core

Install

This repo is prepared for npm publishing. Example:

npm install freeland

Quick usage

import { registerSystem, decodeSystemValue } from 'freeland';

registerSystem('json:', (s) => JSON.parse(s));

const value = await decodeSystemValue('json:{"a":1}');

Integration with envapt

Freeland can be used as the neutral decoder for envapt plugins and resolvers — register a nez: decoder that forwards to your Nezlephant resolver or a custom id: decoder that resolves secrets from a vault.

Release notes

See the release draft RELEASE_DRAFT.md for v0.1.0 notes.

Contributing

PRs welcome. License: MIT.