@spinajs/configuration 2.0.556 → 3.0.0

package/lib/cjs/config/configuration.d.ts

@@ -16,6 +16,7 @@
  *
  * These stay ordinary configuration values, so an app may override them in its own config - that
  * is the point of deciding it here rather than re-deriving it at each call site.
+ * `FrameworkConfiguration.load()` sets them from the `APP_ENV` it resolved, before the sources merge.
  *
  * @param env - process.env, taken as an argument so the derivation is testable without reloading
  *              the module
@@ -26,11 +27,6 @@ export declare function buildEnvironmentFlags(env: NodeJS.ProcessEnv): {
     isLocal: boolean;
 };
 declare const config: {
-    configuration: {
-        isDevelopment: boolean;
-        isProduction: boolean;
-        isLocal: boolean;
-    };
     app: {
         name: string;
         version: string;

package/lib/cjs/config/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/config/configuration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU;IAYxD,aAAa;IACb,YAAY;IACZ,OAAO;EAEV;AAED,QAAA,MAAM,MAAM;IACV,aAAa;;;;;IAEb,GAAG;QACD,IAAI;QACJ,OAAO;;CAEV,CAAC;eAEa,MAAM"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/config/configuration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU;IAYxD,aAAa;IACb,YAAY;IACZ,OAAO;EAEV;AAID,QAAA,MAAM,MAAM;IACV,GAAG;QACD,IAAI;QACJ,OAAO;;CAEV,CAAC;eAEa,MAAM"}

package/lib/cjs/config/configuration.js

@@ -20,6 +20,7 @@ const configuration_common_1 = require("@spinajs/configuration-common");
  *
  * These stay ordinary configuration values, so an app may override them in its own config - that
  * is the point of deciding it here rather than re-deriving it at each call site.
+ * `FrameworkConfiguration.load()` sets them from the `APP_ENV` it resolved, before the sources merge.
  *
  * @param env - process.env, taken as an argument so the derivation is testable without reloading
  *              the module
@@ -40,8 +41,9 @@ function buildEnvironmentFlags(env) {
         isLocal: environment === 'local',
     };
 }
+// No environment flags here: this file is evaluated at import, before `--env` and the `process.env`
+// DI value are known, and as a config file it would override the flags load() derives from them.
 const config = {
-    configuration: buildEnvironmentFlags(process.env),
     app: {
         name: 'spinajs',
         version: '1.0.0',

package/lib/cjs/config/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/config/configuration.ts"],"names":[],"mappings":";;;AAAA,wEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,+BAAsC,GAAsB;IAC1D,2EAA2E;IAC3E,iGAAiG;IACjG,uFAAuF;IACvF,EAAE;IACF,0FAA0F;IAC1F,gGAAgG;IAChG,+FAA+F;IAC/F,WAAW;IACX,MAAM,WAAW,GAAG,IAAA,2CAAoB,EAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC,CAAC;IAEvF,OAAO;QACL,aAAa,EAAE,WAAW,KAAK,KAAK;QACpC,YAAY,EAAE,WAAW,KAAK,MAAM;QACpC,OAAO,EAAE,WAAW,KAAK,OAAO;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG;IACb,aAAa,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC;IAEjD,GAAG,EAAE;QACH,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB;CACF,CAAC;kBAEa,MAAM"}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/config/configuration.ts"],"names":[],"mappings":";;;AAAA,wEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+BAAsC,GAAsB;IAC1D,2EAA2E;IAC3E,iGAAiG;IACjG,uFAAuF;IACvF,EAAE;IACF,0FAA0F;IAC1F,gGAAgG;IAChG,+FAA+F;IAC/F,WAAW;IACX,MAAM,WAAW,GAAG,IAAA,2CAAoB,EAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC,CAAC;IAEvF,OAAO;QACL,aAAa,EAAE,WAAW,KAAK,KAAK;QACpC,YAAY,EAAE,WAAW,KAAK,MAAM;QACpC,OAAO,EAAE,WAAW,KAAK,OAAO;KACjC,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,iGAAiG;AACjG,MAAM,MAAM,GAAG;IACb,GAAG,EAAE;QACH,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB;CACF,CAAC;kBAEa,MAAM"}

package/lib/cjs/configuration.d.ts

@@ -1,5 +1,6 @@
 import { ConfigurationSource, IConfigLike, Configuration, ConfigurationOptions, IConfigurationSchema } from '@spinajs/configuration-common';
-import { Class, Container } from '@spinajs/di';
+import { Class, Container, IContainer } from '@spinajs/di';
+import { InvalidConfiguration } from './exception.js';
 import './sources.js';
 /**
  * HACK:
@@ -31,6 +32,12 @@ export declare class FrameworkConfiguration extends Configuration {
      */
     protected Validator: any;
     protected ValidationSchemas: IConfigurationSchema[];
+    /** Schemas applied after boot that refused the loaded value, by schema; a read of their module throws. */
+    protected RefusedModules: Map<string, {
+        module: string[];
+        error: InvalidConfiguration;
+    }>;
+    private Loading;
     get RootConfig(): IConfigLike;
     protected Container: Container;
     /**
@@ -47,6 +54,8 @@ export declare class FrameworkConfiguration extends Configuration {
      * @param defaultValue - optional, if value at specified path not exists returns default value
      */
     get<T>(path: string[] | string, defaultValue?: T): T;
