@rxap/config 19.3.0-dev.4 → 21.0.1-dev.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/compodoc/changelog.html +26 -0
- package/compodoc/dependencies.html +6 -6
- package/compodoc/index.html +69 -1
- package/compodoc/injectables/ConfigService.html +210 -102
- package/compodoc/interfaces/ConfigLoadError.html +610 -0
- package/compodoc/interfaces/ConfigLoadOptions.html +213 -66
- package/compodoc/js/menu-wc.js +3 -0
- package/compodoc/js/menu-wc_es5.js +1 -1
- package/compodoc/js/search/search_index.js +2 -2
- package/compodoc/miscellaneous/functions.html +130 -1
- package/compodoc/miscellaneous/typealiases.html +78 -0
- package/compodoc/overview.html +1 -1
- package/compodoc/properties.html +1 -1
- package/docs/documentation.json +2445 -1297
- package/docs/html/assets/hierarchy.js +1 -1
- package/docs/html/assets/highlight.css +42 -0
- package/docs/html/assets/navigation.js +1 -1
- package/docs/html/assets/search.js +1 -1
- package/docs/html/classes/ConfigLoaderService.html +2 -2
- package/docs/html/classes/ConfigService.html +8 -6
- package/docs/html/classes/ConfigTestingService.html +2 -2
- package/docs/html/enums/ConfigLoadMethod.html +2 -2
- package/docs/html/enums/ConfigLoadingStrategy.html +2 -2
- package/docs/html/functions/ProvideConfig.html +1 -1
- package/docs/html/functions/defaultConfigLoadErrorHandler.html +4 -0
- package/docs/html/functions/dnsLookup.html +1 -1
- package/docs/html/functions/dnsResolver.html +1 -1
- package/docs/html/functions/fetchCidContent.html +1 -1
- package/docs/html/functions/fetchCidContentAsJson.html +1 -1
- package/docs/html/functions/fetchCidContentViaHttp.html +1 -1
- package/docs/html/functions/fetchContentViaHttp.html +1 -1
- package/docs/html/functions/localPathIpfsGateway.html +1 -1
- package/docs/html/functions/localSubDomainIpfsGateway.html +1 -1
- package/docs/html/functions/raceSuccess.html +2 -2
- package/docs/html/functions/showConfigLoadError.html +2 -0
- package/docs/html/functions/storachaIpfsGateway.html +1 -1
- package/docs/html/functions/w3sIpfsGateway.html +1 -1
- package/docs/html/hierarchy.html +1 -1
- package/docs/html/index.html +54 -2
- package/docs/html/interfaces/AppsNavigationConfig.html +2 -2
- package/docs/html/interfaces/Config.html +2 -2
- package/docs/html/interfaces/ConfigLoadError.html +11 -0
- package/docs/html/interfaces/ConfigLoadOptions.html +13 -6
- package/docs/html/interfaces/LogoConfig.html +2 -2
- package/docs/html/interfaces/NavigationConfig.html +2 -2
- package/docs/html/interfaces/Oauth2Config.html +2 -2
- package/docs/html/interfaces/i18nConfig.html +2 -2
- package/docs/html/modules.html +1 -1
- package/docs/html/types/AnySchema.html +1 -1
- package/docs/html/types/ConfigLoadErrorHandler.html +2 -0
- package/docs/html/types/ConfigLoadErrorKind.html +9 -0
- package/docs/html/types/ConfigRequestOptions.html +1 -0
- package/docs/html/types/IpfsGatewayFunction.html +1 -1
- package/docs/html/types/Join.html +1 -1
- package/docs/html/types/LanguagesConfig.html +1 -1
- package/docs/html/types/Leaves.html +1 -1
- package/docs/html/types/NoInferType.html +1 -1
- package/docs/html/types/Paths.html +1 -1
- package/docs/html/variables/RXAP_CONFIG.html +1 -1
- package/docs/html/variables/defaultDnsServers.html +1 -1
- package/docs/html/variables/defaultIpfsGatewayServers.html +1 -1
- package/docs/markdown/README.md +54 -1
- package/docs/markdown/classes/ConfigLoaderService.md +7 -7
- package/docs/markdown/classes/ConfigService.md +37 -23
- package/docs/markdown/classes/ConfigTestingService.md +8 -8
- package/docs/markdown/enumerations/ConfigLoadMethod.md +6 -6
- package/docs/markdown/enumerations/ConfigLoadingStrategy.md +4 -4
- package/docs/markdown/functions/ProvideConfig.md +2 -2
- package/docs/markdown/functions/defaultConfigLoadErrorHandler.md +26 -0
- package/docs/markdown/functions/dnsLookup.md +2 -2
- package/docs/markdown/functions/dnsResolver.md +2 -2
- package/docs/markdown/functions/fetchCidContent.md +2 -2
- package/docs/markdown/functions/fetchCidContentAsJson.md +2 -2
- package/docs/markdown/functions/fetchCidContentViaHttp.md +2 -2
- package/docs/markdown/functions/fetchContentViaHttp.md +2 -2
- package/docs/markdown/functions/localPathIpfsGateway.md +2 -2
- package/docs/markdown/functions/localSubDomainIpfsGateway.md +2 -2
- package/docs/markdown/functions/raceSuccess.md +2 -2
- package/docs/markdown/functions/showConfigLoadError.md +23 -0
- package/docs/markdown/functions/storachaIpfsGateway.md +2 -2
- package/docs/markdown/functions/w3sIpfsGateway.md +2 -2
- package/docs/markdown/globals.md +8 -2
- package/docs/markdown/interfaces/AppsNavigationConfig.md +12 -12
- package/docs/markdown/interfaces/Config.md +6 -6
- package/docs/markdown/interfaces/ConfigLoadError.md +70 -0
- package/docs/markdown/interfaces/ConfigLoadOptions.md +39 -15
- package/docs/markdown/interfaces/LogoConfig.md +5 -5
- package/docs/markdown/interfaces/NavigationConfig.md +9 -9
- package/docs/markdown/interfaces/Oauth2Config.md +3 -3
- package/docs/markdown/interfaces/i18nConfig.md +4 -4
- package/docs/markdown/type-aliases/AnySchema.md +2 -2
- package/docs/markdown/type-aliases/ConfigLoadErrorHandler.md +23 -0
- package/docs/markdown/type-aliases/ConfigLoadErrorKind.md +19 -0
- package/docs/markdown/type-aliases/ConfigRequestOptions.md +11 -0
- package/docs/markdown/type-aliases/IpfsGatewayFunction.md +2 -2
- package/docs/markdown/type-aliases/Join.md +2 -2
- package/docs/markdown/type-aliases/LanguagesConfig.md +2 -2
- package/docs/markdown/type-aliases/Leaves.md +2 -2
- package/docs/markdown/type-aliases/NoInferType.md +2 -2
- package/docs/markdown/type-aliases/Paths.md +2 -2
- package/docs/markdown/variables/RXAP_CONFIG.md +2 -2
- package/docs/markdown/variables/defaultDnsServers.md +2 -2
- package/docs/markdown/variables/defaultIpfsGatewayServers.md +2 -2
- package/docs/wiki/Class.ConfigLoaderService.md +6 -6
- package/docs/wiki/Class.ConfigService.md +36 -22
- package/docs/wiki/Class.ConfigTestingService.md +7 -7
- package/docs/wiki/Enumeration.ConfigLoadMethod.md +5 -5
- package/docs/wiki/Enumeration.ConfigLoadingStrategy.md +3 -3
- package/docs/wiki/Function.ProvideConfig.md +1 -1
- package/docs/wiki/Function.defaultConfigLoadErrorHandler.md +22 -0
- package/docs/wiki/Function.dnsLookup.md +1 -1
- package/docs/wiki/Function.dnsResolver.md +1 -1
- package/docs/wiki/Function.fetchCidContent.md +1 -1
- package/docs/wiki/Function.fetchCidContentAsJson.md +1 -1
- package/docs/wiki/Function.fetchCidContentViaHttp.md +1 -1
- package/docs/wiki/Function.fetchContentViaHttp.md +1 -1
- package/docs/wiki/Function.localPathIpfsGateway.md +1 -1
- package/docs/wiki/Function.localSubDomainIpfsGateway.md +1 -1
- package/docs/wiki/Function.raceSuccess.md +1 -1
- package/docs/wiki/Function.showConfigLoadError.md +19 -0
- package/docs/wiki/Function.storachaIpfsGateway.md +1 -1
- package/docs/wiki/Function.w3sIpfsGateway.md +1 -1
- package/docs/wiki/Home.md +53 -0
- package/docs/wiki/Interface.AppsNavigationConfig.md +11 -11
- package/docs/wiki/Interface.Config.md +5 -5
- package/docs/wiki/Interface.ConfigLoadError.md +66 -0
- package/docs/wiki/Interface.ConfigLoadOptions.md +38 -14
- package/docs/wiki/Interface.LogoConfig.md +4 -4
- package/docs/wiki/Interface.NavigationConfig.md +8 -8
- package/docs/wiki/Interface.Oauth2Config.md +2 -2
- package/docs/wiki/Interface.i18nConfig.md +3 -3
- package/docs/wiki/TypeAlias.AnySchema.md +1 -1
- package/docs/wiki/TypeAlias.ConfigLoadErrorHandler.md +19 -0
- package/docs/wiki/TypeAlias.ConfigLoadErrorKind.md +15 -0
- package/docs/wiki/TypeAlias.ConfigRequestOptions.md +7 -0
- package/docs/wiki/TypeAlias.IpfsGatewayFunction.md +1 -1
- package/docs/wiki/TypeAlias.Join.md +1 -1
- package/docs/wiki/TypeAlias.LanguagesConfig.md +1 -1
- package/docs/wiki/TypeAlias.Leaves.md +1 -1
- package/docs/wiki/TypeAlias.NoInferType.md +1 -1
- package/docs/wiki/TypeAlias.Paths.md +1 -1
- package/docs/wiki/Variable.RXAP_CONFIG.md +1 -1
- package/docs/wiki/Variable.defaultDnsServers.md +1 -1
- package/docs/wiki/Variable.defaultIpfsGatewayServers.md +1 -1
- package/docs/wiki/_Sidebar.md +6 -0
- package/docs/wiki/globals.md +7 -1
- package/fesm2022/rxap-config.mjs +10 -10
- package/fesm2022/rxap-config.mjs.map +1 -1
- package/package.json +15 -14
- package/types/rxap-config.d.ts +298 -0
- package/index.d.ts +0 -9
- package/lib/config-load-error.d.ts +0 -41
- package/lib/config-loader.service.d.ts +0 -12
- package/lib/config-testing-service.d.ts +0 -12
- package/lib/config.d.ts +0 -41
- package/lib/config.service.d.ts +0 -129
- package/lib/provide-config.d.ts +0 -4
- package/lib/tokens.d.ts +0 -2
- package/lib/types.d.ts +0 -34
- package/lib/utilities.d.ts +0 -19
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,23 @@
|
|
|
1
|
+
## 21.0.1-dev.0 (2026-11-20)
|
|
2
|
+
|
|
3
|
+
### 🩹 Fixes
|
|
4
|
+
|
|
5
|
+
- **upgrade:** TestBed.get->inject (removed in angular) + dedupe rxjs to single version
|
|
6
|
+
|
|
7
|
+
### 🧱 Updated Dependencies
|
|
8
|
+
|
|
9
|
+
- Updated angular-environment to 21.0.1-dev.0
|
|
10
|
+
- Updated utilities to 16.5.2-dev.0
|
|
11
|
+
- Updated rxjs to 1.1.18-dev.0
|
|
12
|
+
|
|
13
|
+
### ❤️ Thank You
|
|
14
|
+
|
|
15
|
+
- Merzough Münker
|
|
16
|
+
|
|
17
|
+
## 19.3.0 (2026-11-20)
|
|
18
|
+
|
|
19
|
+
This was a version bump only for angular-config to align it with other projects, there were no code changes.
|
|
20
|
+
|
|
1
21
|
## 19.3.0-dev.4 (2026-09-25)
|
|
2
22
|
|
|
3
23
|
### 🚀 Features
|
package/compodoc/changelog.html
CHANGED
|
@@ -82,6 +82,32 @@
|
|
|
82
82
|
<div class="content getting-started">
|
|
83
83
|
<div class="content-data">
|
|
84
84
|
|
|
85
|
+
<h2>21.0.1-dev.0 (2026-11-20)</h2>
|
|
86
|
+
<h3>🩹 Fixes</h3>
|
|
87
|
+
<ul>
|
|
88
|
+
<li><strong>upgrade:</strong> TestBed.get->inject (removed in angular) + dedupe rxjs to single version</li>
|
|
89
|
+
</ul>
|
|
90
|
+
<h3>🧱 Updated Dependencies</h3>
|
|
91
|
+
<ul>
|
|
92
|
+
<li>Updated angular-environment to 21.0.1-dev.0</li>
|
|
93
|
+
<li>Updated utilities to 16.5.2-dev.0</li>
|
|
94
|
+
<li>Updated rxjs to 1.1.18-dev.0</li>
|
|
95
|
+
</ul>
|
|
96
|
+
<h3>❤️ Thank You</h3>
|
|
97
|
+
<ul>
|
|
98
|
+
<li>Merzough Münker</li>
|
|
99
|
+
</ul>
|
|
100
|
+
<h2>19.3.0 (2026-11-20)</h2>
|
|
101
|
+
<p>This was a version bump only for angular-config to align it with other projects, there were no code changes.</p>
|
|
102
|
+
<h2>19.3.0-dev.4 (2026-09-25)</h2>
|
|
103
|
+
<h3>🚀 Features</h3>
|
|
104
|
+
<ul>
|
|
105
|
+
<li><strong>config:</strong> allow a custom error handler for failed config requests</li>
|
|
106
|
+
</ul>
|
|
107
|
+
<h3>❤️ Thank You</h3>
|
|
108
|
+
<ul>
|
|
109
|
+
<li>Merzough Münker</li>
|
|
110
|
+
</ul>
|
|
85
111
|
<h2>19.3.0-dev.3 (2026-06-19)</h2>
|
|
86
112
|
<h3>🚀 Features</h3>
|
|
87
113
|
<ul>
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
</ol>
|
|
102
102
|
<ul class="dependencies-list">
|
|
103
103
|
<li>
|
|
104
|
-
<b>@nx/devkit</b> :
|
|
104
|
+
<b>@nx/devkit</b> : 22.7.5</li>
|
|
105
105
|
<li>
|
|
106
106
|
<b>tslib</b> : 2.6.2</li>
|
|
107
107
|
</ul>
|
|
@@ -113,15 +113,15 @@
|
|
|
113
113
|
</ol>
|
|
114
114
|
<ul class="dependencies-list">
|
|
115
115
|
<li>
|
|
116
|
-
<b>@angular/common</b> : ^
|
|
116
|
+
<b>@angular/common</b> : ^21.2.9</li>
|
|
117
117
|
<li>
|
|
118
|
-
<b>@angular/core</b> : ^
|
|
118
|
+
<b>@angular/core</b> : ^21.2.9</li>
|
|
119
119
|
<li>
|
|
120
|
-
<b>@rxap/environment</b> : ^
|
|
120
|
+
<b>@rxap/environment</b> : ^21.0.1-dev.0</li>
|
|
121
121
|
<li>
|
|
122
|
-
<b>@rxap/utilities</b> : ^16.5.
|
|
122
|
+
<b>@rxap/utilities</b> : ^16.5.2-dev.0</li>
|
|
123
123
|
<li>
|
|
124
|
-
<b>rxjs</b> : ^7.8.
|
|
124
|
+
<b>rxjs</b> : ^7.8.2</li>
|
|
125
125
|
</ul>
|
|
126
126
|
|
|
127
127
|
|
package/compodoc/index.html
CHANGED
|
@@ -91,6 +91,7 @@
|
|
|
91
91
|
<img src="https://img.shields.io/npm/l/@rxap/config" alt="NPM" class="img-responsive"></p>
|
|
92
92
|
<ul>
|
|
93
93
|
<li><a href="#installation">Installation</a></li>
|
|
94
|
+
<li><a href="#guides">Guides</a></li>
|
|
94
95
|
<li><a href="#generators">Generators</a><ul>
|
|
95
96
|
<li><a href="#init">init</a></li>
|
|
96
97
|
</ul>
|
|
@@ -100,7 +101,74 @@
|
|
|
100
101
|
<p><strong>Add the package to your workspace:</strong></p>
|
|
101
102
|
<b>Example :</b><div><pre class="line-numbers"><code class="language-bash">yarn add @rxap/config</code></pre></div><p><strong>Install peer dependencies:</strong></p>
|
|
102
103
|
<b>Example :</b><div><pre class="line-numbers"><code class="language-bash">yarn add @angular/common @angular/core @rxap/environment @rxap/utilities rxjs </code></pre></div><p><strong>Execute the init generator:</strong></p>
|
|
103
|
-
<b>Example :</b><div><pre class="line-numbers"><code class="language-bash">yarn nx g @rxap/config:init</code></pre></div><h1>
|
|
104
|
+
<b>Example :</b><div><pre class="line-numbers"><code class="language-bash">yarn nx g @rxap/config:init</code></pre></div><h1>Guides</h1>
|
|
105
|
+
<h2>Custom error handling for failed config requests</h2>
|
|
106
|
+
<p>By default a failed required config url request shows an error overlay and reloads the page after
|
|
107
|
+
30 s. Pass <code>errorHandler</code> in the <code>ConfigLoadOptions</code> to replace this behavior. The handler gets a
|
|
108
|
+
structured <code>ConfigLoadError</code>:</p>
|
|
109
|
+
<table class="table table-bordered compodoc-table">
|
|
110
|
+
<thead>
|
|
111
|
+
<tr>
|
|
112
|
+
<th><code>kind</code></th>
|
|
113
|
+
<th>When</th>
|
|
114
|
+
</tr>
|
|
115
|
+
</thead>
|
|
116
|
+
<tbody>
|
|
117
|
+
<tr>
|
|
118
|
+
<td><code>network</code></td>
|
|
119
|
+
<td><code>fetch()</code> rejected (offline, DNS, CORS without a redirect)</td>
|
|
120
|
+
</tr>
|
|
121
|
+
<tr>
|
|
122
|
+
<td><code>redirect</code></td>
|
|
123
|
+
<td>the response is an <code>opaqueredirect</code> (only with <code>redirect: 'manual'</code>)</td>
|
|
124
|
+
</tr>
|
|
125
|
+
<tr>
|
|
126
|
+
<td><code>http</code></td>
|
|
127
|
+
<td>the response is not ok (<code>status</code> and <code>response</code> are set)</td>
|
|
128
|
+
</tr>
|
|
129
|
+
<tr>
|
|
130
|
+
<td><code>parse</code></td>
|
|
131
|
+
<td>the response body is not valid JSON</td>
|
|
132
|
+
</tr>
|
|
133
|
+
<tr>
|
|
134
|
+
<td><code>schema</code></td>
|
|
135
|
+
<td>the schema validation failed</td>
|
|
136
|
+
</tr>
|
|
137
|
+
</tbody>
|
|
138
|
+
</table>
|
|
139
|
+
<p><code>requestInit</code> is passed to every config url <code>fetch()</code> call. Use <code>{ redirect: 'manual' }</code> to detect a
|
|
140
|
+
redirect to a login page instead of getting a CORS error.</p>
|
|
141
|
+
<b>Example :</b><div><pre class="line-numbers"><code class="language-ts">import {
|
|
142
|
+
ConfigService,
|
|
143
|
+
defaultConfigLoadErrorHandler,
|
|
144
|
+
} from '@rxap/config';
|
|
145
|
+
|
|
146
|
+
await ConfigService.Load({
|
|
147
|
+
url: '/config.json',
|
|
148
|
+
requestInit: { redirect: 'manual' },
|
|
149
|
+
errorHandler: (error) => {
|
|
150
|
+
if (error.kind === 'redirect' || error.status === 401) {
|
|
151
|
+
location.href = '/oauth2/sign_in';
|
|
152
|
+
// never resolve - the browser navigates away
|
|
153
|
+
return new Promise<void>(() => undefined);
|
|
154
|
+
}
|
|
155
|
+
// fall back to the default overlay + reload
|
|
156
|
+
return defaultConfigLoadErrorHandler(error);
|
|
157
|
+
},
|
|
158
|
+
});</code></pre></div><ul>
|
|
159
|
+
<li>The handler is called <strong>instead of</strong> the default overlay and reload - no DOM changes, no reload.</li>
|
|
160
|
+
<li>After the handler resolves a required url still throws and an optional url resolves with <code>null</code>.</li>
|
|
161
|
+
<li>The <code>onError</code> / <code>onRequestError</code> subjects and the <code>onErrorFnc</code> / <code>onRequestErrorFnc</code> hooks are
|
|
162
|
+
still called for required urls.</li>
|
|
163
|
+
<li>The handler and <code>requestInit</code> of the last <code>ConfigService.Load</code> call are also used by
|
|
164
|
+
<code>ConfigService.SideLoad</code>. Pass the fifth <code>options</code> argument of <code>SideLoad</code> to override them.</li>
|
|
165
|
+
<li>The handler only covers config url sources (<code>url</code> / <code>fromUrls</code> and <code>SideLoad</code>). The CID and DNS
|
|
166
|
+
sources (<code>fromCid</code>, <code>fromDns</code>) fetch through their own paths, only log failures and never show the
|
|
167
|
+
overlay.</li>
|
|
168
|
+
<li><code>StandaloneApplication</code> from <code>@rxap/ngx-bootstrap</code> forwards its <code>configLoadOptions</code> unchanged, so
|
|
169
|
+
the options can be passed as its fourth constructor argument.</li>
|
|
170
|
+
</ul>
|
|
171
|
+
<h1>Generators</h1>
|
|
104
172
|
<h2>init</h2>
|
|
105
173
|
<blockquote>
|
|
106
174
|
<p>Initialize the package in the workspace</p>
|