@faasjs/react 0.0.3-beta.7 → 0.0.3-beta.70
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/README.md +22 -83
- package/dist/index.d.ts +15 -9
- package/dist/index.js +15 -4
- package/dist/index.mjs +17 -5
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ React plugin for FaasJS.
|
|
|
10
10
|
|
|
11
11
|
## Install
|
|
12
12
|
|
|
13
|
-
npm install @faasjs/react
|
|
13
|
+
npm install @faasjs/react react react-dom
|
|
14
14
|
|
|
15
15
|
## Modules
|
|
16
16
|
|
|
@@ -20,14 +20,17 @@ React plugin for FaasJS.
|
|
|
20
20
|
- [Response](classes/Response.md)
|
|
21
21
|
- [ResponseError](classes/ResponseError.md)
|
|
22
22
|
|
|
23
|
+
### Interfaces
|
|
24
|
+
|
|
25
|
+
- [FaasDataInjection](interfaces/FaasDataInjection.md)
|
|
26
|
+
- [FaasDataWrapperProps](interfaces/FaasDataWrapperProps.md)
|
|
27
|
+
- [FaasReactClientInstance](interfaces/FaasReactClientInstance.md)
|
|
28
|
+
|
|
23
29
|
### Type Aliases
|
|
24
30
|
|
|
25
31
|
- [FaasAction](#faasaction)
|
|
26
32
|
- [FaasData](#faasdata)
|
|
27
|
-
- [FaasDataInjection](#faasdatainjection)
|
|
28
|
-
- [FaasDataWrapperProps](#faasdatawrapperprops)
|
|
29
33
|
- [FaasParams](#faasparams)
|
|
30
|
-
- [FaasReactClientInstance](#faasreactclientinstance)
|
|
31
34
|
- [Options](#options)
|
|
32
35
|
- [ResponseHeaders](#responseheaders)
|
|
33
36
|
|
|
@@ -59,60 +62,6 @@ ___
|
|
|
59
62
|
|
|
60
63
|
___
|
|
61
64
|
|
|
62
|
-
### FaasDataInjection
|
|
63
|
-
|
|
64
|
-
Ƭ **FaasDataInjection**<`Data`\>: `Object`
|
|
65
|
-
|
|
66
|
-
Injects FaasData props.
|
|
67
|
-
|
|
68
|
-
#### Type parameters
|
|
69
|
-
|
|
70
|
-
| Name | Type |
|
|
71
|
-
| :------ | :------ |
|
|
72
|
-
| `Data` | `any` |
|
|
73
|
-
|
|
74
|
-
#### Type declaration
|
|
75
|
-
|
|
76
|
-
| Name | Type |
|
|
77
|
-
| :------ | :------ |
|
|
78
|
-
| `action` | `string` \| `any` |
|
|
79
|
-
| `data` | `Data` |
|
|
80
|
-
| `error` | `any` |
|
|
81
|
-
| `loading` | `boolean` |
|
|
82
|
-
| `params` | `Record`<`string`, `any`\> |
|
|
83
|
-
| `promise` | `Promise`<[`Response`](classes/Response.md)<`Data`\>\> |
|
|
84
|
-
| `setData` | `React.Dispatch`<`React.SetStateAction`<`Data`\>\> |
|
|
85
|
-
| `setError` | `React.Dispatch`<`React.SetStateAction`<`any`\>\> |
|
|
86
|
-
| `setLoading` | `React.Dispatch`<`React.SetStateAction`<`boolean`\>\> |
|
|
87
|
-
| `setPromise` | `React.Dispatch`<`React.SetStateAction`<`Promise`<[`Response`](classes/Response.md)<`Data`\>\>\>\> |
|
|
88
|
-
| `reload` | (`params?`: `Record`<`string`, `any`\>) => `Promise`<[`Response`](classes/Response.md)<`Data`\>\> |
|
|
89
|
-
|
|
90
|
-
___
|
|
91
|
-
|
|
92
|
-
### FaasDataWrapperProps
|
|
93
|
-
|
|
94
|
-
Ƭ **FaasDataWrapperProps**<`PathOrData`\>: `Object`
|
|
95
|
-
|
|
96
|
-
#### Type parameters
|
|
97
|
-
|
|
98
|
-
| Name | Type |
|
|
99
|
-
| :------ | :------ |
|
|
100
|
-
| `PathOrData` | extends [`FaasAction`](#faasaction) |
|
|
101
|
-
|
|
102
|
-
#### Type declaration
|
|
103
|
-
|
|
104
|
-
| Name | Type | Description |
|
|
105
|
-
| :------ | :------ | :------ |
|
|
106
|
-
| `action` | `string` | - |
|
|
107
|
-
| `data?` | [`FaasData`](#faasdata)<`PathOrData`\> | use custom data, should work with setData |
|
|
108
|
-
| `fallback?` | `JSX.Element` \| ``false`` | - |
|
|
109
|
-
| `params?` | [`FaasParams`](#faasparams)<`PathOrData`\> | - |
|
|
110
|
-
| `setData?` | `React.Dispatch`<`React.SetStateAction`<[`FaasData`](#faasdata)<`PathOrData`\>\>\> | use custom setData, should work with data |
|
|
111
|
-
| `onDataChange?` | (`args`: [`FaasDataInjection`](#faasdatainjection)<[`FaasData`](#faasdata)<`PathOrData`\>\>) => `void` | - |
|
|
112
|
-
| `render?` | (`args`: [`FaasDataInjection`](#faasdatainjection)<[`FaasData`](#faasdata)<`PathOrData`\>\>) => `Element` \| `Element`[] | - |
|
|
113
|
-
|
|
114
|
-
___
|
|
115
|
-
|
|
116
65
|
### FaasParams
|
|
117
66
|
|
|
118
67
|
Ƭ **FaasParams**<`T`\>: `T` extends `FaasActionPaths` ? `FaasActions`[`T`][``"Params"``] : `any`
|
|
@@ -125,20 +74,6 @@ ___
|
|
|
125
74
|
|
|
126
75
|
___
|
|
127
76
|
|
|
128
|
-
### FaasReactClientInstance
|
|
129
|
-
|
|
130
|
-
Ƭ **FaasReactClientInstance**: `Object`
|
|
131
|
-
|
|
132
|
-
#### Type declaration
|
|
133
|
-
|
|
134
|
-
| Name | Type |
|
|
135
|
-
| :------ | :------ |
|
|
136
|
-
| `faas` | <PathOrData\>(`action`: `string` \| `PathOrData`, `params`: [`FaasParams`](#faasparams)<`PathOrData`\>) => `Promise`<[`Response`](classes/Response.md)<[`FaasData`](#faasdata)<`PathOrData`\>\>\> |
|
|
137
|
-
| `useFaas` | <PathOrData\>(`action`: `string` \| `PathOrData`, `defaultParams`: [`FaasParams`](#faasparams)<`PathOrData`\>) => [`FaasDataInjection`](#faasdatainjection)<[`FaasData`](#faasdata)<`PathOrData`\>\> |
|
|
138
|
-
| `FaasDataWrapper` | <PathOrData\>(`props`: [`FaasDataWrapperProps`](#faasdatawrapperprops)<`PathOrData`\>) => `Element` |
|
|
139
|
-
|
|
140
|
-
___
|
|
141
|
-
|
|
142
77
|
### Options
|
|
143
78
|
|
|
144
79
|
Ƭ **Options**: `RequestInit` & { `beforeRequest?`: (`{
|
|
@@ -173,7 +108,7 @@ A data wrapper for react components
|
|
|
173
108
|
|
|
174
109
|
| Name | Type |
|
|
175
110
|
| :------ | :------ |
|
|
176
|
-
| `props` | [`FaasDataWrapperProps`](
|
|
111
|
+
| `props` | [`FaasDataWrapperProps`](interfaces/FaasDataWrapperProps.md)<`PathOrData`\> |
|
|
177
112
|
|
|
178
113
|
#### Returns
|
|
179
114
|
|
|
@@ -194,7 +129,7 @@ ___
|
|
|
194
129
|
|
|
195
130
|
### FaasReactClient
|
|
196
131
|
|
|
197
|
-
▸ **FaasReactClient**(
|
|
132
|
+
▸ **FaasReactClient**(`«destructured»`): [`FaasReactClientInstance`](interfaces/FaasReactClientInstance.md)
|
|
198
133
|
|
|
199
134
|
Before use faas, you should initialize a FaasReactClient.
|
|
200
135
|
|
|
@@ -202,14 +137,14 @@ Before use faas, you should initialize a FaasReactClient.
|
|
|
202
137
|
|
|
203
138
|
| Name | Type |
|
|
204
139
|
| :------ | :------ |
|
|
205
|
-
|
|
|
206
|
-
| `
|
|
207
|
-
| `
|
|
208
|
-
| `
|
|
140
|
+
| `«destructured»` | `Object` |
|
|
141
|
+
| › `domain` | `string` |
|
|
142
|
+
| › `onError?` | (`action`: `string`, `params`: `Record`<`string`, `any`\>) => (`res`: [`ResponseError`](classes/ResponseError.md)) => `Promise`<`void`\> |
|
|
143
|
+
| › `options?` | [`Options`](#options) |
|
|
209
144
|
|
|
210
145
|
#### Returns
|
|
211
146
|
|
|
212
|
-
[`FaasReactClientInstance`](
|
|
147
|
+
[`FaasReactClientInstance`](interfaces/FaasReactClientInstance.md)
|
|
213
148
|
|
|
214
149
|
```ts
|
|
215
150
|
const client = FaasReactClient({
|
|
@@ -252,7 +187,7 @@ ___
|
|
|
252
187
|
|
|
253
188
|
### getClient
|
|
254
189
|
|
|
255
|
-
▸ **getClient**(`domain?`): [`FaasReactClientInstance`](
|
|
190
|
+
▸ **getClient**(`domain?`): [`FaasReactClientInstance`](interfaces/FaasReactClientInstance.md)
|
|
256
191
|
|
|
257
192
|
Get FaasReactClient instance
|
|
258
193
|
|
|
@@ -264,7 +199,7 @@ Get FaasReactClient instance
|
|
|
264
199
|
|
|
265
200
|
#### Returns
|
|
266
201
|
|
|
267
|
-
[`FaasReactClientInstance`](
|
|
202
|
+
[`FaasReactClientInstance`](interfaces/FaasReactClientInstance.md)
|
|
268
203
|
|
|
269
204
|
```ts
|
|
270
205
|
getClient()
|
|
@@ -276,7 +211,7 @@ ___
|
|
|
276
211
|
|
|
277
212
|
### useFaas
|
|
278
213
|
|
|
279
|
-
▸ **useFaas**<`PathOrData`\>(`action`, `defaultParams`): [`FaasDataInjection`](
|
|
214
|
+
▸ **useFaas**<`PathOrData`\>(`action`, `defaultParams`, `options?`): [`FaasDataInjection`](interfaces/FaasDataInjection.md)<[`FaasData`](#faasdata)<`PathOrData`\>\>
|
|
280
215
|
|
|
281
216
|
Request faas server with React hook
|
|
282
217
|
|
|
@@ -292,10 +227,14 @@ Request faas server with React hook
|
|
|
292
227
|
| :------ | :------ | :------ |
|
|
293
228
|
| `action` | `string` \| `PathOrData` | {string} action name |
|
|
294
229
|
| `defaultParams` | [`FaasParams`](#faasparams)<`PathOrData`\> | {object} initial action params |
|
|
230
|
+
| `options?` | `Object` | - |
|
|
231
|
+
| `options.data?` | [`FaasData`](#faasdata)<`PathOrData`\> | - |
|
|
232
|
+
| `options.setData?` | `Dispatch`<`SetStateAction`<[`FaasData`](#faasdata)<`PathOrData`\>\>\> | - |
|
|
233
|
+
| `options.skip?` | `boolean` | - |
|
|
295
234
|
|
|
296
235
|
#### Returns
|
|
297
236
|
|
|
298
|
-
[`FaasDataInjection`](
|
|
237
|
+
[`FaasDataInjection`](interfaces/FaasDataInjection.md)<[`FaasData`](#faasdata)<`PathOrData`\>\>
|
|
299
238
|
|
|
300
239
|
```ts
|
|
301
240
|
function Post ({ id }) {
|
package/dist/index.d.ts
CHANGED
|
@@ -1,12 +1,17 @@
|
|
|
1
1
|
import { Response, Options, ResponseError } from '@faasjs/browser';
|
|
2
2
|
export { FaasBrowserClient, Options, Response, ResponseError, ResponseHeaders } from '@faasjs/browser';
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
|
|
4
|
+
interface FaasActions {
|
|
5
|
+
}
|
|
6
|
+
type FaasActionPaths = keyof FaasActions;
|
|
7
|
+
type FaasAction = FaasActionPaths | Record<string, any>;
|
|
8
|
+
type FaasParams<T = any> = T extends FaasActionPaths ? FaasActions[T]['Params'] : any;
|
|
9
|
+
type FaasData<T = any> = T extends FaasActionPaths ? FaasActions[T]['Data'] : T;
|
|
5
10
|
|
|
6
11
|
/**
|
|
7
12
|
* Injects FaasData props.
|
|
8
13
|
*/
|
|
9
|
-
|
|
14
|
+
interface FaasDataInjection<Data = any> {
|
|
10
15
|
action: string | any;
|
|
11
16
|
params: Record<string, any>;
|
|
12
17
|
loading: boolean;
|
|
@@ -18,9 +23,10 @@ type FaasDataInjection<Data = any> = {
|
|
|
18
23
|
setLoading: React.Dispatch<React.SetStateAction<boolean>>;
|
|
19
24
|
setPromise: React.Dispatch<React.SetStateAction<Promise<Response<Data>>>>;
|
|
20
25
|
setError: React.Dispatch<React.SetStateAction<any>>;
|
|
21
|
-
}
|
|
22
|
-
|
|
26
|
+
}
|
|
27
|
+
interface FaasDataWrapperProps<PathOrData extends FaasAction> {
|
|
23
28
|
render?(args: FaasDataInjection<FaasData<PathOrData>>): JSX.Element | JSX.Element[];
|
|
29
|
+
children?: React.ReactElement<Partial<FaasDataInjection>>;
|
|
24
30
|
fallback?: JSX.Element | false;
|
|
25
31
|
action: string;
|
|
26
32
|
params?: FaasParams<PathOrData>;
|
|
@@ -29,8 +35,8 @@ type FaasDataWrapperProps<PathOrData extends FaasAction> = {
|
|
|
29
35
|
data?: FaasData<PathOrData>;
|
|
30
36
|
/** use custom setData, should work with data */
|
|
31
37
|
setData?: React.Dispatch<React.SetStateAction<FaasData<PathOrData>>>;
|
|
32
|
-
}
|
|
33
|
-
|
|
38
|
+
}
|
|
39
|
+
interface FaasReactClientInstance {
|
|
34
40
|
faas: <PathOrData extends FaasAction>(action: string | PathOrData, params: FaasParams<PathOrData>) => Promise<Response<FaasData<PathOrData>>>;
|
|
35
41
|
useFaas: <PathOrData extends FaasAction>(action: string | PathOrData, defaultParams: FaasParams<PathOrData>, options?: {
|
|
36
42
|
data?: FaasData<PathOrData>;
|
|
@@ -38,7 +44,7 @@ type FaasReactClientInstance = {
|
|
|
38
44
|
skip?: boolean;
|
|
39
45
|
}) => FaasDataInjection<FaasData<PathOrData>>;
|
|
40
46
|
FaasDataWrapper<PathOrData extends FaasAction>(props: FaasDataWrapperProps<PathOrData>): JSX.Element;
|
|
41
|
-
}
|
|
47
|
+
}
|
|
42
48
|
/**
|
|
43
49
|
* Before use faas, you should initialize a FaasReactClient.
|
|
44
50
|
*
|
|
@@ -118,4 +124,4 @@ declare function useFaas<PathOrData extends FaasAction>(action: string | PathOrD
|
|
|
118
124
|
*/
|
|
119
125
|
declare function FaasDataWrapper<PathOrData extends FaasAction>(props: FaasDataWrapperProps<PathOrData>): JSX.Element;
|
|
120
126
|
|
|
121
|
-
export { FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, FaasReactClient, FaasReactClientInstance, faas, getClient, useFaas };
|
|
127
|
+
export { FaasAction, FaasData, FaasDataInjection, FaasDataWrapper, FaasDataWrapperProps, FaasParams, FaasReactClient, FaasReactClientInstance, faas, getClient, useFaas };
|
package/dist/index.js
CHANGED
|
@@ -64,9 +64,12 @@ function FaasReactClient({
|
|
|
64
64
|
return;
|
|
65
65
|
}
|
|
66
66
|
setLoading(true);
|
|
67
|
-
const
|
|
67
|
+
const controller = new AbortController();
|
|
68
|
+
const request = client.action(action, params, { signal: controller.signal });
|
|
68
69
|
setPromise(request);
|
|
69
70
|
request.then((r) => (options2 == null ? void 0 : options2.setData) ? options2.setData(r.data) : setData(r.data)).catch(async (e) => {
|
|
71
|
+
if ((e == null ? void 0 : e.message) === "The user aborted a request.")
|
|
72
|
+
return;
|
|
70
73
|
if (onError)
|
|
71
74
|
try {
|
|
72
75
|
await onError(action, params)(e);
|
|
@@ -77,7 +80,10 @@ function FaasReactClient({
|
|
|
77
80
|
setError(e);
|
|
78
81
|
return Promise.reject(e);
|
|
79
82
|
}).finally(() => setLoading(false));
|
|
80
|
-
return () =>
|
|
83
|
+
return () => {
|
|
84
|
+
controller.abort();
|
|
85
|
+
setLoading(false);
|
|
86
|
+
};
|
|
81
87
|
}, [
|
|
82
88
|
action,
|
|
83
89
|
JSON.stringify(params),
|
|
@@ -111,6 +117,7 @@ function FaasReactClient({
|
|
|
111
117
|
params,
|
|
112
118
|
fallback,
|
|
113
119
|
render,
|
|
120
|
+
children,
|
|
114
121
|
onDataChange,
|
|
115
122
|
data,
|
|
116
123
|
setData
|
|
@@ -128,8 +135,12 @@ function FaasReactClient({
|
|
|
128
135
|
if (onDataChange)
|
|
129
136
|
onDataChange(request);
|
|
130
137
|
}, [JSON.stringify(request.data)]);
|
|
131
|
-
if (loaded)
|
|
132
|
-
|
|
138
|
+
if (loaded) {
|
|
139
|
+
if (children)
|
|
140
|
+
return (0, import_react.cloneElement)(children, request);
|
|
141
|
+
if (render)
|
|
142
|
+
return render(request);
|
|
143
|
+
}
|
|
133
144
|
return fallback || null;
|
|
134
145
|
}
|
|
135
146
|
};
|
package/dist/index.mjs
CHANGED
|
@@ -5,7 +5,8 @@ import {
|
|
|
5
5
|
import {
|
|
6
6
|
useState,
|
|
7
7
|
useEffect,
|
|
8
|
-
createElement
|
|
8
|
+
createElement,
|
|
9
|
+
cloneElement
|
|
9
10
|
} from "react";
|
|
10
11
|
var clients = {};
|
|
11
12
|
function FaasReactClient({
|
|
@@ -42,9 +43,12 @@ function FaasReactClient({
|
|
|
42
43
|
return;
|
|
43
44
|
}
|
|
44
45
|
setLoading(true);
|
|
45
|
-
const
|
|
46
|
+
const controller = new AbortController();
|
|
47
|
+
const request = client.action(action, params, { signal: controller.signal });
|
|
46
48
|
setPromise(request);
|
|
47
49
|
request.then((r) => (options2 == null ? void 0 : options2.setData) ? options2.setData(r.data) : setData(r.data)).catch(async (e) => {
|
|
50
|
+
if ((e == null ? void 0 : e.message) === "The user aborted a request.")
|
|
51
|
+
return;
|
|
48
52
|
if (onError)
|
|
49
53
|
try {
|
|
50
54
|
await onError(action, params)(e);
|
|
@@ -55,7 +59,10 @@ function FaasReactClient({
|
|
|
55
59
|
setError(e);
|
|
56
60
|
return Promise.reject(e);
|
|
57
61
|
}).finally(() => setLoading(false));
|
|
58
|
-
return () =>
|
|
62
|
+
return () => {
|
|
63
|
+
controller.abort();
|
|
64
|
+
setLoading(false);
|
|
65
|
+
};
|
|
59
66
|
}, [
|
|
60
67
|
action,
|
|
61
68
|
JSON.stringify(params),
|
|
@@ -89,6 +96,7 @@ function FaasReactClient({
|
|
|
89
96
|
params,
|
|
90
97
|
fallback,
|
|
91
98
|
render,
|
|
99
|
+
children,
|
|
92
100
|
onDataChange,
|
|
93
101
|
data,
|
|
94
102
|
setData
|
|
@@ -106,8 +114,12 @@ function FaasReactClient({
|
|
|
106
114
|
if (onDataChange)
|
|
107
115
|
onDataChange(request);
|
|
108
116
|
}, [JSON.stringify(request.data)]);
|
|
109
|
-
if (loaded)
|
|
110
|
-
|
|
117
|
+
if (loaded) {
|
|
118
|
+
if (children)
|
|
119
|
+
return cloneElement(children, request);
|
|
120
|
+
if (render)
|
|
121
|
+
return render(request);
|
|
122
|
+
}
|
|
111
123
|
return fallback || null;
|
|
112
124
|
}
|
|
113
125
|
};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@faasjs/react",
|
|
3
|
-
"version": "0.0.3-beta.
|
|
3
|
+
"version": "0.0.3-beta.70",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"module": "dist/index.mjs",
|
|
@@ -16,15 +16,15 @@
|
|
|
16
16
|
},
|
|
17
17
|
"funding": "https://github.com/sponsors/faasjs",
|
|
18
18
|
"scripts": {
|
|
19
|
-
"build": "tsup src/index.tsx --format esm,cjs"
|
|
20
|
-
"build:types": "tsup-node src/index.tsx --dts-only"
|
|
19
|
+
"build": "tsup src/index.tsx --format esm,cjs --dts --clean"
|
|
21
20
|
},
|
|
22
21
|
"files": [
|
|
23
22
|
"dist"
|
|
24
23
|
],
|
|
25
24
|
"dependencies": {
|
|
26
|
-
"@faasjs/browser": "^0.0.3-beta.
|
|
27
|
-
|
|
25
|
+
"@faasjs/browser": "^0.0.3-beta.70"
|
|
26
|
+
},
|
|
27
|
+
"peerDependencies": {
|
|
28
28
|
"react": "*"
|
|
29
29
|
},
|
|
30
30
|
"devDependencies": {
|