justget 0.1.7 → 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 (74) hide show
  1. package/README.browser.md +227 -0
  2. package/README.en.md +39 -12
  3. package/README.md +43 -15
  4. package/dist/browser/core/downloader.d.ts +31 -0
  5. package/dist/browser/core/downloader.d.ts.map +1 -0
  6. package/dist/browser/core/downloader.js +332 -0
  7. package/dist/browser/core/downloader.js.map +1 -0
  8. package/dist/browser/core/http.d.ts +38 -0
  9. package/dist/browser/core/http.d.ts.map +1 -0
  10. package/dist/browser/core/http.js +106 -0
  11. package/dist/browser/core/http.js.map +1 -0
  12. package/dist/browser/index.d.ts +18 -0
  13. package/dist/browser/index.d.ts.map +1 -0
  14. package/dist/browser/index.js +16 -0
  15. package/dist/browser/index.js.map +1 -0
  16. package/dist/browser/utils/buffer.d.ts +11 -0
  17. package/dist/browser/utils/buffer.d.ts.map +1 -0
  18. package/dist/browser/utils/buffer.js +30 -0
  19. package/dist/browser/utils/buffer.js.map +1 -0
  20. package/dist/browser/utils/cache.d.ts +37 -0
  21. package/dist/browser/utils/cache.d.ts.map +1 -0
  22. package/dist/browser/utils/cache.js +102 -0
  23. package/dist/browser/utils/cache.js.map +1 -0
  24. package/dist/browser/utils/hash.d.ts +22 -0
  25. package/dist/browser/utils/hash.d.ts.map +1 -0
  26. package/dist/browser/utils/hash.js +136 -0
  27. package/dist/browser/utils/hash.js.map +1 -0
  28. package/dist/cli.d.ts +2 -9
  29. package/dist/cli.d.ts.map +1 -1
  30. package/dist/cli.js +66 -72
  31. package/dist/cli.js.map +1 -1
  32. package/dist/config.d.ts +2 -2
  33. package/dist/config.d.ts.map +1 -1
  34. package/dist/config.js +24 -21
  35. package/dist/config.js.map +1 -1
  36. package/dist/core/downloader.d.ts +18 -9
  37. package/dist/core/downloader.d.ts.map +1 -1
  38. package/dist/core/downloader.js +478 -258
  39. package/dist/core/downloader.js.map +1 -1
  40. package/dist/core/http.d.ts +19 -18
  41. package/dist/core/http.d.ts.map +1 -1
  42. package/dist/core/http.js +41 -39
  43. package/dist/core/http.js.map +1 -1
  44. package/dist/core/temp.d.ts +23 -19
  45. package/dist/core/temp.d.ts.map +1 -1
  46. package/dist/core/temp.js +29 -29
  47. package/dist/core/temp.js.map +1 -1
  48. package/dist/format.d.ts +16 -0
  49. package/dist/format.d.ts.map +1 -0
  50. package/dist/format.js +47 -0
  51. package/dist/format.js.map +1 -0
  52. package/dist/i18n.d.ts +21 -0
  53. package/dist/i18n.d.ts.map +1 -0
  54. package/dist/i18n.js +109 -0
  55. package/dist/i18n.js.map +1 -0
  56. package/dist/index.d.ts +5 -2
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +10 -7
  59. package/dist/index.js.map +1 -1
  60. package/dist/render.d.ts +85 -0
  61. package/dist/render.d.ts.map +1 -0
  62. package/dist/render.js +221 -0
  63. package/dist/render.js.map +1 -0
  64. package/dist/types.d.ts +30 -7
  65. package/dist/types.d.ts.map +1 -1
  66. package/dist/utils/hash.d.ts +13 -2
  67. package/dist/utils/hash.d.ts.map +1 -1
  68. package/dist/utils/hash.js +35 -4
  69. package/dist/utils/hash.js.map +1 -1
  70. package/package.json +15 -7
  71. package/dist/downloader.d.ts +0 -22
  72. package/dist/downloader.d.ts.map +0 -1
  73. package/dist/downloader.js +0 -564
  74. 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,17 +10,18 @@ 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
21
22
  connectTimeout: 10000, // 10 seconds
22
23
  checksumAlgorithm: 'sha256',
24
+ responseType: 'blob',
23
25
  };
24
26
  /**
25
27
  * Configuration for speed calculation
@@ -79,10 +81,10 @@ export const TEMP_FILE_CONFIG = {
79
81
  export function isImmediateFailure(error, httpStatus) {
80
82
  // Check HTTP status codes
81
83
  if (httpStatus !== undefined) {
82
- // 所有 5xx(服务器错误)一律立即失败并切换镜像 / all 5xx: immediate handover
84
+ // all 5xx: immediate handover
83
85
  if (httpStatus >= 500)
84
86
  return true;
85
- // 常见 4xx 按列表(429 限流不立即切换,重试有意义)/ listed 4xx (429 excluded)
87
+ // listed 4xx (429 excluded on purpose: retrying a rate limit makes sense)
86
88
  if (REPLACEMENT_CONFIG.immediateFailureHttp.includes(httpStatus)) {
87
89
  return true;
88
90
  }
@@ -119,44 +121,45 @@ export function mergeConfig(userConfig) {
119
121
  */
