@rxap/config 19.2.0-dev.1 → 19.2.0-dev.3

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [19.2.0-dev.3](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.2...@rxap/config@19.2.0-dev.3) (2026-01-19)
+
+### Features
+
+- **config:** add `strategy` option and FIFO handling for dynamic config loading ([7534069](https://gitlab.com/rxap/packages/commit/7534069a897493c402d3164d6bb7df7b3f1dc9dd))
+
+# [19.2.0-dev.2](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.1...@rxap/config@19.2.0-dev.2) (2025-10-28)
+
+### Features
+
+- **angular:** add DNS server handling for config loading ([d3fbae0](https://gitlab.com/rxap/packages/commit/d3fbae0258f2dfa6f5a0ab90b0c841d5e086d53c))
+- **angular:** add storacha gateway for IPFS content fetching ([c9239be](https://gitlab.com/rxap/packages/commit/c9239be7bc1f223c6cc0815fe277d536d0219580))
+
 # [19.2.0-dev.1](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.0...@rxap/config@19.2.0-dev.1) (2025-09-23)
 
 ### Bug Fixes

package/compodoc/changelog.html

@@ -85,6 +85,17 @@
 <h1>Change Log</h1>
 <p>All notable changes to this project will be documented in this file.
 See <a href="https://conventionalcommits.org">Conventional Commits</a> for commit guidelines.</p>
+<h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.2...@rxap/config@19.2.0-dev.3">19.2.0-dev.3</a> (2026-01-19)</h1>
+<h3>Features</h3>
+<ul>
+<li><strong>config:</strong> add <code>strategy</code> option and FIFO handling for dynamic config loading (<a href="https://gitlab.com/rxap/packages/commit/7534069a897493c402d3164d6bb7df7b3f1dc9dd">7534069</a>)</li>
+</ul>
+<h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.1...@rxap/config@19.2.0-dev.2">19.2.0-dev.2</a> (2025-10-28)</h1>
+<h3>Features</h3>
+<ul>
+<li><strong>angular:</strong> add DNS server handling for config loading (<a href="https://gitlab.com/rxap/packages/commit/d3fbae0258f2dfa6f5a0ab90b0c841d5e086d53c">d3fbae0</a>)</li>
+<li><strong>angular:</strong> add storacha gateway for IPFS content fetching (<a href="https://gitlab.com/rxap/packages/commit/c9239be7bc1f223c6cc0815fe277d536d0219580">c9239be</a>)</li>
+</ul>
 <h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.0...@rxap/config@19.2.0-dev.1">19.2.0-dev.1</a> (2025-09-23)</h1>
 <h3>Bug Fixes</h3>
 <ul>

package/compodoc/dependencies.html

@@ -119,7 +119,7 @@
         <li>
             <b>@rxap/environment</b> : ^19.0.4</li>
         <li>
-            <b>@rxap/utilities</b> : ^16.5.0-dev.0</li>
+            <b>@rxap/utilities</b> : ^16.5.0-dev.1</li>
         <li>
             <b>rxjs</b> : ^7.8.1</li>
     </ul>

package/compodoc/injectables/ConfigService.html

@@ -260,7 +260,7 @@
                 </tr>
                         <tr>
                             <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
                             </td>
                         </tr>
 
@@ -325,8 +325,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="422"
-                                    class="link-to-prism">src/lib/config.service.ts:422</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="504"
+                                    class="link-to-prism">src/lib/config.service.ts:504</a></div>
                         </td>
                     </tr>
 
@@ -364,8 +364,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="426"
-                                    class="link-to-prism">src/lib/config.service.ts:426</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="508"
+                                    class="link-to-prism">src/lib/config.service.ts:508</a></div>
                         </td>
                     </tr>
 
@@ -441,8 +441,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="427"
-                                    class="link-to-prism">src/lib/config.service.ts:427</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="509"
+                                    class="link-to-prism">src/lib/config.service.ts:509</a></div>
                         </td>
                     </tr>
 
@@ -530,8 +530,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="428"
-                                    class="link-to-prism">src/lib/config.service.ts:428</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="510"
+                                    class="link-to-prism">src/lib/config.service.ts:510</a></div>
                         </td>
                     </tr>
 
@@ -619,8 +619,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="360"
-                                    class="link-to-prism">src/lib/config.service.ts:360</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="442"
+                                    class="link-to-prism">src/lib/config.service.ts:442</a></div>
                         </td>
                     </tr>
 
@@ -721,8 +721,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="366"
-                                    class="link-to-prism">src/lib/config.service.ts:366</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="448"
+                                    class="link-to-prism">src/lib/config.service.ts:448</a></div>
                         </td>
                     </tr>
 
@@ -831,8 +831,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="432"
-                                    class="link-to-prism">src/lib/config.service.ts:432</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="514"
+                                    class="link-to-prism">src/lib/config.service.ts:514</a></div>
                         </td>
                     </tr>
 
@@ -908,8 +908,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="433"
-                                    class="link-to-prism">src/lib/config.service.ts:433</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="515"
+                                    class="link-to-prism">src/lib/config.service.ts:515</a></div>
                         </td>
                     </tr>
 
@@ -997,8 +997,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="434"
-                                    class="link-to-prism">src/lib/config.service.ts:434</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="516"
+                                    class="link-to-prism">src/lib/config.service.ts:516</a></div>
                         </td>
                     </tr>
 
@@ -1087,8 +1087,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="98"
-                                    class="link-to-prism">src/lib/config.service.ts:98</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="106"
+                                    class="link-to-prism">src/lib/config.service.ts:106</a></div>
                         </td>
                     </tr>
 
@@ -1173,8 +1173,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="418"
-                                    class="link-to-prism">src/lib/config.service.ts:418</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="500"
+                                    class="link-to-prism">src/lib/config.service.ts:500</a></div>
                         </td>
                     </tr>
 
@@ -1243,8 +1243,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="341"
-                                    class="link-to-prism">src/lib/config.service.ts:341</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="423"
+                                    class="link-to-prism">src/lib/config.service.ts:423</a></div>
                         </td>
                     </tr>
 
@@ -1353,7 +1353,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
                         </td>
                     </tr>
 
@@ -1385,7 +1385,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="57" class="link-to-prism">src/lib/config.service.ts:57</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="65" class="link-to-prism">src/lib/config.service.ts:65</a></div>
                         </td>
                     </tr>
 
@@ -1417,7 +1417,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="64" class="link-to-prism">src/lib/config.service.ts:64</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="72" class="link-to-prism">src/lib/config.service.ts:72</a></div>
                         </td>
                     </tr>
 
@@ -1457,7 +1457,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="72" class="link-to-prism">src/lib/config.service.ts:72</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="80" class="link-to-prism">src/lib/config.service.ts:80</a></div>
                         </td>
                     </tr>
 
@@ -1483,7 +1483,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="51" class="link-to-prism">src/lib/config.service.ts:51</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="59" class="link-to-prism">src/lib/config.service.ts:59</a></div>
                         </td>
                     </tr>
 
@@ -1515,7 +1515,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="54" class="link-to-prism">src/lib/config.service.ts:54</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/lib/config.service.ts:62</a></div>
                         </td>
                     </tr>
 
@@ -1541,7 +1541,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="52" class="link-to-prism">src/lib/config.service.ts:52</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="60" class="link-to-prism">src/lib/config.service.ts:60</a></div>
                         </td>
                     </tr>
 
@@ -1573,7 +1573,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="55" class="link-to-prism">src/lib/config.service.ts:55</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="63" class="link-to-prism">src/lib/config.service.ts:63</a></div>
                         </td>
                     </tr>
 
@@ -1605,7 +1605,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="70" class="link-to-prism">src/lib/config.service.ts:70</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
                         </td>
                     </tr>
 
@@ -1649,7 +1649,7 @@ value form the Defaults values or dynamic config files</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="77" class="link-to-prism">src/lib/config.service.ts:77</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="85" class="link-to-prism">src/lib/config.service.ts:85</a></div>
                         </td>
                     </tr>
 
@@ -1685,8 +1685,14 @@ import {
 
 export type AnySchema &#x3D; { validateAsync: (...args: any[]) &#x3D;&gt; any };
 
+export enum ConfigLoadingStrategy {
+  DEFAULT &#x3D; &#x27;default&#x27;,
+  FIFO &#x3D; &#x27;fifo&#x27;,
+}
+
 export interface ConfigLoadOptions {
   fromUrlParam?: string | boolean;
+  fromUrls?: boolean;
   fromLocalStorage?: boolean;
   schema?: AnySchema;
   url?: string | string[] | ((environment: Environment) &#x3D;&gt; string | string[]);
@@ -1705,6 +1711,8 @@ export interface ConfigLoadOptions {
    */
   fromCid?: string;
   fetchCidContent?: (cid: string, path?: string) &#x3D;&gt; Promise&lt;Blob | null&gt;;
+  dnsServers?: string[];
+  strategy?: ConfigLoadingStrategy;
 }
 
 @Injectable({
@@ -1773,65 +1781,132 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
         options.fromUrlParam &#x3D; environment.config.fromUrlParam;
         options.fromLocalStorage &#x3D; environment.config.fromLocalStorage;
         options.schema &#x3D; environment.config.schema;
+        options.strategy &#x3D; environment.config.strategy as ConfigLoadingStrategy ?? options.strategy;
       }
     }
 
     config &#x3D; deepMerge(config, options?.static ?? {});
+    let done &#x3D; false;
 
-    const urls &#x3D; (options?.url ? coerceArray(options.url) : ConfigService.Urls).map(url &#x3D;&gt; {
-      if (typeof url &#x3D;&#x3D;&#x3D; &#x27;function&#x27;) {
-        if (!environment) {
-          throw new Error(&#x27;environment is required when url is a function&#x27;);
+    if (!done &amp;&amp; options?.fromUrls !&#x3D;&#x3D; false) {
+      try {
+        config &#x3D; deepMerge(config, await this.loadConfigFromUrls(options, environment));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from urls&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from urls: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
         }
-        return coerceArray(url(environment));
       }
-      return coerceArray(url);
-    }).flat();
+    }
 
-    for (const url of urls) {
-      const loadedConfig &#x3D; await this.loadConfig(url, true, options?.schema);
-      const match &#x3D; url.match(/config\.([a-zA-Z0-9.\-_]+)\.json/);
-      if (match) {
-        SetToObject(config, match[1], loadedConfig);
-      } else {
-        config &#x3D; deepMerge(config, loadedConfig);
+    if (!done &amp;&amp; options?.fromLocalStorage !&#x3D;&#x3D; false) {
+      try {
+        config &#x3D; deepMerge(config, this.loadConfigFromLocalStorage(options));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from local storage&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from local storage: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
+        }
       }
     }
 
-    config &#x3D; deepMerge(config, this.Overwrites);
-
-    if (options?.fromLocalStorage !&#x3D;&#x3D; false) {
-
-      const localConfig &#x3D; localStorage.getItem(ConfigService.LocalStorageKey);
-
-      if (localConfig) {
-        try {
-          config &#x3D; deepMerge(config, JSON.parse(localConfig));
-        } catch (e: any) {
-          console.error(&#x27;local config could not be parsed&#x27;);
+    if (!done &amp;&amp; options?.fromUrlParam) {
+      try {
+        config &#x3D; deepMerge(config, this.loadConfigFromUrlParam(options as any));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from url param&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from url param: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
         }
       }
-
     }
 
-    if (options?.fromUrlParam) {
-      const param &#x3D; typeof options.fromUrlParam &#x3D;&#x3D;&#x3D; &#x27;string&#x27; ? options.fromUrlParam : &#x27;config&#x27;;
-      config &#x3D; deepMerge(config, this.LoadConfigDefaultFromUrlParam(param));
+    if (!done &amp;&amp; options?.fromDns) {
+      await this.loadConfigFromDns(options as any);
     }
 
-    if (options?.fromDns) {
-      await this.loadConfigFromDns(options as any);
+    if (!done &amp;&amp; options?.fromCid) {
+      try {
+        config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from cid&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from cid: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
+        }
+      }
     }
 
-    if (options?.fromCid) {
-      config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+    if (!done) {
+      console.warn(&#x27;No config loading strategy succeeded. Using default config.&#x27;);
     }
 
+    config &#x3D; deepMerge(config, this.Overwrites);
+
     console.debug(&#x27;app config&#x27;, config);
 
     this.Config &#x3D; config;
   }
 
+  private static loadConfigFromUrlParam(options: ConfigLoadOptions &amp; { fromUrlParam: string | true }) {
+    const param &#x3D; typeof options.fromUrlParam &#x3D;&#x3D;&#x3D; &#x27;string&#x27; ? options.fromUrlParam : &#x27;config&#x27;;
+    return this.LoadConfigDefaultFromUrlParam(param);
+  }
+
+  private static loadConfigFromLocalStorage(options: ConfigLoadOptions) {
+    const localConfig &#x3D; localStorage.getItem(ConfigService.LocalStorageKey);
+    if (localConfig) {
+      return JSON.parse(localConfig);
+    } else {
+      return {};
+    }
+  }
+
+  private static async loadConfigFromUrls(options: ConfigLoadOptions, environment?: Environment) {
+    let config: any &#x3D; {};
+    const urls &#x3D; (
+      options?.url ? coerceArray(options.url) : ConfigService.Urls
+    ).map(url &#x3D;&gt; {
+      if (typeof url &#x3D;&#x3D;&#x3D; &#x27;function&#x27;) {
+        if (!environment) {
+          throw new Error(&#x27;environment is required when url is a function&#x27;);
+        }
+        return coerceArray(url(environment));
+      }
+      return coerceArray(url);
+    }).flat();
+
+    for (const url of urls) {
+      const loadedConfig &#x3D; await this.loadConfig(url, true, options?.schema);
+      const match &#x3D; url.match(/config\.([a-zA-Z0-9.\-_]+)\.json/);
+      if (match) {
+        SetToObject(config, match[1], loadedConfig);
+      } else {
+        config &#x3D; deepMerge(config, loadedConfig);
+      }
+    }
+    return config;
+  }
+
   private static async loadConfigFromCid(options: ConfigLoadOptions &amp; { fromCid: string | boolean }) {
     console.debug(&#x27;Loading config from CID: &#x27;, options.fromCid);
     try {
@@ -1854,6 +1929,13 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
 
   private static async loadConfigFromDns(options: ConfigLoadOptions &amp; { fromDns: string | boolean }) {
     console.debug(&#x27;Loading config from DNS&#x27;);
+    const dnsServers &#x3D; options.dnsServers ?? [];
+    if (dnsServers.length &#x3D;&#x3D;&#x3D; 0) {
+      dnsServers.push(
+        &#x27;https://dns.google/resolve&#x27;,
+        &#x27;https://cloudflare-dns.com/dns-query&#x27;
+      );
+    }
     let domain &#x3D; location.hostname;
     if (typeof options.fromDns &#x3D;&#x3D;&#x3D; &#x27;string&#x27;) {
       domain &#x3D; options.fromDns;
@@ -1861,7 +1943,7 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
     domain &#x3D; CoercePrefix(domain, &#x27;_config.&#x27;);
     try {
       console.log(&#x60;Attempting DNS lookup for domain: ${domain}&#x60;);
-      const txtData &#x3D; await dnsLookup(domain, &#x27;TXT&#x27;);
+      const txtData &#x3D; await dnsLookup(domain, &#x27;TXT&#x27;, dnsServers);
       console.log(&#x60;DNS TXT record data found: ${txtData}&#x60;);
       // Example CID extraction logic (adapt to your TXT record format)
       // This looks for IPFS CIDs (v0 &#x27;Qm...&#x27; or v1 &#x27;b...&#x27;) potentially after &#x27;ipfs://&#x27; or &#x27;/&#x27;