@lorion-org/runtime-config-node 1.0.0-beta.0 → 1.0.0-beta.5

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the 'Software'), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the 'Software'), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -34,9 +34,9 @@ pnpm add @lorion-org/runtime-config-node @lorion-org/runtime-config
 ```text
 var/
   runtime-config/
-    billing/
+    checkout/
       runtime.config.json
-    mail/
+    payments/
       runtime.config.json
 ```
 
@@ -49,7 +49,7 @@ import { projectSectionedRuntimeConfig } from '@lorion-org/runtime-config';
 const fragments = loadRuntimeConfigTree('./var');
 const runtimeConfig = projectSectionedRuntimeConfig(fragments);
 
-runtimeConfig.public.billingApiBase;
+runtimeConfig.public.checkoutSuccessPath;
 ```
 
 ## Single fragment example
@@ -57,9 +57,9 @@ runtimeConfig.public.billingApiBase;
 ```ts
 import { loadRuntimeConfigFragment } from '@lorion-org/runtime-config-node';
 
-const billing = loadRuntimeConfigFragment('./var', 'billing');
+const checkout = loadRuntimeConfigFragment('./var', 'checkout');
 
-billing?.public?.apiBase;
+checkout?.public?.successPath;
 ```
 
 ## Source and scope file example
@@ -81,11 +81,11 @@ const source = resolveRuntimeConfigSource({
   envKey: 'APP_VAR_DIR',
 });
 
-readRuntimeConfigScopeJson(source, 'billing', 'settings.json');
-// => { apiBase: '/api/billing' }
+readRuntimeConfigScopeJson(source, 'checkout', 'settings.json');
+// => { successPath: '/orders/confirmed' }
 
-resolveRuntimeConfigPublicFilePath(source, 'billing/logo.svg');
-// => '/absolute/project/path/var/runtime-config/public/billing/logo.svg'
+resolveRuntimeConfigPublicFilePath(source, 'checkout/logo.svg');
+// => '/absolute/project/path/var/runtime-config/public/checkout/logo.svg'
 ```
 
 ## Pattern source example
@@ -106,12 +106,12 @@ const source = {
 };
 
 resolveRuntimeConfigSourceFiles(source);
-// => [{ scopeId: 'billing', configPath: '/project/.runtimeconfig/runtime-config/billing/runtime.config.json', ... }]
+// => [{ scopeId: 'checkout', configPath: '/project/.runtimeconfig/runtime-config/checkout/runtime.config.json', ... }]
 
-loadRuntimeConfigSourceTree(source).get('billing')?.public?.apiBase;
-// => '/api/billing'
+loadRuntimeConfigSourceTree(source).get('checkout')?.public?.successPath;
+// => '/orders/confirmed'
 
-validateRuntimeConfigSourceScopes(source, [{ scopeId: 'billing', cwd: './extensions/billing' }]);
+validateRuntimeConfigSourceScopes(source, [{ scopeId: 'checkout', cwd: './extensions/checkout' }]);
 ```
 
 ## Write fragment example
@@ -119,9 +119,9 @@ validateRuntimeConfigSourceScopes(source, [{ scopeId: 'billing', cwd: './extensi
 ```ts
 import { writeRuntimeConfigFragment } from '@lorion-org/runtime-config-node';
 
