@xopcai/xopc 0.0.83 → 0.0.85

package/dist/src/share/share-auto.js

@@ -0,0 +1,247 @@
+import { resolveMimeType } from "./share-store.js";
+import { basename, join, resolve } from "node:path";
+import { readdirSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { copyFile, mkdir, rm, stat } from "node:fs/promises";
+//#region src/share/share-auto.ts
+/**
+* Smart-share decision layer.
+*
+* The mobile app calls POST /api/shares/auto with a path + audience and
+* lets the server pick file-share vs site-share, pick sane TTLs, and bundle
+* the metadata the share-sheet needs (title, description, thumbnail URL,
+* reachability).
+*/
+/** Convert an audience hint into TTL/maxViews defaults. */
+function audienceDefaults(audience) {
+	switch (audience) {
+		case "public": return {
+			ttlMs: 1440 * 6e4,
+			maxViews: 100
+		};
+		case "colleague": return {
+			ttlMs: 10080 * 6e4,
+			maxViews: null
+		};
+		default: return {
+			ttlMs: 4320 * 6e4,
+			maxViews: null
+		};
+	}
+}
+/** Run filesystem probes needed by the routing logic. */
+async function probeShareTarget(workspaceRoot, relPath) {
+	const trimmed = relPath.trim().replace(/\\/g, "/").replace(/^\/+/, "");
+	if (!trimmed) throw new Error("Empty path");
+	if (trimmed.includes("..") || trimmed.includes("\0")) throw new Error("Invalid path");
+	const abs = resolve(workspaceRoot, trimmed);
+	const st = await stat(abs);
+	if (st.isDirectory()) {
+		let hasIndexHtml = false;
+		try {
+			hasIndexHtml = readdirSync(abs).includes("index.html");
+		} catch {}
+		return {
+			absolutePath: abs,
+			kind: "directory",
+			size: 0,
+			mimeType: "application/x-directory",
+			hasIndexHtml
+		};
+	}
+	if (!st.isFile()) throw new Error("Path is not a regular file or directory");
+	const fileName = basename(abs);
+	return {
+		absolutePath: abs,
+		kind: "file",
+		size: st.size,
+		mimeType: resolveMimeType(fileName),
+		hasIndexHtml: false
+	};
+}
+/** Pure decision function — exported for tests. */
+function decideShareKind(probe, mode) {
+	if (mode === "force-file") return forced(probe.kind === "directory" ? "zip" : "file", probe);
+	if (mode === "force-site") {
+		if (probe.kind !== "directory" && probe.mimeType !== "text/html") throw new Error("force-site requires a directory or a single HTML file");
+		return {
+			kind: "site",
+			isDirectory: probe.kind === "directory",
+			reason: "forced",
+			hint: "已按指定方式作为站点分享"
+		};
+	}
+	if (mode === "force-zip") {
+		if (probe.kind !== "directory") throw new Error("force-zip requires a directory");
+		return {
+			kind: "zip",
+			isDirectory: true,
+			reason: "forced",
+			hint: "已按指定方式打包为 ZIP 分享"
+		};
+	}
+	if (probe.kind === "directory") {
+		if (probe.hasIndexHtml) return {
+			kind: "site",
+			isDirectory: true,
+			reason: "html-with-assets",
+			hint: "目录包含 index.html，已通过站点分享渲染"
+		};
+		return {
+			kind: "file",
+			isDirectory: true,
+			reason: "directory-browse",
+			hint: "目录较多文件，通过分享页可浏览或下载 ZIP"
+		};
+	}
+	if (probe.mimeType === "text/html") return {
+		kind: "site",
+		isDirectory: false,
+		reason: "html-single-file",
+		hint: "HTML 文件，分享后朋友点开即渲染"
+	};
+	if (probe.mimeType.startsWith("image/") && probe.size < 10 * 1024 * 1024) return {
+		kind: "file",
+		isDirectory: false,
+		reason: "small-image",
+		hint: "图片文件，朋友可直接预览或保存"
+	};
+	return {
+		kind: "file",
+		isDirectory: false,
+		reason: "large-binary",
+		hint: "通过分享链接由朋友点开下载"
+	};
+}
+function forced(kind, probe) {
+	return {
+		kind,
+		isDirectory: probe.kind === "directory",
+		reason: "forced",
+		hint: "按指定方式分享"
+	};
+}
+/** Build the user-facing title (trimmed, no extension). */
+function makeTitle(fileName, override) {
+	if (override && override.trim()) return clip(override.trim(), 60);
+	const idx = fileName.lastIndexOf(".");
+	return clip((idx > 0 ? fileName.slice(0, idx) : fileName) || fileName, 60);
+}
+/** Build the user-facing description (audience + TTL hint baked in). */
+function makeDescription(opts) {
+	if (opts.override && opts.override.trim()) return clip(opts.override.trim(), 140);
+	const now = Date.now();
+	const exp = new Date(opts.expiresAt).getTime();
+	const days = Math.max(1, Math.round((exp - now) / (1440 * 6e4)));
+	return clip(`由 xopc 生成 · ${opts.audience === "public" ? "公开分享" : opts.audience === "colleague" ? "同事可见" : "好友可见"} · ${days} 天内有效`, 140);
+}
+function clip(text, max) {
+	if (text.length <= max) return text;
+	return `${text.slice(0, max - 1)}…`;
+}
+/** Subfolder under the workspace where single-HTML site shares are staged. */
+const STAGING_DIR_NAME = ".xopc-share-staging";
+/**
+* Copy a single HTML file into `<workspaceRoot>/.xopc-share-staging/<uuid>/index.html`
+* so it can be served as a site (SiteShareStore needs a directory root).
+*
+* The caller must register a cleanup that calls `cleanupStagedSite(stagingDir)`
+* when the underlying site share is revoked / expires.
+*/
+async function stageSingleHtmlAsSite(workspaceRoot, absoluteHtmlPath) {
+	const stagingRoot = resolve(workspaceRoot, STAGING_DIR_NAME);
+	await mkdir(stagingRoot, { recursive: true });
+	const id = randomUUID();
+	const stagingDir = join(stagingRoot, id);
+	await mkdir(stagingDir, { recursive: true });
+	await copyFile(absoluteHtmlPath, join(stagingDir, "index.html"));
+	return {
+		stagingDir,
+		relativePath: `${STAGING_DIR_NAME}/${id}`
+	};
+}
+/** Best-effort cleanup; never throws. */
+async function cleanupStagedSite(stagingDir) {
+	if (!stagingDir.includes(".xopc-share-staging")) return;
+	try {
+		await rm(stagingDir, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+}
+const stagedSiteByRecordId = /* @__PURE__ */ new Map();
+function rememberStagedSite(recordId, stagingDir) {
+	stagedSiteByRecordId.set(recordId, stagingDir);
+}
+function forgetStagedSite(recordId) {
+	const dir = stagedSiteByRecordId.get(recordId);
+	stagedSiteByRecordId.delete(recordId);
+	return dir;
+}
+/**
+* Walk `<workspaceRoot>/.xopc-share-staging/` and drop directories that are
+* no longer referenced by any live site-share record. Call at gateway boot.
+*/
+async function sweepOrphanedStagingDirs(workspaceRoot, liveStagingDirs) {
+	const stagingRoot = resolve(workspaceRoot, STAGING_DIR_NAME);
+	let entries;
+	try {
+		entries = readdirSync(stagingRoot);
+	} catch {
+		return;
+	}
+	for (const name of entries) {
+		const abs = join(stagingRoot, name);
+		if (liveStagingDirs.has(abs)) continue;
+		try {
+			await rm(abs, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+	}
+}
+/**
+* Boot-time housekeeping:
+*  1. Walk active static site shares whose source lives under STAGING_DIR_NAME
+*     (i.e. created via `stageSingleHtmlAsSite`).
+*  2. Re-register them in the in-process registry so the SiteShareStore
+*     cleanup hook still wipes the right directory on revoke/expire after a
+*     restart.
+*  3. Sweep each workspace's `.xopc-share-staging/` for entries that are not
+*     referenced by any live record — these are leftovers from a previous
+*     process death between create-staging and persist.
+*
+* Safe to call multiple times; idempotent. Best invoked from gateway.start().
+*/
+async function runStagingSweep() {
+	const { getSiteShareStore } = await import("./site-share-store.js");
+	const store = getSiteShareStore();
+	const records = store.getActiveShares();
+	const liveByWorkspace = /* @__PURE__ */ new Map();
+	for (const rec of records) {
+		if (rec.source.kind !== "static") continue;
+		const ws = rec.source.workspaceRoot;
+		const rootDir = rec.source.rootDir;
+		if (!ws || !rootDir) continue;
+		if (!rec.source.workspaceRelativePath.startsWith(`.xopc-share-staging/`)) continue;
+		rememberStagedSite(rec.id, rootDir);
+		const bucket = liveByWorkspace.get(ws) ?? /* @__PURE__ */ new Set();
+		bucket.add(rootDir);
+		liveByWorkspace.set(ws, bucket);
+	}
+	for (const rec of store.getAllShares()) {
+		if (rec.source.kind !== "static") continue;
+		if (!rec.source.workspaceRelativePath.startsWith(`.xopc-share-staging/`)) continue;
+		if (!liveByWorkspace.has(rec.source.workspaceRoot)) liveByWorkspace.set(rec.source.workspaceRoot, /* @__PURE__ */ new Set());
+	}
+	for (const [workspaceRoot, live] of liveByWorkspace) await sweepOrphanedStagingDirs(workspaceRoot, live);
+}
+function resetStagedSiteRegistryForTests() {
+	stagedSiteByRecordId.clear();
+}
+//#endregion
+export { STAGING_DIR_NAME, audienceDefaults, cleanupStagedSite, decideShareKind, forgetStagedSite, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, resetStagedSiteRegistryForTests, runStagingSweep, stageSingleHtmlAsSite, sweepOrphanedStagingDirs };
+
+//# sourceMappingURL=share-auto.js.map

package/dist/src/share/share-auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-auto.js","names":["resolvePath"],"sources":["../../../src/share/share-auto.ts"],"sourcesContent":["/**\n * Smart-share decision layer.\n *\n * The mobile app calls POST /api/shares/auto with a path + audience and\n * lets the server pick file-share vs site-share, pick sane TTLs, and bundle\n * the metadata the share-sheet needs (title, description, thumbnail URL,\n * reachability).\n */\nimport { copyFile, mkdir, rm, stat } from 'node:fs/promises';\nimport { basename, join, resolve as resolvePath } from 'node:path';\nimport { readdirSync } from 'node:fs';\nimport { randomUUID } from 'node:crypto';\n\nimport { resolveMimeType } from './share-store.js';\n\nexport type ShareAudience = 'friend' | 'colleague' | 'public';\n\nexport type ShareAutoMode = 'auto' | 'force-file' | 'force-site' | 'force-zip';\n\nexport type ShareAutoKind = 'file' | 'site' | 'zip';\n\nexport interface ShareAutoDecision {\n  kind: ShareAutoKind;\n  isDirectory: boolean;\n  reason:\n    | 'html-single-file'\n    | 'html-with-assets'\n    | 'small-image'\n    | 'large-binary'\n    | 'directory-zip'\n    | 'directory-browse'\n    | 'forced';\n  hint: string;\n}\n\nexport interface ShareAutoProbe {\n  absolutePath: string;\n  kind: 'file' | 'directory';\n  size: number;\n  mimeType: string;\n  hasIndexHtml: boolean;\n}\n\nexport interface ShareAutoDefaults {\n  ttlMs: number;\n  maxViews: number | null;\n}\n\n/** Convert an audience hint into TTL/maxViews defaults. */\nexport function audienceDefaults(audience: ShareAudience | undefined): ShareAutoDefaults {\n  switch (audience) {\n    case 'public':\n      return { ttlMs: 24 * 60 * 60_000, maxViews: 100 };\n    case 'colleague':\n      return { ttlMs: 7 * 24 * 60 * 60_000, maxViews: null };\n    case 'friend':\n    default:\n      return { ttlMs: 3 * 24 * 60 * 60_000, maxViews: null };\n  }\n}\n\n/** Run filesystem probes needed by the routing logic. */\nexport async function probeShareTarget(\n  workspaceRoot: string,\n  relPath: string,\n): Promise<ShareAutoProbe> {\n  const trimmed = relPath.trim().replace(/\\\\/g, '/').replace(/^\\/+/, '');\n  if (!trimmed) throw new Error('Empty path');\n  if (trimmed.includes('..') || trimmed.includes('\\0')) throw new Error('Invalid path');\n  const abs = resolvePath(workspaceRoot, trimmed);\n  const st = await stat(abs);\n  if (st.isDirectory()) {\n    let hasIndexHtml = false;\n    try {\n      const entries = readdirSync(abs);\n      hasIndexHtml = entries.includes('index.html');\n    } catch {\n      /* unreadable dir is handled later */\n    }\n    return {\n      absolutePath: abs,\n      kind: 'directory',\n      size: 0,\n      mimeType: 'application/x-directory',\n      hasIndexHtml,\n    };\n  }\n  if (!st.isFile()) throw new Error('Path is not a regular file or directory');\n  const fileName = basename(abs);\n  return {\n    absolutePath: abs,\n    kind: 'file',\n    size: st.size,\n    mimeType: resolveMimeType(fileName),\n    hasIndexHtml: false,\n  };\n}\n\n/** Pure decision function — exported for tests. */\nexport function decideShareKind(probe: ShareAutoProbe, mode: ShareAutoMode | undefined): ShareAutoDecision {\n  if (mode === 'force-file') {\n    return forced(probe.kind === 'directory' ? 'zip' : 'file', probe);\n  }\n  if (mode === 'force-site') {\n    if (probe.kind !== 'directory' && probe.mimeType !== 'text/html') {\n      throw new Error('force-site requires a directory or a single HTML file');\n    }\n    return { kind: 'site', isDirectory: probe.kind === 'directory', reason: 'forced', hint: '已按指定方式作为站点分享' };\n  }\n  if (mode === 'force-zip') {\n    if (probe.kind !== 'directory') throw new Error('force-zip requires a directory');\n    return { kind: 'zip', isDirectory: true, reason: 'forced', hint: '已按指定方式打包为 ZIP 分享' };\n  }\n\n  // mode === undefined or 'auto'\n  if (probe.kind === 'directory') {\n    if (probe.hasIndexHtml) {\n      return {\n        kind: 'site',\n        isDirectory: true,\n        reason: 'html-with-assets',\n        hint: '目录包含 index.html，已通过站点分享渲染',\n      };\n    }\n    return {\n      kind: 'file',\n      isDirectory: true,\n      reason: 'directory-browse',\n      hint: '目录较多文件，通过分享页可浏览或下载 ZIP',\n    };\n  }\n\n  if (probe.mimeType === 'text/html') {\n    return {\n      kind: 'site',\n      isDirectory: false,\n      reason: 'html-single-file',\n      hint: 'HTML 文件，分享后朋友点开即渲染',\n    };\n  }\n\n  if (probe.mimeType.startsWith('image/') && probe.size < 10 * 1024 * 1024) {\n    return {\n      kind: 'file',\n      isDirectory: false,\n      reason: 'small-image',\n      hint: '图片文件，朋友可直接预览或保存',\n    };\n  }\n\n  return {\n    kind: 'file',\n    isDirectory: false,\n    reason: 'large-binary',\n    hint: '通过分享链接由朋友点开下载',\n  };\n}\n\nfunction forced(kind: ShareAutoKind, probe: ShareAutoProbe): ShareAutoDecision {\n  return {\n    kind,\n    isDirectory: probe.kind === 'directory',\n    reason: 'forced',\n    hint: '按指定方式分享',\n  };\n}\n\n/** Build the user-facing title (trimmed, no extension). */\nexport function makeTitle(fileName: string, override?: string): string {\n  if (override && override.trim()) return clip(override.trim(), 60);\n  const idx = fileName.lastIndexOf('.');\n  const base = idx > 0 ? fileName.slice(0, idx) : fileName;\n  return clip(base || fileName, 60);\n}\n\n/** Build the user-facing description (audience + TTL hint baked in). */\nexport function makeDescription(opts: {\n  audience: ShareAudience | undefined;\n  expiresAt: string;\n  override?: string;\n}): string {\n  if (opts.override && opts.override.trim()) return clip(opts.override.trim(), 140);\n  const now = Date.now();\n  const exp = new Date(opts.expiresAt).getTime();\n  const days = Math.max(1, Math.round((exp - now) / (24 * 60 * 60_000)));\n  const audienceHint =\n    opts.audience === 'public' ? '公开分享' :\n    opts.audience === 'colleague' ? '同事可见' : '好友可见';\n  return clip(`由 xopc 生成 · ${audienceHint} · ${days} 天内有效`, 140);\n}\n\nfunction clip(text: string, max: number): string {\n  if (text.length <= max) return text;\n  return `${text.slice(0, max - 1)}…`;\n}\n\n/** Subfolder under the workspace where single-HTML site shares are staged. */\nexport const STAGING_DIR_NAME = '.xopc-share-staging';\n\nexport interface StagedSite {\n  /** Absolute path of the freshly-created staging directory. */\n  stagingDir: string;\n  /** Workspace-relative path to feed into SiteShareStore.create({ path }). */\n  relativePath: string;\n}\n\n/**\n * Copy a single HTML file into `<workspaceRoot>/.xopc-share-staging/<uuid>/index.html`\n * so it can be served as a site (SiteShareStore needs a directory root).\n *\n * The caller must register a cleanup that calls `cleanupStagedSite(stagingDir)`\n * when the underlying site share is revoked / expires.\n */\nexport async function stageSingleHtmlAsSite(\n  workspaceRoot: string,\n  absoluteHtmlPath: string,\n): Promise<StagedSite> {\n  const stagingRoot = resolvePath(workspaceRoot, STAGING_DIR_NAME);\n  await mkdir(stagingRoot, { recursive: true });\n  const id = randomUUID();\n  const stagingDir = join(stagingRoot, id);\n  await mkdir(stagingDir, { recursive: true });\n  const target = join(stagingDir, 'index.html');\n  await copyFile(absoluteHtmlPath, target);\n  // Workspace-relative POSIX form expected by SiteShareStore.\n  const rel = `${STAGING_DIR_NAME}/${id}`;\n  return { stagingDir, relativePath: rel };\n}\n\n/** Best-effort cleanup; never throws. */\nexport async function cleanupStagedSite(stagingDir: string): Promise<void> {\n  // Defensive: only remove if it's inside our staging folder name.\n  if (!stagingDir.includes(STAGING_DIR_NAME)) return;\n  try {\n    await rm(stagingDir, { recursive: true, force: true });\n  } catch {\n    /* ignore — disk may already be gone */\n  }\n}\n\n// ── Site staging registry (in-process) ────────────────────────────────────────\n//\n// Maps a site-share record id → absolute staging directory created for it.\n// Used by the SiteShareStore cleanup hook to delete the directory when the\n// share is revoked / expires. Restart-safe in the trivial sense: if the\n// process dies before cleanup fires, the directory just lingers on disk;\n// it is bounded (one folder per stale share) and gets swept by\n// `sweepOrphanedStagingDirs` at startup.\n\nconst stagedSiteByRecordId = new Map<string, string>();\n\nexport function rememberStagedSite(recordId: string, stagingDir: string): void {\n  stagedSiteByRecordId.set(recordId, stagingDir);\n}\n\nexport function forgetStagedSite(recordId: string): string | undefined {\n  const dir = stagedSiteByRecordId.get(recordId);\n  stagedSiteByRecordId.delete(recordId);\n  return dir;\n}\n\n/**\n * Walk `<workspaceRoot>/.xopc-share-staging/` and drop directories that are\n * no longer referenced by any live site-share record. Call at gateway boot.\n */\nexport async function sweepOrphanedStagingDirs(\n  workspaceRoot: string,\n  liveStagingDirs: Set<string>,\n): Promise<void> {\n  const stagingRoot = resolvePath(workspaceRoot, STAGING_DIR_NAME);\n  let entries: string[];\n  try {\n    entries = readdirSync(stagingRoot);\n  } catch {\n    return; // dir doesn't exist; nothing to sweep\n  }\n  for (const name of entries) {\n    const abs = join(stagingRoot, name);\n    if (liveStagingDirs.has(abs)) continue;\n    try {\n      await rm(abs, { recursive: true, force: true });\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\n/**\n * Boot-time housekeeping:\n *  1. Walk active static site shares whose source lives under STAGING_DIR_NAME\n *     (i.e. created via `stageSingleHtmlAsSite`).\n *  2. Re-register them in the in-process registry so the SiteShareStore\n *     cleanup hook still wipes the right directory on revoke/expire after a\n *     restart.\n *  3. Sweep each workspace's `.xopc-share-staging/` for entries that are not\n *     referenced by any live record — these are leftovers from a previous\n *     process death between create-staging and persist.\n *\n * Safe to call multiple times; idempotent. Best invoked from gateway.start().\n */\nexport async function runStagingSweep(): Promise<void> {\n  // Lazy import to keep this module dependency-light for tests that only\n  // exercise the pure decision helpers above.\n  const { getSiteShareStore } = await import('./site-share-store.js');\n  const store = getSiteShareStore();\n  const records = store.getActiveShares();\n\n  const liveByWorkspace = new Map<string, Set<string>>();\n  for (const rec of records) {\n    if (rec.source.kind !== 'static') continue;\n    const ws = rec.source.workspaceRoot;\n    const rootDir = rec.source.rootDir;\n    if (!ws || !rootDir) continue;\n    if (!rec.source.workspaceRelativePath.startsWith(`${STAGING_DIR_NAME}/`)) continue;\n    rememberStagedSite(rec.id, rootDir);\n    const bucket = liveByWorkspace.get(ws) ?? new Set<string>();\n    bucket.add(rootDir);\n    liveByWorkspace.set(ws, bucket);\n  }\n\n  // Workspaces with NO live staged shares still need a sweep: a record may\n  // have expired (so getActiveShares filters it out) without its staging dir\n  // being deleted. We collect those workspaces too.\n  for (const rec of store.getAllShares()) {\n    if (rec.source.kind !== 'static') continue;\n    if (!rec.source.workspaceRelativePath.startsWith(`${STAGING_DIR_NAME}/`)) continue;\n    if (!liveByWorkspace.has(rec.source.workspaceRoot)) {\n      liveByWorkspace.set(rec.source.workspaceRoot, new Set());\n    }\n  }\n\n  for (const [workspaceRoot, live] of liveByWorkspace) {\n    await sweepOrphanedStagingDirs(workspaceRoot, live);\n  }\n}\n\nexport function resetStagedSiteRegistryForTests(): void {\n  stagedSiteByRecordId.clear();\n}\n"],"mappings":"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"}

package/dist/src/share/share-config.js

@@ -1,14 +1,62 @@
 import { SHARE_CONFIG_DEFAULTS } from "./share-types.js";
 import { z } from "zod";
 //#region src/share/share-config.ts
+const ShareDirectoryPatchSchema = z.object({
+	enabled: z.boolean().optional(),
+	maxFolderSize: z.number().int().min(1048576).max(10737418240).optional(),
+	maxFileCount: z.number().int().min(1).max(1e5).optional(),
+	maxDepth: z.number().int().min(1).max(64).optional(),
+	listingCacheMs: z.number().int().min(0).max(6e5).optional(),
+	zipConcurrency: z.number().int().min(1).max(8).optional()
+});
+const ShareThumbnailPatchSchema = z.object({
+	enabled: z.boolean().optional(),
+	concurrency: z.number().int().min(1).max(8).optional(),
+	maxBytes: z.number().int().min(8192).max(4194304).optional(),
+	viewportWidth: z.number().int().min(320).max(2560).optional(),
+	viewportHeight: z.number().int().min(320).max(2560).optional(),
+	generationTimeoutMs: z.number().int().min(1e3).max(6e4).optional(),
+	failureCooldownMs: z.number().int().min(0).max(36e5).optional(),
+	internalGatewayUrl: z.string().min(1).optional()
+});
 const ShareConfigPatchSchema = z.object({
 	enabled: z.boolean().optional(),
 	defaultTtlMs: z.number().int().min(6e4).max(6048e5).optional(),
 	maxTtlMs: z.number().int().min(6e4).max(2592e6).optional(),
 	maxActiveShares: z.number().int().min(1).max(1e4).optional(),
 	maxFileSize: z.number().int().min(1048576).max(10737418240).optional(),
-	inlinePreviewMimes: z.array(z.string().min(1)).optional()
+	inlinePreviewMimes: z.array(z.string().min(1)).optional(),
+	directory: ShareDirectoryPatchSchema.optional(),
+	thumbnail: ShareThumbnailPatchSchema.optional()
 });
+function resolveDirectoryConfig(raw) {
+	const base = SHARE_CONFIG_DEFAULTS.directory;
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return { ...base };
+	const patch = raw;
+	return {
+		enabled: patch.enabled ?? base.enabled,
+		maxFolderSize: patch.maxFolderSize ?? base.maxFolderSize,
+		maxFileCount: patch.maxFileCount ?? base.maxFileCount,
+		maxDepth: patch.maxDepth ?? base.maxDepth,
+		listingCacheMs: patch.listingCacheMs ?? base.listingCacheMs,
+		zipConcurrency: patch.zipConcurrency ?? base.zipConcurrency
+	};
+}
+function resolveThumbnailConfig(raw) {
+	const base = SHARE_CONFIG_DEFAULTS.thumbnail;
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return { ...base };
+	const patch = raw;
+	return {
+		enabled: patch.enabled ?? base.enabled,
+		concurrency: patch.concurrency ?? base.concurrency,
+		maxBytes: patch.maxBytes ?? base.maxBytes,
+		viewportWidth: patch.viewportWidth ?? base.viewportWidth,
+		viewportHeight: patch.viewportHeight ?? base.viewportHeight,
+		generationTimeoutMs: patch.generationTimeoutMs ?? base.generationTimeoutMs,
+		failureCooldownMs: patch.failureCooldownMs ?? base.failureCooldownMs,
+		internalGatewayUrl: patch.internalGatewayUrl ?? base.internalGatewayUrl
+	};
+}
 function resolveShareConfig(raw) {
 	const patch = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
 	return {
@@ -17,7 +65,9 @@ function resolveShareConfig(raw) {
 		maxTtlMs: patch.maxTtlMs ?? SHARE_CONFIG_DEFAULTS.maxTtlMs,
 		maxActiveShares: patch.maxActiveShares ?? SHARE_CONFIG_DEFAULTS.maxActiveShares,
 		maxFileSize: patch.maxFileSize ?? SHARE_CONFIG_DEFAULTS.maxFileSize,
-		inlinePreviewMimes: Array.isArray(patch.inlinePreviewMimes) ? patch.inlinePreviewMimes.filter((x) => typeof x === "string" && x.trim().length > 0) : [...SHARE_CONFIG_DEFAULTS.inlinePreviewMimes]
+		inlinePreviewMimes: Array.isArray(patch.inlinePreviewMimes) ? patch.inlinePreviewMimes.filter((x) => typeof x === "string" && x.trim().length > 0) : [...SHARE_CONFIG_DEFAULTS.inlinePreviewMimes],
+		directory: resolveDirectoryConfig(patch.directory),
+		thumbnail: resolveThumbnailConfig(patch.thumbnail)
 	};
 }
 function mergeShareConfigPatch(config, patch) {
@@ -38,10 +88,19 @@ function mergeShareConfigPatch(config, patch) {
 		maxSseConnections: 100,
 		corsOrigins: []
 	};
+	const current = resolveShareConfig(config.gateway.share);
 	const next = {
-		...resolveShareConfig(config.gateway.share),
+		...current,
 		...parsed.data,
-		...parsed.data.inlinePreviewMimes ? { inlinePreviewMimes: parsed.data.inlinePreviewMimes.map((x) => x.trim()).filter(Boolean) } : {}
+		inlinePreviewMimes: parsed.data.inlinePreviewMimes ? parsed.data.inlinePreviewMimes.map((x) => x.trim()).filter(Boolean) : current.inlinePreviewMimes,
+		directory: parsed.data.directory ? {
+			...current.directory,
+			...parsed.data.directory
+		} : current.directory,
+		thumbnail: parsed.data.thumbnail ? {
+			...current.thumbnail,
+			...parsed.data.thumbnail
+		} : current.thumbnail
 	};
 	if (next.defaultTtlMs > next.maxTtlMs) return {
 		ok: false,

package/dist/src/share/share-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"share-config.js","names":[],"sources":["../../../src/share/share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport { SHARE_CONFIG_DEFAULTS, type ShareConfig } from './share-types.js';\n\nconst ShareConfigPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveShares: z.number().int().min(1).max(10_000).optional(),\n  maxFileSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  inlinePreviewMimes: z.array(z.string().min(1)).optional(),\n});\n\nexport function resolveShareConfig(raw: unknown): ShareConfig {\n  const patch = raw && typeof raw === 'object' && !Array.isArray(raw) ? (raw as Partial<ShareConfig>) : {};\n  return {\n    enabled: patch.enabled ?? SHARE_CONFIG_DEFAULTS.enabled,\n    defaultTtlMs: patch.defaultTtlMs ?? SHARE_CONFIG_DEFAULTS.defaultTtlMs,\n    maxTtlMs: patch.maxTtlMs ?? SHARE_CONFIG_DEFAULTS.maxTtlMs,\n    maxActiveShares: patch.maxActiveShares ?? SHARE_CONFIG_DEFAULTS.maxActiveShares,\n    maxFileSize: patch.maxFileSize ?? SHARE_CONFIG_DEFAULTS.maxFileSize,\n    inlinePreviewMimes: Array.isArray(patch.inlinePreviewMimes)\n      ? patch.inlinePreviewMimes.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n      : [...SHARE_CONFIG_DEFAULTS.inlinePreviewMimes],\n  };\n}\n\nexport function mergeShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = ShareConfigPatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const current = resolveShareConfig(config.gateway.share);\n  const next: ShareConfig = {\n    ...current,\n    ...parsed.data,\n    ...(parsed.data.inlinePreviewMimes\n      ? {\n          inlinePreviewMimes: parsed.data.inlinePreviewMimes\n            .map((x) => x.trim())\n            .filter(Boolean),\n        }\n      : {}),\n  };\n\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return {\n      ok: false,\n      message: 'gateway.share.defaultTtlMs must not exceed gateway.share.maxTtlMs',\n    };\n  }\n\n  config.gateway.share = next;\n  return { ok: true };\n}\n"],"mappings":";;;AAKA,MAAM,yBAAyB,EAAE,OAAO;CACtC,SAAS,EAAE,SAAS,CAAC,UAAU;CAC/B,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAO,CAAC,IAAI,OAAY,CAAC,UAAU;CACtE,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAO,CAAC,IAAI,OAAc,CAAC,UAAU;CACpE,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAO,CAAC,UAAU;CAC/D,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAU,CAAC,IAAI,YAAe,CAAC,UAAU;CAC3E,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAC1D,CAAC;AAEF,SAAgB,mBAAmB,KAA2B;CAC5D,MAAM,QAAQ,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI,GAAI,MAA+B,EAAE;AACxG,QAAO;EACL,SAAS,MAAM,WAAW,sBAAsB;EAChD,cAAc,MAAM,gBAAgB,sBAAsB;EAC1D,UAAU,MAAM,YAAY,sBAAsB;EAClD,iBAAiB,MAAM,mBAAmB,sBAAsB;EAChE,aAAa,MAAM,eAAe,sBAAsB;EACxD,oBAAoB,MAAM,QAAQ,MAAM,mBAAmB,GACvD,MAAM,mBAAmB,QAAQ,MAAmB,OAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,GACjG,CAAC,GAAG,sBAAsB,mBAAmB;EAClD;;AAGH,SAAgB,sBACd,QACA,OAC+C;CAC/C,MAAM,SAAS,uBAAuB,UAAU,MAAM;AACtD,KAAI,CAAC,OAAO,QACV,QAAO;EAAE,IAAI;EAAO,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,EAAE,QAAQ,CAAC,KAAK,KAAK;EAAE;AAGrF,KAAI,CAAC,OAAO,QACV,QAAO,UAAU;EACf,MAAM;EACN,MAAM;EACN,MAAM,EAAE,MAAM,SAAS;EACvB,WAAW;GAAE,SAAS;GAAM,YAAY;GAAW,4BAA4B;GAAO;EACtF,mBAAmB;EACnB,aAAa,EAAE;EAChB;CAIH,MAAM,OAAoB;EACxB,GAFc,mBAAmB,OAAO,QAAQ,MAEtC;EACV,GAAG,OAAO;EACV,GAAI,OAAO,KAAK,qBACZ,EACE,oBAAoB,OAAO,KAAK,mBAC7B,KAAK,MAAM,EAAE,MAAM,CAAC,CACpB,OAAO,QAAQ,EACnB,GACD,EAAE;EACP;AAED,KAAI,KAAK,eAAe,KAAK,SAC3B,QAAO;EACL,IAAI;EACJ,SAAS;EACV;AAGH,QAAO,QAAQ,QAAQ;AACvB,QAAO,EAAE,IAAI,MAAM"}
+{"version":3,"file":"share-config.js","names":[],"sources":["../../../src/share/share-config.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  SHARE_CONFIG_DEFAULTS,\n  type ShareConfig,\n  type ShareDirectoryConfig,\n  type ShareThumbnailConfig,\n} from './share-types.js';\n\nconst ShareDirectoryPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  maxFolderSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  maxFileCount: z.number().int().min(1).max(100_000).optional(),\n  maxDepth: z.number().int().min(1).max(64).optional(),\n  listingCacheMs: z.number().int().min(0).max(600_000).optional(),\n  zipConcurrency: z.number().int().min(1).max(8).optional(),\n});\n\nconst ShareThumbnailPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  concurrency: z.number().int().min(1).max(8).optional(),\n  maxBytes: z.number().int().min(8_192).max(4_194_304).optional(),\n  viewportWidth: z.number().int().min(320).max(2_560).optional(),\n  viewportHeight: z.number().int().min(320).max(2_560).optional(),\n  generationTimeoutMs: z.number().int().min(1_000).max(60_000).optional(),\n  failureCooldownMs: z.number().int().min(0).max(3_600_000).optional(),\n  internalGatewayUrl: z.string().min(1).optional(),\n});\n\nconst ShareConfigPatchSchema = z.object({\n  enabled: z.boolean().optional(),\n  defaultTtlMs: z.number().int().min(60_000).max(604_800_000).optional(),\n  maxTtlMs: z.number().int().min(60_000).max(2_592_000_000).optional(),\n  maxActiveShares: z.number().int().min(1).max(10_000).optional(),\n  maxFileSize: z.number().int().min(1_048_576).max(10_737_418_240).optional(),\n  inlinePreviewMimes: z.array(z.string().min(1)).optional(),\n  directory: ShareDirectoryPatchSchema.optional(),\n  thumbnail: ShareThumbnailPatchSchema.optional(),\n});\n\nfunction resolveDirectoryConfig(raw: unknown): ShareDirectoryConfig {\n  const base = SHARE_CONFIG_DEFAULTS.directory;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return { ...base };\n  const patch = raw as Partial<ShareDirectoryConfig>;\n  return {\n    enabled: patch.enabled ?? base.enabled,\n    maxFolderSize: patch.maxFolderSize ?? base.maxFolderSize,\n    maxFileCount: patch.maxFileCount ?? base.maxFileCount,\n    maxDepth: patch.maxDepth ?? base.maxDepth,\n    listingCacheMs: patch.listingCacheMs ?? base.listingCacheMs,\n    zipConcurrency: patch.zipConcurrency ?? base.zipConcurrency,\n  };\n}\n\nfunction resolveThumbnailConfig(raw: unknown): ShareThumbnailConfig {\n  const base = SHARE_CONFIG_DEFAULTS.thumbnail;\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return { ...base };\n  const patch = raw as Partial<ShareThumbnailConfig>;\n  return {\n    enabled: patch.enabled ?? base.enabled,\n    concurrency: patch.concurrency ?? base.concurrency,\n    maxBytes: patch.maxBytes ?? base.maxBytes,\n    viewportWidth: patch.viewportWidth ?? base.viewportWidth,\n    viewportHeight: patch.viewportHeight ?? base.viewportHeight,\n    generationTimeoutMs: patch.generationTimeoutMs ?? base.generationTimeoutMs,\n    failureCooldownMs: patch.failureCooldownMs ?? base.failureCooldownMs,\n    internalGatewayUrl: patch.internalGatewayUrl ?? base.internalGatewayUrl,\n  };\n}\n\nexport function resolveShareConfig(raw: unknown): ShareConfig {\n  const patch =\n    raw && typeof raw === 'object' && !Array.isArray(raw)\n      ? (raw as Partial<ShareConfig> & { directory?: unknown; thumbnail?: unknown })\n      : {};\n  return {\n    enabled: patch.enabled ?? SHARE_CONFIG_DEFAULTS.enabled,\n    defaultTtlMs: patch.defaultTtlMs ?? SHARE_CONFIG_DEFAULTS.defaultTtlMs,\n    maxTtlMs: patch.maxTtlMs ?? SHARE_CONFIG_DEFAULTS.maxTtlMs,\n    maxActiveShares: patch.maxActiveShares ?? SHARE_CONFIG_DEFAULTS.maxActiveShares,\n    maxFileSize: patch.maxFileSize ?? SHARE_CONFIG_DEFAULTS.maxFileSize,\n    inlinePreviewMimes: Array.isArray(patch.inlinePreviewMimes)\n      ? patch.inlinePreviewMimes.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n      : [...SHARE_CONFIG_DEFAULTS.inlinePreviewMimes],\n    directory: resolveDirectoryConfig(patch.directory),\n    thumbnail: resolveThumbnailConfig(patch.thumbnail),\n  };\n}\n\nexport function mergeShareConfigPatch(\n  config: Config,\n  patch: Record<string, unknown>,\n): { ok: true } | { ok: false; message: string } {\n  const parsed = ShareConfigPatchSchema.safeParse(patch);\n  if (!parsed.success) {\n    return { ok: false, message: parsed.error.issues.map((i) => i.message).join('; ') };\n  }\n\n  if (!config.gateway) {\n    config.gateway = {\n      bind: 'loopback',\n      port: 18790,\n      auth: { mode: 'token' },\n      heartbeat: { enabled: true, intervalMs: 1_800_000, includeSystemPromptSection: false },\n      maxSseConnections: 100,\n      corsOrigins: [],\n    };\n  }\n\n  const current = resolveShareConfig(config.gateway.share);\n  const next: ShareConfig = {\n    ...current,\n    ...parsed.data,\n    inlinePreviewMimes: parsed.data.inlinePreviewMimes\n      ? parsed.data.inlinePreviewMimes.map((x) => x.trim()).filter(Boolean)\n      : current.inlinePreviewMimes,\n    directory: parsed.data.directory\n      ? { ...current.directory, ...parsed.data.directory }\n      : current.directory,\n    thumbnail: parsed.data.thumbnail\n      ? { ...current.thumbnail, ...parsed.data.thumbnail }\n      : current.thumbnail,\n  };\n\n  if (next.defaultTtlMs > next.maxTtlMs) {\n    return {\n      ok: false,\n      message: 'gateway.share.defaultTtlMs must not exceed gateway.share.maxTtlMs',\n    };\n  }\n\n  config.gateway.share = next;\n  return { ok: true };\n}\n"],"mappings":"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"}

package/dist/src/share/share-landing.d.ts

@@ -1,6 +1,32 @@
+import type { DirectoryListing } from './share-store.js';
 import type { ShareRecord } from './share-types.js';
-/** Render the download confirmation landing page (does not consume viewCount). */
-export declare function renderShareLandingPage(record: ShareRecord, downloadPath: string): string;
+export interface ShareLandingOgOptions {
+    /** Absolute https/http URL of this landing page (for og:url). Omit if non-public. */
+    absoluteShareUrl?: string | null;
+    /** Absolute URL of the thumbnail image (for og:image). Omit if non-public. */
+    absoluteThumbnailUrl?: string | null;
+    /** Title override (default: fileName). */
+    title?: string;
+    /** Description override (default: type + size). */
+    description?: string;
+}
+/** Render the file download confirmation landing page (does not consume downloadCount). */
+export declare function renderShareLandingPage(record: ShareRecord, downloadPath: string, options?: {
+    /** Path to open the file inline (?inline=1) for browser-native rendering. */
+    inlineUrl?: string | null;
+    /** SPA preview URL (for markdown / docs / code that benefit from rich rendering). */
+    previewUrl?: string | null;
+    /** Social card / unfurl metadata. */
+    og?: ShareLandingOgOptions;
+}): string;
+/** Render the folder landing page (browse mode shows a tree, zip-only shows a single button). */
+export declare function renderFolderLandingPage(record: ShareRecord, listing: DirectoryListing | null, urls: {
+    tree: (path: string) => string;
+    file: (path: string) => string;
+    zip: (path: string) => string;
+}, options?: {
+    og?: ShareLandingOgOptions;
+}): string;
 export type ShareExpiredReason = 'expired' | 'revoked' | 'max_views' | 'not_found' | 'file_deleted';
 /** Render the "share no longer valid" page — does NOT reveal file name or path. */
 export declare function renderShareExpiredPage(reason: ShareExpiredReason): string;