@venizia/ardor-kernel 0.4.2 → 0.4.3

package/dist/utilities/runtime-config.d.ts

@@ -3,6 +3,8 @@
  * The preset image writes it at container start, from the environment variables that start with `VITE_`.
  */
 export declare const RUNTIME_CONFIG_GLOBAL = "__APP_CONFIG__";
+/** The `normalized.code` of the error `getRuntimeConfig` throws for a required value that is not set; the key is in its `extra.key`. */
+export declare const RUNTIME_CONFIG_REQUIRED_CODE = "ardor.runtime_config.required";
 interface IRuntimeConfigOptions {
     key: string;
     buildTimeEnv?: Record<string, unknown>;
@@ -14,7 +16,9 @@ interface IRuntimeConfigOptions {
  * string counts, and a missing global is not an error.
  *
  * With `required: true` the result is a `string`: when all three are absent it throws, naming the
- * key and never a value. Without it, the result is `string | undefined`.
+ * key and never a value. The error is an `ApplicationError` with `normalized.code` equal to
+ * `RUNTIME_CONFIG_REQUIRED_CODE` and the key in `extra.key`, so a caller tells it from another error
+ * without reading the message. Without `required`, the result is `string | undefined`.
  */
 export declare const getRuntimeConfig: {
     (opts: IRuntimeConfigOptions & {

package/dist/utilities/runtime-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../../src/utilities/runtime-config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAmBtD,UAAU,qBAAqB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,CAAC,IAAI,EAAE,qBAAqB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,CAAC;IAC3D,CAAC,IAAI,EAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAgB5E,CAAC"}
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../../src/utilities/runtime-config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD,wIAAwI;AACxI,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAmB5E,UAAU,qBAAqB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,CAAC,IAAI,EAAE,qBAAqB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,CAAC;IAC3D,CAAC,IAAI,EAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAkB5E,CAAC"}

package/dist/utilities/runtime-config.js

@@ -4,6 +4,8 @@ import { getError } from '@venizia/ignis-inversion';
  * The preset image writes it at container start, from the environment variables that start with `VITE_`.
  */
 export const RUNTIME_CONFIG_GLOBAL = '__APP_CONFIG__';
+/** The `normalized.code` of the error `getRuntimeConfig` throws for a required value that is not set; the key is in its `extra.key`. */
+export const RUNTIME_CONFIG_REQUIRED_CODE = 'ardor.runtime_config.required';
 const readString = (opts) => {
     const { source, key } = opts;
     if (typeof source !== 'object' || source === null || Array.isArray(source)) {
@@ -22,7 +24,9 @@ const readString = (opts) => {
  * string counts, and a missing global is not an error.
  *
  * With `required: true` the result is a `string`: when all three are absent it throws, naming the
- * key and never a value. Without it, the result is `string | undefined`.
+ * key and never a value. The error is an `ApplicationError` with `normalized.code` equal to
+ * `RUNTIME_CONFIG_REQUIRED_CODE` and the key in `extra.key`, so a caller tells it from another error
+ * without reading the message. Without `required`, the result is `string | undefined`.
  */
 export const getRuntimeConfig = (opts) => {
     const { key, buildTimeEnv, defaultValue, required } = opts;
@@ -31,6 +35,8 @@ export const getRuntimeConfig = (opts) => {
         defaultValue;
     if (required && value === undefined) {
         throw getError({
+            messageCode: RUNTIME_CONFIG_REQUIRED_CODE,
+            extra: { key },
             message: `[getRuntimeConfig] '${key}' is required and not set | Write it to config.js (a VITE_ variable of the container, listed in APP_REQUIRED_ENV), or pass it in buildTimeEnv or defaultValue`,
         });
     }

package/dist/utilities/runtime-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../../src/utilities/runtime-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAEtD,MAAM,UAAU,GAAG,CAAC,IAAsC,EAAsB,EAAE;IAChF,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qEAAqE;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC,CAAC;AAQF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGzB,CAAC,IAAoD,EAAU,EAAE;IACnE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE3D,MAAM,KAAK,GACT,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,qBAAqB,CAAC,EAAE,GAAG,EAAE,CAAC;QAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;QACzC,YAAY,CAAC;IAEf,IAAI,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,uBAAuB,GAAG,+JAA+J;SACnM,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAe,CAAC;AACzB,CAAC,CAAC"}
+{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../../src/utilities/runtime-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAEtD,wIAAwI;AACxI,MAAM,CAAC,MAAM,4BAA4B,GAAG,+BAA+B,CAAC;AAE5E,MAAM,UAAU,GAAG,CAAC,IAAsC,EAAsB,EAAE;IAChF,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qEAAqE;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC,CAAC;AAQF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGzB,CAAC,IAAoD,EAAU,EAAE;IACnE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE3D,MAAM,KAAK,GACT,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,qBAAqB,CAAC,EAAE,GAAG,EAAE,CAAC;QAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;QACzC,YAAY,CAAC;IAEf,IAAI,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,QAAQ,CAAC;YACb,WAAW,EAAE,4BAA4B;YACzC,KAAK,EAAE,EAAE,GAAG,EAAE;YACd,OAAO,EAAE,uBAAuB,GAAG,+JAA+J;SACnM,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAe,CAAC;AACzB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ardor-kernel",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "ARDOR kernel - the isomorphic core of the ARDOR frontend framework: application base on IGNIS inversion, service and CRUD bases, request/auth constants, binding keys, logger, network fetchers and socket client. No React and no react-admin.",
   "keywords": [
     "ardor",
@@ -68,12 +68,12 @@
   "devDependencies": {
     "@size-limit/preset-small-lib": "^14.2.0",
     "@types/bun": "^1.4.3",
-    "@venizia/dev-configs": "^0.4.2",
-    "@venizia/ignis-connectors": "^0.4.2",
-    "@venizia/ignis-filter": "^0.4.2",
-    "@venizia/ignis-helpers": "^0.4.2",
-    "@venizia/ignis-inversion": "^0.4.2",
-    "@venizia/ignis-kernel": "^0.4.2",
+    "@venizia/dev-configs": "^0.4.3",
+    "@venizia/ignis-connectors": "^0.4.3",
+    "@venizia/ignis-filter": "^0.4.3",
+    "@venizia/ignis-helpers": "^0.4.3",
+    "@venizia/ignis-inversion": "^0.4.3",
+    "@venizia/ignis-kernel": "^0.4.3",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",