@konker.dev/config-o-tron 0.0.1

package/dist/lib/flatten.test.js

@@ -0,0 +1,230 @@
+/**
+ * Flatten/Unflatten Tests
+ */
+import { describe, expect, it } from 'vitest';
+import { camelToScreamingSnake, envKeyToPath, flatten, getSortedKeys, pathToEnvKey, screamingSnakeToCamel, toEnvMap, unflatten, } from './flatten.js';
+describe('flatten', () => {
+    describe('flatten', () => {
+        it('should flatten simple object', () => {
+            const input = {
+                database: {
+                    host: 'localhost',
+                    port: 5432,
+                },
+            };
+            const result = flatten(input);
+            expect(result).toEqual({
+                'database.host': 'localhost',
+                'database.port': 5432,
+            });
+        });
+        it('should flatten deeply nested object', () => {
+            const input = {
+                level1: {
+                    level2: {
+                        level3: {
+                            value: 'deep',
+                        },
+                    },
+                },
+            };
+            const result = flatten(input);
+            expect(result).toEqual({
+                'level1.level2.level3.value': 'deep',
+            });
+        });
+        it('should handle arrays as values', () => {
+            const input = {
+                config: {
+                    tags: ['a', 'b', 'c'],
+                },
+            };
+            const result = flatten(input);
+            expect(result).toEqual({
+                'config.tags': ['a', 'b', 'c'],
+            });
+        });
+        it('should handle null values', () => {
+            const input = {
+                nullable: null,
+                nested: {
+                    also: null,
+                },
+            };
+            const result = flatten(input);
+            expect(result).toEqual({
+                nullable: null,
+                'nested.also': null,
+            });
+        });
+        it('should handle empty object', () => {
+            const result = flatten({});
+            expect(result).toEqual({});
+        });
+    });
+    describe('unflatten', () => {
+        it('should unflatten simple paths', () => {
+            const input = {
+                'database.host': 'localhost',
+                'database.port': '5432',
+            };
+            const result = unflatten(input);
+            expect(result).toEqual({
+                database: {
+                    host: 'localhost',
+                    port: '5432',
+                },
+            });
+        });
+        it('should unflatten deep paths', () => {
+            const input = {
+                'a.b.c.d': 'value',
+            };
+            const result = unflatten(input);
+            expect(result).toEqual({
+                a: {
+                    b: {
+                        c: {
+                            d: 'value',
+                        },
+                    },
+                },
+            });
+        });
+        it('should handle multiple paths to same object', () => {
+            const input = {
+                'db.host': 'localhost',
+                'db.port': '5432',
+                'db.name': 'mydb',
+            };
+            const result = unflatten(input);
+            expect(result).toEqual({
+                db: {
+                    host: 'localhost',
+                    port: '5432',
+                    name: 'mydb',
+                },
+            });
+        });
+    });
+    describe('pathToEnvKey', () => {
+        it('should convert dot notation to SCREAMING_SNAKE_CASE', () => {
+            expect(pathToEnvKey('database.host')).toBe('DATABASE_HOST');
+            expect(pathToEnvKey('server.port')).toBe('SERVER_PORT');
+        });
+        it('should handle camelCase segments', () => {
+            expect(pathToEnvKey('myService.apiKey')).toBe('MY_SERVICE_API_KEY');
+            expect(pathToEnvKey('database.connectionString')).toBe('DATABASE_CONNECTION_STRING');
+        });
+        it('should handle single segment', () => {
+            expect(pathToEnvKey('port')).toBe('PORT');
+            expect(pathToEnvKey('apiKey')).toBe('API_KEY');
+        });
+        it('should handle custom separator', () => {
+            expect(pathToEnvKey('database.host', '__')).toBe('DATABASE__HOST');
+        });
+    });
+    describe('envKeyToPath', () => {
+        it('should convert SCREAMING_SNAKE_CASE to dot notation', () => {
+            expect(envKeyToPath('DATABASE_HOST')).toBe('database.host');
+            expect(envKeyToPath('SERVER_PORT')).toBe('server.port');
+        });
+        it('should handle single word', () => {
+            expect(envKeyToPath('PORT')).toBe('port');
+        });
+        it('should handle custom separator', () => {
+            expect(envKeyToPath('DATABASE__HOST', '__')).toBe('database.host');
+        });
+    });
+    describe('camelToScreamingSnake', () => {
+        it('should convert camelCase', () => {
+            expect(camelToScreamingSnake('timeoutMs')).toBe('TIMEOUT_MS');
+            expect(camelToScreamingSnake('enableBeta')).toBe('ENABLE_BETA');
+        });
+        it('should handle consecutive uppercase', () => {
+            expect(camelToScreamingSnake('APIKey')).toBe('API_KEY');
+        });
+        it('should handle already uppercase', () => {
+            expect(camelToScreamingSnake('API')).toBe('API');
+        });
+    });
+    describe('screamingSnakeToCamel', () => {
+        it('should convert SCREAMING_SNAKE_CASE to camelCase', () => {
+            expect(screamingSnakeToCamel('TIMEOUT_MS')).toBe('timeoutMs');
+            expect(screamingSnakeToCamel('ENABLE_BETA')).toBe('enableBeta');
+        });
+        it('should handle single word', () => {
+            expect(screamingSnakeToCamel('PORT')).toBe('port');
+        });
+        it('should handle multiple underscores', () => {
+            expect(screamingSnakeToCamel('MY_LONG_VARIABLE_NAME')).toBe('myLongVariableName');
+        });
+    });
+    describe('toEnvMap', () => {
+        it('should convert nested object to env map', () => {
+            const obj = {
+                database: {
+                    host: 'localhost',
+                    port: 5432,
+                },
+            };
+            const result = toEnvMap(obj);
+            expect(result).toEqual({
+                DATABASE_HOST: 'localhost',
+                DATABASE_PORT: 5432,
+            });
+        });
+        it('should handle camelCase keys', () => {
+            const obj = {
+                apiKey: 'secret',
+                timeoutMs: 5000,
+            };
+            const result = toEnvMap(obj);
+            expect(result).toEqual({
+                API_KEY: 'secret',
+                TIMEOUT_MS: 5000,
+            });
+        });
+        it('should handle custom separator', () => {
+            const obj = {
+                database: {
+                    host: 'localhost',
+                },
+            };
+            const result = toEnvMap(obj, '__');
+            expect(result).toEqual({
+                DATABASE__HOST: 'localhost',
+            });
+        });
+        it('should handle empty object', () => {
+            const result = toEnvMap({});
+            expect(result).toEqual({});
+        });
+    });
+    describe('getSortedKeys', () => {
+        it('should sort keys case-insensitively', () => {
+            const obj = {
+                Zebra: 1,
+                apple: 2,
+                BANANA: 3,
+            };
+            const result = getSortedKeys(obj);
+            expect(result).toEqual(['apple', 'BANANA', 'Zebra']);
+        });
+        it('should handle empty object', () => {
+            const result = getSortedKeys({});
+            expect(result).toEqual([]);
+        });
+        it('should handle keys with same lowercase', () => {
+            const obj = {
+                AAA: 1,
+                aaa: 2,
+                Aaa: 3,
+            };
+            const result = getSortedKeys(obj);
+            // All have same lowercase, order is stable
+            expect(result).toHaveLength(3);
+        });
+    });
+});
+//# sourceMappingURL=flatten.test.js.map

