justget 0.2.4 → 0.2.5

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.
Files changed (72) hide show
  1. package/README.browser.md +1 -1
  2. package/README.en.md +13 -11
  3. package/README.md +16 -13
  4. package/dist/browser/core/downloader.d.ts +11 -11
  5. package/dist/browser/core/downloader.d.ts.map +1 -1
  6. package/dist/browser/core/downloader.js +28 -27
  7. package/dist/browser/core/downloader.js.map +1 -1
  8. package/dist/browser/core/http.d.ts +13 -13
  9. package/dist/browser/core/http.d.ts.map +1 -1
  10. package/dist/browser/core/http.js +8 -8
  11. package/dist/browser/core/http.js.map +1 -1
  12. package/dist/browser/index.d.ts +2 -2
  13. package/dist/browser/index.js +2 -2
  14. package/dist/browser/utils/buffer.d.ts +4 -4
  15. package/dist/browser/utils/buffer.d.ts.map +1 -1
  16. package/dist/browser/utils/buffer.js +4 -4
  17. package/dist/browser/utils/buffer.js.map +1 -1
  18. package/dist/browser/utils/cache.d.ts +12 -11
  19. package/dist/browser/utils/cache.d.ts.map +1 -1
  20. package/dist/browser/utils/cache.js +14 -13
  21. package/dist/browser/utils/cache.js.map +1 -1
  22. package/dist/browser/utils/hash.d.ts +10 -11
  23. package/dist/browser/utils/hash.d.ts.map +1 -1
  24. package/dist/browser/utils/hash.js +20 -20
  25. package/dist/browser/utils/hash.js.map +1 -1
  26. package/dist/cli.d.ts +2 -9
  27. package/dist/cli.d.ts.map +1 -1
  28. package/dist/cli.js +66 -72
  29. package/dist/cli.js.map +1 -1
  30. package/dist/config.d.ts +2 -2
  31. package/dist/config.d.ts.map +1 -1
  32. package/dist/config.js +23 -21
  33. package/dist/config.js.map +1 -1
  34. package/dist/core/downloader.d.ts +18 -9
  35. package/dist/core/downloader.d.ts.map +1 -1
  36. package/dist/core/downloader.js +478 -258
  37. package/dist/core/downloader.js.map +1 -1
  38. package/dist/core/http.d.ts +19 -18
  39. package/dist/core/http.d.ts.map +1 -1
  40. package/dist/core/http.js +41 -39
  41. package/dist/core/http.js.map +1 -1
  42. package/dist/core/temp.d.ts +23 -19
  43. package/dist/core/temp.d.ts.map +1 -1
  44. package/dist/core/temp.js +29 -29
  45. package/dist/core/temp.js.map +1 -1
  46. package/dist/format.d.ts +16 -0
  47. package/dist/format.d.ts.map +1 -0
  48. package/dist/format.js +47 -0
  49. package/dist/format.js.map +1 -0
  50. package/dist/i18n.d.ts +21 -0
  51. package/dist/i18n.d.ts.map +1 -0
  52. package/dist/i18n.js +109 -0
  53. package/dist/i18n.js.map +1 -0
  54. package/dist/index.d.ts +5 -2
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +10 -7
  57. package/dist/index.js.map +1 -1
  58. package/dist/render.d.ts +85 -0
  59. package/dist/render.d.ts.map +1 -0
  60. package/dist/render.js +221 -0
  61. package/dist/render.js.map +1 -0
  62. package/dist/types.d.ts +22 -5
  63. package/dist/types.d.ts.map +1 -1
  64. package/dist/utils/hash.d.ts +13 -2
  65. package/dist/utils/hash.d.ts.map +1 -1
  66. package/dist/utils/hash.js +35 -4
  67. package/dist/utils/hash.js.map +1 -1
  68. package/package.json +4 -3
  69. package/dist/downloader.d.ts +0 -22
  70. package/dist/downloader.d.ts.map +0 -1
  71. package/dist/downloader.js +0 -564
  72. package/dist/downloader.js.map +0 -1
package/dist/config.js CHANGED
@@ -1,7 +1,8 @@
1
1
  /**
2
- * JustGet 默认配置
2
+ * JustGet default configuration
3
3
  * Default configuration for JustGet downloader
4
4
  */
