@lzwme/sserver 0.0.10 → 1.0.0

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 (69) hide show
  1. package/LICENSE +21 -21
  2. package/README.MD +72 -100
  3. package/bin/sserver.js +0 -0
  4. package/dist/assets/assets/localsend/style.css +2 -0
  5. package/dist/assets/assets/localsend/vendor/qr-code-styling.js +2 -0
  6. package/dist/assets/localsend/style.css +2 -0
  7. package/dist/assets/localsend/vendor/qr-code-styling.js +2 -0
  8. package/dist/cli.js +26 -4
  9. package/dist/config.d.ts +38 -1
  10. package/dist/config.js +54 -9
  11. package/dist/lib/get-cert.js +1 -1
  12. package/dist/lib/merge-config.d.ts +9 -0
  13. package/dist/lib/merge-config.js +66 -0
  14. package/dist/lib/utils.d.ts +27 -1
  15. package/dist/lib/utils.js +94 -14
  16. package/dist/localsend/audit.d.ts +36 -0
  17. package/dist/localsend/audit.js +104 -0
  18. package/dist/localsend/auth.d.ts +94 -0
  19. package/dist/localsend/auth.js +227 -0
  20. package/dist/localsend/cache.d.ts +34 -0
  21. package/dist/localsend/cache.js +269 -0
  22. package/dist/localsend/chunk.d.ts +114 -0
  23. package/dist/localsend/chunk.js +475 -0
  24. package/dist/localsend/cleaner.d.ts +19 -0
  25. package/dist/localsend/cleaner.js +80 -0
  26. package/dist/localsend/client/app.js +4131 -0
  27. package/dist/localsend/client/crypto.js +233 -0
  28. package/dist/localsend/client/favicon.png +0 -0
  29. package/dist/localsend/client/icons/icon-192.png +0 -0
  30. package/dist/localsend/client/icons/icon-512.png +0 -0
  31. package/dist/localsend/client/index.html +451 -0
  32. package/dist/localsend/client/manifest.webmanifest +33 -0
  33. package/dist/localsend/client/sw.js +128 -0
  34. package/dist/localsend/guard.d.ts +58 -0
  35. package/dist/localsend/guard.js +210 -0
  36. package/dist/localsend/index.d.ts +52 -0
  37. package/dist/localsend/index.js +1771 -0
  38. package/dist/localsend/manage.d.ts +96 -0
  39. package/dist/localsend/manage.js +304 -0
  40. package/dist/localsend/metrics.d.ts +26 -0
  41. package/dist/localsend/metrics.js +58 -0
  42. package/dist/localsend/paste.d.ts +72 -0
  43. package/dist/localsend/paste.js +125 -0
  44. package/dist/localsend/path.d.ts +33 -0
  45. package/dist/localsend/path.js +151 -0
  46. package/dist/localsend/query.d.ts +78 -0
  47. package/dist/localsend/query.js +147 -0
  48. package/dist/localsend/secret.d.ts +31 -0
  49. package/dist/localsend/secret.js +96 -0
  50. package/dist/localsend/settings.d.ts +53 -0
  51. package/dist/localsend/settings.js +285 -0
  52. package/dist/localsend/share.d.ts +35 -0
  53. package/dist/localsend/share.js +117 -0
  54. package/dist/localsend/temp.d.ts +10 -0
  55. package/dist/localsend/temp.js +47 -0
  56. package/dist/localsend/ticket.d.ts +40 -0
  57. package/dist/localsend/ticket.js +98 -0
  58. package/dist/localsend/trash.d.ts +39 -0
  59. package/dist/localsend/trash.js +261 -0
  60. package/dist/localsend/webdav.d.ts +50 -0
  61. package/dist/localsend/webdav.js +530 -0
  62. package/dist/localsend/zip.d.ts +20 -0
  63. package/dist/localsend/zip.js +186 -0
  64. package/dist/proxy/php-proxy.js +54 -21
  65. package/dist/static-server.js +10 -3
  66. package/package.json +21 -13
  67. package/dist/localsend/index.html +0 -481
  68. package/dist/localsend.d.ts +0 -2
  69. package/dist/localsend.js +0 -148
