typed-settings 0.1.1 → 0.2.1

package/dist/chunk-RQC6OMVV.js

@@ -1,86 +0,0 @@
-import { ConfigError } from './chunk-EE6LXNJV.js';
-
-// src/vault/shared.ts
-function getFetch(fetchFn) {
-  if (fetchFn) return fetchFn;
-  const g = globalThis;
-  if (g.fetch) return g.fetch.bind(globalThis);
-  throw new ConfigError(
-    [{ path: "<provider>", from: "vault", message: "E_NO_FETCH: global fetch unavailable" }],
-    "E_NO_FETCH"
-  );
-}
-function sameHost(a, b) {
-  return new URL(a).host === new URL(b).host;
-}
-var SENSITIVE_HEADER_RE = /authorization|token|secret|api[-_]?key|cookie|auth/i;
-function stripSensitiveForCrossHost(headers) {
-  const next = new Headers();
-  headers.forEach((value, key) => {
-    if (!SENSITIVE_HEADER_RE.test(key)) next.set(key, value);
-  });
-  return next;
-}
-async function fetchWithRedirectGuard(url, init, fetchFn, maxRedirects = 2) {
-  let current = url;
-  let headers = new Headers(init.headers);
-  for (let i = 0; i <= maxRedirects; i++) {
-    const res = await fetchFn(current, { ...init, headers, redirect: "manual" });
-    const status = res.status;
-    if (![301, 302, 303, 307, 308].includes(status)) return res;
-    const loc = res.headers.get("location");
-    if (!loc) return res;
-    let next;
-    try {
-      next = new URL(loc, current).toString();
-    } catch {
-      throw new ConfigError(
-        [{ path: current, from: "vault", message: "E_REDIRECT: invalid Location header" }],
-        "E_REDIRECT"
-      );
-    }
-    if (i === maxRedirects) {
-      throw new ConfigError(
-        [{ path: next, from: "vault", message: "E_REDIRECT: too many redirects" }],
-        "E_REDIRECT"
-      );
-    }
-    if (!sameHost(current, next)) headers = stripSensitiveForCrossHost(headers);
-    current = next;
-  }
-  throw new ConfigError([{ path: url, from: "vault", message: "E_REDIRECT" }], "E_REDIRECT");
-}
-function normalizeSecretMap(raw, providerName, opts) {
-  const trim = opts?.trimNewline !== false;
-  const clean = (v) => {
-    if (v === null || v === void 0) return void 0;
-    let s = typeof v === "string" ? v : String(v);
-    if (trim) s = s.replace(/\r?\n$/, "");
-    return s;
-  };
-  const out = {};
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    throw new ConfigError(
-      [{ path: "<root>", from: providerName, message: "E_SHAPE: provider returned non-object" }],
-      "E_SHAPE"
-    );
-  }
-  for (const [k, v] of Object.entries(raw)) {
-    if (v !== null && typeof v === "object" && !Array.isArray(v)) {
-      out[k] = v;
-      continue;
-    }
-    const c = clean(v);
-    if (c !== void 0) out[k] = c;
-  }
-  return out;
-}
-function statusToCode(status) {
-  if (status === 403 || status === 401) return "E_DENIED";
-  if (status === 404) return "E_NOT_FOUND";
-  if (status === 429) return "E_THROTTLED";
-  if (status >= 500) return "E_UPSTREAM";
-  return "E_PROVIDER";
-}
-
-export { fetchWithRedirectGuard, getFetch, normalizeSecretMap, statusToCode };

package/dist/chunk-UFUHHR2J.js

@@ -1,38 +0,0 @@
-import { parseAllDocuments } from 'yaml';
-
-// src/formats/yaml.ts
-function parseYamlText(text, from = "yaml") {
-  const stripped = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  if (!stripped.trim()) return {};
-  const docs = parseAllDocuments(stripped, {
-    version: "1.2",
-    uniqueKeys: true
-  }).filter((d) => {
-    if (d.errors.length > 0) return true;
-    try {
-      const v = d.toJS();
-      return v !== null && v !== void 0;
-    } catch {
-      return true;
-    }
-  });
-  if (docs.length === 0) return {};
-  if (docs.length > 1) {
-    throw new Error(`ParseError (${from}): multi-doc YAML not supported (got ${docs.length} documents)`);
-  }
-  const doc = docs[0];
-  if (doc.errors.length > 0) {
-    const first = doc.errors[0];
-    const line = first.linePos?.[0]?.line ?? "?";
-    throw new Error(`ParseError (${from}:${line}): ${first.message}`);
-  }
-  let value;
-  try {
-    value = doc.toJS();
-  } catch (e) {
-    throw new Error(`ParseError (${from}): ${e.message}`);
-  }
-  return value;
-}
-
-export { parseYamlText };

