@rxap/config 19.0.4-dev.1 → 19.1.0-dev.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [19.1.0-dev.0](https://gitlab.com/rxap/packages/compare/@rxap/config@19.0.4-dev.1...@rxap/config@19.1.0-dev.0) (2025-05-06)
+
+### Features
+
+- **config:** add support for loading configuration from DNS and CID ([1af98c4](https://gitlab.com/rxap/packages/commit/1af98c442b3fdd45b61053b2163f0446fa4a66d0))
+
 ## [19.0.4-dev.1](https://gitlab.com/rxap/packages/compare/@rxap/config@19.0.4-dev.0...@rxap/config@19.0.4-dev.1) (2025-05-06)
 
 ### Bug Fixes

package/compodoc/changelog.html

@@ -85,6 +85,11 @@
 <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.0.4-dev.1...@rxap/config@19.1.0-dev.0">19.1.0-dev.0</a> (2025-05-06)</h1>
+<h3>Features</h3>
+<ul>
+<li><strong>config:</strong> add support for loading configuration from DNS and CID (<a href="https://gitlab.com/rxap/packages/commit/1af98c442b3fdd45b61053b2163f0446fa4a66d0">1af98c4</a>)</li>
+</ul>
 <h2><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.0.4-dev.0...@rxap/config@19.0.4-dev.1">19.0.4-dev.1</a> (2025-05-06)</h2>
 <h3>Bug Fixes</h3>
 <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="61" class="link-to-prism">src/lib/config.service.ts:61</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="76" class="link-to-prism">src/lib/config.service.ts:76</a></div>
                             </td>
                         </tr>
 
@@ -325,8 +325,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="345"
-                                    class="link-to-prism">src/lib/config.service.ts:345</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="414"
+                                    class="link-to-prism">src/lib/config.service.ts:414</a></div>
                         </td>
                     </tr>
 
@@ -364,8 +364,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="349"
-                                    class="link-to-prism">src/lib/config.service.ts:349</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="418"
+                                    class="link-to-prism">src/lib/config.service.ts:418</a></div>
                         </td>
                     </tr>
 
@@ -441,8 +441,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="350"
-                                    class="link-to-prism">src/lib/config.service.ts:350</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="419"
+                                    class="link-to-prism">src/lib/config.service.ts:419</a></div>
                         </td>
                     </tr>
 
@@ -530,8 +530,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="351"
-                                    class="link-to-prism">src/lib/config.service.ts:351</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="420"
+                                    class="link-to-prism">src/lib/config.service.ts:420</a></div>
                         </td>
                     </tr>
 
@@ -619,8 +619,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="283"
-                                    class="link-to-prism">src/lib/config.service.ts:283</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="352"
+                                    class="link-to-prism">src/lib/config.service.ts:352</a></div>
                         </td>
                     </tr>
 
@@ -721,8 +721,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="289"
-                                    class="link-to-prism">src/lib/config.service.ts:289</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="358"
+                                    class="link-to-prism">src/lib/config.service.ts:358</a></div>
                         </td>
                     </tr>
 
@@ -831,8 +831,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="355"
-                                    class="link-to-prism">src/lib/config.service.ts:355</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="424"
+                                    class="link-to-prism">src/lib/config.service.ts:424</a></div>
                         </td>
                     </tr>
 
@@ -908,8 +908,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="356"
-                                    class="link-to-prism">src/lib/config.service.ts:356</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="425"
+                                    class="link-to-prism">src/lib/config.service.ts:425</a></div>
                         </td>
                     </tr>
 
@@ -997,8 +997,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="357"
-                                    class="link-to-prism">src/lib/config.service.ts:357</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="426"
+                                    class="link-to-prism">src/lib/config.service.ts:426</a></div>
                         </td>
                     </tr>
 
@@ -1087,8 +1087,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="81"
-                                    class="link-to-prism">src/lib/config.service.ts:81</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="96"
+                                    class="link-to-prism">src/lib/config.service.ts:96</a></div>
                         </td>
                     </tr>
 
@@ -1173,8 +1173,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="410"
+                                    class="link-to-prism">src/lib/config.service.ts:410</a></div>
                         </td>
                     </tr>
 
@@ -1243,8 +1243,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="264"
-                                    class="link-to-prism">src/lib/config.service.ts:264</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="333"
+                                    class="link-to-prism">src/lib/config.service.ts:333</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="61" class="link-to-prism">src/lib/config.service.ts:61</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="76" class="link-to-prism">src/lib/config.service.ts:76</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="40" class="link-to-prism">src/lib/config.service.ts:40</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="55" class="link-to-prism">src/lib/config.service.ts:55</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="47" class="link-to-prism">src/lib/config.service.ts:47</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>
 
@@ -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="55" class="link-to-prism">src/lib/config.service.ts:55</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="70" class="link-to-prism">src/lib/config.service.ts:70</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="34" class="link-to-prism">src/lib/config.service.ts:34</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="49" class="link-to-prism">src/lib/config.service.ts:49</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="37" class="link-to-prism">src/lib/config.service.ts:37</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="52" class="link-to-prism">src/lib/config.service.ts:52</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="35" class="link-to-prism">src/lib/config.service.ts:35</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="50" class="link-to-prism">src/lib/config.service.ts:50</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="38" class="link-to-prism">src/lib/config.service.ts:38</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="53" class="link-to-prism">src/lib/config.service.ts:53</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="53" class="link-to-prism">src/lib/config.service.ts:53</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="68" class="link-to-prism">src/lib/config.service.ts:68</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="60" class="link-to-prism">src/lib/config.service.ts:60</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="75" class="link-to-prism">src/lib/config.service.ts:75</a></div>
                         </td>
                     </tr>
 
@@ -1670,12 +1670,17 @@ value form the Defaults values or dynamic config files</p>
 import { Environment } from &#x27;@rxap/environment&#x27;;
 import {
   coerceArray,
+  CoercePrefix,
   deepMerge,
   SetObjectValue,
 } from &#x27;@rxap/utilities&#x27;;
 import { ReplaySubject } from &#x27;rxjs&#x27;;
 import { RXAP_CONFIG } from &#x27;./tokens&#x27;;
 import { NoInferType } from &#x27;./types&#x27;;
+import {
+  dnsLookup,
+  fetchCidContentAsJson,
+} from &#x27;./utilities&#x27;;
 
 export type AnySchema &#x3D; { validateAsync: (...args: any[]) &#x3D;&gt; any };
 
@@ -1688,6 +1693,16 @@ export interface ConfigLoadOptions {
    * static config values
    */
   static?: Record&lt;string, any&gt;;
+  /**
+   * Load additional configuration based on a CID found in a DNS TXT record.
+   * If true, uses &#x60;location.hostname&#x60;. If a string, uses that domain.
+   */
+  fromDns?: string | boolean;
+  /**
+   * Load additional configuration directly from the given Content Identifier (CID).
+   * This takes precedence over &#x60;fromDns&#x60; if both are provided.
+   */
+  fromCid?: string;
 }
 
 @Injectable({
@@ -1796,11 +1811,65 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
       config &#x3D; deepMerge(config, this.LoadConfigDefaultFromUrlParam(param));
     }
 
+    if (options?.fromDns) {
+      await this.loadConfigFromDns(options as any);
+    }
+
+    if (options?.fromCid) {
+      config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+    }
+
     console.debug(&#x27;app config&#x27;, config);
 
     this.Config &#x3D; config;
   }
 
+  private static async loadConfigFromCid(options: ConfigLoadOptions &amp; { fromCid: string | boolean }) {
+    console.debug(&#x27;Loading config from CID: &#x27;, options.fromCid);
+    try {
+      const cidContent &#x3D; await fetchCidContentAsJson(options.fromCid);
+      if (cidContent &amp;&amp; typeof cidContent &#x3D;&#x3D;&#x3D; &#x27;object&#x27;) {
+        console.log(&#x60;Merging configuration from CID ${options.fromCid}.&#x60;, cidContent);
+        // Merge CID content into the existing config object
+        console.log(&#x27;Configuration merged successfully.&#x27;);
+        return cidContent;
+      } else if (cidContent) {
+        console.warn(&#x60;Content fetched from CID ${options.fromCid} is not a mergeable object, skipping merge.&#x60;);
+      } else {
+        console.warn(&#x60;No content fetched or content was null for CID ${options.fromCid}.&#x60;);
+      }
+    } catch (error) {
+      console.error(&#x60;Failed to fetch or process content for CID ${options.fromCid}:&#x60;, error);
+      // Decide how to handle fetch/processing errors
+    }
+  }
+
+  private static async loadConfigFromDns(options: ConfigLoadOptions &amp; { fromDns: string | boolean }) {
+    console.debug(&#x27;Loading config from DNS&#x27;);
+    let domain &#x3D; location.hostname;
+    if (typeof options.fromDns &#x3D;&#x3D;&#x3D; &#x27;string&#x27;) {
+      domain &#x3D; options.fromDns;
+    }
+    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;);
+      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;
+      const cidMatch &#x3D; txtData.match(/(?:ipfs:\/\/|\/|^)([a-zA-Z0-9]{40,})$/);
+      if (cidMatch &amp;&amp; cidMatch[1]) {
+        options.fromCid &#x3D; cidMatch[1];
+        console.log(&#x60;Extracted CID from DNS: ${options.fromCid}&#x60;);
+      } else {
+        console.warn(&#x60;Could not extract a valid CID format from DNS TXT data: &quot;${txtData}&quot;&#x60;);
+      }
+    } catch (error) {
+      console.error(&#x60;DNS lookup for ${domain} failed:&#x60;, error);
+      // Decide if failure is critical or recoverable
+    }
+  }
+
   private static handleError(error: any) {
     this.onError.next(error);
     for (const fnc of this.onErrorFnc) {

package/compodoc/interfaces/ConfigLoadOptions.html

@@ -140,6 +140,20 @@
                     <tr>
                         <td class="col-md-4">
                             <ul class="index-list">
+                                <li>
+                                            <span class="modifier">Optional</span>
+                                        <a href="#fromCid" 
+>
+                                            fromCid
+                                        </a>
+                                </li>
+                                <li>
+                                            <span class="modifier">Optional</span>
+                                        <a href="#fromDns" 
+>
+                                            fromDns
+                                        </a>
+                                </li>
                                 <li>
                                             <span class="modifier">Optional</span>
                                         <a href="#fromLocalStorage" 
@@ -186,6 +200,96 @@
 
             <section data-compodoc="block-properties">
                 <h3 id="inputs">Properties</h3>
+                    <table class="table table-sm table-bordered">
+                        <tbody>
+                                <tr>
+                                    <td class="col-md-4">
+                                        <a name="fromCid"></a>
+                                        <span class="name "><b>fromCid</b>
+                                            <a href="#fromCid">
+                                                <span class="icon ion-ios-link"></span>
+                                            </a>
+                                        </span>
+                                    </td>
+                                </tr>
+                                <tr>
+                                    <td class="col-md-4">
+                                        <code>fromCid:         <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/string" target="_blank" >string</a></code>
+</code>
+                                    </td>
+                                </tr>
+
+
+                                    <tr>
+                                        <td class="col-md-4">
+                                            <i>Type : </i>        <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/string" target="_blank" >string</a></code>
+
+                                        </td>
+                                    </tr>
+
+                                    <tr>
+                                        <td class="col-md-4">
+                                            <i>Optional</i>
+                                        </td>
+                                    </tr>
+
+
+
+
+                            <tr>
+                                <td class="col-md-4">
+                                    <div class="io-description"><p>Load additional configuration directly from the given Content Identifier (CID).
+This takes precedence over <code>fromDns</code> if both are provided.</p>
+</div>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
+                    <table class="table table-sm table-bordered">
+                        <tbody>
+                                <tr>
+                                    <td class="col-md-4">
+                                        <a name="fromDns"></a>
+                                        <span class="name "><b>fromDns</b>
+                                            <a href="#fromDns">
+                                                <span class="icon ion-ios-link"></span>
+                                            </a>
+                                        </span>
+                                    </td>
+                                </tr>
+                                <tr>
+                                    <td class="col-md-4">
+                                        <code>fromDns:     <code>string | boolean</code>
+</code>
+                                    </td>
+                                </tr>
+
+
+                                    <tr>
+                                        <td class="col-md-4">
+                                            <i>Type : </i>    <code>string | boolean</code>
+
+                                        </td>
+                                    </tr>
+
+                                    <tr>
+                                        <td class="col-md-4">
+                                            <i>Optional</i>
+                                        </td>
+                                    </tr>
+
+
+
+
+                            <tr>
+                                <td class="col-md-4">
+                                    <div class="io-description"><p>Load additional configuration based on a CID found in a DNS TXT record.
+If true, uses <code>location.hostname</code>. If a string, uses that domain.</p>
+</div>
+                                </td>
+                            </tr>
+                        </tbody>
+                    </table>
                     <table class="table table-sm table-bordered">
                         <tbody>
                                 <tr>
@@ -395,12 +499,17 @@
 import { Environment } from &#x27;@rxap/environment&#x27;;
 import {
   coerceArray,
+  CoercePrefix,
   deepMerge,
   SetObjectValue,
 } from &#x27;@rxap/utilities&#x27;;
 import { ReplaySubject } from &#x27;rxjs&#x27;;
 import { RXAP_CONFIG } from &#x27;./tokens&#x27;;
 import { NoInferType } from &#x27;./types&#x27;;
+import {
+  dnsLookup,
+  fetchCidContentAsJson,
+} from &#x27;./utilities&#x27;;
 
 export type AnySchema &#x3D; { validateAsync: (...args: any[]) &#x3D;&gt; any };
 
@@ -413,6 +522,16 @@ export interface ConfigLoadOptions {
    * static config values
    */
   static?: Record&lt;string, any&gt;;
+  /**
+   * Load additional configuration based on a CID found in a DNS TXT record.
+   * If true, uses &#x60;location.hostname&#x60;. If a string, uses that domain.
+   */
+  fromDns?: string | boolean;
+  /**
+   * Load additional configuration directly from the given Content Identifier (CID).
+   * This takes precedence over &#x60;fromDns&#x60; if both are provided.
+   */
+  fromCid?: string;
 }
 
 @Injectable({
@@ -521,11 +640,65 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
       config &#x3D; deepMerge(config, this.LoadConfigDefaultFromUrlParam(param));
     }
 
+    if (options?.fromDns) {
+      await this.loadConfigFromDns(options as any);
+    }
+
+    if (options?.fromCid) {
+      config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+    }
+
     console.debug(&#x27;app config&#x27;, config);
 
     this.Config &#x3D; config;
   }
 
+  private static async loadConfigFromCid(options: ConfigLoadOptions &amp; { fromCid: string | boolean }) {
+    console.debug(&#x27;Loading config from CID: &#x27;, options.fromCid);
+    try {
+      const cidContent &#x3D; await fetchCidContentAsJson(options.fromCid);
+      if (cidContent &amp;&amp; typeof cidContent &#x3D;&#x3D;&#x3D; &#x27;object&#x27;) {
+        console.log(&#x60;Merging configuration from CID ${options.fromCid}.&#x60;, cidContent);
+        // Merge CID content into the existing config object
+        console.log(&#x27;Configuration merged successfully.&#x27;);
+        return cidContent;
+      } else if (cidContent) {
+        console.warn(&#x60;Content fetched from CID ${options.fromCid} is not a mergeable object, skipping merge.&#x60;);
+      } else {
+        console.warn(&#x60;No content fetched or content was null for CID ${options.fromCid}.&#x60;);
+      }
+    } catch (error) {
+      console.error(&#x60;Failed to fetch or process content for CID ${options.fromCid}:&#x60;, error);
+      // Decide how to handle fetch/processing errors
+    }
+  }
+
+  private static async loadConfigFromDns(options: ConfigLoadOptions &amp; { fromDns: string | boolean }) {
+    console.debug(&#x27;Loading config from DNS&#x27;);
+    let domain &#x3D; location.hostname;
+    if (typeof options.fromDns &#x3D;&#x3D;&#x3D; &#x27;string&#x27;) {
+      domain &#x3D; options.fromDns;
+    }
+    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;);
+      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;
+      const cidMatch &#x3D; txtData.match(/(?:ipfs:\/\/|\/|^)([a-zA-Z0-9]{40,})$/);
+      if (cidMatch &amp;&amp; cidMatch[1]) {
+        options.fromCid &#x3D; cidMatch[1];
+        console.log(&#x60;Extracted CID from DNS: ${options.fromCid}&#x60;);
+      } else {
+        console.warn(&#x60;Could not extract a valid CID format from DNS TXT data: &quot;${txtData}&quot;&#x60;);
+      }
+    } catch (error) {
+      console.error(&#x60;DNS lookup for ${domain} failed:&#x60;, error);
+      // Decide if failure is critical or recoverable
+    }
+  }
+
   private static handleError(error: any) {
     this.onError.next(error);
     for (const fnc of this.onErrorFnc) {