npm - @xopcai/xopc - Versions diffs - 0.0.84 → 0.0.86 - Mend

@xopcai/xopc 0.0.84 → 0.0.86

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 (418) hide show

package/dist/src/share/share-landing.js CHANGED Viewed

@@ -8,51 +8,179 @@ function formatFileSize(bytes) {
 function escapeHtml(text) {
 	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-/** Render the download confirmation landing page (does not consume viewCount). */
-function renderShareLandingPage(record, downloadPath) {
+function commonCss() {
+	return `
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:flex-start;justify-content:center;padding:1rem}
+.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:720px;width:100%;box-shadow:0 1px 3px rgba(0,0,0,.06);margin:1rem 0}
+.icon{font-size:2.5rem;margin-bottom:1rem;text-align:center}
+.name{font-size:1.125rem;font-weight:600;word-break:break-all;text-align:center;margin-bottom:.5rem}
+.meta{font-size:.875rem;color:#64748b;text-align:center;margin-bottom:.25rem}
+.desc{font-size:.875rem;color:#475569;margin:1rem 0;padding:.75rem;background:#f1f5f9;border-radius:8px}
+.btn{display:inline-block;padding:.6rem 1.4rem;background:#2563eb;color:#fff;text-decoration:none;border-radius:8px;font-weight:500;font-size:.95rem;border:none;cursor:pointer;transition:background .15s;margin:.25rem}
+.btn.secondary{background:#475569}
+.btn:hover{filter:brightness(1.1)}
+.footer{margin-top:1.5rem;font-size:.75rem;color:#94a3b8;text-align:center}
+.actions{text-align:center;margin-top:1.5rem}
+.crumb{font-size:.85rem;color:#475569;margin-bottom:1rem}
+.crumb a{color:#2563eb;text-decoration:none}
+.crumb a:hover{text-decoration:underline}
+.tree{border-top:1px solid #e2e8f0;margin-top:1rem}
+.row{display:flex;align-items:center;justify-content:space-between;padding:.55rem .25rem;border-bottom:1px solid #f1f5f9}
+.row a{text-decoration:none;color:#1e293b;flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}
+.row a:hover{color:#2563eb}
+.row .size{color:#94a3b8;font-size:.8rem;margin-left:.75rem;white-space:nowrap}
+.row .act{display:flex;gap:.5rem;align-items:center}
+.row .act a{font-size:.8rem;color:#2563eb;flex:none}
+.empty{text-align:center;color:#94a3b8;padding:2rem}
+`;
+}
+/** Render the file download confirmation landing page (does not consume downloadCount). */
+function renderShareLandingPage(record, downloadPath, options) {
 	const fileName = escapeHtml(record.fileName);
 	const description = record.description ? escapeHtml(record.description) : "";
+	const size = formatFileSize(record.fileSize);
+	const expiresDate = new Date(record.expiresAt).toLocaleDateString("zh-CN", {
+		year: "numeric",
+		month: "long",
+		day: "numeric",
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+	const buttons = [];
+	if (options?.previewUrl) buttons.push(`<a class="btn" href="${escapeHtml(options.previewUrl)}" target="_blank" rel="noopener">👁 在线预览</a>`);
+	if (options?.inlineUrl) buttons.push(`<a class="btn secondary" href="${escapeHtml(options.inlineUrl)}" target="_blank" rel="noopener">↗ 在线打开</a>`);
+	buttons.push(`<form method="POST" action="${escapeHtml(downloadPath)}" style="display:inline">
+<button type="submit" class="btn ${buttons.length > 0 ? "secondary" : ""}">⬇ 下载文件</button>
+</form>`);
 	return `<!DOCTYPE html>
 <html lang="zh">
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <meta name="referrer" content="no-referrer">
-<meta name="robots" content="noindex,nofollow">
+<meta name="robots" content="noindex,follow">
+${renderOgTags({
+		title: escapeHtml(options?.og?.title ?? record.fileName),
+		description: escapeHtml(options?.og?.description ?? `${size} · 由 xopc 分享`),
+		url: options?.og?.absoluteShareUrl ?? null,
+		image: options?.og?.absoluteThumbnailUrl ?? null
+	})}
 <title>${fileName} — xopc Share</title>
-<style>
-*{margin:0;padding:0;box-sizing:border-box}
-body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:1rem}
-.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:420px;width:100%;text-align:center;box-shadow:0 1px 3px rgba(0,0,0,.06)}
-.icon{font-size:2.5rem;margin-bottom:1rem}
-.name{font-size:1.125rem;font-weight:600;word-break:break-all;margin-bottom:.5rem}
-.meta{font-size:.875rem;color:#64748b;margin-bottom:.25rem}
-.desc{font-size:.875rem;color:#475569;margin:1rem 0;padding:.75rem;background:#f1f5f9;border-radius:8px;text-align:left}
-.btn{display:inline-block;margin-top:1.5rem;padding:.75rem 2rem;background:#2563eb;color:#fff;text-decoration:none;border-radius:8px;font-weight:500;font-size:1rem;border:none;cursor:pointer;transition:background .15s}
-.btn:hover{background:#1d4ed8}
-.footer{margin-top:1.5rem;font-size:.75rem;color:#94a3b8}
-</style>
+<style>${commonCss()}</style>
 </head>
 <body>
 <div class="card">
 <div class="icon">📄</div>
 <div class="name">${fileName}</div>
-<div class="meta">${formatFileSize(record.fileSize)} · 有效期至 ${new Date(record.expiresAt).toLocaleDateString("zh-CN", {
+<div class="meta">${size} · 有效期至 ${expiresDate}</div>
+${description ? `<div class="desc">${description}</div>` : ""}
+<div class="actions">
+${buttons.join("\n")}
+</div>
+<div class="footer">Shared via xopc</div>
+</div>
+</body>
+</html>`;
+}
+/** Emit OG / Twitter / WeChat-compatible meta tags. Only emitted when url+image present. */
+function renderOgTags(opts) {
+	if (!opts.url || !opts.image) return "";
+	return [
+		`<meta property="og:type" content="website">`,
+		`<meta property="og:site_name" content="xopc Share">`,
+		`<meta property="og:title" content="${opts.title}">`,
+		`<meta property="og:description" content="${opts.description}">`,
+		`<meta property="og:image" content="${escapeHtml(opts.image)}">`,
+		`<meta property="og:image:width" content="1200">`,
+		`<meta property="og:image:height" content="630">`,
+		`<meta property="og:url" content="${escapeHtml(opts.url)}">`,
+		`<meta itemprop="name" content="${opts.title}">`,
+		`<meta itemprop="description" content="${opts.description}">`,
+		`<meta itemprop="image" content="${escapeHtml(opts.image)}">`,
+		`<meta name="twitter:card" content="summary_large_image">`
+	].join("\n");
+}
+/** Render the folder landing page (browse mode shows a tree, zip-only shows a single button). */
+function renderFolderLandingPage(record, listing, urls, options) {
+	const folderName = escapeHtml(record.fileName);
+	const description = record.description ? escapeHtml(record.description) : "";
+	const totalSize = formatFileSize(record.fileSize);
+	const entryCount = record.directory?.entryCount ?? 0;
+	const expiresDate = new Date(record.expiresAt).toLocaleDateString("zh-CN", {
 		year: "numeric",
 		month: "long",
 		day: "numeric",
 		hour: "2-digit",
 		minute: "2-digit"
-	})}</div>
+	});
+	const zipOnly = record.directory?.mode === "zip-only" || !listing;
+	const zipUrl = urls.zip("");
+	const treeHtml = zipOnly ? "" : renderTree(listing, urls);
+	const breadcrumbs = zipOnly ? "" : renderBreadcrumbs(listing.path, urls);
+	return `<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<meta name="referrer" content="no-referrer">
+<meta name="robots" content="noindex,follow">
+${renderOgTags({
+		title: escapeHtml(options?.og?.title ?? record.fileName),
+		description: escapeHtml(options?.og?.description ?? `${entryCount} 项 · ${totalSize}`),
+		url: options?.og?.absoluteShareUrl ?? null,
+		image: options?.og?.absoluteThumbnailUrl ?? null
+	})}
+<title>${folderName} — xopc Share</title>
+<style>${commonCss()}</style>
+</head>
+<body>
+<div class="card">
+<div class="icon">📁</div>
+<div class="name">${folderName}</div>
+<div class="meta">${entryCount} 项 · ${totalSize} · 有效期至 ${expiresDate}</div>
 ${description ? `<div class="desc">${description}</div>` : ""}
-<form method="POST" action="${escapeHtml(downloadPath)}">
-<button type="submit" class="btn">⬇ 下载文件</button>
-</form>
+<div class="actions">
+<a class="btn" href="${escapeHtml(zipUrl)}">⬇ 下载全部为 ZIP</a>
+</div>
+${breadcrumbs}
+${treeHtml}
 <div class="footer">Shared via xopc</div>
 </div>
 </body>
 </html>`;
 }
+function renderBreadcrumbs(currentPath, urls) {
+	if (!currentPath) return "<div class=\"crumb\"><a href=\"" + escapeHtml(urls.tree("")) + "\">/ 根目录</a></div>";
+	const segments = currentPath.split("/").filter(Boolean);
+	const links = [`<a href="${escapeHtml(urls.tree(""))}">/ 根目录</a>`];
+	let cumulative = "";
+	for (const seg of segments) {
+		cumulative = cumulative ? `${cumulative}/${seg}` : seg;
+		links.push(`<a href="${escapeHtml(urls.tree(cumulative))}">${escapeHtml(seg)}</a>`);
+	}
+	return `<div class="crumb">${links.join(" / ")}</div>`;
+}
+function renderTree(listing, urls) {
+	if (listing.entries.length === 0) return "<div class=\"tree\"><div class=\"empty\">空目录</div></div>";
+	return `<div class="tree">${listing.entries.map((entry) => renderTreeRow(entry, urls)).join("")}${listing.truncated ? "<div class=\"empty\">列表过长已截断（仍可通过 URL 访问子目录）</div>" : ""}</div>`;
+}
+function renderTreeRow(entry, urls) {
+	const safeName = escapeHtml(entry.name);
+	if (entry.isDirectory) return `<div class="row">
+<a href="${escapeHtml(urls.tree(entry.path))}"><span>📁</span><span>${safeName}/</span></a>
+<div class="act">
+<a href="${escapeHtml(urls.zip(entry.path))}">ZIP</a>
+</div>
+</div>`;
+	return `<div class="row">
+<a href="${escapeHtml(urls.file(entry.path))}"><span>📄</span><span>${safeName}</span></a>
+<div class="act">
+<span class="size">${formatFileSize(entry.size)}</span>
+<a href="${escapeHtml(urls.file(entry.path))}?dl=1">下载</a>
+</div>
+</div>`;
+}
 /** Render the "share no longer valid" page — does NOT reveal file name or path. */
 function renderShareExpiredPage(reason) {
 	const reasons = {
@@ -62,6 +190,7 @@ function renderShareExpiredPage(reason) {
 		not_found: "链接无效或已失效",
 		file_deleted: "分享的文件已不存在"
 	};
+	const reasonText = reasons[reason] ?? reasons.not_found;
 	return `<!DOCTYPE html>
 <html lang="zh">
 <head>
@@ -70,27 +199,19 @@ function renderShareExpiredPage(reason) {
 <meta name="referrer" content="no-referrer">
 <meta name="robots" content="noindex,nofollow">
 <title>分享已失效 — xopc</title>
-<style>
-*{margin:0;padding:0;box-sizing:border-box}
-body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:1rem}
-.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:420px;width:100%;text-align:center;box-shadow:0 1px 3px rgba(0,0,0,.06)}
-.icon{font-size:2.5rem;margin-bottom:1rem}
-h1{font-size:1.125rem;font-weight:600;margin-bottom:1rem}
-.reason{font-size:.875rem;color:#64748b;margin-bottom:1rem}
-.hint{font-size:.8125rem;color:#94a3b8;margin-top:1rem}
-</style>
+<style>${commonCss()}</style>
 </head>
 <body>
-<div class="card">
+<div class="card" style="max-width:420px;text-align:center">
 <div class="icon">⚠️</div>
-<h1>此分享链接已失效</h1>
-<div class="reason">${reasons[reason] ?? reasons.not_found}</div>
-<div class="hint">如需访问请联系分享者获取新链接</div>
+<h1 style="font-size:1.125rem;font-weight:600;margin-bottom:1rem">此分享链接已失效</h1>
+<div class="meta">${reasonText}</div>
+<div class="footer">如需访问请联系分享者获取新链接</div>
 </div>
 </body>
 </html>`;
 }
 //#endregion
-export { renderShareExpiredPage, renderShareLandingPage };
+export { renderFolderLandingPage, renderShareExpiredPage, renderShareLandingPage };
 //# sourceMappingURL=share-landing.js.map

package/dist/src/share/share-landing.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"share-landing.js","names":[],"sources":["../../../src/share/share-landing.ts"],"sourcesContent":["import type { ShareRecord } from './share-types.js';\n\nfunction formatFileSize(bytes: number): string {\n if (bytes < 1024) return `${bytes} B`;\n if (bytes < 1_048_576) return `${(bytes / 1024).toFixed(1)} KB`;\n if (bytes < 1_073_741_824) return `${(bytes / 1_048_576).toFixed(1)} MB`;\n return `${(bytes / 1_073_741_824).toFixed(1)} GB`;\n}\n\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\n/** Render the download confirmation landing page (does not consume viewCount). /\nexport function renderShareLandingPage(record: ShareRecord, downloadPath: string): string {\n const fileName = escapeHtml(record.fileName);\n const description = record.description ? escapeHtml(record.description) : '';\n const size = formatFileSize(record.fileSize);\n const expiresDate = new Date(record.expiresAt).toLocaleDateString('zh-CN', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n hour: '2-digit',\n minute: '2-digit',\n });\n\n return `<!DOCTYPE html>\n<html lang=\"zh\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"referrer\" content=\"no-referrer\">\n<meta name=\"robots\" content=\"noindex,nofollow\">\n<title>${fileName} — xopc Share</title>\n<style>\n{margin:0;padding:0;box-sizing:border-box}\nbody{font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:1rem}\n.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:420px;width:100%;text-align:center;box-shadow:0 1px 3px rgba(0,0,0,.06)}\n.icon{font-size:2.5rem;margin-bottom:1rem}\n.name{font-size:1.125rem;font-weight:600;word-break:break-all;margin-bottom:.5rem}\n.meta{font-size:.875rem;color:#64748b;margin-bottom:.25rem}\n.desc{font-size:.875rem;color:#475569;margin:1rem 0;padding:.75rem;background:#f1f5f9;border-radius:8px;text-align:left}\n.btn{display:inline-block;margin-top:1.5rem;padding:.75rem 2rem;background:#2563eb;color:#fff;text-decoration:none;border-radius:8px;font-weight:500;font-size:1rem;border:none;cursor:pointer;transition:background .15s}\n.btn:hover{background:#1d4ed8}\n.footer{margin-top:1.5rem;font-size:.75rem;color:#94a3b8}\n</style>\n</head>\n<body>\n<div class=\"card\">\n<div class=\"icon\">📄</div>\n<div class=\"name\">${fileName}</div>\n<div class=\"meta\">${size} · 有效期至 ${expiresDate}</div>\n${description ? `<div class=\"desc\">${description}</div>` : ''}\n<form method=\"POST\" action=\"${escapeHtml(downloadPath)}\">\n<button type=\"submit\" class=\"btn\">⬇ 下载文件</button>\n</form>\n<div class=\"footer\">Shared via xopc</div>\n</div>\n</body>\n</html>`;\n}\n\nexport type ShareExpiredReason = 'expired' \| 'revoked' \| 'max_views' \| 'not_found' \| 'file_deleted';\n\n/** Render the \"share no longer valid\" page — does NOT reveal file name or path. /\nexport function renderShareExpiredPage(reason: ShareExpiredReason): string {\n const reasons: Record<ShareExpiredReason, string> = {\n expired: '链接已过期',\n revoked: '链接已被创建者撤销',\n max_views: '已达最大访问次数',\n not_found: '链接无效或已失效',\n file_deleted: '分享的文件已不存在',\n };\n const reasonText = reasons[reason] ?? reasons.not_found;\n\n return `<!DOCTYPE html>\n<html lang=\"zh\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"referrer\" content=\"no-referrer\">\n<meta name=\"robots\" content=\"noindex,nofollow\">\n<title>分享已失效 — xopc</title>\n<style>\n{margin:0;padding:0;box-sizing:border-box}\nbody{font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:1rem}\n.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:420px;width:100%;text-align:center;box-shadow:0 1px 3px rgba(0,0,0,.06)}\n.icon{font-size:2.5rem;margin-bottom:1rem}\nh1{font-size:1.125rem;font-weight:600;margin-bottom:1rem}\n.reason{font-size:.875rem;color:#64748b;margin-bottom:1rem}\n.hint{font-size:.8125rem;color:#94a3b8;margin-top:1rem}\n</style>\n</head>\n<body>\n<div class=\"card\">\n<div class=\"icon\">⚠️</div>\n<h1>此分享链接已失效</h1>\n<div class=\"reason\">${reasonText}</div>\n<div class=\"hint\">如需访问请联系分享者获取新链接</div>\n</div>\n</body>\n</html>`;\n}\n"],"mappings":";AAEA,SAAS,eAAe,OAAuB;AAC7C,KAAI,QAAQ,KAAM,QAAO,GAAG,MAAM;AAClC,KAAI,QAAQ,QAAW,QAAO,IAAI,QAAQ,MAAM,QAAQ,EAAE,CAAC;AAC3D,KAAI,QAAQ,WAAe,QAAO,IAAI,QAAQ,SAAW,QAAQ,EAAE,CAAC;AACpE,QAAO,IAAI,QAAQ,YAAe,QAAQ,EAAE,CAAC;;AAG/C,SAAS,WAAW,MAAsB;AACxC,QAAO,KACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS,CACvB,QAAQ,MAAM,QAAQ;;;AAI3B,SAAgB,uBAAuB,QAAqB,cAA8B;CACxF,MAAM,WAAW,WAAW,OAAO,SAAS;CAC5C,MAAM,cAAc,OAAO,cAAc,WAAW,OAAO,YAAY,GAAG;AAU1E,QAAO;;;;;;;SAOA,SAAS;;;;;;;;;;;;;;;;;oBAiBE,SAAS;oBAjCd,eAAe,OAAO,SAkCb,CAAC,UAjCH,IAAI,KAAK,OAAO,UAAU,CAAC,mBAAmB,SAAS;EACzE,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT,CA2B2C,CAAC;EAC7C,cAAc,qBAAqB,YAAY,UAAU,GAAG;8BAChC,WAAW,aAAa,CAAC;;;;;;;;;AAYvD,SAAgB,uBAAuB,QAAoC;CACzE,MAAM,UAA8C;EAClD,SAAS;EACT,SAAS;EACT,WAAW;EACX,WAAW;EACX,cAAc;EACf;AAGD,QAAO;;;;;;;;;;;;;;;;;;;;;;sBAFY,QAAQ,WAAW,QAAQ,UAwBf"}
1	+ {"version":3,"file":"share-landing.js","names":[],"sources":["../../../src/share/share-landing.ts"],"sourcesContent":["import type { DirectoryListing, DirectoryListingEntry } from './share-store.js';\nimport type { ShareRecord } from './share-types.js';\n\nfunction formatFileSize(bytes: number): string {\n if (bytes < 1024) return `${bytes} B`;\n if (bytes < 1_048_576) return `${(bytes / 1024).toFixed(1)} KB`;\n if (bytes < 1_073_741_824) return `${(bytes / 1_048_576).toFixed(1)} MB`;\n return `${(bytes / 1_073_741_824).toFixed(1)} GB`;\n}\n\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, '&')\n .replace(/</g, '<')\n .replace(/>/g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction commonCss(): string {\n return `\n{margin:0;padding:0;box-sizing:border-box}\nbody{font-family:-apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,sans-serif;background:#f8fafc;color:#1e293b;min-height:100vh;display:flex;align-items:flex-start;justify-content:center;padding:1rem}\n.card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:2rem;max-width:720px;width:100%;box-shadow:0 1px 3px rgba(0,0,0,.06);margin:1rem 0}\n.icon{font-size:2.5rem;margin-bottom:1rem;text-align:center}\n.name{font-size:1.125rem;font-weight:600;word-break:break-all;text-align:center;margin-bottom:.5rem}\n.meta{font-size:.875rem;color:#64748b;text-align:center;margin-bottom:.25rem}\n.desc{font-size:.875rem;color:#475569;margin:1rem 0;padding:.75rem;background:#f1f5f9;border-radius:8px}\n.btn{display:inline-block;padding:.6rem 1.4rem;background:#2563eb;color:#fff;text-decoration:none;border-radius:8px;font-weight:500;font-size:.95rem;border:none;cursor:pointer;transition:background .15s;margin:.25rem}\n.btn.secondary{background:#475569}\n.btn:hover{filter:brightness(1.1)}\n.footer{margin-top:1.5rem;font-size:.75rem;color:#94a3b8;text-align:center}\n.actions{text-align:center;margin-top:1.5rem}\n.crumb{font-size:.85rem;color:#475569;margin-bottom:1rem}\n.crumb a{color:#2563eb;text-decoration:none}\n.crumb a:hover{text-decoration:underline}\n.tree{border-top:1px solid #e2e8f0;margin-top:1rem}\n.row{display:flex;align-items:center;justify-content:space-between;padding:.55rem .25rem;border-bottom:1px solid #f1f5f9}\n.row a{text-decoration:none;color:#1e293b;flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}\n.row a:hover{color:#2563eb}\n.row .size{color:#94a3b8;font-size:.8rem;margin-left:.75rem;white-space:nowrap}\n.row .act{display:flex;gap:.5rem;align-items:center}\n.row .act a{font-size:.8rem;color:#2563eb;flex:none}\n.empty{text-align:center;color:#94a3b8;padding:2rem}\n`;\n}\n\nexport interface ShareLandingOgOptions {\n /* Absolute https/http URL of this landing page (for og:url). Omit if non-public. /\n absoluteShareUrl?: string \| null;\n /* Absolute URL of the thumbnail image (for og:image). Omit if non-public. /\n absoluteThumbnailUrl?: string \| null;\n /* Title override (default: fileName). /\n title?: string;\n /* Description override (default: type + size). /\n description?: string;\n}\n\n/* Render the file download confirmation landing page (does not consume downloadCount). /\nexport function renderShareLandingPage(\n record: ShareRecord,\n downloadPath: string,\n options?: {\n /* Path to open the file inline (?inline=1) for browser-native rendering. /\n inlineUrl?: string \| null;\n /* SPA preview URL (for markdown / docs / code that benefit from rich rendering). /\n previewUrl?: string \| null;\n /* Social card / unfurl metadata. /\n og?: ShareLandingOgOptions;\n },\n): string {\n const fileName = escapeHtml(record.fileName);\n const description = record.description ? escapeHtml(record.description) : '';\n const size = formatFileSize(record.fileSize);\n const expiresDate = new Date(record.expiresAt).toLocaleDateString('zh-CN', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n hour: '2-digit',\n minute: '2-digit',\n });\n\n const buttons: string[] = [];\n if (options?.previewUrl) {\n buttons.push(\n `<a class=\"btn\" href=\"${escapeHtml(options.previewUrl)}\" target=\"_blank\" rel=\"noopener\">👁 在线预览</a>`,\n );\n }\n if (options?.inlineUrl) {\n buttons.push(\n `<a class=\"btn secondary\" href=\"${escapeHtml(options.inlineUrl)}\" target=\"_blank\" rel=\"noopener\">↗ 在线打开</a>`,\n );\n }\n buttons.push(\n `<form method=\"POST\" action=\"${escapeHtml(downloadPath)}\" style=\"display:inline\">\n<button type=\"submit\" class=\"btn ${buttons.length > 0 ? 'secondary' : ''}\">⬇ 下载文件</button>\n</form>`,\n );\n\n const ogTitle = escapeHtml(options?.og?.title ?? record.fileName);\n const ogDesc = escapeHtml(options?.og?.description ?? `${size} · 由 xopc 分享`);\n const ogTags = renderOgTags({\n title: ogTitle,\n description: ogDesc,\n url: options?.og?.absoluteShareUrl ?? null,\n image: options?.og?.absoluteThumbnailUrl ?? null,\n });\n\n return `<!DOCTYPE html>\n<html lang=\"zh\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"referrer\" content=\"no-referrer\">\n<meta name=\"robots\" content=\"noindex,follow\">\n${ogTags}\n<title>${fileName} — xopc Share</title>\n<style>${commonCss()}</style>\n</head>\n<body>\n<div class=\"card\">\n<div class=\"icon\">📄</div>\n<div class=\"name\">${fileName}</div>\n<div class=\"meta\">${size} · 有效期至 ${expiresDate}</div>\n${description ? `<div class=\"desc\">${description}</div>` : ''}\n<div class=\"actions\">\n${buttons.join('\\n')}\n</div>\n<div class=\"footer\">Shared via xopc</div>\n</div>\n</body>\n</html>`;\n}\n\n/* Emit OG / Twitter / WeChat-compatible meta tags. Only emitted when url+image present. /\nfunction renderOgTags(opts: { title: string; description: string; url: string \| null; image: string \| null }): string {\n if (!opts.url \|\| !opts.image) return '';\n return [\n `<meta property=\"og:type\" content=\"website\">`,\n `<meta property=\"og:site_name\" content=\"xopc Share\">`,\n `<meta property=\"og:title\" content=\"${opts.title}\">`,\n `<meta property=\"og:description\" content=\"${opts.description}\">`,\n `<meta property=\"og:image\" content=\"${escapeHtml(opts.image)}\">`,\n `<meta property=\"og:image:width\" content=\"1200\">`,\n `<meta property=\"og:image:height\" content=\"630\">`,\n `<meta property=\"og:url\" content=\"${escapeHtml(opts.url)}\">`,\n `<meta itemprop=\"name\" content=\"${opts.title}\">`,\n `<meta itemprop=\"description\" content=\"${opts.description}\">`,\n `<meta itemprop=\"image\" content=\"${escapeHtml(opts.image)}\">`,\n `<meta name=\"twitter:card\" content=\"summary_large_image\">`,\n ].join('\\n');\n}\n\n/* Render the folder landing page (browse mode shows a tree, zip-only shows a single button). /\nexport function renderFolderLandingPage(\n record: ShareRecord,\n listing: DirectoryListing \| null,\n urls: { tree: (path: string) => string; file: (path: string) => string; zip: (path: string) => string },\n options?: { og?: ShareLandingOgOptions },\n): string {\n const folderName = escapeHtml(record.fileName);\n const description = record.description ? escapeHtml(record.description) : '';\n const totalSize = formatFileSize(record.fileSize);\n const entryCount = record.directory?.entryCount ?? 0;\n const expiresDate = new Date(record.expiresAt).toLocaleDateString('zh-CN', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n hour: '2-digit',\n minute: '2-digit',\n });\n const zipOnly = record.directory?.mode === 'zip-only' \|\| !listing;\n const zipUrl = urls.zip('');\n\n const treeHtml = zipOnly ? '' : renderTree(listing!, urls);\n const breadcrumbs = zipOnly ? '' : renderBreadcrumbs(listing!.path, urls);\n\n const ogTitle = escapeHtml(options?.og?.title ?? record.fileName);\n const ogDesc = escapeHtml(options?.og?.description ?? `${entryCount} 项 · ${totalSize}`);\n const ogTags = renderOgTags({\n title: ogTitle,\n description: ogDesc,\n url: options?.og?.absoluteShareUrl ?? null,\n image: options?.og?.absoluteThumbnailUrl ?? null,\n });\n\n return `<!DOCTYPE html>\n<html lang=\"zh\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"referrer\" content=\"no-referrer\">\n<meta name=\"robots\" content=\"noindex,follow\">\n${ogTags}\n<title>${folderName} — xopc Share</title>\n<style>${commonCss()}</style>\n</head>\n<body>\n<div class=\"card\">\n<div class=\"icon\">📁</div>\n<div class=\"name\">${folderName}</div>\n<div class=\"meta\">${entryCount} 项 · ${totalSize} · 有效期至 ${expiresDate}</div>\n${description ? `<div class=\"desc\">${description}</div>` : ''}\n<div class=\"actions\">\n<a class=\"btn\" href=\"${escapeHtml(zipUrl)}\">⬇ 下载全部为 ZIP</a>\n</div>\n${breadcrumbs}\n${treeHtml}\n<div class=\"footer\">Shared via xopc</div>\n</div>\n</body>\n</html>`;\n}\n\nfunction renderBreadcrumbs(\n currentPath: string,\n urls: { tree: (path: string) => string },\n): string {\n if (!currentPath) return '<div class=\"crumb\"><a href=\"' + escapeHtml(urls.tree('')) + '\">/ 根目录</a></div>';\n const segments = currentPath.split('/').filter(Boolean);\n const links: string[] = [`<a href=\"${escapeHtml(urls.tree(''))}\">/ 根目录</a>`];\n let cumulative = '';\n for (const seg of segments) {\n cumulative = cumulative ? `${cumulative}/${seg}` : seg;\n links.push(`<a href=\"${escapeHtml(urls.tree(cumulative))}\">${escapeHtml(seg)}</a>`);\n }\n return `<div class=\"crumb\">${links.join(' / ')}</div>`;\n}\n\nfunction renderTree(\n listing: DirectoryListing,\n urls: { tree: (path: string) => string; file: (path: string) => string; zip: (path: string) => string },\n): string {\n if (listing.entries.length === 0) {\n return '<div class=\"tree\"><div class=\"empty\">空目录</div></div>';\n }\n const rows = listing.entries.map((entry) => renderTreeRow(entry, urls)).join('');\n const truncated = listing.truncated\n ? '<div class=\"empty\">列表过长已截断（仍可通过 URL 访问子目录）</div>'\n : '';\n return `<div class=\"tree\">${rows}${truncated}</div>`;\n}\n\nfunction renderTreeRow(\n entry: DirectoryListingEntry,\n urls: { tree: (path: string) => string; file: (path: string) => string; zip: (path: string) => string },\n): string {\n const safeName = escapeHtml(entry.name);\n if (entry.isDirectory) {\n return `<div class=\"row\">\n<a href=\"${escapeHtml(urls.tree(entry.path))}\"><span>📁</span><span>${safeName}/</span></a>\n<div class=\"act\">\n<a href=\"${escapeHtml(urls.zip(entry.path))}\">ZIP</a>\n</div>\n</div>`;\n }\n return `<div class=\"row\">\n<a href=\"${escapeHtml(urls.file(entry.path))}\"><span>📄</span><span>${safeName}</span></a>\n<div class=\"act\">\n<span class=\"size\">${formatFileSize(entry.size)}</span>\n<a href=\"${escapeHtml(urls.file(entry.path))}?dl=1\">下载</a>\n</div>\n</div>`;\n}\n\nexport type ShareExpiredReason = 'expired' \| 'revoked' \| 'max_views' \| 'not_found' \| 'file_deleted';\n\n/* Render the \"share no longer valid\" page — does NOT reveal file name or path. */\nexport function renderShareExpiredPage(reason: ShareExpiredReason): string {\n const reasons: Record<ShareExpiredReason, string> = {\n expired: '链接已过期',\n revoked: '链接已被创建者撤销',\n max_views: '已达最大访问次数',\n not_found: '链接无效或已失效',\n file_deleted: '分享的文件已不存在',\n };\n const reasonText = reasons[reason] ?? reasons.not_found;\n\n return `<!DOCTYPE html>\n<html lang=\"zh\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"referrer\" content=\"no-referrer\">\n<meta name=\"robots\" content=\"noindex,nofollow\">\n<title>分享已失效 — xopc</title>\n<style>${commonCss()}</style>\n</head>\n<body>\n<div class=\"card\" style=\"max-width:420px;text-align:center\">\n<div class=\"icon\">⚠️</div>\n<h1 style=\"font-size:1.125rem;font-weight:600;margin-bottom:1rem\">此分享链接已失效</h1>\n<div class=\"meta\">${reasonText}</div>\n<div class=\"footer\">如需访问请联系分享者获取新链接</div>\n</div>\n</body>\n</html>`;\n}\n"],"mappings":"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"}

package/dist/src/share/share-store.d.ts CHANGED Viewed

@@ -1,18 +1,42 @@
 import type { ShareRecord, ShareConfig, CreateShareParams } from './share-types.js';
+export interface DirectoryListingEntry {
+    name: string;
+    /** Workspace/share-relative POSIX path. */
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    mtime: string;
+    mimeType: string;
+}
+export interface DirectoryListing {
+    /** Share-relative path of the listed dir ('' for root). */
+    path: string;
+    entries: DirectoryListingEntry[];
+    truncated: boolean;
+}
 export declare class ShareStore {
     private shares;
     private tokenIndex;
-    private viewCountDirty;
-    private viewCountTimer;
+    private dirty;
+    private debounceTimer;
     private cleanupTimer;
     private config;
+    private listingCache;
+    /** Optional cleanup hook invoked when a share record is dropped (e.g. delete thumbnail). */
+    private onCleanup;
     constructor(config?: Partial<ShareConfig>);
     updateConfig(config: Partial<ShareConfig>): void;
+    /** Register a cleanup hook (idempotent — last wins). */
+    setCleanupHook(hook: (record: ShareRecord) => void): void;
     getConfig(): ShareConfig;
     create(params: CreateShareParams & {
         workspaceRoot: string;
         gatewayTokenHash: string;
     }): Promise<ShareRecord>;
+    private createFileShare;
+    private createDirectoryShare;
+    private buildRecord;
+    private persistAndAudit;
     getById(id: string): ShareRecord | null;
     getByToken(token: string): ShareRecord | null;
     /** Validate a share is still accessible for download. Returns null reason if valid. */
@@ -20,13 +44,30 @@ export declare class ShareStore {
         valid: boolean;
         reason?: string;
     };
-    /** Increment view count (debounced persist). */
-    incrementViewCount(id: string): void;
+    /** Increment download counter (used by directory & file downloads). Debounced persist. */
+    incrementDownloadCount(id: string): void;
     /** Check if the file still exists and inode matches. */
     validateFileIntegrity(record: ShareRecord): Promise<{
         valid: boolean;
         reason?: string;
     }>;
+    /**
+     * Resolve a child path inside a directory share. Returns the absolute path
+     * if it stays within both the share root and the workspace.
+     */
+    resolveDirectoryChild(record: ShareRecord, relativePath: string): Promise<{
+        ok: true;
+        absolutePath: string;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /** List a single directory level (cached, share-root-relative). */
+    listDirectory(record: ShareRecord, relativePath: string): Promise<DirectoryListing>;
+    /** Update thumbnail status. Persists immediately so generator restart is safe. */
+    setThumbnailStatus(id: string, status: 'pending' | 'ready' | 'failed'): void;
+    /** Drop the listing cache for a share (used on revoke/update). */
+    invalidateListingCache(shareId: string): void;
     revoke(id: string): boolean;
     revokeMany(ids: string[]): number;
     revokeExpired(): number;
@@ -44,5 +85,8 @@ export declare class ShareStore {
     shutdown(): void;
     private resolveAndValidatePath;
 }
+export declare function resolveMimeType(fileName: string): string;
+/** HTTP Content-Type with charset for text-like bodies (browser inline preview). */
+export declare function shareResponseContentType(mime: string): string;
 export declare function getShareStore(config?: Partial<ShareConfig>): ShareStore;
 export declare function resetShareStoreForTests(): void;