dsh-plugin-update 0.5.8 → 0.7.0

package/dist/store.d.ts

@@ -131,6 +131,48 @@ export declare function createBatchDiskPorts(homeDir: string, profileDir: string
     writeBatch: (session: BatchSession) => Promise<void>;
     clearBatch: () => Promise<void>;
 };
+/** 批量属主隔离与知识/偏好落盘（#59 D1：知识、一轮、属主各回各家）。 */
+export declare const INVENTORY_FILE = "inventory.json";
+export declare const PREFS_FILE = "prefs.json";
+export declare const INVENTORY_FILE_MAX_BYTES: number;
+export declare const PREFS_FILE_MAX_BYTES: number;
+export declare function sanitizeBatchOwner(owner: unknown): string | null;
+export interface BatchOwnerPaths {
+    directory: string;
+    batchFile: string;
+    inventoryFile: string;
+    prefsFile: string;
+}
+export declare function batchPathsForOwner(homeDir: string, profileDir: string, owner: unknown): BatchOwnerPaths | null;
+export interface BatchInventoryEntry {
+    lastCheckedAt: number;
+    installedVersion: string | null;
+    latestVersion: string | null;
+    canInstall: boolean | null;
+    error: string | null;
+}
+export interface BatchInventory {
+    version: 1;
+    updatedAt: number;
+    entries: Record<string, BatchInventoryEntry>;
+}
+export declare function emptyBatchInventory(nowMs?: number): BatchInventory;
+export declare function normalizeBatchInventory(raw: unknown, nowMs?: number): BatchInventory;
+export interface BatchPrefs {
+    checkOnOpen?: boolean;
+}
+export declare function normalizeBatchPrefs(raw: unknown): BatchPrefs;
+export interface BatchOwnerPorts {
+    paths: BatchOwnerPaths | null;
+    readBatch: () => Promise<BatchSession>;
+    writeBatch: (session: BatchSession) => Promise<void>;
+    clearBatch: () => Promise<void>;
+    readInventory: () => Promise<BatchInventory>;
+    writeInventory: (inventory: BatchInventory) => Promise<void>;
+    readPrefs: () => Promise<BatchPrefs>;
+    writePrefs: (prefs: BatchPrefs) => Promise<void>;
+}
+export declare function createBatchOwnerPorts(homeDir: string, profileDir: string, owner: unknown, deps?: BatchPortsDeps): BatchOwnerPorts;
 /** 按插件 + 版本持久化的跳过记录（#16，与三冻结落盘名并存的第四文件，不碰旧树）。
  *
  * 键：跳过只按「插件标识 + 版本」记——目录已按插件标识隔离（pathsForUpdate），

package/dist/store.js

@@ -328,6 +328,135 @@ function createBatchDiskPorts(homeDir, profileDir, deps = {}) {
   }
   return { paths, readBatch, writeBatch, clearBatch };
 }
+const INVENTORY_FILE = "inventory.json";
+const PREFS_FILE = "prefs.json";
+const INVENTORY_FILE_MAX_BYTES = 1024 * 1024;
+const PREFS_FILE_MAX_BYTES = 64 * 1024;
+function sanitizeBatchOwner(owner) {
+  if (typeof owner !== "string" || !owner) return null;
+  if (owner.length < 1 || owner.length > 64) return null;
+  if (!/^[A-Za-z0-9_-]+$/.test(owner)) return null;
+  return owner;
+}
+function batchPathsForOwner(homeDir, profileDir, owner) {
+  const clean = sanitizeBatchOwner(owner);
+  if (!clean) return null;
+  const queue = queuePathsForUpdate(homeDir, profileDir);
+  if (!queue) return null;
+  const directory = join(queue.directory, clean);
+  return { directory, batchFile: join(directory, BATCH_FILE), inventoryFile: join(directory, INVENTORY_FILE), prefsFile: join(directory, PREFS_FILE) };
+}
+function emptyBatchInventory(nowMs) {
+  const at = typeof nowMs === "number" && Number.isFinite(nowMs) && nowMs >= 0 ? nowMs : 0;
+  return { version: 1, updatedAt: at, entries: {} };
+}
+function asMillisOrZero(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : 0;
+}
+function asNullableText(value) {
+  return typeof value === "string" && value ? value : null;
+}
+function normalizeBatchInventory(raw, nowMs) {
+  const fallback = emptyBatchInventory(nowMs);
+  try {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) return fallback;
+    const input = raw;
+    if (input["version"] !== 1) return fallback;
+    const entries = {};
+    const rawEntries = input["entries"];
+    if (rawEntries && typeof rawEntries === "object" && !Array.isArray(rawEntries)) {
+      for (const [key, item] of Object.entries(rawEntries)) {
+        if (!key || typeof item !== "object" || !item || Array.isArray(item)) continue;
+        const e = item;
+        const canInstallRaw = e["canInstall"];
+        entries[key] = {
+          lastCheckedAt: asMillisOrZero(e["lastCheckedAt"]),
+          installedVersion: asNullableText(e["installedVersion"]),
+          latestVersion: asNullableText(e["latestVersion"]),
+          canInstall: typeof canInstallRaw === "boolean" ? canInstallRaw : null,
+          error: asNullableText(e["error"])
+        };
+      }
+    }
+    return { version: 1, updatedAt: asMillisOrZero(input["updatedAt"]), entries };
+  } catch {
+    return fallback;
+  }
+}
+function normalizeBatchPrefs(raw) {
+  try {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+    const v = raw["checkOnOpen"];
+    if (typeof v === "boolean") return { checkOnOpen: v };
+    return {};
+  } catch {
+    return {};
+  }
+}
+async function readJsonFile(filename, maxBytes, readText, statFile) {
+  try {
+    if ((await statFile(filename)).size > maxBytes) return null;
+    return JSON.parse(await readText(filename, "utf8"));
+  } catch (error) {
+    if (error && error.code === "ENOENT") return null;
+    return null;
+  }
+}
+async function writeJsonFileAtomic(filename, value, directory) {
+  await mkdir(directory, { recursive: true, mode: 448 });
+  const temporary = filename + "." + randomUUID() + ".tmp";
+  try {
+    await writeFile(temporary, JSON.stringify(value, null, 2) + "\n", { mode: 384, flag: "wx" });
+    await rename(temporary, filename);
+  } catch {
+    throw batchFail();
+  } finally {
+    await unlink(temporary).catch(() => {
+    });
+  }
+}
+function createBatchOwnerPorts(homeDir, profileDir, owner, deps = {}) {
+  const paths = batchPathsForOwner(homeDir, profileDir, owner);
+  const readText = deps.readFileImpl ?? ((filename, encoding) => readFile(filename, encoding));
+  const statFile = deps.statImpl ?? ((filename) => stat(filename));
+  async function readBatch() {
+    if (!paths) return emptyBatchSession();
+    const raw = await readJsonFile(paths.batchFile, BATCH_FILE_MAX_BYTES, readText, statFile);
+    if (raw === null) return emptyBatchSession();
+    return normalizeBatchSession(raw);
+  }
+  async function writeBatch(session) {
+    if (!paths) throw batchFail();
+    await writeJsonFileAtomic(paths.batchFile, normalizeBatchSession(session), paths.directory);
+  }
+  async function clearBatch() {
+    if (!paths) return;
+    await writeBatch(emptyBatchSession());
+  }
+  async function readInventory() {
+    if (!paths) return emptyBatchInventory();
+    const raw = await readJsonFile(paths.inventoryFile, INVENTORY_FILE_MAX_BYTES, readText, statFile);
+    if (raw === null) return emptyBatchInventory();
+    return normalizeBatchInventory(raw);
+  }
+  async function writeInventory(inventory) {
+    if (!paths) throw batchFail();
+    const normalized = normalizeBatchInventory(inventory, inventory.updatedAt);
+    normalized.updatedAt = asMillisOrZero(inventory.updatedAt);
+    await writeJsonFileAtomic(paths.inventoryFile, normalized, paths.directory);
+  }
+  async function readPrefs() {
+    if (!paths) return {};
+    const raw = await readJsonFile(paths.prefsFile, PREFS_FILE_MAX_BYTES, readText, statFile);
+    if (raw === null) return {};
+    return normalizeBatchPrefs(raw);
+  }
+  async function writePrefs(prefs) {
+    if (!paths) throw batchFail();
+    await writeJsonFileAtomic(paths.prefsFile, normalizeBatchPrefs(prefs), paths.directory);
+  }
+  return { paths, readBatch, writeBatch, clearBatch, readInventory, writeInventory, readPrefs, writePrefs };
+}
 const MAX_SKIPPED_ENTRIES = 50;
 function skipKey(pluginId, version) {
   return `${String(pluginId)}@${String(version)}`;
@@ -693,25 +822,35 @@ const __executorInternals = { INSTALL_STDIO, TERMINATION_GRACE_MS, CLI_PACKAGE_N
 export {
   BATCH_FILE,
   BATCH_FILE_MAX_BYTES,
+  INVENTORY_FILE,
+  INVENTORY_FILE_MAX_BYTES,
   MAX_SKIPPED_ENTRIES,
+  PREFS_FILE,
+  PREFS_FILE_MAX_BYTES,
   QUEUE_DIR_SEGMENT,
   QUEUE_FILE,
   QUEUE_LOCK_FILE,
   QUEUE_LOCK_STALE_MS,
   __executorInternals,
   addSkipped,
+  batchPathsForOwner,
   batchPathsForUpdate,
   clearSkipped,
   createBatchDiskPorts,
+  createBatchOwnerPorts,
   createSkipDiskPorts,
   createUpdateDiskPorts,
   createUpdateExecutor,
   createUpdateQueuePorts,
+  emptyBatchInventory,
   isVersionSkipped,
   legacyPathsForUpdate,
+  normalizeBatchInventory,
+  normalizeBatchPrefs,
   normalizeSkipped,
   pathsForUpdate,
   queuePathsForUpdate,
   resolveCliEntry,
+  sanitizeBatchOwner,
   skipKey
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-update",
-  "version": "0.5.8",
+  "version": "0.7.0",
   "description": "可复用的更新系统装成的 npm 包：任何 DSH 插件照文档能集成检查更新等功能（地图 #579）",
   "license": "MIT",
   "author": "王辰浩",