@push.rocks/smartjmap 2.0.0 → 2.1.0

package/ts/interfaces.backend.ts

@@ -122,6 +122,18 @@ export interface IJmapSubmissionInput {
   message: Uint8Array;
 }
 
+/**
+ * Authenticated, admitted upload handed to a streaming backend. The backend
+ * must reserve quota before reading `stream`, consume it through EOF, and
+ * abort its storage operation when `signal` fires.
+ */
+export interface IJmapBlobUploadStream {
+  stream: ReadableStream<Uint8Array>;
+  size: number;
+  type: string;
+  signal: AbortSignal;
+}
+
 /** Standard result shape for the /get-style backend reads. */
 export interface IJmapGetResult<T> {
   /** Backend-owned opaque state string for the collection at read time. */
@@ -367,6 +379,15 @@ export interface IJmapMailBackend {
     type: string
   ): Promise<{ blobId: string; size: number }>;
 
+  /**
+   * Optional streaming upload path. When present, JmapServer requires a valid
+   * Content-Length and never buffers the request before invoking this method.
+   */
+  uploadBlobStream?(
+    accountId: string,
+    upload: IJmapBlobUploadStream
+  ): Promise<{ blobId: string; size: number }>;
+
   /** Returns a blob's bytes and metadata, or null when unknown. */
   getBlob(accountId: string, blobId: string): Promise<IJmapBlobRecord | null>;