typed-settings 0.1.1 → 0.2.1

package/dist/cli/main.js

@@ -1,831 +1,57 @@
 #!/usr/bin/env node
-import { watchSettings } from '../chunk-VTIYOSG2.js';
-import { settings } from '../chunk-RCO6K3WQ.js';
-import '../chunk-33M5GIKQ.js';
-import '../chunk-OVFMKC2O.js';
-import '../chunk-UFUHHR2J.js';
-import { ConfigError } from '../chunk-EE6LXNJV.js';
-import '../chunk-F6DX3HXZ.js';
-import { parseArgs } from 'util';
-import { resolve, join, dirname } from 'path';
-import { existsSync, mkdirSync, writeFileSync, chmodSync, readFileSync } from 'fs';
-import { spawn } from 'child_process';
-
-async function loadSchema(schemaPath, exportName) {
-  const abs = resolve(schemaPath);
-  let mod;
-  try {
-    const { createJiti } = await import('jiti');
-    const jiti = createJiti(import.meta.url, { interopDefault: false, fsCache: false, moduleCache: false });
-    mod = await jiti.import(abs);
-  } catch (e) {
-    const err2 = e;
-    const wrapped = new Error(`SCHEMA_LOAD_ERROR: ${abs}: ${err2.message}`);
-    wrapped.code = "SCHEMA_LOAD_ERROR";
-    throw wrapped;
-  }
-  const pick = (name) => mod[name];
-  const isStandard = (v) => {
-    if (!v) return false;
-    if (typeof v !== "object" && typeof v !== "function") return false;
-    return "~standard" in v;
-  };
-  if (exportName) {
-    const picked = pick(exportName);
-    if (!isStandard(picked)) {
-      const err2 = new Error(
-        `SCHEMA_LOAD_ERROR: --schema-export ${JSON.stringify(exportName)} did not resolve to a Standard Schema in ${abs}`
-      );
-      err2.code = "SCHEMA_LOAD_ERROR";
-      throw err2;
-    }
-    return picked;
-  }
-  for (const cand of ["schema", "settingsSchema", "default"]) {
-    if (isStandard(pick(cand))) return pick(cand);
-  }
-  const first = Object.values(mod).find((v) => isStandard(v));
-  if (first) return first;
-  const err = new Error(`SCHEMA_LOAD_ERROR: no Standard Schema export in ${abs} (tried default/schema/settingsSchema)`);
-  err.code = "SCHEMA_LOAD_ERROR";
-  throw err;
-}
-
-// src/cli/check.ts
-async function runCheck(args) {
-  let schema;
-  try {
-    schema = await loadSchema(args.schema, args.schemaExport);
-  } catch (e) {
-    const err = e;
-    if (args.format === "json") console.log(JSON.stringify({ ok: false, error: err.message }));
-    else console.error(err.message);
-    return 2;
-  }
-  const sources = (args.config ?? ".env,env").split(",").map((s) => s.trim()).filter(Boolean);
-  try {
-    const cfg = settings({
-      schema,
-      sources: sources.length ? sources : [".env", "env"],
-      strict: void 0,
-      unknownKeys: args.strict ? "reject" : "strip",
-      expand: args.expand ?? true,
-      arrayStrategy: args.array ?? "replace",
-      prefix: args.prefix
-    });
-    if (args.format === "json") console.log(JSON.stringify({ ok: true, config: cfg }));
-    else console.log("OK: config valid");
-    return 0;
-  } catch (e) {
-    if (e instanceof ConfigError) {
-      if (args.format === "json") console.log(JSON.stringify({ ok: false, issues: e.issues }));
-      else {
-        console.error(e.message);
-      }
-      return 1;
-    }
-    const err = e;
-    if (args.format === "json") console.log(JSON.stringify({ ok: false, error: err.message }));
-    else console.error(`E_LOAD: ${err.message}`);
-    return 2;
-  }
-}
-var SETTINGS_TPL = {
-  zod: `import { z } from 'zod';
+import {b as b$1,a}from'../chunk-FQYD5ZKE.js';import {d}from'../chunk-C6CG2D4B.js';import'../chunk-4EAMKDNK.js';import'../chunk-NQDE3WLR.js';import {parseArgs}from'util';import {existsSync,mkdirSync,writeFileSync,chmodSync,readFileSync,lstatSync}from'fs';import {resolve,join,dirname}from'path';import {spawn}from'child_process';var w={zod:`import { z } from 'zod';
 import { settings } from 'typed-settings';
+import 'typed-settings/node';
 
-const schema = z.object({
+export const schema = z.object({
   port: z.coerce.number().default(3000),
 });
 
 export const cfg = settings({ schema, sources: ['.env', 'env'], prefix: 'APP_' });
-`,
-  valibot: `import * as v from 'valibot';
+`,valibot:`import * as v from 'valibot';
 import { settings } from 'typed-settings';
+import 'typed-settings/node';
 
-const schema = v.object({ port: v.optional(v.pipe(v.unknown(), v.transform(Number)), 3000) });
+export const schema = v.object({ port: v.optional(v.pipe(v.unknown(), v.transform(Number), v.number()), 3000) });
 
 export const cfg = settings({ schema: schema as never, sources: ['.env', 'env'], prefix: 'APP_' });
-`,
-  arktype: `import { type } from 'arktype';
+`,arktype:`import { type } from 'arktype';
 import { settings } from 'typed-settings';
+import 'typed-settings/node';
 
-const schema = type({ 'port?: string.integer.parse = 3000' });
+export const schema = type({ port: 'number = 3000' });
 
 export const cfg = settings({ schema: schema as never, sources: ['.env', 'env'], prefix: 'APP_' });
-`,
-  yup: `import * as yup from 'yup';
+`,yup:`// npm install yup
+import * as yup from 'yup';
 import { settings } from 'typed-settings';
+import 'typed-settings/node';
 import { yupAdapter } from 'typed-settings/yup';
 
-const schema = yup.object({ port: yup.number().default(3000) });
+export const schema = yup.object({ port: yup.number().default(3000) });
 
 export const cfg = settings({ schema: yupAdapter(schema) as never, sources: ['.env', 'env'], prefix: 'APP_' });
-`,
-  joi: `import Joi from 'joi';
+`,joi:`// npm install joi
+import Joi from 'joi';
 import { settings } from 'typed-settings';
+import 'typed-settings/node';
 import { joiAdapter } from 'typed-settings/joi';
 
-const schema = Joi.object({ port: Joi.number().default(3000) });
+export const schema = Joi.object({ port: Joi.number().default(3000) });
 
 export const cfg = settings({ schema: joiAdapter(schema as never) as never, sources: ['.env', 'env'], prefix: 'APP_' });
-`
-};
-var CONFIG_TPL = {
-  env: "# APP_PORT=3000\nAPP_PORT=3000\n",
-  yaml: "# config.yaml\nport: 3000\n",
-  toml: "# config.toml\nport = 3000\n"
-};
-async function runInit(args) {
-  const lib = args.lib ?? "zod";
-  const format = args.format ?? "env";
-  if (!(lib in SETTINGS_TPL)) {
-    console.error(`E_USAGE: --lib must be ${Object.keys(SETTINGS_TPL).join("|")} (got ${JSON.stringify(lib)})`);
-    return 2;
-  }
-  if (!(format in CONFIG_TPL)) {
-    console.error(`E_USAGE: --format must be ${Object.keys(CONFIG_TPL).join("|")} (got ${JSON.stringify(format)})`);
-    return 2;
-  }
-  const dir = resolve(args.dir ?? ".");
-  const settingsTpl = SETTINGS_TPL[lib];
-  const configName = format === "env" ? ".env.example" : `config.${format}`;
-  const files = [
-    { path: join(dir, "src", "settings.ts"), content: settingsTpl },
-    { path: join(dir, configName), content: CONFIG_TPL[format] }
-  ];
-  const currentOf = (p) => {
-    try {
-      return readFileSync(p, "utf8");
-    } catch {
-      return null;
-    }
-  };
-  const drifted = files.filter((f) => currentOf(f.path) !== f.content);
-  if (args.dryRun || args.check) {
-    for (const f of files) {
-      const cur = currentOf(f.path);
-      console.log(`${cur === null ? "create" : cur === f.content ? "exists" : "overwrite"} ${f.path}`);
-    }
-    if (args.check && drifted.length > 0) return 2;
-    return 0;
-  }
-  let written = 0;
-  for (const f of files) {
-    if (currentOf(f.path) === f.content) {
-      continue;
-    }
-    if (existsSync(f.path) && !args.force) {
-      continue;
-    }
-    mkdirSync(dirname(f.path), { recursive: true });
-    writeFileSync(f.path, f.content, { mode: 384 });
-    try {
-      chmodSync(f.path, 384);
-    } catch {
-    }
-    written++;
-  }
-  console.log(`init: ${lib} + ${format} scaffolding ${written > 0 ? `written (${written} file${written === 1 ? "" : "s"})` : "already up to date"}`);
-  return 0;
-}
-
-// src/cli/describe.ts
-function getShape(schema) {
-  const s = schema;
-  if (s && typeof s.shape === "object" && s.shape !== null) return s.shape;
-  if (s && typeof s.shape === "function") {
-    try {
-      return s.shape();
-    } catch {
-      return null;
-    }
-  }
-  const d = s?._def?.shape;
-  if (typeof d === "function") {
-    try {
-      return d();
-    } catch {
-      return null;
-    }
-  }
-  if (d && typeof d === "object") return d;
-  return null;
-}
-function unwrapField(t) {
-  let cur = t;
-  let optional = false;
-  let def;
-  for (let i = 0; i < 10; i++) {
-    const c = cur;
-    const z4type = c?.type ?? c?.def?.type;
-    if (z4type === "optional") {
-      optional = true;
-      cur = c?.def?.innerType ?? (typeof c?.unwrap === "function" ? safeUnwrap(c.unwrap) : void 0) ?? cur;
-      if (cur === t) break;
-      t = cur;
-      continue;
-    }
-    if (z4type === "nullable") {
-      cur = c?.def?.innerType ?? (typeof c?.unwrap === "function" ? safeUnwrap(c.unwrap) : void 0) ?? cur;
-      if (cur === t) break;
-      t = cur;
-      continue;
-    }
-    if (z4type === "catch" || z4type === "prefault" || z4type === "pipe" || z4type === "brand" || z4type === "readonly") {
-      const inner = c?.def?.innerType ?? (typeof c?.unwrap === "function" ? safeUnwrap(c.unwrap) : void 0);
-      if (inner === void 0 || inner === cur) break;
-      cur = inner;
-      t = cur;
-      continue;
-    }
-    if (z4type === "default") {
-      const dv = c?.def?.defaultValue;
-      if (def === void 0) def = typeof dv === "function" ? safeCall(dv) : dv;
-      optional = true;
-      cur = c?.def?.innerType ?? (typeof c?.unwrap === "function" ? safeUnwrap(c.unwrap) : void 0) ?? cur;
-      continue;
-    }
-    if (z4type === "readonly" || z4type === "nonoptional" || z4type === "success") {
-      cur = c?.def?.innerType ?? cur;
-      continue;
-    }
-    const tn = c?._def?.typeName;
-    if (tn === "ZodOptional") {
-      optional = true;
-      cur = c?._def?.innerType;
-      continue;
-    }
-    if (tn === "ZodNullable") {
-      cur = c?._def?.innerType;
-      continue;
-    }
-    if (tn === "ZodDefault") {
-      if (def === void 0) {
-        const dv = c?._def?.defaultValue;
-        def = typeof dv === "function" ? safeCall(dv) : dv;
-      }
-      optional = true;
-      cur = c?._def?.innerType;
-      continue;
-    }
-    if (tn === "ZodReadonly") {
-      cur = c?._def?.innerType;
-      continue;
-    }
-    break;
-  }
-  const desc = cur?.description ?? cur?.def?.description ?? t?.description;
-  return { inner: cur, optional, def, desc };
-}
-function safeUnwrap(fn) {
-  try {
-    return fn();
-  } catch {
-    return void 0;
-  }
-}
-function safeCall(fn) {
-  try {
-    return fn();
-  } catch {
-    return void 0;
-  }
-}
-function enumMembers(def) {
-  const d = def;
-  if (Array.isArray(d?.values)) return d.values;
-  if (d?.entries && typeof d.entries === "object") return Object.values(d.entries);
-  return [];
-}
-function unwrapZod(t) {
-  return unwrapField(t);
-}
-function zodTypeName(t) {
-  const c = t;
-  const z4 = c?.type ?? c?.def?.type;
-  if (z4) {
-    switch (z4) {
-      case "string":
-        return "string";
-      case "number":
-        return "number";
-      case "boolean":
-        return "boolean";
-      case "array":
-        return "array";
-      case "object":
-        return "object";
-      // Zod 4 keeps enum members in `def.entries` (object); older shapes use `def.values`.
-      case "enum":
-        return `enum(${enumMembers(c?.def).join("|")})`;
-      case "literal":
-        return "literal";
-      case "union":
-        return "union";
-      default:
-        return z4;
-    }
-  }
-  const tn = c?._def?.typeName ?? "unknown";
-  switch (tn) {
-    case "ZodString":
-      return "string";
-    case "ZodNumber":
-      return "number";
-    case "ZodBoolean":
-      return "boolean";
-    case "ZodArray":
-      return "array";
-    case "ZodObject":
-      return "object";
-    case "ZodEnum":
-      return `enum(${(c?._def?.values ?? []).join("|")})`;
-    case "ZodLiteral":
-      return "literal";
-    case "ZodUnion":
-      return "union";
-    default:
-      return "string";
-  }
-}
-function walkZod(prefix, t, out) {
-  const { inner, optional, def, desc } = unwrapZod(t);
-  const shape = getShape(inner);
-  if (shape) {
-    for (const [k, v] of Object.entries(shape)) {
-      walkZod(prefix ? `${prefix}.${k}` : k, v, out);
-    }
-    return;
-  }
-  out.push({
-    path: prefix || "<root>",
-    type: zodTypeName(inner),
-    required: !optional && def === void 0,
-    default: def,
-    description: desc
-  });
-}
-function describeSchema(schema) {
-  try {
-    if (getShape(schema)) {
-      const out = [];
-      walkZod("", schema, out);
-      return { fields: out, bestEffort: false };
-    }
-  } catch {
-  }
-  try {
-    if (isValibotObject(schema)) {
-      const out = [];
-      walkValibot("", schema, out);
-      return { fields: out, bestEffort: false };
-    }
-  } catch {
-  }
-  try {
-    const j = arktypeJson(schema);
-    if (j && j.domain === "object") {
-      const out = [];
-      walkArktype(j, out);
-      return { fields: out, bestEffort: false };
-    }
-  } catch {
-  }
-  return { fields: [{ path: "<root>", type: "string", required: false, description: "GEN_BEST_EFFORT: unknown schema (Effect/others), fill manually" }], bestEffort: true };
-}
-function isValibotObject(schema) {
-  const s = schema;
-  return !!s && s.type === "object" && !!s.entries && typeof s.entries === "object";
-}
-function unwrapValibot(t) {
-  let cur = t;
-  let optional = false;
-  let def;
-  for (let i = 0; i < 10; i++) {
-    const c = cur;
-    const ty = c?.type;
-    if (ty === "optional" || ty === "nullish") {
-      optional = true;
-      if (def === void 0 && c?.default !== void 0) def = c.default;
-      if (!c?.wrapped) break;
-      cur = c.wrapped;
-      continue;
-    }
-    if (ty === "nullable") {
-      if (!c?.wrapped) break;
-      cur = c.wrapped;
-      continue;
-    }
-    if (ty === "non_optional" || ty === "non_nullable" || ty === "non_nullish") {
-      if (!c?.wrapped) break;
-      cur = c.wrapped;
-      continue;
-    }
-    break;
-  }
-  const leaf = cur;
-  if (def === void 0 && leaf?.default !== void 0) def = leaf.default;
-  return { inner: cur, optional, def, desc: leaf?.description };
-}
-function valibotTypeName(t) {
-  const c = t;
-  switch (c?.type) {
-    case "string":
-      return "string";
-    case "number":
-      return "number";
-    case "boolean":
-      return "boolean";
-    case "bigint":
-      return "bigint";
-    case "date":
-      return "date";
-    case "array":
-      return "array";
-    case "object":
-      return "object";
-    case "record":
-      return "object";
-    case "tuple":
-      return "array";
-    case "map":
-      return "object";
-    case "picklist":
-    case "enum_":
-      return `enum(${(c.options ?? []).map((o) => JSON.stringify(o)).join("|")})`;
-    case "literal":
-      return `literal(${JSON.stringify(c.literal)})`;
-    case "union":
-    case "variant":
-    case "intersect":
-      return c.type;
-    case "nan":
-      return "number";
-    default:
-      return typeof c?.type === "string" ? c.type : "string";
-  }
-}
-function walkValibot(prefix, t, out) {
-  const { inner, optional, def, desc } = unwrapValibot(t);
-  const c = inner;
-  if (c?.type === "object" && c.entries && typeof c.entries === "object") {
-    for (const [k, v] of Object.entries(c.entries)) {
-      walkValibot(prefix ? `${prefix}.${k}` : k, v, out);
-    }
-    return;
-  }
-  out.push({
-    path: prefix || "<root>",
-    type: valibotTypeName(inner),
-    required: !optional && def === void 0,
-    default: def,
-    description: desc
-  });
-}
-function arktypeJson(schema) {
-  const s = schema;
-  const j = s?.json;
-  if (typeof j === "function") {
-    try {
-      return j();
-    } catch {
-      return null;
-    }
-  }
-  return j ?? null;
-}
-function arktypeTypeName(v) {
-  if (typeof v === "string") return v;
-  if (Array.isArray(v)) return "union";
-  if (v && typeof v === "object") {
-    const o = v;
-    if ("sequence" in o) return "array";
-    if (o["domain"] === "object") return "object";
-    if (typeof o["proto"] === "string") return String(o["proto"]).toLowerCase();
-  }
-  return "string";
-}
-function walkArktype(node, out) {
-  const n = node;
-  if (n && n.domain === "object" && (Array.isArray(n.required) || Array.isArray(n.optional))) {
-    for (const r of n.required ?? []) walkArktypeValue(r.key, r.value, true, void 0, out);
-    for (const r of n.optional ?? []) walkArktypeValue(r.key, r.value, false, r.default, out);
-    return;
-  }
-  out.push({ path: "<root>", type: arktypeTypeName(node), required: true, default: void 0 });
-}
-function walkArktypeValue(path, value, required, def, out) {
-  if (value && typeof value === "object" && !Array.isArray(value) && value.domain === "object") {
-    const n = value;
-    if (Array.isArray(n.required) || Array.isArray(n.optional)) {
-      for (const r of n.required ?? []) walkArktypeValue(`${path}.${r.key}`, r.value, true, void 0, out);
-      for (const r of n.optional ?? []) walkArktypeValue(`${path}.${r.key}`, r.value, false, r.default, out);
-      return;
-    }
-  }
-  out.push({ path, type: arktypeTypeName(value), required: required && def === void 0, default: def });
-}
-function toEnvExample(fields, prefix = "") {
-  const lines = ["# Generated by typed-settings gen \u2014 edit values, keep keys"];
-  const sorted = [...fields].sort((a, b) => a.path.localeCompare(b.path));
-  for (const f of sorted) {
-    if (f.path === "<root>") {
-      lines.push(`# ${f.description ?? "no fields discovered \u2014 fill manually"}`);
-      continue;
-    }
-    const key = (prefix + f.path.replace(/\./g, "__")).toUpperCase();
-    const val = f.default !== void 0 && typeof f.default !== "object" ? String(f.default) : f.type === "number" ? "0" : f.type === "boolean" ? "false" : "";
-    const comment = f.required ? "required" : `default: ${f.default !== void 0 ? JSON.stringify(f.default) : "none"}`;
-    if (f.description) lines.push(`# ${f.description}`);
-    lines.push(`${key}=${val} # ${f.type} ${comment}`);
-  }
-  lines.push("");
-  return lines.join("\n");
-}
-function toMarkdownDocs(fields, prefix = "") {
-  const lines = ["# Configuration", "", "| Env | Path | Type | Required | Default |", "| --- | --- | --- | --- | --- |"];
-  for (const f of [...fields].sort((a, b) => a.path.localeCompare(b.path))) {
-    const env = (prefix + f.path.replace(/\./g, "__")).toUpperCase();
-    lines.push(`| \`${env}\` | \`${f.path}\` | ${f.type} | ${f.required} | ${f.default !== void 0 ? `\`${JSON.stringify(f.default)}\`` : "-"} |`);
-  }
-  lines.push("");
-  return lines.join("\n");
-}
-
-// src/cli/gen.ts
-async function runGen(args) {
-  let schema;
-  try {
-    schema = await loadSchema(args.schema, args.schemaExport);
-  } catch (e) {
-    console.error(e.message);
-    return 2;
-  }
-  const { fields, bestEffort } = describeSchema(schema);
-  if (bestEffort) console.error("GEN_BEST_EFFORT: non-Zod schema, output is a starting point \u2014 verify types manually");
-  const envText = toEnvExample(fields, args.prefix);
-  const mdText = toMarkdownDocs(fields, args.prefix);
-  const writeGuarded = (p, content) => {
-    if (existsSync(p) && !args.force) {
-      console.error(`E_EXISTS: ${p} exists \u2014 pass --force to overwrite`);
-      return 2;
-    }
-    mkdirSync(dirname(p), { recursive: true });
-    writeFileSync(p, content, { mode: 384 });
-    console.log(`gen: wrote ${p}`);
-    return 0;
-  };
-  if (args.out) {
-    const code = writeGuarded(resolve(args.out), envText);
-    if (code !== 0) return code;
-  } else {
-    console.log(envText);
-  }
-  if (args.docs) {
-    const code = writeGuarded(resolve(args.docs), mdText);
-    if (code !== 0) return code;
-  } else if (!args.out) {
-    console.log(mdText);
-  }
-  return 0;
-}
-async function runWatch(args) {
-  if (!args.schema) {
-    console.error("Usage: watch -s schema.ts -c base.yaml,.env [-- cmd...]");
-    return 2;
-  }
-  const schema = await loadSchema(args.schema, args.schemaExport).catch((e) => {
-    console.error(e.message);
-    return null;
-  });
-  if (!schema) return 2;
-  const sources = (args.config ?? ".env,env").split(",").map((s) => s.trim()).filter(Boolean);
-  let child = null;
-  const startChild = () => {
-    if (!args.cmd?.length) return;
-    stopChild();
-    child = spawn(args.cmd[0], args.cmd.slice(1), { stdio: "inherit", shell: false });
-    child.on("error", (e) => {
-      console.error(`watch: child failed to start: ${e.message}`);
-      child = null;
-    });
-    child.on("exit", () => {
-      child = null;
-    });
-  };
-  const stopChild = () => {
-    try {
-      child?.kill();
-    } catch {
-    }
-    child = null;
-  };
-  if (args.once) {
-    if (args.cmd?.length) console.error("watch: -- cmd is ignored with --once (single validation, nothing to supervise)");
-    const { settings: settings2, ConfigError: ConfigError2 } = await import('../index.js');
-    try {
-      settings2({ schema, sources: sources.length ? sources : [".env", "env"], unknownKeys: args.strict ? "reject" : "strip", expand: args.expand ?? true, arrayStrategy: args.array ?? "replace", prefix: args.prefix });
-      console.log("OK: config valid");
-      return 0;
-    } catch (e) {
-      console.error(e.message);
-      return e instanceof ConfigError2 ? 1 : 2;
-    }
-  }
-  const sub = watchSettings(
-    // NOTE: no `env` override — inherit process.env exactly like --once/check do.
-    { schema, sources: sources.length ? sources : [".env", "env"], unknownKeys: args.strict ? "reject" : "strip", expand: args.expand ?? true, arrayStrategy: args.array ?? "replace", prefix: args.prefix },
-    {
-      onUpdate: (cfg, changed) => {
-        console.log(`reload: ok changed=[${changed.join(",")}]`);
-        if (args.cmd?.length) startChild();
-      },
-      onError: (e) => {
-        console.error(`reload: invalid, kept old
-${e.message}`);
-        if (args.exitOnError) {
-          void sub.dispose().then(() => {
-            stopChild();
-            process.exitCode = 1;
-          });
-        }
-      }
-    }
-  );
-  startChild();
-  const shutdown = () => {
-    void sub.dispose().then(() => {
-      stopChild();
-    });
-  };
-  process.once("SIGINT", shutdown);
-  process.once("SIGTERM", shutdown);
-  await new Promise((resolve4) => {
-    const t = setInterval(() => {
-      if ((process.exitCode ?? 0) !== 0) {
-        clearInterval(t);
-        resolve4();
-      }
-    }, 100);
-    process.once("SIGINT", () => {
-      clearInterval(t);
-      resolve4();
-    });
-    process.once("SIGTERM", () => {
-      clearInterval(t);
-      resolve4();
-    });
-  });
-  return Number(process.exitCode ?? 0);
-}
-
-// src/cli/main.ts
-async function main(argv = process.argv.slice(2)) {
-  const [cmd, ...rest] = argv;
-  if (!cmd || cmd === "--help" || cmd === "-h") {
-    console.log(`typed-settings <check|init|gen|watch>
-
-check -s schema.ts -c base.yaml,.env [--strict] [--no-expand] [--array replace|concat|mergeIndex] [--format human|json]
-init --lib zod|valibot|arktype|yup|joi --format yaml|toml|env [--force|--dry-run|--check]
-gen --schema src/config.ts --out .env.example --docs CONFIG.md
-watch -s schema.ts -c base.yaml --once [--exit-on-error] [-- cmd...]`);
-    return 0;
-  }
-  try {
-    if (cmd === "check") {
-      const { values } = parseArgs({
-        args: rest,
-        // allowNegative enables the advertised `--no-expand` negation flag.
-        allowNegative: true,
-        options: {
-          schema: { type: "string", short: "s" },
-          config: { type: "string", short: "c" },
-          strict: { type: "boolean", default: false },
-          expand: { type: "boolean", default: true },
-          array: { type: "string", default: "replace" },
-          format: { type: "string", default: "human" },
-          "schema-export": { type: "string" },
-          prefix: { type: "string" }
-        }
-      });
-      if (!values.schema) {
-        console.error("Usage: check -s schema.ts -c base.yaml,.env");
-        return 2;
-      }
-      if (values.array !== void 0 && !["replace", "concat", "mergeIndex"].includes(values.array)) {
-        console.error(`E_USAGE: --array must be replace|concat|mergeIndex (got ${JSON.stringify(values.array)})`);
-        return 2;
-      }
-      if (values.format !== void 0 && !["human", "json"].includes(values.format)) {
-        console.error(`E_USAGE: --format must be human|json (got ${JSON.stringify(values.format)})`);
-        return 2;
-      }
-      return await runCheck({
-        schema: values.schema,
-        config: values.config,
-        strict: values.strict,
-        expand: values.expand,
-        array: values.array,
-        format: values.format,
-        schemaExport: values["schema-export"],
-        prefix: values.prefix
-      });
-    }
-    if (cmd === "init") {
-      const { values } = parseArgs({
-        args: rest,
-        options: {
-          lib: { type: "string", default: "zod" },
-          format: { type: "string", default: "env" },
-          dir: { type: "string", default: "." },
-          force: { type: "boolean", default: false },
-          "dry-run": { type: "boolean", default: false },
-          check: { type: "boolean", default: false }
-        }
-      });
-      return await runInit({
-        lib: values.lib,
-        format: values.format,
-        dir: values.dir,
-        force: values.force,
-        dryRun: values["dry-run"],
-        check: values.check
-      });
-    }
-    if (cmd === "gen") {
-      const { values } = parseArgs({
-        args: rest,
-        options: {
-          schema: { type: "string" },
-          "schema-export": { type: "string" },
-          out: { type: "string" },
-          docs: { type: "string" },
-          prefix: { type: "string" },
-          force: { type: "boolean", default: false }
-        }
-      });
-      if (!values.schema) {
-        console.error("Usage: gen --schema src/config.ts --out .env.example --docs CONFIG.md");
-        return 2;
-      }
-      return await runGen({
-        schema: values.schema,
-        schemaExport: values["schema-export"],
-        out: values.out,
-        docs: values.docs,
-        prefix: values.prefix,
-        force: values.force
-      });
-    }
-    if (cmd === "watch") {
-      const dashIdx = rest.indexOf("--");
-      const watchArgs = dashIdx === -1 ? rest : rest.slice(0, dashIdx);
-      const childCmd = dashIdx === -1 ? [] : rest.slice(dashIdx + 1);
-      const { values } = parseArgs({
-        args: watchArgs,
-        allowNegative: true,
-        options: {
-          schema: { type: "string", short: "s" },
-          config: { type: "string", short: "c" },
-          strict: { type: "boolean", default: false },
-          expand: { type: "boolean", default: true },
-          array: { type: "string", default: "replace" },
-          once: { type: "boolean", default: false },
-          "exit-on-error": { type: "boolean", default: false },
-          "schema-export": { type: "string" },
-          prefix: { type: "string" }
-        }
-      });
-      if (values.array !== void 0 && !["replace", "concat", "mergeIndex"].includes(values.array)) {
-        console.error(`E_USAGE: --array must be replace|concat|mergeIndex (got ${JSON.stringify(values.array)})`);
-        return 2;
-      }
-      return await runWatch({
-        schema: values.schema,
-        config: values.config,
-        schemaExport: values["schema-export"],
-        strict: values.strict,
-        expand: values.expand,
-        array: values.array,
-        prefix: values.prefix,
-        once: values.once,
-        exitOnError: values["exit-on-error"],
-        cmd: childCmd.length ? childCmd : void 0
-      });
-    }
-    console.error(`unknown command: ${cmd}`);
-    return 2;
-  } catch (e) {
-    console.error(e.message);
-    return 2;
-  }
-}
-var isDirect = process.argv[1]?.endsWith("main.js") || process.argv[1]?.endsWith("main.cjs");
-if (isDirect) {
-  main().then((code) => {
-    process.exitCode = code;
-  });
-}
-
-export { main };
+`},x={env:`# APP_PORT=3000
+APP_PORT=3000
+`,yaml:`# config.yaml
+port: 3000
+`,toml:`# config.toml
+port = 3000
+`};async function T(n){let e=n.lib??"zod",o=n.format??"env";if(!Object.hasOwn(w,e))return console.error(`E_USAGE: --lib must be ${Object.keys(w).join("|")} (got ${JSON.stringify(e)})`),2;if(!Object.hasOwn(x,o))return console.error(`E_USAGE: --format must be ${Object.keys(x).join("|")} (got ${JSON.stringify(o)})`),2;let t=resolve(n.dir??"."),i=w[e],c=o==="env"?".env.example":`config.${o}`,r=[{path:join(t,"src","settings.ts"),content:i},{path:join(t,c),content:x[o]}],a=f=>{try{return readFileSync(f,"utf8")}catch{return null}},l=r.filter(f=>a(f.path)!==f.content);if(n.dryRun||n.check){for(let f of r){let m=a(f.path);console.log(`${m===null?"create":m===f.content?"exists":"overwrite"} ${f.path}`);}return n.check&&l.length>0?2:0}let s=0;for(let f of r){if(a(f.path)===f.content){continue}if(existsSync(f.path)&&!n.force){continue}mkdirSync(dirname(f.path),{recursive:true}),writeFileSync(f.path,f.content,{mode:384});try{chmodSync(f.path,384);}catch{}s++;}return console.log(`init: ${e} + ${o} scaffolding ${s>0?`written (${s} file${s===1?"":"s"})`:"already up to date"}`),o==="env"&&s>0&&console.log("hint: copy .env.example to .env and fill in real values (example files are never loaded)"),0}function I(n){let e=n;if(e&&typeof e.shape=="object"&&e.shape!==null)return e.shape;if(e&&typeof e.shape=="function")try{return e.shape()}catch{return null}let o=e?._def?.shape;if(typeof o=="function")try{return o()}catch{return null}return o&&typeof o=="object"?o:null}function X(n){let e=n,o=false,t;for(let c=0;c<10;c++){let r=e,a=r?.type??r?.def?.type;if(a==="optional"){if(o=true,e=r?.def?.innerType??(typeof r?.unwrap=="function"?g(r.unwrap):void 0)??e,e===n)break;n=e;continue}if(a==="nullable"){if(e=r?.def?.innerType??(typeof r?.unwrap=="function"?g(r.unwrap):void 0)??e,e===n)break;n=e;continue}if(a==="catch"||a==="prefault"||a==="pipe"||a==="brand"||a==="readonly"){let s=r?.def?.innerType??(typeof r?.unwrap=="function"?g(r.unwrap):void 0);if(s===void 0||s===e)break;e=s,n=e;continue}if(a==="default"){let s=r?.def?.defaultValue;t===void 0&&(t=typeof s=="function"?O(s):s),o=true,e=r?.def?.innerType??(typeof r?.unwrap=="function"?g(r.unwrap):void 0)??e;continue}if(a==="nonoptional"||a==="success"){let s=r?.def?.innerType;if(s===void 0||s===e)break;e=s,n=e;continue}let l=r?._def?.typeName;if(l==="ZodOptional"){o=true,e=r?._def?.innerType;continue}if(l==="ZodNullable"){e=r?._def?.innerType;continue}if(l==="ZodDefault"){if(t===void 0){let s=r?._def?.defaultValue;t=typeof s=="function"?O(s):s;}o=true,e=r?._def?.innerType;continue}if(l==="ZodReadonly"){e=r?._def?.innerType;continue}break}let i=e?.description??e?.def?.description??n?.description;return {inner:e,optional:o,def:t,desc:i}}function g(n){try{return n()}catch{return}}function O(n){try{return n()}catch{return}}function Y(n){let e=n;return Array.isArray(e?.values)?e.values:e?.entries&&typeof e.entries=="object"?Object.values(e.entries):[]}function H(n){return X(n)}function Q(n){let e=n,o=e?.type??e?.def?.type;if(o)switch(o){case "string":return "string";case "number":return "number";case "boolean":return "boolean";case "array":return "array";case "object":return "object";case "enum":return `enum(${Y(e?.def).join("|")})`;case "literal":return "literal";case "union":return "union";default:return o}switch(e?._def?.typeName??"unknown"){case "ZodString":return "string";case "ZodNumber":return "number";case "ZodBoolean":return "boolean";case "ZodBigInt":return "bigint";case "ZodDate":return "date";case "ZodNaN":return "number";case "ZodArray":return "array";case "ZodObject":return "object";case "ZodEnum":return `enum(${(e?._def?.values??[]).join("|")})`;case "ZodLiteral":return "literal";case "ZodUnion":return "union";default:return "string"}}function F(n,e,o,t=false){let{inner:i,optional:c,def:r,desc:a}=H(e),l=t||c,s=I(i);if(s){for(let[p,f]of Object.entries(s))F(n?`${n}.${p}`:p,f,o,l);return}o.push({path:n||"<root>",type:Q(i),required:!l&&r===void 0,default:r,description:a});}function G(n){try{if(I(n)){let e=[];return F("",n,e),{fields:e,bestEffort:!1}}}catch{}try{if(ee(n)){let e=[];return P("",n,e),{fields:e,bestEffort:!1}}}catch{}try{let e=re(n);if(e&&e.domain==="object"){let o=[];return oe(e,o),{fields:o,bestEffort:!1}}}catch{}return {fields:[{path:"<root>",type:"string",required:false,description:"GEN_BEST_EFFORT: unknown schema (Effect/others), fill manually"}],bestEffort:true}}function ee(n){let e=n;return !!e&&e.type==="object"&&!!e.entries&&typeof e.entries=="object"}function ne(n){let e=n,o=false,t;for(let c=0;c<10;c++){let r=e,a=r?.type;if(a==="optional"||a==="nullish"){if(o=true,t===void 0&&r?.default!==void 0&&(t=r.default),!r?.wrapped)break;e=r.wrapped;continue}if(a==="nullable"){if(!r?.wrapped)break;e=r.wrapped;continue}if(a==="non_optional"||a==="non_nullable"||a==="non_nullish"){if(!r?.wrapped)break;e=r.wrapped;continue}break}let i=e;return t===void 0&&i?.default!==void 0&&(t=i.default),{inner:e,optional:o,def:t,desc:i?.description}}function te(n){let e=n;switch(e?.type){case "string":return "string";case "number":return "number";case "boolean":return "boolean";case "bigint":return "bigint";case "date":return "date";case "array":return "array";case "object":return "object";case "record":return "object";case "tuple":return "array";case "map":return "object";case "picklist":case "enum_":return `enum(${(e.options??[]).map(o=>JSON.stringify(o)).join("|")})`;case "literal":return `literal(${JSON.stringify(e.literal)})`;case "union":case "variant":case "intersect":return e.type;case "nan":return "number";default:return typeof e?.type=="string"?e.type:"string"}}function P(n,e,o,t=false){let{inner:i,optional:c,def:r,desc:a}=ne(e),l=t||c,s=i;if(s?.type==="object"&&s.entries&&typeof s.entries=="object"){for(let[p,f]of Object.entries(s.entries))P(n?`${n}.${p}`:p,f,o,l);return}o.push({path:n||"<root>",type:te(i),required:!l&&r===void 0,default:r,description:a});}function re(n){let o=n?.json;if(typeof o=="function")try{return o()}catch{return null}return o??null}function C(n){if(typeof n=="string")return n;if(Array.isArray(n))return "union";if(n&&typeof n=="object"){let e=n;if("sequence"in e)return "array";if(e.domain==="object")return "object";if(typeof e.proto=="string")return String(e.proto).toLowerCase()}return "string"}function oe(n,e){let o=n;if(o&&o.domain==="object"&&(Array.isArray(o.required)||Array.isArray(o.optional))){for(let t of o.required??[])b(t.key,t.value,true,void 0,e);for(let t of o.optional??[])b(t.key,t.value,false,t.default,e);return}e.push({path:"<root>",type:C(n),required:true,default:void 0});}function b(n,e,o,t,i){if(e&&typeof e=="object"&&!Array.isArray(e)&&e.domain==="object"){let c=e;if(Array.isArray(c.required)||Array.isArray(c.optional)){for(let r of c.required??[])b(`${n}.${r.key}`,r.value,true,void 0,i);for(let r of c.optional??[])b(`${n}.${r.key}`,r.value,false,r.default,i);return}}i.push({path:n,type:C(e),required:o&&t===void 0,default:t});}function R(n,e){return ((n&&!n.endsWith("_")?`${n}_`:n)+e.replace(/\./g,"__")).toUpperCase().replace(/[^A-Z0-9_]/g,"_")}function D(n,e=""){let o=["# Generated by typed-settings gen \u2014 edit values, keep keys"],t=[...n].sort((i,c)=>i.path.localeCompare(c.path));for(let i of t){if(i.path==="<root>"){o.push(`# ${i.description??"no fields discovered \u2014 fill manually"}`);continue}let c=R(e,i.path),r=i.default!==void 0&&typeof i.default!="object"?String(i.default):i.type==="number"?"0":i.type==="boolean"?"false":"",a=i.required?"required":`default: ${i.default!==void 0?JSON.stringify(i.default):"none"}`;i.description&&o.push(`# ${i.description}`),o.push(`${c}=${r} # ${i.type} ${a}`);}return o.push(""),o.join(`
+`)}function Z(n,e=""){let o=["# Configuration","","| Env | Path | Type | Required | Default |","| --- | --- | --- | --- | --- |"];for(let t of [...n].sort((i,c)=>i.path.localeCompare(c.path))){if(t.path==="<root>")continue;let i=R(e,t.path);o.push(`| \`${i}\` | \`${t.path}\` | ${t.type} | ${t.required} | ${t.default!==void 0?`\`${JSON.stringify(t.default)}\``:"-"} |`);}return o.push(""),o.join(`
+`)}function le(n){try{return lstatSync(n).isSymbolicLink()}catch{return  false}}async function U(n){let e;try{e=await a(n.schema,n.schemaExport);}catch(s){return console.error(s.message),2}let{fields:o,bestEffort:t}=G(e);t&&console.error("GEN_BEST_EFFORT: non-Zod schema, output is a starting point \u2014 verify types manually");let i=D(o,n.prefix),c=Z(o,n.prefix),r=n.out?resolve(n.out):null,a$1=n.docs?resolve(n.docs):null;for(let s of [r,a$1])if(s){if(le(s))return console.error(`E_SYMLINK: ${s} is a symlink \u2014 refusing to write through it`),2;if(existsSync(s)&&!n.force)return console.error(`E_EXISTS: ${s} exists \u2014 pass --force to overwrite`),2}let l=(s,p)=>{mkdirSync(dirname(s),{recursive:true}),writeFileSync(s,p,{mode:384});try{chmodSync(s,384);}catch{}console.log(`gen: wrote ${s}`);};return r?l(r,i):console.log(i),a$1?l(a$1,c):r||(console.log("# ---- CONFIG.md below ----"),console.log(c)),0}async function V(n){if(!n.schema)return console.error("Usage: watch -s schema.ts -c base.yaml,.env [-- cmd...]"),2;let e=await a(n.schema,n.schemaExport).catch(u=>(console.error(u.message),null));if(!e)return 2;let o=(n.config??".env,env").split(",").map(u=>u.trim()).filter(Boolean),t=null,i=()=>{if(!n.cmd?.length)return;c();let u=spawn(n.cmd[0],n.cmd.slice(1),{stdio:"inherit",shell:false});t=u,u.on("error",d=>{console.error(`watch: child failed to start: ${d.message}`),t===u&&(t=null);}),u.on("exit",(d,$)=>{t===u&&(t=null,typeof d=="number"&&d!==0?(console.error(`watch: child exited with code ${d}`),n.exitOnChildError&&p(d)):typeof $=="string"&&(console.error(`watch: child exited on signal ${$}`),n.exitOnChildError&&p(1)));});},c=()=>{let u=t;if(t=null,!u)return;try{u.kill();}catch{}setTimeout(()=>{try{u.kill("SIGKILL");}catch{}},2e3).unref();};if(n.once){n.cmd?.length&&console.error("watch: -- cmd is ignored with --once (single validation, nothing to supervise)");let{runCheck:u}=await import('../check-XVFZEVNV.js');return u({schema:n.schema,config:n.config,schemaExport:n.schemaExport,strict:n.strict,expand:n.expand,array:n.array,prefix:n.prefix,format:n.format,secretKeys:n.secretKeys})}let r=d({schema:e,sources:o.length?o:[".env","env"],unknownKeys:n.strict?"reject":"strip",expand:n.expand??true,arrayStrategy:n.array??"replace",prefix:n.prefix},{onUpdate:(u,d)=>{d.length!==0&&(console.log(`reload: ok changed=[${d.join(",")}]`),n.cmd?.length&&i());},onError:u=>{console.error(`reload: invalid, kept old
+${u.message}`),n.exitOnError&&r.dispose().then(()=>{c(),process.exitCode=1,s(1);});}}),a$1,l=new Promise(u=>{a$1=u;}),s=u=>{process.removeListener("SIGINT",j),process.removeListener("SIGTERM",S),process.removeListener("SIGINT",y),process.removeListener("SIGTERM",y),clearInterval(E),a$1(u);},p=u=>{r.dispose().then(()=>{c(),process.exitCode=u,s(u);});};i();let f=null,m=new Promise(u=>{f=u;}),v=()=>{r.dispose().then(()=>{c(),f();});},E=setInterval(()=>{(process.exitCode??0)!==0&&s(Number(process.exitCode));},100),y=()=>{clearInterval(E),m.then(()=>s(Number(process.exitCode??0)));};function j(){v();}function S(){v();}return process.once("SIGINT",j),process.once("SIGTERM",S),process.once("SIGINT",y),process.once("SIGTERM",y),l}async function de(n=process.argv.slice(2)){let[e,...o]=n;if(!e||e==="--help"||e==="-h")return console.log(`typed-settings <check|init|gen|watch>
+
+check -s schema.ts -c base.yaml,.env [--strict] [--no-expand] [--array replace|concat|mergeIndex] [--format human|json] [--schema-export NAME] [--prefix PFX] [--secret-keys a,b]
+init --lib zod|valibot|arktype|yup|joi --format yaml|toml|env [--dir .] [--force|--dry-run|--check]
+gen --schema src/config.ts --out .env.example --docs CONFIG.md [--schema-export NAME] [--prefix PFX] [--force]
+watch -s schema.ts -c base.yaml [--strict] [--no-expand] [--array ...] [--format human|json] [--schema-export NAME] [--prefix PFX] [--secret-keys a,b] [--once] [--exit-on-error] [--exit-on-child-error] [-- cmd...]`),0;try{if(e==="check"){let{values:t}=parseArgs({args:o,allowNegative:!0,options:{schema:{type:"string",short:"s"},config:{type:"string",short:"c"},strict:{type:"boolean",default:!1},expand:{type:"boolean",default:!0},array:{type:"string",default:"replace"},format:{type:"string",default:"human"},"schema-export":{type:"string"},prefix:{type:"string"},"secret-keys":{type:"string"}}});return t.schema?t.array!==void 0&&!["replace","concat","mergeIndex"].includes(t.array)?(console.error(`E_USAGE: --array must be replace|concat|mergeIndex (got ${JSON.stringify(t.array)})`),2):t.format!==void 0&&!["human","json"].includes(t.format)?(console.error(`E_USAGE: --format must be human|json (got ${JSON.stringify(t.format)})`),2):await b$1({schema:t.schema,config:t.config,strict:t.strict,expand:t.expand,array:t.array,format:t.format,schemaExport:t["schema-export"],prefix:t.prefix,secretKeys:t["secret-keys"]?.split(",").map(i=>i.trim()).filter(Boolean)}):(console.error("E_USAGE: check -s schema.ts -c base.yaml,.env"),2)}if(e==="init"){let{values:t}=parseArgs({args:o,options:{lib:{type:"string",default:"zod"},format:{type:"string",default:"env"},dir:{type:"string",default:"."},force:{type:"boolean",default:!1},"dry-run":{type:"boolean",default:!1},check:{type:"boolean",default:!1}}});return await T({lib:t.lib,format:t.format,dir:t.dir,force:t.force,dryRun:t["dry-run"],check:t.check})}if(e==="gen"){let{values:t}=parseArgs({args:o,options:{schema:{type:"string",short:"s"},"schema-export":{type:"string"},out:{type:"string"},docs:{type:"string"},prefix:{type:"string"},force:{type:"boolean",default:!1}}});return t.schema?await U({schema:t.schema,schemaExport:t["schema-export"],out:t.out,docs:t.docs,prefix:t.prefix,force:t.force}):(console.error("E_USAGE: gen --schema src/config.ts --out .env.example --docs CONFIG.md"),2)}if(e==="watch"){let t=o.indexOf("--"),i=t===-1?o:o.slice(0,t),c=t===-1?[]:o.slice(t+1),{values:r}=parseArgs({args:i,allowNegative:!0,options:{schema:{type:"string",short:"s"},config:{type:"string",short:"c"},strict:{type:"boolean",default:!1},expand:{type:"boolean",default:!0},array:{type:"string",default:"replace"},format:{type:"string",default:"human"},once:{type:"boolean",default:!1},"exit-on-error":{type:"boolean",default:!1},"exit-on-child-error":{type:"boolean",default:!1},"schema-export":{type:"string"},prefix:{type:"string"},"secret-keys":{type:"string"}}});return r.array!==void 0&&!["replace","concat","mergeIndex"].includes(r.array)?(console.error(`E_USAGE: --array must be replace|concat|mergeIndex (got ${JSON.stringify(r.array)})`),2):r.format!==void 0&&!["human","json"].includes(r.format)?(console.error(`E_USAGE: --format must be human|json (got ${JSON.stringify(r.format)})`),2):await V({schema:r.schema,config:r.config,schemaExport:r["schema-export"],strict:r.strict,expand:r.expand,array:r.array,format:r.format,prefix:r.prefix,secretKeys:r["secret-keys"]?.split(",").map(a=>a.trim()).filter(Boolean),once:r.once,exitOnError:r["exit-on-error"],exitOnChildError:r["exit-on-child-error"],cmd:c.length?c:void 0})}return console.error(`E_USAGE: unknown command: ${e}`),2}catch(t){return console.error(`E_USAGE: ${t.message}`),2}}var me=process.argv[1]?.endsWith("main.js")||process.argv[1]?.endsWith("main.cjs");me&&de().then(n=>{process.exitCode=n;}).catch(n=>{console.error(n?.message??n),process.exitCode=2;});export{de as main};