@ureq/lib-hash 0.0.3-alpha.0 → 0.0.3

package/README.md

@@ -0,0 +1,140 @@
+# @ureq/lib-hash
+
+哈希工具库，提供请求哈希和字符串哈希功能。
+
+## 安装
+
+```bash
+npm install @ureq/lib-hash
+# 或
+pnpm add @ureq/lib-hash
+```
+
+> 注意：通常作为 `@ureq/business` 的依赖自动安装，无需单独安装
+
+## 使用
+
+```typescript
+import { DefaultHashService } from '@ureq/lib-hash';
+
+const hashService = new DefaultHashService();
+
+// 生成请求哈希
+const requestHash = hashService.generateRequestHash(
+  'GET',
+  '/api/users',
+  null,
+  { params: { page: 1 } }
+);
+
+// 生成字符串哈希
+const strHash = hashService.hashString('some-string');
+```
+
+## API
+
+### DefaultHashService
+
+```typescript
+class DefaultHashService implements HashService {
+  generateRequestHash(
+    method: string,
+    url: string,
+    data?: any,
+    options?: RequestOptions
+  ): string;
+  
+  hashString(str: string): string;
+}
+```
+
+## 功能
+
+### generateRequestHash
+
+生成请求的唯一哈希值，用于：
+
+- 请求去重（幂等性保证）
+- 缓存键生成
+- 请求标识
+
+```typescript
+const hash1 = hashService.generateRequestHash('GET', '/users', null, { params: { page: 1 } });
+const hash2 = hashService.generateRequestHash('GET', '/users', null, { params: { page: 1 } });
+
+console.log(hash1 === hash2);  // true - 相同的请求生成相同的哈希
+```
+
+### hashString
+
+生成字符串的哈希值。
+
+```typescript
+const hash = hashService.hashString('hello world');
+console.log(hash);  // 生成的哈希值
+```
+
+## 哈希算法
+
+默认使用简单的字符串哈希算法，适用于大多数场景。如需更强的哈希算法，可以自定义实现：
+
+```typescript
+import { HashService } from '@ureq/business';
+import crypto from 'crypto';
+
+class CryptoHashService implements HashService {
+  generateRequestHash(method: string, url: string, data?: any, options?: any): string {
+    const str = JSON.stringify({ method, url, data, options });
+    return this.hashString(str);
+  }
+  
+  hashString(str: string): string {
+    return crypto.createHash('sha256').update(str).digest('hex');
+  }
+}
+```
+
+## 使用场景
+
+### 请求去重
+
+```typescript
+import { Request } from '@ureq/core';
+import { FetchRequestor } from '@ureq/impl-fetch';
+import { DefaultHashService } from '@ureq/lib-hash';
+
+const hashService = new DefaultHashService();
+
+const request = new Request(
+  new FetchRequestor(),
+  {
+    idempotent: {
+      hashService,
+      dedupeTime: 1000
+    }
+  }
+);
+```
+
+### 缓存键生成
+
+```typescript
+const request = new Request(
+  new FetchRequestor(),
+  {
+    cache: {
+      getCacheKey: (url, options) => {
+        return hashService.generateRequestHash('GET', url, null, options);
+      }
+    }
+  }
+);
+```
+
+## 文档
+
+查看完整文档：[https://sunny-117.github.io/ureq](https://sunny-117.github.io/ureq)
+
+## License
+
+MIT

package/dist/index.js

@@ -1,2 +1,26 @@
-'use strict';function i(n){let t=0;for(let r=0;r<n.length;r++){let e=n.charCodeAt(r);t=(t<<5)-t+e,t=t&t;}return t.toString(36)}function g(n,t,r,e){let s=[n.toUpperCase(),t,r?JSON.stringify(r):"",e?JSON.stringify(e):""];return i(s.join("|"))}exports.generateHash=i;exports.generateRequestHash=g;//# sourceMappingURL=index.js.map
+'use strict';
+
+// src/index.ts
+function generateHash(input) {
+  let hash = 0;
+  for (let i = 0; i < input.length; i++) {
+    const char = input.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return hash.toString(36);
+}
+function generateRequestHash(method, url, data, options) {
+  const parts = [
+    method.toUpperCase(),
+    url,
+    data ? JSON.stringify(data) : "",
+    options ? JSON.stringify(options) : ""
+  ];
+  return generateHash(parts.join("|"));
+}
+
+exports.generateHash = generateHash;
+exports.generateRequestHash = generateRequestHash;
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["generateHash","input","hash","i","char","generateRequestHash","method","url","data","options","parts"],"mappings":"aAAO,SAASA,CAAaC,CAAAA,CAAAA,CAAuB,CAClD,IAAIC,EAAO,CACX,CAAA,IAAA,IAASC,CAAI,CAAA,CAAA,CAAGA,CAAIF,CAAAA,CAAAA,CAAM,MAAQE,CAAAA,CAAAA,EAAAA,CAAK,CACrC,IAAMC,CAAAA,CAAOH,CAAM,CAAA,UAAA,CAAWE,CAAC,CAAA,CAC/BD,CAASA,CAAAA,CAAAA,CAAAA,EAAQ,GAAKA,CAAQE,CAAAA,CAAAA,CAC9BF,CAAOA,CAAAA,CAAAA,CAAOA,EAChB,CACA,OAAOA,CAAAA,CAAK,SAAS,EAAE,CACzB,CAEO,SAASG,CACdC,CAAAA,CAAAA,CACAC,CACAC,CAAAA,CAAAA,CACAC,EACQ,CACR,IAAMC,CAAQ,CAAA,CACZJ,CAAO,CAAA,WAAA,EACPC,CAAAA,CAAAA,CACAC,EAAO,IAAK,CAAA,SAAA,CAAUA,CAAI,CAAA,CAAI,EAC9BC,CAAAA,CAAAA,CAAU,IAAK,CAAA,SAAA,CAAUA,CAAO,CAAI,CAAA,EACtC,CACA,CAAA,OAAOT,CAAaU,CAAAA,CAAAA,CAAM,IAAK,CAAA,GAAG,CAAC,CACrC","file":"index.js","sourcesContent":["export function generateHash(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = ((hash << 5) - hash) + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  return hash.toString(36);\n}\n\nexport function generateRequestHash(\n  method: string,\n  url: string,\n  data?: any,\n  options?: Record<string, any>\n): string {\n  const parts = [\n    method.toUpperCase(),\n    url,\n    data ? JSON.stringify(data) : '',\n    options ? JSON.stringify(options) : ''\n  ];\n  return generateHash(parts.join('|'));\n} "]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAAO,SAAS,aAAa,KAAuB,EAAA;AAClD,EAAA,IAAI,IAAO,GAAA,CAAA;AACX,EAAA,KAAA,IAAS,CAAI,GAAA,CAAA,EAAG,CAAI,GAAA,KAAA,CAAM,QAAQ,CAAK,EAAA,EAAA;AACrC,IAAM,MAAA,IAAA,GAAO,KAAM,CAAA,UAAA,CAAW,CAAC,CAAA;AAC/B,IAAS,IAAA,GAAA,CAAA,IAAA,IAAQ,KAAK,IAAQ,GAAA,IAAA;AAC9B,IAAA,IAAA,GAAO,IAAO,GAAA,IAAA;AAAA;AAEhB,EAAO,OAAA,IAAA,CAAK,SAAS,EAAE,CAAA;AACzB;AAEO,SAAS,mBACd,CAAA,MAAA,EACA,GACA,EAAA,IAAA,EACA,OACQ,EAAA;AACR,EAAA,MAAM,KAAQ,GAAA;AAAA,IACZ,OAAO,WAAY,EAAA;AAAA,IACnB,GAAA;AAAA,IACA,IAAO,GAAA,IAAA,CAAK,SAAU,CAAA,IAAI,CAAI,GAAA,EAAA;AAAA,IAC9B,OAAU,GAAA,IAAA,CAAK,SAAU,CAAA,OAAO,CAAI,GAAA;AAAA,GACtC;AACA,EAAA,OAAO,YAAa,CAAA,KAAA,CAAM,IAAK,CAAA,GAAG,CAAC,CAAA;AACrC","file":"index.js","sourcesContent":["export function generateHash(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = ((hash << 5) - hash) + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  return hash.toString(36);\n}\n\nexport function generateRequestHash(\n  method: string,\n  url: string,\n  data?: any,\n  options?: Record<string, any>\n): string {\n  const parts = [\n    method.toUpperCase(),\n    url,\n    data ? JSON.stringify(data) : '',\n    options ? JSON.stringify(options) : ''\n  ];\n  return generateHash(parts.join('|'));\n} "]}

package/dist/index.mjs

@@ -1,2 +1,23 @@
-function i(n){let t=0;for(let r=0;r<n.length;r++){let e=n.charCodeAt(r);t=(t<<5)-t+e,t=t&t;}return t.toString(36)}function g(n,t,r,e){let s=[n.toUpperCase(),t,r?JSON.stringify(r):"",e?JSON.stringify(e):""];return i(s.join("|"))}export{i as generateHash,g as generateRequestHash};//# sourceMappingURL=index.mjs.map
+// src/index.ts
+function generateHash(input) {
+  let hash = 0;
+  for (let i = 0; i < input.length; i++) {
+    const char = input.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return hash.toString(36);
+}
+function generateRequestHash(method, url, data, options) {
+  const parts = [
+    method.toUpperCase(),
+    url,
+    data ? JSON.stringify(data) : "",
+    options ? JSON.stringify(options) : ""
+  ];
+  return generateHash(parts.join("|"));
+}
+
+export { generateHash, generateRequestHash };
+//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["generateHash","input","hash","i","char","generateRequestHash","method","url","data","options","parts"],"mappings":"AAAO,SAASA,CAAaC,CAAAA,CAAAA,CAAuB,CAClD,IAAIC,EAAO,CACX,CAAA,IAAA,IAASC,CAAI,CAAA,CAAA,CAAGA,CAAIF,CAAAA,CAAAA,CAAM,MAAQE,CAAAA,CAAAA,EAAAA,CAAK,CACrC,IAAMC,CAAAA,CAAOH,CAAM,CAAA,UAAA,CAAWE,CAAC,CAAA,CAC/BD,CAASA,CAAAA,CAAAA,CAAAA,EAAQ,GAAKA,CAAQE,CAAAA,CAAAA,CAC9BF,CAAOA,CAAAA,CAAAA,CAAOA,EAChB,CACA,OAAOA,CAAAA,CAAK,SAAS,EAAE,CACzB,CAEO,SAASG,CACdC,CAAAA,CAAAA,CACAC,CACAC,CAAAA,CAAAA,CACAC,EACQ,CACR,IAAMC,CAAQ,CAAA,CACZJ,CAAO,CAAA,WAAA,EACPC,CAAAA,CAAAA,CACAC,EAAO,IAAK,CAAA,SAAA,CAAUA,CAAI,CAAA,CAAI,EAC9BC,CAAAA,CAAAA,CAAU,IAAK,CAAA,SAAA,CAAUA,CAAO,CAAI,CAAA,EACtC,CACA,CAAA,OAAOT,CAAaU,CAAAA,CAAAA,CAAM,IAAK,CAAA,GAAG,CAAC,CACrC","file":"index.mjs","sourcesContent":["export function generateHash(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = ((hash << 5) - hash) + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  return hash.toString(36);\n}\n\nexport function generateRequestHash(\n  method: string,\n  url: string,\n  data?: any,\n  options?: Record<string, any>\n): string {\n  const parts = [\n    method.toUpperCase(),\n    url,\n    data ? JSON.stringify(data) : '',\n    options ? JSON.stringify(options) : ''\n  ];\n  return generateHash(parts.join('|'));\n} "]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAAO,SAAS,aAAa,KAAuB,EAAA;AAClD,EAAA,IAAI,IAAO,GAAA,CAAA;AACX,EAAA,KAAA,IAAS,CAAI,GAAA,CAAA,EAAG,CAAI,GAAA,KAAA,CAAM,QAAQ,CAAK,EAAA,EAAA;AACrC,IAAM,MAAA,IAAA,GAAO,KAAM,CAAA,UAAA,CAAW,CAAC,CAAA;AAC/B,IAAS,IAAA,GAAA,CAAA,IAAA,IAAQ,KAAK,IAAQ,GAAA,IAAA;AAC9B,IAAA,IAAA,GAAO,IAAO,GAAA,IAAA;AAAA;AAEhB,EAAO,OAAA,IAAA,CAAK,SAAS,EAAE,CAAA;AACzB;AAEO,SAAS,mBACd,CAAA,MAAA,EACA,GACA,EAAA,IAAA,EACA,OACQ,EAAA;AACR,EAAA,MAAM,KAAQ,GAAA;AAAA,IACZ,OAAO,WAAY,EAAA;AAAA,IACnB,GAAA;AAAA,IACA,IAAO,GAAA,IAAA,CAAK,SAAU,CAAA,IAAI,CAAI,GAAA,EAAA;AAAA,IAC9B,OAAU,GAAA,IAAA,CAAK,SAAU,CAAA,OAAO,CAAI,GAAA;AAAA,GACtC;AACA,EAAA,OAAO,YAAa,CAAA,KAAA,CAAM,IAAK,CAAA,GAAG,CAAC,CAAA;AACrC","file":"index.mjs","sourcesContent":["export function generateHash(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    const char = input.charCodeAt(i);\n    hash = ((hash << 5) - hash) + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  return hash.toString(36);\n}\n\nexport function generateRequestHash(\n  method: string,\n  url: string,\n  data?: any,\n  options?: Record<string, any>\n): string {\n  const parts = [\n    method.toUpperCase(),\n    url,\n    data ? JSON.stringify(data) : '',\n    options ? JSON.stringify(options) : ''\n  ];\n  return generateHash(parts.join('|'));\n} "]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ureq/lib-hash",
-  "version": "0.0.3-alpha.0",
+  "version": "0.0.3",
   "description": "Hash utilities for universal request library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",