120
122
  export function validateConfig(config) {
121
123
  if (config.primaryWarmupTime !== undefined && config.primaryWarmupTime < 0) {
122
- throw new Error('primaryWarmupTime must be non-negative');
124
+ throw new Error(t('primaryWarmupTime must be non-negative'));
123
125
  }
124
126
  if (config.speedThreshold !== undefined && config.speedThreshold < 0) {
125
- throw new Error('speedThreshold must be non-negative');
127
+ throw new Error(t('speedThreshold must be non-negative'));
126
128
  }
127
129
  if (config.fastPrimaryThreshold !== undefined && config.fastPrimaryThreshold < 0) {
128
- throw new Error('fastPrimaryThreshold must be non-negative');
130
+ throw new Error(t('fastPrimaryThreshold must be non-negative'));
129
131
  }
130
132
  if (config.sizeThreshold !== undefined && config.sizeThreshold < 0) {
131
- throw new Error('sizeThreshold must be non-negative');
133
+ throw new Error(t('sizeThreshold must be non-negative'));
132
134
  }
133
135
  if (config.minReplaceTime !== undefined && config.minReplaceTime < 0) {
134
- throw new Error('minReplaceTime must be non-negative');
136
+ throw new Error(t('minReplaceTime must be non-negative'));
135
137
  }
136
138
  if (config.replaceCheckInterval !== undefined && config.replaceCheckInterval < 0) {
137
- throw new Error('replaceCheckInterval must be non-negative');
139
+ throw new Error(t('replaceCheckInterval must be non-negative'));
138
140
  }
139
141
  if (config.connectTimeout !== undefined && config.connectTimeout < 0) {
140
- throw new Error('connectTimeout must be non-negative');
142
+ throw new Error(t('connectTimeout must be non-negative'));
141
143
  }
142
144
  if (config.chunks !== undefined && typeof config.chunks === 'number' && config.chunks < 1) {
143
- throw new Error('chunks must be at least 1');
145
+ throw new Error(t('chunks must be at least 1'));
144
146
  }
145
- if (config.chunkSize !== undefined && typeof config.chunkSize === 'number' && config.chunkSize < 1) {
146
- 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'));
147
149
  }
148
- if (config.minChunkSize !== undefined && config.minChunkSize < 1) {
149
- 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)'));
150
153
  }
151
154
  if (config.retries !== undefined && config.retries < 0) {
152
- throw new Error('retries must be non-negative');
155
+ throw new Error(t('retries must be non-negative'));
153
156
  }
154
157
  if (config.timeout !== undefined && config.timeout < 0) {
155
- throw new Error('timeout must be non-negative');
158
+ throw new Error(t('timeout must be non-negative'));
156
159
  }
157
160
  if (config.checksumAlgorithm !== undefined &&
158
161
  !['md5', 'sha1', 'sha256', 'sha512'].includes(config.checksumAlgorithm)) {
159
- throw new Error(`Unsupported checksumAlgorithm: ${config.checksumAlgorithm}`);
162
+ throw new Error(`${t('Unsupported checksumAlgorithm')}: ${config.checksumAlgorithm}`);
160
163
  }
161
164
  }
162
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":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,WAAW,CAAC;AAU9B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,iBAAiB,EAAE,IAAI,EAAW,YAAY;IAC9C,cAAc,EAAE,MAAM,EAAY,0CAA0C;IAC5E,oBAAoB,EAAE,OAAO,EAAK,2CAA2C;IAC7E,aAAa,EAAE,OAAO,EAAY,OAAO;IACzC,cAAc,EAAE,KAAK,EAAa,aAAa;IAC/C,oBAAoB,EAAE,KAAK,EAAO,aAAa;IAC/C,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAK,0DAA0D;IAC5F,kBAAkB,EAAE,GAAG,EAAW,wDAAwD;IAC1F,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,MAAM,EAAmB,YAAY;IAC9C,cAAc,EAAE,KAAK,EAAa,aAAa;IAC/C,iBAAiB,EAAE,QAAQ;IAC3B,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,GAAG,EAAS,wBAAwB;IAC/C,cAAc,EAAE,IAAI,EAAG,wBAAwB;IAC/C,UAAU,EAAE,EAAE,EAAS,uBAAuB;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,GAAG,EAAM,mCAAmC;IAC/D,iBAAiB,EAAE,GAAG,EAAM,mCAAmC;IAC/D,kBAAkB,EAAE,GAAG,EAAK,qBAAqB;IACjD,aAAa,EAAE,GAAG,EAAU,4BAA4B;IACxD,cAAc,EAAE,IAAI,EAAQ,wBAAwB;IACpD,iBAAiB,EAAE,IAAI,EAAK,2BAA2B;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB,EAAE,KAAK,EAAI,qBAAqB;IACpD,aAAa,EAAE,KAAK,EAAW,yBAAyB;IACxD,kBAAkB,EAAE,IAAI,EAAO,wBAAwB;IACvD,aAAa,EAAE,CAAC,EAAe,8BAA8B;IAC7D,UAAU,EAAE,OAAO,EAAY,4BAA4B;IAC3D,qBAAqB,EAAE;QACrB,cAAc;QACd,aAAa;QACb,cAAc;QACd,WAAW;QACX,WAAW;QACX,WAAW;KACZ;IACD,oBAAoB,EAAE;QACpB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;KACvC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC,EAAiB,gCAAgC;IAC/D,eAAe,EAAE,GAAG,EAAW,4BAA4B;CAC5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,UAAmB;IAClE,0BAA0B;IAC1B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,8BAA8B;QAC9B,IAAI,UAAU,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;QACnC,0EAA0E;QAC1E,IAAI,kBAAkB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,IAAI,GAAI,KAAa,CAAC,IAAI,CAAC;IACjC,IAAI,IAAI,IAAI,kBAAkB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACtC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAA2B;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,UAAU;QACb,iCAAiC;KAClC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IACE,MAAM,CAAC,kBAAkB,KAAK,SAAS;QACvC,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,IAAI,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IACE,MAAM,CAAC,iBAAiB,KAAK,SAAS;QACtC,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,EACvE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,+BAA+B,CAAC,KAAK,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}
@@ -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"}