@kcuf/helper-data 0.0.1 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# CHANGELOG
+
+## 0.2.0 2024/11/05 @驳是
+
+* BREAK Removed Loading stuff
+* BREAK `timeModified` → `timeUpdated`
+* BREAK `whoCreated` → `creator`
+* BREAK `whoModified` → `updater`
+
+## 0.1.0 2024/11/05 @驳是
+
+* Revamped version

package/README.md

@@ -1,4 +1,4 @@
-# @/pkg/data-normalizer
+# @kcuf/helper-data
 
 将千奇百怪、随心所欲、虚头巴脑的后端数据中的字段、类型进行标准化的帮助类型及方法。
 

package/dist/cjs/helper/index.js

@@ -4,12 +4,6 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "createDataWithLoading", {
-  enumerable: true,
-  get: function get() {
-    return _createDataWithLoading.default;
-  }
-});
 Object.defineProperty(exports, "normalizeBoolean", {
   enumerable: true,
   get: function get() {
@@ -40,6 +34,12 @@ Object.defineProperty(exports, "normalizePagedList", {
     return _normalizePagedList.default;
   }
 });
+Object.defineProperty(exports, "normalizePagedListUncertain", {
+  enumerable: true,
+  get: function get() {
+    return _normalizePagedListUncertain.default;
+  }
+});
 Object.defineProperty(exports, "normalizeTime", {
   enumerable: true,
   get: function get() {
@@ -52,4 +52,4 @@ var _normalizeNumber = _interopRequireDefault(require("./normalize-number"));
 var _normalizeEnum = _interopRequireDefault(require("./normalize-enum"));
 var _normalizeTime = _interopRequireDefault(require("./normalize-time"));
 var _normalizePagedList = _interopRequireDefault(require("./normalize-paged-list"));
-var _createDataWithLoading = _interopRequireDefault(require("./create-data-with-loading"));
+var _normalizePagedListUncertain = _interopRequireDefault(require("./normalize-paged-list-uncertain"));

package/dist/cjs/index.js

@@ -3,19 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _exportNames = {
-  LoadingStatus: true
-};
-Object.defineProperty(exports, "LoadingStatus", {
-  enumerable: true,
-  get: function get() {
-    return _enum.ELoadingStatus;
-  }
-});
 var _helper = require("./helper");
 Object.keys(_helper).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _helper[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -23,5 +13,4 @@ Object.keys(_helper).forEach(function (key) {
       return _helper[key];
     }
   });
-});
-var _enum = require("./enum");
+});

package/dist/esm/helper/index.js

@@ -4,5 +4,5 @@ export { default as normalizeNumber } from './normalize-number';
 export { default as normalizeEnum } from './normalize-enum';
 export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
-export { default as createDataWithLoading } from './create-data-with-loading';
+export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';
 //# sourceMappingURL=index.js.map

package/dist/esm/helper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","createDataWithLoading"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\n\nexport { default as createDataWithLoading } from './create-data-with-loading';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AAEtE,SAASN,OAAO,IAAIO,qBAAqB,QAAQ,4BAA4B","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","normalizePagedListUncertain"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\nexport { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AACtE,SAASN,OAAO,IAAIO,2BAA2B,QAAQ,kCAAkC","ignoreList":[]}

package/dist/esm/index.js

@@ -1,3 +1,3 @@
 export * from './helper';
-export { ELoadingStatus as LoadingStatus } from './enum';
+export {};
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["ELoadingStatus","LoadingStatus"],"sources":["../../src/index.ts"],"sourcesContent":["export * from './helper';\n\nexport {\n  ELoadingStatus as LoadingStatus\n} from './enum';\n\nexport type {\n  IBaseParamsPage as BaseParamsPage,\n  IBaseParamsPageWithQ as BaseParamsPageWithQ,\n  \n  IBaseDataId as BaseDataId,\n  IBaseDataName as BaseDataName,\n  IBaseDataIdName as BaseDataIdName,\n  IBaseDataTitle as BaseDataTitle,\n  IBaseDataContent as BaseDataContent,\n  IBaseDataTimeCreated as BaseDataTimeCreated,\n  IBaseDataTimeModified as BaseDataTimeModified,\n  IBaseDataTimes as BaseDataTimes,\n  \n  IPagedList as PagedList,\n  IPagedListUncertain as PagedListUncertain,\n  \n  IDataWithLoading as DataWithLoading\n} from './types';\n"],"mappings":"AAAA,cAAc,UAAU;AAExB,SACEA,cAAc,IAAIC,aAAa,QAC1B,QAAQ","ignoreList":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["export * from './helper';\n\nexport type {\n  IBaseParamsPage as BaseParamsPage,\n  IBaseParamsPageWithQ as BaseParamsPageWithQ,\n  \n  IBaseDataId as BaseDataId,\n  IBaseDataName as BaseDataName,\n  IBaseDataIdName as BaseDataIdName,\n  IBaseDataTitle as BaseDataTitle,\n  IBaseDataDescription as BaseDataDescription,\n  IBaseDataContent as BaseDataContent,\n  IBaseDataTimeCreated as BaseDataTimeCreated,\n  IBaseDataTimeUpdated as BaseDataTimeModified,\n  IBaseDataTimes as BaseDataTimes,\n  IBaseDataCreator as BaseDataCreator,\n  IBaseDataUpdater as BaseDataUpdater,\n  \n  IPagedList as PagedList,\n  IPagedListUncertain as PagedListUncertain\n} from './types';\n"],"mappings":"AAAA,cAAc,UAAU;AAAC","ignoreList":[]}

package/dist/esm/types/base-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-data.js","names":[],"sources":["../../../src/types/base-data.ts"],"sourcesContent":["// 基础类型 mixin，用于继承，统一前缀 BaseData\n\n/**\n * 「ID」标准化\n */\nexport interface IBaseDataId {\n  id: string;\n}\n\n/**\n * 「名称」标准化\n */\nexport interface IBaseDataName {\n  name: string;\n}\n\n/**\n * 「标题」标准化\n */\nexport interface IBaseDataTitle {\n  title: string;\n}\n\n/**\n * 「内容」标准化\n */\nexport interface IBaseDataContent {\n  content: string;\n}\n\n/**\n * id + name\n */\nexport interface IBaseDataIdName extends IBaseDataId, IBaseDataName {}\n\n/**\n * 「创建时间」标准化\n */\nexport interface IBaseDataTimeCreated {\n  timeCreated: Date;\n}\n\n/**\n * 「更新时间」标准化\n */\nexport interface IBaseDataTimeModified {\n  timeModified: Date;\n}\n\n/**\n * timeCreated + timeModified\n */\nexport interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeModified {}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"base-data.js","names":[],"sources":["../../../src/types/base-data.ts"],"sourcesContent":["// 基础类型 mixin，用于继承，统一前缀 BaseData\n\n/**\n * 「ID」标准化\n */\nexport interface IBaseDataId {\n  id: string;\n}\n\n/**\n * 「名称」标准化\n */\nexport interface IBaseDataName {\n  name: string;\n}\n\n/**\n * 「标题」标准化\n */\nexport interface IBaseDataTitle {\n  title: string;\n}\n\n/**\n * 「内容」标准化\n */\nexport interface IBaseDataContent {\n  content: string;\n}\n\n/**\n * 「描述」标准化\n */\nexport interface IBaseDataDescription {\n  description: string;\n}\n\n/**\n * id + name\n */\nexport interface IBaseDataIdName extends IBaseDataId, IBaseDataName {}\n\n/**\n * 「创建时间」标准化\n */\nexport interface IBaseDataTimeCreated {\n  timeCreated: Date;\n}\n\n/**\n * 「更新时间」标准化\n */\nexport interface IBaseDataTimeUpdated {\n  timeUpdated: Date;\n}\n\n/**\n * timeCreated + timeUpdated\n */\nexport interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeUpdated {}\n\n/**\n * 「创建人」标准化\n */\nexport interface IBaseDataCreator {\n  creator: IBaseDataIdName;\n}\n\n/**\n * 「更新人」标准化\n */\nexport interface IBaseDataUpdater {\n  updater: IBaseDataIdName;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/esm/types/generic.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic.js","names":[],"sources":["../../../src/types/generic.ts"],"sourcesContent":["import {\n  ELoadingStatus\n} from '../enum';\n\n/**\n * 分页数据标准化\n */\nexport interface IPagedList<T> {\n  list: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\n/**\n * 某些分页接口，后端给的数据只有列表，前端需根据返回转成非确定分页列表数据\n */\nexport interface IPagedListUncertain<T> extends Omit<IPagedList<T>, 'total'> {\n  hasMore: boolean;\n}\n\nexport interface IDataWithLoading<T> {\n  loading: ELoadingStatus;\n  data: T | null | undefined;\n  error: Error | null | undefined;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"generic.js","names":[],"sources":["../../../src/types/generic.ts"],"sourcesContent":["/**\n * 分页数据标准化\n */\nexport interface IPagedList<T> {\n  list: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\n/**\n * 某些分页接口，后端给的数据只有列表，前端需根据返回转成非确定分页列表数据\n */\nexport interface IPagedListUncertain<T> extends Omit<IPagedList<T>, 'total'> {\n  hasMore: boolean;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/types/helper/index.d.ts

@@ -4,4 +4,4 @@ export { default as normalizeNumber } from './normalize-number';
 export { default as normalizeEnum } from './normalize-enum';
 export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
-export { default as createDataWithLoading } from './create-data-with-loading';
+export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';

package/dist/types/index.d.ts

@@ -1,3 +1,2 @@
 export * from './helper';
-export { ELoadingStatus as LoadingStatus } from './enum';
-export type { IBaseParamsPage as BaseParamsPage, IBaseParamsPageWithQ as BaseParamsPageWithQ, IBaseDataId as BaseDataId, IBaseDataName as BaseDataName, IBaseDataIdName as BaseDataIdName, IBaseDataTitle as BaseDataTitle, IBaseDataContent as BaseDataContent, IBaseDataTimeCreated as BaseDataTimeCreated, IBaseDataTimeModified as BaseDataTimeModified, IBaseDataTimes as BaseDataTimes, IPagedList as PagedList, IPagedListUncertain as PagedListUncertain, IDataWithLoading as DataWithLoading } from './types';
+export type { IBaseParamsPage as BaseParamsPage, IBaseParamsPageWithQ as BaseParamsPageWithQ, IBaseDataId as BaseDataId, IBaseDataName as BaseDataName, IBaseDataIdName as BaseDataIdName, IBaseDataTitle as BaseDataTitle, IBaseDataDescription as BaseDataDescription, IBaseDataContent as BaseDataContent, IBaseDataTimeCreated as BaseDataTimeCreated, IBaseDataTimeUpdated as BaseDataTimeModified, IBaseDataTimes as BaseDataTimes, IBaseDataCreator as BaseDataCreator, IBaseDataUpdater as BaseDataUpdater, IPagedList as PagedList, IPagedListUncertain as PagedListUncertain } from './types';

package/dist/types/types/base-data.d.ts

@@ -22,6 +22,12 @@ export interface IBaseDataTitle {
 export interface IBaseDataContent {
     content: string;
 }
+/**
+ * 「描述」标准化
+ */
+export interface IBaseDataDescription {
+    description: string;
+}
 /**
  * id + name
  */
@@ -36,11 +42,23 @@ export interface IBaseDataTimeCreated {
 /**
  * 「更新时间」标准化
  */
-export interface IBaseDataTimeModified {
-    timeModified: Date;
+export interface IBaseDataTimeUpdated {
+    timeUpdated: Date;
+}
+/**
+ * timeCreated + timeUpdated
+ */
+export interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeUpdated {
+}
+/**
+ * 「创建人」标准化
+ */
+export interface IBaseDataCreator {
+    creator: IBaseDataIdName;
 }
 /**
- * timeCreated + timeModified
+ * 「更新人」标准化
  */
-export interface IBaseDataTimes extends IBaseDataTimeCreated, IBaseDataTimeModified {
+export interface IBaseDataUpdater {
+    updater: IBaseDataIdName;
 }

package/dist/types/types/generic.d.ts

@@ -1,4 +1,3 @@
-import { ELoadingStatus } from '../enum';
 /**
  * 分页数据标准化
  */
@@ -14,8 +13,3 @@ export interface IPagedList<T> {
 export interface IPagedListUncertain<T> extends Omit<IPagedList<T>, 'total'> {
     hasMore: boolean;
 }
-export interface IDataWithLoading<T> {
-    loading: ELoadingStatus;
-    data: T | null | undefined;
-    error: Error | null | undefined;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kcuf/helper-data",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Data normalizer helpers and loading stuff to make all frontend data processing sane.",
   "keywords": [],
   "license": "MIT",
@@ -22,17 +22,17 @@
     "access": "public"
   },
   "devDependencies": {
-    "@babel/cli": "^7.25.9",
-    "@babel/core": "^7.26.0",
-    "@babel/plugin-transform-runtime": "^7.25.9",
-    "@babel/preset-env": "^7.26.0",
-    "@babel/preset-typescript": "^7.26.0",
+    "@babel/cli": "^7.28.3",
+    "@babel/core": "^7.28.3",
+    "@babel/plugin-transform-runtime": "^7.28.3",
+    "@babel/preset-env": "^7.28.3",
+    "@babel/preset-typescript": "^7.27.1",
     "rimraf": "^6.0.1",
-    "typescript": "^5.6.3",
+    "typescript": "^5.9.2",
     "@kcuf/ts-config": "^0.0.1"
   },
   "peerDependencies": {
-    "@babel/runtime": "^7.24.8"
+    "@babel/runtime": "^7.x"
   },
   "scripts": {
     "build:clean": "rimraf dist",

package/dist/cjs/enum/index.js

@@ -1,16 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ELoadingStatus = void 0;
-/**
- * 数据加载状态
- */
-var ELoadingStatus = exports.ELoadingStatus = /*#__PURE__*/function (ELoadingStatus) {
-  ELoadingStatus[ELoadingStatus["IDLE"] = 0] = "IDLE";
-  ELoadingStatus[ELoadingStatus["LOADING"] = 1] = "LOADING";
-  ELoadingStatus[ELoadingStatus["SUCCESS"] = 2] = "SUCCESS";
-  ELoadingStatus[ELoadingStatus["ERROR"] = 3] = "ERROR";
-  return ELoadingStatus;
-}({});

package/dist/cjs/helper/create-data-with-loading.js

@@ -1,16 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = createDataWithLoading;
-var _enum = require("../enum");
-function createDataWithLoading(data) {
-  var loading = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : _enum.ELoadingStatus.IDLE;
-  var error = arguments.length > 2 ? arguments[2] : undefined;
-  return {
-    loading: loading,
-    data: data,
-    error: error
-  };
-}

package/dist/esm/enum/index.js

@@ -1,11 +0,0 @@
-/**
- * 数据加载状态
- */
-export var ELoadingStatus = /*#__PURE__*/function (ELoadingStatus) {
-  ELoadingStatus[ELoadingStatus["IDLE"] = 0] = "IDLE";
-  ELoadingStatus[ELoadingStatus["LOADING"] = 1] = "LOADING";
-  ELoadingStatus[ELoadingStatus["SUCCESS"] = 2] = "SUCCESS";
-  ELoadingStatus[ELoadingStatus["ERROR"] = 3] = "ERROR";
-  return ELoadingStatus;
-}({});
-//# sourceMappingURL=index.js.map

package/dist/esm/enum/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["ELoadingStatus"],"sources":["../../../src/enum/index.ts"],"sourcesContent":["/**\n * 数据加载状态\n */\nexport enum ELoadingStatus {\n  IDLE,\n  LOADING,\n  SUCCESS,\n  ERROR\n}\n"],"mappings":"AAAA;AACA;AACA;AACA,WAAYA,cAAc,0BAAdA,cAAc;EAAdA,cAAc,CAAdA,cAAc;EAAdA,cAAc,CAAdA,cAAc;EAAdA,cAAc,CAAdA,cAAc;EAAdA,cAAc,CAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA","ignoreList":[]}

package/dist/esm/helper/create-data-with-loading.js

@@ -1,11 +0,0 @@
-import { ELoadingStatus } from '../enum';
-export default function createDataWithLoading(data) {
-  var loading = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ELoadingStatus.IDLE;
-  var error = arguments.length > 2 ? arguments[2] : undefined;
-  return {
-    loading: loading,
-    data: data,
-    error: error
-  };
-}
-//# sourceMappingURL=create-data-with-loading.js.map

package/dist/esm/helper/create-data-with-loading.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-data-with-loading.js","names":["ELoadingStatus","createDataWithLoading","data","loading","arguments","length","undefined","IDLE","error"],"sources":["../../../src/helper/create-data-with-loading.ts"],"sourcesContent":["import {\n  ELoadingStatus\n} from '../enum';\nimport {\n  IDataWithLoading\n} from '../types';\n\nexport default function createDataWithLoading<T>(data?: T | null, loading = ELoadingStatus.IDLE, error?: Error | null): IDataWithLoading<T> {\n  return {\n    loading,\n    data,\n    error\n  };\n}\n"],"mappings":"AAAA,SACEA,cAAc,QACT,SAAS;AAKhB,eAAe,SAASC,qBAAqBA,CAAIC,IAAe,EAA4E;EAAA,IAA1EC,OAAO,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGJ,cAAc,CAACO,IAAI;EAAA,IAAEC,KAAoB,GAAAJ,SAAA,CAAAC,MAAA,OAAAD,SAAA,MAAAE,SAAA;EACnH,OAAO;IACLH,OAAO,EAAPA,OAAO;IACPD,IAAI,EAAJA,IAAI;IACJM,KAAK,EAALA;EACF,CAAC;AACH","ignoreList":[]}

package/dist/types/enum/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * 数据加载状态
- */
-export declare enum ELoadingStatus {
-    IDLE = 0,
-    LOADING = 1,
-    SUCCESS = 2,
-    ERROR = 3
-}

package/dist/types/helper/create-data-with-loading.d.ts

@@ -1,3 +0,0 @@
-import { ELoadingStatus } from '../enum';
-import { IDataWithLoading } from '../types';
-export default function createDataWithLoading<T>(data?: T | null, loading?: ELoadingStatus, error?: Error | null): IDataWithLoading<T>;