+    private isUnresolvedVar;
+    private throwIfRefused;
     /**
      * Sets at given path configuration value. Use when you want to override config
      * loaded from files programatically
@@ -68,11 +77,25 @@ export declare class FrameworkConfiguration extends Configuration {
      * Reloads configuration data
      */
     load(): Promise<void>;
+    private loadTree;
     protected loadProtocolVars(): Promise<void>;
     protected onLoad(): unknown;
     protected loadSources(): void;
     protected validate(): void;
+    /** The Configuration of `container` that has run its check but is not resolved (cached) yet. */
+    static checkedIn(container: IContainer): FrameworkConfiguration | undefined;
+    private checkAll;
+    private schemasAt;
+    private checkChange;
+    private applySchemas;
+    /** Validates one module after boot; a refused module stays refused for reads until a later check passes. */
+    validateModule(s: IConfigurationSchema): void;
+    private throwIfInvalid;
+    private checkModule;
+    private failureOf;
+    private validateInPlace;
     protected initValidator(): void;
+    private schemasOfLineage;
     protected dir(toJoin: string): string;
     /**
      * adds app dirs to system.dirs config

package/lib/cjs/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/configuration.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,oBAAoB,EAEpB,oBAAoB,EAGrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAc,KAAK,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AAK3E,OAAO,cAAc,CAAC;AAStB;;;;GAIG;AAEH,qBACa,sBAAuB,SAAQ,aAAa;IACvD;;OAEG;IACI,UAAU,SAAQ;IAEzB;;OAEG;IACI,GAAG,EAAG,MAAM,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACI,MAAM,SAAM;IAEnB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE/C,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAEtC,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAEzC;;;OAGG;IAEH,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC;IAEzB,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAEpD,IAAW,UAAU,IACG,WAAW,CAClC;IAGD,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,OAAO,CAAC,EAAE,oBAAoB,EAMzC;IAED;;;;;OAKG;IACI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAE1D;IAED;;;;;;OAMG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,QAEjD;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,QAEnD;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CpC;IAEY,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,mBAAmB,CAAC,iBASzD;IAED;;OAEG;IACU,IAAI,kBA0EhB;IAED,UAAgB,gBAAgB,kBA6E/B;IAED,SAAS,CAAC,MAAM,IAAI,OAAO,CAE1B;IAED,SAAS,CAAC,WAAW,SAYpB;IAED,SAAS,CAAC,QAAQ,SA+BjB;IAED,SAAS,CAAC,aAAa,SAmDtB;IAED,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,UAE3B;IAED;;OAEG;IACH,SAAS,CAAC,YAAY,SAQrB;IAED;;;OAGG;IACH,SAAS,CAAC,SAAS,SAalB;CACF"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/configuration.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,oBAAoB,EAEpB,oBAAoB,EAGrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAc,KAAK,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAEnF,OAAO,EAA0B,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,cAAc,CAAC;AAoFtB;;;;GAIG;AAEH,qBACa,sBAAuB,SAAQ,aAAa;IACvD;;OAEG;IACI,UAAU,SAAQ;IAEzB;;OAEG;IACI,GAAG,EAAG,MAAM,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACI,MAAM,SAAM;IAEnB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE/C,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAEtC,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAEzC;;;OAGG;IAEH,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC;IAEzB,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAEpD,0GAA0G;IAC1G,SAAS,CAAC,cAAc;gBAA6B,MAAM,EAAE;eAAS,oBAAoB;OAAM;IAEhG,OAAO,CAAC,OAAO,CAAS;IAExB,IAAW,UAAU,IACG,WAAW,CAClC;IAGD,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,OAAO,CAAC,EAAE,oBAAoB,EAMzC;IAED;;;;;OAKG;IACI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAK1D;IAED,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,cAAc;IAYtB;;;;;;OAMG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,QAMjD;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,QAMnD;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA6CpC;IAEY,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,mBAAmB,CAAC,iBAYzD;IAED;;OAEG;IACU,IAAI,kBAahB;YAEa,QAAQ;IA0EtB,UAAgB,gBAAgB,kBA+E/B;IAED,SAAS,CAAC,MAAM,IAAI,OAAO,CAE1B;IAED,SAAS,CAAC,WAAW,SAYpB;IAED,SAAS,CAAC,QAAQ,SAQjB;IAED,gGAAgG;IAChG,OAAc,SAAS,CAAC,SAAS,EAAE,UAAU,GAAG,sBAAsB,GAAG,SAAS,CAEjF;IAED,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAQpB,4GAA4G;IACrG,cAAc,CAAC,CAAC,EAAE,oBAAoB,QAU5C;IAED,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,eAAe;IASvB,SAAS,CAAC,aAAa,SAgDtB;IAGD,OAAO,CAAC,gBAAgB;IAUxB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,UAE3B;IAED;;OAEG;IACH,SAAS,CAAC,YAAY,SASrB;IAED;;;OAGG;IACH,SAAS,CAAC,SAAS,SAalB;CACF"}