@navios/react-query 1.0.0-alpha.1 → 1.0.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.
Files changed (50) hide show
  1. package/CHANGELOG.md +11 -1
  2. package/coverage/base.css +224 -0
  3. package/coverage/block-navigation.js +87 -0
  4. package/coverage/client/declare-client.mts.html +1264 -0
  5. package/coverage/client/index.html +116 -0
  6. package/coverage/clover.xml +160 -0
  7. package/coverage/coverage-final.json +8 -0
  8. package/coverage/favicon.png +0 -0
  9. package/coverage/index.html +146 -0
  10. package/coverage/mutation/index.html +131 -0
  11. package/coverage/mutation/key-creator.mts.html +277 -0
  12. package/coverage/mutation/make-hook.mts.html +952 -0
  13. package/coverage/prettify.css +1 -0
  14. package/coverage/prettify.js +2 -0
  15. package/coverage/query/index.html +161 -0
  16. package/coverage/query/key-creator.mts.html +415 -0
  17. package/coverage/query/make-infinite-options.mts.html +601 -0
  18. package/coverage/query/make-options.mts.html +838 -0
  19. package/coverage/query/prefetch.mts.html +1063 -0
  20. package/coverage/sort-arrow-sprite.png +0 -0
  21. package/coverage/sorter.js +210 -0
  22. package/dist/src/__tests__/prefetch.spec.d.mts +2 -0
  23. package/dist/src/__tests__/prefetch.spec.d.mts.map +1 -0
  24. package/dist/src/client/types/from-endpoint.d.mts.map +1 -1
  25. package/dist/src/common/types.d.mts +10 -0
  26. package/dist/src/common/types.d.mts.map +1 -1
  27. package/dist/src/mutation/optimistic.d.mts +7 -1
  28. package/dist/src/mutation/optimistic.d.mts.map +1 -1
  29. package/dist/src/mutation/types.d.mts +1 -12
  30. package/dist/src/mutation/types.d.mts.map +1 -1
  31. package/dist/src/query/types.d.mts +2 -13
  32. package/dist/src/query/types.d.mts.map +1 -1
  33. package/dist/tsconfig.tsbuildinfo +1 -1
  34. package/lib/index.cjs +6 -0
  35. package/lib/index.cjs.map +1 -1
  36. package/lib/index.d.cts +20 -24
  37. package/lib/index.d.cts.map +1 -1
  38. package/lib/index.d.mts +20 -24
  39. package/lib/index.d.mts.map +1 -1
  40. package/lib/index.mjs +6 -0
  41. package/lib/index.mjs.map +1 -1
  42. package/package.json +3 -3
  43. package/src/__tests__/declare-client.spec.mts +228 -0
  44. package/src/__tests__/prefetch.spec.mts +310 -0
  45. package/src/client/__type-tests__/infinite-query.spec-d.mts +1 -1
  46. package/src/client/types/from-endpoint.mts +0 -1
  47. package/src/common/types.mts +19 -0
  48. package/src/mutation/optimistic.mts +7 -1
  49. package/src/mutation/types.mts +4 -20
  50. package/src/query/types.mts +1 -22
