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
@@ -0,0 +1,332 @@
1
+ /**
2
+ * Core downloader (browser): whole-file racing + mirror learning cache, in-memory
3
+ * Browser downloader: full-file racing + learning cache, in-memory
4
+ *
5
+ * Design notes:
6
+ * 1. No Range chunking; whole-file downloads are browser-cache friendly
7
+ * 2. Primary starts first; if slow after warmup, mirrors are released one by one
8
+ * 3. First to finish wins; the rest are aborted
9
+ * 4. Fully in-memory storage (Uint8Array[]), no temp files
10
+ * 5. Checksum validation via the Web Crypto API
11
+ * 6. Learning cache (localStorage): remembers which mirror succeeded and promotes it next time
12
+ */
13
+ import { mergeConfig, validateConfig, isImmediateFailure, REPLACEMENT_CONFIG } from '../../config.js';
14
+ import { SpeedMonitor } from '../../speed/speed-monitor.js';
15
+ import { openStream, consumeBody } from './http.js';
16
+ import { concatBuffers } from '../utils/buffer.js';
17
+ import { digest } from '../utils/hash.js';
18
+ import { prioritizeMirrors, recordSuccess } from '../utils/cache.js';
19
+ function sleep(ms) {
20
+ return new Promise((resolve) => setTimeout(resolve, ms));
21
+ }
22
+ /** Checksum mismatch: recoverable error (drop the winner and re-race) */
23
+ export class ChecksumMismatchError extends Error {
24
+ expected;
25
+ actual;
26
+ badUrl;
27
+ constructor(expected, actual, badUrl) {
28
+ super(`Checksum mismatch: expected ${expected}, got ${actual}`);
29
+ this.expected = expected;
30
+ this.actual = actual;
31
+ this.badUrl = badUrl;
32
+ this.name = 'ChecksumMismatchError';
33
+ }
34
+ }
35
+ /**
36
+ * Multi-source whole-file racing (browser).
37
+ * Primary -> mirrors released one by one when slow -> first to finish wins.
38
+ */
39
+ export async function download(options) {
40
+ const startedAt = Date.now();
41
+ const { url, mirrors = [] } = options;
42
+ if (!url)
43
+ throw new Error('url is required');
44
+ const cfg = mergeConfig(options.options);
45
+ validateConfig(cfg);
46
+ // Checksum failure -> drop the winning source and re-race until the checksum
47
+ // passes or sources are exhausted (degrades within this call only; the mirror
48
+ // list is caller intent, the library never silently drops sources)
49
+ let candidates = [url, ...mirrors];
50
+ let lastMismatch;
51
+ let result;
52
+ for (;;) {
53
+ if (candidates.length === 0) {
54
+ throw lastMismatch ?? new Error('Download failed: no source could complete');
55
+ }
56
+ try {
57
+ result = await runDownload(candidates[0], candidates.slice(1), cfg, options.url);
58
+ break;
59
+ }
60
+ catch (err) {
61
+ if (err instanceof ChecksumMismatchError) {
62
+ candidates = candidates.filter((u) => u !== err.badUrl);
63
+ lastMismatch = err;
64
+ continue;
65
+ }
66
+ throw err;
67
+ }
68
+ }
69
+ const final = { ...result, duration: Date.now() - startedAt };
70
+ if (cfg.onComplete)
71
+ cfg.onComplete(final);
72
+ return final;
73
+ }
74
+ async function runDownload(url, mirrors, cfg, resourceUrl) {
75
+ const startedAt = Date.now();
76
+ // 0) learning cache: promote a previously successful mirror to primary
77
+ const reordered = prioritizeMirrors(url, mirrors, resourceUrl);
78
+ url = reordered.primaryUrl;
79
+ mirrors = reordered.mirrors;
80
+ // 1) HEAD probe (file size + Content-Type)
81
+ let contentLength;
82
+ let mimeType = 'application/octet-stream';
83
+ try {
84
+ const headRes = await fetch(url, { method: 'HEAD', redirect: 'follow' });
85
+ if (headRes.ok) {
86
+ const cl = headRes.headers.get('content-length');
87
+ if (cl)
88
+ contentLength = Number(cl);
89
+ const ct = headRes.headers.get('content-type');
90
+ if (ct)
91
+ mimeType = ct.split(';')[0].trim();
92
+ }
93
+ }
94
+ catch { /* GET still works */ }
95
+ const ctx = {
96
+ contentLength,
97
+ workers: [],
98
+ cfg,
99
+ done: false,
100
+ mirrorsStartedCount: 0,
101
+ primaryFailedImmediately: false,
102
+ winner: null,
103
+ overallStartedAt: startedAt,
104
+ };
105
+ const emitProgress = () => {
106
+ if (!cfg.onProgress)
107
+ return;
108
+ const sources = ctx.workers.map((w) => ({
109
+ id: w.id, url: w.url,
110
+ downloadedBytes: w.bytesWritten,
111
+ speed: w.monitor.getCurrentSpeed(),
112
+ status: w.status,
113
+ }));
114
+ const downloadedBytes = ctx.winner
115
+ ? ctx.winner.chunks.reduce((s, c) => s + c.byteLength, 0)
116
+ : ctx.workers.reduce((sum, w) => sum + w.bytesWritten, 0);
117
+ const total = contentLength ?? downloadedBytes;
118
+ const instant = ctx.workers.reduce((sum, w) => sum + w.monitor.getCurrentSpeed(), 0);
119
+ const elapsedMs = Math.max(1, Date.now() - startedAt);
120
+ const speed = instant > 0 ? instant : downloadedBytes > 0 ? (downloadedBytes / elapsedMs) * 1000 : 0;
121
+ cfg.onProgress({
122
+ downloadedBytes, totalBytes: total,
123
+ percentage: total > 0 ? (downloadedBytes / total) * 100 : 0,
124
+ speed, eta: speed > 0 ? ((total - downloadedBytes) / speed) * 1000 : 0,
125
+ sources,
126
+ });
127
+ };
128
+ // 2) mirror-start decision: release one at a time
129
+ const needMoreMirrors = () => {
130
+ if (mirrors.length === 0)
131
+ return false;
132
+ if (ctx.mirrorsStartedCount >= mirrors.length)
133
+ return false;
134
+ const active = ctx.workers.filter((w) => w.status === 'active' && !w.aborted);
135
+ if (active.length === 0)
136
+ return true;
137
+ const fastest = active.reduce((a, b) => a.monitor.getCurrentSpeed() > b.monitor.getCurrentSpeed() ? a : b);
138
+ const fastestSpeed = fastest.monitor.getCurrentSpeed();
139
+ if (fastestSpeed >= (cfg.fastPrimaryThreshold ?? 2_048_000))
140
+ return false;
141
+ const size = contentLength ?? 0;
142
+ if (size < (cfg.sizeThreshold ?? 1024 * 1024))
143
+ return false;
144
+ if (fastestSpeed < (cfg.speedThreshold ?? 512_000))
145
+ return true;
146
+ return false;
147
+ };
148
+ const startNextMirror = () => {
149
+ const nextIndex = ctx.mirrorsStartedCount++;
150
+ if (nextIndex >= mirrors.length)
151
+ return;
152
+ const w = {
153
+ id: `mirror-${nextIndex}`,
154
+ url: mirrors[nextIndex],
155
+ isPrimary: false,
156
+ monitor: new SpeedMonitor(),
157
+ controller: new AbortController(),
158
+ aborted: false, slowChecks: 0, bytesWritten: 0,
159
+ startedAt: Date.now(), status: 'active', chunks: [],
160
+ };
161
+ startWorker(w);
162
+ };
163
+ const maybeStartMirrors = () => {
164
+ if (ctx.done || mirrors.length === 0)
165
+ return;
166
+ if (ctx.primaryFailedImmediately) {
167
+ while (ctx.mirrorsStartedCount < mirrors.length && !ctx.done)
168
+ startNextMirror();
169
+ return;
170
+ }
171
+ if (needMoreMirrors())
172
+ startNextMirror();
173
+ };
174
+ const startWorker = (w) => {
175
+ ctx.workers.push(w);
176
+ w.monitor.startSampling(() => w.bytesWritten);
177
+ void runWorker(w, ctx, emitProgress).catch((err) => {
178
+ w.error = err;
179
+ w.status = 'failed';
180
+ ctx.lastError = ctx.lastError ?? err;
181
+ if (w.isPrimary && isImmediateFailure(err, err.status)) {
182
+ ctx.primaryFailedImmediately = true;
183
+ maybeStartMirrors();
184
+ }
185
+ });
186
+ };
187
+ // 3) start the primary
188
+ const primaryWorker = {
189
+ id: 'primary', url, isPrimary: true,
190
+ monitor: new SpeedMonitor(), controller: new AbortController(),
191
+ aborted: false, slowChecks: 0, bytesWritten: 0,
192
+ startedAt: Date.now(), status: 'active', chunks: [],
193
+ };
194
+ startWorker(primaryWorker);
195
+ // 4) decide after warmup
196
+ const warmupTimer = setTimeout(() => maybeStartMirrors(), cfg.primaryWarmupTime ?? 5000);
197
+ // 5) periodic check: slow-source replacement + staged mirror release
198
+ const replaceCheck = setInterval(() => {
199
+ if (ctx.done)
200
+ return;
201
+ maybeStartMirrors();
202
+ const active = ctx.workers.filter((w) => w.status === 'active' && !w.aborted);
203
+ if (active.length < 2)
204
+ return;
205
+ if (Date.now() - startedAt < (cfg.minReplaceTime ?? 30_000))
206
+ return;
207
+ const fastest = active.reduce((a, b) => a.monitor.getCurrentSpeed() > b.monitor.getCurrentSpeed() ? a : b);
208
+ const fastestSpeed = fastest.monitor.getCurrentSpeed();
209
+ if (fastestSpeed <= 0)
210
+ return;
211
+ for (const w of active) {
212
+ if (w === fastest)
213
+ continue;
214
+ const ratio = w.monitor.getCurrentSpeed() / fastestSpeed;
215
+ if (ratio < REPLACEMENT_CONFIG.slowThresholdRatio) {
216
+ if (++w.slowChecks >= REPLACEMENT_CONFIG.maxSlowChecks) {
217
+ w.aborted = true;
218
+ w.status = 'failed';
219
+ w.controller.abort();
220
+ emitProgress();
221
+ }
222
+ }
223
+ else
224
+ w.slowChecks = 0;
225
+ }
226
+ }, cfg.replaceCheckInterval ?? 10_000);
227
+ // 6) progress callback
228
+ const progressTimer = setInterval(emitProgress, 200);
229
+ try {
230
+ await waitForCompletion(ctx, cfg);
231
+ if (!ctx.done || !ctx.winner) {
232
+ throw ctx.lastError ?? new Error('Download failed: no source could complete');
233
+ }
234
+ for (const w of ctx.workers) {
235
+ if (w.status === 'active')
236
+ w.status = 'completed';
237
+ }
238
+ const data = concatBuffers(ctx.winner.chunks);
239
+ // Verify checksum: mismatch throws ChecksumMismatchError; download() drops the winner and re-races
240
+ if (cfg.checksum) {
241
+ const algorithm = cfg.checksumAlgorithm ?? 'sha256';
242
+ const actual = await digest(data, algorithm);
243
+ if (actual !== cfg.checksum.toLowerCase()) {
244
+ throw new ChecksumMismatchError(cfg.checksum.toLowerCase(), actual, ctx.winner.url);
245
+ }
246
+ }
247
+ // Record the successful source in the cache (preferred next time)
248
+ if (ctx.winner.url !== resourceUrl) {
249
+ recordSuccess(resourceUrl, ctx.winner.url);
250
+ }
251
+ const finalData = cfg.responseType === 'uint8array'
252
+ ? data
253
+ : new Blob([data], { type: mimeType });
254
+ const finalSize = contentLength ?? data.byteLength;
255
+ return summarize(finalData, finalSize, mimeType, ctx.workers, startedAt);
256
+ }
257
+ finally {
258
+ clearTimeout(warmupTimer);
259
+ clearInterval(replaceCheck);
260
+ clearInterval(progressTimer);
261
+ for (const w of ctx.workers) {
262
+ w.controller.abort();
263
+ w.monitor.stopSampling();
264
+ }
265
+ }
266
+ }
267
+ /** Overall watchdog: default timeout x3 (racing plus replacements take time; a
268
+ * single-source timeout is a poor total bound; x3 is an empirical margin) */
269
+ async function waitForCompletion(ctx, cfg) {
270
+ const overall = (cfg.timeout ?? 300_000) * 3;
271
+ const deadline = Date.now() + overall;
272
+ while (Date.now() < deadline) {
273
+ if (ctx.done)
274
+ return;
275
+ if (!ctx.workers.some((w) => w.status === 'active' && !w.aborted) && ctx.workers.length > 0) {
276
+ throw ctx.lastError ?? new Error('All sources failed');
277
+ }
278
+ await sleep(100);
279
+ }
280
+ throw new Error(`Download timeout (${overall}ms = timeout×3)`);
281
+ }
282
+ async function runWorker(w, ctx, emit) {
283
+ const stream = await openStream(w.url, {
284
+ connectTimeout: ctx.cfg.connectTimeout,
285
+ timeout: ctx.cfg.timeout,
286
+ signal: w.controller.signal,
287
+ });
288
+ try {
289
+ await consumeBody(stream.body, (chunk) => {
290
+ if (w.aborted)
291
+ throw new Error('Aborted');
292
+ w.chunks.push(chunk);
293
+ w.bytesWritten += chunk.byteLength;
294
+ }, w.controller.signal);
295
+ }
296
+ finally {
297
+ stream.cleanup(); // clear bodyTimer even on natural completion or the watchdog leaks
298
+ }
299
+ if (!ctx.done) {
300
+ ctx.done = true;
301
+ ctx.winner = { chunks: w.chunks, mimeType: '', url: w.url };
302
+ w.status = 'completed';
303
+ for (const other of ctx.workers) {
304
+ if (other !== w && !other.aborted) {
305
+ other.aborted = true;
306
+ other.status = 'failed';
307
+ other.controller.abort();
308
+ }
309
+ }
310
+ emit();
311
+ }
312
+ }
313
+ function summarize(data, bytes, mimeType, workers, startedAt) {
314
+ const sources = workers.map((w) => ({
315
+ id: w.id, url: w.url, bytes: w.bytesWritten,
316
+ duration: Date.now() - w.startedAt,
317
+ averageSpeed: (w.bytesWritten / Math.max(1, Date.now() - w.startedAt)) * 1000,
318
+ status: w.status,
319
+ }));
320
+ const duration = Date.now() - startedAt;
321
+ return {
322
+ data, bytes, duration,
323
+ averageSpeed: duration > 0 ? (bytes / duration) * 1000 : 0,
324
+ sources, mimeType,
325
+ };
326
+ }
327
+ export class Downloader {
328
+ options;
329
+ constructor(options) { this.options = options; }
330
+ start() { return download(this.options); }
331
+ }
332
+ //# sourceMappingURL=downloader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"downloader.js","sourceRoot":"","sources":["../../../src/browser/core/downloader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * HTTP layer: thin wrapper over the browser fetch API
3
+ * Browser-native fetch wrapper
4
+ *
5
+ * Whole-file downloads (no Range chunking), browser-cache friendly.
6
+ * Racing cancellation via AbortController.
7
+ */
8
+ import type { RangeCheckResult } from '../../types.js';
9
+ /** Common options for download/probe */
10
+ export interface HttpOptions {
11
+ connectTimeout?: number;
12
+ timeout?: number;
13
+ signal?: AbortSignal;
14
+ }
15
+ /** An opened response stream */
16
+ export interface OpenedStream {
17
+ status: number;
18
+ contentLength?: number;
19
+ body: ReadableStream<Uint8Array>;
20
+ /** Cancel/abort the download (includes cleanup) */
21
+ cancel: () => void;
22
+ /** Release resources (bodyTimer/listeners) — must be called even after a
23
+ * natural completion, or the watchdog timer keeps the page alive */
24
+ cleanup: () => void;
25
+ }
26
+ /** Probe a source: file size (HEAD only). Unused by the main download flow
27
+ * (kept for callers doing manual probing); supportsRange is always false here
28
+ * because the browser edition does not chunk. */
29
+ export declare function probe(url: string, options?: HttpOptions): Promise<RangeCheckResult>;
30
+ /** Open a whole-file download stream */
31
+ export declare function openStream(url: string, options?: HttpOptions): Promise<OpenedStream>;
32
+ /** Read the body chunk by chunk */
33
+ export declare function consumeBody(body: ReadableStream<Uint8Array>, onChunk: (chunk: Uint8Array) => void | Promise<void>, signal?: AbortSignal): Promise<void>;
34
+ export declare class HttpError extends Error {
35
+ readonly status: number;
36
+ constructor(status: number, url: string);
37
+ }
38
+ //# sourceMappingURL=http.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/browser/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACjC,mDAAmD;IACnD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;wEACoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;iDAEiD;AACjD,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAED,wCAAwC;AACxC,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED,mCAAmC;AACnC,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACpD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,qBAAa,SAAU,SAAQ,KAAK;aACN,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAIxD"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * HTTP layer: thin wrapper over the browser fetch API
3
+ * Browser-native fetch wrapper
4
+ *
5
+ * Whole-file downloads (no Range chunking), browser-cache friendly.
6
+ * Racing cancellation via AbortController.
7
+ */
8
+ /** Probe a source: file size (HEAD only). Unused by the main download flow
9
+ * (kept for callers doing manual probing); supportsRange is always false here
10
+ * because the browser edition does not chunk. */
11
+ export async function probe(url, options = {}) {
12
+ const timeout = options.connectTimeout ?? 10_000;
13
+ const controller = new AbortController();
14
+ const timer = setTimeout(() => controller.abort(), timeout);
15
+ try {
16
+ const res = await fetch(url, { method: 'HEAD', redirect: 'follow', signal: controller.signal });
17
+ if (res.status >= 400)
18
+ return { supportsRange: false };
19
+ const contentLength = parseContentLength(res.headers.get('content-length'));
20
+ return { supportsRange: false, contentLength };
21
+ }
22
+ catch {
23
+ return { supportsRange: false };
24
+ }
25
+ finally {
26
+ clearTimeout(timer);
27
+ }
28
+ }
29
+ /** Open a whole-file download stream */
30
+ export async function openStream(url, options = {}) {
31
+ const connectTimeout = options.connectTimeout ?? 10_000;
32
+ const overallTimeout = options.timeout ?? 300_000;
33
+ const connectController = new AbortController();
34
+ const connectTimer = setTimeout(() => connectController.abort(), connectTimeout);
35
+ try {
36
+ const res = await fetch(url, { redirect: 'follow', signal: connectController.signal });
37
+ if (res.status >= 400) {
38
+ res.body?.getReader().cancel();
39
+ throw new HttpError(res.status, url);
40
+ }
41
+ const bodyController = new AbortController();
42
+ const bodyTimer = setTimeout(() => bodyController.abort(), overallTimeout);
43
+ const combined = combineSignals(bodyController.signal, options.signal);
44
+ const onAbort = () => res.body?.getReader().cancel();
45
+ combined.addEventListener('abort', onAbort, { once: true });
46
+ const cleanup = () => {
47
+ clearTimeout(bodyTimer);
48
+ combined.removeEventListener('abort', onAbort);
49
+ };
50
+ return {
51
+ status: res.status,
52
+ contentLength: parseContentLength(res.headers.get('content-length')),
53
+ body: res.body,
54
+ cancel: () => { cleanup(); res.body?.getReader().cancel(); },
55
+ cleanup,
56
+ };
57
+ }
58
+ finally {
59
+ clearTimeout(connectTimer);
60
+ }
61
+ }
62
+ /** Read the body chunk by chunk */
63
+ export async function consumeBody(body, onChunk, signal) {
64
+ const reader = body.getReader();
65
+ try {
66
+ for (;;) {
67
+ if (signal?.aborted)
68
+ throw new Error('Aborted');
69
+ const { done, value } = await reader.read();
70
+ if (done)
71
+ break;
72
+ await onChunk(value);
73
+ }
74
+ }
75
+ finally {
76
+ reader.releaseLock();
77
+ }
78
+ }
79
+ export class HttpError extends Error {
80
+ status;
81
+ constructor(status, url) {
82
+ super(`HTTP ${status}: ${url}`);
83
+ this.status = status;
84
+ this.name = 'HttpError';
85
+ }
86
+ }
87
+ function parseContentLength(value) {
88
+ if (!value)
89
+ return undefined;
90
+ const n = Number.parseInt(value, 10);
91
+ return Number.isFinite(n) && n >= 0 ? n : undefined;
92
+ }
93
+ function combineSignals(...signals) {
94
+ const controller = new AbortController();
95
+ for (const signal of signals) {
96
+ if (!signal)
97
+ continue;
98
+ if (signal.aborted) {
99
+ controller.abort(signal.reason);
100
+ return controller.signal;
101
+ }
102
+ signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
103
+ }
104
+ return controller.signal;
105
+ }
106
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/browser/core/http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * justget browser entry point
3
+ * Browser entry point — import via `justget/browser`
4
+ *
5
+ * Usage:
6
+ * import { download } from 'justget/browser';
7
+ * const result = await download({ url: '...', mirrors: [...] });
8
+ */
9
+ export { download, Downloader, ChecksumMismatchError } from './core/downloader.js';
10
+ export { DEFAULT_CONFIG, mergeConfig, validateConfig, isImmediateFailure } from '../config.js';
11
+ export { EWMA, calculateInstantSpeed, calculateAverageSpeed, getSpeedStats } from '../speed/ewma.js';
12
+ export { SpeedMonitor } from '../speed/speed-monitor.js';
13
+ export { concatBuffers, hexToUint8Array, uint8ArrayToHex } from './utils/buffer.js';
14
+ export { digest, generateShortHash } from './utils/hash.js';
15
+ export { saveBestSource, loadBestSource, prioritizeMirrors, recordSuccess, cacheKey } from './utils/cache.js';
16
+ export type { CachedSource } from './utils/cache.js';
17
+ export type { DownloadOptions, DownloadConfig, ProgressInfo, SourceProgress, DownloadResult, SourceResult, SourceStatus, ChunkStrategy, RangeCheckResult, ValidationResult, SpeedStats, SpeedSample, DownloadChunk, Source, ReplaceDecision, } from '../types.js';
18
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9G,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAC7D,cAAc,EAAE,YAAY,EAAE,YAAY,EAC1C,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EACjD,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,GAChE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * justget browser entry point
3
+ * Browser entry point — import via `justget/browser`
4
+ *
5
+ * Usage:
6
+ * import { download } from 'justget/browser';
7
+ * const result = await download({ url: '...', mirrors: [...] });
8
+ */
9
+ export { download, Downloader, ChecksumMismatchError } from './core/downloader.js';
10
+ export { DEFAULT_CONFIG, mergeConfig, validateConfig, isImmediateFailure } from '../config.js';
11
+ export { EWMA, calculateInstantSpeed, calculateAverageSpeed, getSpeedStats } from '../speed/ewma.js';
12
+ export { SpeedMonitor } from '../speed/speed-monitor.js';
13
+ export { concatBuffers, hexToUint8Array, uint8ArrayToHex } from './utils/buffer.js';
14
+ export { digest, generateShortHash } from './utils/hash.js';
15
+ export { saveBestSource, loadBestSource, prioritizeMirrors, recordSuccess, cacheKey } from './utils/cache.js';
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * In-memory buffer utilities (replacement for Node.js fs)
3
+ * In-memory buffer utilities
4
+ */
5
+ /** Concatenate several Uint8Arrays into one contiguous Uint8Array */
6
+ export declare function concatBuffers(chunks: Uint8Array[]): Uint8Array;
7
+ /** hex string -> Uint8Array */
8
+ export declare function hexToUint8Array(hex: string): Uint8Array;
9
+ /** Uint8Array -> hex string */
10
+ export declare function uint8ArrayToHex(data: Uint8Array): string;
11
+ //# sourceMappingURL=buffer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/browser/utils/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAQ9D;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAExD"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * In-memory buffer utilities (replacement for Node.js fs)
3
+ * In-memory buffer utilities
4
+ */
5
+ /** Concatenate several Uint8Arrays into one contiguous Uint8Array */
6
+ export function concatBuffers(chunks) {
7
+ if (chunks.length === 0)
8
+ return new Uint8Array(0);
9
+ if (chunks.length === 1)
10
+ return chunks[0];
11
+ const totalLength = chunks.reduce((sum, c) => sum + c.byteLength, 0);
12
+ const result = new Uint8Array(totalLength);
13
+ let offset = 0;
14
+ for (const chunk of chunks)
15
+ result.set(chunk, offset), offset += chunk.byteLength;
16
+ return result;
17
+ }
18
+ /** hex string -> Uint8Array */
19
+ export function hexToUint8Array(hex) {
20
+ const normalized = hex.replace(/^0x/i, '');
21
+ const result = new Uint8Array(normalized.length / 2);
22
+ for (let i = 0; i < normalized.length; i += 2)
23
+ result[i / 2] = parseInt(normalized.substring(i, i + 2), 16);
24
+ return result;
25
+ }
26
+ /** Uint8Array -> hex string */
27
+ export function uint8ArrayToHex(data) {
28
+ return Array.from(data).map((b) => b.toString(16).padStart(2, '0')).join('');
29
+ }
30
+ //# sourceMappingURL=buffer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../../src/browser/utils/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAC3C,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Source cache: remembers which source succeeded last time and prefers it (localStorage)
3
+ *
4
+ * How it works: hash the resource URL and store the mirror that succeeded in
5
+ * localStorage; on the next download of the same resource, promote that mirror
6
+ * to primary and skip the slow source.
7
+ *
8
+ * Storage: localStorage
9
+ * key: justget:cache:<resourceHash>
10
+ * value: { bestUrl, timestamp, successCount }
11
+ * entries auto-expire after 7 days
12
+ */
13
+ declare const STORAGE_PREFIX = "justget:cache:";
14
+ declare const DEFAULT_TTL_MS: number;
15
+ export interface CachedSource {
16
+ bestUrl: string;
17
+ timestamp: number;
18
+ successCount: number;
19
+ }
20
+ /** Build a cache key */
21
+ export declare function cacheKey(resourceUrl: string): string;
22
+ /** Write: record which source downloaded successfully */
23
+ export declare function saveBestSource(resourceUrl: string, successfulUrl: string): void;
24
+ /** Read: the source that succeeded last time */
25
+ export declare function loadBestSource(resourceUrl: string): string | null;
26
+ /**
27
+ * If a previously successful mirror exists, swap it with the primary so the
28
+ * next download uses it directly without waiting for warmup.
29
+ */
30
+ export declare function prioritizeMirrors(primaryUrl: string, mirrors: string[], resourceUrl: string): {
31
+ primaryUrl: string;
32
+ mirrors: string[];
33
+ };
34
+ /** Record a successful download source */
35
+ export declare function recordSuccess(resourceUrl: string, successfulUrl: string): void;
36
+ export { DEFAULT_TTL_MS, STORAGE_PREFIX };
37
+ //# sourceMappingURL=cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/browser/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,QAAA,MAAM,cAAc,mBAAmB,CAAC;AACxC,QAAA,MAAM,cAAc,QAA0B,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAwB;AACxB,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAW/E;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,MAAM,GAClB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAW3C;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAE9E;AAuBD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}