@kindgi/dotenv-file 0.0.0-stage → 0.1.0

package/dist/layers.js

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Layered env files — several dotenv files read as one view, the way
+ * an application reads `.env` + `.env.local`.
+ *
+ * Layers are ordered LOWEST precedence first: a key in a later layer
+ * overrides the same key in an earlier one. Raw values are merged
+ * first, then expanded once over the merged view, so a reference in
+ * `.env` to a name defined in `.env.local` sees the `.env.local` value
+ * (matching how Next.js loads its files). Pure — the caller reads the
+ * files and passes their contents (`null` for a file that doesn't
+ * exist), so this module never touches the filesystem.
+ */
+import { expandEnv } from './expand.js';
+import { parseEnvFile } from './parse.js';
+export function readEnvLayers(layers, options = {}) {
+    const raw = {};
+    const origin = {};
+    const present = [];
+    const diagnostics = [];
+    for (const layer of layers) {
+        if (layer.contents === null)
+            continue;
+        present.push(layer.source);
+        let lineNo = 1;
+        for (const line of parseEnvFile(layer.contents)) {
+            if (line.kind === 'entry' && line.key !== undefined && line.value !== undefined) {
+                raw[line.key] = line.value;
+                origin[line.key] = layer.source;
+            }
+            else if (line.kind === 'malformed') {
+                diagnostics.push({
+                    kind: 'malformed',
+                    source: layer.source,
+                    line: lineNo,
+                    raw: line.raw,
+                    reason: line.reason ?? 'not a `KEY=value` line',
+                });
+            }
+            lineNo += line.raw.split('\n').length;
+        }
+    }
+    const expanded = expandEnv(raw, options);
+    for (const d of expanded.diagnostics) {
+        diagnostics.push({ ...d, source: origin[d.key] ?? '' });
+    }
+    return { values: expanded.values, raw, origin, present, diagnostics };
+}
+/** One file's values, parsed and expanded. */
+export function readEnv(contents, options = {}) {
+    return { ...readEnvLayers([{ source: '', contents }], options).values };
+}
+//# sourceMappingURL=layers.js.map

package/dist/layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;;;;;;GAWG;AAEH,OAAO,EAA6C,SAAS,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkC1C,MAAM,UAAU,aAAa,CAC3B,MAA2B,EAC3B,UAAyB,EAAE;IAE3B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAoB,EAAE,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAS;QACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChF,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YAClC,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACrC,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,IAAI,EAAE,MAAM;oBACZ,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,wBAAwB;iBAChD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrC,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACxE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,UAAyB,EAAE;IACnE,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1E,CAAC"}

package/dist/parse.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Structured, lossless dotenv parser.
+ *
+ * **Grammar = `dotenv`'s `parse()`** (verified against `dotenv@16.3.1`,
+ * the version Next.js 16 bundles, by `tests/conformance.test.ts`). An
+ * application Kindgi is embedded in reads its `.env` files with that
+ * parser; Kindgi reading the same file must see the same values.
+ *
+ *   - `KEY=value` or `KEY: value` (colon + at least one space).
+ *     Optional leading whitespace and an optional `export ` prefix.
+ *   - Keys: `[A-Za-z0-9_.-]+` (dotenv accepts lowercase, dots, dashes).
+ *   - Unquoted values end at the first `#` (inline comment) and are
+ *     trimmed.
+ *   - `'…'`, `"…"` and `` `…` `` values may span lines. The closing
+ *     quote must be followed only by whitespace or a `# comment` on its
+ *     line; otherwise the value is read unquoted. Inside double quotes
+ *     `\n` / `\r` become newline / carriage return; nothing else is
+ *     unescaped (`\"` stays `\"`, exactly as dotenv does).
+ *   - Duplicate keys: the last one wins.
+ *   - Anything else is ignored by dotenv; here it surfaces as a
+ *     `malformed` line so hand-edited files round-trip untouched.
+ *
+ * Deliberate divergence (pathological inputs only): dotenv's regex lets
+ * a key's separator or an empty value's leading whitespace run across
+ * a newline (`KEY=` followed by a line that starts with a quote joins
+ * the two). Here a key, its separator, and the start of its value are
+ * always on one line.
+ *
+ * Variable expansion (`${VAR}`) is a separate step — see `expand.ts`.
+ * `parseEnvFile` returns values exactly as written.
+ */
+export interface EnvLine {
+    readonly kind: 'blank' | 'comment' | 'entry' | 'malformed';
+    /**
+     * The line's source text. For an `entry` whose quoted value spans
+     * several lines, `raw` holds all of them joined with `\n`.
+     */
+    readonly raw: string;
+    readonly key?: string;
+    /** Parsed (unexpanded) value. */
+    readonly value?: string;
+    /** `true` when the entry was written with an `export ` prefix. */
+    readonly exported?: boolean;
+    readonly reason?: string;
+}
+/** Keys dotenv accepts when READING a file. */
+export declare const DOTENV_KEY_REGEX: RegExp;
+/**
+ * Keys Kindgi WRITES: POSIX-shell env-var shape. Stricter than
+ * `DOTENV_KEY_REGEX` so every name Kindgi writes is also exportable
+ * from a shell.
+ */
+export declare const ENV_KEY_REGEX: RegExp;
+/**
+ * Split dotenv text into structured lines. `serializeEnvFile` of the
+ * result reproduces the input (line endings normalised to `\n`, which
+ * is also what dotenv does before parsing).
+ */
+export declare function parseEnvFile(raw: string): readonly EnvLine[];
+/**
+ * Parse a single entry's source text (possibly multi-line). Returns
+ * `undefined` unless the whole text is exactly one entry. Used by the
+ * serializer to decide whether an entry's `raw` is still faithful to
+ * its `key` / `value`.
+ */
+export declare function parseEntryRaw(raw: string): EnvLine | undefined;
+/** Flatten entries into a record (last duplicate wins). Values are unexpanded. */
+export declare function envLinesToRecord(lines: readonly EnvLine[]): Record<string, string>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAAc,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAuB,CAAC;AAMlD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAK9D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlF"}

