@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/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: (a, b) => a.length === b.length && a.every((item, index) => item === b[index]),
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
- }, options2.onError).catch(() => {
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 = (args) => __async(null, null, function* () {
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, args.concat(resolveDeps()))) {
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
- const currentDeps = resolveDeps();
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.args = args;
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 queryRemoteWithEnhancer = queryFnEnhancer((args) => __async(null, null, function* () {
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(args))) && Promise.resolve().then(() => __async(null, null, function* () {
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: args.concat(resolveDeps()),
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
- }), { type: "remote", onSuccess, onError });
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
- queryRemoteWithEnhancer(args)
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) => queryRemoteWithEnhancer(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.7",
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": "^4.13.0",
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",