@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,261 @@
1
+ "use strict";
2
+ /*
3
+ * LocalSend 回收站
4
+ *
5
+ * 删除文件时先移入回收站,而不是直接抹掉,
6
+ * 这样误删后还能在一定时间内还原。
7
+ *
8
+ * 回收站目录位于存储目录下的 `.trash` 内部目录,
9
+ * 不出现在文件列表、WebDAV 目录与自动清理范围内。
10
+ * 超过保留期限的条目会被自动清理。
11
+ */
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.TRASH_DIR_NAME = void 0;
14
+ exports.createTrash = createTrash;
15
+ const node_crypto_1 = require("node:crypto");
16
+ const node_fs_1 = require("node:fs");
17
+ const node_path_1 = require("node:path");
18
+ /** 回收站目录名 */
19
+ exports.TRASH_DIR_NAME = '.trash';
20
+ /** 条目文件名前缀 */
21
+ const ENTRY_PREFIX = 'item-';
22
+ function createTrash(options) {
23
+ const { dir } = options;
24
+ /** 运行时读取当前生效的保留时长 */
25
+ const getTtl = () => {
26
+ const value = typeof options.ttl === 'function' ? options.ttl() : options.ttl;
27
+ return value ?? 24 * 60 * 60 * 1000;
28
+ };
29
+ const intervalMs = options.intervalMs ?? 60 * 60 * 1000;
30
+ const trashDir = (0, node_path_1.join)(dir, exports.TRASH_DIR_NAME);
31
+ /** 确保回收站目录存在 */
32
+ function ensureDir() {
33
+ if (!(0, node_fs_1.existsSync)(trashDir))
34
+ (0, node_fs_1.mkdirSync)(trashDir, { recursive: true });
35
+ }
36
+ /** 条目在回收站中的实际路径 */
37
+ function entryPath(id) {
38
+ return (0, node_path_1.join)(trashDir, ENTRY_PREFIX + id);
39
+ }
40
+ /** 读取条目的元信息 */
41
+ function readMeta(id) {
42
+ const path = entryPath(id);
43
+ const metaPath = `${path}.json`;
44
+ if (!(0, node_fs_1.existsSync)(metaPath))
45
+ return null;
46
+ try {
47
+ const meta = JSON.parse((0, node_fs_1.readFileSync)(metaPath, 'utf8'));
48
+ if (!meta?.name)
49
+ return null;
50
+ return meta;
51
+ }
52
+ catch {
53
+ return null;
54
+ }
55
+ }
56
+ /** 写入条目的元信息 */
57
+ function writeMeta(entry) {
58
+ (0, node_fs_1.writeFileSync)(`${entryPath(entry.id)}.json`, JSON.stringify(entry), 'utf8');
59
+ }
60
+ /** 删除条目的元信息文件 */
61
+ function removeMeta(id) {
62
+ try {
63
+ (0, node_fs_1.rmSync)(`${entryPath(id)}.json`, { force: true });
64
+ }
65
+ catch {
66
+ // 忽略清理失败
67
+ }
68
+ }
69
+ /** 彻底移除一个条目 */
70
+ function purge(id) {
71
+ try {
72
+ (0, node_fs_1.rmSync)(entryPath(id), { recursive: true, force: true });
73
+ }
74
+ catch {
75
+ // 忽略清理失败
76
+ }
77
+ removeMeta(id);
78
+ }
79
+ /** 清理过期条目 */
80
+ function cleanup() {
81
+ if (!(0, node_fs_1.existsSync)(trashDir))
82
+ return 0;
83
+ let names;
84
+ try {
85
+ names = (0, node_fs_1.readdirSync)(trashDir);
86
+ }
87
+ catch {
88
+ return 0;
89
+ }
90
+ const now = Date.now();
91
+ let removed = 0;
92
+ for (const name of names) {
93
+ if (!name.startsWith(ENTRY_PREFIX) || !name.endsWith('.json'))
94
+ continue;
95
+ const id = name.slice(ENTRY_PREFIX.length, -'.json'.length);
96
+ const meta = readMeta(id);
97
+ if (!meta) {
98
+ // 元信息丢失,清掉残留
99
+ purge(id);
100
+ removed++;
101
+ continue;
102
+ }
103
+ if (meta.expiresAt <= now) {
104
+ purge(id);
105
+ removed++;
106
+ }
107
+ }
108
+ return removed;
109
+ }
110
+ const timer = setInterval(() => {
111
+ try {
112
+ cleanup();
113
+ }
114
+ catch {
115
+ // 清理失败不影响服务
116
+ }
117
+ }, intervalMs);
118
+ timer.unref?.();
119
+ return {
120
+ add(relPath) {
121
+ ensureDir();
122
+ const src = (0, node_path_1.join)(dir, ...relPath.split('/'));
123
+ if (!(0, node_fs_1.existsSync)(src))
124
+ return null;
125
+ let size = 0;
126
+ try {
127
+ const st = (0, node_fs_1.statSync)(src);
128
+ size = st.isFile() ? st.size : 0;
129
+ }
130
+ catch {
131
+ size = 0;
132
+ }
133
+ const id = `${Date.now().toString(36)}-${(0, node_crypto_1.randomBytes)(4).toString('hex')}`;
134
+ const now = Date.now();
135
+ const entry = {
136
+ id,
137
+ name: relPath,
138
+ size,
139
+ deletedAt: now,
140
+ expiresAt: now + getTtl(),
141
+ };
142
+ try {
143
+ // 移动到回收站;若跨设备失败则退化为复制
144
+ try {
145
+ (0, node_fs_1.renameSync)(src, entryPath(id));
146
+ }
147
+ catch {
148
+ (0, node_fs_1.copyFileSync)(src, entryPath(id));
149
+ (0, node_fs_1.rmSync)(src, { recursive: true, force: true });
150
+ }
151
+ }
152
+ catch {
153
+ return null;
154
+ }
155
+ writeMeta(entry);
156
+ return entry;
157
+ },
158
+ restore(id) {
159
+ const meta = readMeta(id);
160
+ if (!meta)
161
+ return null;
162
+ const src = entryPath(id);
163
+ if (!(0, node_fs_1.existsSync)(src)) {
164
+ removeMeta(id);
165
+ return null;
166
+ }
167
+ const dest = (0, node_path_1.join)(dir, ...meta.name.split('/'));
168
+ try {
169
+ const parent = dest.slice(0, dest.length - meta.name.split('/').pop().length);
170
+ if (!(0, node_fs_1.existsSync)(parent))
171
+ (0, node_fs_1.mkdirSync)(parent, { recursive: true });
172
+ // 原位置已被占用时自动改名,避免覆盖。只改文件名部分,扩展名按最后一个点切分(无点则整体作为文件名)
173
+ const parts = meta.name.split('/');
174
+ const fileName = parts.pop() || '';
175
+ const dot = fileName.lastIndexOf('.');
176
+ const ext = dot > 0 ? fileName.slice(dot) : '';
177
+ const base = dot > 0 ? fileName.slice(0, dot) : fileName;
178
+ let finalDest = dest;
179
+ let i = 1;
180
+ while ((0, node_fs_1.existsSync)(finalDest)) {
181
+ const renamed = ext ? `${base}_${i}${ext}` : `${fileName}_${i}`;
182
+ finalDest = (0, node_path_1.join)(dir, ...parts, renamed);
183
+ i += 1;
184
+ }
185
+ try {
186
+ (0, node_fs_1.renameSync)(src, finalDest);
187
+ }
188
+ catch {
189
+ (0, node_fs_1.copyFileSync)(src, finalDest);
190
+ (0, node_fs_1.rmSync)(src, { recursive: true, force: true });
191
+ }
192
+ removeMeta(id);
193
+ // 返回还原后的相对路径
194
+ const rel = finalDest
195
+ .slice(dir.length)
196
+ .replace(/^[\\/]+/, '')
197
+ .split(/[\\/]+/)
198
+ .join('/');
199
+ return rel;
200
+ }
201
+ catch {
202
+ return null;
203
+ }
204
+ },
205
+ remove(id) {
206
+ const meta = readMeta(id);
207
+ if (!meta)
208
+ return false;
209
+ purge(id);
210
+ return true;
211
+ },
212
+ empty() {
213
+ if (!(0, node_fs_1.existsSync)(trashDir))
214
+ return 0;
215
+ let names;
216
+ try {
217
+ names = (0, node_fs_1.readdirSync)(trashDir);
218
+ }
219
+ catch {
220
+ return 0;
221
+ }
222
+ let count = 0;
223
+ for (const name of names) {
224
+ // 每个条目由「数据文件 + .json 元信息文件」两个文件组成,
225
+ // 这里只按元信息文件计数,避免重复统计
226
+ if (!name.startsWith(ENTRY_PREFIX) || !name.endsWith('.json'))
227
+ continue;
228
+ const id = name.slice(ENTRY_PREFIX.length, -'.json'.length);
229
+ purge(id);
230
+ count += 1;
231
+ }
232
+ return count;
233
+ },
234
+ list() {
235
+ if (!(0, node_fs_1.existsSync)(trashDir))
236
+ return [];
237
+ let names;
238
+ try {
239
+ names = (0, node_fs_1.readdirSync)(trashDir);
240
+ }
241
+ catch {
242
+ return [];
243
+ }
244
+ const entries = [];
245
+ for (const name of names) {
246
+ if (!name.startsWith(ENTRY_PREFIX) || !name.endsWith('.json'))
247
+ continue;
248
+ const id = name.slice(ENTRY_PREFIX.length, -'.json'.length);
249
+ const meta = readMeta(id);
250
+ if (meta)
251
+ entries.push(meta);
252
+ }
253
+ entries.sort((a, b) => b.deletedAt - a.deletedAt);
254
+ return entries;
255
+ },
256
+ cleanup,
257
+ stop() {
258
+ clearInterval(timer);
259
+ },
260
+ };
261
+ }
@@ -0,0 +1,50 @@
1
+ import type { Request, Response } from 'express';
2
+ import { type Role } from './auth';
3
+ export interface WebDavOptions {
4
+ /** 存储目录 */
5
+ dir: string;
6
+ /** 是否配置了访问令牌。传入函数表示运行时取值 */
7
+ hasToken?: () => boolean;
8
+ /**
9
+ * 校验访问令牌(明文或摘要均可)。
10
+ * WebDAV 客户端只能用 Basic Auth 传明文,服务端用盐值现场算摘要再比对。
11
+ */
12
+ verifyToken?: (presented: string) => boolean;
13
+ /**
14
+ * 校验明文口令,返回匹配到的角色(admin / visitor / open / guest),不匹配返回 null。
15
+ * 传入函数表示运行时取值
16
+ */
17
+ verifyPlain?: (plaintext: string) => Role | null;
18
+ /** 是否未配置任何口令(开放模式)。传入函数表示运行时取值 */
19
+ isOpen?: () => boolean;
20
+ /** 是否配置了访客口令(决定未认证客户端能否上传)。传入函数表示运行时取值 */
21
+ hasVisitor?: () => boolean;
22
+ /** 禁止上传的扩展名(含点,如 .php)。传入函数表示运行时取值 */
23
+ blockExtensions?: string[] | (() => string[]);
24
+ /** 存储总容量上限(字节),0 表示不限制。传入函数表示运行时取值 */
25
+ maxTotalSize?: number | (() => number);
26
+ /** 单文件大小上限(字节)。传入函数表示运行时取值 */
27
+ maxSize?: number | (() => number);
28
+ /** 挂载路径前缀,如 /localsend/dav */
29
+ basePath?: string;
30
+ /**
31
+ * 写操作回调:WebDAV 侧的删除 / 上传 / 移动同样需要审计。
32
+ * role 是本次请求解析出的身份,交由调用方决定日志字段。
33
+ */
34
+ onWrite?: (action: string, target: string, req: Request, role: Role) => void;
35
+ }
36
+ /** 计算目录下所有文件的总大小(字节),与上传接口保持一致 */
37
+ export declare function davDirSize(target: string): number;
38
+ /**
39
+ * 校验 Basic Auth。
40
+ * 未配置令牌时直接放行;配置后要求用户名为 localsend、密码为令牌。
41
+ *
42
+ * @deprecated 令牌已改为摘要校验,WebDAV 处理函数内部直接调用 verifyToken
43
+ */
44
+ export declare function checkDavAuth(req: Request, token: string): boolean;
45
+ /** 生成 PROPFIND 的 207 响应 */
46
+ export declare function buildMultistatus(baseUrl: string, dir: string, relPath: string, depth: number): string;
47
+ /**
48
+ * 生成 WebDAV 处理函数
49
+ */
50
+ export declare function createWebDavHandler(options: WebDavOptions): (req: Request, res: Response) => Promise<void>;