@aweave/config-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { getConfigRoot, getDomainConfigDir, getUserConfigPath } from './paths';
+export { deepMerge, loadConfig } from './loader';
+export { listDefaultConfigs, syncDefaultConfigs } from './sync';
+export { migrateFromLegacy } from './migrate';
+export { validateConfig } from './schema';
+export { projectClientConfig } from './projection';
+export type { ConfigFile, ConfigSchema, LoadConfigOptions, MigrateOptions, MigrateResult, SchemaField, SyncOptions, SyncResult, ValidationIssue, } from './types';
+export { ConfigDefaultsMissingError, ConfigParseError, ConfigValidationError, } from './types';

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationError = exports.ConfigParseError = exports.ConfigDefaultsMissingError = exports.projectClientConfig = exports.validateConfig = exports.migrateFromLegacy = exports.syncDefaultConfigs = exports.listDefaultConfigs = exports.loadConfig = exports.deepMerge = exports.getUserConfigPath = exports.getDomainConfigDir = exports.getConfigRoot = void 0;
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "getConfigRoot", { enumerable: true, get: function () { return paths_1.getConfigRoot; } });
+Object.defineProperty(exports, "getDomainConfigDir", { enumerable: true, get: function () { return paths_1.getDomainConfigDir; } });
+Object.defineProperty(exports, "getUserConfigPath", { enumerable: true, get: function () { return paths_1.getUserConfigPath; } });
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "deepMerge", { enumerable: true, get: function () { return loader_1.deepMerge; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return loader_1.loadConfig; } });
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "listDefaultConfigs", { enumerable: true, get: function () { return sync_1.listDefaultConfigs; } });
+Object.defineProperty(exports, "syncDefaultConfigs", { enumerable: true, get: function () { return sync_1.syncDefaultConfigs; } });
+var migrate_1 = require("./migrate");
+Object.defineProperty(exports, "migrateFromLegacy", { enumerable: true, get: function () { return migrate_1.migrateFromLegacy; } });
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return schema_1.validateConfig; } });
+var projection_1 = require("./projection");
+Object.defineProperty(exports, "projectClientConfig", { enumerable: true, get: function () { return projection_1.projectClientConfig; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "ConfigDefaultsMissingError", { enumerable: true, get: function () { return types_1.ConfigDefaultsMissingError; } });
+Object.defineProperty(exports, "ConfigParseError", { enumerable: true, get: function () { return types_1.ConfigParseError; } });
+Object.defineProperty(exports, "ConfigValidationError", { enumerable: true, get: function () { return types_1.ConfigValidationError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,iCAA+E;AAAtE,sGAAA,aAAa,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAG7D,mCAAiD;AAAxC,mGAAA,SAAS,OAAA;AAAE,oGAAA,UAAU,OAAA;AAG9B,+BAAgE;AAAvD,0GAAA,kBAAkB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAG/C,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAG1B,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AAGvB,2CAAmD;AAA1C,iHAAA,mBAAmB,OAAA;AAc5B,iCAIiB;AAHf,mHAAA,0BAA0B,OAAA;AAC1B,yGAAA,gBAAgB,OAAA;AAChB,8GAAA,qBAAqB,OAAA"}

package/dist/loader.d.ts

@@ -0,0 +1,3 @@
+import { type ConfigFile, type LoadConfigOptions } from './types';
+export declare function loadConfig<T extends ConfigFile = ConfigFile>(options: LoadConfigOptions): T;
+export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;

package/dist/loader.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.deepMerge = deepMerge;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+const paths_1 = require("./paths");
+const types_1 = require("./types");
+function loadConfig(options) {
+    const { domain, name, defaultsDir, envOverrides } = options;
+    const defaultConfig = loadDefaultConfig(defaultsDir, name);
+    const userConfigPath = (0, paths_1.getUserConfigPath)(domain, name);
+    const userConfig = loadYamlFile(userConfigPath, false);
+    const merged = deepMerge(defaultConfig, userConfig);
+    if (envOverrides) {
+        applyEnvOverrides(merged, envOverrides);
+    }
+    return merged;
+}
+function loadDefaultConfig(defaultsDir, name) {
+    if (!node_fs_1.default.existsSync(defaultsDir)) {
+        throw new types_1.ConfigDefaultsMissingError(defaultsDir);
+    }
+    const filePath = node_path_1.default.join(defaultsDir, `${name}.yaml`);
+    return loadYamlFile(filePath, true);
+}
+function loadYamlFile(filePath, required) {
+    if (!node_fs_1.default.existsSync(filePath)) {
+        if (required) {
+            throw new types_1.ConfigParseError(filePath, new Error('File does not exist'));
+        }
+        return {};
+    }
+    const raw = node_fs_1.default.readFileSync(filePath, 'utf-8');
+    if (raw.trim().length === 0) {
+        return {};
+    }
+    try {
+        const parsed = yaml_1.default.parse(raw);
+        if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('Config file must contain a YAML mapping (object) at top level');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof yaml_1.default.YAMLParseError) {
+            const pos = error.linePos?.[0];
+            throw new types_1.ConfigParseError(filePath, error, pos?.line, pos?.col);
+        }
+        throw new types_1.ConfigParseError(filePath, error instanceof Error ? error : new Error(String(error)));
+    }
+}
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = result[key];
+        if (isPlainObject(sourceVal) && isPlainObject(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function applyEnvOverrides(config, overrides) {
+    for (const [dotPath, envVar] of Object.entries(overrides)) {
+        const envValue = process.env[envVar];
+        if (envValue === undefined)
+            continue;
+        const keys = dotPath.split('.');
+        let current = config;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!isPlainObject(current[key])) {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        const lastKey = keys[keys.length - 1];
+        current[lastKey] = coerceValue(envValue);
+    }
+}
+function coerceValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    const num = Number(value);
+    if (!Number.isNaN(num) && value.trim().length > 0)
+        return num;
+    return value;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":";;;;;AA4BA,gCAqBC;AAsED,8BAqBC;AA5ID,sDAAyB;AACzB,0DAA6B;AAE7B,gDAAwB;AAExB,mCAA4C;AAC5C,mCAKiB;AAiBjB,SAAgB,UAAU,CACxB,OAA0B;IAE1B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAG5D,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAG3D,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAGvD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAGpD,IAAI,YAAY,EAAE,CAAC;QACjB,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC;AAMD,SAAS,iBAAiB,CACxB,WAAmB,EACnB,IAAY;IAEZ,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,kCAA0B,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACxD,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAOD,SAAS,YAAY,CACnB,QAAgB,EAChB,QAAiB;IAEjB,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,wBAAgB,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAG/C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;QACJ,CAAC;QAED,OAAO,MAAiC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAI,CAAC,cAAc,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,IAAI,wBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,wBAAgB,CACxB,QAAQ,EACR,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AASD,SAAgB,SAAS,CACvB,MAA+B,EAC/B,MAA+B;IAE/B,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,SAAoC,EACpC,SAAoC,CACrC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AASD,SAAS,iBAAiB,CACxB,MAA+B,EAC/B,SAAiC;IAEjC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QAErC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,GAA4B,MAAM,CAAC;QAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAA4B,CAAC;QACpD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAEpC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAE9D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/migrate.d.ts

@@ -0,0 +1,2 @@
+import { type MigrateOptions, type MigrateResult } from './types';
+export declare function migrateFromLegacy(options: MigrateOptions): MigrateResult[];

package/dist/migrate.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateFromLegacy = migrateFromLegacy;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+const paths_1 = require("./paths");
+function migrateFromLegacy(options) {
+    const { domain, legacyFiles } = options;
+    if (!legacyFiles || Object.keys(legacyFiles).length === 0) {
+        return [];
+    }
+    const destDir = (0, paths_1.getDomainConfigDir)(domain);
+    node_fs_1.default.mkdirSync(destDir, { recursive: true });
+    const results = [];
+    for (const [legacyPath, newName] of Object.entries(legacyFiles)) {
+        const expandedPath = expandHome(legacyPath);
+        const destPath = node_path_1.default.join(destDir, `${newName}.yaml`);
+        if (!node_fs_1.default.existsSync(expandedPath)) {
+            results.push({
+                legacyPath: expandedPath,
+                newPath: destPath,
+                action: 'not_found',
+                message: `Legacy file not found: ${expandedPath}`,
+            });
+            continue;
+        }
+        if (node_fs_1.default.existsSync(destPath)) {
+            results.push({
+                legacyPath: expandedPath,
+                newPath: destPath,
+                action: 'skipped',
+                message: `Target already exists: ${destPath} (legacy file preserved at ${expandedPath})`,
+            });
+            continue;
+        }
+        const raw = node_fs_1.default.readFileSync(expandedPath, 'utf-8');
+        let content;
+        if (expandedPath.endsWith('.json')) {
+            const parsed = JSON.parse(raw);
+            content = yaml_1.default.stringify(parsed);
+        }
+        else {
+            content = raw;
+        }
+        node_fs_1.default.writeFileSync(destPath, content, 'utf-8');
+        results.push({
+            legacyPath: expandedPath,
+            newPath: destPath,
+            action: 'migrated',
+            message: `Migrated ${expandedPath} → ${destPath}`,
+        });
+    }
+    return results;
+}
+function expandHome(filePath) {
+    if (filePath.startsWith('~/') || filePath === '~') {
+        return node_path_1.default.join(process.env.HOME || process.env.USERPROFILE || '', filePath.slice(1));
+    }
+    return filePath;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":";;;;;AAqBA,8CA2DC;AAhFD,sDAAyB;AACzB,0DAA6B;AAE7B,gDAAwB;AAExB,mCAA6C;AAgB7C,SAAgB,iBAAiB,CAAC,OAAuB;IACvD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAExC,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,0BAAkB,EAAC,MAAM,CAAC,CAAC;IAC3C,iBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChE,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QAEvD,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,0BAA0B,YAAY,EAAE;aAClD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,YAAY;gBACxB,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,0BAA0B,QAAQ,8BAA8B,YAAY,GAAG;aACzF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAGD,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,OAAe,CAAC;QAEpB,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC1D,OAAO,GAAG,cAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,GAAG,CAAC;QAChB,CAAC;QAED,iBAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE7C,OAAO,CAAC,IAAI,CAAC;YACX,UAAU,EAAE,YAAY;YACxB,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,YAAY,YAAY,MAAM,QAAQ,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAKD,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,mBAAI,CAAC,IAAI,CACd,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EACjD,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getConfigRoot(): string;
+export declare function getDomainConfigDir(domain: string): string;
+export declare function getUserConfigPath(domain: string, name: string): string;

package/dist/paths.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigRoot = getConfigRoot;
+exports.getDomainConfigDir = getDomainConfigDir;
+exports.getUserConfigPath = getUserConfigPath;
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const CONFIG_ROOT_DIR = '.aweave';
+const CONFIG_SUB_DIR = 'config';
+function getConfigRoot() {
+    if (process.env.AWEAVE_CONFIG_ROOT) {
+        return process.env.AWEAVE_CONFIG_ROOT;
+    }
+    return node_path_1.default.join(node_os_1.default.homedir(), CONFIG_ROOT_DIR, CONFIG_SUB_DIR);
+}
+function getDomainConfigDir(domain) {
+    return node_path_1.default.join(getConfigRoot(), domain);
+}
+function getUserConfigPath(domain, name) {
+    return node_path_1.default.join(getDomainConfigDir(domain), `${name}.yaml`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;AAgBA,sCAMC;AAMD,gDAEC;AAMD,8CAEC;AAtCD,sDAAyB;AACzB,0DAA6B;AAM7B,MAAM,eAAe,GAAG,SAAS,CAAC;AAClC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAQhC,SAAgB,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxC,CAAC;IAED,OAAO,mBAAI,CAAC,IAAI,CAAC,iBAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAClE,CAAC;AAMD,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,OAAO,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAMD,SAAgB,iBAAiB,CAAC,MAAc,EAAE,IAAY;IAC5D,OAAO,mBAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/projection.d.ts

@@ -0,0 +1,2 @@
+import type { ConfigFile } from './types';
+export declare function projectClientConfig<T extends ConfigFile>(config: T): Record<string, unknown>;

package/dist/projection.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectClientConfig = projectClientConfig;
+function projectClientConfig(config) {
+    return config.clientPublic ?? {};
+}
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":";;AAoBA,kDAIC;AAJD,SAAgB,mBAAmB,CACjC,MAAS;IAET,OAAO,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+import { type ConfigSchema } from './types';
+export declare function validateConfig(config: Record<string, unknown>, schema: ConfigSchema, filePath: string): void;

package/dist/schema.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+const types_1 = require("./types");
+function validateConfig(config, schema, filePath) {
+    const issues = [];
+    if (schema.configVersion != null) {
+        const actual = config.configVersion;
+        if (actual != null && actual !== schema.configVersion) {
+            issues.push({
+                path: 'configVersion',
+                message: `Expected version ${schema.configVersion}, got ${actual}`,
+                expected: String(schema.configVersion),
+                actual: String(actual),
+            });
+        }
+    }
+    for (const [fieldPath, fieldDef] of Object.entries(schema.fields)) {
+        const value = getNestedValue(config, fieldPath);
+        if (value === undefined) {
+            if (fieldDef.required) {
+                issues.push({
+                    path: fieldPath,
+                    message: `Required field is missing`,
+                    expected: fieldDef.type,
+                });
+            }
+            continue;
+        }
+        const actualType = getValueType(value);
+        if (actualType !== fieldDef.type) {
+            issues.push({
+                path: fieldPath,
+                message: `Expected type "${fieldDef.type}", got "${actualType}"`,
+                expected: fieldDef.type,
+                actual: actualType,
+            });
+        }
+    }
+    if (issues.length > 0) {
+        throw new types_1.ConfigValidationError(filePath, issues);
+    }
+}
+function getNestedValue(obj, dotPath) {
+    const keys = dotPath.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function getValueType(value) {
+    if (Array.isArray(value))
+        return 'array';
+    if (value === null)
+        return 'null';
+    return typeof value;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":";;AAkBA,wCAiDC;AAnED,mCAIiB;AAcjB,SAAgB,cAAc,CAC5B,MAA+B,EAC/B,MAAoB,EACpB,QAAgB;IAEhB,MAAM,MAAM,GAAsB,EAAE,CAAC;IAGrC,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;QACpC,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,oBAAoB,MAAM,CAAC,aAAa,SAAS,MAAM,EAAE;gBAClE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;gBACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAGD,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEhD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,2BAA2B;oBACpC,QAAQ,EAAE,QAAQ,CAAC,IAAI;iBACxB,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,UAAU,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,kBAAkB,QAAQ,CAAC,IAAI,WAAW,UAAU,GAAG;gBAChE,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,6BAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAUD,SAAS,cAAc,CACrB,GAA4B,EAC5B,OAAe;IAEf,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}

package/dist/sync.d.ts

@@ -0,0 +1,3 @@
+import { type SyncOptions, type SyncResult } from './types';
+export declare function syncDefaultConfigs(options: SyncOptions): SyncResult[];
+export declare function listDefaultConfigs(defaultsDir: string): string[];

package/dist/sync.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncDefaultConfigs = syncDefaultConfigs;
+exports.listDefaultConfigs = listDefaultConfigs;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const paths_1 = require("./paths");
+const types_1 = require("./types");
+function syncDefaultConfigs(options) {
+    const { domain, defaultsDir, force = false } = options;
+    if (!node_fs_1.default.existsSync(defaultsDir)) {
+        throw new types_1.ConfigDefaultsMissingError(defaultsDir);
+    }
+    const destDir = (0, paths_1.getDomainConfigDir)(domain);
+    node_fs_1.default.mkdirSync(destDir, { recursive: true });
+    const yamlFiles = node_fs_1.default
+        .readdirSync(defaultsDir)
+        .filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const results = [];
+    for (const file of yamlFiles) {
+        const srcPath = node_path_1.default.join(defaultsDir, file);
+        const destPath = node_path_1.default.join(destDir, file);
+        const exists = node_fs_1.default.existsSync(destPath);
+        if (exists && !force) {
+            results.push({ file, action: 'skipped', destination: destPath });
+            continue;
+        }
+        node_fs_1.default.copyFileSync(srcPath, destPath);
+        results.push({
+            file,
+            action: exists ? 'overwritten' : 'created',
+            destination: destPath,
+        });
+    }
+    return results;
+}
+function listDefaultConfigs(defaultsDir) {
+    if (!node_fs_1.default.existsSync(defaultsDir)) {
+        return [];
+    }
+    return node_fs_1.default
+        .readdirSync(defaultsDir)
+        .filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":";;;;;AAwBA,gDAmCC;AAMD,gDAQC;AAzED,sDAAyB;AACzB,0DAA6B;AAE7B,mCAA6C;AAC7C,mCAIiB;AAgBjB,SAAgB,kBAAkB,CAAC,OAAoB;IACrD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEvD,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,kCAA0B,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,0BAAkB,EAAC,MAAM,CAAC,CAAC;IAC3C,iBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,iBAAE;SACjB,WAAW,CAAC,WAAW,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QAED,iBAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YAC1C,WAAW,EAAE,QAAQ;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAMD,SAAgB,kBAAkB,CAAC,WAAmB;IACpD,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,iBAAE;SACN,WAAW,CAAC,WAAW,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export interface LoadConfigOptions {
+    domain: string;
+    name: string;
+    defaultsDir: string;
+    envOverrides?: Record<string, string>;
+}
+export interface SyncOptions {
+    domain: string;
+    defaultsDir: string;
+    force?: boolean;
+}
+export interface SyncResult {
+    file: string;
+    action: 'created' | 'skipped' | 'overwritten';
+    destination: string;
+}
+export interface MigrateOptions {
+    domain: string;
+    legacyFiles?: Record<string, string>;
+}
+export interface MigrateResult {
+    legacyPath: string;
+    newPath: string;
+    action: 'migrated' | 'skipped' | 'not_found';
+    message: string;
+}
+export interface ConfigFile {
+    configVersion?: number;
+    server?: Record<string, unknown>;
+    clientPublic?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface SchemaField {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required?: boolean;
+    description?: string;
+}
+export interface ConfigSchema {
+    configVersion?: number;
+    fields: Record<string, SchemaField>;
+}
+export interface ValidationIssue {
+    path: string;
+    message: string;
+    expected?: string;
+    actual?: string;
+}
+export declare class ConfigParseError extends Error {
+    readonly filePath: string;
+    readonly cause: Error;
+    readonly line?: number | undefined;
+    readonly column?: number | undefined;
+    constructor(filePath: string, cause: Error, line?: number | undefined, column?: number | undefined);
+}
+export declare class ConfigValidationError extends Error {
+    readonly filePath: string;
+    readonly issues: ValidationIssue[];
+    constructor(filePath: string, issues: ValidationIssue[]);
+}
+export declare class ConfigDefaultsMissingError extends Error {
+    readonly defaultsDir: string;
+    constructor(defaultsDir: string);
+}

package/dist/types.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigDefaultsMissingError = exports.ConfigValidationError = exports.ConfigParseError = void 0;
+class ConfigParseError extends Error {
+    filePath;
+    cause;
+    line;
+    column;
+    constructor(filePath, cause, line, column) {
+        const location = line != null
+            ? ` at line ${line}` + (column != null ? `, column ${column}` : '')
+            : '';
+        super(`Failed to parse config file "${filePath}"${location}: ${cause.message}`);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.line = line;
+        this.column = column;
+        this.name = 'ConfigParseError';
+    }
+}
+exports.ConfigParseError = ConfigParseError;
+class ConfigValidationError extends Error {
+    filePath;
+    issues;
+    constructor(filePath, issues) {
+        const summary = issues.map((i) => `  - ${i.path}: ${i.message}`).join('\n');
+        super(`Config validation failed for "${filePath}":\n${summary}`);
+        this.filePath = filePath;
+        this.issues = issues;
+        this.name = 'ConfigValidationError';
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+class ConfigDefaultsMissingError extends Error {
+    defaultsDir;
+    constructor(defaultsDir) {
+        super(`Defaults directory not found: "${defaultsDir}"`);
+        this.defaultsDir = defaultsDir;
+        this.name = 'ConfigDefaultsMissingError';
+    }
+}
+exports.ConfigDefaultsMissingError = ConfigDefaultsMissingError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAuFA,MAAa,gBAAiB,SAAQ,KAAK;IAEvB;IACA;IACA;IACA;IAJlB,YACkB,QAAgB,EAChB,KAAY,EACZ,IAAa,EACb,MAAe;QAE/B,MAAM,QAAQ,GACZ,IAAI,IAAI,IAAI;YACV,CAAC,CAAC,YAAY,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,CAAC,CAAC,EAAE,CAAC;QACT,KAAK,CACH,gCAAgC,QAAQ,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CACzE,CAAC;QAXc,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAO;QACZ,SAAI,GAAJ,IAAI,CAAS;QACb,WAAM,GAAN,MAAM,CAAS;QAS/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAhBD,4CAgBC;AAGD,MAAa,qBAAsB,SAAQ,KAAK;IAE5B;IACA;IAFlB,YACkB,QAAgB,EAChB,MAAyB;QAEzC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,KAAK,CAAC,iCAAiC,QAAQ,OAAO,OAAO,EAAE,CAAC,CAAC;QAJjD,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAmB;QAIzC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AATD,sDASC;AAGD,MAAa,0BAA2B,SAAQ,KAAK;IACvB;IAA5B,YAA4B,WAAmB;QAC7C,KAAK,CAAC,kCAAkC,WAAW,GAAG,CAAC,CAAC;QAD9B,gBAAW,GAAX,WAAW,CAAQ;QAE7C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AALD,gEAKC"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@aweave/config-core",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}