@memberjunction/config 0.0.1 → 3.0.0

package/dist/config-loader.d.ts

@@ -0,0 +1,86 @@
+import { MergeOptions } from './config-merger';
+/**
+ * Configuration loading options
+ */
+export interface LoadConfigOptions {
+    /**
+     * Directory to start searching for config file.
+     * Default: process.cwd()
+     */
+    searchFrom?: string;
+    /**
+     * If true, throws error when config file is not found.
+     * If false, returns empty object when no config file exists.
+     * Default: false
+     */
+    requireConfigFile?: boolean;
+    /**
+     * Merge behavior options
+     */
+    mergeOptions?: MergeOptions;
+    /**
+     * If true, logs configuration loading details
+     * Default: false
+     */
+    verbose?: boolean;
+    /**
+     * Default configuration to use as base.
+     * Typically provided by the calling package.
+     */
+    defaultConfig?: Record<string, any>;
+}
+/**
+ * Result of configuration loading
+ */
+export interface LoadConfigResult<T = Record<string, any>> {
+    /**
+     * Final merged configuration
+     */
+    config: T;
+    /**
+     * Path to user config file (undefined if using only defaults)
+     */
+    configFilePath?: string;
+    /**
+     * True if user config file was found and loaded
+     */
+    hasUserConfig: boolean;
+    /**
+     * Keys that were overridden from defaults
+     */
+    overriddenKeys: string[];
+}
+/**
+ * Loads and merges MemberJunction configuration from multiple sources:
+ * 1. Default configuration (provided by calling package)
+ * 2. Optional mj.config.cjs file (found via cosmiconfig)
+ * 3. Environment variables (applied on top of merged config)
+ *
+ * @param options - Configuration loading options
+ * @returns Merged configuration result
+ */
+export declare function loadMJConfig<T = Record<string, any>>(options?: LoadConfigOptions): Promise<LoadConfigResult<T>>;
+/**
+ * Loads configuration synchronously (for CommonJS compatibility).
+ * Note: This does NOT search for config files, only loads from explicit path.
+ *
+ * @param configPath - Explicit path to config file
+ * @param options - Loading options
+ */
+export declare function loadMJConfigSync<T = Record<string, any>>(configPath: string, options?: Omit<LoadConfigOptions, 'searchFrom' | 'requireConfigFile'>): T;
+/**
+ * Helper to build a complete MJ config by merging configurations from multiple packages.
+ * Each package provides its own default configuration.
+ *
+ * @param packageDefaults - Object with package-specific default configs
+ * @param userConfigOverrides - Optional user overrides
+ * @returns Merged configuration
+ */
+export declare function buildMJConfig(packageDefaults: {
+    codegen?: Record<string, any>;
+    server?: Record<string, any>;
+    mcpServer?: Record<string, any>;
+    a2aServer?: Record<string, any>;
+    queryGen?: Record<string, any>;
+}, userConfigOverrides?: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=config-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACvD;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA6E9B;AAmBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,mBAAmB,CAAM,GACxE,CAAC,CAUH;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,EACD,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA2BrB"}

package/dist/config-loader.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMJConfig = exports.loadMJConfigSync = exports.loadMJConfig = void 0;
+const cosmiconfig_1 = require("cosmiconfig");
+const config_merger_1 = require("./config-merger");
+/**
+ * Loads and merges MemberJunction configuration from multiple sources:
+ * 1. Default configuration (provided by calling package)
+ * 2. Optional mj.config.cjs file (found via cosmiconfig)
+ * 3. Environment variables (applied on top of merged config)
+ *
+ * @param options - Configuration loading options
+ * @returns Merged configuration result
+ */
+async function loadMJConfig(options = {}) {
+    const { searchFrom = process.cwd(), requireConfigFile = false, mergeOptions = {}, verbose = false, defaultConfig = {} } = options;
+    if (verbose) {
+        console.log(`\n📄 Loading MemberJunction configuration...`);
+        console.log(`   Search directory: ${searchFrom}`);
+    }
+    // Search for user config file
+    const explorer = (0, cosmiconfig_1.cosmiconfig)('mj', {
+        searchPlaces: [
+            'mj.config.cjs',
+            'mj.config.js',
+            '.mjrc',
+            '.mjrc.js',
+            '.mjrc.cjs',
+            'package.json' // Look for "mj" key
+        ]
+    });
+    const searchResult = await explorer.search(searchFrom);
+    if (!searchResult) {
+        if (requireConfigFile) {
+            throw new Error(`No mj.config.cjs file found in ${searchFrom} or parent directories. ` +
+                `Either create a config file or set requireConfigFile: false to use defaults.`);
+        }
+        if (verbose) {
+            console.log(`   ℹ No user config file found, using defaults only`);
+        }
+        return {
+            config: defaultConfig,
+            hasUserConfig: false,
+            overriddenKeys: []
+        };
+    }
+    if (verbose) {
+        console.log(`   ✓ Found config file: ${searchResult.filepath}`);
+    }
+    // Merge user config into defaults
+    const userConfig = searchResult.config;
+    const mergedConfig = (0, config_merger_1.mergeConfigs)(defaultConfig, userConfig, mergeOptions);
+    // Identify overridden keys for logging
+    const overriddenKeys = identifyOverriddenKeys(defaultConfig, userConfig);
+    if (verbose) {
+        console.log(`   ✓ Merged ${overriddenKeys.length} configuration override(s)`);
+        if (overriddenKeys.length > 0 && overriddenKeys.length <= 10) {
+            console.log(`   Overridden keys: ${overriddenKeys.join(', ')}`);
+        }
+        else if (overriddenKeys.length > 10) {
+            console.log(`   Overridden keys: ${overriddenKeys.slice(0, 10).join(', ')}, ... (${overriddenKeys.length - 10} more)`);
+        }
+    }
+    if (verbose) {
+        console.log(`   ✓ Configuration loaded successfully\n`);
+    }
+    return {
+        config: mergedConfig,
+        configFilePath: searchResult.filepath,
+        hasUserConfig: true,
+        overriddenKeys
+    };
+}
+exports.loadMJConfig = loadMJConfig;
+/**
+ * Identifies which top-level keys were overridden in user config
+ */
+function identifyOverriddenKeys(defaults, overrides) {
+    if (!overrides)
+        return [];
+    return Object.keys(overrides).filter(key => {
+        const hasOverride = key in overrides;
+        // Only count as override if the value is different
+        const isDifferent = JSON.stringify(defaults[key]) !== JSON.stringify(overrides[key]);
+        return hasOverride && isDifferent;
+    });
+}
+/**
+ * Loads configuration synchronously (for CommonJS compatibility).
+ * Note: This does NOT search for config files, only loads from explicit path.
+ *
+ * @param configPath - Explicit path to config file
+ * @param options - Loading options
+ */
+function loadMJConfigSync(configPath, options = {}) {
+    const { defaultConfig = {}, mergeOptions = {} } = options;
+    try {
+        const userConfig = require(configPath);
+        const mergedConfig = (0, config_merger_1.mergeConfigs)(defaultConfig, userConfig, mergeOptions);
+        return mergedConfig;
+    }
+    catch (error) {
+        throw new Error(`Failed to load config from ${configPath}: ${error.message}`);
+    }
+}
+exports.loadMJConfigSync = loadMJConfigSync;
+/**
+ * Helper to build a complete MJ config by merging configurations from multiple packages.
+ * Each package provides its own default configuration.
+ *
+ * @param packageDefaults - Object with package-specific default configs
+ * @param userConfigOverrides - Optional user overrides
+ * @returns Merged configuration
+ */
+function buildMJConfig(packageDefaults, userConfigOverrides) {
+    // Start with empty config
+    let config = {};
+    // Merge each package's defaults
+    if (packageDefaults.codegen) {
+        config = (0, config_merger_1.mergeConfigs)(config, packageDefaults.codegen);
+    }
+    if (packageDefaults.server) {
+        config = (0, config_merger_1.mergeConfigs)(config, packageDefaults.server);
+    }
+    if (packageDefaults.mcpServer) {
+        config = (0, config_merger_1.mergeConfigs)(config, packageDefaults.mcpServer);
+    }
+    if (packageDefaults.a2aServer) {
+        config = (0, config_merger_1.mergeConfigs)(config, packageDefaults.a2aServer);
+    }
+    if (packageDefaults.queryGen) {
+        config = { ...config, queryGen: packageDefaults.queryGen };
+    }
+    // Apply user overrides
+    if (userConfigOverrides) {
+        config = (0, config_merger_1.mergeConfigs)(config, userConfigOverrides);
+    }
+    return config;
+}
+exports.buildMJConfig = buildMJConfig;
+//# sourceMappingURL=config-loader.js.map

package/dist/config-loader.js.map

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

package/dist/config-merger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Configuration merge options
+ */
+export interface MergeOptions {
+    /**
+     * If true, arrays are concatenated instead of replaced.
+     * Default: false (arrays replace)
+     */
+    concatenateArrays?: boolean;
+    /**
+     * If true, null values in override config will replace default values.
+     * If false, null values are ignored and defaults are preserved.
+     * Default: false
+     */
+    allowNullOverrides?: boolean;
+}
+/**
+ * Deep merges user configuration into default configuration.
+ *
+ * Merge Rules:
+ * 1. Primitives (string, number, boolean): User value replaces default
+ * 2. Objects: Recursively merge properties
+ * 3. Arrays: Replace entirely (unless concatenateArrays option is true)
+ * 4. Null/Undefined: Preserved based on allowNullOverrides option
+ * 5. Special _append suffix: Concatenates arrays (e.g., excludeSchemas_append)
+ *
+ * @param defaults - Default configuration object
+ * @param overrides - User override configuration object
+ * @param options - Merge behavior options
+ * @returns Merged configuration object
+ */
+export declare function mergeConfigs<T extends Record<string, any>>(defaults: T, overrides: Partial<T> | undefined, options?: MergeOptions): T;
+/**
+ * Validates merged configuration against expected structure.
+ * Logs warnings for unexpected keys that might indicate typos.
+ *
+ * @param config - Merged configuration object
+ * @param allowedKeys - Set of allowed top-level keys
+ */
+export declare function validateConfigStructure(config: Record<string, any>, allowedKeys: Set<string>): void;
+//# sourceMappingURL=config-merger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-merger.d.ts","sourceRoot":"","sources":["../src/config-merger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,EACjC,OAAO,GAAE,YAAiB,GACzB,CAAC,CAqBH;AA0ED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,IAAI,CAUN"}

package/dist/config-merger.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfigStructure = exports.mergeConfigs = void 0;
+const lodash_mergewith_1 = __importDefault(require("lodash.mergewith"));
+/**
+ * Deep merges user configuration into default configuration.
+ *
+ * Merge Rules:
+ * 1. Primitives (string, number, boolean): User value replaces default
+ * 2. Objects: Recursively merge properties
+ * 3. Arrays: Replace entirely (unless concatenateArrays option is true)
+ * 4. Null/Undefined: Preserved based on allowNullOverrides option
+ * 5. Special _append suffix: Concatenates arrays (e.g., excludeSchemas_append)
+ *
+ * @param defaults - Default configuration object
+ * @param overrides - User override configuration object
+ * @param options - Merge behavior options
+ * @returns Merged configuration object
+ */
+function mergeConfigs(defaults, overrides, options = {}) {
+    const { concatenateArrays = false, allowNullOverrides = false } = options;
+    if (!overrides || typeof overrides !== 'object') {
+        return defaults;
+    }
+    // Process _append suffixed keys first
+    const processedOverrides = processAppendKeys(overrides, defaults);
+    return (0, lodash_mergewith_1.default)({}, defaults, processedOverrides, (defaultValue, overrideValue, key) => {
+        return customMergeStrategy(defaultValue, overrideValue, key, {
+            concatenateArrays,
+            allowNullOverrides
+        });
+    });
+}
+exports.mergeConfigs = mergeConfigs;
+/**
+ * Processes keys with _append suffix to concatenate arrays
+ */
+function processAppendKeys(overrides, defaults) {
+    const processed = { ...overrides };
+    for (const key in overrides) {
+        if (key.endsWith('_append')) {
+            const baseKey = key.slice(0, -7); // Remove '_append' suffix
+            const defaultValue = defaults[baseKey];
+            const appendValue = overrides[key];
+            if (Array.isArray(defaultValue) && Array.isArray(appendValue)) {
+                processed[baseKey] = [...defaultValue, ...appendValue];
+                delete processed[key]; // Remove the _append key
+            }
+            else {
+                console.warn(`Warning: ${key} expects both default and override to be arrays. ` +
+                    `Default type: ${typeof defaultValue}, Override type: ${typeof appendValue}`);
+            }
+        }
+    }
+    return processed;
+}
+/**
+ * Custom merge strategy for lodash.mergeWith
+ */
+function customMergeStrategy(defaultValue, overrideValue, key, options) {
+    const { concatenateArrays, allowNullOverrides } = options;
+    // Handle null/undefined overrides
+    if (overrideValue === null || overrideValue === undefined) {
+        return allowNullOverrides ? overrideValue : defaultValue;
+    }
+    // Arrays: Replace or concatenate based on option
+    if (Array.isArray(defaultValue) && Array.isArray(overrideValue)) {
+        return concatenateArrays ? [...defaultValue, ...overrideValue] : overrideValue;
+    }
+    // Objects: Let lodash continue recursive merge (return undefined)
+    if (isPlainObject(defaultValue) && isPlainObject(overrideValue)) {
+        return undefined; // Continue default merge behavior
+    }
+    // Primitives: Override replaces default
+    return overrideValue;
+}
+/**
+ * Checks if value is a plain object (not array, not class instance)
+ */
+function isPlainObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+/**
+ * Validates merged configuration against expected structure.
+ * Logs warnings for unexpected keys that might indicate typos.
+ *
+ * @param config - Merged configuration object
+ * @param allowedKeys - Set of allowed top-level keys
+ */
+function validateConfigStructure(config, allowedKeys) {
+    const configKeys = Object.keys(config);
+    const unexpectedKeys = configKeys.filter(key => !allowedKeys.has(key));
+    if (unexpectedKeys.length > 0) {
+        console.warn(`Warning: Unexpected configuration keys found: ${unexpectedKeys.join(', ')}. ` +
+            `These may be typos or deprecated settings.`);
+    }
+}
+exports.validateConfigStructure = validateConfigStructure;
+//# sourceMappingURL=config-merger.js.map

package/dist/config-merger.js.map

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

package/dist/config-types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Configuration type definitions for MemberJunction.
+ *
+ * Note: This file provides type re-exports for convenience.
+ * The actual type definitions and defaults live in their respective packages:
+ * - @memberjunction/server (MJServerConfig)
+ * - @memberjunction/codegen-lib (CodeGenConfig)
+ * - @memberjunction/mcp-server (MCPServerConfig)
+ * - @memberjunction/a2a-server (A2AServerConfig)
+ * - @memberjunction/querygen (QueryGenConfig)
+ */
+/**
+ * Generic configuration type for MemberJunction.
+ * Each consuming package should define its own specific configuration type.
+ */
+export type MJConfig = Record<string, any>;
+/**
+ * Type guard to check if a value is a valid configuration object
+ */
+export declare function isValidConfig(value: unknown): value is MJConfig;
+//# sourceMappingURL=config-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE3C;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE/D"}

package/dist/config-types.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Configuration type definitions for MemberJunction.
+ *
+ * Note: This file provides type re-exports for convenience.
+ * The actual type definitions and defaults live in their respective packages:
+ * - @memberjunction/server (MJServerConfig)
+ * - @memberjunction/codegen-lib (CodeGenConfig)
+ * - @memberjunction/mcp-server (MCPServerConfig)
+ * - @memberjunction/a2a-server (A2AServerConfig)
+ * - @memberjunction/querygen (QueryGenConfig)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidConfig = void 0;
+/**
+ * Type guard to check if a value is a valid configuration object
+ */
+function isValidConfig(value) {
+    return typeof value === 'object' && value !== null;
+}
+exports.isValidConfig = isValidConfig;
+//# sourceMappingURL=config-types.js.map

package/dist/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAQH;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAFD,sCAEC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @memberjunction/config
+ *
+ * Central configuration utilities for MemberJunction framework.
+ * Provides utilities for loading and merging user overrides with package defaults.
+ *
+ * Architecture:
+ * - Each package (server, codegen-lib, etc.) exports its own DEFAULT_CONFIG
+ * - This package provides utilities to discover, load, and merge configurations
+ * - User's mj.config.cjs file overrides package defaults
+ * - Environment variables override everything
+ */
+export { loadMJConfig, loadMJConfigSync, buildMJConfig, type LoadConfigOptions, type LoadConfigResult } from './config-loader';
+export { mergeConfigs, validateConfigStructure, type MergeOptions } from './config-merger';
+export { type MJConfig, isValidConfig } from './config-types';
+//# 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;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,KAAK,QAAQ,EACb,aAAa,EACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @memberjunction/config
+ *
+ * Central configuration utilities for MemberJunction framework.
+ * Provides utilities for loading and merging user overrides with package defaults.
+ *
+ * Architecture:
+ * - Each package (server, codegen-lib, etc.) exports its own DEFAULT_CONFIG
+ * - This package provides utilities to discover, load, and merge configurations
+ * - User's mj.config.cjs file overrides package defaults
+ * - Environment variables override everything
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidConfig = exports.validateConfigStructure = exports.mergeConfigs = exports.buildMJConfig = exports.loadMJConfigSync = exports.loadMJConfig = void 0;
+var config_loader_1 = require("./config-loader");
+Object.defineProperty(exports, "loadMJConfig", { enumerable: true, get: function () { return config_loader_1.loadMJConfig; } });
+Object.defineProperty(exports, "loadMJConfigSync", { enumerable: true, get: function () { return config_loader_1.loadMJConfigSync; } });
+Object.defineProperty(exports, "buildMJConfig", { enumerable: true, get: function () { return config_loader_1.buildMJConfig; } });
+var config_merger_1 = require("./config-merger");
+Object.defineProperty(exports, "mergeConfigs", { enumerable: true, get: function () { return config_merger_1.mergeConfigs; } });
+Object.defineProperty(exports, "validateConfigStructure", { enumerable: true, get: function () { return config_merger_1.validateConfigStructure; } });
+var config_types_1 = require("./config-types");
+Object.defineProperty(exports, "isValidConfig", { enumerable: true, get: function () { return config_types_1.isValidConfig; } });
+//# 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;;;;;;;;;;;GAWG;;;AAEH,iDAMyB;AALvB,6GAAA,YAAY,OAAA;AACZ,iHAAA,gBAAgB,OAAA;AAChB,8GAAA,aAAa,OAAA;AAKf,iDAIyB;AAHvB,6GAAA,YAAY,OAAA;AACZ,wHAAA,uBAAuB,OAAA;AAIzB,+CAGwB;AADtB,6GAAA,aAAa,OAAA"}

package/package.json

@@ -1,10 +1,33 @@
 {
   "name": "@memberjunction/config",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/config",
+  "version": "3.0.0",
+  "description": "Central configuration package for MemberJunction framework with default configurations and merge utilities",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "jest"
+  },
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
+    "memberjunction",
+    "configuration",
+    "config"
+  ],
+  "author": "MemberJunction",
+  "license": "MIT",
+  "dependencies": {
+    "cosmiconfig": "^9.0.0",
+    "lodash.mergewith": "^4.6.2",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/lodash.mergewith": "^4.6.9",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist"
   ]
 }

package/README.md

@@ -1,45 +0,0 @@
-# @memberjunction/config
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/config`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**