refactor: mail manager changes

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

src/types/common.ts

@@ -87,7 +87,9 @@ export type ApiStreamResponse<T = any> =
 /**
  * Identifiers for targeting specific providers, services, collections, or entities in list or extant operations.
  *
-
+ * Operations accept flat arrays of colon-separated identifier strings, e.g.
+ * ["imap:account1:INBOX", "imap:account1:Sent:1001"].
+ */
 export type ProviderIdentifier = `${string}`;
 export type ServiceIdentifier = `${string}:${string}`;
 export type CollectionIdentifier = `${string}:${string}:${string | number}`;

src/types/entity.ts

@@ -92,7 +92,9 @@ export interface EntityExtantResponse {
  * Entity delta
  */
 export interface EntityDeltaRequest {
-  targets: CollectionIdentifier[];
+  // Each target is provider:service:collection, or provider:service:collection:signature
+  // to request a delta relative to a known signature (the signature is the entity slot).
+  targets: (CollectionIdentifier | EntityIdentifier)[];
 }
 
 export interface EntityDeltaResponse {