package/dist/lib/flatten.test.js.map

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

package/dist/lib/format.d.ts

@@ -0,0 +1,41 @@
+export type FormatOptions = {
+    readonly separator?: string;
+    readonly sortKeys?: boolean;
+};
+/**
+ * Format a configuration object as .env content
+ *
+ * @param config - The configuration object (nested or flat)
+ * @param options - Format options
+ * @returns .env file content as string
+ */
+export declare function formatEnv(config: Record<string, unknown>, options?: FormatOptions): string;
+/**
+ * Format a configuration object as JSON content
+ *
+ * @param config - The configuration object
+ * @param pretty - Whether to pretty-print (default: true)
+ * @returns JSON content as string
+ */
+export declare function formatJson(config: Record<string, unknown>, pretty?: boolean): string;
+/**
+ * Format a configuration object in the specified format
+ *
+ * @param config - The configuration object
+ * @param format - Output format ("env" or "json")
+ * @param options - Format options
+ * @returns Formatted content as string
+ */
+export declare function formatConfig(config: Record<string, unknown>, format: 'env' | 'json', options?: FormatOptions): string;
+/**
+ * Parse .env file content
+ *
+ * @param content - .env file content
+ * @returns Flat key-value map
+ */
+export declare function parseEnvContent(content: string): Record<string, string>;
+/**
+ * Detect file format from content
+ */
+export declare function detectFormat(content: string): 'env' | 'json' | 'unknown';
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AA4EF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAwB9F;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,UAAO,GAAG,MAAM,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAOR;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAoBxE"}

package/dist/lib/format.js