5
+ import { t } from './i18n.js';
5
6
  /**
6
7
  * Default download configuration
7
8
  */
@@ -9,12 +10,12 @@ export const DEFAULT_CONFIG = {
9
10
  primaryWarmupTime: 5000, // 5 seconds
10
11
  speedThreshold: 512000, // 500 KB/s (below this, consider mirrors)
11
12
  fastPrimaryThreshold: 2048000, // 2 MB/s (above this, don't start mirrors)
12
- sizeThreshold: 52428800, // 50 MB
13
+ sizeThreshold: 1048576, // 1 MB
13
14
  minReplaceTime: 30000, // 30 seconds
14
15
  replaceCheckInterval: 10000, // 10 seconds
15
16
  chunks: 'auto',
16
- chunkSize: 'auto',
17
- minChunkSize: 1048576, // 1 MB
17
+ minSliceSize: 4 * 1024 * 1024, // 4 MB: min lease slice size, also the takeover threshold
18
+ overtakeSpeedRatio: 0.5, // overtake when the other is slower than half our speed
18
19
  retries: 3,
19
20
  retryDelay: 2000,
20
21
  timeout: 300000, // 5 minutes
@@ -80,10 +81,10 @@ export const TEMP_FILE_CONFIG = {
80
81
  export function isImmediateFailure(error, httpStatus) {
81
82
  // Check HTTP status codes
82
83
  if (httpStatus !== undefined) {
83
- // 所有 5xx(服务器错误)一律立即失败并切换镜像 / all 5xx: immediate handover
84
+ // all 5xx: immediate handover
84
85
  if (httpStatus >= 500)
85
86
  return true;
86
- // 常见 4xx 按列表(429 限流不立即切换,重试有意义)/ listed 4xx (429 excluded)
87
+ // listed 4xx (429 excluded on purpose: retrying a rate limit makes sense)
87
88
  if (REPLACEMENT_CONFIG.immediateFailureHttp.includes(httpStatus)) {
88
89
  return true;
89
90
  }
@@ -120,44 +121,45 @@ export function mergeConfig(userConfig) {
120
121
  */
121
122
  export function validateConfig(config) {
122
123
  if (config.primaryWarmupTime !== undefined && config.primaryWarmupTime < 0) {
123
- throw new Error('primaryWarmupTime must be non-negative');
124
+ throw new Error(t('primaryWarmupTime must be non-negative'));
124
125
  }
125
126
  if (config.speedThreshold !== undefined && config.speedThreshold < 0) {
126
- throw new Error('speedThreshold must be non-negative');
127
+ throw new Error(t('speedThreshold must be non-negative'));
127
128
  }
128
129
  if (config.fastPrimaryThreshold !== undefined && config.fastPrimaryThreshold < 0) {
129
- throw new Error('fastPrimaryThreshold must be non-negative');
130
+ throw new Error(t('fastPrimaryThreshold must be non-negative'));
130
131
  }
131
132
  if (config.sizeThreshold !== undefined && config.sizeThreshold < 0) {
132
- throw new Error('sizeThreshold must be non-negative');
133
+ throw new Error(t('sizeThreshold must be non-negative'));
133
134
  }
134
135
  if (config.minReplaceTime !== undefined && config.minReplaceTime < 0) {
135
- throw new Error('minReplaceTime must be non-negative');
136
+ throw new Error(t('minReplaceTime must be non-negative'));
136
137
  }
137
138
  if (config.replaceCheckInterval !== undefined && config.replaceCheckInterval < 0) {
138
- throw new Error('replaceCheckInterval must be non-negative');
139
+ throw new Error(t('replaceCheckInterval must be non-negative'));
139
140
  }
140
141
  if (config.connectTimeout !== undefined && config.connectTimeout < 0) {
141
- throw new Error('connectTimeout must be non-negative');
142
+ throw new Error(t('connectTimeout must be non-negative'));
142
143
  }
143
144
  if (config.chunks !== undefined && typeof config.chunks === 'number' && config.chunks < 1) {
144
- throw new Error('chunks must be at least 1');
145
+ throw new Error(t('chunks must be at least 1'));
145
146
  }
146
- if (config.chunkSize !== undefined && typeof config.chunkSize === 'number' && config.chunkSize < 1) {
147
- throw new Error('chunkSize must be at least 1');
147
+ if (config.minSliceSize !== undefined && config.minSliceSize < 1) {
148
+ throw new Error(t('minSliceSize must be at least 1'));
148
149
  }
149
- if (config.minChunkSize !== undefined && config.minChunkSize < 1) {
150
- throw new Error('minChunkSize must be at least 1');
150
+ if (config.overtakeSpeedRatio !== undefined &&
151
+ (config.overtakeSpeedRatio <= 0 || config.overtakeSpeedRatio >= 1)) {
152
+ throw new Error(t('overtakeSpeedRatio must be in (0, 1)'));
151
153
  }
152
154
  if (config.retries !== undefined && config.retries < 0) {
153
- throw new Error('retries must be non-negative');
155
+ throw new Error(t('retries must be non-negative'));
154
156
  }
155
157
  if (config.timeout !== undefined && config.timeout < 0) {
156
- throw new Error('timeout must be non-negative');
158
+ throw new Error(t('timeout must be non-negative'));
157
159
  }
158
160
  if (config.checksumAlgorithm !== undefined &&
159
161
  !['md5', 'sha1', 'sha256', 'sha512'].includes(config.checksumAlgorithm)) {
160
- throw new Error(`Unsupported checksumAlgorithm: ${config.checksumAlgorithm}`);
162
+ throw new Error(`${t('Unsupported checksumAlgorithm')}: ${config.checksumAlgorithm}`);
161
163
  }
162
164
  }
163
165
  //# sourceMappingURL=config.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -1,22 +1,31 @@
1
1
  /**
2
- * 核心下载器:多源竞速分块下载
3
- * Core downloader: multi-source racing chunked download
2
+ * Core downloader: multi-source racing with lease-based dynamic range splitting
4
3
  *
5
- * 流程 / Flow:
6
- * 探测(probe) → 分块(chunks) → 主源预热(warmup) → 决策(decide mirrors)
7
- * → 竞速(race) → 慢源替换(replace) → 合并(merge) → 校验(verify) → 提交(commit)
4
+ * Strategy (see docs/plans/2026-09-16-lease-download-strategy.md):
5
+ * - The primary issues one Range request for the whole file (a single lease [0, total))
6
+ * - When a mirror joins, the second half of the slowest-ETA lease's remaining range
7
+ * is carved out for it
8
+ * - When a lease completes: 1) overtake a slow right neighbor that has written
9
+ * little; 2) otherwise take a free lease and resume from its cursor (zero waste);
10
+ * 3) otherwise idle (never exit) until every lease is done
11
+ * - Slow-source replacement: abort -> lease goes to the free pool (partial file
12
+ * kept) -> the fastest source seamlessly takes over and resumes
13
+ * - Servers without Range support: whole-file racing (single-stream), first wins
14
+ *
15
+ * probe -> initial lease -> warmup -> decide mirrors -> split/takeover
16
+ * -> replace -> merge -> verify -> commit
8
17
  */
9
18
  import type { DownloadOptions, DownloadResult } from '../types.js';
10
19
  /**
11
- * 多源竞速分块下载
12
- * Multi-source racing chunked download
20
+ * Multi-source racing lease-based download
21
+ * Multi-source racing lease-based download
13
22
  */
14
23
  export declare function download(options: DownloadOptions): Promise<DownloadResult>;
15
- /** 下载器类(download() 的面向对象封装)/ OO wrapper over download() */
24
+ /** OO wrapper over download() */
16
25
  export declare class Downloader {
17
26
  private options;
18
27
  constructor(options: DownloadOptions);
19
- /** 开始下载 / start download */
28
+ /** start download */
20
29
  start(): Promise<DownloadResult>;
21
30
  }
22
31
  //# sourceMappingURL=downloader.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../src/core/downloader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6BH,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAKf,MAAM,aAAa,CAAC;AAgDrB;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAahF;AAmgBD,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAIpC,4BAA4B;IAC5B,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;CAGjC"}
1
+ {"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../src/core/downloader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAKf,MAAM,aAAa,CAAC;AAyFrB;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAmBhF;AAyrBD,iCAAiC;AACjC,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAIpC,qBAAqB;IACrB,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;CAGjC"}