package/dist/parse.js

@@ -0,0 +1,173 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/** Keys dotenv accepts when READING a file. */
+export const DOTENV_KEY_REGEX = /^[\w.-]+$/;
+/**
+ * Keys Kindgi WRITES: POSIX-shell env-var shape. Stricter than
+ * `DOTENV_KEY_REGEX` so every name Kindgi writes is also exportable
+ * from a shell.
+ */
+export const ENV_KEY_REGEX = /^[A-Z_][A-Z0-9_]*$/;
+const ENTRY_HEAD = /^\s*(export\s+)?([\w.-]+)(?:\s*=|:\s)\s*/;
+const TRAILER = /^\s*(?:#.*)?$/;
+const QUOTES = new Set(["'", '"', '`']);
+/**
+ * Split dotenv text into structured lines. `serializeEnvFile` of the
+ * result reproduces the input (line endings normalised to `\n`, which
+ * is also what dotenv does before parsing).
+ */
+export function parseEnvFile(raw) {
+    if (raw === '')
+        return [];
+    const physical = raw.split(/\r\n?|\n/);
+    const lines = physical.length > 0 && physical[physical.length - 1] === '' ? physical.slice(0, -1) : physical;
+    const out = [];
+    let i = 0;
+    while (i < lines.length) {
+        const { line, consumed } = parseAt(lines, i);
+        out.push(line);
+        i += consumed;
+    }
+    return out;
+}
+/**
+ * Parse a single entry's source text (possibly multi-line). Returns
+ * `undefined` unless the whole text is exactly one entry. Used by the
+ * serializer to decide whether an entry's `raw` is still faithful to
+ * its `key` / `value`.
+ */
+export function parseEntryRaw(raw) {
+    const lines = parseEnvFile(raw);
+    if (lines.length !== 1)
+        return undefined;
+    const [only] = lines;
+    return only?.kind === 'entry' ? only : undefined;
+}
+/** Flatten entries into a record (last duplicate wins). Values are unexpanded. */
+export function envLinesToRecord(lines) {
+    const out = {};
+    for (const line of lines) {
+        if (line.kind === 'entry' && line.key !== undefined && line.value !== undefined) {
+            out[line.key] = line.value;
+        }
+    }
+    return out;
+}
+function parseAt(lines, i) {
+    const first = lines[i] ?? '';
+    if (first.trim() === '')
+        return { line: { kind: 'blank', raw: first }, consumed: 1 };
+    if (first.trimStart().startsWith('#')) {
+        return { line: { kind: 'comment', raw: first }, consumed: 1 };
+    }
+    const head = ENTRY_HEAD.exec(first);
+    if (head === null) {
+        return {
+            line: { kind: 'malformed', raw: first, reason: 'not a `KEY=value` line' },
+            consumed: 1,
+        };
+    }
+    const key = head[2] ?? '';
+    const exported = head[1] !== undefined;
+    const valueStart = head[0].length;
+    const opener = first[valueStart];
+    if (opener !== undefined && QUOTES.has(opener)) {
+        const quoted = scanQuoted(lines, i, valueStart, opener);
+        if (quoted !== undefined) {
+            const raw = lines.slice(i, i + quoted.lineCount).join('\n');
+            return {
+                line: entry(raw, key, unescapeQuoted(quoted.inner, opener), exported),
+                consumed: quoted.lineCount,
+            };
+        }
+    }
+    return { line: entry(first, key, unquotedValue(first.slice(valueStart)), exported), consumed: 1 };
+}
+function entry(raw, key, value, exported) {
+    return exported
+        ? { kind: 'entry', raw, key, value, exported: true }
+        : { kind: 'entry', raw, key, value };
+}
+/**
+ * Unquoted value: everything up to the first `#`, trimmed. dotenv then
+ * strips one pair of matching outer quotes from the trimmed text (e.g.
+ * `KEY="a" "b"` → `a" "b`), and expands `\n` / `\r` if that pair was
+ * double quotes. Replicated exactly.
+ */
+function unquotedValue(rest) {
+    const hash = rest.indexOf('#');
+    const v = (hash === -1 ? rest : rest.slice(0, hash)).trim();
+    const q = v[0];
+    if (v.length >= 2 && q !== undefined && QUOTES.has(q) && v[v.length - 1] === q) {
+        return unescapeQuoted(v.slice(1, -1), q);
+    }
+    return v;
+}
+function unescapeQuoted(inner, quote) {
+    return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner;
+}
+/**
+ * Closing-quote candidates in the order dotenv's regex tries them: the
+ * first quote not preceded by a backslash, then each backslash-escaped
+ * quote before it, last to first.
+ */
+function closingCandidates(lines, startLine, startCol, quote) {
+    const escaped = [];
+    for (let line = startLine; line < lines.length; line += 1) {
+        const text = lines[line] ?? '';
+        const found = scanLine(text, line === startLine ? startCol + 1 : 0, quote);
+        for (const col of found.escaped)
+            escaped.push({ line, col });
+        if (found.closing !== -1)
+            return [{ line, col: found.closing }, ...escaped.reverse()];
+    }
+    return escaped.reverse();
+}
+/** One line's escaped-quote columns, and the first unescaped quote (-1 if none). */
+function scanLine(text, from, quote) {
+    const escaped = [];
+    let col = from;
+    while (col < text.length) {
+        if (text[col] === '\\' && text[col + 1] === quote) {
+            escaped.push(col + 1);
+            col += 2;
+        }
+        else if (text[col] === quote) {
+            return { escaped, closing: col };
+        }
+        else {
+            col += 1;
+        }
+    }
+    return { escaped, closing: -1 };
+}
+/**
+ * Find the closing quote the way dotenv's `'(?:\\'|[^'])*'` alternative
+ * does (per quote character): the first quote not preceded by a
+ * backslash is tried first; then, backtracking, each backslash-escaped
+ * quote before it, last to first. A candidate is accepted when the rest
+ * of its line is whitespace or a `# comment`. `undefined` = no candidate
+ * works and the value is read unquoted.
+ */
+function scanQuoted(lines, startLine, startCol, quote) {
+    for (const c of closingCandidates(lines, startLine, startCol, quote)) {
+        const closingLine = lines[c.line] ?? '';
+        if (!TRAILER.test(closingLine.slice(c.col + 1)))
+            continue;
+        return {
+            inner: sliceAcross(lines, startLine, startCol + 1, c.line, c.col),
+            lineCount: c.line - startLine + 1,
+        };
+    }
+    return undefined;
+}
+function sliceAcross(lines, fromLine, fromCol, toLine, toCol) {
+    if (fromLine === toLine)
+        return (lines[fromLine] ?? '').slice(fromCol, toCol);
+    const parts = [(lines[fromLine] ?? '').slice(fromCol)];
+    for (let li = fromLine + 1; li < toLine; li += 1)
+        parts.push(lines[li] ?? '');
+    parts.push((lines[toLine] ?? '').slice(0, toCol));
+    return parts.join('\n');
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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"}

package/dist/serialize.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Writer side: render entries so they READ BACK as the exact value
+ * written — through `dotenv`'s parser and `expand.ts`'s `${VAR}`
+ * expansion (the pipeline Next.js / Vite / dotenv-cli apply) — and keep
+ * every untouched line byte-for-byte.
+ *
+ * Round-trip contract, for any string `v` the writer accepts:
+ *
+ *     expandEnv(envLinesToRecord(parseEnvFile(setKey('', K, v).contents))).values[K] === v
+ *
+ * Quoting, first rule that fits wins:
+ *   1. Plain value (`[A-Za-z0-9_.,:/@+=%~-]+`) → unquoted.
+ *   2. Double quotes, when the value has no `"` and no literal `\n` /
+ *      `\r` sequence (dotenv would turn those into control chars).
+ *      Real newlines / carriage returns are written as `\n` / `\r`.
+ *   3. Single quotes (literal), when the value has no `'` and no `\r`.
+ *   4. Backticks (literal), when the value has no `` ` `` and no `\r`.
+ *   Otherwise the value is not representable in dotenv syntax and
+ *   `EnvValueNotRepresentableError` is thrown — never a silently
+ *   different value.
+ *
+ * `$` is always written as `\$`: expanders substitute `$NAME` even
+ * inside quotes, and `\$` is the one escape they all undo.
+ */
+import { type EnvLine } from './parse.js';
+/** Thrown when a value cannot be written so that it reads back unchanged. */
+export declare class EnvValueNotRepresentableError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+/** Render one `KEY=value` entry (throws `EnvValueNotRepresentableError`). */
+export declare function renderEntry(key: string, value: string, options?: {
+    exported?: boolean;
+}): string;
+/**
+ * Serialize lines back to file text with a trailing newline. An entry
+ * whose `raw` still parses to its `key` / `value` is emitted verbatim
+ * (hand-written quoting, `export`, inline comments survive); any other
+ * entry is re-rendered from `key` / `value`. Non-entry lines are
+ * emitted verbatim — a malformed line is never dropped.
+ */
+export declare function serializeEnvFile(lines: readonly EnvLine[]): string;
+/**
+ * Set `KEY=value`. When the key already exists, the LAST occurrence —
+ * the one readers see — is replaced in place (keeping its `export`
+ * prefix); otherwise the entry is appended. `key` must be a POSIX env
+ * name (`ENV_KEY_REGEX`).
+ */
+export declare function setKey(rawFileContents: string, key: string, value: string): {
+    readonly contents: string;
+    readonly overwritten: boolean;
+};
+/**
+ * Remove every entry for KEY; unrelated lines are preserved.
+ * Idempotent — `removed: false` when the key wasn't present.
+ */
+export declare function unsetKey(rawFileContents: string, key: string): {
+    readonly contents: string;
+    readonly removed: boolean;
+};
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAiB,KAAK,OAAO,EAA+B,MAAM,YAAY,CAAC;AAEtF,6EAA6E;AAC7E,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,GAAG,EAAE,MAAM;CAOxB;AAID,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,MAAM,CAGR;AAgBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAGlE;AAgBD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAqB9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAY1D"}

package/dist/serialize.js

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Writer side: render entries so they READ BACK as the exact value
+ * written — through `dotenv`'s parser and `expand.ts`'s `${VAR}`
+ * expansion (the pipeline Next.js / Vite / dotenv-cli apply) — and keep
+ * every untouched line byte-for-byte.
+ *
+ * Round-trip contract, for any string `v` the writer accepts:
+ *
+ *     expandEnv(envLinesToRecord(parseEnvFile(setKey('', K, v).contents))).values[K] === v
+ *
+ * Quoting, first rule that fits wins:
+ *   1. Plain value (`[A-Za-z0-9_.,:/@+=%~-]+`) → unquoted.
+ *   2. Double quotes, when the value has no `"` and no literal `\n` /
+ *      `\r` sequence (dotenv would turn those into control chars).
+ *      Real newlines / carriage returns are written as `\n` / `\r`.
+ *   3. Single quotes (literal), when the value has no `'` and no `\r`.
+ *   4. Backticks (literal), when the value has no `` ` `` and no `\r`.
+ *   Otherwise the value is not representable in dotenv syntax and
+ *   `EnvValueNotRepresentableError` is thrown — never a silently
+ *   different value.
+ *
+ * `$` is always written as `\$`: expanders substitute `$NAME` even
+ * inside quotes, and `\$` is the one escape they all undo.
+ */
+import { ENV_KEY_REGEX, parseEntryRaw, parseEnvFile } from './parse.js';
+/** Thrown when a value cannot be written so that it reads back unchanged. */
+export class EnvValueNotRepresentableError extends Error {
+    key;
+    constructor(key) {
+        super(`The value for ${key} cannot be written to a dotenv file so that it reads back unchanged (it mixes quote characters with content no dotenv quoting style can hold).`);
+        this.name = 'EnvValueNotRepresentableError';
+        this.key = key;
+    }
+}
+const PLAIN = /^[A-Za-z0-9_.,:/@+=%~-]+$/;
+/** Render one `KEY=value` entry (throws `EnvValueNotRepresentableError`). */
+export function renderEntry(key, value, options = {}) {
+    const prefix = options.exported === true ? 'export ' : '';
+    return `${prefix}${key}=${renderValue(key, value)}`;
+}
+function renderValue(key, value) {
+    if (value === '')
+        return '""';
+    const escaped = value.replace(/\$/g, '\\$');
+    if (PLAIN.test(escaped))
+        return escaped;
+    if (!escaped.includes('"') && !/\\[nr]/.test(escaped)) {
+        return `"${escaped.replace(/\n/g, '\\n').replace(/\r/g, '\\r')}"`;
+    }
+    if (!value.includes('\r')) {
+        if (!escaped.includes("'"))
+            return `'${escaped}'`;
+        if (!escaped.includes('`'))
+            return `\`${escaped}\``;
+    }
+    throw new EnvValueNotRepresentableError(key);
+}
+/**
+ * Serialize lines back to file text with a trailing newline. An entry
+ * whose `raw` still parses to its `key` / `value` is emitted verbatim
+ * (hand-written quoting, `export`, inline comments survive); any other
+ * entry is re-rendered from `key` / `value`. Non-entry lines are
+ * emitted verbatim — a malformed line is never dropped.
+ */
+export function serializeEnvFile(lines) {
+    const body = lines.map(serializeLine).join('\n');
+    return body === '' ? '' : `${body}\n`;
+}
+function serializeLine(line) {
+    if (line.kind !== 'entry' || line.key === undefined || line.value === undefined)
+        return line.raw;
+    const reparsed = parseEntryRaw(line.raw);
+    if (reparsed !== undefined &&
+        reparsed.key === line.key &&
+        reparsed.value === line.value &&
+        (reparsed.exported === true) === (line.exported === true)) {
+        return line.raw;
+    }
+    return renderEntry(line.key, line.value, { exported: line.exported === true });
+}
+/**
+ * Set `KEY=value`. When the key already exists, the LAST occurrence —
+ * the one readers see — is replaced in place (keeping its `export`
+ * prefix); otherwise the entry is appended. `key` must be a POSIX env
+ * name (`ENV_KEY_REGEX`).
+ */
+export function setKey(rawFileContents, key, value) {
+    if (!ENV_KEY_REGEX.test(key)) {
+        throw new TypeError(`Invalid env key "${key}" — must match ${ENV_KEY_REGEX.source}.`);
+    }
+    const lines = [...parseEnvFile(rawFileContents)];
+    let target = -1;
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const line = lines[i];
+        if (line?.kind === 'entry' && line.key === key) {
+            target = i;
+            break;
+        }
+    }
+    const exported = target === -1 ? false : lines[target]?.exported === true;
+    const raw = renderEntry(key, value, { exported });
+    const replacement = exported
+        ? { kind: 'entry', raw, key, value, exported: true }
+        : { kind: 'entry', raw, key, value };
+    if (target === -1)
+        lines.push(replacement);
+    else
+        lines[target] = replacement;
+    return { contents: serializeEnvFile(lines), overwritten: target !== -1 };
+}
+/**
+ * Remove every entry for KEY; unrelated lines are preserved.
+ * Idempotent — `removed: false` when the key wasn't present.
+ */
+export function unsetKey(rawFileContents, key) {
+    const lines = parseEnvFile(rawFileContents);
+    let removed = false;
+    const kept = [];
+    for (const line of lines) {
+        if (line.kind === 'entry' && line.key === key) {
+            removed = true;
+            continue;
+        }
+        kept.push(line);
+    }
+    return { contents: serializeEnvFile(kept), removed };
+}
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@kindgi/dotenv-file",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Dotenv files the way applications read them (dotenv grammar, verified against the version Next.js bundles), expanded (${VAR}), layered (.env < .env.local) and edited losslessly. Used by @kindgi/secrets-dotenv. Zero runtime dependencies.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kindgi/kindgi-sdk.git",
+    "directory": "packages/dotenv-file"
+  },
+  "homepage": "https://github.com/kindgi/kindgi-sdk/tree/main/packages/dotenv-file#readme",
+  "bugs": {
+    "url": "https://github.com/kindgi/kindgi-sdk/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "dotenv": "16.3.1",
+    "dotenv-expand-10": "npm:dotenv-expand@10.0.0",
+    "dotenv-expand-12": "npm:dotenv-expand@12.0.3",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
 }