@lacrous/omnicloud 0.2.27 → 0.2.28

package/dist/index.d.cts

@@ -1106,6 +1106,8 @@ interface StorageUploadInput {
     size?: number;
     /** SHA-256 of the spooled bytes, computed while they were written. Required with `path`. */
     sha256?: string;
+    /** Message caption that identifies this upload, so a later search can find it. */
+    caption?: string;
 }
 interface StorageHealth {
     /** Reachable and usable. */
@@ -1142,7 +1144,7 @@ interface StorageProvider {
      * recover an upload whose outcome was unknown. Providers that cannot search
      * omit it, and the caller then treats the outcome as unresolved.
      */
-    findByCaption?(sha256: string, size: number): Promise<StoredObject[]>;
+    findByCaption?(caption: string, size: number): Promise<StoredObject[]>;
     /** Validates that the backing store is reachable and usable. */
     healthCheck(): Promise<StorageHealth>;
 }
@@ -1193,7 +1195,7 @@ declare class StorageEngine {
     /** Read-only listing of stored objects, for reconciliation. Never modifies anything. */
     list(limit: number): Promise<StoredObject[]>;
     /** Read-only search for stored objects with this content hash and size. */
-    findByCaption(sha256: string, size: number): Promise<StoredObject[] | null>;
+    findByCaption(caption: string, size: number): Promise<StoredObject[] | null>;
     stat(ref: StoredRef): Promise<StoredObject | null>;
     health(): Promise<StorageHealth>;
     verifyIntegrity(data: Buffer, expectedSha256: string): Promise<boolean>;
@@ -1647,10 +1649,10 @@ declare class TelegramStorageProvider implements StorageProvider {
      */
     listObjects(limit: number): Promise<StoredObject[]>;
     /**
-     * Finds stored documents whose caption equals the content hash and whose size
+     * Finds stored documents whose caption equals the given caption and whose size
      * matches. Used to recover an upload whose outcome was unknown.
      */
-    findByCaption(sha256: string, size: number): Promise<StoredObject[]>;
+    findByCaption(caption: string, size: number): Promise<StoredObject[]>;
     stat(ref: StoredRef): Promise<StoredObject | null>;
     /**
      * Validates that the client is connected and the storage channel is

package/dist/index.d.ts

@@ -1106,6 +1106,8 @@ interface StorageUploadInput {
     size?: number;
     /** SHA-256 of the spooled bytes, computed while they were written. Required with `path`. */
     sha256?: string;
+    /** Message caption that identifies this upload, so a later search can find it. */
+    caption?: string;
 }
 interface StorageHealth {
     /** Reachable and usable. */
@@ -1142,7 +1144,7 @@ interface StorageProvider {
      * recover an upload whose outcome was unknown. Providers that cannot search
      * omit it, and the caller then treats the outcome as unresolved.
      */
-    findByCaption?(sha256: string, size: number): Promise<StoredObject[]>;
+    findByCaption?(caption: string, size: number): Promise<StoredObject[]>;
     /** Validates that the backing store is reachable and usable. */
     healthCheck(): Promise<StorageHealth>;
 }
@@ -1193,7 +1195,7 @@ declare class StorageEngine {
     /** Read-only listing of stored objects, for reconciliation. Never modifies anything. */
     list(limit: number): Promise<StoredObject[]>;
     /** Read-only search for stored objects with this content hash and size. */
-    findByCaption(sha256: string, size: number): Promise<StoredObject[] | null>;
+    findByCaption(caption: string, size: number): Promise<StoredObject[] | null>;
     stat(ref: StoredRef): Promise<StoredObject | null>;
     health(): Promise<StorageHealth>;
     verifyIntegrity(data: Buffer, expectedSha256: string): Promise<boolean>;
@@ -1647,10 +1649,10 @@ declare class TelegramStorageProvider implements StorageProvider {
      */
     listObjects(limit: number): Promise<StoredObject[]>;
     /**
-     * Finds stored documents whose caption equals the content hash and whose size
+     * Finds stored documents whose caption equals the given caption and whose size
      * matches. Used to recover an upload whose outcome was unknown.
      */
-    findByCaption(sha256: string, size: number): Promise<StoredObject[]>;
+    findByCaption(caption: string, size: number): Promise<StoredObject[]>;
     stat(ref: StoredRef): Promise<StoredObject | null>;
     /**
      * Validates that the client is connected and the storage channel is

package/dist/index.js

@@ -1220,10 +1220,10 @@ var StorageEngine = class {
     }
   }
   /** Read-only search for stored objects with this content hash and size. */
-  async findByCaption(sha256, size) {
+  async findByCaption(caption, size) {
     if (!this.provider.findByCaption) return null;
     try {
-      return await this.provider.findByCaption(sha256, size);
+      return await this.provider.findByCaption(caption, size);
     } catch (error) {
       throw mapProviderError("Storage lookup failed", error);
     }
@@ -1449,6 +1449,9 @@ function uploadRequestFingerprint(input) {
 function contentSha256(input) {
   return input.spooled?.sha256 ?? sha256Hex(input.data ?? Buffer.alloc(0));
 }
+function uploadCaption(sha256, operationId) {
+  return `${sha256}:${operationId}`;
+}
 function contentSize(input) {
   return input.spooled?.size ?? input.data?.byteLength ?? 0;
 }
@@ -1530,6 +1533,7 @@ var FileService = class {
     }
     try {
       const record = await this.performUpload(userId, input, {
+        caption: uploadCaption(contentSha256(input), op.operationId),
         onStored: async (stored) => {
           await operations.update(op.id, { telegramMessageId: Number(stored.messageId) });
           await operations.claim(op.id, "UPLOADING", "COMMITTING");
@@ -1561,7 +1565,7 @@ var FileService = class {
       );
     }
     const engine = await this.engineFor(userId);
-    const matches = await engine.findByCaption(op.sha256, op.size);
+    const matches = await engine.findByCaption(uploadCaption(op.sha256, op.operationId), op.size);
     if (matches === null) {
       throw new ConflictError(
         "This upload's outcome is unknown and the storage backend cannot search for it."
@@ -1666,8 +1670,9 @@ var FileService = class {
         mimeType,
         path: input.spooled.path,
         size: input.spooled.size,
-        sha256: input.spooled.sha256
-      } : { name, mimeType, data: input.data },
+        sha256: input.spooled.sha256,
+        caption: hooks.caption
+      } : { name, mimeType, data: input.data, caption: hooks.caption },
       control
     );
     await hooks.onStored?.(stored);
@@ -3035,7 +3040,7 @@ var TelegramStorageProvider = class {
         file,
         forceDocument: true,
         workers: 1,
-        caption: input.sha256,
+        caption: input.caption,
         // Surface transport-level progress to the caller. GramJS reports a
         // 0..1 fraction. `isCanceled` lets us abort an in-flight upload.
         progressCallback: Object.assign(
@@ -3194,18 +3199,18 @@ var TelegramStorageProvider = class {
     return objects;
   }
   /**
-   * Finds stored documents whose caption equals the content hash and whose size
+   * Finds stored documents whose caption equals the given caption and whose size
    * matches. Used to recover an upload whose outcome was unknown.
    */
-  async findByCaption(sha256, size) {
+  async findByCaption(caption, size) {
     const matches = [];
     try {
       for await (const message of this.client.iterMessages(this.peer, {
-        search: sha256,
+        search: caption,
         limit: 20
       })) {
         if (!(message instanceof Api2.Message)) continue;
-        if (message.message !== sha256) continue;
+        if (message.message !== caption) continue;
         const document = message.document;
         if (!(document instanceof Api2.Document)) continue;
         if (Number(document.size.toString()) !== size) continue;