@flowlist/js-core 4.0.7-beta.0 → 4.0.9-beta.0

package/dist/mutations/index.d.ts

@@ -0,0 +1,14 @@
+import { MutationHandler, RequestParams, UpdateStateType } from '../types.js';
+export { coreMutations } from './core.js';
+export { extendedMutations } from './extended.js';
+
+/**
+ * 创建 updateState 函数，可传入自定义 mutation handlers
+ */
+declare const createUpdateState: (handlers?: Record<string, MutationHandler>) => <P extends RequestParams, R>({ getter, setter, func, query, method, id, value, changeKey }: UpdateStateType<P, R>) => Promise<unknown>;
+/**
+ * 默认 updateState（包含全部 10 种 mutation）
+ */
+declare const updateState: <P extends RequestParams, R>({ getter, setter, func, query, method, id, value, changeKey }: UpdateStateType<P, R>) => Promise<unknown>;
+
+export { createUpdateState, updateState };

package/dist/mutations/index.js

@@ -0,0 +1,379 @@
+'use strict';
+
+// src/constants.ts
+var constants_default = {
+  SETTER_TYPE: {
+    RESET: 0},
+  CHANGE_TYPE: {
+    SEARCH_FIELD: "search",
+    RESET_FIELD: "reset",
+    RESULT_UPDATE_KV: "update",
+    RESULT_ADD_AFTER: "push",
+    RESULT_ADD_BEFORE: "unshift",
+    RESULT_REMOVE_BY_ID: "delete",
+    RESULT_INSERT_TO_BEFORE: "insert-before",
+    RESULT_INSERT_TO_AFTER: "insert-after",
+    RESULT_LIST_MERGE: "patch",
+    RESULT_ITEM_MERGE: "merge"
+  },
+  FIELD_DATA: {
+    RESULT_KEY: "result",
+    EXTRA_KEY: "extra"
+  },
+  DEFAULT_UNIQUE_KEY_NAME: "id"
+};
+
+// src/_internal/utils.ts
+var isArray = (data) => Array.isArray(data);
+var isObjectKey = (value) => typeof value === "string" || typeof value === "number";
+var isKeyMap = (value) => typeof value === "object" && value !== null && !isArray(value);
+var isKeyMapArray = (value) => isArray(value) && value.every((item) => typeof item === "object" && item !== null);
+var isObjectKeyArray = (value) => isArray(value) && value.every((item) => typeof item === "string" || typeof item === "number");
+var stableSerialize = (value) => {
+  if (value === null || typeof value !== "object") return String(value);
+  try {
+    if (isArray(value)) return JSON.stringify(value);
+    return JSON.stringify(
+      Object.fromEntries(
+        Object.entries(value).sort(
+          ([a], [b]) => a.localeCompare(b)
+        )
+      )
+    );
+  } catch {
+    return "[Circular]";
+  }
+};
+var getObjectDeepValue = (field, keys) => {
+  if (!keys || isArray(keys) && keys.length === 0) return field;
+  const keysArr = isArray(keys) ? keys : keys.split(".");
+  let cur = field;
+  for (let i = 0; i < keysArr.length; i++) {
+    if (cur == null || typeof cur !== "object") return void 0;
+    cur = cur[keysArr[i]];
+  }
+  return cur;
+};
+var updateObjectDeepValue = (field, changeKey, value) => {
+  const keys = changeKey.split(".");
+  const lastKey = keys.pop();
+  if (!lastKey) return;
+  let current = field;
+  for (const key of keys) {
+    if (current[key] == null || typeof current[key] !== "object") {
+      current[key] = {};
+    }
+    if (!isKeyMap(current[key])) return;
+    current = current[key];
+  }
+  current[lastKey] = value;
+};
+var computeMatchedItemIndex = (itemId, fieldArr, changingKey) => {
+  const stringId = String(itemId);
+  for (let i = 0; i < fieldArr.length; i++) {
+    const item = fieldArr[i];
+    if (!isKeyMap(item)) continue;
+    const val = getObjectDeepValue(item, changingKey);
+    if (String(val) === stringId) return i;
+  }
+  return -1;
+};
+var computeResultLength = (data) => {
+  if (isArray(data)) return data.length;
+  return 0;
+};
+var toObjectKey = (id) => {
+  if (id === void 0) return void 0;
+  if (isObjectKey(id)) return id;
+  if (isObjectKeyArray(id) && id.length > 0) return id[0];
+  return void 0;
+};
+var getResultAsArray = (field) => {
+  const result = field[constants_default.FIELD_DATA.RESULT_KEY];
+  return isArray(result) ? result : null;
+};
+var updateArrayItem = (arr, index, updater) => {
+  if (index >= 0 && index < arr.length && isKeyMap(arr[index])) {
+    arr[index] = updater(arr[index]);
+  }
+};
+var searchValueByKey = (result, id, key) => {
+  if (isArray(result)) {
+    const index = computeMatchedItemIndex(id, result, key);
+    return index >= 0 ? result[index] : void 0;
+  }
+  if (isKeyMap(result)) return result[String(id)];
+  return void 0;
+};
+var combineArrayData = (fieldArray, value, changingKey) => {
+  const indexMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < fieldArray.length; i++) {
+    const item = fieldArray[i];
+    if (!isKeyMap(item)) continue;
+    const id = getObjectDeepValue(item, changingKey);
+    if (id !== void 0) indexMap.set(String(id), i);
+  }
+  const mergeItem = (uniqueId, col) => {
+    const index = indexMap.get(uniqueId);
+    if (index !== void 0 && isKeyMap(fieldArray[index])) {
+      fieldArray[index] = { ...fieldArray[index], ...col };
+    }
+  };
+  if (isArray(value)) {
+    for (const col of value) {
+      if (!isKeyMap(col)) continue;
+      mergeItem(String(getObjectDeepValue(col, changingKey)), col);
+    }
+  } else if (isKeyMap(value)) {
+    for (const [uniqueId, col] of Object.entries(value)) {
+      if (isKeyMap(col)) mergeItem(uniqueId, col);
+    }
+  }
+};
+
+// src/core.ts
+var generateFieldName = ({
+  func,
+  query
+}) => {
+  let result = func.id;
+  if (!query) return result;
+  const queryObj = query;
+  const filteredKeys = Object.keys(queryObj).filter((key) => !func.paramsIgnore.includes(key)).sort();
+  for (const key of filteredKeys) {
+    const value = queryObj[key];
+    const safeValue = typeof value === "object" && value !== null ? stableSerialize(value) : String(value);
+    result += `-${key}-${encodeURIComponent(safeValue)}`;
+  }
+  return result;
+};
+
+// src/mutations/core.ts
+var pushHandler = (ctx) => {
+  if (!isArray(ctx.resultArray)) return;
+  return {
+    modifyValue: isArray(ctx.value) ? [...ctx.resultArray, ...ctx.value] : [...ctx.resultArray, ctx.value]
+  };
+};
+var unshiftHandler = (ctx) => {
+  if (!isArray(ctx.resultArray)) return;
+  return {
+    modifyValue: isArray(ctx.value) ? [...ctx.value, ...ctx.resultArray] : [ctx.value, ...ctx.resultArray]
+  };
+};
+var deleteHandler = (ctx) => {
+  if (!isKeyMapArray(ctx.resultArray)) return;
+  const objectKeyId = toObjectKey(ctx._id);
+  if (objectKeyId !== void 0) {
+    const matchedIndex = computeMatchedItemIndex(
+      objectKeyId,
+      ctx.resultArray,
+      ctx._uniqueKey
+    );
+    if (matchedIndex >= 0) {
+      const newArray = [...ctx.resultArray];
+      newArray.splice(matchedIndex, 1);
+      return { modifyValue: newArray };
+    }
+  }
+  if (isObjectKeyArray(ctx._id)) {
+    const idSet = new Set(ctx._id);
+    return {
+      modifyValue: ctx.resultArray.filter((item) => {
+        const itemKey = getObjectDeepValue(item, ctx._uniqueKey);
+        return typeof itemKey !== "string" && typeof itemKey !== "number" ? true : !idSet.has(itemKey);
+      })
+    };
+  }
+  return void 0;
+};
+var mergeHandler = (ctx) => {
+  const objectKeyId = toObjectKey(ctx._id);
+  if (objectKeyId === void 0 || !ctx.resultArray || !isKeyMap(ctx.value))
+    return;
+  const matchedIndex = computeMatchedItemIndex(
+    objectKeyId,
+    ctx.resultArray,
+    ctx._uniqueKey
+  );
+  updateArrayItem(ctx.resultArray, matchedIndex, (item) => ({
+    ...item,
+    ...ctx.value
+  }));
+};
+var resetHandler = (ctx) => {
+  if (ctx._changeKey === constants_default.FIELD_DATA.RESULT_KEY && isKeyMapArray(ctx.value)) {
+    ctx.newFieldData.result = ctx.value;
+  } else if (ctx._changeKey === constants_default.FIELD_DATA.EXTRA_KEY && isKeyMap(ctx.value)) {
+    ctx.newFieldData.extra = ctx.value;
+  }
+};
+var coreMutations = {
+  [constants_default.CHANGE_TYPE.RESULT_ADD_AFTER]: pushHandler,
+  [constants_default.CHANGE_TYPE.RESULT_ADD_BEFORE]: unshiftHandler,
+  [constants_default.CHANGE_TYPE.RESULT_REMOVE_BY_ID]: deleteHandler,
+  [constants_default.CHANGE_TYPE.RESULT_ITEM_MERGE]: mergeHandler,
+  [constants_default.CHANGE_TYPE.RESET_FIELD]: resetHandler
+};
+
+// src/mutations/extended.ts
+var searchHandler = (ctx) => {
+  const objectKeyId = toObjectKey(ctx._id);
+  if (objectKeyId === void 0) return;
+  const searchResult = ctx.resultArray ? searchValueByKey(ctx.resultArray, objectKeyId, ctx._uniqueKey) : void 0;
+  return { resolved: searchResult };
+};
+var updateKVHandler = (ctx) => {
+  const objectKeyId = toObjectKey(ctx._id);
+  if (objectKeyId === void 0 || !ctx.resultArray) return;
+  const matchedIndex = computeMatchedItemIndex(
+    objectKeyId,
+    ctx.resultArray,
+    ctx._uniqueKey
+  );
+  if (matchedIndex >= 0 && isKeyMap(ctx.resultArray[matchedIndex])) {
+    const newItem = { ...ctx.resultArray[matchedIndex] };
+    updateObjectDeepValue(newItem, ctx._changeKey, ctx.value);
+    ctx.resultArray[matchedIndex] = newItem;
+  }
+};
+var insertBeforeHandler = (ctx) => {
+  const objectKeyId = toObjectKey(ctx._id);
+  if (!isArray(ctx.resultArray) || objectKeyId === void 0) return void 0;
+  const matchedIndex = computeMatchedItemIndex(
+    objectKeyId,
+    ctx.resultArray,
+    ctx._uniqueKey
+  );
+  if (matchedIndex >= 0) {
+    const newArray = [...ctx.resultArray];
+    newArray.splice(matchedIndex, 0, ctx.value);
+    return { modifyValue: newArray };
+  }
+  return void 0;
+};
+var insertAfterHandler = (ctx) => {
+  const objectKeyId = toObjectKey(ctx._id);
+  if (!isArray(ctx.resultArray) || objectKeyId === void 0) return void 0;
+  const matchedIndex = computeMatchedItemIndex(
+    objectKeyId,
+    ctx.resultArray,
+    ctx._uniqueKey
+  );
+  if (matchedIndex >= 0) {
+    const newArray = [...ctx.resultArray];
+    newArray.splice(matchedIndex + 1, 0, ctx.value);
+    return { modifyValue: newArray };
+  }
+  return void 0;
+};
+var patchHandler = (ctx) => {
+  if (!isKeyMapArray(ctx.resultArray)) return;
+  const newArray = [...ctx.resultArray];
+  if (isKeyMapArray(ctx.value)) {
+    combineArrayData(newArray, ctx.value, ctx._uniqueKey);
+  } else if (isKeyMap(ctx.value)) {
+    const valueAsRecord = {};
+    for (const [k, v] of Object.entries(ctx.value)) {
+      if (isKeyMap(v)) valueAsRecord[k] = v;
+    }
+    combineArrayData(newArray, valueAsRecord, ctx._uniqueKey);
+  }
+  return { modifyValue: newArray };
+};
+var extendedMutations = {
+  [constants_default.CHANGE_TYPE.SEARCH_FIELD]: searchHandler,
+  [constants_default.CHANGE_TYPE.RESULT_UPDATE_KV]: updateKVHandler,
+  [constants_default.CHANGE_TYPE.RESULT_INSERT_TO_BEFORE]: insertBeforeHandler,
+  [constants_default.CHANGE_TYPE.RESULT_INSERT_TO_AFTER]: insertAfterHandler,
+  [constants_default.CHANGE_TYPE.RESULT_LIST_MERGE]: patchHandler
+};
+
+// src/mutations/index.ts
+var allMutations = {
+  ...coreMutations,
+  ...extendedMutations
+};
+var createUpdateState = (handlers = allMutations) => {
+  return ({
+    getter,
+    setter,
+    func,
+    query,
+    method,
+    id,
+    value,
+    changeKey
+  }) => {
+    return new Promise((resolve, reject) => {
+      const fieldName = generateFieldName({ func, query });
+      const fieldData = getter(fieldName);
+      if (!fieldData) {
+        reject(new Error(`Field ${fieldName} not found.`));
+        return;
+      }
+      if (fieldData.page === -1) {
+        resolve(null);
+        return;
+      }
+      const _uniqueKey = func.uniqueKey || constants_default.DEFAULT_UNIQUE_KEY_NAME;
+      const _changeKey = changeKey || constants_default.FIELD_DATA.RESULT_KEY;
+      const beforeLength = computeResultLength(
+        fieldData[constants_default.FIELD_DATA.RESULT_KEY]
+      );
+      const newFieldData = { ...fieldData };
+      let resultArray = getResultAsArray(fieldData);
+      if (resultArray) {
+        resultArray = [...resultArray];
+        newFieldData.result = resultArray;
+      }
+      const handler = handlers[method];
+      if (!handler) {
+        resolve(null);
+        return;
+      }
+      const ctx = {
+        resultArray,
+        newFieldData,
+        _id: id,
+        _uniqueKey,
+        _changeKey,
+        value
+      };
+      const handlerResult = handler(ctx);
+      if (handlerResult) {
+        if ("resolved" in handlerResult) {
+          resolve(handlerResult.resolved);
+          return;
+        }
+        if ("modifyValue" in handlerResult && handlerResult.modifyValue !== void 0) {
+          const modifyValue = handlerResult.modifyValue;
+          if (_changeKey === constants_default.FIELD_DATA.RESULT_KEY && isKeyMapArray(modifyValue)) {
+            newFieldData.result = modifyValue;
+          } else if (_changeKey === constants_default.FIELD_DATA.EXTRA_KEY && isKeyMap(modifyValue)) {
+            newFieldData.extra = modifyValue;
+          }
+        }
+      }
+      const afterLength = computeResultLength(
+        newFieldData[constants_default.FIELD_DATA.RESULT_KEY]
+      );
+      newFieldData.total = newFieldData.total + afterLength - beforeLength;
+      newFieldData.nothing = afterLength === 0;
+      setter({
+        key: fieldName,
+        type: constants_default.SETTER_TYPE.RESET,
+        value: newFieldData,
+        callback: () => resolve(null)
+      });
+    });
+  };
+};
+var updateState = createUpdateState();
+
+exports.coreMutations = coreMutations;
+exports.createUpdateState = createUpdateState;
+exports.extendedMutations = extendedMutations;
+exports.updateState = updateState;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/mutations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/_internal/utils.ts","../../src/core.ts","../../src/mutations/core.ts","../../src/mutations/extended.ts","../../src/mutations/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// constants.ts\nconst FETCH_TYPE_ARRAY = ['jump', 'sinceId', 'page', 'seenIds', 'auto'] as const\n\nexport default {\n  SETTER_TYPE: {\n    RESET: 0,\n    MERGE: 1\n  } as const,\n  FETCH_TYPE_ARRAY,\n  FETCH_TYPE: {\n    PAGINATION: FETCH_TYPE_ARRAY[0],\n    SINCE_FIRST_OR_END_ID: FETCH_TYPE_ARRAY[1],\n    SCROLL_LOAD_MORE: FETCH_TYPE_ARRAY[2],\n    HAS_LOADED_IDS: FETCH_TYPE_ARRAY[3],\n    AUTO: FETCH_TYPE_ARRAY[4]\n  } as const,\n  CHANGE_TYPE: {\n    SEARCH_FIELD: 'search',\n    RESET_FIELD: 'reset',\n    RESULT_UPDATE_KV: 'update',\n    RESULT_ADD_AFTER: 'push',\n    RESULT_ADD_BEFORE: 'unshift',\n    RESULT_REMOVE_BY_ID: 'delete',\n    RESULT_INSERT_TO_BEFORE: 'insert-before',\n    RESULT_INSERT_TO_AFTER: 'insert-after',\n    RESULT_LIST_MERGE: 'patch',\n    RESULT_ITEM_MERGE: 'merge'\n  } as const,\n  FIELD_DATA: {\n    RESULT_KEY: 'result',\n    EXTRA_KEY: 'extra'\n  } as const,\n  DEFAULT_UNIQUE_KEY_NAME: 'id'\n} as const\n","// _internal/utils.ts\nimport ENUM from '../constants'\nimport type {\n  DefaultField,\n  FetchType,\n  FieldKeys,\n  GenerateParamsResp,\n  GenerateParamsType,\n  KeyMap,\n  ObjectKey\n} from '../types'\n\n// ========== 类型守卫 ==========\n\nexport const isArray = (data: unknown): data is any[] => Array.isArray(data)\n\nexport const isObjectKey = (value: unknown): value is ObjectKey =>\n  typeof value === 'string' || typeof value === 'number'\n\nexport const isKeyMap = (value: unknown): value is KeyMap =>\n  typeof value === 'object' && value !== null && !isArray(value)\n\nexport const isKeyMapArray = (value: unknown): value is KeyMap[] =>\n  isArray(value) &&\n  value.every((item) => typeof item === 'object' && item !== null)\n\nexport const isObjectKeyArray = (value: unknown): value is ObjectKey[] =>\n  isArray(value) &&\n  value.every((item) => typeof item === 'string' || typeof item === 'number')\n\n// ========== 序列化 ==========\n\nexport const stableSerialize = (value: unknown): string => {\n  if (value === null || typeof value !== 'object') return String(value)\n  try {\n    if (isArray(value)) return JSON.stringify(value)\n    return JSON.stringify(\n      Object.fromEntries(\n        Object.entries(value as Record<string, unknown>).sort(([a], [b]) =>\n          a.localeCompare(b)\n        )\n      )\n    )\n  } catch {\n    return '[Circular]'\n  }\n}\n\n// ========== 深度访问 ==========\n\nexport const getObjectDeepValue = (\n  field: unknown,\n  keys: string | string[]\n): unknown => {\n  if (!keys || (isArray(keys) && keys.length === 0)) return field\n  const keysArr = isArray(keys) ? keys : (keys as string).split('.')\n  let cur: any = field\n  for (let i = 0; i < keysArr.length; i++) {\n    if (cur == null || typeof cur !== 'object') return undefined\n    cur = cur[keysArr[i]]\n  }\n  return cur\n}\n\nexport const updateObjectDeepValue = (\n  field: KeyMap,\n  changeKey: string,\n  value: unknown\n): void => {\n  const keys = changeKey.split('.')\n  const lastKey = keys.pop()\n  if (!lastKey) return\n\n  let current: KeyMap = field\n  for (const key of keys) {\n    if (current[key] == null || typeof current[key] !== 'object') {\n      current[key] = {}\n    }\n    if (!isKeyMap(current[key])) return\n    current = current[key] as KeyMap\n  }\n  current[lastKey] = value\n}\n\n// ========== uniqueKey 提取 ==========\n\nconst extractUniqueKey = (\n  item: KeyMap,\n  uniqueKey: string\n): ObjectKey | undefined => {\n  if (!isKeyMap(item)) return undefined\n  const val = item[uniqueKey]\n  if (isObjectKey(val)) return val\n  if (uniqueKey.includes('.')) {\n    const deepVal = getObjectDeepValue(item, uniqueKey)\n    if (isObjectKey(deepVal)) return deepVal\n  }\n  return undefined\n}\n\n// ========== 核心工具 ==========\n\nexport const generateDefaultField = <T = any>(\n  opts: Partial<DefaultField<T>> = {}\n): DefaultField<T> => ({\n  result: [] as unknown as T,\n  noMore: false,\n  nothing: false,\n  loading: false,\n  error: null,\n  extra: null,\n  fetched: false,\n  page: 0,\n  total: 0,\n  ...opts\n})\n\nexport const computeMatchedItemIndex = (\n  itemId: ObjectKey,\n  fieldArr: any[],\n  changingKey: string\n): number => {\n  const stringId = String(itemId)\n  for (let i = 0; i < fieldArr.length; i++) {\n    const item = fieldArr[i]\n    if (!isKeyMap(item)) continue\n    const val = getObjectDeepValue(item, changingKey)\n    if (String(val) === stringId) return i\n  }\n  return -1\n}\n\nexport const computeResultLength = (data: unknown): number => {\n  if (isArray(data)) return data.length\n  return 0\n}\n\nexport const toObjectKey = (\n  id: ObjectKey | ObjectKey[] | undefined\n): ObjectKey | undefined => {\n  if (id === undefined) return undefined\n  if (isObjectKey(id)) return id\n  if (isObjectKeyArray(id) && id.length > 0) return id[0]\n  return undefined\n}\n\nexport const getResultAsArray = (field: DefaultField): any[] | null => {\n  const result = field[ENUM.FIELD_DATA.RESULT_KEY]\n  return isArray(result) ? result : null\n}\n\nexport const updateArrayItem = (\n  arr: any[],\n  index: number,\n  updater: (item: KeyMap) => KeyMap\n): void => {\n  if (index >= 0 && index < arr.length && isKeyMap(arr[index])) {\n    arr[index] = updater(arr[index])\n  }\n}\n\n// ========== 搜索 ==========\n\nexport const searchValueByKey = (\n  result: any[] | Record<string, any>,\n  id: ObjectKey,\n  key: string\n): unknown => {\n  if (isArray(result)) {\n    const index = computeMatchedItemIndex(id, result, key)\n    return index >= 0 ? result[index] : undefined\n  }\n  if (isKeyMap(result)) return result[String(id)]\n  return undefined\n}\n\n// ========== 批量合并 ==========\n\nexport const combineArrayData = (\n  fieldArray: any[],\n  value: any[] | Record<ObjectKey, KeyMap>,\n  changingKey: string\n): void => {\n  const indexMap = new Map<string, number>()\n  for (let i = 0; i < fieldArray.length; i++) {\n    const item = fieldArray[i]\n    if (!isKeyMap(item)) continue\n    const id = getObjectDeepValue(item, changingKey)\n    if (id !== undefined) indexMap.set(String(id), i)\n  }\n\n  const mergeItem = (uniqueId: string, col: KeyMap) => {\n    const index = indexMap.get(uniqueId)\n    if (index !== undefined && isKeyMap(fieldArray[index])) {\n      fieldArray[index] = { ...fieldArray[index], ...col }\n    }\n  }\n\n  if (isArray(value)) {\n    for (const col of value) {\n      if (!isKeyMap(col)) continue\n      mergeItem(String(getObjectDeepValue(col, changingKey)), col)\n    }\n  } else if (isKeyMap(value)) {\n    for (const [uniqueId, col] of Object.entries(value)) {\n      if (isKeyMap(col)) mergeItem(uniqueId, col)\n    }\n  }\n}\n\n// ========== 响应式字段设置 ==========\n\nexport const setReactivityField = (\n  field: DefaultField,\n  key: FieldKeys,\n  value: unknown,\n  type: FetchType,\n  insertBefore: boolean\n): void => {\n  const fieldAny = field as any\n\n  // 分页模式直接赋值\n  if (type === ENUM.FETCH_TYPE.PAGINATION) {\n    fieldAny[key] = value\n    return\n  }\n\n  // 非 result 字段\n  if (key !== ENUM.FIELD_DATA.RESULT_KEY) {\n    if (isArray(value)) {\n      const current = isArray(fieldAny[key]) ? fieldAny[key] : []\n      fieldAny[key] = insertBefore\n        ? [...(value as any[]), ...current]\n        : [...current, ...(value as any[])]\n    } else {\n      fieldAny[key] = value\n    }\n    return\n  }\n\n  // result 字段 — 数组\n  if (isArray(value)) {\n    if ((value as any[]).length === 0) return\n    const current = isArray(field.result) ? (field.result as any[]) : []\n    if (current.length === 0) {\n      field.result = value as any\n      return\n    }\n    field.result = (\n      insertBefore\n        ? [...(value as any[]), ...current]\n        : [...current, ...(value as any[])]\n    ) as any\n    return\n  }\n\n  // result 字段 — 对象（按 key 分组场景）\n  const valueObj = value as KeyMap\n  let target = field.result as Record<string, any>\n  if (\n    isArray(field.result) ||\n    typeof field.result !== 'object' ||\n    field.result === null\n  ) {\n    target = {}\n    field.result = target as any\n  }\n\n  for (const subKey of Object.keys(valueObj)) {\n    const existing = target[subKey]\n    const incoming = valueObj[subKey]\n    if (existing !== undefined && isArray(existing) && isArray(incoming)) {\n      target[subKey] = insertBefore\n        ? [...incoming, ...existing]\n        : [...existing, ...incoming]\n    } else {\n      target[subKey] = incoming\n    }\n  }\n}\n\n// ========== 请求参数生成 ==========\n\nconst getSeenIdsString = (arr: any[], uniqueKey: string): string => {\n  if (!isArray(arr)) return ''\n  const ids: ObjectKey[] = []\n  for (const item of arr) {\n    const id = extractUniqueKey(item, uniqueKey)\n    if (id !== undefined) ids.push(id)\n  }\n  return ids.join(',')\n}\n\nexport const generateRequestParams = ({\n  field,\n  uniqueKey = ENUM.DEFAULT_UNIQUE_KEY_NAME,\n  query = {},\n  is_up = false,\n  type\n}: GenerateParamsType): GenerateParamsResp => {\n  const result: GenerateParamsResp = { ...query }\n  const isFetched = field.fetched\n  const fieldResult = field.result as any\n\n  const getSafeObjectKey = (item: unknown): ObjectKey | undefined =>\n    extractUniqueKey(item as KeyMap, uniqueKey)\n\n  if (isFetched) {\n    switch (type) {\n      case ENUM.FETCH_TYPE.AUTO:\n        if (isArray(fieldResult)) {\n          result.seen_ids = getSeenIdsString(fieldResult, uniqueKey)\n          result.since_id = getSafeObjectKey(\n            fieldResult[is_up ? 0 : fieldResult.length - 1]\n          )\n        }\n        result.is_up = is_up ? 1 : 0\n        result.page =\n          typeof query.page === 'number' ? query.page : field.page + 1\n        break\n      case ENUM.FETCH_TYPE.HAS_LOADED_IDS:\n        if (isArray(fieldResult)) {\n          result.seen_ids = getSeenIdsString(fieldResult, uniqueKey)\n        }\n        break\n      case ENUM.FETCH_TYPE.SINCE_FIRST_OR_END_ID:\n        if (isArray(fieldResult)) {\n          result.since_id = getSafeObjectKey(\n            fieldResult[is_up ? 0 : fieldResult.length - 1]\n          )\n        }\n        result.is_up = is_up ? 1 : 0\n        break\n      case ENUM.FETCH_TYPE.PAGINATION:\n        result.page = typeof query.page === 'number' ? query.page : undefined\n        break\n      case ENUM.FETCH_TYPE.SCROLL_LOAD_MORE:\n        result.page = field.page + 1\n        break\n    }\n  } else {\n    switch (type) {\n      case ENUM.FETCH_TYPE.AUTO:\n        result.seen_ids = ''\n        result.since_id = isObjectKey(query.sinceId) ? query.sinceId : ''\n        result.is_up = is_up ? 1 : 0\n        result.page =\n          typeof query.page === 'number' ? query.page : field.page || 1\n        break\n      case ENUM.FETCH_TYPE.HAS_LOADED_IDS:\n        result.seen_ids = ''\n        break\n      case ENUM.FETCH_TYPE.SINCE_FIRST_OR_END_ID:\n        result.since_id = isObjectKey(query.sinceId) ? query.sinceId : ''\n        result.is_up = is_up ? 1 : 0\n        break\n      case ENUM.FETCH_TYPE.PAGINATION:\n        result.page = typeof query.page === 'number' ? query.page : field.page\n        break\n      case ENUM.FETCH_TYPE.SCROLL_LOAD_MORE:\n        result.page = 1\n        break\n    }\n  }\n\n  return result\n}\n","// core.ts — createApi / initState / initData / loadMore / generateFieldName\nimport { SET_DATA, SET_ERROR } from './_internal/setters'\nimport {\n  generateDefaultField,\n  generateRequestParams,\n  stableSerialize\n} from './_internal/utils'\nimport ENUM from './constants'\n\nimport type {\n  ApiContract,\n  BaseApiResponse,\n  DefaultField,\n  FetchType,\n  InitDataType,\n  InitStateType,\n  KeyMap,\n  LoadMoreType,\n  RequestParams\n} from './types'\n\n// --- generateFieldName ---\nexport const generateFieldName = <P extends RequestParams, R>({\n  func,\n  query\n}: {\n  func: ApiContract<P, R>\n  query?: P\n}): string => {\n  let result = func.id\n  if (!query) return result\n\n  const queryObj = query as Record<string, unknown>\n  const filteredKeys = Object.keys(queryObj)\n    .filter((key) => !func.paramsIgnore.includes(key))\n    .sort()\n\n  for (const key of filteredKeys) {\n    const value = queryObj[key]\n    const safeValue =\n      typeof value === 'object' && value !== null\n        ? stableSerialize(value)\n        : String(value)\n    result += `-${key}-${encodeURIComponent(safeValue)}`\n  }\n  return result\n}\n\n// --- createApi ---\nexport const createApi = <P extends RequestParams, R>(options: {\n  id: string\n  type?: FetchType\n  uniqueKey?: string\n  is_up?: boolean\n  paramsIgnore?: string[]\n  fetcher: (params: P) => Promise<BaseApiResponse<R>>\n}): ApiContract<P, R> => {\n  const fn = ((params: P) => options.fetcher(params)) as ApiContract<P, R>\n\n  const metadata: Partial<ApiContract<P, R>> = {\n    id: options.id,\n    type: options.type || (ENUM.FETCH_TYPE.SCROLL_LOAD_MORE as FetchType),\n    uniqueKey: options.uniqueKey || ENUM.DEFAULT_UNIQUE_KEY_NAME,\n    is_up: options.is_up || false,\n    paramsIgnore: [\n      'page',\n      'since_id',\n      'seen_ids',\n      '__refresh__',\n      '__reload__',\n      ...(options.paramsIgnore || [])\n    ]\n  }\n\n  return Object.freeze(Object.assign(fn, metadata))\n}\n\n// --- initState ---\nexport const initState = <P extends RequestParams, R>({\n  getter,\n  setter,\n  func,\n  query,\n  opts\n}: InitStateType<P, R>): Promise<void> => {\n  return new Promise((resolve) => {\n    const fieldName = generateFieldName({ func, query })\n    if (getter(fieldName)) return resolve()\n\n    setter({\n      key: fieldName,\n      type: ENUM.SETTER_TYPE.RESET,\n      value: generateDefaultField(opts),\n      callback: () => resolve()\n    })\n  })\n}\n\n// --- initData ---\nexport const initData = <P extends RequestParams, R>({\n  getter,\n  setter,\n  func,\n  query,\n  callback\n}: InitDataType<P, R>): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const fieldName = generateFieldName({ func, query })\n    const fieldData = getter(fieldName)\n\n    const doRefresh = !!query?.__refresh__\n    const needReset = !!query?.__reload__\n    const directlyLoadData = doRefresh && !needReset\n\n    if (fieldData && fieldData.error && !doRefresh) return resolve()\n    if (fieldData && fieldData.loading) return resolve()\n    if (fieldData && fieldData.fetched && !doRefresh) return resolve()\n\n    const params = generateRequestParams({\n      field: generateDefaultField({ ...fieldData, fetched: false }),\n      uniqueKey: func.uniqueKey,\n      type: func.type,\n      is_up: func.is_up,\n      query: query as KeyMap\n    })\n\n    const executeFetch = () => {\n      func(params as P)\n        .then((data) => {\n          const commitData = () => {\n            SET_DATA({\n              getter,\n              setter,\n              data: data as BaseApiResponse,\n              fieldName,\n              type: func.type,\n              page: params.page || 0,\n              insertBefore: false\n            }).then(() => {\n              callback?.({ params: params as P, data, refresh: doRefresh })\n              resolve()\n            })\n          }\n\n          if (directlyLoadData) {\n            setter({\n              key: fieldName,\n              type: ENUM.SETTER_TYPE.RESET,\n              value: generateDefaultField(),\n              callback: commitData\n            })\n          } else {\n            commitData()\n          }\n        })\n        .catch((error: Error) => {\n          SET_ERROR({ setter, fieldName, error })\n          reject(error)\n        })\n    }\n\n    if (directlyLoadData) {\n      executeFetch()\n    } else {\n      setter({\n        key: fieldName,\n        type: ENUM.SETTER_TYPE.RESET,\n        value: { ...generateDefaultField(), loading: true, error: null },\n        callback: executeFetch\n      })\n    }\n  })\n\n// --- loadMore ---\nexport const loadMore = <P extends RequestParams, R>({\n  getter,\n  setter,\n  query,\n  func,\n  errorRetry,\n  callback\n}: LoadMoreType<P, R>): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const fieldName = generateFieldName({ func, query })\n    const fieldData = getter(fieldName)\n    if (!fieldData || fieldData.loading || fieldData.nothing) return resolve()\n    if (fieldData.noMore && !errorRetry) return resolve()\n\n    const type = func.type\n\n    if (\n      type === ENUM.FETCH_TYPE.PAGINATION &&\n      query?.page != null &&\n      Number(query.page) === fieldData.page\n    ) {\n      return resolve()\n    }\n\n    const loadingState: Partial<DefaultField> =\n      type === ENUM.FETCH_TYPE.PAGINATION\n        ? { loading: true, error: null, result: [], extra: null }\n        : { loading: true, error: null }\n\n    const params = generateRequestParams({\n      field: fieldData,\n      uniqueKey: func.uniqueKey,\n      type,\n      is_up: func.is_up,\n      query: query as KeyMap\n    })\n\n    if (fieldData.extra) params.extra = fieldData.extra\n\n    setter({\n      key: fieldName,\n      type: ENUM.SETTER_TYPE.MERGE,\n      value: loadingState,\n      callback: () => {\n        func(params as P)\n          .then((data) => {\n            SET_DATA({\n              getter,\n              setter,\n              data: data as BaseApiResponse,\n              type,\n              fieldName,\n              page: params.page || 0,\n              insertBefore: func.is_up\n            }).then(() => {\n              callback?.({ params: params as P, data, refresh: false })\n              resolve()\n            })\n          })\n          .catch((error: Error) => {\n            SET_ERROR({ setter, fieldName, error })\n            reject(error)\n          })\n      }\n    })\n  })\n","// mutations/core.ts — 5 种核心 mutation handler\nimport {\n  computeMatchedItemIndex,\n  getObjectDeepValue,\n  isArray,\n  isKeyMap,\n  isKeyMapArray,\n  isObjectKeyArray,\n  toObjectKey,\n  updateArrayItem\n} from '../_internal/utils'\nimport ENUM from '../constants'\nimport type { MutationHandler, ObjectKey } from '../types'\n\n// --- push: 末尾追加 ---\nexport const pushHandler: MutationHandler = (ctx) => {\n  if (!isArray(ctx.resultArray)) return\n  return {\n    modifyValue: isArray(ctx.value)\n      ? [...ctx.resultArray, ...ctx.value]\n      : [...ctx.resultArray, ctx.value]\n  }\n}\n\n// --- unshift: 头部插入 ---\nexport const unshiftHandler: MutationHandler = (ctx) => {\n  if (!isArray(ctx.resultArray)) return\n  return {\n    modifyValue: isArray(ctx.value)\n      ? [...ctx.value, ...ctx.resultArray]\n      : [ctx.value, ...ctx.resultArray]\n  }\n}\n\n// --- delete: 按 ID 删除 ---\nexport const deleteHandler: MutationHandler = (ctx) => {\n  if (!isKeyMapArray(ctx.resultArray)) return\n\n  const objectKeyId = toObjectKey(ctx._id)\n\n  if (objectKeyId !== undefined) {\n    const matchedIndex = computeMatchedItemIndex(\n      objectKeyId,\n      ctx.resultArray,\n      ctx._uniqueKey\n    )\n    if (matchedIndex >= 0) {\n      const newArray = [...ctx.resultArray]\n      newArray.splice(matchedIndex, 1)\n      return { modifyValue: newArray }\n    }\n  }\n\n  // 批量删除：id 为数组\n  if (isObjectKeyArray(ctx._id)) {\n    const idSet = new Set<ObjectKey>(ctx._id)\n    return {\n      modifyValue: ctx.resultArray.filter((item) => {\n        const itemKey = getObjectDeepValue(item, ctx._uniqueKey)\n        return typeof itemKey !== 'string' && typeof itemKey !== 'number'\n          ? true\n          : !idSet.has(itemKey as ObjectKey)\n      })\n    }\n  }\n\n  return undefined\n}\n\n// --- merge: 按 ID 合并字段 ---\nexport const mergeHandler: MutationHandler = (ctx) => {\n  const objectKeyId = toObjectKey(ctx._id)\n  if (objectKeyId === undefined || !ctx.resultArray || !isKeyMap(ctx.value))\n    return\n\n  const matchedIndex = computeMatchedItemIndex(\n    objectKeyId,\n    ctx.resultArray,\n    ctx._uniqueKey\n  )\n  updateArrayItem(ctx.resultArray, matchedIndex, (item) => ({\n    ...item,\n    ...ctx.value\n  }))\n}\n\n// --- reset: 整体替换 result 或 extra ---\nexport const resetHandler: MutationHandler = (ctx) => {\n  if (\n    ctx._changeKey === ENUM.FIELD_DATA.RESULT_KEY &&\n    isKeyMapArray(ctx.value)\n  ) {\n    ctx.newFieldData.result = ctx.value\n  } else if (\n    ctx._changeKey === ENUM.FIELD_DATA.EXTRA_KEY &&\n    isKeyMap(ctx.value)\n  ) {\n    ctx.newFieldData.extra = ctx.value\n  }\n}\n\n// --- 核心 mutation 注册表 ---\nexport const coreMutations: Record<string, MutationHandler> = {\n  [ENUM.CHANGE_TYPE.RESULT_ADD_AFTER]: pushHandler,\n  [ENUM.CHANGE_TYPE.RESULT_ADD_BEFORE]: unshiftHandler,\n  [ENUM.CHANGE_TYPE.RESULT_REMOVE_BY_ID]: deleteHandler,\n  [ENUM.CHANGE_TYPE.RESULT_ITEM_MERGE]: mergeHandler,\n  [ENUM.CHANGE_TYPE.RESET_FIELD]: resetHandler\n}\n","// mutations/extended.ts — 5 种扩展 mutation handler\nimport {\n  combineArrayData,\n  computeMatchedItemIndex,\n  isArray,\n  isKeyMap,\n  isKeyMapArray,\n  searchValueByKey,\n  toObjectKey,\n  updateObjectDeepValue\n} from '../_internal/utils'\nimport ENUM from '../constants'\nimport type { KeyMap, MutationHandler, ObjectKey } from '../types'\n\n// --- search: 按 ID 查找 item ---\nexport const searchHandler: MutationHandler = (ctx) => {\n  const objectKeyId = toObjectKey(ctx._id)\n  if (objectKeyId === undefined) return\n  const searchResult = ctx.resultArray\n    ? searchValueByKey(ctx.resultArray, objectKeyId, ctx._uniqueKey)\n    : undefined\n  return { resolved: searchResult }\n}\n\n// --- update: 深层 KV 更新 ---\nexport const updateKVHandler: MutationHandler = (ctx) => {\n  const objectKeyId = toObjectKey(ctx._id)\n  if (objectKeyId === undefined || !ctx.resultArray) return\n\n  const matchedIndex = computeMatchedItemIndex(\n    objectKeyId,\n    ctx.resultArray,\n    ctx._uniqueKey\n  )\n  if (matchedIndex >= 0 && isKeyMap(ctx.resultArray[matchedIndex])) {\n    const newItem = { ...ctx.resultArray[matchedIndex] }\n    updateObjectDeepValue(newItem, ctx._changeKey, ctx.value)\n    ctx.resultArray[matchedIndex] = newItem\n  }\n}\n\n// --- insert-before: 在指定 ID 前插入 ---\nexport const insertBeforeHandler: MutationHandler = (ctx) => {\n  const objectKeyId = toObjectKey(ctx._id)\n  if (!isArray(ctx.resultArray) || objectKeyId === undefined) return undefined\n\n  const matchedIndex = computeMatchedItemIndex(\n    objectKeyId,\n    ctx.resultArray,\n    ctx._uniqueKey\n  )\n  if (matchedIndex >= 0) {\n    const newArray = [...ctx.resultArray]\n    newArray.splice(matchedIndex, 0, ctx.value)\n    return { modifyValue: newArray }\n  }\n  return undefined\n}\n\n// --- insert-after: 在指定 ID 后插入 ---\nexport const insertAfterHandler: MutationHandler = (ctx) => {\n  const objectKeyId = toObjectKey(ctx._id)\n  if (!isArray(ctx.resultArray) || objectKeyId === undefined) return undefined\n\n  const matchedIndex = computeMatchedItemIndex(\n    objectKeyId,\n    ctx.resultArray,\n    ctx._uniqueKey\n  )\n  if (matchedIndex >= 0) {\n    const newArray = [...ctx.resultArray]\n    newArray.splice(matchedIndex + 1, 0, ctx.value)\n    return { modifyValue: newArray }\n  }\n  return undefined\n}\n\n// --- patch: 批量合并 ---\nexport const patchHandler: MutationHandler = (ctx) => {\n  if (!isKeyMapArray(ctx.resultArray)) return\n\n  const newArray = [...ctx.resultArray]\n  if (isKeyMapArray(ctx.value)) {\n    combineArrayData(newArray, ctx.value, ctx._uniqueKey)\n  } else if (isKeyMap(ctx.value)) {\n    const valueAsRecord: Record<ObjectKey, KeyMap> = {}\n    for (const [k, v] of Object.entries(ctx.value)) {\n      if (isKeyMap(v)) valueAsRecord[k] = v\n    }\n    combineArrayData(newArray, valueAsRecord, ctx._uniqueKey)\n  }\n  return { modifyValue: newArray }\n}\n\n// --- 扩展 mutation 注册表 ---\nexport const extendedMutations: Record<string, MutationHandler> = {\n  [ENUM.CHANGE_TYPE.SEARCH_FIELD]: searchHandler,\n  [ENUM.CHANGE_TYPE.RESULT_UPDATE_KV]: updateKVHandler,\n  [ENUM.CHANGE_TYPE.RESULT_INSERT_TO_BEFORE]: insertBeforeHandler,\n  [ENUM.CHANGE_TYPE.RESULT_INSERT_TO_AFTER]: insertAfterHandler,\n  [ENUM.CHANGE_TYPE.RESULT_LIST_MERGE]: patchHandler\n}\n","// mutations/index.ts — 全量 updateState（core + extended mutations）\nimport {\n  computeResultLength,\n  getResultAsArray,\n  isKeyMap,\n  isKeyMapArray\n} from '../_internal/utils'\nimport ENUM from '../constants'\nimport { generateFieldName } from '../core'\n\nimport type {\n  DefaultField,\n  MutationContext,\n  MutationHandler,\n  RequestParams,\n  UpdateStateType\n} from '../types'\n\nimport { coreMutations } from './core'\nimport { extendedMutations } from './extended'\n\n// 合并全部 mutation handlers\nconst allMutations: Record<string, MutationHandler> = {\n  ...coreMutations,\n  ...extendedMutations\n}\n\nexport { coreMutations } from './core'\nexport { extendedMutations } from './extended'\n\n/**\n * 创建 updateState 函数，可传入自定义 mutation handlers\n */\nexport const createUpdateState = (\n  handlers: Record<string, MutationHandler> = allMutations\n) => {\n  return <P extends RequestParams, R>({\n    getter,\n    setter,\n    func,\n    query,\n    method,\n    id,\n    value,\n    changeKey\n  }: UpdateStateType<P, R>): Promise<unknown> => {\n    return new Promise((resolve, reject) => {\n      const fieldName = generateFieldName({ func, query })\n      const fieldData = getter(fieldName)\n      if (!fieldData) {\n        reject(new Error(`Field ${fieldName} not found.`))\n        return\n      }\n\n      if (fieldData.page === -1) {\n        resolve(null)\n        return\n      }\n\n      const _uniqueKey = func.uniqueKey || ENUM.DEFAULT_UNIQUE_KEY_NAME\n      const _changeKey = changeKey || ENUM.FIELD_DATA.RESULT_KEY\n      const beforeLength = computeResultLength(\n        fieldData[ENUM.FIELD_DATA.RESULT_KEY]\n      )\n\n      // 创建新 field 对象\n      const newFieldData: DefaultField = { ...fieldData }\n      let resultArray = getResultAsArray(fieldData)\n      if (resultArray) {\n        resultArray = [...resultArray]\n        newFieldData.result = resultArray as any\n      }\n\n      // 查找 handler\n      const handler = handlers[method]\n      if (!handler) {\n        resolve(null)\n        return\n      }\n\n      const ctx: MutationContext = {\n        resultArray,\n        newFieldData,\n        _id: id,\n        _uniqueKey,\n        _changeKey,\n        value\n      }\n\n      const handlerResult = handler(ctx)\n\n      // 处理 handler 返回值\n      if (handlerResult) {\n        // search 等操作直接返回结果\n        if ('resolved' in handlerResult) {\n          resolve(handlerResult.resolved)\n          return\n        }\n\n        // modifyValue: handler 返回了处理后的数据，需要写回\n        if (\n          'modifyValue' in handlerResult &&\n          handlerResult.modifyValue !== undefined\n        ) {\n          const modifyValue = handlerResult.modifyValue\n          if (\n            _changeKey === ENUM.FIELD_DATA.RESULT_KEY &&\n            isKeyMapArray(modifyValue)\n          ) {\n            newFieldData.result = modifyValue\n          } else if (\n            _changeKey === ENUM.FIELD_DATA.EXTRA_KEY &&\n            isKeyMap(modifyValue)\n          ) {\n            newFieldData.extra = modifyValue\n          }\n        }\n      }\n\n      // 更新 total 和 nothing\n      const afterLength = computeResultLength(\n        newFieldData[ENUM.FIELD_DATA.RESULT_KEY]\n      )\n      newFieldData.total = newFieldData.total + afterLength - beforeLength\n      newFieldData.nothing = afterLength === 0\n\n      setter({\n        key: fieldName,\n        type: ENUM.SETTER_TYPE.RESET,\n        value: newFieldData,\n        callback: () => resolve(null)\n      })\n    })\n  }\n}\n\n/**\n * 默认 updateState（包含全部 10 种 mutation）\n */\nexport const updateState = createUpdateState()\n"]}