-writeRuntimeConfigFragment('./var', 'billing', {
+writeRuntimeConfigFragment('./var', 'checkout', {
   public: {
-    apiBase: '/api/billing',
+    successPath: '/orders/confirmed',
   },
 });
 ```
@@ -137,7 +137,7 @@ import { loadRuntimeConfigShellAssignments } from '@lorion-org/runtime-config-no
 loadRuntimeConfigShellAssignments('./var', {
   prefix: 'APP',
 });
-// => APP_PUBLIC_BILLING_API_BASE='"/api/billing"'
+// => APP_PUBLIC_CHECKOUT_SUCCESS_PATH='"/orders/confirmed"'
 ```
 
 ## Tree query example
@@ -154,16 +154,16 @@ import {
 } from '@lorion-org/runtime-config-node';
 
 listRuntimeConfigFragments('./var');
-// => { scopes: [{ scopeId: 'billing', ... }] }
+// => { scopes: [{ scopeId: 'checkout', ... }] }
 
-projectRuntimeConfigTree('./var').runtimeConfig.public.billingApiBase;
-// => '/api/billing'
+projectRuntimeConfigTree('./var').runtimeConfig.public.checkoutSuccessPath;
+// => '/orders/confirmed'
 
-getRuntimeConfigValue('./var', 'billing', 'apiBase').value;
-// => '/api/billing'
+getRuntimeConfigValue('./var', 'checkout', 'successPath').value;
+// => '/orders/confirmed'
 
-getRuntimeConfigScopeView('./var', 'billing').config;
-// => { apiBase: '/api/billing' }
+getRuntimeConfigScopeView('./var', 'checkout').config;
+// => { successPath: '/orders/confirmed' }
 ```
 
 ## Schema validation example
@@ -176,9 +176,9 @@ import { validateRuntimeConfigSchemaTargets } from '@lorion-org/runtime-config-n
 
 validateRuntimeConfigSchemaTargets([
   {
-    scopeId: 'billing',
-    schemaPath: './schemas/billing.schema.json',
-    configPath: './var/runtime-config/billing/runtime.config.json',
+    scopeId: 'checkout',
+    schemaPath: './schemas/checkout.schema.json',
+    configPath: './var/runtime-config/checkout/runtime.config.json',
   },
 ]);
 ```
@@ -187,7 +187,7 @@ For adapters that resolve schema locations from scope directories, use
 `validateRuntimeConfigScopes(...)` to collect `validated` and `skipped`
 targets before the AJV validation runs.
 
-Runnable example files live in [`examples/`](./examples).
+Runnable example files live in [`snippets/`](./snippets).
 
 ## Local commands
 

package/dist/index.cjs

@@ -30,7 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  assertRequiredRuntimeConfigValidationTargets: () => assertRequiredRuntimeConfigValidationTargets,
   collectRuntimeConfigFragmentFiles: () => collectRuntimeConfigFragmentFiles,
+  collectRuntimeConfigSchemaTargetValidationErrors: () => collectRuntimeConfigSchemaTargetValidationErrors,
   ensureParentDir: () => ensureParentDir,
   getRuntimeConfigScopeView: () => getRuntimeConfigScopeView,
   getRuntimeConfigValue: () => getRuntimeConfigValue,
@@ -45,6 +47,7 @@ __export(index_exports, {
   projectRuntimeConfigTree: () => projectRuntimeConfigTree,
   readJsonFile: () => readJsonFile,
   readRequiredJsonFile: () => readRequiredJsonFile,
+  readRuntimeConfigSchemaRegistry: () => readRuntimeConfigSchemaRegistry,
   readRuntimeConfigScopeJson: () => readRuntimeConfigScopeJson,
   readTextFile: () => readTextFile,
   resolveRuntimeConfigFilePath: () => resolveRuntimeConfigFilePath,
@@ -162,6 +165,35 @@ function getRuntimeConfigPathOptions(source) {
 function getSchemaFileName(options) {
   return options.schemaFileName ?? defaultRuntimeConfigSchemaFileName;
 }
+function formatMissingRuntimeConfigValidationError(skipped) {
+  if (skipped.reason === "missing-schema") {
+    return new Error(
+      [
+        `RuntimeConfig schema file missing for scope "${skipped.scopeId}".`,
+        ...skipped.schemaPath ? [`missing schema file: ${skipped.schemaPath}`] : [],
+        ...skipped.configPath ? [`runtime config file: ${skipped.configPath}`] : []
+      ].join(" ")
+    );
+  }
+  if (skipped.reason === "missing-config") {
+    return new Error(
+      [
+        `RuntimeConfig file missing for scope "${skipped.scopeId}".`,
+        ...skipped.configPath ? [`expected runtime config file: ${skipped.configPath}`] : [],
+        ...skipped.schemaPath ? [`schema file: ${skipped.schemaPath}`] : []
+      ].join(" ")
+    );
+  }
+  const details = [
+    `RuntimeConfig validation target has no schema directory for scope "${skipped.scopeId}".`
+  ];
+  if (skipped.configPath) details.push(`runtime config file: ${skipped.configPath}`);
+  if (skipped.schemaPath) details.push(`schema file: ${skipped.schemaPath}`);
+  return new Error(details.join(" "));
+}
+function shouldReportMissingRuntimeConfig(mode) {
+  return mode !== "optional";
+}
 function stripJsonBom(text) {
   return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
 }
@@ -338,12 +370,19 @@ function formatRuntimeConfigSchemaValidationError(target, validationError) {
   );
 }
 function validateRuntimeConfigSchemaTargets(targets, options = {}) {
+  const invalid = collectRuntimeConfigSchemaTargetValidationErrors(targets, options);
+  if (invalid[0]) {
+    throw invalid[0].error;
+  }
+}
+function collectRuntimeConfigSchemaTargetValidationErrors(targets, options = {}) {
   const ajv = new import_ajv.default({
     strict: false,
     allErrors: false,
     ...options.ajvOptions
   });
   const formatError = options.formatError ?? formatRuntimeConfigSchemaValidationError;
+  const invalid = [];
   for (const target of targets) {
     if (!(0, import_node_fs.existsSync)(target.schemaPath) || !(0, import_node_fs.existsSync)(target.configPath)) {
       continue;
@@ -355,13 +394,21 @@ function validateRuntimeConfigSchemaTargets(targets, options = {}) {
     if (!isValid) {
       const validationError = validate.errors?.[0];
       if (validationError) {
-        throw formatError(target, validationError);
+        invalid.push({
+          ...target,
+          error: formatError(target, validationError)
+        });
+        continue;
       }
-      throw new Error(
-        `RuntimeConfig schema validation failed for "${target.scopeId}" (${target.configPath})`
-      );
+      invalid.push({
+        ...target,
+        error: new Error(
+          `RuntimeConfig schema validation failed for "${target.scopeId}" (${target.configPath})`
+        )
+      });
     }
   }
+  return invalid;
 }
 function loadRuntimeConfigTree(varDir, options = {}) {
   const runtimeConfigDir = import_node_path.default.join(varDir, getRuntimeConfigDirName(options));
@@ -480,21 +527,28 @@ function validateRuntimeConfigScopes(varDir, targets, options = {}) {
   const schemaFileName = getSchemaFileName(options);
   const result = {
     fileName: getFileName(options),
+    invalid: [],
     skipped: [],
     validated: [],
     varDir
   };
   for (const target of targets) {
+    if (!(0, import_runtime_config.shouldRegisterRuntimeConfigValidationSchema)(target.policy)) continue;
     const scopeId = target.scopeId.trim();
     if (!scopeId) continue;
+    const mode = (0, import_runtime_config.resolveRuntimeConfigValidationMode)(target.policy);
     const configPath = resolveRuntimeConfigPaths(varDir, scopeId, options).filePath;
     const schemaPath = target.cwd ? import_node_path.default.resolve(target.cwd, schemaFileName) : void 0;
     if (!target.cwd || !schemaPath) {
-      result.skipped.push({ configPath, reason: "missing-scope-dir", scopeId });
+      if (shouldReportMissingRuntimeConfig(mode)) {
+        result.skipped.push({ configPath, reason: "missing-scope-dir", scopeId });
+      }
       continue;
     }
     if (!(0, import_node_fs.existsSync)(configPath)) {
-      result.skipped.push({ configPath, reason: "missing-config", schemaPath, scopeId });
+      if (shouldReportMissingRuntimeConfig(mode)) {
+        result.skipped.push({ configPath, reason: "missing-config", schemaPath, scopeId });
+      }
       continue;
     }
     if (!(0, import_node_fs.existsSync)(schemaPath)) {
@@ -503,16 +557,45 @@ function validateRuntimeConfigScopes(varDir, targets, options = {}) {
     }
     result.validated.push({ configPath, schemaPath, scopeId });
   }
-  validateRuntimeConfigSchemaTargets(result.validated, {
+  result.invalid = collectRuntimeConfigSchemaTargetValidationErrors(result.validated, {
     ...options.formatError ? { formatError: options.formatError } : {}
   });
   return result;
 }
+function readRuntimeConfigSchemaRegistry(targets, options = {}) {
+  const schemaFileName = options.schemaFileName ?? defaultRuntimeConfigSchemaFileName;
+  const entries = targets.filter((target) => (0, import_runtime_config.shouldRegisterRuntimeConfigValidationSchema)(target.policy)).flatMap((target) => {
+    const scopeId = target.scopeId.trim();
+    if (!scopeId || !target.cwd) return [];
+    const schemaPath = import_node_path.default.resolve(target.cwd, schemaFileName);
+    if (!(0, import_node_fs.existsSync)(schemaPath)) return [];
+    return [[scopeId, readRequiredJsonFile(schemaPath)]];
+  });
+  return Object.fromEntries(entries);
+}
+function assertRequiredRuntimeConfigValidationTargets(result, targets) {
+  const requiredScopeIds = new Set(
+    targets.filter((target) => (0, import_runtime_config.shouldRequireRuntimeConfigAtStartup)(target.policy)).map((target) => target.scopeId.trim()).filter(Boolean)
+  );
+  const requiredFailures = [
+    ...result.skipped.filter((entry) => requiredScopeIds.has(entry.scopeId)).map(formatMissingRuntimeConfigValidationError),
+    ...result.invalid.filter((entry) => requiredScopeIds.has(entry.scopeId)).map((entry) => entry.error)
+  ];
+  if (requiredFailures.length) {
+    throw new Error(
+      [
+        "RuntimeConfig startup validation failed.",
+        ...requiredFailures.map((error) => error.message)
+      ].join("\n\n")
+    );
+  }
+}
 function validateRuntimeConfigSourceScopes(source, targets, options = {}) {
   const schemaFileName = getSchemaFileName(options);
   const filesByScope = /* @__PURE__ */ new Map();
   const result = {
     fileName: source.paths[0] ?? "",
+    invalid: [],
     skipped: [],
     validated: [],
     varDir: ""
@@ -521,20 +604,26 @@ function validateRuntimeConfigSourceScopes(source, targets, options = {}) {
     filesByScope.set(file.scopeId, file.configPath);
   }
   for (const target of targets) {
+    if (!(0, import_runtime_config.shouldRegisterRuntimeConfigValidationSchema)(target.policy)) continue;
     const scopeId = target.scopeId.trim();
     if (!scopeId) continue;
+    const mode = (0, import_runtime_config.resolveRuntimeConfigValidationMode)(target.policy);
     const configPath = filesByScope.get(scopeId);
     const schemaPath = target.cwd ? import_node_path.default.resolve(target.cwd, schemaFileName) : void 0;
     if (!target.cwd || !schemaPath) {
-      result.skipped.push({
-        ...configPath ? { configPath } : {},
-        reason: "missing-scope-dir",
-        scopeId
-      });
+      if (shouldReportMissingRuntimeConfig(mode)) {
+        result.skipped.push({
+          ...configPath ? { configPath } : {},
+          reason: "missing-scope-dir",
+          scopeId
+        });
+      }
       continue;
     }
     if (!configPath) {
-      result.skipped.push({ reason: "missing-config", schemaPath, scopeId });
+      if (shouldReportMissingRuntimeConfig(mode)) {
+        result.skipped.push({ reason: "missing-config", schemaPath, scopeId });
+      }
       continue;
     }
     if (!(0, import_node_fs.existsSync)(schemaPath)) {
@@ -543,14 +632,16 @@ function validateRuntimeConfigSourceScopes(source, targets, options = {}) {
     }
     result.validated.push({ configPath, schemaPath, scopeId });
   }
-  validateRuntimeConfigSchemaTargets(result.validated, {
+  result.invalid = collectRuntimeConfigSchemaTargetValidationErrors(result.validated, {
     ...options.formatError ? { formatError: options.formatError } : {}
   });
   return result;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  assertRequiredRuntimeConfigValidationTargets,
   collectRuntimeConfigFragmentFiles,
+  collectRuntimeConfigSchemaTargetValidationErrors,
   ensureParentDir,
   getRuntimeConfigScopeView,
   getRuntimeConfigValue,
@@ -565,6 +656,7 @@ function validateRuntimeConfigSourceScopes(source, targets, options = {}) {
   projectRuntimeConfigTree,
   readJsonFile,
   readRequiredJsonFile,
+  readRuntimeConfigSchemaRegistry,
   readRuntimeConfigScopeJson,
   readTextFile,
   resolveRuntimeConfigFilePath,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { ErrorObject, Options } from 'ajv';
-import { ProjectRuntimeConfigEnvVarsOptions, SectionedRuntimeConfig, ConfigVisibility, RuntimeConfigSection, RuntimeConfigFragment, RuntimeEnvVars, RuntimeConfigFragmentMap } from '@lorion-org/runtime-config';
+import { ProjectRuntimeConfigEnvVarsOptions, SectionedRuntimeConfig, RuntimeConfigValidationPolicyInput, ConfigVisibility, RuntimeConfigSection, RuntimeConfigFragment, RuntimeEnvVars, RuntimeConfigFragmentMap, RuntimeConfigValidationSchemaRegistry } from '@lorion-org/runtime-config';
 
 type RuntimeConfigPaths = {
     varDir: string;
@@ -111,6 +111,7 @@ type RuntimeConfigScopeViewResult = {
 };
 type RuntimeConfigSchemaTargetInput = {
     cwd?: string;
+    policy?: RuntimeConfigValidationPolicyInput;
     scopeId: string;
 };
 type RuntimeConfigValidationEntry = {
@@ -124,6 +125,9 @@ type RuntimeConfigValidationSkippedEntry = {
     schemaPath?: string;
     scopeId: string;
 };
+type RuntimeConfigValidationInvalidEntry = RuntimeConfigSchemaValidationTarget & {
+    error: Error;
+};
 type ValidateRuntimeConfigScopesOptions = RuntimeConfigPathOptions & {
     formatError?: RuntimeConfigSchemaValidationErrorFormatter;
     schemaFileName?: string;
@@ -131,10 +135,14 @@ type ValidateRuntimeConfigScopesOptions = RuntimeConfigPathOptions & {
 type ValidateRuntimeConfigPatternSourceScopesOptions = Pick<ValidateRuntimeConfigScopesOptions, 'formatError' | 'schemaFileName'>;
 type RuntimeConfigValidateResult = {
     fileName: string;
+    invalid: RuntimeConfigValidationInvalidEntry[];
     skipped: RuntimeConfigValidationSkippedEntry[];
     validated: RuntimeConfigValidationEntry[];
     varDir: string;
 };
+type ReadRuntimeConfigSchemaRegistryOptions = {
+    schemaFileName?: string;
+};
 declare function ensureParentDir(filePath: string): void;
 declare function readTextFile(filePath: string): string | undefined;
 declare function writeTextFile(filePath: string, data: string, options?: WriteFileOptions): void;
@@ -160,6 +168,7 @@ declare function parseRuntimeConfigFragmentFiles(filePaths: string[], runtimeCon
 declare function loadRuntimeConfigFragment(varDir: string, scopeId: string, options?: RuntimeConfigPathOptions): RuntimeConfigFragment | undefined;
 declare function writeRuntimeConfigFragment(varDir: string, scopeId: string, config: RuntimeConfigFragment, options?: RuntimeConfigPathOptions & WriteJsonFileOptions): void;
 declare function validateRuntimeConfigSchemaTargets(targets: RuntimeConfigSchemaValidationTarget[], options?: ValidateRuntimeConfigSchemaTargetsOptions): void;
+declare function collectRuntimeConfigSchemaTargetValidationErrors(targets: RuntimeConfigSchemaValidationTarget[], options?: ValidateRuntimeConfigSchemaTargetsOptions): RuntimeConfigValidationInvalidEntry[];
 declare function loadRuntimeConfigTree(varDir: string, options?: RuntimeConfigPathOptions): RuntimeConfigFragmentMap;
 declare function loadRuntimeConfigEnvVars(varDir: string, options?: RuntimeConfigEnvFileOptions): RuntimeEnvVars;
 declare function loadRuntimeConfigShellAssignments(varDir: string, options?: RuntimeConfigEnvFileOptions): string;
@@ -169,6 +178,8 @@ declare function projectRuntimeConfigTree(varDir: string, options?: RuntimeConfi
 declare function getRuntimeConfigValue(varDir: string, scopeId: string, key: string, options?: RuntimeConfigValueQueryOptions): RuntimeConfigValueResult;
 declare function getRuntimeConfigScopeView(varDir: string, scopeId: string, options?: RuntimeConfigScopeViewOptions): RuntimeConfigScopeViewResult;
 declare function validateRuntimeConfigScopes(varDir: string, targets: RuntimeConfigSchemaTargetInput[], options?: ValidateRuntimeConfigScopesOptions): RuntimeConfigValidateResult;
+declare function readRuntimeConfigSchemaRegistry(targets: RuntimeConfigSchemaTargetInput[], options?: ReadRuntimeConfigSchemaRegistryOptions): RuntimeConfigValidationSchemaRegistry;
+declare function assertRequiredRuntimeConfigValidationTargets(result: RuntimeConfigValidateResult, targets: RuntimeConfigSchemaTargetInput[]): void;
 declare function validateRuntimeConfigSourceScopes(source: RuntimeConfigPathPatternSource, targets: RuntimeConfigSchemaTargetInput[], options?: ValidateRuntimeConfigPatternSourceScopesOptions): RuntimeConfigValidateResult;
 
-export { type ReadJsonFileOptions, type ResolveRuntimeConfigSourceOptions, type RuntimeConfigEnvFileOptions, type RuntimeConfigListEntry, type RuntimeConfigListOptions, type RuntimeConfigListResult, type RuntimeConfigPathOptions, type RuntimeConfigPathPatternSource, type RuntimeConfigPaths, type RuntimeConfigProjectOptions, type RuntimeConfigProjectResult, type RuntimeConfigSchemaTargetInput, type RuntimeConfigSchemaValidationErrorFormatter, type RuntimeConfigSchemaValidationTarget, type RuntimeConfigScopeViewOptions, type RuntimeConfigScopeViewResult, type RuntimeConfigShowResult, type RuntimeConfigSource, type RuntimeConfigSourceFile, type RuntimeConfigValidateResult, type RuntimeConfigValidationEntry, type RuntimeConfigValidationSkippedEntry, type RuntimeConfigValueQueryOptions, type RuntimeConfigValueResult, type ValidateRuntimeConfigPatternSourceScopesOptions, type ValidateRuntimeConfigSchemaTargetsOptions, type ValidateRuntimeConfigScopesOptions, type WriteFileOptions, type WriteJsonFileOptions, collectRuntimeConfigFragmentFiles, ensureParentDir, getRuntimeConfigScopeView, getRuntimeConfigValue, listRuntimeConfigFragments, listRuntimeConfigScopeFiles, loadRuntimeConfigEnvVars, loadRuntimeConfigFragment, loadRuntimeConfigShellAssignments, loadRuntimeConfigSourceTree, loadRuntimeConfigTree, parseRuntimeConfigFragmentFiles, projectRuntimeConfigTree, readJsonFile, readRequiredJsonFile, readRuntimeConfigScopeJson, readTextFile, resolveRuntimeConfigFilePath, resolveRuntimeConfigPaths, resolveRuntimeConfigPublicFilePath, resolveRuntimeConfigPublicRootPath, resolveRuntimeConfigScopeFilePath, resolveRuntimeConfigSource, resolveRuntimeConfigSourceFiles, resolveRuntimeConfigSourcePublicRootPath, showRuntimeConfigFragment, validateRuntimeConfigSchemaTargets, validateRuntimeConfigScopes, validateRuntimeConfigSourceScopes, writeJsonFile, writeRuntimeConfigFragment, writeRuntimeConfigScopeJson, writeTextFile };
+export { type ReadJsonFileOptions, type ReadRuntimeConfigSchemaRegistryOptions, type ResolveRuntimeConfigSourceOptions, type RuntimeConfigEnvFileOptions, type RuntimeConfigListEntry, type RuntimeConfigListOptions, type RuntimeConfigListResult, type RuntimeConfigPathOptions, type RuntimeConfigPathPatternSource, type RuntimeConfigPaths, type RuntimeConfigProjectOptions, type RuntimeConfigProjectResult, type RuntimeConfigSchemaTargetInput, type RuntimeConfigSchemaValidationErrorFormatter, type RuntimeConfigSchemaValidationTarget, type RuntimeConfigScopeViewOptions, type RuntimeConfigScopeViewResult, type RuntimeConfigShowResult, type RuntimeConfigSource, type RuntimeConfigSourceFile, type RuntimeConfigValidateResult, type RuntimeConfigValidationEntry, type RuntimeConfigValidationInvalidEntry, type RuntimeConfigValidationSkippedEntry, type RuntimeConfigValueQueryOptions, type RuntimeConfigValueResult, type ValidateRuntimeConfigPatternSourceScopesOptions, type ValidateRuntimeConfigSchemaTargetsOptions, type ValidateRuntimeConfigScopesOptions, type WriteFileOptions, type WriteJsonFileOptions, assertRequiredRuntimeConfigValidationTargets, collectRuntimeConfigFragmentFiles, collectRuntimeConfigSchemaTargetValidationErrors, ensureParentDir, getRuntimeConfigScopeView, getRuntimeConfigValue, listRuntimeConfigFragments, listRuntimeConfigScopeFiles, loadRuntimeConfigEnvVars, loadRuntimeConfigFragment, loadRuntimeConfigShellAssignments, loadRuntimeConfigSourceTree, loadRuntimeConfigTree, parseRuntimeConfigFragmentFiles, projectRuntimeConfigTree, readJsonFile, readRequiredJsonFile, readRuntimeConfigSchemaRegistry, readRuntimeConfigScopeJson, readTextFile, resolveRuntimeConfigFilePath, resolveRuntimeConfigPaths, resolveRuntimeConfigPublicFilePath, resolveRuntimeConfigPublicRootPath, resolveRuntimeConfigScopeFilePath, resolveRuntimeConfigSource, resolveRuntimeConfigSourceFiles, resolveRuntimeConfigSourcePublicRootPath, showRuntimeConfigFragment, validateRuntimeConfigSchemaTargets, validateRuntimeConfigScopes, validateRuntimeConfigSourceScopes, writeJsonFile, writeRuntimeConfigFragment, writeRuntimeConfigScopeJson, writeTextFile };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ErrorObject, Options } from 'ajv';
-import { ProjectRuntimeConfigEnvVarsOptions, SectionedRuntimeConfig, ConfigVisibility, RuntimeConfigSection, RuntimeConfigFragment, RuntimeEnvVars, RuntimeConfigFragmentMap } from '@lorion-org/runtime-config';
+import { ProjectRuntimeConfigEnvVarsOptions, SectionedRuntimeConfig, RuntimeConfigValidationPolicyInput, ConfigVisibility, RuntimeConfigSection, RuntimeConfigFragment, RuntimeEnvVars, RuntimeConfigFragmentMap, RuntimeConfigValidationSchemaRegistry } from '@lorion-org/runtime-config';
 
 type RuntimeConfigPaths = {
     varDir: string;
@@ -111,6 +111,7 @@ type RuntimeConfigScopeViewResult = {
 };
 type RuntimeConfigSchemaTargetInput = {
     cwd?: string;
+    policy?: RuntimeConfigValidationPolicyInput;
     scopeId: string;
 };
 type RuntimeConfigValidationEntry = {
@@ -124,6 +125,9 @@ type RuntimeConfigValidationSkippedEntry = {
     schemaPath?: string;
     scopeId: string;
 };
+type RuntimeConfigValidationInvalidEntry = RuntimeConfigSchemaValidationTarget & {
+    error: Error;
+};
 type ValidateRuntimeConfigScopesOptions = RuntimeConfigPathOptions & {
     formatError?: RuntimeConfigSchemaValidationErrorFormatter;
     schemaFileName?: string;
@@ -131,10 +135,14 @@ type ValidateRuntimeConfigScopesOptions = RuntimeConfigPathOptions & {
 type ValidateRuntimeConfigPatternSourceScopesOptions = Pick<ValidateRuntimeConfigScopesOptions, 'formatError' | 'schemaFileName'>;
 type RuntimeConfigValidateResult = {
     fileName: string;
+    invalid: RuntimeConfigValidationInvalidEntry[];
     skipped: RuntimeConfigValidationSkippedEntry[];
     validated: RuntimeConfigValidationEntry[];
     varDir: string;
 };
+type ReadRuntimeConfigSchemaRegistryOptions = {
+    schemaFileName?: string;
+};
 declare function ensureParentDir(filePath: string): void;
 declare function readTextFile(filePath: string): string | undefined;
 declare function writeTextFile(filePath: string, data: string, options?: WriteFileOptions): void;
@@ -160,6 +168,7 @@ declare function parseRuntimeConfigFragmentFiles(filePaths: string[], runtimeCon
 declare function loadRuntimeConfigFragment(varDir: string, scopeId: string, options?: RuntimeConfigPathOptions): RuntimeConfigFragment | undefined;
 declare function writeRuntimeConfigFragment(varDir: string, scopeId: string, config: RuntimeConfigFragment, options?: RuntimeConfigPathOptions & WriteJsonFileOptions): void;
 declare function validateRuntimeConfigSchemaTargets(targets: RuntimeConfigSchemaValidationTarget[], options?: ValidateRuntimeConfigSchemaTargetsOptions): void;
+declare function collectRuntimeConfigSchemaTargetValidationErrors(targets: RuntimeConfigSchemaValidationTarget[], options?: ValidateRuntimeConfigSchemaTargetsOptions): RuntimeConfigValidationInvalidEntry[];
 declare function loadRuntimeConfigTree(varDir: string, options?: RuntimeConfigPathOptions): RuntimeConfigFragmentMap;
 declare function loadRuntimeConfigEnvVars(varDir: string, options?: RuntimeConfigEnvFileOptions): RuntimeEnvVars;
 declare function loadRuntimeConfigShellAssignments(varDir: string, options?: RuntimeConfigEnvFileOptions): string;
@@ -169,6 +178,8 @@ declare function projectRuntimeConfigTree(varDir: string, options?: RuntimeConfi
 declare function getRuntimeConfigValue(varDir: string, scopeId: string, key: string, options?: RuntimeConfigValueQueryOptions): RuntimeConfigValueResult;
 declare function getRuntimeConfigScopeView(varDir: string, scopeId: string, options?: RuntimeConfigScopeViewOptions): RuntimeConfigScopeViewResult;
 declare function validateRuntimeConfigScopes(varDir: string, targets: RuntimeConfigSchemaTargetInput[], options?: ValidateRuntimeConfigScopesOptions): RuntimeConfigValidateResult;
+declare function readRuntimeConfigSchemaRegistry(targets: RuntimeConfigSchemaTargetInput[], options?: ReadRuntimeConfigSchemaRegistryOptions): RuntimeConfigValidationSchemaRegistry;
+declare function assertRequiredRuntimeConfigValidationTargets(result: RuntimeConfigValidateResult, targets: RuntimeConfigSchemaTargetInput[]): void;
 declare function validateRuntimeConfigSourceScopes(source: RuntimeConfigPathPatternSource, targets: RuntimeConfigSchemaTargetInput[], options?: ValidateRuntimeConfigPatternSourceScopesOptions): RuntimeConfigValidateResult;
 
-export { type ReadJsonFileOptions, type ResolveRuntimeConfigSourceOptions, type RuntimeConfigEnvFileOptions, type RuntimeConfigListEntry, type RuntimeConfigListOptions, type RuntimeConfigListResult, type RuntimeConfigPathOptions, type RuntimeConfigPathPatternSource, type RuntimeConfigPaths, type RuntimeConfigProjectOptions, type RuntimeConfigProjectResult, type RuntimeConfigSchemaTargetInput, type RuntimeConfigSchemaValidationErrorFormatter, type RuntimeConfigSchemaValidationTarget, type RuntimeConfigScopeViewOptions, type RuntimeConfigScopeViewResult, type RuntimeConfigShowResult, type RuntimeConfigSource, type RuntimeConfigSourceFile, type RuntimeConfigValidateResult, type RuntimeConfigValidationEntry, type RuntimeConfigValidationSkippedEntry, type RuntimeConfigValueQueryOptions, type RuntimeConfigValueResult, type ValidateRuntimeConfigPatternSourceScopesOptions, type ValidateRuntimeConfigSchemaTargetsOptions, type ValidateRuntimeConfigScopesOptions, type WriteFileOptions, type WriteJsonFileOptions, collectRuntimeConfigFragmentFiles, ensureParentDir, getRuntimeConfigScopeView, getRuntimeConfigValue, listRuntimeConfigFragments, listRuntimeConfigScopeFiles, loadRuntimeConfigEnvVars, loadRuntimeConfigFragment, loadRuntimeConfigShellAssignments, loadRuntimeConfigSourceTree, loadRuntimeConfigTree, parseRuntimeConfigFragmentFiles, projectRuntimeConfigTree, readJsonFile, readRequiredJsonFile, readRuntimeConfigScopeJson, readTextFile, resolveRuntimeConfigFilePath, resolveRuntimeConfigPaths, resolveRuntimeConfigPublicFilePath, resolveRuntimeConfigPublicRootPath, resolveRuntimeConfigScopeFilePath, resolveRuntimeConfigSource, resolveRuntimeConfigSourceFiles, resolveRuntimeConfigSourcePublicRootPath, showRuntimeConfigFragment, validateRuntimeConfigSchemaTargets, validateRuntimeConfigScopes, validateRuntimeConfigSourceScopes, writeJsonFile, writeRuntimeConfigFragment, writeRuntimeConfigScopeJson, writeTextFile };
+export { type ReadJsonFileOptions, type ReadRuntimeConfigSchemaRegistryOptions, type ResolveRuntimeConfigSourceOptions, type RuntimeConfigEnvFileOptions, type RuntimeConfigListEntry, type RuntimeConfigListOptions, type RuntimeConfigListResult, type RuntimeConfigPathOptions, type RuntimeConfigPathPatternSource, type RuntimeConfigPaths, type RuntimeConfigProjectOptions, type RuntimeConfigProjectResult, type RuntimeConfigSchemaTargetInput, type RuntimeConfigSchemaValidationErrorFormatter, type RuntimeConfigSchemaValidationTarget, type RuntimeConfigScopeViewOptions, type RuntimeConfigScopeViewResult, type RuntimeConfigShowResult, type RuntimeConfigSource, type RuntimeConfigSourceFile, type RuntimeConfigValidateResult, type RuntimeConfigValidationEntry, type RuntimeConfigValidationInvalidEntry, type RuntimeConfigValidationSkippedEntry, type RuntimeConfigValueQueryOptions, type RuntimeConfigValueResult, type ValidateRuntimeConfigPatternSourceScopesOptions, type ValidateRuntimeConfigSchemaTargetsOptions, type ValidateRuntimeConfigScopesOptions, type WriteFileOptions, type WriteJsonFileOptions, assertRequiredRuntimeConfigValidationTargets, collectRuntimeConfigFragmentFiles, collectRuntimeConfigSchemaTargetValidationErrors, ensureParentDir, getRuntimeConfigScopeView, getRuntimeConfigValue, listRuntimeConfigFragments, listRuntimeConfigScopeFiles, loadRuntimeConfigEnvVars, loadRuntimeConfigFragment, loadRuntimeConfigShellAssignments, loadRuntimeConfigSourceTree, loadRuntimeConfigTree, parseRuntimeConfigFragmentFiles, projectRuntimeConfigTree, readJsonFile, readRequiredJsonFile, readRuntimeConfigSchemaRegistry, readRuntimeConfigScopeJson, readTextFile, resolveRuntimeConfigFilePath, resolveRuntimeConfigPaths, resolveRuntimeConfigPublicFilePath, resolveRuntimeConfigPublicRootPath, resolveRuntimeConfigScopeFilePath, resolveRuntimeConfigSource, resolveRuntimeConfigSourceFiles, resolveRuntimeConfigSourcePublicRootPath, showRuntimeConfigFragment, validateRuntimeConfigSchemaTargets, validateRuntimeConfigScopes, validateRuntimeConfigSourceScopes, writeJsonFile, writeRuntimeConfigFragment, writeRuntimeConfigScopeJson, writeTextFile };