@@ -0,0 +1,269 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createListCache = createListCache;
4
+ /*
5
+ * LocalSend 文件列表缓存
6
+ *
7
+ * 存储目录里可能有成千上万个文件,每次请求都递归扫描一遍 statSync,
8
+ * 在大目录上会明显拖慢响应。这里加一层内存缓存:
9
+ * - 首次访问时全量扫描
10
+ * - 通过 fs.watch 监听目录变化,增量更新缓存
11
+ * - watch 不可用或事件丢失时,用 TTL 定期全量校准兜底
12
+ */
13
+ const node_fs_1 = require("node:fs");
14
+ const node_path_1 = require("node:path");
15
+ const path_1 = require("./path");
16
+ function createListCache(options) {
17
+ const { dir } = options;
18
+ const ttl = options.ttl ?? 5 * 60 * 1000;
19
+ const watchEnabled = options.watchEnabled !== false;
20
+ /** 缓存的文件列表 */
21
+ let entries = [];
22
+ /** 是否已经扫描过 */
23
+ let loaded = false;
24
+ /** 上次全量扫描时间 */
25
+ let lastScan = 0;
26
+ /** 命中/未命中计数 */
27
+ let hits = 0;
28
+ let misses = 0;
29
+ /** 待处理的增量变更 */
30
+ const pending = new Map();
31
+ /** 合并变更的定时器 */
32
+ let flushTimer = null;
33
+ /** 全量扫描并写入缓存 */
34
+ function scan() {
35
+ const filter = options.filter;
36
+ const list = (0, path_1.listFiles)(dir, filter);
37
+ entries = list;
38
+ loaded = true;
39
+ lastScan = Date.now();
40
+ return entries;
41
+ }
42
+ /** 取相对路径对应的条目索引 */
43
+ function findIndex(rel) {
44
+ return entries.findIndex((e) => e.name === rel);
45
+ }
46
+ /** 读取单个文件的元信息 */
47
+ function statOf(rel) {
48
+ const parts = rel.split('/');
49
+ const name = parts.pop();
50
+ try {
51
+ const st = (0, node_fs_1.statSync)((0, node_path_1.join)(dir, ...parts, name));
52
+ if (!st.isFile())
53
+ return null;
54
+ return {
55
+ name: rel,
56
+ size: st.size,
57
+ mtime: st.mtimeMs,
58
+ ext: name.slice(name.lastIndexOf('.') + 1).toLowerCase(),
59
+ isDir: false,
60
+ };
61
+ }
62
+ catch {
63
+ return null;
64
+ }
65
+ }
66
+ /**
67
+ * 应用一次增量变更。
68
+ *
69
+ * 返回是否真的对应一个文件条目:目录本身的创建/改名也会触发 watcher,
70
+ * 这类事件不该被当成「收到新文件」推送出去。
71
+ */
72
+ function applyChange(rel, type) {
73
+ const filter = options.filter;
74
+ if (type === 'remove') {
75
+ const idx = findIndex(rel);
76
+ if (idx >= 0)
77
+ entries.splice(idx, 1);
78
+ return false;
79
+ }
80
+ // 内部目录(如分片暂存区)不进入缓存
81
+ if (rel.split('/').some((p) => (0, path_1.isInternalDirName)(p)))
82
+ return false;
83
+ if (filter && !filter(rel))
84
+ return false;
85
+ const meta = statOf(rel);
86
+ if (!meta) {
87
+ // 文件可能已被删除,或者是目录事件
88
+ const idx = findIndex(rel);
89
+ if (idx >= 0)
90
+ entries.splice(idx, 1);
91
+ return false;
92
+ }
93
+ const idx = findIndex(rel);
94
+ if (idx >= 0)
95
+ entries[idx] = meta;
96
+ else
97
+ entries.push(meta);
98
+ return true;
99
+ }
100
+ /** 合并并应用待处理的变更 */
101
+ function flush() {
102
+ flushTimer = null;
103
+ if (!pending.size)
104
+ return;
105
+ const changed = [];
106
+ for (const [rel, info] of pending) {
107
+ const applied = applyChange(rel, info.type);
108
+ // 删除不作为「收到新文件」通知;目录事件也不推送
109
+ if (info.type !== 'remove' && applied)
110
+ changed.push(rel);
111
+ }
112
+ pending.clear();
113
+ if (changed.length)
114
+ options.onChange?.(changed);
115
+ }
116
+ /** 记录一次变更(同一文件短时间内多次变更只保留最后一次) */
117
+ function queue(rel, type) {
118
+ pending.set(rel, { type, at: Date.now() });
119
+ if (flushTimer)
120
+ return;
121
+ // 合并 100ms 内的连续变更,避免大目录频繁变动时反复重排
122
+ flushTimer = setTimeout(flush, 100);
123
+ flushTimer.unref?.();
124
+ }
125
+ /** 监听器集合(需要监听子目录) */
126
+ const watchers = [];
127
+ /** 为一个目录建立监听 */
128
+ function watchDir(target) {
129
+ if (!(0, node_fs_1.existsSync)(target))
130
+ return;
131
+ try {
132
+ const w = (0, node_fs_1.watch)(target, { persistent: false }, (eventType, filename) => {
133
+ if (!filename)
134
+ return;
135
+ const name = String(filename);
136
+ // 内部目录变化不处理
137
+ if ((0, path_1.isInternalDirName)(name))
138
+ return;
139
+ const rel = relativeToDir(target, name);
140
+ if (eventType === 'rename') {
141
+ // rename 事件表示文件被创建或删除,通过实际存在性区分
142
+ queue(rel, (0, node_fs_1.existsSync)((0, node_path_1.join)(target, name)) ? 'add' : 'remove');
143
+ }
144
+ else {
145
+ queue(rel, 'change');
146
+ }
147
+ });
148
+ watchers.push(w);
149
+ }
150
+ catch {
151
+ // 监听失败(目录不存在或权限不足),忽略,交给 TTL 校准兜底
152
+ }
153
+ }
154
+ /** 计算相对存储目录的路径(统一用 `/` 分隔) */
155
+ function relativeToDir(target, name) {
156
+ if (target === dir)
157
+ return name;
158
+ const prefix = target
159
+ .slice(dir.length)
160
+ .replace(/^[\\/]+/, '')
161
+ .split(/[\\/]+/)
162
+ .filter(Boolean)
163
+ .join('/');
164
+ return prefix ? `${prefix}/${name}` : name;
165
+ }
166
+ /** 监听上限:目录过多时只覆盖较浅的层级,更深的靠 TTL 兜底 */
167
+ const MAX_WATCHERS = 64;
168
+ /** 监听的最大层级(根目录算第 0 层) */
169
+ const MAX_WATCH_DEPTH = 3;
170
+ /**
171
+ * 建立对存储目录及其子目录的监听。
172
+ *
173
+ * 以前只监听根目录与一级子目录,深层子目录里的新增文件要等 5 分钟 TTL
174
+ * 过期才会被推送。这里按深度(默认 3 层)与数量(默认 64 个)递归监听,
175
+ * 既覆盖常见的「归档/2026/项目」这类结构,也不会让 watcher 数量失控。
176
+ */
177
+ function setupWatch() {
178
+ if (!watchEnabled)
179
+ return;
180
+ // 监听顶层目录
181
+ watchDir(dir);
182
+ const walk = (current, depth) => {
183
+ if (depth >= MAX_WATCH_DEPTH || watchers.length >= MAX_WATCHERS)
184
+ return;
185
+ let names;
186
+ try {
187
+ names = (0, node_fs_1.readdirSync)(current);
188
+ }
189
+ catch {
190
+ return;
191
+ }
192
+ for (const name of names) {
193
+ if ((0, path_1.isInternalDirName)(name))
194
+ continue;
195
+ if (watchers.length >= MAX_WATCHERS)
196
+ return;
197
+ const full = (0, node_path_1.join)(current, name);
198
+ try {
199
+ if (!(0, node_fs_1.statSync)(full).isDirectory())
200
+ continue;
201
+ }
202
+ catch {
203
+ // 忽略读取失败的条目
204
+ continue;
205
+ }
206
+ watchDir(full);
207
+ walk(full, depth + 1);
208
+ }
209
+ };
210
+ walk(dir, 0);
211
+ }
212
+ return {
213
+ list() {
214
+ const expired = !loaded || Date.now() - lastScan > ttl;
215
+ if (expired) {
216
+ misses++;
217
+ scan();
218
+ // 重新扫描后重新建立监听,覆盖新增的子目录
219
+ if (watchEnabled) {
220
+ for (const w of watchers) {
221
+ try {
222
+ w.close();
223
+ }
224
+ catch {
225
+ // 忽略关闭失败
226
+ }
227
+ }
228
+ watchers.length = 0;
229
+ setupWatch();
230
+ }
231
+ return entries;
232
+ }
233
+ hits++;
234
+ // 应用待处理的增量变更
235
+ if (pending.size)
236
+ flush();
237
+ return entries;
238
+ },
239
+ startWatch() {
240
+ if (!watchEnabled)
241
+ return;
242
+ setupWatch();
243
+ },
244
+ refresh() {
245
+ misses++;
246
+ return scan();
247
+ },
248
+ invalidate() {
249
+ loaded = false;
250
+ pending.clear();
251
+ },
252
+ stats() {
253
+ return { entries: entries.length, hits, misses, watching: watchers.length > 0, lastScan };
254
+ },
255
+ stop() {
256
+ for (const w of watchers) {
257
+ try {
258
+ w.close();
259
+ }
260
+ catch {
261
+ // 忽略关闭失败
262
+ }
263
+ }
264
+ watchers.length = 0;
265
+ if (flushTimer)
266
+ clearTimeout(flushTimer);
267
+ },
268
+ };
269
+ }
@@ -0,0 +1,114 @@
1
+ export interface ChunkMeta {
2
+ /** 上传任务 ID */
3
+ uploadId: string;
4
+ /** 目标文件名(相对存储目录) */
5
+ name: string;
6
+ /** 文件总大小(字节) */
7
+ size: number;
8
+ /** 分片大小(字节) */
9
+ chunkSize: number;
10
+ /** 分片总数 */
11
+ total: number;
12
+ /** 已完成的分片索引 */
13
+ received: number[];
14
+ /** 创建时间戳 */
15
+ createdAt: number;
16
+ /** 文件指纹(名称:大小:修改时间),用于客户端重连后找回同一个任务 */
17
+ fileKey?: string;
18
+ }
19
+ export interface ChunkStoreOptions {
20
+ /** 正式存储目录 */
21
+ dir: string;
22
+ /** 分片暂存目录 */
23
+ tmpDir: string;
24
+ /** 上传任务有效期(毫秒),超时自动清理 */
25
+ ttl?: number;
26
+ /** 单文件大小上限(字节)。传入函数表示运行时取值 */
27
+ maxSize?: number | (() => number);
28
+ }
29
+ export interface ChunkInitResult {
30
+ uploadId: string;
31
+ name: string;
32
+ size: number;
33
+ chunkSize: number;
34
+ total: number;
35
+ /** 已经上传过的分片索引(断点续传的关键) */
36
+ received: number[];
37
+ /** 是否复用了已有任务(即这次是续传而不是新开) */
38
+ resumed?: boolean;
39
+ }
40
+ /** 初始化参数:带上其中之一即可续传 */
41
+ export interface ChunkInitOptions {
42
+ /** 客户端上次拿到的任务 ID(服务重启后仍可通过落盘元信息找回) */
43
+ uploadId?: string;
44
+ /** 文件指纹(名称:大小:修改时间):没有 uploadId 时按它找回任务 */
45
+ fileKey?: string;
46
+ }
47
+ export interface ChunkUploadResult {
48
+ uploadId: string;
49
+ index: number;
50
+ received: number[];
51
+ total: number;
52
+ /** 全部到齐 */
53
+ complete: boolean;
54
+ }
55
+ export interface ChunkMergeResult {
56
+ /** 最终文件名(可能因同名而追加 _1 后缀) */
57
+ name: string;
58
+ size: number;
59
+ }
60
+ /** 默认分片大小:8MB,太小会显著增加请求数,太大则断点损失多 */
61
+ export declare const DEFAULT_CHUNK_SIZE: number;
62
+ export declare const MAX_CHUNK_SIZE: number;
63
+ /**
64
+ * 分片上传管理器。
65
+ * 任务信息只存内存(重启即失效,分片文件会被清理),避免状态泄漏到磁盘。
66
+ */
67
+ export declare function createChunkStore(options: ChunkStoreOptions): {
68
+ /**
69
+ * 初始化一个上传任务。
70
+ *
71
+ * 带 uploadId 或 fileKey 时会尝试复用已有任务:分片以磁盘实际文件为准,
72
+ * 因此「服务重启」「页面刷新」「换标签页」之后都能从已传的部分接着来。
73
+ */
74
+ init(name: string, size: number, chunkSize?: number, opts?: ChunkInitOptions): ChunkInitResult;
75
+ /** 记录一个已上传的分片 */
76
+ markReceived(uploadId: string, index: number): ChunkUploadResult | null;
77
+ /** 查询上传进度 */
78
+ status(uploadId: string): (ChunkInitResult & {
79
+ complete: boolean;
80
+ }) | null;
81
+ /**
82
+ * 登记一个已上传的分片。
83
+ * `sourcePath` 为 multer 落下的临时文件路径,会被移动到分片暂存区,
84
+ * 避免把整个分片读进内存。
85
+ */
86
+ writeChunk(uploadId: string, index: number, sourcePath: string): ChunkUploadResult | null;
87
+ /**
88
+ * 合并分片为正式文件(流式、异步)。
89
+ *
90
+ * 由调用方提供 `resolveTarget` 把目标文件名解析为绝对路径(处理同名改名与子目录创建)。
91
+ *
92
+ * 逐片边读边写,不把分片读进内存;也不会像同步循环那样把事件循环占住——
93
+ * 合并 1GB 文件时,同步实现会让 SSE 推送与其它设备的列表请求一起排队数秒。
94
+ * 先写 `<目标名>.<随机>.merging`,校验大小后再转正,中断不会留下半截文件。
95
+ */
96
+ merge(uploadId: string, resolveTarget: (name: string) => {
97
+ path: string;
98
+ name: string;
99
+ } | null): Promise<ChunkMergeResult | null>;
100
+ /** 取消并清理分片 */
101
+ cancel(uploadId: string): boolean;
102
+ /** 释放资源(服务关闭时调用) */
103
+ dispose(): void;
104
+ /** 内部:查询元信息 */
105
+ meta(uploadId: string): ChunkMeta | undefined;
106
+ /** 内部:单文件大小上限 */
107
+ readonly maxSize: number;
108
+ /** 内部:分片大小钳制 */
109
+ clampChunkSize(size?: number): number;
110
+ /** 停止定时清理(进程退出或测试收尾时调用) */
111
+ stop(): void;
112
+ /** 内部:分片总数上限 */
113
+ maxChunks: number;
114
+ };