justget 0.1.2

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 (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +263 -0
  3. package/dist/chunks/strategy.d.ts +39 -0
  4. package/dist/chunks/strategy.d.ts.map +1 -0
  5. package/dist/chunks/strategy.js +97 -0
  6. package/dist/chunks/strategy.js.map +1 -0
  7. package/dist/cli.d.ts +7 -0
  8. package/dist/cli.d.ts.map +1 -0
  9. package/dist/cli.js +117 -0
  10. package/dist/cli.js.map +1 -0
  11. package/dist/config.d.ts +71 -0
  12. package/dist/config.d.ts.map +1 -0
  13. package/dist/config.js +158 -0
  14. package/dist/config.js.map +1 -0
  15. package/dist/core/downloader.d.ts +22 -0
  16. package/dist/core/downloader.d.ts.map +1 -0
  17. package/dist/core/downloader.js +555 -0
  18. package/dist/core/downloader.js.map +1 -0
  19. package/dist/core/http.d.ts +51 -0
  20. package/dist/core/http.d.ts.map +1 -0
  21. package/dist/core/http.js +186 -0
  22. package/dist/core/http.js.map +1 -0
  23. package/dist/core/temp.d.ts +47 -0
  24. package/dist/core/temp.d.ts.map +1 -0
  25. package/dist/core/temp.js +137 -0
  26. package/dist/core/temp.js.map +1 -0
  27. package/dist/index.d.ts +13 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +17 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/speed/ewma.d.ts +38 -0
  32. package/dist/speed/ewma.d.ts.map +1 -0
  33. package/dist/speed/ewma.js +87 -0
  34. package/dist/speed/ewma.js.map +1 -0
  35. package/dist/speed/speed-monitor.d.ts +56 -0
  36. package/dist/speed/speed-monitor.d.ts.map +1 -0
  37. package/dist/speed/speed-monitor.js +94 -0
  38. package/dist/speed/speed-monitor.js.map +1 -0
  39. package/dist/types.d.ts +236 -0
  40. package/dist/types.d.ts.map +1 -0
  41. package/dist/types.js +5 -0
  42. package/dist/types.js.map +1 -0
  43. package/dist/utils/hash.d.ts +38 -0
  44. package/dist/utils/hash.d.ts.map +1 -0
  45. package/dist/utils/hash.js +89 -0
  46. package/dist/utils/hash.js.map +1 -0
  47. package/dist/utils/validator.d.ts +21 -0
  48. package/dist/utils/validator.d.ts.map +1 -0
  49. package/dist/utils/validator.js +72 -0
  50. package/dist/utils/validator.js.map +1 -0
  51. package/package.json +70 -0
@@ -0,0 +1,186 @@
1
+ /**
2
+ * HTTP 层:源探测与分块流式下载
3
+ * HTTP layer: source probing and range chunk streaming
4
+ */
5
+ import fetch from 'node-fetch';
6
+ /** HTTP 错误(带状态码,供立即失败判定)/ HTTP error with status code */
7
+ export class HttpError extends Error {
8
+ status;
9
+ constructor(status, url) {
10
+ super(`HTTP ${status}: ${url}`);
11
+ this.status = status;
12
+ this.name = 'HttpError';
13
+ }
14
+ }
15
+ /** 组合多个 AbortSignal(任一触发即取消),兼容 Node 18 / combine signals */
16
+ function combineSignals(...signals) {
17
+ const controller = new AbortController();
18
+ for (const signal of signals) {
19
+ if (!signal)
20
+ continue;
21
+ if (signal.aborted) {
22
+ controller.abort(signal.reason);
23
+ return controller.signal;
24
+ }
25
+ signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
26
+ }
27
+ return controller.signal;
28
+ }
29
+ /** 解析 Content-Length / parse content length */
30
+ function parseContentLength(value) {
31
+ if (!value)
32
+ return undefined;
33
+ const n = Number.parseInt(value, 10);
34
+ return Number.isFinite(n) && n >= 0 ? n : undefined;
35
+ }
36
+ /** 从 Content-Range "bytes 0-0/12345" 解析总长度 / parse total from content-range */
37
+ function parseContentRangeTotal(value) {
38
+ if (!value)
39
+ return undefined;
40
+ const match = /bytes\s+\d+-\d+\/(\d+)/i.exec(value);
41
+ if (!match)
42
+ return undefined;
43
+ const n = Number.parseInt(match[1], 10);
44
+ return Number.isFinite(n) ? n : undefined;
45
+ }
46
+ /**
47
+ * 探测一个源:文件大小与 Range 支持
48
+ * Probe a source: file size and Range support.
49
+ * 优先 HEAD;HEAD 拿不到大小时回退 GET Range: bytes=0-0。
50
+ */
51
+ export async function probe(url, options = {}) {
52
+ const timeout = options.connectTimeout ?? 10_000;
53
+ // 1) HEAD
54
+ try {
55
+ const controller = new AbortController();
56
+ const timer = setTimeout(() => controller.abort(), timeout);
57
+ try {
58
+ const res = await fetch(url, {
59
+ method: 'HEAD',
60
+ redirect: 'follow',
61
+ signal: combineSignals(controller.signal, options.signal),
62
+ headers: options.headers,
63
+ });
64
+ // 4xx/5xx → 源不可用,交由下载阶段处理 / error status → let download phase handle it
65
+ if (res.status >= 400) {
66
+ res.body?.destroy();
67
+ return { supportsRange: false };
68
+ }
69
+ const contentLength = parseContentLength(res.headers.get('content-length'));
70
+ const acceptRanges = res.headers.get('accept-ranges') ?? undefined;
71
+ // HEAD 成功且长度已知 → 直接判定
72
+ if (contentLength !== undefined || res.status === 206 || res.status === 200) {
73
+ // 必须销毁响应体,否则 keep-alive socket 悬挂导致进程不退出
74
+ // destroy the body so the keep-alive socket is released (process exit)
75
+ res.body?.destroy();
76
+ return {
77
+ supportsRange: acceptRanges === 'bytes' || res.status === 206,
78
+ contentLength,
79
+ acceptRanges,
80
+ };
81
+ }
82
+ }
83
+ finally {
84
+ clearTimeout(timer);
85
+ }
86
+ }
87
+ catch {
88
+ // 继续回退
89
+ }
90
+ // 2) GET Range: bytes=0-0
91
+ try {
92
+ const controller = new AbortController();
93
+ const timer = setTimeout(() => controller.abort(), timeout);
94
+ try {
95
+ const res = await fetch(url, {
96
+ redirect: 'follow',
97
+ signal: combineSignals(controller.signal, options.signal),
98
+ headers: { Range: 'bytes=0-0', ...options.headers },
99
+ });
100
+ if (res.status >= 400) {
101
+ res.body?.destroy();
102
+ return { supportsRange: false };
103
+ }
104
+ if (res.status === 206) {
105
+ const total = parseContentRangeTotal(res.headers.get('content-range'));
106
+ res.body?.destroy();
107
+ return { supportsRange: true, contentLength: total, acceptRanges: 'bytes' };
108
+ }
109
+ const contentLength = parseContentLength(res.headers.get('content-length'));
110
+ res.body?.destroy();
111
+ return { supportsRange: false, contentLength, acceptRanges: undefined };
112
+ }
113
+ finally {
114
+ clearTimeout(timer);
115
+ }
116
+ }
117
+ catch {
118
+ return { supportsRange: false };
119
+ }
120
+ }
121
+ /**
122
+ * 打开一个分块(Range)下载流 / Open a ranged download stream
123
+ *
124
+ * 服务器忽略 Range 时返回 200 全文,由调用方负责跳过 start 字节。
125
+ */
126
+ export async function openRangeStream(url, start, end, options = {}) {
127
+ const connectTimeout = options.connectTimeout ?? 10_000;
128
+ const overallTimeout = options.timeout ?? 300_000;
129
+ // 连接阶段:connectTimeout 内应收到响应头
130
+ const connectController = new AbortController();
131
+ const connectTimer = setTimeout(() => connectController.abort(), connectTimeout);
132
+ const headers = { ...options.headers };
133
+ if (start !== undefined && end !== undefined)
134
+ headers.Range = `bytes=${start}-${end}`;
135
+ let res;
136
+ try {
137
+ res = await fetch(url, {
138
+ redirect: 'follow',
139
+ signal: combineSignals(connectController.signal, options.signal),
140
+ headers,
141
+ });
142
+ }
143
+ finally {
144
+ clearTimeout(connectTimer);
145
+ }
146
+ // 4xx/5xx → 抛出带状态码的错误 / error status → throw with status code
147
+ if (res.status >= 400) {
148
+ res.body?.destroy();
149
+ throw new HttpError(res.status, url);
150
+ }
151
+ // 流阶段:整体超时
152
+ const bodyController = new AbortController();
153
+ const bodyTimer = setTimeout(() => bodyController.abort(), overallTimeout);
154
+ // unref:超时是兜底逻辑,不能挂住进程(否则下载完成后进程 300s 不退出)
155
+ // unref: the timeout is a backstop; a ref'd timer would keep the process
156
+ // alive for overallTimeout ms after the download completes
157
+ bodyTimer.unref?.();
158
+ const combined = combineSignals(bodyController.signal, options.signal);
159
+ const onAbort = () => {
160
+ res.body?.destroy();
161
+ };
162
+ combined.addEventListener('abort', onAbort, { once: true });
163
+ const contentRange = res.headers.get('content-range');
164
+ const totalLength = parseContentRangeTotal(contentRange);
165
+ return {
166
+ status: res.status,
167
+ contentLength: parseContentLength(res.headers.get('content-length')),
168
+ totalLength,
169
+ supportsRange: res.status === 206,
170
+ body: res.body,
171
+ cancel: () => {
172
+ clearTimeout(bodyTimer);
173
+ res.body?.destroy();
174
+ },
175
+ };
176
+ }
177
+ /** 流式读取响应体,逐块回调(用于写入文件与计数)/ read body chunk by chunk */
178
+ export async function consumeBody(body, onChunk, signal) {
179
+ for await (const chunk of body) {
180
+ if (signal?.aborted)
181
+ throw new Error('Aborted');
182
+ const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
183
+ await onChunk(buffer);
184
+ }
185
+ }
186
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ /**
2
+ * 临时文件生命周期:命名(复用 utils/hash.ts)、清理、合并、原子改名、恢复
3
+ * Temp file lifecycle: naming, cleanup, merging, atomic rename, resume
4
+ */
5
+ import { getOriginalFromTemp } from '../utils/hash.js';
6
+ export interface ChunkFile {
7
+ index: number;
8
+ tempPath: string;
9
+ }
10
+ /**
11
+ * 清理目标文件同目录下超过 maxAgeHours 的旧临时文件
12
+ * Clean stale temp files (older than maxAgeHours) in the target dir
13
+ */
14
+ export declare function cleanupOldTempFiles(targetPath: string): void;
15
+ /**
16
+ * 生成该输出文件的所有临时文件路径
17
+ * Build temp file paths for every chunk of the output
18
+ */
19
+ export declare function buildChunkTempPaths(output: string, chunkCount: number): {
20
+ index: number;
21
+ tempPath: string;
22
+ }[];
23
+ /**
24
+ * 检查是否存在可恢复的 merged 临时文件
25
+ * Check for a resumable merged temp file
26
+ */
27
+ export declare function findResumableMerged(output: string, expectedSize?: number): string | null;
28
+ /**
29
+ * 按 index 顺序合并分块临时文件到 merged 临时文件
30
+ * Merge chunk temp files (ordered by index) into one merged temp file
31
+ *
32
+ * 手动泵数据而非复用 pipeline({end:false}),避免在同一个写流上累积监听器
33
+ * manual pump avoids listener accumulation from repeated pipeline({end:false}) calls
34
+ */
35
+ export declare function mergeChunks(chunkFiles: ChunkFile[], mergedPath: string): Promise<void>;
36
+ /**
37
+ * 原子改名:merged 临时文件 → 最终输出文件
38
+ * Atomically move merged temp file to the final output path
39
+ */
40
+ export declare function commitMerged(mergedPath: string, output: string): void;
41
+ /**
42
+ * 删除该输出文件相关的全部临时文件(chunk + merged)
43
+ * Remove all temp files related to the output (chunks + merged)
44
+ */
45
+ export declare function removeAllTempFiles(output: string): void;
46
+ export { getOriginalFromTemp };
47
+ //# sourceMappingURL=temp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"temp.d.ts","sourceRoot":"","sources":["../../src/core/temp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAGL,mBAAmB,EAGpB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAsB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CAUvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiBvD;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
@@ -0,0 +1,137 @@
1
+ /**
2
+ * 临时文件生命周期:命名(复用 utils/hash.ts)、清理、合并、原子改名、恢复
3
+ * Temp file lifecycle: naming, cleanup, merging, atomic rename, resume
4
+ */
5
+ import * as fs from 'node:fs';
6
+ import * as path from 'node:path';
7
+ import { once } from 'node:events';
8
+ import { generateShortHash, getMergedTempFileName, getOriginalFromTemp, getTempFileName, isTempFile, } from '../utils/hash.js';
9
+ import { TEMP_FILE_CONFIG } from '../config.js';
10
+ /**
11
+ * 清理目标文件同目录下超过 maxAgeHours 的旧临时文件
12
+ * Clean stale temp files (older than maxAgeHours) in the target dir
13
+ */
14
+ export function cleanupOldTempFiles(targetPath) {
15
+ const dir = path.dirname(path.resolve(targetPath));
16
+ const hash = generateShortHash(targetPath);
17
+ let entries;
18
+ try {
19
+ entries = fs.readdirSync(dir, { withFileTypes: true });
20
+ }
21
+ catch {
22
+ return;
23
+ }
24
+ const now = Date.now();
25
+ for (const entry of entries) {
26
+ if (!entry.isFile() || !isTempFile(entry.name) || !entry.name.includes(hash))
27
+ continue;
28
+ try {
29
+ const stat = fs.statSync(path.join(dir, entry.name));
30
+ const ageHours = (now - stat.mtimeMs) / (1000 * 60 * 60);
31
+ if (ageHours > TEMP_FILE_CONFIG.maxAgeHours) {
32
+ fs.unlinkSync(path.join(dir, entry.name));
33
+ }
34
+ }
35
+ catch {
36
+ // 忽略单个文件失败
37
+ }
38
+ }
39
+ }
40
+ /**
41
+ * 生成该输出文件的所有临时文件路径
42
+ * Build temp file paths for every chunk of the output
43
+ */
44
+ export function buildChunkTempPaths(output, chunkCount) {
45
+ const dir = path.dirname(path.resolve(output));
46
+ const paths = [];
47
+ for (let index = 0; index < chunkCount; index++) {
48
+ paths.push({
49
+ index,
50
+ tempPath: path.join(dir, getTempFileName(output, 'chunk', index)),
51
+ });
52
+ }
53
+ return paths;
54
+ }
55
+ /**
56
+ * 检查是否存在可恢复的 merged 临时文件
57
+ * Check for a resumable merged temp file
58
+ */
59
+ export function findResumableMerged(output, expectedSize) {
60
+ const merged = path.join(path.dirname(path.resolve(output)), getMergedTempFileName(output));
61
+ try {
62
+ const stat = fs.statSync(merged);
63
+ if (expectedSize !== undefined) {
64
+ if (stat.size < expectedSize * TEMP_FILE_CONFIG.resumeThreshold)
65
+ return null;
66
+ }
67
+ return merged;
68
+ }
69
+ catch {
70
+ return null;
71
+ }
72
+ }
73
+ /**
74
+ * 按 index 顺序合并分块临时文件到 merged 临时文件
75
+ * Merge chunk temp files (ordered by index) into one merged temp file
76
+ *
77
+ * 手动泵数据而非复用 pipeline({end:false}),避免在同一个写流上累积监听器
78
+ * manual pump avoids listener accumulation from repeated pipeline({end:false}) calls
79
+ */
80
+ export async function mergeChunks(chunkFiles, mergedPath) {
81
+ const ordered = [...chunkFiles].sort((a, b) => a.index - b.index);
82
+ const out = fs.createWriteStream(mergedPath, { flags: 'w' });
83
+ let outError;
84
+ out.on('error', (e) => {
85
+ outError = e;
86
+ });
87
+ try {
88
+ for (const chunk of ordered) {
89
+ const src = fs.createReadStream(chunk.tempPath);
90
+ for await (const data of src) {
91
+ if (outError)
92
+ throw outError;
93
+ if (!out.write(data))
94
+ await once(out, 'drain');
95
+ }
96
+ }
97
+ out.end();
98
+ await once(out, 'finish');
99
+ }
100
+ finally {
101
+ out.destroy();
102
+ }
103
+ }
104
+ /**
105
+ * 原子改名:merged 临时文件 → 最终输出文件
106
+ * Atomically move merged temp file to the final output path
107
+ */
108
+ export function commitMerged(mergedPath, output) {
109
+ fs.renameSync(mergedPath, output);
110
+ }
111
+ /**
112
+ * 删除该输出文件相关的全部临时文件(chunk + merged)
113
+ * Remove all temp files related to the output (chunks + merged)
114
+ */
115
+ export function removeAllTempFiles(output) {
116
+ const dir = path.dirname(path.resolve(output));
117
+ const hash = generateShortHash(output);
118
+ let entries;
119
+ try {
120
+ entries = fs.readdirSync(dir, { withFileTypes: true });
121
+ }
122
+ catch {
123
+ return;
124
+ }
125
+ for (const entry of entries) {
126
+ if (!entry.isFile() || !isTempFile(entry.name) || !entry.name.includes(hash))
127
+ continue;
128
+ try {
129
+ fs.unlinkSync(path.join(dir, entry.name));
130
+ }
131
+ catch {
132
+ // 忽略
133
+ }
134
+ }
135
+ }
136
+ export { getOriginalFromTemp };
137
+ //# sourceMappingURL=temp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"temp.js","sourceRoot":"","sources":["../../src/core/temp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * JustGet 对外入口
3
+ * Public entry point of JustGet
4
+ */
5
+ export { download, Downloader } from './core/downloader.js';
6
+ export { DEFAULT_CONFIG, mergeConfig, validateConfig, isImmediateFailure } from './config.js';
7
+ export { calculateChunkStrategy, calculateChunkSize, calculateChunkCount, createChunkRanges, } from './chunks/strategy.js';
8
+ export { EWMA, calculateInstantSpeed, calculateAverageSpeed, getSpeedStats } from './speed/ewma.js';
9
+ export { SpeedMonitor } from './speed/speed-monitor.js';
10
+ export { generateShortHash, getTempFileName, getMergedTempFileName, getTempDir, isTempFile, getOriginalFromTemp, getHashFromTemp, } from './utils/hash.js';
11
+ export { calculateChecksum, validateFile, getFileSize, fileExists } from './utils/validator.js';
12
+ export type { DownloadOptions, DownloadConfig, ProgressInfo, SourceProgress, DownloadResult, SourceResult, SourceStatus, ReplaceDecision, RangeCheckResult, ValidationResult, DownloadChunk, ChunkStrategy, Source, SpeedStats, SpeedSample, } from './types.js';
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG9F,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGhG,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * JustGet 对外入口
3
+ * Public entry point of JustGet
4
+ */
5
+ // 下载器(规划中 / planned)
6
+ export { download, Downloader } from './core/downloader.js';
7
+ // 配置 Config
8
+ export { DEFAULT_CONFIG, mergeConfig, validateConfig, isImmediateFailure } from './config.js';
9
+ // 分块策略 Chunk strategy
10
+ export { calculateChunkStrategy, calculateChunkSize, calculateChunkCount, createChunkRanges, } from './chunks/strategy.js';
11
+ // 速度计算 Speed
12
+ export { EWMA, calculateInstantSpeed, calculateAverageSpeed, getSpeedStats } from './speed/ewma.js';
13
+ export { SpeedMonitor } from './speed/speed-monitor.js';
14
+ // 工具 Utilities
15
+ export { generateShortHash, getTempFileName, getMergedTempFileName, getTempDir, isTempFile, getOriginalFromTemp, getHashFromTemp, } from './utils/hash.js';
16
+ export { calculateChecksum, validateFile, getFileSize, fileExists } from './utils/validator.js';
17
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE9F,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Speed calculation using Exponentially Weighted Moving Average (EWMA)
3
+ */
4
+ import type { SpeedSample, SpeedStats } from '../types.js';
5
+ /**
6
+ * EWMA Calculator for smooth speed estimation
7
+ */
8
+ export declare class EWMA {
9
+ private alpha;
10
+ private value;
11
+ private initialized;
12
+ constructor(alpha?: number);
13
+ /**
14
+ * Update EWMA with new value
15
+ */
16
+ update(newValue: number): number;
17
+ /**
18
+ * Get current EWMA value
19
+ */
20
+ getValue(): number;
21
+ /**
22
+ * Reset EWMA
23
+ */
24
+ reset(): void;
25
+ }
26
+ /**
27
+ * Calculate instant speed from samples
28
+ */
29
+ export declare function calculateInstantSpeed(samples: SpeedSample[]): number;
30
+ /**
31
+ * Calculate average speed from samples
32
+ */
33
+ export declare function calculateAverageSpeed(samples: SpeedSample[], startTime: number): number;
34
+ /**
35
+ * Get complete speed statistics
36
+ */
37
+ export declare function getSpeedStats(samples: SpeedSample[], startTime: number, ewma: EWMA): SpeedStats;
38
+ //# sourceMappingURL=ewma.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ewma.d.ts","sourceRoot":"","sources":["../../src/speed/ewma.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG3D;;GAEG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,GAAE,MAA+B;IAOlD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAUhC;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAcpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAavF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,GACT,UAAU,CAYZ"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Speed calculation using Exponentially Weighted Moving Average (EWMA)
3
+ */
4
+ import { SPEED_CONFIG } from '../config.js';
5
+ /**
6
+ * EWMA Calculator for smooth speed estimation
7
+ */
8
+ export class EWMA {
9
+ alpha;
10
+ value = 0;
11
+ initialized = false;
12
+ constructor(alpha = SPEED_CONFIG.ewmaAlpha) {
13
+ if (alpha <= 0 || alpha >= 1) {
14
+ throw new Error('Alpha must be between 0 and 1');
15
+ }
16
+ this.alpha = alpha;
17
+ }
18
+ /**
19
+ * Update EWMA with new value
20
+ */
21
+ update(newValue) {
22
+ if (!this.initialized) {
23
+ this.value = newValue;
24
+ this.initialized = true;
25
+ }
26
+ else {
27
+ this.value = this.alpha * newValue + (1 - this.alpha) * this.value;
28
+ }
29
+ return this.value;
30
+ }
31
+ /**
32
+ * Get current EWMA value
33
+ */
34
+ getValue() {
35
+ return this.value;
36
+ }
37
+ /**
38
+ * Reset EWMA
39
+ */
40
+ reset() {
41
+ this.value = 0;
42
+ this.initialized = false;
43
+ }
44
+ }
45
+ /**
46
+ * Calculate instant speed from samples
47
+ */
48
+ export function calculateInstantSpeed(samples) {
49
+ if (samples.length < 2) {
50
+ return 0;
51
+ }
52
+ const newest = samples[samples.length - 1];
53
+ const oldest = samples[0];
54
+ const timeDiff = newest.timestamp - oldest.timestamp;
55
+ if (timeDiff <= 0) {
56
+ return 0;
57
+ }
58
+ return (newest.bytes - oldest.bytes) / (timeDiff / 1000);
59
+ }
60
+ /**
61
+ * Calculate average speed from samples
62
+ */
63
+ export function calculateAverageSpeed(samples, startTime) {
64
+ if (samples.length === 0) {
65
+ return 0;
66
+ }
67
+ const lastSample = samples[samples.length - 1];
68
+ const elapsed = lastSample.timestamp - startTime;
69
+ if (elapsed <= 0) {
70
+ return 0;
71
+ }
72
+ return (lastSample.bytes / elapsed) * 1000;
73
+ }
74
+ /**
75
+ * Get complete speed statistics
76
+ */
77
+ export function getSpeedStats(samples, startTime, ewma) {
78
+ const current = calculateInstantSpeed(samples);
79
+ const average = calculateAverageSpeed(samples, startTime);
80
+ return {
81
+ current,
82
+ ewma: ewma.getValue(),
83
+ peak: Math.max(current, ...samples.map((_, i) => i > 0 ? calculateInstantSpeed(samples.slice(0, i + 1)) : 0)),
84
+ average,
85
+ };
86
+ }
87
+ //# sourceMappingURL=ewma.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ewma.js","sourceRoot":"","sources":["../../src/speed/ewma.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Speed monitoring for download sources
3
+ */
4
+ import type { SpeedStats } from '../types.js';
5
+ export interface SpeedMonitorOptions {
6
+ /** EWMA alpha value (default: 0.3) */
7
+ alpha?: number;
8
+ /** Sample interval in ms (default: 1000) */
9
+ sampleInterval?: number;
10
+ /** Window size for samples (default: 10) */
11
+ windowSize?: number;
12
+ }
13
+ /**
14
+ * Monitor and calculate download speed
15
+ */
16
+ export declare class SpeedMonitor {
17
+ private samples;
18
+ private ewma;
19
+ private startTime;
20
+ private options;
21
+ private interval?;
22
+ constructor(options?: SpeedMonitorOptions);
23
+ /**
24
+ * Record a speed sample
25
+ */
26
+ record(bytes: number): SpeedStats;
27
+ /**
28
+ * Get current speed statistics
29
+ */
30
+ getStats(): SpeedStats;
31
+ /**
32
+ * Get current speed (EWMA)
33
+ */
34
+ getCurrentSpeed(): number;
35
+ /**
36
+ * Check if speed is below threshold
37
+ */
38
+ isBelowThreshold(threshold: number): boolean;
39
+ /**
40
+ * Start automatic sampling
41
+ */
42
+ startSampling(getBytes: () => number, callback?: (stats: SpeedStats) => void): void;
43
+ /**
44
+ * Stop automatic sampling
45
+ */
46
+ stopSampling(): void;
47
+ /**
48
+ * Reset monitor
49
+ */
50
+ reset(): void;
51
+ /**
52
+ * Get elapsed time in milliseconds
53
+ */
54
+ getElapsedTime(): number;
55
+ }
56
+ //# sourceMappingURL=speed-monitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"speed-monitor.d.ts","sourceRoot":"","sources":["../../src/speed/speed-monitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAI3D,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,CAAiC;gBAEtC,OAAO,GAAE,mBAAwB;IAW7C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAoBjC;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAQnF;;OAEG;IACH,YAAY,IAAI,IAAI;IAOpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}