@@ -0,0 +1,182 @@
+/**
+ * Output Formatting
+ *
+ * Converts configuration objects to .env or JSON format
+ */
+import { flatten, getSortedKeys, pathToEnvKey } from './flatten.js';
+// --------------------------------------------------------------------------
+// Value Serialization
+// --------------------------------------------------------------------------
+/**
+ * Check if a string needs quoting in .env format
+ */
+function needsQuoting(value) {
+    // Needs quoting if:
+    // - Contains spaces, #, =, newlines, or $
+    // - Starts or ends with whitespace
+    // - Is empty
+    if (value.length === 0) {
+        // Empty string can be KEY= without quotes
+        return false;
+    }
+    if (value.startsWith(' ') || value.endsWith(' '))
+        return true;
+    if (/[\s#=$\n]/.test(value))
+        return true;
+    return false;
+}
+/**
+ * Escape a string for double-quoted .env value
+ */
+function escapeEnvValue(value) {
+    return value
+        .replace(/\\/g, '\\\\') // Backslash first
+        .replace(/"/g, '\\"') // Quotes
+        .replace(/\n/g, '\\n'); // Newlines
+}
+/**
+ * Serialize a value for .env format
+ */
+function serializeEnvValue(value) {
+    if (value === undefined) {
+        // Omit undefined values
+        return undefined;
+    }
+    if (value === null) {
+        // Omit null values in .env format
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        if (needsQuoting(value)) {
+            return `"${escapeEnvValue(value)}"`;
+        }
+        return value;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (Array.isArray(value) || typeof value === 'object') {
+        // Arrays and objects are serialized as minified JSON
+        const json = JSON.stringify(value);
+        // JSON always needs quoting since it contains special chars
+        return `"${escapeEnvValue(json)}"`;
+    }
+    return String(value);
+}
+// --------------------------------------------------------------------------
+// Format Functions
+// --------------------------------------------------------------------------
+/**
+ * Format a configuration object as .env content
+ *
+ * @param config - The configuration object (nested or flat)
+ * @param options - Format options
+ * @returns .env file content as string
+ */
+export function formatEnv(config, options = {}) {
+    const separator = options.separator ?? '_';
+    const sortKeys = options.sortKeys ?? true;
+    // Flatten if nested
+    const flat = flatten(config);
+    // Convert to env keys
+    const envMap = {};
+    for (const [path, value] of Object.entries(flat)) {
+        const envKey = pathToEnvKey(path, separator);
+        const serialized = serializeEnvValue(value);
+        if (serialized !== undefined) {
+            envMap[envKey] = serialized;
+        }
+    }
+    // Sort keys
+    const keys = sortKeys ? getSortedKeys(envMap) : Object.keys(envMap);
+    // Build output
+    const lines = keys.map((key) => `${key}=${envMap[key]}`);
+    return lines.join('\n') + (lines.length > 0 ? '\n' : '');
+}
+/**
+ * Format a configuration object as JSON content
+ *
+ * @param config - The configuration object
+ * @param pretty - Whether to pretty-print (default: true)
+ * @returns JSON content as string
+ */
+export function formatJson(config, pretty = true) {
+    return pretty ? JSON.stringify(config, null, 2) + '\n' : JSON.stringify(config) + '\n';
+}
+/**
+ * Format a configuration object in the specified format
+ *
+ * @param config - The configuration object
+ * @param format - Output format ("env" or "json")
+ * @param options - Format options
+ * @returns Formatted content as string
+ */
+export function formatConfig(config, format, options = {}) {
+    switch (format) {
+        case 'env':
+            return formatEnv(config, options);
+        case 'json':
+            return formatJson(config);
+    }
+}
+// --------------------------------------------------------------------------
+// Parse Functions (for validate command)
+// --------------------------------------------------------------------------
+/**
+ * Parse .env file content
+ *
+ * @param content - .env file content
+ * @returns Flat key-value map
+ */
+export function parseEnvContent(content) {
+    const result = {};
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (trimmed === '' || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Find the first = sign
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1) {
+            continue; // Invalid line, skip
+        }
+        const key = trimmed.slice(0, eqIndex);
+        let value = trimmed.slice(eqIndex + 1);
+        // Handle quoted values
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+            // Unescape
+            value = value.replace(/\\n/g, '\n').replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Detect file format from content
+ */
+export function detectFormat(content) {
+    const trimmed = content.trim();
+    // Check for JSON
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            JSON.parse(trimmed);
+            return 'json';
+        }
+        catch {
+            // Not valid JSON
+        }
+    }
+    // Check for .env format (KEY=VALUE lines)
+    const lines = trimmed.split('\n').filter((l) => l.trim() !== '' && !l.trim().startsWith('#'));
+    if (lines.length > 0 && lines.every((l) => /^[A-Z_][A-Z0-9_]*=/.test(l.trim()))) {
+        return 'env';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

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

package/dist/lib/format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.test.d.ts.map

package/dist/lib/format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../../src/lib/format.test.ts"],"names":[],"mappings":""}