@shihengtech/utils 0.0.7 → 0.0.8
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/dist/sh-utils.js +46 -2
- package/dist/sh-utils.js.map +1 -1
- package/es/index.js +132 -26
- package/es/index.js.map +1 -1
- package/lib/index.d.ts +68 -6
- package/lib/index.js +134 -25
- package/lib/index.js.map +1 -1
- package/package.json +7 -7
package/lib/index.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
+
var react = require('react');
|
|
3
4
|
var localforage = require('localforage');
|
|
4
5
|
var ramda = require('ramda');
|
|
5
6
|
|
|
@@ -8,6 +9,8 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
|
|
|
8
9
|
var localforage__default = /*#__PURE__*/_interopDefault(localforage);
|
|
9
10
|
|
|
10
11
|
var __defProp = Object.defineProperty;
|
|
12
|
+
var __defProps = Object.defineProperties;
|
|
13
|
+
var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
|
|
11
14
|
var __getOwnPropSymbols = Object.getOwnPropertySymbols;
|
|
12
15
|
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
13
16
|
var __propIsEnum = Object.prototype.propertyIsEnumerable;
|
|
@@ -23,6 +26,19 @@ var __spreadValues = (a, b) => {
|
|
|
23
26
|
}
|
|
24
27
|
return a;
|
|
25
28
|
};
|
|
29
|
+
var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
|
|
30
|
+
var __objRest = (source, exclude) => {
|
|
31
|
+
var target = {};
|
|
32
|
+
for (var prop in source)
|
|
33
|
+
if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
|
|
34
|
+
target[prop] = source[prop];
|
|
35
|
+
if (source != null && __getOwnPropSymbols)
|
|
36
|
+
for (var prop of __getOwnPropSymbols(source)) {
|
|
37
|
+
if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
|
|
38
|
+
target[prop] = source[prop];
|
|
39
|
+
}
|
|
40
|
+
return target;
|
|
41
|
+
};
|
|
26
42
|
var __async = (__this, __arguments, generator) => {
|
|
27
43
|
return new Promise((resolve, reject) => {
|
|
28
44
|
var fulfilled = (value) => {
|
|
@@ -67,6 +83,18 @@ var ReplaySubject = class {
|
|
|
67
83
|
}
|
|
68
84
|
}
|
|
69
85
|
};
|
|
86
|
+
function useLaziedRef(value) {
|
|
87
|
+
const ref = react.useRef();
|
|
88
|
+
if (ref.current == null) {
|
|
89
|
+
ref.current = value();
|
|
90
|
+
}
|
|
91
|
+
return ref;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// src/hooks/useLaziedConst/index.ts
|
|
95
|
+
function useLaziedConst(value) {
|
|
96
|
+
return useLaziedRef(value).current;
|
|
97
|
+
}
|
|
70
98
|
|
|
71
99
|
// src/utils/fnRunner/index.ts
|
|
72
100
|
function fnRunner(fn, retryTimes = 0) {
|
|
@@ -109,43 +137,46 @@ function createQueryWithCache(key, fn, options) {
|
|
|
109
137
|
} = __spreadValues({
|
|
110
138
|
deps: [],
|
|
111
139
|
retry: 0,
|
|
112
|
-
equals:
|
|
140
|
+
equals: ramda.equals,
|
|
113
141
|
compareBeforeUpdate: ramda.equals,
|
|
114
142
|
remoteMemoryCache: false
|
|
115
143
|
}, options);
|
|
144
|
+
let fnRunCount = 0;
|
|
145
|
+
let currentDeps = [];
|
|
116
146
|
const cacheUpdateSubject = new ReplaySubject(1);
|
|
117
147
|
const resolveDeps = () => typeof deps === "function" ? deps() : deps;
|
|
118
|
-
const queryFnEnhancer = (fn2, options2) => ((args) => {
|
|
119
|
-
const promiseResult = fn2(args);
|
|
148
|
+
const queryFnEnhancer = (fn2, options2) => ((args, rest) => {
|
|
149
|
+
const promiseResult = fn2(args, rest);
|
|
120
150
|
promiseResult.then((result) => {
|
|
121
151
|
var _a;
|
|
122
152
|
const res = { type: options2.type, result };
|
|
123
|
-
(_a = options2.onSuccess) == null ? void 0 : _a.call(options2, res);
|
|
153
|
+
rest.runCount === fnRunCount && ((_a = options2.onSuccess) == null ? void 0 : _a.call(options2, res));
|
|
124
154
|
return res;
|
|
125
|
-
},
|
|
155
|
+
}, (error) => {
|
|
156
|
+
var _a;
|
|
157
|
+
rest.runCount === fnRunCount && ((_a = options2.onError) == null ? void 0 : _a.call(options2, error));
|
|
158
|
+
}).catch(() => {
|
|
126
159
|
});
|
|
127
160
|
return promiseResult;
|
|
128
161
|
});
|
|
129
|
-
const getLocalCache = (
|
|
162
|
+
const getLocalCache = (_0, _1) => __async(null, [_0, _1], function* (_args, { deps: deps2 }) {
|
|
130
163
|
const cache = yield db.getItem(key);
|
|
131
|
-
if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals(cache.deps,
|
|
164
|
+
if (cache && (!version || cache.version === version) && (!cache.expires || cache.expires > Date.now()) && equals(cache.deps, deps2)) {
|
|
132
165
|
return cache.result;
|
|
133
166
|
}
|
|
134
167
|
throw new Error("Cache not found");
|
|
135
168
|
});
|
|
136
169
|
const remoteResultCache = {
|
|
137
170
|
success: false,
|
|
138
|
-
args: [],
|
|
139
171
|
deps: [],
|
|
140
172
|
result: null
|
|
141
173
|
};
|
|
142
174
|
const clearMemoryCache = () => {
|
|
143
175
|
remoteResultCache.success = false;
|
|
144
176
|
remoteResultCache.result = null;
|
|
145
|
-
remoteResultCache.args = [];
|
|
146
177
|
remoteResultCache.deps = [];
|
|
147
178
|
};
|
|
148
|
-
const queryWithMemoryCache = (args) => {
|
|
179
|
+
const queryWithMemoryCache = (args, deps2) => {
|
|
149
180
|
if (!remoteMemoryCache) {
|
|
150
181
|
return {
|
|
151
182
|
type: "remote",
|
|
@@ -155,15 +186,13 @@ function createQueryWithCache(key, fn, options) {
|
|
|
155
186
|
)
|
|
156
187
|
};
|
|
157
188
|
}
|
|
158
|
-
|
|
159
|
-
if (remoteResultCache.success && equals(remoteResultCache.args, args) && equals(remoteResultCache.deps, currentDeps)) {
|
|
189
|
+
if (remoteResultCache.success && equals(remoteResultCache.deps, deps2)) {
|
|
160
190
|
return {
|
|
161
191
|
type: "memory",
|
|
162
192
|
promiseResult: remoteResultCache.result
|
|
163
193
|
};
|
|
164
194
|
}
|
|
165
|
-
remoteResultCache.
|
|
166
|
-
remoteResultCache.deps = currentDeps;
|
|
195
|
+
remoteResultCache.deps = deps2;
|
|
167
196
|
remoteResultCache.success = true;
|
|
168
197
|
const result = remoteResultCache.result = fnRunner(
|
|
169
198
|
() => fn(...args),
|
|
@@ -172,18 +201,19 @@ function createQueryWithCache(key, fn, options) {
|
|
|
172
201
|
Promise.resolve(result).catch(clearMemoryCache);
|
|
173
202
|
return { type: "remote", promiseResult: result };
|
|
174
203
|
};
|
|
175
|
-
const
|
|
204
|
+
const queryRemote = (args, queryOption) => __async(null, null, function* () {
|
|
176
205
|
const rs = {
|
|
177
206
|
type: "remote",
|
|
178
207
|
result: null
|
|
179
208
|
};
|
|
209
|
+
const { runCount, deps: deps2 } = queryOption;
|
|
180
210
|
try {
|
|
181
|
-
const { type, promiseResult } = queryWithMemoryCache(args);
|
|
211
|
+
const { type, promiseResult } = queryWithMemoryCache(args, deps2);
|
|
182
212
|
const result = rs.result = yield promiseResult;
|
|
183
|
-
type === "remote" && (!cacheEnabled || (yield cacheEnabled(
|
|
184
|
-
const oldCache = yield getLocalCache(args).catch(() => null);
|
|
213
|
+
runCount === fnRunCount && type === "remote" && (!cacheEnabled || (yield cacheEnabled(deps2))) && Promise.resolve().then(() => __async(null, null, function* () {
|
|
214
|
+
const oldCache = yield getLocalCache(args, queryOption).catch(() => null);
|
|
185
215
|
const cacheData = __spreadValues(__spreadValues({
|
|
186
|
-
deps:
|
|
216
|
+
deps: deps2,
|
|
187
217
|
result
|
|
188
218
|
}, version && { version }), maxAge && { expires: Date.now() + maxAge });
|
|
189
219
|
db.setItem(key, cacheData);
|
|
@@ -204,20 +234,33 @@ function createQueryWithCache(key, fn, options) {
|
|
|
204
234
|
}
|
|
205
235
|
}
|
|
206
236
|
return rs.result;
|
|
207
|
-
})
|
|
237
|
+
});
|
|
208
238
|
const _fn = (...args) => __async(null, null, function* () {
|
|
209
239
|
yield beforeRequest == null ? void 0 : beforeRequest();
|
|
240
|
+
const runCount = ++fnRunCount;
|
|
241
|
+
currentDeps = args.concat(resolveDeps());
|
|
242
|
+
const queryOption = { runCount, deps: currentDeps };
|
|
243
|
+
const isCacheDisabled = cacheEnabled && !(yield cacheEnabled(currentDeps));
|
|
210
244
|
const [cacheResult, remoteResult] = [
|
|
211
|
-
queryFnEnhancer(getLocalCache, { type: "local", onSuccess })(args),
|
|
212
|
-
|
|
245
|
+
isCacheDisabled ? null : queryFnEnhancer(getLocalCache, { type: "local", onSuccess })(args, queryOption),
|
|
246
|
+
queryFnEnhancer(queryRemote, { type: "remote", onSuccess, onError })(args, queryOption)
|
|
213
247
|
];
|
|
214
|
-
const result = yield Promise.race([
|
|
248
|
+
const result = cacheResult ? yield Promise.race([
|
|
215
249
|
cacheResult.catch(() => remoteResult),
|
|
216
250
|
remoteResult
|
|
217
|
-
]);
|
|
251
|
+
]) : remoteResult;
|
|
218
252
|
return result;
|
|
219
253
|
});
|
|
220
|
-
_fn.refresh = (...args) =>
|
|
254
|
+
_fn.refresh = (...args) => __async(null, null, function* () {
|
|
255
|
+
yield beforeRequest == null ? void 0 : beforeRequest();
|
|
256
|
+
const runCount = ++fnRunCount;
|
|
257
|
+
currentDeps = args.concat(resolveDeps());
|
|
258
|
+
const queryOption = { runCount, deps: currentDeps };
|
|
259
|
+
return queryFnEnhancer(
|
|
260
|
+
queryRemote,
|
|
261
|
+
{ type: "remote", onSuccess, onError }
|
|
262
|
+
)(args, queryOption);
|
|
263
|
+
});
|
|
221
264
|
_fn.getCache = () => db.getItem(key);
|
|
222
265
|
_fn.updateCache = (value) => __async(null, null, function* () {
|
|
223
266
|
if (typeof value === "function") {
|
|
@@ -246,8 +289,74 @@ createQueryWithCache.useDb = (newDb) => {
|
|
|
246
289
|
}
|
|
247
290
|
};
|
|
248
291
|
|
|
292
|
+
// src/hooks/useQueryWithCache/index.ts
|
|
293
|
+
function useQueryWithCache(key, fn, deps = [], options) {
|
|
294
|
+
const _a = options || {}, {
|
|
295
|
+
enabled = true,
|
|
296
|
+
initialData,
|
|
297
|
+
onSuccess,
|
|
298
|
+
onError,
|
|
299
|
+
onFinished,
|
|
300
|
+
useCustomEffect = react.useEffect
|
|
301
|
+
} = _a, restOptions = __objRest(_a, [
|
|
302
|
+
"enabled",
|
|
303
|
+
"initialData",
|
|
304
|
+
"onSuccess",
|
|
305
|
+
"onError",
|
|
306
|
+
"onFinished",
|
|
307
|
+
"useCustomEffect"
|
|
308
|
+
]);
|
|
309
|
+
const [loading, setLoading] = react.useState(false);
|
|
310
|
+
const [state, setState] = react.useState(() => ({
|
|
311
|
+
type: "local",
|
|
312
|
+
data: typeof initialData === "function" ? initialData() : initialData,
|
|
313
|
+
error: null
|
|
314
|
+
}));
|
|
315
|
+
const infoRef = react.useRef({ deps, fn, onSuccess, onError, onFinished });
|
|
316
|
+
infoRef.current.deps = deps;
|
|
317
|
+
infoRef.current.fn = fn;
|
|
318
|
+
infoRef.current.onSuccess = onSuccess;
|
|
319
|
+
infoRef.current.onError = onError;
|
|
320
|
+
infoRef.current.onFinished = onFinished;
|
|
321
|
+
const cachedFn = useLaziedConst(() => createQueryWithCache(key, () => infoRef.current.fn(), __spreadProps(__spreadValues({}, restOptions), {
|
|
322
|
+
deps: () => infoRef.current.deps,
|
|
323
|
+
beforeRequest: () => {
|
|
324
|
+
setLoading(true);
|
|
325
|
+
},
|
|
326
|
+
onSuccess: (result) => {
|
|
327
|
+
var _a2, _b, _c, _d;
|
|
328
|
+
setLoading(false);
|
|
329
|
+
setState({ type: result.type, data: result.result, error: null });
|
|
330
|
+
(_b = (_a2 = infoRef.current).onSuccess) == null ? void 0 : _b.call(_a2, result.result);
|
|
331
|
+
(_d = (_c = infoRef.current).onFinished) == null ? void 0 : _d.call(_c, { success: true, data: result.result });
|
|
332
|
+
},
|
|
333
|
+
onError: (error) => {
|
|
334
|
+
var _a2, _b, _c, _d;
|
|
335
|
+
setLoading(false);
|
|
336
|
+
setState((s) => __spreadProps(__spreadValues({}, s), { error }));
|
|
337
|
+
(_b = (_a2 = infoRef.current).onError) == null ? void 0 : _b.call(_a2, error);
|
|
338
|
+
(_d = (_c = infoRef.current).onFinished) == null ? void 0 : _d.call(_c, { success: false, error });
|
|
339
|
+
}
|
|
340
|
+
})));
|
|
341
|
+
useCustomEffect(() => {
|
|
342
|
+
if (!enabled)
|
|
343
|
+
return;
|
|
344
|
+
cachedFn();
|
|
345
|
+
}, [enabled, ...deps]);
|
|
346
|
+
return __spreadProps(__spreadValues({}, state), {
|
|
347
|
+
loading,
|
|
348
|
+
setState,
|
|
349
|
+
run: cachedFn,
|
|
350
|
+
refresh: cachedFn.refresh,
|
|
351
|
+
clearCache: cachedFn.clearCache
|
|
352
|
+
});
|
|
353
|
+
}
|
|
354
|
+
|
|
249
355
|
exports.ReplaySubject = ReplaySubject;
|
|
250
356
|
exports.createQueryWithCache = createQueryWithCache;
|
|
251
357
|
exports.fnRunner = fnRunner;
|
|
358
|
+
exports.useLaziedConst = useLaziedConst;
|
|
359
|
+
exports.useLaziedRef = useLaziedRef;
|
|
360
|
+
exports.useQueryWithCache = useQueryWithCache;
|
|
252
361
|
//# sourceMappingURL=index.js.map
|
|
253
362
|
//# sourceMappingURL=index.js.map
|
package/lib/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts"],"names":["localforage","deepEquals","fn","options"],"mappings":"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","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n private maxBufferSize: number\n private buffer: T[] = []\n\n private subscriptions: ((data: T) => void)[] = []\n\n constructor(maxBufferSize = 1) {\n this.maxBufferSize = maxBufferSize\n }\n\n subscribe(fn: (data: T) => void) {\n this.subscriptions.push(fn)\n this.buffer.forEach(data => fn(data))\n return () => this.unsubscribe(fn)\n }\n\n unsubscribe(fn: (data: T) => void) {\n this.subscriptions = this.subscriptions.filter(f => f !== fn)\n }\n\n next(data: T) {\n this.subscriptions.forEach(fn => fn(data))\n this.buffer.push(data)\n if (this.buffer.length > this.maxBufferSize) {\n this.buffer = this.buffer.slice(1)\n }\n }\n}\n\nexport { ReplaySubject }\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(fn: T, retryTimes: number = 0): Promise<Awaited<ReturnType<T>>> {\n const times = (retryTimes || 0) + 1\n for (let i = 0; i < times; i++) {\n try {\n return await fn()\n }\n catch (error) {\n // Only throw if this was the last attempt\n if (i === times - 1) {\n throw error\n }\n }\n }\n // This line should never be reached, but it's required for type safety.\n throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n LocalForage,\n 'getItem' | 'setItem' | 'removeItem' | 'clear'\n // 这些可以暂时不考虑\n // | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n name: DB_NAME,\n storeName: 'main-store',\n // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n /** 缓存参数 */\n deps: any[]\n /** 缓存版本,用于缓存数据结构变更 */\n version?: string\n /** 缓存过期时间,为空表示永不过期 */\n expires?: number\n /** 缓存结果 */\n result: Awaited<ReturnType<T>>\n}\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n /** 缓存过期时间,为空表示永不过期 */\n maxAge?: number\n /** 缓存版本,用于缓存数据结构变更 */\n version?: string\n /** 依赖项,用于缓存依赖项变更。支持函数形式,函数会在运行时调用取值 */\n deps?: readonly unknown[] | (() => readonly unknown[])\n /**\n * 重试次数,为0表示不重试\n * @default 0\n */\n retry?: number\n /**\n * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n * 为 true 时,只有当新旧缓存不一致时才触发 onCacheUpdate\n * 为 false 时,总是触发 onCacheUpdate\n * @default R.equals\n */\n compareBeforeUpdate?:\n | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n | false\n /**\n * 是否启用远程内存缓存\n * 为 true 时,启用远程内存缓存\n * 为 false 时,不启用远程内存缓存\n * @default false\n */\n remoteMemoryCache?: boolean\n /**\n * 比较依赖项(函数参数及 deps)是否相等\n * @default (a, b) => a.length === b.length && a.every((item, index) => item === b[index])\n */\n equals?: (prev: readonly unknown[], next: readonly unknown[]) => boolean\n /**\n * 根据入参决定是否添加缓存\n * 不传的话默认启用缓存\n */\n cacheEnabled?: (args: Parameters<T>) => Promise<boolean>\n /** 请求前回调 */\n beforeRequest?: () => Promise<void> | void\n /** 请求成功回调 */\n onSuccess?: (result: {\n type: 'local' | 'remote'\n result: Awaited<ReturnType<T>>\n }) => void\n /** 请求错误回调 */\n onError?: (error: any) => void\n /** 远程请求错误处理 */\n errorHandler?: (error: any) => any\n // /** 缓存更新回调 */\n // onCacheUpdate?: (\n // result: Awaited<ReturnType<T>>,\n // cacheData: CacheItem<T>,\n // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n result: Awaited<ReturnType<T>>\n cacheData: CacheItem<T>\n isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(key: string, fn: T, options?: CacheOptions<T>) {\n const {\n deps,\n retry,\n maxAge,\n version,\n compareBeforeUpdate,\n remoteMemoryCache,\n equals,\n cacheEnabled,\n beforeRequest,\n onSuccess,\n onError,\n errorHandler,\n } = {\n deps: [],\n retry: 0,\n equals: (a, b) =>\n a.length === b.length && a.every((item, index) => item === b[index]),\n compareBeforeUpdate: deepEquals,\n remoteMemoryCache: false,\n ...options,\n } satisfies CacheOptions<T>\n\n const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n /** 解析 deps,如果元素是函数则调用获取值 */\n const resolveDeps = () => (typeof deps === 'function' ? deps() : deps)\n\n const queryFnEnhancer = (fn: (args: Parameters<T>) => Promise<ReturnType<T>>, options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' }) => (((args) => {\n const promiseResult = fn(args)\n\n promiseResult\n .then((result) => {\n const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n options.onSuccess?.(res)\n return res\n }, options.onError)\n .catch(() => {})\n\n return promiseResult\n }) as typeof fn)\n\n const getLocalCache = async (args: Parameters<T>) => {\n const cache = await db.getItem<CacheItem<T>>(key)\n if (\n cache\n && (!version || cache.version === version)\n && (!cache.expires || cache.expires > Date.now())\n && equals(cache.deps, args.concat(resolveDeps()))\n ) {\n return cache.result\n }\n\n throw new Error('Cache not found')\n }\n\n const remoteResultCache: {\n success: boolean\n args: Parameters<T>\n deps: readonly unknown[]\n result: ReturnType<T> | null\n } = {\n success: false,\n args: [] as any,\n deps: [],\n result: null,\n }\n\n const clearMemoryCache = () => {\n remoteResultCache.success = false\n remoteResultCache.result = null\n remoteResultCache.args = [] as any\n remoteResultCache.deps = []\n }\n\n const queryWithMemoryCache = (args: Parameters<T>) => {\n if (!remoteMemoryCache) {\n return {\n type: 'remote' as const,\n promiseResult: fnRunner(\n () => fn(...args),\n retry,\n ),\n }\n }\n\n const currentDeps = resolveDeps()\n if (\n remoteResultCache.success\n && equals(remoteResultCache.args, args)\n && equals(remoteResultCache.deps, currentDeps)\n ) {\n return {\n type: 'memory' as const,\n promiseResult: remoteResultCache.result!,\n }\n }\n\n remoteResultCache.args = args\n remoteResultCache.deps = currentDeps\n remoteResultCache.success = true\n const result = (remoteResultCache.result = fnRunner(\n () => fn(...args),\n retry,\n ) as ReturnType<T>)\n\n Promise.resolve(result)\n .catch(clearMemoryCache)\n\n return { type: 'remote' as const, promiseResult: result }\n }\n\n const queryRemoteWithEnhancer = queryFnEnhancer(async (args: Parameters<T>) => {\n const rs = {\n type: 'remote' as const,\n result: null as unknown as Awaited<ReturnType<T>>,\n }\n\n try {\n const { type, promiseResult } = queryWithMemoryCache(args)\n const result = (rs.result = await promiseResult)\n\n // 设置缓存\n type === 'remote'\n && (!cacheEnabled || (await cacheEnabled(args)))\n && Promise.resolve().then(async () => {\n const oldCache = await getLocalCache(args).catch(() => null)\n\n const cacheData: CacheItem<T> = {\n deps: args.concat(resolveDeps()),\n result,\n ...(version && { version }),\n ...(maxAge && { expires: Date.now() + maxAge }),\n }\n db.setItem(key, cacheData)\n\n // 如果配置了比较,且旧缓存存在且与新结果相等,则不触发 onCacheUpdate\n if (\n compareBeforeUpdate\n && oldCache\n && compareBeforeUpdate(oldCache, result)\n ) {\n return\n }\n cacheUpdateSubject.next({\n result,\n cacheData,\n isCacheHit: !!oldCache,\n })\n })\n }\n catch (error) {\n if (errorHandler) {\n rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n }\n else {\n throw error\n }\n }\n\n return rs.result\n }, { type: 'remote' as const, onSuccess, onError })\n\n const _fn = async (...args: Parameters<T>) => {\n await beforeRequest?.()\n\n const [cacheResult, remoteResult] = [\n queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args),\n queryRemoteWithEnhancer(args),\n ]\n const result = await Promise.race([\n cacheResult.catch(() => remoteResult),\n remoteResult,\n ])\n\n return result\n }\n\n _fn.refresh = (...args: Parameters<T>) => queryRemoteWithEnhancer(args)\n\n _fn.getCache = () => db.getItem<CacheItem<T>>(key)\n\n _fn.updateCache = async (value: (CacheItem<T> | ((prev: CacheItem<T> | null) => CacheItem<T>))) => {\n if (typeof value === 'function') {\n const prevCache = await _fn.getCache().catch(() => null)\n const newCache = value(prevCache)\n await db.setItem(key, newCache)\n }\n else {\n await db.setItem(key, value)\n }\n }\n\n _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n cacheUpdateSubject.subscribe(fn)\n\n _fn.clearCache = async () => {\n clearMemoryCache()\n await db.removeItem(key)\n }\n\n return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName,如果为字符串,则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(newDb: DBType | (T extends 'main-store' ? never : T)) => {\n if (typeof newDb === 'string') {\n db = localforage.createInstance({\n name: DB_NAME,\n storeName: newDb,\n })\n }\n else {\n db = newDb\n }\n}\n\nexport { createQueryWithCache }\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/class/ReplaySubject/index.ts","../src/hooks/useLaziedRef/index.ts","../src/hooks/useLaziedConst/index.ts","../src/utils/fnRunner/index.ts","../src/utils/createQueryWithCache/index.ts","../src/hooks/useQueryWithCache/index.ts"],"names":["useRef","localforage","deepEquals","fn","options","deps","useEffect","useState","_a"],"mappings":"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","file":"index.js","sourcesContent":["class ReplaySubject<T> {\n private maxBufferSize: number\n private buffer: T[] = []\n\n private subscriptions: ((data: T) => void)[] = []\n\n constructor(maxBufferSize = 1) {\n this.maxBufferSize = maxBufferSize\n }\n\n subscribe(fn: (data: T) => void) {\n this.subscriptions.push(fn)\n this.buffer.forEach(data => fn(data))\n return () => this.unsubscribe(fn)\n }\n\n unsubscribe(fn: (data: T) => void) {\n this.subscriptions = this.subscriptions.filter(f => f !== fn)\n }\n\n next(data: T) {\n this.subscriptions.forEach(fn => fn(data))\n this.buffer.push(data)\n if (this.buffer.length > this.maxBufferSize) {\n this.buffer = this.buffer.slice(1)\n }\n }\n}\n\nexport { ReplaySubject }\n","import { useRef } from 'react'\n\nexport function useLaziedRef<T extends NonNullable<unknown>>(value: () => T) {\n const ref = useRef<T>()\n\n if (ref.current == null) {\n ref.current = value()\n }\n\n return ref as React.MutableRefObject<T>\n}\n","import { useLaziedRef } from '../useLaziedRef'\n\nexport function useLaziedConst<T extends NonNullable<unknown>>(value: () => T) {\n return useLaziedRef(value).current\n}\n","export async function fnRunner<T extends (...args: any[]) => Promise<any>>(\n fn: T,\n retryTimes: number = 0,\n): Promise<Awaited<ReturnType<T>>> {\n const times = (retryTimes || 0) + 1\n for (let i = 0; i < times; i++) {\n try {\n return await fn()\n }\n catch (error) {\n // Only throw if this was the last attempt\n if (i === times - 1) {\n throw error\n }\n }\n }\n // This line should never be reached, but it's required for type safety.\n throw new Error('fnRunner: Unexpected error - all retries exhausted.')\n}\n","import localforage from 'localforage'\nimport { equals as deepEquals } from 'ramda'\nimport { ReplaySubject } from '../../class'\nimport { fnRunner } from '../fnRunner'\n\ntype DBType = Pick<\n LocalForage,\n 'getItem' | 'setItem' | 'removeItem' | 'clear'\n // 这些可以暂时不考虑\n // | 'clear' | 'keys' | 'length'\n>\n\nconst DB_NAME = 'sh-cache-common'\n\nlet db: DBType = localforage.createInstance({\n name: DB_NAME,\n storeName: 'main-store',\n // driver: [localforage.LOCALSTORAGE, localforage.INDEXEDDB, localforage.WEBSQL],\n})\n\ninterface CacheItem<T extends (...args: any[]) => Promise<any>> {\n /** 缓存参数 */\n deps: any[]\n /** 缓存版本,用于缓存数据结构变更 */\n version?: string\n /** 缓存过期时间,为空表示永不过期 */\n expires?: number\n /** 缓存结果 */\n result: Awaited<ReturnType<T>>\n}\n\ninterface CacheOptions<T extends (...args: any[]) => Promise<any>> {\n /** 缓存过期时间,为空表示永不过期 */\n maxAge?: number\n /** 缓存版本,用于缓存数据结构变更 */\n version?: string\n /** 依赖项,用于缓存依赖项变更。支持函数形式,函数会在运行时调用取值 */\n deps?: readonly unknown[] | (() => readonly unknown[])\n /**\n * 重试次数,为0表示不重试\n * @default 0\n */\n retry?: number\n /**\n * 是否比较旧缓存与新缓存后再触发 onCacheUpdate\n * 为 true 时,只有当新旧缓存不一致时才触发 onCacheUpdate\n * 为 false 时,总是触发 onCacheUpdate\n * @default R.equals\n */\n compareBeforeUpdate?:\n | ((prev: Awaited<ReturnType<T>>, next: Awaited<ReturnType<T>>) => boolean)\n | false\n /**\n * 是否启用远程内存缓存\n * 为 true 时,启用远程内存缓存\n * 为 false 时,不启用远程内存缓存\n * @default false\n */\n remoteMemoryCache?: boolean\n /**\n * 比较依赖项(函数参数及 deps)是否相等\n * @default R.equals\n */\n equals?: (prev: readonly unknown[], next: readonly unknown[]) => boolean\n /**\n * 根据入参决定是否启用缓存\n */\n cacheEnabled?: (deps: readonly unknown[]) => Promise<boolean>\n /** 请求前回调 */\n beforeRequest?: () => Promise<void> | void\n /** 请求成功回调 */\n onSuccess?: (result: {\n type: 'local' | 'remote'\n result: Awaited<ReturnType<T>>\n }) => void\n /** 请求错误回调 */\n onError?: (error: any) => void\n /** 远程请求错误处理 */\n errorHandler?: (error: any) => any\n // /** 缓存更新回调 */\n // onCacheUpdate?: (\n // result: Awaited<ReturnType<T>>,\n // cacheData: CacheItem<T>,\n // ) => void;\n}\n\ninterface CacheUpdateEvent<T extends (...args: any[]) => Promise<any>> {\n result: Awaited<ReturnType<T>>\n cacheData: CacheItem<T>\n isCacheHit: boolean\n}\n\nfunction createQueryWithCache<T extends (...args: any[]) => Promise<any>>(\n key: string,\n fn: T,\n options?: CacheOptions<T>,\n) {\n const {\n deps,\n retry,\n maxAge,\n version,\n compareBeforeUpdate,\n remoteMemoryCache,\n equals,\n cacheEnabled,\n beforeRequest,\n onSuccess,\n onError,\n errorHandler,\n } = {\n deps: [],\n retry: 0,\n equals: deepEquals,\n compareBeforeUpdate: deepEquals,\n remoteMemoryCache: false,\n ...options,\n } satisfies CacheOptions<T>\n\n let fnRunCount = 0\n let currentDeps: any[] = []\n const cacheUpdateSubject = new ReplaySubject<CacheUpdateEvent<T>>(1)\n\n /** 解析 deps,如果元素是函数则调用获取值 */\n const resolveDeps = () => (typeof deps === 'function' ? deps() : deps)\n\n interface QueryOption { runCount: number, deps: readonly unknown[] }\n\n const queryFnEnhancer = (\n fn: (args: Parameters<T>, option: QueryOption) => Promise<ReturnType<T>>,\n options: Pick<CacheOptions<T>, 'onSuccess' | 'onError'> & { type: 'remote' | 'local' },\n ) => (((args, rest) => {\n const promiseResult = fn(args, rest)\n\n promiseResult\n .then((result) => {\n const res = { type: options.type, result: result as Awaited<ReturnType<T>> }\n rest.runCount === fnRunCount && options.onSuccess?.(res)\n return res\n }, (error) => {\n rest.runCount === fnRunCount && options.onError?.(error)\n })\n .catch(() => {})\n\n return promiseResult\n }) as typeof fn)\n\n const getLocalCache = async (_args: Parameters<T>, { deps }: QueryOption) => {\n const cache = await db.getItem<CacheItem<T>>(key)\n if (\n cache\n && (!version || cache.version === version)\n && (!cache.expires || cache.expires > Date.now())\n && equals(cache.deps, deps)\n ) {\n return cache.result\n }\n\n throw new Error('Cache not found')\n }\n\n const remoteResultCache: {\n success: boolean\n deps: readonly unknown[]\n result: ReturnType<T> | null\n } = {\n success: false,\n deps: [],\n result: null,\n }\n\n const clearMemoryCache = () => {\n remoteResultCache.success = false\n remoteResultCache.result = null\n remoteResultCache.deps = []\n }\n\n const queryWithMemoryCache = (args: Parameters<T>, deps: readonly unknown[]) => {\n if (!remoteMemoryCache) {\n return {\n type: 'remote' as const,\n promiseResult: fnRunner(\n () => fn(...args),\n retry,\n ),\n }\n }\n\n if (\n remoteResultCache.success\n && equals(remoteResultCache.deps, deps)\n ) {\n return {\n type: 'memory' as const,\n promiseResult: remoteResultCache.result!,\n }\n }\n\n remoteResultCache.deps = deps\n remoteResultCache.success = true\n const result = (remoteResultCache.result = fnRunner(\n () => fn(...args),\n retry,\n ) as ReturnType<T>)\n\n Promise.resolve(result)\n .catch(clearMemoryCache)\n\n return { type: 'remote' as const, promiseResult: result }\n }\n\n const queryRemote = async (args: Parameters<T>, queryOption: QueryOption) => {\n const rs = {\n type: 'remote' as const,\n result: null as unknown as Awaited<ReturnType<T>>,\n }\n const { runCount, deps } = queryOption\n try {\n const { type, promiseResult } = queryWithMemoryCache(args, deps)\n const result = (rs.result = await promiseResult)\n\n // 设置缓存\n runCount === fnRunCount\n && type === 'remote'\n && (!cacheEnabled || (await cacheEnabled(deps)))\n && Promise.resolve().then(async () => {\n const oldCache = await getLocalCache(args, queryOption).catch(() => null)\n\n const cacheData: CacheItem<T> = {\n deps: deps as any[],\n result,\n ...(version && { version }),\n ...(maxAge && { expires: Date.now() + maxAge }),\n }\n db.setItem(key, cacheData)\n\n // 如果配置了比较,且旧缓存存在且与新结果相等,则不触发 onCacheUpdate\n if (\n compareBeforeUpdate\n && oldCache\n && compareBeforeUpdate(oldCache, result)\n ) {\n return\n }\n cacheUpdateSubject.next({\n result,\n cacheData,\n isCacheHit: !!oldCache,\n })\n })\n }\n catch (error) {\n if (errorHandler) {\n rs.result = (await errorHandler(error)) as Awaited<ReturnType<T>>\n }\n else {\n throw error\n }\n }\n\n return rs.result\n }\n\n const _fn = async (...args: Parameters<T>) => {\n await beforeRequest?.()\n\n const runCount = ++fnRunCount\n\n currentDeps = args.concat(resolveDeps())\n\n const queryOption: QueryOption = { runCount, deps: currentDeps }\n const isCacheDisabled = cacheEnabled && !(await cacheEnabled(currentDeps))\n\n const [cacheResult, remoteResult] = [\n isCacheDisabled\n ? null\n : queryFnEnhancer(getLocalCache, { type: 'local' as const, onSuccess })(args, queryOption),\n queryFnEnhancer(queryRemote, { type: 'remote' as const, onSuccess, onError })(args, queryOption),\n ]\n\n const result = cacheResult\n ? await Promise.race([\n cacheResult.catch(() => remoteResult),\n remoteResult,\n ])\n : remoteResult\n\n return result\n }\n\n _fn.refresh = async (...args: Parameters<T>) => {\n await beforeRequest?.()\n\n const runCount = ++fnRunCount\n currentDeps = args.concat(resolveDeps())\n\n const queryOption: QueryOption = { runCount, deps: currentDeps }\n return queryFnEnhancer(\n queryRemote,\n { type: 'remote' as const, onSuccess, onError },\n )(args, queryOption)\n }\n\n _fn.getCache = () => db.getItem<CacheItem<T>>(key)\n\n _fn.updateCache = async (\n value: CacheItem<T> | ((prev: CacheItem<T> | null) => CacheItem<T>),\n ) => {\n if (typeof value === 'function') {\n const prevCache = await _fn.getCache().catch(() => null)\n const newCache = value(prevCache)\n await db.setItem(key, newCache)\n }\n else {\n await db.setItem(key, value)\n }\n }\n\n _fn.subscribeCacheUpdate = (fn: (data: CacheUpdateEvent<T>) => void) =>\n cacheUpdateSubject.subscribe(fn)\n\n _fn.clearCache = async () => {\n clearMemoryCache()\n await db.removeItem(key)\n }\n\n return _fn\n}\n\n/**\n * 使用自定义数据库实例\n * @param newDb 数据库实例或 storeName,如果为字符串,则使用 localforage 创建一个实例\n */\ncreateQueryWithCache.useDb = <T extends string>(\n newDb: DBType | (T extends 'main-store' ? never : T),\n) => {\n if (typeof newDb === 'string') {\n db = localforage.createInstance({\n name: DB_NAME,\n storeName: newDb,\n })\n }\n else {\n db = newDb\n }\n}\n\nexport { createQueryWithCache }\nexport type { CacheItem, CacheOptions, CacheUpdateEvent }\n","import type { CacheOptions } from '../../utils'\nimport { useEffect, useRef, useState } from 'react'\nimport { createQueryWithCache } from '../../utils'\nimport { useLaziedConst } from '../useLaziedConst'\n\ninterface UseQueryWithCacheOptions<T> {\n /**\n * 是否自动执行查询\n * @default true\n */\n enabled?: boolean\n /** 初始数据,支持函数形式(惰性初始化) */\n initialData?: T | (() => T)\n /** 成功回调 */\n onSuccess?: (data: T) => void\n /** 错误回调 */\n onError?: (error: any) => void\n /** 完成回调 */\n onFinished?: (result: {\n success: true\n data: T\n } | {\n success: false\n error: any\n }) => void\n /** 自定义 useEffect 钩子 */\n useCustomEffect?: typeof useEffect\n}\n\n/**\n * 基于 createQueryWithCache 的 React Hook\n *\n * @param key - 缓存的唯一标识,暂不支持加入任何变量,仅支持字符串常量\n * @param fn - 查询函数\n * @param deps - 依赖列表,当依赖变化时重新执行查询\n * @param options - 配置选项\n */\nfunction useQueryWithCache<\n T extends () => Promise<any>,\n D,\n>(\n key: string,\n fn: T,\n deps: readonly D[] = [],\n options?: UseQueryWithCacheOptions<Awaited<ReturnType<T>>>\n & Pick<CacheOptions<T>, 'maxAge'\n | 'version'\n | 'retry'\n | 'compareBeforeUpdate'\n | 'remoteMemoryCache'> & {\n equals: (prev: readonly D[], next: readonly D[]) => boolean\n cacheEnabled?: (deps: readonly D[]) => Promise<boolean>\n },\n) {\n type Result = Awaited<ReturnType<T>>\n\n const {\n enabled = true,\n initialData,\n onSuccess,\n onError,\n onFinished,\n useCustomEffect = useEffect,\n ...restOptions\n } = options || {}\n\n const [loading, setLoading] = useState(false)\n const [state, setState] = useState<{\n type: 'local' | 'remote'\n data: Result | undefined\n error: any\n }>(() => ({\n type: 'local',\n data: typeof initialData === 'function' ? (initialData as () => Result)() : initialData,\n error: null,\n }))\n\n const infoRef = useRef({ deps, fn, onSuccess, onError, onFinished })\n infoRef.current.deps = deps\n infoRef.current.fn = fn\n infoRef.current.onSuccess = onSuccess\n infoRef.current.onError = onError\n infoRef.current.onFinished = onFinished\n\n const cachedFn = useLaziedConst(() => createQueryWithCache(key, () => infoRef.current.fn(), {\n // 这里类型已经推导的 T 就会出问题,先 as any 解决\n ...(restOptions as any),\n deps: () => infoRef.current.deps,\n beforeRequest: () => {\n setLoading(true)\n },\n onSuccess: (result) => {\n setLoading(false)\n setState({ type: result.type, data: result.result, error: null })\n infoRef.current.onSuccess?.(result.result)\n infoRef.current.onFinished?.({ success: true, data: result.result })\n },\n onError: (error) => {\n setLoading(false)\n setState(s => ({ ...s, error }))\n infoRef.current.onError?.(error)\n infoRef.current.onFinished?.({ success: false, error })\n },\n }))\n\n useCustomEffect(() => {\n if (!enabled)\n return\n\n cachedFn()\n }, [enabled, ...deps])\n\n return {\n ...state,\n loading,\n setState,\n run: cachedFn,\n refresh: cachedFn.refresh,\n clearCache: cachedFn.clearCache,\n }\n}\n\nexport { useQueryWithCache }\nexport type { UseQueryWithCacheOptions }\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shihengtech/utils",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.8",
|
|
4
4
|
"description": "A collection of utility tools for frontend projects",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "asakura",
|
|
@@ -55,11 +55,6 @@
|
|
|
55
55
|
"lint:fix": "eslint . --fix",
|
|
56
56
|
"prepublishOnly": "npm run build"
|
|
57
57
|
},
|
|
58
|
-
"dependencies": {
|
|
59
|
-
"localforage": "^1.10.0",
|
|
60
|
-
"ramda": "^0.32.0",
|
|
61
|
-
"tslib": "^2.8.1"
|
|
62
|
-
},
|
|
63
58
|
"peerDependencies": {
|
|
64
59
|
"react": "^16.8.0 || ^17.0.0 || ^18.0.0"
|
|
65
60
|
},
|
|
@@ -68,8 +63,13 @@
|
|
|
68
63
|
"optional": true
|
|
69
64
|
}
|
|
70
65
|
},
|
|
66
|
+
"dependencies": {
|
|
67
|
+
"localforage": "^1.10.0",
|
|
68
|
+
"ramda": "^0.32.0",
|
|
69
|
+
"tslib": "^2.8.1"
|
|
70
|
+
},
|
|
71
71
|
"devDependencies": {
|
|
72
|
-
"@antfu/eslint-config": "^
|
|
72
|
+
"@antfu/eslint-config": "^6.2.0",
|
|
73
73
|
"@types/node": "^20.10.0",
|
|
74
74
|
"@types/ramda": "^0.31.1",
|
|
75
75
|
"@types/react": "^18.0.0",
|