@@ -0,0 +1,131 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for mutation</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../prettify.css" />
9
+ <link rel="stylesheet" href="../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../index.html">All files</a> mutation</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">76% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>19/25</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">85.71% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>18/21</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">75% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>9/12</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">76% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>19/25</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line medium'></div>
65
+ <div class="pad1">
66
+ <table class="coverage-summary">
67
+ <thead>
68
+ <tr>
69
+ <th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
70
+ <th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
71
+ <th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
72
+ <th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
73
+ <th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
74
+ <th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
75
+ <th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
76
+ <th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
77
+ <th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
78
+ <th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
79
+ </tr>
80
+ </thead>
81
+ <tbody><tr>
82
+ <td class="file high" data-value="key-creator.mts"><a href="key-creator.mts.html">key-creator.mts</a></td>
83
+ <td data-value="80" class="pic high">
84
+ <div class="chart"><div class="cover-fill" style="width: 80%"></div><div class="cover-empty" style="width: 20%"></div></div>
85
+ </td>
86
+ <td data-value="80" class="pct high">80%</td>
87
+ <td data-value="5" class="abs high">4/5</td>
88
+ <td data-value="100" class="pct high">100%</td>
89
+ <td data-value="1" class="abs high">1/1</td>
90
+ <td data-value="66.66" class="pct medium">66.66%</td>
91
+ <td data-value="3" class="abs medium">2/3</td>
92
+ <td data-value="80" class="pct high">80%</td>
93
+ <td data-value="5" class="abs high">4/5</td>
94
+ </tr>
95
+
96
+ <tr>
97
+ <td class="file medium" data-value="make-hook.mts"><a href="make-hook.mts.html">make-hook.mts</a></td>
98
+ <td data-value="75" class="pic medium">
99
+ <div class="chart"><div class="cover-fill" style="width: 75%"></div><div class="cover-empty" style="width: 25%"></div></div>
100
+ </td>
101
+ <td data-value="75" class="pct medium">75%</td>
102
+ <td data-value="20" class="abs medium">15/20</td>
103
+ <td data-value="85" class="pct high">85%</td>
104
+ <td data-value="20" class="abs high">17/20</td>
105
+ <td data-value="77.77" class="pct medium">77.77%</td>
106
+ <td data-value="9" class="abs medium">7/9</td>
107
+ <td data-value="75" class="pct medium">75%</td>
108
+ <td data-value="20" class="abs medium">15/20</td>
109
+ </tr>
110
+
111
+ </tbody>
112
+ </table>
113
+ </div>
114
+ <div class='push'></div><!-- for sticky footer -->
115
+ </div><!-- /wrapper -->
116
+ <div class='footer quiet pad2 space-top1 center small'>
117
+ Code coverage generated by
118
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
119
+ at 2026-01-08T14:29:05.093Z
120
+ </div>
121
+ <script src="../prettify.js"></script>
122
+ <script>
123
+ window.onload = function () {
124
+ prettyPrint();
125
+ };
126
+ </script>
127
+ <script src="../sorter.js"></script>
128
+ <script src="../block-navigation.js"></script>
129
+ </body>
130
+ </html>
131
+
@@ -0,0 +1,277 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for mutation/key-creator.mts</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../prettify.css" />
9
+ <link rel="stylesheet" href="../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../index.html">All files</a> / <a href="index.html">mutation</a> key-creator.mts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">80% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>4/5</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">100% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>1/1</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">66.66% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>2/3</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">80% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>4/5</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line high'></div>
65
+ <pre><table class="coverage">
66
+ <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
+ <a name='L2'></a><a href='#L2'>2</a>
68
+ <a name='L3'></a><a href='#L3'>3</a>
69
+ <a name='L4'></a><a href='#L4'>4</a>
70
+ <a name='L5'></a><a href='#L5'>5</a>
71
+ <a name='L6'></a><a href='#L6'>6</a>
72
+ <a name='L7'></a><a href='#L7'>7</a>
73
+ <a name='L8'></a><a href='#L8'>8</a>
74
+ <a name='L9'></a><a href='#L9'>9</a>
75
+ <a name='L10'></a><a href='#L10'>10</a>
76
+ <a name='L11'></a><a href='#L11'>11</a>
77
+ <a name='L12'></a><a href='#L12'>12</a>
78
+ <a name='L13'></a><a href='#L13'>13</a>
79
+ <a name='L14'></a><a href='#L14'>14</a>
80
+ <a name='L15'></a><a href='#L15'>15</a>
81
+ <a name='L16'></a><a href='#L16'>16</a>
82
+ <a name='L17'></a><a href='#L17'>17</a>
83
+ <a name='L18'></a><a href='#L18'>18</a>
84
+ <a name='L19'></a><a href='#L19'>19</a>
85
+ <a name='L20'></a><a href='#L20'>20</a>
86
+ <a name='L21'></a><a href='#L21'>21</a>
87
+ <a name='L22'></a><a href='#L22'>22</a>
88
+ <a name='L23'></a><a href='#L23'>23</a>
89
+ <a name='L24'></a><a href='#L24'>24</a>
90
+ <a name='L25'></a><a href='#L25'>25</a>
91
+ <a name='L26'></a><a href='#L26'>26</a>
92
+ <a name='L27'></a><a href='#L27'>27</a>
93
+ <a name='L28'></a><a href='#L28'>28</a>
94
+ <a name='L29'></a><a href='#L29'>29</a>
95
+ <a name='L30'></a><a href='#L30'>30</a>
96
+ <a name='L31'></a><a href='#L31'>31</a>
97
+ <a name='L32'></a><a href='#L32'>32</a>
98
+ <a name='L33'></a><a href='#L33'>33</a>
99
+ <a name='L34'></a><a href='#L34'>34</a>
100
+ <a name='L35'></a><a href='#L35'>35</a>
101
+ <a name='L36'></a><a href='#L36'>36</a>
102
+ <a name='L37'></a><a href='#L37'>37</a>
103
+ <a name='L38'></a><a href='#L38'>38</a>
104
+ <a name='L39'></a><a href='#L39'>39</a>
105
+ <a name='L40'></a><a href='#L40'>40</a>
106
+ <a name='L41'></a><a href='#L41'>41</a>
107
+ <a name='L42'></a><a href='#L42'>42</a>
108
+ <a name='L43'></a><a href='#L43'>43</a>
109
+ <a name='L44'></a><a href='#L44'>44</a>
110
+ <a name='L45'></a><a href='#L45'>45</a>
111
+ <a name='L46'></a><a href='#L46'>46</a>
112
+ <a name='L47'></a><a href='#L47'>47</a>
113
+ <a name='L48'></a><a href='#L48'>48</a>
114
+ <a name='L49'></a><a href='#L49'>49</a>
115
+ <a name='L50'></a><a href='#L50'>50</a>
116
+ <a name='L51'></a><a href='#L51'>51</a>
117
+ <a name='L52'></a><a href='#L52'>52</a>
118
+ <a name='L53'></a><a href='#L53'>53</a>
119
+ <a name='L54'></a><a href='#L54'>54</a>
120
+ <a name='L55'></a><a href='#L55'>55</a>
121
+ <a name='L56'></a><a href='#L56'>56</a>
122
+ <a name='L57'></a><a href='#L57'>57</a>
123
+ <a name='L58'></a><a href='#L58'>58</a>
124
+ <a name='L59'></a><a href='#L59'>59</a>
125
+ <a name='L60'></a><a href='#L60'>60</a>
126
+ <a name='L61'></a><a href='#L61'>61</a>
127
+ <a name='L62'></a><a href='#L62'>62</a>
128
+ <a name='L63'></a><a href='#L63'>63</a>
129
+ <a name='L64'></a><a href='#L64'>64</a>
130
+ <a name='L65'></a><a href='#L65'>65</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
131
+ <span class="cline-any cline-neutral">&nbsp;</span>
132
+ <span class="cline-any cline-neutral">&nbsp;</span>
133
+ <span class="cline-any cline-neutral">&nbsp;</span>
134
+ <span class="cline-any cline-neutral">&nbsp;</span>
135
+ <span class="cline-any cline-neutral">&nbsp;</span>
136
+ <span class="cline-any cline-neutral">&nbsp;</span>
137
+ <span class="cline-any cline-neutral">&nbsp;</span>
138
+ <span class="cline-any cline-neutral">&nbsp;</span>
139
+ <span class="cline-any cline-neutral">&nbsp;</span>
140
+ <span class="cline-any cline-neutral">&nbsp;</span>
141
+ <span class="cline-any cline-neutral">&nbsp;</span>
142
+ <span class="cline-any cline-neutral">&nbsp;</span>
143
+ <span class="cline-any cline-neutral">&nbsp;</span>
144
+ <span class="cline-any cline-neutral">&nbsp;</span>
145
+ <span class="cline-any cline-neutral">&nbsp;</span>
146
+ <span class="cline-any cline-neutral">&nbsp;</span>
147
+ <span class="cline-any cline-neutral">&nbsp;</span>
148
+ <span class="cline-any cline-neutral">&nbsp;</span>
149
+ <span class="cline-any cline-neutral">&nbsp;</span>
150
+ <span class="cline-any cline-neutral">&nbsp;</span>
151
+ <span class="cline-any cline-neutral">&nbsp;</span>
152
+ <span class="cline-any cline-neutral">&nbsp;</span>
153
+ <span class="cline-any cline-neutral">&nbsp;</span>
154
+ <span class="cline-any cline-neutral">&nbsp;</span>
155
+ <span class="cline-any cline-neutral">&nbsp;</span>
156
+ <span class="cline-any cline-neutral">&nbsp;</span>
157
+ <span class="cline-any cline-neutral">&nbsp;</span>
158
+ <span class="cline-any cline-neutral">&nbsp;</span>
159
+ <span class="cline-any cline-neutral">&nbsp;</span>
160
+ <span class="cline-any cline-neutral">&nbsp;</span>
161
+ <span class="cline-any cline-neutral">&nbsp;</span>
162
+ <span class="cline-any cline-neutral">&nbsp;</span>
163
+ <span class="cline-any cline-neutral">&nbsp;</span>
164
+ <span class="cline-any cline-neutral">&nbsp;</span>
165
+ <span class="cline-any cline-neutral">&nbsp;</span>
166
+ <span class="cline-any cline-neutral">&nbsp;</span>
167
+ <span class="cline-any cline-neutral">&nbsp;</span>
168
+ <span class="cline-any cline-neutral">&nbsp;</span>
169
+ <span class="cline-any cline-neutral">&nbsp;</span>
170
+ <span class="cline-any cline-neutral">&nbsp;</span>
171
+ <span class="cline-any cline-neutral">&nbsp;</span>
172
+ <span class="cline-any cline-neutral">&nbsp;</span>
173
+ <span class="cline-any cline-neutral">&nbsp;</span>
174
+ <span class="cline-any cline-neutral">&nbsp;</span>
175
+ <span class="cline-any cline-neutral">&nbsp;</span>
176
+ <span class="cline-any cline-no">&nbsp;</span>
177
+ <span class="cline-any cline-neutral">&nbsp;</span>
178
+ <span class="cline-any cline-neutral">&nbsp;</span>
179
+ <span class="cline-any cline-neutral">&nbsp;</span>
180
+ <span class="cline-any cline-neutral">&nbsp;</span>
181
+ <span class="cline-any cline-neutral">&nbsp;</span>
182
+ <span class="cline-any cline-neutral">&nbsp;</span>
183
+ <span class="cline-any cline-yes">17x</span>
184
+ <span class="cline-any cline-neutral">&nbsp;</span>
185
+ <span class="cline-any cline-neutral">&nbsp;</span>
186
+ <span class="cline-any cline-yes">17x</span>
187
+ <span class="cline-any cline-yes">2x</span>
188
+ <span class="cline-any cline-neutral">&nbsp;</span>
189
+ <span class="cline-any cline-neutral">&nbsp;</span>
190
+ <span class="cline-any cline-neutral">&nbsp;</span>
191
+ <span class="cline-any cline-neutral">&nbsp;</span>
192
+ <span class="cline-any cline-neutral">&nbsp;</span>
193
+ <span class="cline-any cline-yes">4x</span>
194
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type {
195
+ AnyEndpointConfig,
196
+ UrlHasParams,
197
+ UrlParams,
198
+ } from '@navios/builder'
199
+ import type { DataTag } from '@tanstack/react-query'
200
+ &nbsp;
201
+ import type { QueryParams } from '../query/types.mjs'
202
+ &nbsp;
203
+ import { createQueryKey } from '../query/key-creator.mjs'
204
+ &nbsp;
205
+ /**
206
+ * Creates a mutation key generator for a given endpoint configuration.
207
+ *
208
+ * @param config - The endpoint configuration
209
+ * @param options - Optional query parameters with a default `processResponse` function
210
+ * @returns A function that generates mutation keys
211
+ *
212
+ * @example Basic usage:
213
+ * ```typescript
214
+ * const createMutationKey = createMutationKey(endpoint.config);
215
+ * const mutationKey = createMutationKey({ urlParams: { id: 123 } });
216
+ * ```
217
+ *
218
+ * @example Advanced usage with processResponse:
219
+ * ```ts
220
+ * const createMutationKey = createMutationKey(endpoint.config, {
221
+ * processResponse: (data) =&gt; {
222
+ * if (!data.success) {
223
+ * throw new Error(data.message);
224
+ * }
225
+ * return data.data;
226
+ * },
227
+ * });
228
+ * // We create a mutation that will be shared across the project for all passed userId
229
+ * const mutationKey = createMutationKey({ urlParams: { projectId: 123, userId: 'wildcard' } });
230
+ * ```
231
+ */
232
+ export function createMutationKey&lt;
233
+ Config extends AnyEndpointConfig,
234
+ Options extends QueryParams&lt;Config&gt;,
235
+ Url extends Config['url'] = Config['url'],
236
+ HasParams extends UrlHasParams&lt;Url&gt; = UrlHasParams&lt;Url&gt;,
237
+ &gt;(
238
+ config: Config,
239
+ options: Options = {
240
+ processResponse: <span class="fstat-no" title="function not covered" >(d</span>ata) =&gt; <span class="cstat-no" title="statement not covered" >data,</span>
241
+ } as Options,
242
+ ): (
243
+ params: HasParams extends true ? { urlParams: UrlParams&lt;Url&gt; } : {},
244
+ ) =&gt; Options['processResponse'] extends (...args: unknown[]) =&gt; infer Result
245
+ ? DataTag&lt;[Config['url']], Result, Error&gt;
246
+ : never {
247
+ const queryKey = createQueryKey(config, options, false)
248
+ &nbsp;
249
+ // @ts-expect-error We have correct types in return type
250
+ return (params) =&gt; {
251
+ return queryKey.filterKey(params)
252
+ }
253
+ }
254
+ &nbsp;
255
+ // Legacy export for backwards compatibility
256
+ /** @deprecated Use createMutationKey instead */
257
+ export const mutationKeyCreator = createMutationKey
258
+ &nbsp;</pre></td></tr></table></pre>
259
+
260
+ <div class='push'></div><!-- for sticky footer -->
261
+ </div><!-- /wrapper -->
262
+ <div class='footer quiet pad2 space-top1 center small'>
263
+ Code coverage generated by
264
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
265
+ at 2026-01-08T14:29:05.093Z
266
+ </div>
267
+ <script src="../prettify.js"></script>
268
+ <script>
269
+ window.onload = function () {
270
+ prettyPrint();
271
+ };
272
+ </script>
273
+ <script src="../sorter.js"></script>
274
+ <script src="../block-navigation.js"></script>
275
+ </body>
276
+ </html>
277
+