package/dist/mutations/index.mjs

@@ -0,0 +1,8 @@
+export { createUpdateState, updateState } from '../chunk-BTOUHSDU.mjs';
+import '../chunk-LF6DOBID.mjs';
+export { coreMutations } from '../chunk-C4BWSFWU.mjs';
+export { extendedMutations } from '../chunk-6WOZNOYJ.mjs';
+import '../chunk-OKKMFSGF.mjs';
+import '../chunk-PP7QTJDR.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/mutations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/types.d.mts

@@ -0,0 +1,140 @@
+/** 对象的唯一标识符类型 */
+type ObjectKey = string | number;
+/** 通用对象结构 */
+type KeyMap = Record<string, any>;
+/** API 响应基础结构 */
+interface BaseApiResponse<TData = any> {
+    readonly result: TData;
+    readonly extra?: any;
+    readonly total?: number;
+    readonly no_more?: boolean;
+}
+/** 核心状态字段 */
+interface DefaultField<TData = any, TExtra = any> {
+    result: TData;
+    noMore: boolean;
+    nothing: boolean;
+    loading: boolean;
+    error: Error | null;
+    extra: TExtra | null;
+    fetched: boolean;
+    page: number;
+    total: number;
+}
+type FieldKeys = keyof DefaultField;
+/** 请求参数基础约束 */
+interface RequestParams {
+    [key: string]: any;
+    __refresh__?: boolean;
+    __reload__?: boolean;
+    page?: number;
+    sinceId?: ObjectKey;
+}
+/** 数据获取策略类型 */
+type FetchType = 'jump' | 'sinceId' | 'page' | 'seenIds' | 'auto';
+/** API 契约 */
+interface ApiContract<TParams extends RequestParams, TResponse> {
+    (params: TParams): Promise<BaseApiResponse<TResponse>>;
+    readonly id: string;
+    readonly type: FetchType;
+    readonly is_up: boolean;
+    readonly uniqueKey: string;
+    readonly paramsIgnore: string[];
+}
+type FieldGetter = (key: string) => DefaultField | undefined;
+interface SetterFuncParams {
+    readonly key: string;
+    readonly type: number;
+    readonly value: Partial<DefaultField> | DefaultField;
+    readonly callback?: (obj?: any) => void;
+}
+type FieldSetter = (obj: SetterFuncParams) => void;
+interface GenerateParamsResp extends RequestParams {
+    seen_ids?: string;
+    since_id?: ObjectKey;
+    is_up?: 0 | 1;
+    page?: number;
+    extra?: any;
+}
+interface GenerateParamsType {
+    readonly field: DefaultField;
+    readonly uniqueKey?: string;
+    readonly is_up?: boolean;
+    readonly query?: KeyMap;
+    readonly type: FetchType;
+}
+type FetchResultCallback<TParams, TResponse> = (obj: {
+    params: TParams;
+    data: BaseApiResponse<TResponse>;
+    refresh: boolean;
+}) => void;
+interface SetDataType {
+    readonly getter: FieldGetter;
+    readonly setter: FieldSetter;
+    readonly data: BaseApiResponse;
+    readonly fieldName: string;
+    readonly type: FetchType;
+    readonly page: number;
+    readonly insertBefore: boolean;
+}
+interface SetErrorType {
+    readonly setter: FieldSetter;
+    readonly fieldName: string;
+    readonly error: Error | null;
+}
+interface InitStateParams<P extends RequestParams = RequestParams, R = any> {
+    readonly func: ApiContract<P, R>;
+    readonly query?: P;
+    readonly opts?: Partial<DefaultField<R>>;
+}
+interface InitDataParams<P extends RequestParams = RequestParams, R = any> {
+    readonly func: ApiContract<P, R>;
+    readonly query?: P;
+    readonly callback?: FetchResultCallback<P, R>;
+}
+interface LoadMoreParams<P extends RequestParams = RequestParams, R = any> {
+    readonly func: ApiContract<P, R>;
+    readonly query?: P;
+    readonly errorRetry?: boolean;
+    readonly callback?: FetchResultCallback<P, R>;
+}
+interface UpdateStateParams<P extends RequestParams = RequestParams, R = any> {
+    readonly func: ApiContract<P, R>;
+    readonly query?: P;
+    readonly method: string;
+    readonly value: any;
+    readonly id?: ObjectKey | ObjectKey[];
+    readonly changeKey?: string;
+    readonly uniqueKey?: string;
+}
+interface InitStateType<P extends RequestParams, R> extends InitStateParams<P, R> {
+    readonly getter: FieldGetter;
+    readonly setter: FieldSetter;
+}
+interface InitDataType<P extends RequestParams, R> extends InitDataParams<P, R> {
+    readonly getter: FieldGetter;
+    readonly setter: FieldSetter;
+}
+interface LoadMoreType<P extends RequestParams, R> extends LoadMoreParams<P, R> {
+    readonly getter: FieldGetter;
+    readonly setter: FieldSetter;
+}
+interface UpdateStateType<P extends RequestParams, R> extends UpdateStateParams<P, R> {
+    readonly getter: FieldGetter;
+    readonly setter: FieldSetter;
+}
+interface MutationContext {
+    resultArray: any[] | null;
+    newFieldData: DefaultField;
+    _id: ObjectKey | ObjectKey[] | undefined;
+    _uniqueKey: string;
+    _changeKey: string;
+    value: any;
+}
+/** mutation handler 返回值：处理后的 modifyValue 或 undefined 表示已直接修改 newFieldData */
+type MutationHandler = (ctx: MutationContext) => {
+    resolved?: unknown;
+    modifyValue?: unknown;
+} | void;
+
+export type { ApiContract, BaseApiResponse, DefaultField, FetchResultCallback, FetchType, FieldGetter, FieldKeys, FieldSetter, GenerateParamsResp, GenerateParamsType, InitDataParams, InitDataType, InitStateParams, InitStateType, KeyMap, LoadMoreParams, LoadMoreType, MutationContext, MutationHandler, ObjectKey, RequestParams, SetDataType, SetErrorType, SetterFuncParams, UpdateStateParams, UpdateStateType };