traced-config 0.0.0 → 0.2.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import type { CliValue } from './types.js';
+export declare function parseCli(argv: string[]): Map<string, CliValue>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CA4B9D"}

package/dist/cli.js

@@ -0,0 +1,25 @@
+export function parseCli(argv) {
+    const parsed = new Map();
+    for (let index = 2; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token || !token.startsWith('--')) {
+            continue;
+        }
+        const equalIndex = token.indexOf('=');
+        if (equalIndex !== -1) {
+            const name = token.slice(0, equalIndex);
+            const value = token.slice(equalIndex + 1);
+            parsed.set(name, { value, source: name });
+            continue;
+        }
+        const next = argv[index + 1];
+        if (typeof next === 'string' && !next.startsWith('--')) {
+            parsed.set(token, { value: next, source: token });
+            index += 1;
+            continue;
+        }
+        parsed.set(token, { value: 'true', source: token });
+    }
+    return parsed;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { tracedConfig } from './traced-config.js';
+export type { InferSchemaValues, Origin, SchemaEntry, SchemaShape, TracedConfigApi, TracedConfigOptions, TracedValue, ValidateError, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { tracedConfig } from './traced-config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/naming.d.ts

@@ -0,0 +1,13 @@
+export declare function toScreamingSnake(input: string): string;
+export declare function toKebab(input: string): string;
+declare const ENV_NAME_BUILDERS: {
+    readonly SCREAMING_SNAKE: typeof toScreamingSnake;
+};
+declare const ARG_NAME_BUILDERS: {
+    readonly kebab: (key: string) => string;
+};
+export declare function buildDefaultEnvName(key: string, envStyle: keyof typeof ENV_NAME_BUILDERS): string;
+export declare function buildDefaultArgName(key: string, argStyle: keyof typeof ARG_NAME_BUILDERS): string;
+export declare function normalizeArgName(argName: string): string;
+export {};
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,QAAA,MAAM,iBAAiB;;CAEb,CAAC;AAEX,QAAA,MAAM,iBAAiB;0BACR,MAAM;CACX,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,iBAAiB,GAAG,MAAM,CAEjG;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,iBAAiB,GAAG,MAAM,CAEjG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/naming.js

@@ -0,0 +1,30 @@
+export function toScreamingSnake(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')
+        .replace(/[\s.-]+/g, '_')
+        .toUpperCase();
+}
+export function toKebab(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .replace(/[\s._]+/g, '-')
+        .toLowerCase();
+}
+const ENV_NAME_BUILDERS = {
+    SCREAMING_SNAKE: toScreamingSnake,
+};
+const ARG_NAME_BUILDERS = {
+    kebab: (key) => `--${toKebab(key)}`,
+};
+export function buildDefaultEnvName(key, envStyle) {
+    return ENV_NAME_BUILDERS[envStyle](key);
+}
+export function buildDefaultArgName(key, argStyle) {
+    return ARG_NAME_BUILDERS[argStyle](key);
+}
+export function normalizeArgName(argName) {
+    return argName.startsWith('--') ? argName : `--${argName}`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK;SACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,iBAAiB,GAAG;IACxB,eAAe,EAAE,gBAAgB;CACzB,CAAC;AAEX,MAAM,iBAAiB,GAAG;IACxB,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE;CACnC,CAAC;AAEX,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,QAAwC;IACvF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,QAAwC;IACvF,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;AAC7D,CAAC"}

package/dist/traced-config.d.ts

@@ -0,0 +1,3 @@
+import type { InferSchemaValues, SchemaShape, TracedConfigApi, TracedConfigOptions } from './types.js';
+export declare function tracedConfig<TSchema extends SchemaShape = {}>(options?: TracedConfigOptions<TSchema>): TracedConfigApi<InferSchemaValues<TSchema>>;
+//# sourceMappingURL=traced-config.d.ts.map

package/dist/traced-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-config.d.ts","sourceRoot":"","sources":["../src/traced-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAKV,iBAAiB,EAGjB,WAAW,EAEX,eAAe,EACf,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAWpB,wBAAgB,YAAY,CAAC,OAAO,SAAS,WAAW,GAAG,EAAE,EAC3D,OAAO,GAAE,mBAAmB,CAAC,OAAO,CAAM,GACzC,eAAe,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CA+R7C"}

package/dist/traced-config.js

@@ -0,0 +1,254 @@
+import { access, readFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { parseCli } from './cli.js';
+import { buildDefaultArgName, buildDefaultEnvName, normalizeArgName } from './naming.js';
+import { createDefaultParsers, flattenFileEntries, getFileExtension, isMissingFileError, isPlainObject } from './utils.js';
+import { coerceInputValue, isBuiltinStringFormat, validateFormatValue } from './validation.js';
+const DEFAULT_SOURCES = {
+    global: true,
+    local: true,
+    env: true,
+    cli: false,
+};
+export function tracedConfig(options = {}) {
+    const envStyle = options.envStyle ?? 'SCREAMING_SNAKE';
+    const argStyle = options.argStyle ?? 'kebab';
+    const schema = new Map();
+    const globalValues = new Map();
+    const localValues = new Map();
+    const unknownFileKeys = [];
+    const parsers = createDefaultParsers();
+    const customFormats = new Map();
+    const cachedCliValues = parseCli(process.argv);
+    function assertKnownKey(key) {
+        const entry = schema.get(key);
+        if (!entry) {
+            throw new Error(`Schema key '${key}' is not defined`);
+        }
+        return entry;
+    }
+    function findPrefixCollision(key, keys) {
+        for (const existingKey of keys) {
+            if (key.startsWith(`${existingKey}.`) || existingKey.startsWith(`${key}.`)) {
+                return existingKey;
+            }
+        }
+        return null;
+    }
+    function resolveKey(key) {
+        const entry = assertKnownKey(key);
+        let traced = {
+            value: entry.default,
+            source: null,
+            origin: 'default',
+        };
+        if (entry.sources.global) {
+            const fromGlobal = globalValues.get(key);
+            if (fromGlobal) {
+                traced = { value: fromGlobal.value, source: fromGlobal.source, origin: 'global' };
+            }
+        }
+        if (entry.sources.local) {
+            const fromLocal = localValues.get(key);
+            if (fromLocal) {
+                traced = { value: fromLocal.value, source: fromLocal.source, origin: 'local' };
+            }
+        }
+        if (entry.sources.env) {
+            const envValue = process.env[entry.env];
+            if (envValue !== undefined) {
+                traced = {
+                    value: coerceInputValue(envValue, entry),
+                    source: entry.env,
+                    origin: 'env',
+                };
+            }
+        }
+        if (entry.sources.cli) {
+            const cliValue = cachedCliValues.get(entry.arg);
+            if (cliValue) {
+                traced = {
+                    value: coerceInputValue(cliValue.value, entry),
+                    source: cliValue.source,
+                    origin: 'cli',
+                };
+            }
+        }
+        return traced;
+    }
+    function addSchema(next) {
+        const pendingEntries = [];
+        for (const [key, rawEntry] of Object.entries(next)) {
+            if (schema.has(key)) {
+                throw new Error(`Schema key '${key}' is already defined`);
+            }
+            const collidedKey = findPrefixCollision(key, schema.keys()) ?? findPrefixCollision(key, pendingEntries.map(([pendingKey]) => pendingKey));
+            if (collidedKey) {
+                throw new Error(`Schema key '${key}' has a prefix collision with existing key '${collidedKey}'`);
+            }
+            if (typeof rawEntry.doc !== 'string' || rawEntry.doc.trim().length === 0) {
+                throw new Error(`Schema key '${key}' must define a non-empty doc string`);
+            }
+            const env = rawEntry.env ?? buildDefaultEnvName(key, envStyle);
+            const arg = rawEntry.arg ?? buildDefaultArgName(key, argStyle);
+            const sources = {
+                ...DEFAULT_SOURCES,
+                ...(rawEntry.sources ?? {}),
+            };
+            pendingEntries.push([key, {
+                    default: rawEntry.default,
+                    doc: rawEntry.doc,
+                    format: rawEntry.format,
+                    env,
+                    arg: normalizeArgName(arg),
+                    sources,
+                }]);
+        }
+        for (const [key, entry] of pendingEntries) {
+            schema.set(key, entry);
+        }
+        return api;
+    }
+    function addParser(extension, parser) {
+        if (typeof extension !== 'string' || extension.trim().length === 0) {
+            throw new Error('Parser extension must be a non-empty string');
+        }
+        if (typeof parser !== 'function') {
+            throw new Error('Parser must be a function');
+        }
+        const normalized = extension.replace(/^\./, '').toLowerCase();
+        parsers.set(normalized, parser);
+    }
+    function addFormat(name, validator) {
+        if (typeof name !== 'string' || name.trim().length === 0) {
+            throw new Error('Format name must be a non-empty string');
+        }
+        if (typeof validator !== 'function') {
+            throw new Error('Format validator must be a function');
+        }
+        customFormats.set(name, validator);
+    }
+    async function loadFile(entries) {
+        for (const entry of entries) {
+            if (!isPlainObject(entry) || typeof entry.path !== 'string' || (entry.label !== 'global' && entry.label !== 'local')) {
+                throw new Error('loadFile entries must be objects with { path, label } where label is global or local');
+            }
+            try {
+                await access(entry.path, constants.F_OK);
+            }
+            catch (error) {
+                if (isMissingFileError(error)) {
+                    continue;
+                }
+                throw error;
+            }
+            const content = await readFile(entry.path, 'utf8');
+            const extension = getFileExtension(entry.path);
+            const parser = parsers.get(extension);
+            if (!parser) {
+                throw new Error(`Unsupported file type for path: ${entry.path}`);
+            }
+            let parsedRaw;
+            try {
+                parsedRaw = parser(content);
+            }
+            catch {
+                throw new Error(`Failed to parse config file '${entry.path}' (label: ${entry.label})`);
+            }
+            const parsedEntries = isPlainObject(parsedRaw) ? flattenFileEntries(parsedRaw, new Set(schema.keys())) : [];
+            for (const [key, value] of parsedEntries) {
+                if (!schema.has(key)) {
+                    unknownFileKeys.push({ key, source: entry.path, origin: entry.label });
+                    continue;
+                }
+                if (entry.label === 'global') {
+                    globalValues.set(key, { value, source: entry.path });
+                }
+                else {
+                    localValues.set(key, { value, source: entry.path });
+                }
+            }
+        }
+    }
+    function get(key) {
+        return resolveKey(key).value;
+    }
+    function getSource(key) {
+        return resolveKey(key).source;
+    }
+    function getOrigin(key) {
+        return resolveKey(key).origin;
+    }
+    function getTraced(key) {
+        return resolveKey(key);
+    }
+    function getSchema() {
+        const snapshot = {};
+        for (const [key, entry] of schema.entries()) {
+            snapshot[key] = {
+                default: entry.default,
+                doc: entry.doc,
+                format: entry.format,
+                env: entry.env,
+                arg: entry.arg.replace(/^--/u, ''),
+                sources: { ...entry.sources },
+            };
+        }
+        return snapshot;
+    }
+    function validate(validateOptions = {}) {
+        const errors = [];
+        for (const [key, entry] of schema.entries()) {
+            const resolved = resolveKey(key);
+            let error = validateFormatValue(key, resolved.value, entry.format);
+            if (!error && typeof entry.format === 'string') {
+                const validator = customFormats.get(entry.format);
+                if (validator && !validator(resolved.value)) {
+                    error = {
+                        key,
+                        value: resolved.value,
+                        message: `${entry.format} validation failed`,
+                    };
+                }
+                else if (!validator && !isBuiltinStringFormat(entry.format)) {
+                    error = {
+                        key,
+                        value: resolved.value,
+                        message: `Unknown format '${entry.format}'`,
+                    };
+                }
+            }
+            if (error) {
+                errors.push(error);
+            }
+        }
+        if (validateOptions.strict) {
+            for (const unknown of unknownFileKeys) {
+                errors.push({
+                    key: unknown.key,
+                    source: unknown.source,
+                    origin: unknown.origin,
+                    message: `Unknown key '${unknown.key}'`,
+                });
+            }
+        }
+        return errors;
+    }
+    const api = {
+        addSchema,
+        addParser,
+        addFormat,
+        loadFile,
+        get,
+        getSource,
+        getOrigin,
+        getTraced,
+        getSchema,
+        validate,
+    };
+    if (options.schema) {
+        addSchema(options.schema);
+    }
+    return api;
+}
+//# sourceMappingURL=traced-config.js.map

package/dist/traced-config.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export type Origin = 'default' | 'global' | 'local' | 'env' | 'cli';
+export type FileLabel = 'global' | 'local';
+export type SourceToggles = {
+    global: boolean;
+    local: boolean;
+    env: boolean;
+    cli: boolean;
+};
+export type SchemaEntry<TDefault> = {
+    default: TDefault;
+    doc: string;
+    format?: unknown;
+    env?: string;
+    arg?: string;
+    sources?: Partial<SourceToggles>;
+};
+export type SchemaShape = Record<string, SchemaEntry<unknown>>;
+export type InferSchemaValues<TSchema extends SchemaShape> = {
+    [K in keyof TSchema]: TSchema[K]['default'];
+};
+export type TracedValue<TValue> = {
+    value: TValue;
+    source: string | null;
+    origin: Origin;
+};
+export type ValidateError = {
+    key: string;
+    message: string;
+    value?: unknown;
+    source?: string | null;
+    origin?: string;
+};
+export type TracedConfigOptions<TSchema extends SchemaShape = {}> = {
+    envStyle?: 'SCREAMING_SNAKE';
+    argStyle?: 'kebab';
+    schema?: TSchema;
+};
+export type FileParser = (content: string) => unknown;
+export type FormatValidator = (value: unknown) => boolean;
+export type ResolvedSchemaEntry = {
+    default: unknown;
+    doc: string;
+    format?: unknown;
+    env: string;
+    arg: string;
+    sources: SourceToggles;
+};
+export type FileValueRecord = {
+    value: unknown;
+    source: string;
+};
+export type CliValue = {
+    value: string;
+    source: string;
+};
+export type UnknownKeyIssue = {
+    key: string;
+    source: string;
+    origin: FileLabel;
+};
+export type TracedConfigApi<TValues extends Record<string, unknown>> = {
+    addSchema: <TSchema extends SchemaShape>(schema: TSchema) => TracedConfigApi<TValues & InferSchemaValues<TSchema>>;
+    addParser: (extension: string, parser: FileParser) => void;
+    addFormat: (name: string, validator: FormatValidator) => void;
+    loadFile: (entries: Array<{
+        path: string;
+        label: FileLabel;
+    }>) => Promise<void>;
+    get: <TKey extends Extract<keyof TValues, string>>(key: TKey) => TValues[TKey];
+    getSource: <TKey extends Extract<keyof TValues, string>>(key: TKey) => string | null;
+    getOrigin: <TKey extends Extract<keyof TValues, string>>(key: TKey) => Origin;
+    getTraced: <TKey extends Extract<keyof TValues, string>>(key: TKey) => TracedValue<TValues[TKey]>;
+    getSchema: () => Record<string, ResolvedSchemaEntry>;
+    validate: (options?: {
+        strict?: boolean;
+    }) => ValidateError[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { FileParser } from './types.js';
+export declare function isMissingFileError(error: unknown): boolean;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function flattenFileEntries(value: Record<string, unknown>, leafKeys?: ReadonlySet<string>): Array<[string, unknown]>;
+export declare function getFileExtension(filePath: string): string;
+export declare function createDefaultParsers(): Map<string, FileParser>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwC7C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAID,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAqB,GAChD,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0E1B;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAO9D"}

package/dist/utils.js

@@ -0,0 +1,112 @@
+import YAML from 'yaml';
+function parseDotEnv(content) {
+    const parsed = {};
+    const lines = content.split(/\r?\n/u);
+    for (const [index, line] of lines.entries()) {
+        const lineNumber = index + 1;
+        const trimmed = line.trim();
+        if (trimmed.length === 0 || trimmed.startsWith('#')) {
+            continue;
+        }
+        const withoutExport = trimmed.startsWith('export ') ? trimmed.slice('export '.length) : trimmed;
+        const separatorIndex = withoutExport.indexOf('=');
+        if (separatorIndex <= 0) {
+            throw new Error(`Invalid .env entry at line ${lineNumber}`);
+        }
+        const key = withoutExport.slice(0, separatorIndex).trim();
+        let value = withoutExport.slice(separatorIndex + 1).trim();
+        if (key.length === 0) {
+            throw new Error(`Invalid .env entry at line ${lineNumber}`);
+        }
+        if (value.length >= 2
+            && ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith('\'') && value.endsWith('\'')))) {
+            value = value.slice(1, -1);
+        }
+        parsed[key] = value;
+    }
+    return parsed;
+}
+export function isMissingFileError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return 'code' in error && error.code === 'ENOENT';
+}
+export function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+const MAX_CONFIG_NESTING_DEPTH = 100;
+export function flattenFileEntries(value, leafKeys = new Set()) {
+    const flattened = [];
+    const activeAncestors = new WeakSet();
+    const stack = [
+        {
+            value,
+            prefix: '',
+            entries: Object.entries(value),
+            index: 0,
+            depth: 0,
+        },
+    ];
+    activeAncestors.add(value);
+    while (stack.length > 0) {
+        const current = stack[stack.length - 1];
+        if (!current) {
+            break;
+        }
+        if (current.index >= current.entries.length) {
+            activeAncestors.delete(current.value);
+            stack.pop();
+            continue;
+        }
+        const nextEntry = current.entries[current.index];
+        if (!nextEntry) {
+            activeAncestors.delete(current.value);
+            stack.pop();
+            continue;
+        }
+        const [key, nestedValue] = nextEntry;
+        current.index += 1;
+        const dottedKey = current.prefix.length === 0 ? key : `${current.prefix}.${key}`;
+        if (!isPlainObject(nestedValue)) {
+            flattened.push([dottedKey, nestedValue]);
+            continue;
+        }
+        if (activeAncestors.has(nestedValue)) {
+            throw new Error('Circular references in config files are not supported');
+        }
+        if (leafKeys.has(dottedKey)) {
+            flattened.push([dottedKey, nestedValue]);
+            continue;
+        }
+        const nextDepth = current.depth + 1;
+        if (nextDepth > MAX_CONFIG_NESTING_DEPTH) {
+            throw new Error(`Config file nesting exceeds maximum depth of ${MAX_CONFIG_NESTING_DEPTH}`);
+        }
+        activeAncestors.add(nestedValue);
+        stack.push({
+            value: nestedValue,
+            prefix: dottedKey,
+            entries: Object.entries(nestedValue),
+            index: 0,
+            depth: nextDepth,
+        });
+    }
+    return flattened;
+}
+export function getFileExtension(filePath) {
+    const lastDot = filePath.lastIndexOf('.');
+    if (lastDot === -1 || lastDot === filePath.length - 1) {
+        throw new Error(`Unsupported file type for path: ${filePath}`);
+    }
+    return filePath.slice(lastDot + 1).toLowerCase();
+}
+export function createDefaultParsers() {
+    return new Map([
+        ['yaml', (content) => YAML.parse(content)],
+        ['yml', (content) => YAML.parse(content)],
+        ['json', (content) => JSON.parse(content)],
+        ['env', (content) => parseDotEnv(content)],
+    ]);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedSchemaEntry, ValidateError } from './types.js';
+export declare function isBuiltinStringFormat(format: string): boolean;
+export declare function coerceInputValue(value: unknown, entry: ResolvedSchemaEntry): unknown;
+export declare function validateFormatValue(key: string, value: unknown, format: unknown): ValidateError | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwCrE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAuBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAkCpF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAqCtG"}

package/dist/validation.js

@@ -0,0 +1,111 @@
+const BUILTIN_STRING_FORMAT_VALIDATORS = {
+    port: (key, value) => {
+        const valid = typeof value === 'number' && Number.isInteger(value) && value >= 0 && value <= 65535;
+        return valid ? null : { key, value, message: 'port must be 0-65535' };
+    },
+    nat: (key, value) => {
+        const valid = typeof value === 'number' && Number.isInteger(value) && value >= 0;
+        return valid ? null : { key, value, message: 'nat must be a non-negative integer' };
+    },
+    int: (key, value) => {
+        const valid = typeof value === 'number' && Number.isInteger(value);
+        return valid ? null : { key, value, message: 'int must be an integer' };
+    },
+    url: (key, value) => {
+        if (typeof value !== 'string') {
+            return { key, value, message: 'url must be a string' };
+        }
+        try {
+            new URL(value);
+            return null;
+        }
+        catch {
+            return { key, value, message: 'url must be a valid URL' };
+        }
+    },
+    ipaddress: (key, value) => {
+        if (typeof value !== 'string') {
+            return { key, value, message: 'ipaddress must be a string' };
+        }
+        const ipv4 = /^(25[0-5]|2[0-4]\d|1?\d?\d)(\.(25[0-5]|2[0-4]\d|1?\d?\d)){3}$/;
+        const ipv6 = /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|::1|::)$/;
+        return ipv4.test(value) || ipv6.test(value) ? null : { key, value, message: 'ipaddress must be a valid IPv4 or IPv6 address' };
+    },
+};
+export function isBuiltinStringFormat(format) {
+    return Object.hasOwn(BUILTIN_STRING_FORMAT_VALIDATORS, format);
+}
+function coerceNumberString(value) {
+    const parsed = Number(value);
+    return Number.isNaN(parsed) ? value : parsed;
+}
+function coerceBooleanString(value) {
+    if (value === 'true' || value === '1') {
+        return true;
+    }
+    if (value === 'false' || value === '0') {
+        return false;
+    }
+    return value;
+}
+function coerceArrayString(value) {
+    return value.split(',').map((part) => part.trim());
+}
+export function coerceInputValue(value, entry) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    if (entry.format === Array) {
+        return coerceArrayString(value);
+    }
+    if (entry.format === Number || entry.format === 'port' || entry.format === 'nat' || entry.format === 'int') {
+        return coerceNumberString(value);
+    }
+    if (entry.format === Boolean) {
+        return coerceBooleanString(value);
+    }
+    if (entry.format === String) {
+        return value;
+    }
+    if (Array.isArray(entry.default)) {
+        return coerceArrayString(value);
+    }
+    if (typeof entry.default === 'number') {
+        return coerceNumberString(value);
+    }
+    if (typeof entry.default === 'boolean') {
+        return coerceBooleanString(value);
+    }
+    return value;
+}
+export function validateFormatValue(key, value, format) {
+    if (format === undefined) {
+        return null;
+    }
+    if (Array.isArray(format)) {
+        if (!format.includes(value)) {
+            return { key, value, message: `Value must be one of: ${format.join(', ')}` };
+        }
+        return null;
+    }
+    if (format === String) {
+        return typeof value === 'string' ? null : { key, value, message: 'Value must be a string' };
+    }
+    if (format === Number) {
+        return typeof value === 'number' && Number.isFinite(value) ? null : { key, value, message: 'Value must be a number' };
+    }
+    if (format === Boolean) {
+        return typeof value === 'boolean' ? null : { key, value, message: 'Value must be a boolean' };
+    }
+    if (format === Array) {
+        return Array.isArray(value) ? null : { key, value, message: 'Value must be an array' };
+    }
+    if (typeof format === 'string') {
+        const validator = BUILTIN_STRING_FORMAT_VALIDATORS[format];
+        if (validator) {
+            return validator(key, value);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -1,11 +1,26 @@
 {
   "name": "traced-config",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "Configuration management with key-level source tracing. Know where every value came from.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/nrslib/traced-config.git"
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build && npm run test"
   },
   "keywords": [
     "config",
@@ -16,5 +31,22 @@
     "env",
     "cli",
     "precedence"
-  ]
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nrslib/traced-config.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "eslint": "^9.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  }
 }

package/.github/workflows/publish.yml

@@ -1,20 +0,0 @@
-name: Publish to npm
-
-on:
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Publish package
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}