@lacrous/omnicloud 0.2.8 → 0.2.10

package/dist/index.d.cts

@@ -1001,6 +1001,8 @@ interface FileRepository {
     findVersionById(versionId: string): Promise<FileVersionRecord | null>;
     countVersions(fileId: string): Promise<number>;
     deleteVersionsByFileIds(fileIds: string[]): Promise<void>;
+    /** Removes one version row. Callers must delete its Telegram object first. */
+    deleteVersion(versionId: string): Promise<void>;
 }
 interface ActivityRepository {
     record(input: {
@@ -1165,6 +1167,21 @@ declare class StorageEngine {
     private withRetry;
 }
 
+/**
+ * Which historical versions to keep. The current version is never a candidate,
+ * whatever the policy says. The default keeps everything, so no version is ever
+ * removed unless an operator opts in.
+ */
+type VersionRetentionPolicy = {
+    kind: "KEEP_ALL";
+} | {
+    kind: "KEEP_LATEST_N";
+    count: number;
+} | {
+    kind: "KEEP_FOR_DAYS";
+    days: number;
+};
+
 interface OperationSink {
     info(record: Record<string, unknown>, message: string): void;
     warn(record: Record<string, unknown>, message: string): void;
@@ -1330,6 +1347,13 @@ declare class FileService {
             message: string;
         }[];
     }>;
+    /**
+     * 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.
+     */
+    pruneVersions(userId: string, fileId: string, policy: VersionRetentionPolicy, now?: Date): Promise<number>;
     private assertFolder;
 }
 

package/dist/index.d.ts

@@ -1001,6 +1001,8 @@ interface FileRepository {
     findVersionById(versionId: string): Promise<FileVersionRecord | null>;
     countVersions(fileId: string): Promise<number>;
     deleteVersionsByFileIds(fileIds: string[]): Promise<void>;
+    /** Removes one version row. Callers must delete its Telegram object first. */
+    deleteVersion(versionId: string): Promise<void>;
 }
 interface ActivityRepository {
     record(input: {
@@ -1165,6 +1167,21 @@ declare class StorageEngine {
     private withRetry;
 }
 
+/**
+ * Which historical versions to keep. The current version is never a candidate,
+ * whatever the policy says. The default keeps everything, so no version is ever
+ * removed unless an operator opts in.
+ */
+type VersionRetentionPolicy = {
+    kind: "KEEP_ALL";
+} | {
+    kind: "KEEP_LATEST_N";
+    count: number;
+} | {
+    kind: "KEEP_FOR_DAYS";
+    days: number;
+};
+
 interface OperationSink {
     info(record: Record<string, unknown>, message: string): void;
     warn(record: Record<string, unknown>, message: string): void;
@@ -1330,6 +1347,13 @@ declare class FileService {
             message: string;
         }[];
     }>;
+    /**
+     * 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.
+     */
+    pruneVersions(userId: string, fileId: string, policy: VersionRetentionPolicy, now?: Date): Promise<number>;
     private assertFolder;
 }
 

package/dist/index.js

@@ -1294,6 +1294,23 @@ async function resolveItemQuery(folders, userId, input) {
 // ../core/src/services/auth-session-service.ts
 import { createHash as createHash3, randomBytes } from "crypto";
 
+// ../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);
@@ -1882,6 +1899,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) {