@lacrous/omnicloud 0.2.9 → 0.2.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lacrous/omnicloud",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "SDK and core building blocks for OmniCloud — self-hosted cloud storage powered by your Telegram account.",
   "license": "MIT",
   "type": "module",
@@ -48,9 +48,9 @@
     "prisma": "^6.2.0"
   },
   "devDependencies": {
-    "@omnicloud/core": "0.2.9",
-    "@omnicloud/shared": "0.2.9",
-    "@omnicloud/telegram": "0.2.9",
+    "@omnicloud/core": "0.2.11",
+    "@omnicloud/shared": "0.2.11",
+    "@omnicloud/telegram": "0.2.11",
     "@types/node": "^22.10.0",
     "esbuild": "0.25.12",
     "tsup": "^8.3.0",

package/server/index.js

@@ -761,6 +761,23 @@ function truncate(value, max) {
   return value === null ? null : value.slice(0, max);
 }
 
+// ../core/src/services/version-retention.ts
+function versionsToPrune(versions, currentVersionId, policy, now) {
+  const historical = versions.filter((version) => version.id !== currentVersionId).sort((a, b) => b.versionNumber - a.versionNumber);
+  switch (policy.kind) {
+    case "KEEP_ALL":
+      return [];
+    case "KEEP_LATEST_N": {
+      const keep = Math.max(0, policy.count);
+      return historical.slice(keep);
+    }
+    case "KEEP_FOR_DAYS": {
+      const cutoff = now.getTime() - policy.days * 24 * 60 * 60 * 1e3;
+      return historical.filter((version) => version.createdAt.getTime() < cutoff);
+    }
+  }
+}
+
 // ../core/src/services/upload-operation.ts
 function isValidOperationId(id) {
   return /^[A-Za-z0-9_-]{8,64}$/.test(id);
@@ -918,7 +935,9 @@ var ReconciliationApplier = class {
     const file = (await this.repos.files.listByUser(this.userId)).find(
       (candidate) => candidate.telegramMessageId === action.messageId
     );
-    if (!file) return;
+    if (!file) {
+      throw new Error("No file of yours references this message, so there is nothing to detach");
+    }
     await this.repos.files.update(file.id, { deletedAt: /* @__PURE__ */ new Date(), trashBatchId: null });
   }
   async adopt(action) {
@@ -1538,6 +1557,33 @@ var FileService = class {
     };
   }
   // ── internals ────────────────────────────────────────────────────────────
+  /**
+   * Removes historical versions the policy no longer keeps. For each version the
+   * Telegram message is deleted first, and its row only after that succeeds, the
+   * same order as a permanent delete. A failed remote delete leaves that version
+   * in place. The current version is never removed. Returns how many were removed.
+   */
+  async pruneVersions(userId, fileId, policy, now = /* @__PURE__ */ new Date()) {
+    const record = await this.get(userId, fileId);
+    const versions = await this.files.listVersions(fileId);
+    const doomed = versionsToPrune(versions, record.currentVersionId ?? null, policy, now);
+    if (doomed.length === 0) return 0;
+    const engine = await this.engineFor(userId);
+    let removed = 0;
+    for (const version of doomed) {
+      await engine.remove({ messageId: String(version.telegramMessageId) });
+      await this.files.deleteVersion(version.id);
+      removed += 1;
+    }
+    await this.activity.record({
+      userId,
+      action: "delete",
+      resourceType: "file",
+      resourceId: fileId,
+      resourceName: `${record.name} (${removed} old version${removed === 1 ? "" : "s"})`
+    });
+    return removed;
+  }
   async assertFolder(userId, folderId) {
     const folder = await this.folders.findById(folderId);
     if (!folder || folder.userId !== userId) {
@@ -3870,6 +3916,9 @@ function createFileRepo(prisma) {
     async deleteVersionsByFileIds(fileIds) {
       if (fileIds.length === 0) return;
       await prisma.fileVersion.deleteMany({ where: { fileId: { in: fileIds } } });
+    },
+    async deleteVersion(versionId) {
+      await prisma.fileVersion.deleteMany({ where: { id: versionId } });
     }
   };
 }
@@ -4317,6 +4366,27 @@ function parseListQuery(raw) {
   }
   return { query, page: query.page, limit: query.limit };
 }
+function parseRetentionPolicy(body) {
+  const kind = requireString(body, "policy");
+  if (kind === "KEEP_ALL") return { kind: "KEEP_ALL" };
+  if (kind === "KEEP_LATEST_N") {
+    const count = requireWholeNumber(body, "count");
+    return { kind: "KEEP_LATEST_N", count };
+  }
+  if (kind === "KEEP_FOR_DAYS") {
+    const days = requireWholeNumber(body, "days");
+    if (days < 1) throw new ValidationError("days must be at least 1");
+    return { kind: "KEEP_FOR_DAYS", days };
+  }
+  throw new ValidationError("policy must be KEEP_ALL, KEEP_LATEST_N or KEEP_FOR_DAYS");
+}
+function requireWholeNumber(body, field) {
+  const value = body?.[field];
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+    throw new ValidationError(`${field} must be a whole number of zero or more`);
+  }
+  return value;
+}
 
 // ../../apps/api/src/mappers.ts
 function toUserDTO(user) {
@@ -4637,6 +4707,13 @@ function registerFileRoutes(app2, container2) {
     const versions = await container2.files.listVersions(request.user.id, id);
     return { versions: versions.map((v) => toVersionDTO(v, record.currentVersionId)) };
   });
+  app2.post("/api/files/:id/versions/prune", async (request, reply) => {
+    const { id } = request.params;
+    const body = requireBody(request);
+    const policy = parseRetentionPolicy(body);
+    const removed = await container2.files.pruneVersions(request.user.id, id, policy);
+    return reply.send({ removed });
+  });
   app2.post("/api/files/:id/replace", async (request, reply) => {
     const { id } = request.params;
     const part = await request.file();
@@ -4895,7 +4972,7 @@ function encryptionCheck(configured) {
 }
 
 // ../../apps/api/src/routes/storage.ts
-var VERSION = "0.2.9";
+var VERSION = "0.2.11";
 function registerStorageRoutes(app2, container2) {
   app2.get("/api/health", async () => {
     const database = await probeDatabase(container2);