@hyper-fetch/react 1.7.0 โ 2.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.
- package/README.md +4 -3
- package/dist/config-provider/config-provider.types.d.ts +7 -7
- package/dist/helpers/index.d.ts +1 -0
- package/dist/helpers/use-command-events/use-command-events.hooks.d.ts +2 -3
- package/dist/helpers/use-command-events/use-command-events.types.d.ts +12 -12
- package/dist/helpers/use-socket-state/index.d.ts +3 -0
- package/dist/helpers/use-socket-state/use-socket-state.constants.d.ts +2 -0
- package/dist/helpers/use-socket-state/use-socket-state.hooks.d.ts +16 -0
- package/dist/helpers/use-socket-state/use-socket-state.types.d.ts +9 -0
- package/dist/helpers/use-tracked-state/use-tracked-state.hooks.d.ts +1 -2
- package/dist/helpers/use-tracked-state/use-tracked-state.types.d.ts +5 -5
- package/dist/helpers/use-tracked-state/use-tracked-state.utils.d.ts +5 -5
- package/dist/hooks/use-app-manager/use-app-manager.hooks.d.ts +2 -3
- package/dist/hooks/use-app-manager/use-app-manager.types.d.ts +1 -1
- package/dist/hooks/use-cache/use-cache.hooks.d.ts +2 -3
- package/dist/hooks/use-cache/use-cache.types.d.ts +4 -4
- package/dist/hooks/use-emitter/index.d.ts +2 -0
- package/dist/hooks/use-emitter/use-emitter.hooks.d.ts +19 -0
- package/dist/hooks/use-emitter/use-emitter.types.d.ts +3 -0
- package/dist/hooks/use-event-messages/index.d.ts +2 -0
- package/dist/hooks/use-event-messages/use-event-messages.hooks.d.ts +24 -0
- package/dist/hooks/use-event-messages/use-event-messages.types.d.ts +4 -0
- package/dist/hooks/use-fetch/use-fetch.constants.d.ts +2 -2
- package/dist/hooks/use-fetch/use-fetch.hooks.d.ts +2 -3
- package/dist/hooks/use-fetch/use-fetch.types.d.ts +5 -5
- package/dist/hooks/use-listener/index.d.ts +2 -0
- package/dist/hooks/use-listener/use-listener.hooks.d.ts +20 -0
- package/dist/hooks/use-listener/use-listener.types.d.ts +3 -0
- package/dist/hooks/use-queue/use-queue.constants.d.ts +1 -1
- package/dist/hooks/use-queue/use-queue.hooks.d.ts +2 -3
- package/dist/hooks/use-queue/use-queue.types.d.ts +3 -3
- package/dist/hooks/use-submit/use-submit.constants.d.ts +1 -1
- package/dist/hooks/use-submit/use-submit.hooks.d.ts +2 -3
- package/dist/hooks/use-submit/use-submit.types.d.ts +14 -14
- package/dist/index.cjs.js +1 -1
- package/dist/index.cjs.js.map +4 -4
- package/dist/index.esm.js +1 -1
- package/dist/index.esm.js.map +4 -4
- package/dist/types/invalidation.types.d.ts +1 -1
- package/package.json +11 -3
- package/src/helpers/index.ts +1 -0
- package/src/helpers/use-socket-state/index.ts +3 -0
- package/src/helpers/use-socket-state/use-socket-state.constants.ts +8 -0
- package/src/helpers/use-socket-state/use-socket-state.hooks.ts +135 -0
- package/src/helpers/use-socket-state/use-socket-state.types.ts +10 -0
- package/src/hooks/use-emitter/index.ts +2 -0
- package/src/hooks/use-emitter/use-emitter.hooks.ts +47 -0
- package/src/hooks/use-emitter/use-emitter.types.ts +3 -0
- package/src/hooks/use-event-messages/index.ts +2 -0
- package/src/hooks/use-event-messages/use-event-messages.hooks.ts +65 -0
- package/src/hooks/use-event-messages/use-event-messages.types.ts +4 -0
- package/src/hooks/use-listener/index.ts +2 -0
- package/src/hooks/use-listener/use-listener.hooks.ts +75 -0
- package/src/hooks/use-listener/use-listener.types.ts +3 -0
- package/src/hooks/use-submit/use-submit.hooks.ts +18 -14
- package/src/hooks/use-submit/use-submit.types.ts +14 -17
package/README.md
CHANGED
|
@@ -49,7 +49,7 @@ fetch or mutate data, observe sent requests and interact with data in the cache.
|
|
|
49
49
|
|
|
50
50
|
๐ **Queueing** - [Read more](https://hyperfetch.bettertyped.com/guides/Advanced/Queueing)
|
|
51
51
|
|
|
52
|
-
๐ **Automatic caching** - [Read more](https://hyperfetch.bettertyped.com/docs/
|
|
52
|
+
๐ **Automatic caching** - [Read more](https://hyperfetch.bettertyped.com/docs/Core/Cache)
|
|
53
53
|
|
|
54
54
|
๐ช **Persistance** - [Read more](https://hyperfetch.bettertyped.com/guides/Advanced/Persistence)
|
|
55
55
|
|
|
@@ -57,7 +57,7 @@ fetch or mutate data, observe sent requests and interact with data in the cache.
|
|
|
57
57
|
|
|
58
58
|
๐ **Offline First** - [Read more](https://hyperfetch.bettertyped.com/guides/Advanced/Offline)
|
|
59
59
|
|
|
60
|
-
๐ก **Built-in client** - [Read more](https://hyperfetch.bettertyped.com/docs/
|
|
60
|
+
๐ก **Built-in client** - [Read more](https://hyperfetch.bettertyped.com/docs/Core/Client)
|
|
61
61
|
|
|
62
62
|
๐งช **Easy to test** - [Read more](https://hyperfetch.bettertyped.com/docs/Getting%20Started/Testing)
|
|
63
63
|
|
|
@@ -75,4 +75,5 @@ fetch or mutate data, observe sent requests and interact with data in the cache.
|
|
|
75
75
|
|
|
76
76
|
## Other Packages
|
|
77
77
|
|
|
78
|
-
- #### [Hyper Fetch](https://github.com/BetterTyped/hyper-fetch/tree/main/packages/core)
|
|
78
|
+
- - #### [Hyper Fetch](https://github.com/BetterTyped/hyper-fetch/tree/main/packages/core)
|
|
79
|
+
- #### [Hyper Fetch Sockets](https://github.com/BetterTyped/hyper-fetch/tree/main/packages/sockets)
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
import React from "react";
|
|
2
2
|
import { CommandInstance } from "@hyper-fetch/core";
|
|
3
|
-
import { UseFetchOptionsType } from "
|
|
4
|
-
import { UseSubmitOptionsType } from "
|
|
5
|
-
import { UseCacheOptionsType } from "
|
|
6
|
-
import { UseQueueOptionsType } from "
|
|
7
|
-
export
|
|
3
|
+
import { UseFetchOptionsType } from "hooks/use-fetch";
|
|
4
|
+
import { UseSubmitOptionsType } from "hooks/use-submit";
|
|
5
|
+
import { UseCacheOptionsType } from "hooks/use-cache";
|
|
6
|
+
import { UseQueueOptionsType } from "hooks/use-queue";
|
|
7
|
+
export type ConfigProviderOptionsType = {
|
|
8
8
|
useFetchConfig?: Partial<UseFetchOptionsType<CommandInstance>>;
|
|
9
9
|
useSubmitConfig?: Partial<UseSubmitOptionsType<CommandInstance>>;
|
|
10
10
|
useCacheConfig?: Partial<UseCacheOptionsType<CommandInstance>>;
|
|
11
11
|
useQueueConfig?: Partial<UseQueueOptionsType>;
|
|
12
12
|
};
|
|
13
|
-
export
|
|
13
|
+
export type ConfigProviderProps = {
|
|
14
14
|
children: React.ReactNode;
|
|
15
15
|
config?: ConfigProviderOptionsType;
|
|
16
16
|
};
|
|
17
|
-
export
|
|
17
|
+
export type ConfigProviderValueType = [ConfigProviderOptionsType, (newConfig: ConfigProviderOptionsType) => void];
|
package/dist/helpers/index.d.ts
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { UseCommandEventsReturnType, UseCommandEventsPropsType } from "./..";
|
|
1
|
+
import { UseCommandEventsReturnType, UseCommandEventsPropsType } from "helpers";
|
|
3
2
|
/**
|
|
4
3
|
* This is helper hook that handles main Hyper-Fetch event/data flow
|
|
5
4
|
* @internal
|
|
6
5
|
* @param options
|
|
7
6
|
* @returns
|
|
8
7
|
*/
|
|
9
|
-
export declare const useCommandEvents: <T extends
|
|
8
|
+
export declare const useCommandEvents: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>({ command, dispatcher, logger, actions, setCacheData, }: UseCommandEventsPropsType<T>) => UseCommandEventsReturnType<T>;
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
import { Dispatcher, ExtractError, CacheValueType, ExtractResponse, LoggerType, FetchProgressType, ExtractClientReturnType, CommandEventDetails, CommandInstance, CommandResponseDetails } from "@hyper-fetch/core";
|
|
2
|
-
import { UseTrackedStateActions } from "
|
|
3
|
-
export
|
|
2
|
+
import { UseTrackedStateActions } from "helpers";
|
|
3
|
+
export type UseCommandEventsDataMap = {
|
|
4
4
|
unmount: VoidFunction;
|
|
5
5
|
};
|
|
6
|
-
export
|
|
6
|
+
export type UseCommandEventsLifecycleMap = Map<string, {
|
|
7
7
|
unmount: VoidFunction;
|
|
8
8
|
}>;
|
|
9
|
-
export
|
|
9
|
+
export type UseCommandEventsPropsType<T extends CommandInstance> = {
|
|
10
10
|
command: T;
|
|
11
11
|
dispatcher: Dispatcher;
|
|
12
12
|
logger: LoggerType;
|
|
13
13
|
actions: UseTrackedStateActions<T>;
|
|
14
14
|
setCacheData: (cacheData: CacheValueType<ExtractResponse<T>, ExtractError<T>>) => void;
|
|
15
15
|
};
|
|
16
|
-
export
|
|
16
|
+
export type UseCommandEventsActionsType<T extends CommandInstance> = {
|
|
17
17
|
/**
|
|
18
18
|
* Callback that allows canceling ongoing requests from the given queueKey.
|
|
19
19
|
*/
|
|
@@ -55,7 +55,7 @@ export declare type UseCommandEventsActionsType<T extends CommandInstance> = {
|
|
|
55
55
|
*/
|
|
56
56
|
onUploadProgress: (callback: OnProgressCallbackType) => void;
|
|
57
57
|
};
|
|
58
|
-
export
|
|
58
|
+
export type UseCommandEventsReturnType<T extends CommandInstance> = [
|
|
59
59
|
UseCommandEventsActionsType<T>,
|
|
60
60
|
{
|
|
61
61
|
addDataListener: (command: CommandInstance) => VoidFunction;
|
|
@@ -65,16 +65,16 @@ export declare type UseCommandEventsReturnType<T extends CommandInstance> = [
|
|
|
65
65
|
clearLifecycleListeners: () => void;
|
|
66
66
|
}
|
|
67
67
|
];
|
|
68
|
-
export
|
|
68
|
+
export type CallbackParameters<Command, ResponseType> = {
|
|
69
69
|
response: ResponseType;
|
|
70
70
|
details: CommandResponseDetails;
|
|
71
71
|
command: Command;
|
|
72
72
|
};
|
|
73
|
-
export
|
|
74
|
-
export
|
|
75
|
-
export
|
|
76
|
-
export
|
|
73
|
+
export type OnSuccessCallbackType<Command extends CommandInstance> = (params: CallbackParameters<Command, ExtractResponse<Command>>) => void | Promise<void>;
|
|
74
|
+
export type OnErrorCallbackType<Command extends CommandInstance> = (params: CallbackParameters<Command, ExtractError<Command>>) => void | Promise<void>;
|
|
75
|
+
export type OnFinishedCallbackType<Command extends CommandInstance> = (params: CallbackParameters<Command, ExtractClientReturnType<Command>>) => void | Promise<void>;
|
|
76
|
+
export type OnStartCallbackType<Command extends CommandInstance> = (params: {
|
|
77
77
|
details: CommandEventDetails<Command>;
|
|
78
78
|
command: Command;
|
|
79
79
|
}) => void | Promise<void>;
|
|
80
|
-
export
|
|
80
|
+
export type OnProgressCallbackType = <Command extends CommandInstance>(progress: FetchProgressType, details: CommandEventDetails<Command>) => void | Promise<void>;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { UseSocketStateType, UseSocketStateProps } from "helpers";
|
|
2
|
+
export declare const useSocketState: <DataType>(socket: Socket<any>, { dependencyTracking }: UseSocketStateProps) => readonly [UseSocketStateType<DataType>, {
|
|
3
|
+
setData: (data: DataType) => void;
|
|
4
|
+
setConnected: (connected: boolean) => void;
|
|
5
|
+
setConnecting: (connecting: boolean) => void;
|
|
6
|
+
setTimestamp: (timestamp: number | null) => void;
|
|
7
|
+
}, {
|
|
8
|
+
onOpen: (callback: VoidFunction) => void;
|
|
9
|
+
onClose: (callback: VoidFunction) => void;
|
|
10
|
+
onError: <ErrorType = Event>(callback: (event: ErrorType) => void) => void;
|
|
11
|
+
onConnecting: (callback: VoidFunction) => void;
|
|
12
|
+
onReconnecting: (callback: (attempts: number) => void) => void;
|
|
13
|
+
onReconnectingStop: (callback: (attempts: number) => void) => void;
|
|
14
|
+
}, {
|
|
15
|
+
readonly setRenderKey: (renderKey: keyof UseSocketStateType<DataType>) => void;
|
|
16
|
+
}];
|
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import { CommandInstance } from "@hyper-fetch/core";
|
|
2
1
|
import { UseTrackedStateProps, UseTrackedStateReturn } from "./use-tracked-state.types";
|
|
3
2
|
/**
|
|
4
3
|
*
|
|
@@ -8,4 +7,4 @@ import { UseTrackedStateProps, UseTrackedStateReturn } from "./use-tracked-state
|
|
|
8
7
|
* @param dependencies
|
|
9
8
|
* @internal
|
|
10
9
|
*/
|
|
11
|
-
export declare const useTrackedState: <T extends
|
|
10
|
+
export declare const useTrackedState: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>({ command, dispatcher, initialData, deepCompare, dependencyTracking, defaultCacheEmitting, }: UseTrackedStateProps<T>) => UseTrackedStateReturn<T>;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Dispatcher, ExtractError, CacheValueType, ExtractResponse, ClientResponseType, CommandInstance, LoggerType } from "@hyper-fetch/core";
|
|
2
|
-
import { isEqual } from "
|
|
3
|
-
export
|
|
2
|
+
import { isEqual } from "utils";
|
|
3
|
+
export type UseTrackedStateProps<T extends CommandInstance> = {
|
|
4
4
|
command: T;
|
|
5
5
|
logger: LoggerType;
|
|
6
6
|
initialData: ClientResponseType<ExtractResponse<T>, ExtractError<T>> | null;
|
|
@@ -9,7 +9,7 @@ export declare type UseTrackedStateProps<T extends CommandInstance> = {
|
|
|
9
9
|
defaultCacheEmitting?: boolean;
|
|
10
10
|
deepCompare: boolean | typeof isEqual;
|
|
11
11
|
};
|
|
12
|
-
export
|
|
12
|
+
export type UseTrackedStateReturn<T extends CommandInstance> = [
|
|
13
13
|
UseTrackedStateType<T>,
|
|
14
14
|
UseTrackedStateActions<T>,
|
|
15
15
|
{
|
|
@@ -18,7 +18,7 @@ export declare type UseTrackedStateReturn<T extends CommandInstance> = [
|
|
|
18
18
|
getStaleStatus: () => boolean;
|
|
19
19
|
}
|
|
20
20
|
];
|
|
21
|
-
export
|
|
21
|
+
export type UseTrackedStateType<T extends CommandInstance = CommandInstance> = {
|
|
22
22
|
/**
|
|
23
23
|
* Request response data
|
|
24
24
|
*/
|
|
@@ -44,7 +44,7 @@ export declare type UseTrackedStateType<T extends CommandInstance = CommandInsta
|
|
|
44
44
|
*/
|
|
45
45
|
timestamp: null | Date;
|
|
46
46
|
};
|
|
47
|
-
export
|
|
47
|
+
export type UseTrackedStateActions<T extends CommandInstance> = {
|
|
48
48
|
/**
|
|
49
49
|
* Action to set custom data. We can do it locally(inside hook state) or in cache(all related sources) with 'emitToCache' option.
|
|
50
50
|
*/
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { CacheValueType, NullableType, CommandInstance, ClientResponseType, ExtractResponse, ExtractError,
|
|
2
|
-
import { UseTrackedStateType } from "
|
|
3
|
-
export declare const getDetailsState: (state?: UseTrackedStateType<CommandInstance>, details?:
|
|
1
|
+
import { CacheValueType, NullableType, CommandInstance, ClientResponseType, ExtractResponse, ExtractError, Dispatcher } from "@hyper-fetch/core";
|
|
2
|
+
import { UseTrackedStateType } from "helpers";
|
|
3
|
+
export declare const getDetailsState: (state?: UseTrackedStateType<CommandInstance>, details?: CommandResponseDetails) => CommandResponseDetails;
|
|
4
4
|
export declare const isStaleCacheData: (cacheTime: number, cacheTimestamp: NullableType<Date | number>) => boolean;
|
|
5
|
-
export declare const getValidCacheData: <T extends
|
|
5
|
+
export declare const getValidCacheData: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>(command: T, initialData: ClientResponseType<ExtractResponse<T_1>, ExtractError<T_1>>, cacheData: CacheValueType<ExtractResponse<T>, ExtractError<T>>) => CacheValueType<ExtractResponse<T>, ExtractError<T>>;
|
|
6
6
|
export declare const getTimestamp: (timestamp?: NullableType<number | Date>) => Date;
|
|
7
|
-
export declare const getInitialState: <T extends
|
|
7
|
+
export declare const getInitialState: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>(initialData: ClientResponseType<ExtractResponse<T>, ExtractError<T>>, dispatcher: Dispatcher, command: T) => UseTrackedStateType<T>;
|
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
export declare const useAppManager: <B extends BuilderInstance>(builder: B) => UseAppManagerReturnType;
|
|
1
|
+
import { UseAppManagerReturnType } from "hooks/use-app-manager";
|
|
2
|
+
export declare const useAppManager: <B extends Builder<any, any>>(builder: B) => UseAppManagerReturnType;
|
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
export declare const useCache: <T extends CommandInstance>(command: T, options?: UseCacheOptionsType<T>) => UseCacheReturnType<T>;
|
|
1
|
+
import { UseCacheOptionsType, UseCacheReturnType } from "hooks/use-cache";
|
|
2
|
+
export declare const useCache: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>(command: T, options?: UseCacheOptionsType<T>) => UseCacheReturnType<T>;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { CommandInstance, ExtractResponse, ExtractError, CacheValueType } from "@hyper-fetch/core";
|
|
2
|
-
import { isEqual } from "
|
|
3
|
-
import { OnErrorCallbackType, OnFinishedCallbackType, OnSuccessCallbackType, UseTrackedStateActions, UseTrackedStateType } from "
|
|
4
|
-
export
|
|
2
|
+
import { isEqual } from "utils";
|
|
3
|
+
import { OnErrorCallbackType, OnFinishedCallbackType, OnSuccessCallbackType, UseTrackedStateActions, UseTrackedStateType } from "helpers";
|
|
4
|
+
export type UseCacheOptionsType<T extends CommandInstance> = {
|
|
5
5
|
/**
|
|
6
6
|
* If `true` it will rerender only when values used by our component gets changed. Otherwise it will rerender on any change.
|
|
7
7
|
*/
|
|
@@ -15,7 +15,7 @@ export declare type UseCacheOptionsType<T extends CommandInstance> = {
|
|
|
15
15
|
*/
|
|
16
16
|
deepCompare?: boolean | typeof isEqual;
|
|
17
17
|
};
|
|
18
|
-
export
|
|
18
|
+
export type UseCacheReturnType<T extends CommandInstance> = UseTrackedStateType<T> & UseTrackedStateActions<T> & {
|
|
19
19
|
/**
|
|
20
20
|
* Helper hook listener for success response
|
|
21
21
|
*/
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { UseEmitterOptionsType } from "hooks/use-emitter";
|
|
2
|
+
export declare const useEmitter: <EmitterType extends Emitter<any, any, any>>(emitter: EmitterType, { dependencyTracking }: UseEmitterOptionsType) => {
|
|
3
|
+
emit: any;
|
|
4
|
+
reconnect: any;
|
|
5
|
+
onEmit: (callback: (emitter: EmitterType) => void) => void;
|
|
6
|
+
onOpen: (callback: VoidFunction) => void;
|
|
7
|
+
onClose: (callback: VoidFunction) => void;
|
|
8
|
+
onError: <ErrorType = Event>(callback: (event: ErrorType) => void) => void;
|
|
9
|
+
onConnecting: (callback: VoidFunction) => void;
|
|
10
|
+
onReconnecting: (callback: (attempts: number) => void) => void;
|
|
11
|
+
onReconnectingStop: (callback: (attempts: number) => void) => void;
|
|
12
|
+
setData: (data: unknown) => void;
|
|
13
|
+
setConnected: (connected: boolean) => void;
|
|
14
|
+
setConnecting: (connecting: boolean) => void;
|
|
15
|
+
setTimestamp: (timestamp: number) => void;
|
|
16
|
+
connected: boolean;
|
|
17
|
+
connecting: boolean;
|
|
18
|
+
timestamp: number;
|
|
19
|
+
};
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { UseEventMessagesOptionsType } from "hooks/use-event-messages";
|
|
2
|
+
/**
|
|
3
|
+
* Allow to listen to all event messages received with sockets
|
|
4
|
+
* @param socket
|
|
5
|
+
* @param options
|
|
6
|
+
* @returns
|
|
7
|
+
*/
|
|
8
|
+
export declare const useEventMessages: <ResponsesType>(socket: Socket<any>, { dependencyTracking, filter }: UseEventMessagesOptionsType<ResponsesType>) => {
|
|
9
|
+
onEvent: (callback: (data: ResponsesType, event: MessageEvent<ResponsesType>) => void) => void;
|
|
10
|
+
onOpen: (callback: VoidFunction) => void;
|
|
11
|
+
onClose: (callback: VoidFunction) => void;
|
|
12
|
+
onError: <ErrorType = Event>(callback: (event: ErrorType) => void) => void;
|
|
13
|
+
onConnecting: (callback: VoidFunction) => void;
|
|
14
|
+
onReconnecting: (callback: (attempts: number) => void) => void;
|
|
15
|
+
onReconnectingStop: (callback: (attempts: number) => void) => void;
|
|
16
|
+
setData: (data: unknown) => void;
|
|
17
|
+
setConnected: (connected: boolean) => void;
|
|
18
|
+
setConnecting: (connecting: boolean) => void;
|
|
19
|
+
setTimestamp: (timestamp: number) => void;
|
|
20
|
+
data: unknown;
|
|
21
|
+
connected: boolean;
|
|
22
|
+
connecting: boolean;
|
|
23
|
+
timestamp: number;
|
|
24
|
+
};
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { CommandInstance, RequiredKeys } from "@hyper-fetch/core";
|
|
2
|
-
import { UseFetchOptionsType } from "
|
|
3
|
-
|
|
2
|
+
import { UseFetchOptionsType } from "hooks/use-fetch";
|
|
3
|
+
type DefaultOptionsType = RequiredKeys<Omit<UseFetchOptionsType<CommandInstance>, "initialData">> & {
|
|
4
4
|
initialData: null;
|
|
5
5
|
};
|
|
6
6
|
export declare const useFetchDefaultOptions: DefaultOptionsType;
|
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { UseFetchOptionsType, UseFetchReturnType } from "./";
|
|
1
|
+
import { UseFetchOptionsType, UseFetchReturnType } from "hooks/use-fetch";
|
|
3
2
|
/**
|
|
4
3
|
* This hooks aims to retrieve data from server.
|
|
5
4
|
* @param command Command instance
|
|
6
5
|
* @param options Hook options
|
|
7
6
|
* @returns
|
|
8
7
|
*/
|
|
9
|
-
export declare const useFetch: <T extends
|
|
8
|
+
export declare const useFetch: <T extends Command<any, any, any, any, any, any, any, any, any, any, any>>(command: T, options?: UseFetchOptionsType<T>) => UseFetchReturnType<T>;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { CommandInstance, ExtractResponse, ExtractError, CacheValueType } from "@hyper-fetch/core";
|
|
2
|
-
import { UseCommandEventsActionsType, UseTrackedStateActions, UseTrackedStateType } from "
|
|
3
|
-
import { InvalidationKeyType } from "
|
|
4
|
-
import { isEqual } from "
|
|
5
|
-
export
|
|
2
|
+
import { UseCommandEventsActionsType, UseTrackedStateActions, UseTrackedStateType } from "helpers";
|
|
3
|
+
import { InvalidationKeyType } from "types";
|
|
4
|
+
import { isEqual } from "utils";
|
|
5
|
+
export type UseFetchOptionsType<T extends CommandInstance> = {
|
|
6
6
|
/**
|
|
7
7
|
* Refetch dependencies
|
|
8
8
|
*/
|
|
@@ -64,7 +64,7 @@ export declare type UseFetchOptionsType<T extends CommandInstance> = {
|
|
|
64
64
|
*/
|
|
65
65
|
deepCompare?: boolean | typeof isEqual;
|
|
66
66
|
};
|
|
67
|
-
export
|
|
67
|
+
export type UseFetchReturnType<T extends CommandInstance> = UseTrackedStateType<T> & UseTrackedStateActions<T> & UseCommandEventsActionsType<T> & {
|
|
68
68
|
/**
|
|
69
69
|
* Data related to current state of the bounce usage
|
|
70
70
|
*/
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { ExtractListenerDataType } from "@hyper-fetch/sockets";
|
|
2
|
+
import { UseListenerOptionsType } from "hooks/use-listener";
|
|
3
|
+
export declare const useListener: <ListenerType extends Listener<any, any>>(listener: ListenerType, { dependencyTracking }: UseListenerOptionsType) => {
|
|
4
|
+
listen: () => void;
|
|
5
|
+
onEvent: (callback: (data: ExtractListenerDataType<ListenerType>, event: MessageEvent<ExtractListenerDataType<ListenerType>>) => void) => void;
|
|
6
|
+
onOpen: (callback: VoidFunction) => void;
|
|
7
|
+
onClose: (callback: VoidFunction) => void;
|
|
8
|
+
onError: <ErrorType = Event>(callback: (event: ErrorType) => void) => void;
|
|
9
|
+
onConnecting: (callback: VoidFunction) => void;
|
|
10
|
+
onReconnecting: (callback: (attempts: number) => void) => void;
|
|
11
|
+
onReconnectingStop: (callback: (attempts: number) => void) => void;
|
|
12
|
+
setData: (data: unknown) => void;
|
|
13
|
+
setConnected: (connected: boolean) => void;
|
|
14
|
+
setConnecting: (connecting: boolean) => void;
|
|
15
|
+
setTimestamp: (timestamp: number) => void;
|
|
16
|
+
data: unknown;
|
|
17
|
+
connected: boolean;
|
|
18
|
+
connecting: boolean;
|
|
19
|
+
timestamp: number;
|
|
20
|
+
};
|
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { UseQueueOptionsType, UseQueueReturnType } from "./";
|
|
1
|
+
import { UseQueueOptionsType, UseQueueReturnType } from "hooks/use-queue";
|
|
3
2
|
/**
|
|
4
3
|
* This hook allows to control dispatchers request queues
|
|
5
4
|
* @param command
|
|
6
5
|
* @param options
|
|
7
6
|
* @returns
|
|
8
7
|
*/
|
|
9
|
-
export declare const useQueue: <Command extends
|
|
8
|
+
export declare const useQueue: <Command extends Command<any, any, any, any, any, any, any, any, any, any, any>>(command: Command, options?: UseQueueOptionsType) => UseQueueReturnType<Command>;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { FetchProgressType, CommandInstance, DispatcherDumpValueType } from "@hyper-fetch/core";
|
|
2
|
-
export
|
|
2
|
+
export type UseQueueOptionsType = {
|
|
3
3
|
queueType?: "auto" | "fetch" | "submit";
|
|
4
4
|
};
|
|
5
|
-
export
|
|
5
|
+
export type QueueRequest<Command extends CommandInstance> = DispatcherDumpValueType<Command> & {
|
|
6
6
|
/**
|
|
7
7
|
* Uploading progress for given request
|
|
8
8
|
*/
|
|
@@ -24,7 +24,7 @@ export declare type QueueRequest<Command extends CommandInstance> = DispatcherDu
|
|
|
24
24
|
*/
|
|
25
25
|
deleteRequest: () => void;
|
|
26
26
|
};
|
|
27
|
-
export
|
|
27
|
+
export type UseQueueReturnType<T extends CommandInstance> = {
|
|
28
28
|
/**
|
|
29
29
|
* Queue status for provided command
|
|
30
30
|
*/
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { CommandInstance, RequiredKeys } from "@hyper-fetch/core";
|
|
2
2
|
import { UseSubmitOptionsType } from "./use-submit.types";
|
|
3
|
-
|
|
3
|
+
type DefaultOptionsType = RequiredKeys<Omit<UseSubmitOptionsType<CommandInstance>, "initialData">> & {
|
|
4
4
|
initialData: null;
|
|
5
5
|
};
|
|
6
6
|
export declare const useSubmitDefaultOptions: DefaultOptionsType;
|
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { UseSubmitOptionsType, UseSubmitReturnType } from "./";
|
|
1
|
+
import { UseSubmitOptionsType, UseSubmitReturnType } from "hooks/use-submit";
|
|
3
2
|
/**
|
|
4
3
|
* This hooks aims to mutate data on the server.
|
|
5
4
|
* @param command
|
|
6
5
|
* @param options
|
|
7
6
|
* @returns
|
|
8
7
|
*/
|
|
9
|
-
export declare const useSubmit: <
|
|
8
|
+
export declare const useSubmit: <CommandType extends Command<any, any, any, any, any, any, any, any, any, any, any>>(command: CommandType, options?: UseSubmitOptionsType<CommandType>) => UseSubmitReturnType<CommandType>;
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import { CacheValueType, ExtractError, ExtractResponse, CommandInstance,
|
|
2
|
-
import { isEqual } from "
|
|
3
|
-
import { OnErrorCallbackType, OnFinishedCallbackType, OnProgressCallbackType, OnStartCallbackType, OnSuccessCallbackType, UseTrackedStateType, UseTrackedStateActions } from "
|
|
4
|
-
import { InvalidationKeyType } from "
|
|
5
|
-
export
|
|
1
|
+
import { CacheValueType, ExtractError, ExtractResponse, CommandInstance, FetchMethodType } from "@hyper-fetch/core";
|
|
2
|
+
import { isEqual } from "utils";
|
|
3
|
+
import { OnErrorCallbackType, OnFinishedCallbackType, OnProgressCallbackType, OnStartCallbackType, OnSuccessCallbackType, UseTrackedStateType, UseTrackedStateActions } from "helpers";
|
|
4
|
+
import { InvalidationKeyType } from "types";
|
|
5
|
+
export type UseSubmitOptionsType<T extends CommandInstance> = {
|
|
6
6
|
/**
|
|
7
7
|
* Disable fetching
|
|
8
8
|
*/
|
|
@@ -32,7 +32,7 @@ export declare type UseSubmitOptionsType<T extends CommandInstance> = {
|
|
|
32
32
|
*/
|
|
33
33
|
deepCompare?: boolean | typeof isEqual;
|
|
34
34
|
};
|
|
35
|
-
export
|
|
35
|
+
export type UseSubmitReturnType<CommandType extends CommandInstance> = Omit<UseTrackedStateType<CommandType>, "loading"> & UseTrackedStateActions<CommandType> & {
|
|
36
36
|
/**
|
|
37
37
|
* Callback which allows to cancel ongoing requests from given queueKey.
|
|
38
38
|
*/
|
|
@@ -40,23 +40,23 @@ export declare type UseSubmitReturnType<T extends CommandInstance> = Omit<UseTra
|
|
|
40
40
|
/**
|
|
41
41
|
* Helper hook listening on success response.
|
|
42
42
|
*/
|
|
43
|
-
onSubmitSuccess: (callback: OnSuccessCallbackType<
|
|
43
|
+
onSubmitSuccess: (callback: OnSuccessCallbackType<CommandType>) => void;
|
|
44
44
|
/**
|
|
45
45
|
* Helper hook listening on error response.
|
|
46
46
|
*/
|
|
47
|
-
onSubmitError: (callback: OnErrorCallbackType<
|
|
47
|
+
onSubmitError: (callback: OnErrorCallbackType<CommandType>) => void;
|
|
48
48
|
/**
|
|
49
49
|
* Helper hook listening on any response.
|
|
50
50
|
*/
|
|
51
|
-
onSubmitFinished: (callback: OnFinishedCallbackType<
|
|
51
|
+
onSubmitFinished: (callback: OnFinishedCallbackType<CommandType>) => void;
|
|
52
52
|
/**
|
|
53
53
|
* Helper hook listening on request start.
|
|
54
54
|
*/
|
|
55
|
-
onSubmitRequestStart: (callback: OnStartCallbackType<
|
|
55
|
+
onSubmitRequestStart: (callback: OnStartCallbackType<CommandType>) => void;
|
|
56
56
|
/**
|
|
57
57
|
* Helper hook listening on response start(before we receive all data from server).
|
|
58
58
|
*/
|
|
59
|
-
onSubmitResponseStart: (callback: OnStartCallbackType<
|
|
59
|
+
onSubmitResponseStart: (callback: OnStartCallbackType<CommandType>) => void;
|
|
60
60
|
/**
|
|
61
61
|
* Helper hook listening on download progress ETA. We can later match given requests by their id's or command instance which holds all data which is being transferred.
|
|
62
62
|
*/
|
|
@@ -68,15 +68,15 @@ export declare type UseSubmitReturnType<T extends CommandInstance> = Omit<UseTra
|
|
|
68
68
|
/**
|
|
69
69
|
* Helper hook listening on aborting of requests. Abort events are not triggering onError callbacks.
|
|
70
70
|
*/
|
|
71
|
-
onSubmitAbort: (callback: OnErrorCallbackType<
|
|
71
|
+
onSubmitAbort: (callback: OnErrorCallbackType<CommandType>) => void;
|
|
72
72
|
/**
|
|
73
73
|
* Helper hook listening on request going into offline awaiting for network connection to be restored. It will not trigger onError when 'offline' mode is set on command.
|
|
74
74
|
*/
|
|
75
|
-
onSubmitOfflineError: (callback: OnErrorCallbackType<
|
|
75
|
+
onSubmitOfflineError: (callback: OnErrorCallbackType<CommandType>) => void;
|
|
76
76
|
/**
|
|
77
77
|
* Method responsible for triggering requests. It return Promise which will be resolved with the request.
|
|
78
78
|
*/
|
|
79
|
-
submit:
|
|
79
|
+
submit: FetchMethodType<CommandType>;
|
|
80
80
|
/**
|
|
81
81
|
* Request loading state
|
|
82
82
|
*/
|