package/dist/chunk-VTIYOSG2.js

@@ -1,233 +0,0 @@
-import { settings } from './chunk-RCO6K3WQ.js';
-import { parseEnvText } from './chunk-F6DX3HXZ.js';
-import { readFileSync, readdirSync, statSync, watch } from 'fs';
-import { join, dirname, basename, resolve } from 'path';
-
-globalThis.__typedSettingsFs ??= {
-  readFileSync: (p, e) => readFileSync(p, e)
-};
-function loadEnvFiles(paths) {
-  const parts = [];
-  for (const p of paths) {
-    try {
-      parts.push(readFileSync(p, "utf8"));
-    } catch (e) {
-      const err = e;
-      if (err?.code === "ENOENT") continue;
-      throw e;
-    }
-  }
-  return { text: parts.join("\n") };
-}
-function loadSecretsDir(dir) {
-  const out = {};
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch (e) {
-    const err = e;
-    if (err?.code === "ENOENT") return out;
-    throw e;
-  }
-  for (const name of entries) {
-    const full = join(dir, name);
-    try {
-      const st = statSync(full);
-      if (!st.isFile()) continue;
-    } catch (e) {
-      const err = e;
-      if (err?.code === "ENOENT") continue;
-      throw e;
-    }
-    if (name.startsWith("..")) continue;
-    let v;
-    try {
-      v = readFileSync(full, "utf8").replace(/\r?\n$/, "");
-    } catch (e) {
-      const err = e;
-      if (err?.code === "ENOENT") continue;
-      throw e;
-    }
-    if (!v) continue;
-    out[name.toUpperCase()] = v;
-  }
-  return out;
-}
-function parseEnvFile(path) {
-  try {
-    const text = readFileSync(path, "utf8");
-    return parseEnvText(text);
-  } catch (e) {
-    const err = e;
-    if (err?.code === "ENOENT") return {};
-    throw e;
-  }
-}
-function extractWatchFiles(sources) {
-  const out = [];
-  for (const s of sources ?? []) {
-    if (s === "env") continue;
-    if (s === ".env" || s === ".env.local") out.push(resolve(s));
-    else if (typeof s === "string") {
-      const lower = s.toLowerCase();
-      if (lower.endsWith(".env") || s === ".env.local" || lower.endsWith(".json") || lower.endsWith(".yaml") || lower.endsWith(".yml") || lower.endsWith(".toml")) {
-        out.push(resolve(s));
-      } else if (!lower.endsWith(".env")) {
-        out.push(resolve(s));
-      }
-    } else if (s && typeof s === "object" && "file" in s) {
-      out.push(resolve(s.file));
-    }
-  }
-  return [...new Set(out)];
-}
-function hasPollSources(sources) {
-  return (sources ?? []).some(
-    (s) => s && typeof s === "object" && ("dir" in s || "provider" in s || "load" in s)
-  );
-}
-function diffLeafPaths(a, b, prefix = "") {
-  if (Array.isArray(a) && Array.isArray(b)) {
-    const out = [];
-    const len = Math.max(a.length, b.length);
-    for (let i = 0; i < len; i++) {
-      const p = prefix ? `${prefix}[${i}]` : `[${i}]`;
-      if (i >= a.length || i >= b.length) out.push(p);
-      else out.push(...diffLeafPaths(a[i], b[i], p));
-    }
-    return out;
-  }
-  if (a && typeof a === "object" && b && typeof b === "object" && !Array.isArray(a) && !Array.isArray(b)) {
-    const out = [];
-    const keys = /* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(b)]);
-    for (const k of keys) {
-      const p = prefix ? `${prefix}.${k}` : k;
-      if (!(k in a) || !(k in b)) out.push(p);
-      else out.push(...diffLeafPaths(a[k], b[k], p));
-    }
-    return out;
-  }
-  return JSON.stringify(a) === JSON.stringify(b) ? [] : [prefix || "<root>"];
-}
-async function stableSize(path, retries = 3) {
-  for (let i = 0; i < retries; i++) {
-    let s1 = null;
-    let s2 = null;
-    try {
-      const st = statSync(path);
-      s1 = { size: st.size, mtimeMs: st.mtimeMs };
-    } catch {
-      return;
-    }
-    await new Promise((r) => setTimeout(r, 20));
-    try {
-      const st = statSync(path);
-      s2 = { size: st.size, mtimeMs: st.mtimeMs };
-    } catch {
-      return;
-    }
-    if (s1.size === s2.size && s1.mtimeMs === s2.mtimeMs) return;
-  }
-}
-function watchSettings(opts, cb = {}) {
-  const debounceMs = cb.debounceMs ?? 100;
-  const refreshMs = cb.refreshMs ?? (hasPollSources(opts.sources) ? 6e4 : 0);
-  const pollMs = cb.pollMs ?? 0;
-  let current = settings(opts);
-  let version = 0;
-  let reloadId = 0;
-  let disposed = false;
-  let timer = null;
-  const watchers = [];
-  const intervals = [];
-  const watchedDirs = /* @__PURE__ */ new Set();
-  const handle = {
-    get: () => current,
-    reload: async () => {
-      await doReload();
-    },
-    dispose: async () => {
-      if (disposed) return;
-      disposed = true;
-      if (timer) clearTimeout(timer);
-      for (const iv of intervals) clearInterval(iv);
-      for (const w of watchers) {
-        try {
-          w.close();
-        } catch {
-        }
-      }
-    },
-    get version() {
-      return version;
-    }
-  };
-  async function doReload() {
-    const myId = ++reloadId;
-    ensureWatchers();
-    const files = extractWatchFiles(opts.sources);
-    await Promise.all(
-      files.map(
-        (f) => stableSize(f).catch(() => {
-        })
-      )
-    );
-    if (disposed || myId !== reloadId) return;
-    let next;
-    try {
-      next = settings(opts);
-    } catch (e) {
-      try {
-        cb.onError?.(e, { version });
-      } catch {
-      }
-      return;
-    }
-    if (disposed || myId !== reloadId) return;
-    const changed = diffLeafPaths(current, next);
-    current = next;
-    version++;
-    try {
-      cb.onUpdate?.(current, changed);
-    } catch {
-    }
-  }
-  function scheduleReload() {
-    if (disposed) return;
-    if (timer) clearTimeout(timer);
-    timer = setTimeout(() => {
-      timer = null;
-      void doReload();
-    }, debounceMs);
-  }
-  function ensureWatchers() {
-    for (const file of extractWatchFiles(opts.sources)) {
-      const dir = dirname(file);
-      const base = basename(file);
-      const key = dir + "\0" + base;
-      if (watchedDirs.has(key)) continue;
-      try {
-        const w = watch(dir, (_event, filename) => {
-          const name = typeof filename === "string" ? filename : filename ? String(filename) : null;
-          if (name && name !== base) return;
-          scheduleReload();
-        });
-        w.on("error", () => {
-        });
-        watchers.push(w);
-        watchedDirs.add(key);
-      } catch {
-      }
-    }
-  }
-  ensureWatchers();
-  if (pollMs > 0) {
-    intervals.push(setInterval(scheduleReload, pollMs));
-  }
-  if (refreshMs > 0) {
-    intervals.push(setInterval(scheduleReload, refreshMs));
-  }
-  return handle;
-}
-
-export { loadEnvFiles, loadSecretsDir, parseEnvFile, watchSettings };

package/dist/errors-itGaU4Q8.d.cts

@@ -1,17 +0,0 @@
-/** One validation failure: the key path, the winning source, and what went wrong. */
-interface ConfigIssue {
-    path: string;
-    from: string;
-    message: string;
-}
-/**
- * Every settings failure. Carries machine-readable `issues` plus a `code`
- * (`E_INVALID_CONFIG` by default, e.g. `E_UNKNOWN_KEY`, `E_TIMEOUT`).
- */
-declare class ConfigError extends Error {
-    code: string;
-    issues: ConfigIssue[];
-    constructor(issues: ConfigIssue[], code?: string);
-}
-
-export { ConfigError as C };

package/dist/errors-itGaU4Q8.d.ts

@@ -1,17 +0,0 @@
-/** One validation failure: the key path, the winning source, and what went wrong. */
-interface ConfigIssue {
-    path: string;
-    from: string;
-    message: string;
-}
-/**
- * Every settings failure. Carries machine-readable `issues` plus a `code`
- * (`E_INVALID_CONFIG` by default, e.g. `E_UNKNOWN_KEY`, `E_TIMEOUT`).
- */
-declare class ConfigError extends Error {
-    code: string;
-    issues: ConfigIssue[];
-    constructor(issues: ConfigIssue[], code?: string);
-}
-
-export { ConfigError as C };

package/dist/formats/env.cjs

@@ -1,103 +0,0 @@
-'use strict';
-
-// src/formats/env.ts
-function parseEnvText(text) {
-  const out = {};
-  if (text.charCodeAt(0) === 65279) text = text.slice(1);
-  const lines = splitLogicalLines(text);
-  for (const rawLine of lines) {
-    let line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    if (line.startsWith("export ")) line = line.slice(7).trimStart();
-    const eq = line.indexOf("=");
-    if (eq === -1) {
-      throw new Error(`ParseError: bare key without '=': ${JSON.stringify(line)}`);
-    }
-    const key = line.slice(0, eq).trim();
-    let rest = line.slice(eq + 1).trimStart();
-    if (!key) throw new Error("ParseError: empty key");
-    out[key] = parseValue(rest);
-  }
-  return out;
-}
-function splitLogicalLines(text) {
-  const physical = text.split(/\r?\n/);
-  const out = [];
-  let buf = "";
-  let inDouble = false;
-  for (const pl of physical) {
-    if (!inDouble) {
-      const opens = countUnescapedQuotes(pl);
-      if (opens % 2 === 1 && isValueStartDoubleQuoted(pl)) {
-        buf = pl;
-        inDouble = true;
-      } else {
-        out.push(pl);
-      }
-    } else {
-      buf += "\n" + pl;
-      const opens = countUnescapedQuotes(buf.split("=").slice(1).join("="));
-      if (opens % 2 === 0) {
-        inDouble = false;
-        out.push(buf);
-        buf = "";
-      }
-    }
-  }
-  if (inDouble) throw new Error("ParseError: unterminated double-quoted value");
-  return out;
-}
-function isValueStartDoubleQuoted(line) {
-  const eq = line.indexOf("=");
-  if (eq === -1) return false;
-  const rest = line.slice(eq + 1).trimStart();
-  return rest.startsWith('"') && !rest.endsWith('"');
-}
-function countUnescapedQuotes(s) {
-  let n = 0;
-  for (let i = 0; i < s.length; i++) {
-    if (s[i] === '"' && s[i - 1] !== "\\") n++;
-  }
-  return n;
-}
-function parseValue(rest) {
-  if (!rest) return "";
-  if (rest.startsWith("'")) {
-    const end = rest.indexOf("'", 1);
-    if (end === -1) throw new Error("ParseError: unterminated single-quoted value");
-    return rest.slice(1, end);
-  }
-  if (rest.startsWith('"')) {
-    let i = 1;
-    let val = "";
-    while (i < rest.length) {
-      const c = rest[i];
-      if (c === "\\" && i + 1 < rest.length) {
-        const n = rest[i + 1];
-        if (n === "n") val += "\n";
-        else if (n === "r") val += "\r";
-        else if (n === "t") val += "	";
-        else val += n;
-        i += 2;
-        continue;
-      }
-      if (c === '"') break;
-      val += c;
-      i++;
-    }
-    if (rest[i] !== '"') throw new Error("ParseError: unterminated double-quoted value");
-    return val;
-  }
-  if (rest.startsWith("`")) throw new Error("ParseError: backtick values not supported");
-  const hash = findCommentStart(rest);
-  const v = (hash === -1 ? rest : rest.slice(0, hash)).trim();
-  return v;
-}
-function findCommentStart(s) {
-  for (let i = 0; i < s.length; i++) {
-    if (s[i] === "#" && (i === 0 || /\s/.test(s[i - 1]))) return i;
-  }
-  return -1;
-}
-
-exports.parseEnvText = parseEnvText;

package/dist/formats/env.d.cts

@@ -1,8 +0,0 @@
-/**
- * Parses dotenv text into a flat map. Strips one BOM, joins multiline
- * double-quoted values, lets the last duplicate win. Throws `ParseError` on
- * backticks, unterminated quotes, bare keys, and empty keys.
- */
-declare function parseEnvText(text: string): Record<string, string>;
-
-export { parseEnvText };

package/dist/formats/env.d.ts

@@ -1,8 +0,0 @@
-/**
- * Parses dotenv text into a flat map. Strips one BOM, joins multiline
- * double-quoted values, lets the last duplicate win. Throws `ParseError` on
- * backticks, unterminated quotes, bare keys, and empty keys.
- */
-declare function parseEnvText(text: string): Record<string, string>;
-
-export { parseEnvText };

package/dist/formats/env.js

@@ -1 +0,0 @@
-export { parseEnvText } from '../chunk-F6DX3HXZ.js';

package/dist/formats/json.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-// src/formats/json.ts
-function parseJsonText(text, from = "json") {
-  const stripped = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  if (!stripped.trim()) return {};
-  try {
-    return JSON.parse(stripped);
-  } catch (e) {
-    const err = e;
-    throw new Error(`ParseError (${from}): ${err.message}`);
-  }
-}
-
-exports.parseJsonText = parseJsonText;

package/dist/formats/json.d.cts

@@ -1,7 +0,0 @@
-/**
- * Strict JSON parse (BOM-tolerant, blank reads as `{}`). Failures throw
- * `ParseError` naming the source for attribution.
- */
-declare function parseJsonText(text: string, from?: string): unknown;
-
-export { parseJsonText };

package/dist/formats/json.d.ts

@@ -1,7 +0,0 @@
-/**
- * Strict JSON parse (BOM-tolerant, blank reads as `{}`). Failures throw
- * `ParseError` naming the source for attribution.
- */
-declare function parseJsonText(text: string, from?: string): unknown;
-
-export { parseJsonText };

package/dist/formats/json.js

@@ -1 +0,0 @@
-export { parseJsonText } from '../chunk-33M5GIKQ.js';

package/dist/formats/toml.cjs

@@ -1,17 +0,0 @@
-'use strict';
-
-var smolToml = require('smol-toml');
-
-// src/formats/toml.ts
-function parseTomlText(text, from = "toml") {
-  const stripped = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  if (!stripped.trim()) return {};
-  try {
-    return smolToml.parse(stripped);
-  } catch (e) {
-    const err = e;
-    throw new Error(`ParseError (${from}): ${err.message}`);
-  }
-}
-
-exports.parseTomlText = parseTomlText;

package/dist/formats/toml.d.cts

@@ -1,7 +0,0 @@
-/**
- * TOML parse via smol-toml (duplicate keys rejected). Blank reads as `{}`;
- * failures throw `ParseError` naming the source.
- */
-declare function parseTomlText(text: string, from?: string): unknown;
-
-export { parseTomlText };

package/dist/formats/toml.d.ts

@@ -1,7 +0,0 @@
-/**
- * TOML parse via smol-toml (duplicate keys rejected). Blank reads as `{}`;
- * failures throw `ParseError` naming the source.
- */
-declare function parseTomlText(text: string, from?: string): unknown;
-
-export { parseTomlText };

package/dist/formats/toml.js

@@ -1 +0,0 @@
-export { parseTomlText } from '../chunk-OVFMKC2O.js';

package/dist/formats/yaml.cjs

@@ -1,40 +0,0 @@
-'use strict';
-
-var yaml = require('yaml');
-
-// src/formats/yaml.ts
-function parseYamlText(text, from = "yaml") {
-  const stripped = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  if (!stripped.trim()) return {};
-  const docs = yaml.parseAllDocuments(stripped, {
-    version: "1.2",
-    uniqueKeys: true
-  }).filter((d) => {
-    if (d.errors.length > 0) return true;
-    try {
-      const v = d.toJS();
-      return v !== null && v !== void 0;
-    } catch {
-      return true;
-    }
-  });
-  if (docs.length === 0) return {};
-  if (docs.length > 1) {
-    throw new Error(`ParseError (${from}): multi-doc YAML not supported (got ${docs.length} documents)`);
-  }
-  const doc = docs[0];
-  if (doc.errors.length > 0) {
-    const first = doc.errors[0];
-    const line = first.linePos?.[0]?.line ?? "?";
-    throw new Error(`ParseError (${from}:${line}): ${first.message}`);
-  }
-  let value;
-  try {
-    value = doc.toJS();
-  } catch (e) {
-    throw new Error(`ParseError (${from}): ${e.message}`);
-  }
-  return value;
-}
-
-exports.parseYamlText = parseYamlText;

package/dist/formats/yaml.d.cts

@@ -1,8 +0,0 @@
-/**
- * Single-doc YAML parse (1.2, duplicate keys rejected). A trailing lone `---`
- * still parses; multi-doc payloads, bad indentation, and unresolvable aliases
- * throw `ParseError` naming the source. Explicit `null` reads as `{}`.
- */
-declare function parseYamlText(text: string, from?: string): unknown;
-
-export { parseYamlText };

package/dist/formats/yaml.d.ts

@@ -1,8 +0,0 @@
-/**
- * Single-doc YAML parse (1.2, duplicate keys rejected). A trailing lone `---`
- * still parses; multi-doc payloads, bad indentation, and unresolvable aliases
- * throw `ParseError` naming the source. Explicit `null` reads as `{}`.
- */
-declare function parseYamlText(text: string, from?: string): unknown;
-
-export { parseYamlText };

package/dist/formats/yaml.js

@@ -1 +0,0 @@
-export { parseYamlText } from '../chunk-UFUHHR2J.js';