@xemahq/biomes-platform-imap 0.6.0 → 0.7.0

package/dist/connector-adapters/imap-fetch.d.ts

@@ -1,11 +1,72 @@
 import { type OutboundActionHandler } from '@xemahq/biome-sdk/adapter';
 import { EmailTlsMode } from '@xemahq/contracts/connector';
-import { type ImapAttachment, type MessageBody, type MimePartNode } from './imap-message-parts.js';
-export { DEFAULT_ATTACHMENT_SIZE_LIMIT, type ImapAttachment, type MessageBody, } from './imap-message-parts.js';
+import { type ImapAttachment, MAIL_BODYSTRUCTURE_TOO_DEEP, type MessageBody, type MimePartNode } from './imap-message-parts.js';
+import { type MailEventLog } from './mail-dial-guard.js';
+export { DEFAULT_ATTACHMENT_SIZE_LIMIT, type ImapAttachment, MAIL_BODYSTRUCTURE_TOO_DEEP, MailBodyStructureTooDeepError, MAX_BODYSTRUCTURE_DEPTH, type MessageBody, } from './imap-message-parts.js';
+export { MAIL_INBOUND_TOO_LARGE, MailInboundTooLargeError } from './mail-dial-guard.js';
 export declare const IMAP_FETCH_ACTION = "fetch";
 export declare const IMAP_FETCH_BY_UID_ACTION = "fetch-by-uid";
 export declare const IMAP_SEARCH_ACTION = "search";
 export declare const IMAP_MARK_ACTION = "mark";
+export declare const MAIL_MESSAGE_TOO_LARGE: "MAIL_MESSAGE_TOO_LARGE";
+export declare const MAIL_FETCH_TOO_LARGE: "MAIL_FETCH_TOO_LARGE";
+export declare const MAIL_MESSAGE_SIZE_MISMATCH: "MAIL_MESSAGE_SIZE_MISMATCH";
+export declare const MAIL_UNREQUESTED_RESPONSE: "MAIL_UNREQUESTED_RESPONSE";
+export declare const MAIL_SEARCH_TOO_LARGE: "MAIL_SEARCH_TOO_LARGE";
+export declare const MAIL_LIST_TOO_LARGE: "MAIL_LIST_TOO_LARGE";
+export declare const MAIL_SEARCH_FAILED: "MAIL_SEARCH_FAILED";
+export declare const MAIL_UNEXPECTED_RESPONSE: "MAIL_UNEXPECTED_RESPONSE";
+export declare class MailMessageTooLargeError extends Error {
+    readonly uid: string;
+    readonly limit: number;
+    readonly code: "MAIL_MESSAGE_TOO_LARGE";
+    constructor(uid: string, limit: number);
+}
+export declare class MailFetchTooLargeError extends Error {
+    readonly limit: number;
+    readonly code: "MAIL_FETCH_TOO_LARGE";
+    constructor(limit: number);
+}
+export declare class MailUnrequestedResponseError extends Error {
+    readonly requested: number;
+    readonly code: "MAIL_UNREQUESTED_RESPONSE";
+    constructor(requested: number);
+}
+export declare class MailListTooLargeError extends Error {
+    readonly limit: number;
+    readonly code: "MAIL_LIST_TOO_LARGE";
+    constructor(limit: number);
+}
+export declare class MailSearchFailedError extends Error {
+    readonly code: "MAIL_SEARCH_FAILED";
+    constructor();
+}
+export declare class MailSearchTooLargeError extends Error {
+    readonly limit: number;
+    readonly code: "MAIL_SEARCH_TOO_LARGE";
+    constructor(limit: number);
+}
+export declare class MailUnexpectedResponseError extends Error {
+    readonly detail: string;
+    readonly code: "MAIL_UNEXPECTED_RESPONSE";
+    constructor(detail: string);
+}
+export interface ImapLimits {
+    readonly maxMessageBytes: number;
+    readonly maxFetchBytes: number;
+    readonly maxSearchBytes: number;
+    readonly maxListBytes: number;
+    readonly maxReceivedBytes: number;
+}
+export declare const DEFAULT_IMAP_LIMITS: ImapLimits;
+export declare function resolveImapLimits(overrides?: {
+    readonly [K in keyof ImapLimits]?: number | undefined;
+}): ImapLimits;
+export interface RefusedMessage {
+    readonly code: typeof MAIL_MESSAGE_TOO_LARGE | typeof MAIL_MESSAGE_SIZE_MISMATCH | typeof MAIL_FETCH_TOO_LARGE | typeof MAIL_LIST_TOO_LARGE | typeof MAIL_BODYSTRUCTURE_TOO_DEEP;
+    readonly size: number;
+    readonly limit: number;
+}
 export interface ImapSearchCriteria {
     readonly unseen?: boolean;
     readonly flagged?: boolean;
@@ -54,6 +115,10 @@ export interface ImapMessage {
     };
     readonly bodyStructure?: MimePartNode;
 }
+export interface ImapDownloadOptions {
+    readonly uid: true;
+    readonly maxBytes?: number;
+}
 export interface ImapMailboxLock {
     release(): void;
 }
@@ -74,12 +139,7 @@ export interface ImapClientLike {
     fetch(range: string, query: Readonly<Record<string, unknown>>, options: {
         uid: true;
     }): AsyncIterable<ImapMessage>;
-    fetchOne(range: string, query: Readonly<Record<string, unknown>>, options: {
-        uid: true;
-    }): Promise<ImapMessage | false>;
-    download(range: string, part: string | undefined, options: {
-        uid: true;
-    }): Promise<ImapDownloadResult>;
+    download(range: string, part: string | undefined, options: ImapDownloadOptions): Promise<ImapDownloadResult>;
     messageFlagsAdd(range: string, flags: readonly string[], options: {
         uid: true;
     }): Promise<boolean>;
@@ -101,13 +161,17 @@ export interface BodyFetchOptions {
     readonly includeAttachments: boolean;
     readonly attachmentSizeLimit: number;
 }
+export type FetchedMessage = MessageEnvelope & MessageBody & {
+    readonly refused?: RefusedMessage;
+};
 export interface FetchSinceMarkerResult {
     readonly mailbox: string;
     readonly uidValidity: string;
     readonly criteriaHash: string;
     readonly markerReset: boolean;
-    readonly messages: readonly (MessageEnvelope & MessageBody)[];
+    readonly messages: readonly FetchedMessage[];
     readonly highestUidSeen: string;
+    readonly byteLimitReached: boolean;
     readonly attachments?: readonly ImapAttachment[];
 }
 export declare function fetchSinceMarker(client: ImapClientLike, params: {
@@ -117,6 +181,7 @@ export declare function fetchSinceMarker(client: ImapClientLike, params: {
     readonly sinceUid: number;
     readonly expectedUidValidity?: string;
     readonly body: BodyFetchOptions;
+    readonly limits?: Partial<ImapLimits>;
 }): Promise<FetchSinceMarkerResult>;
 export interface FetchByUidResult extends MessageEnvelope, MessageBody {
     readonly uidValidity: string;
@@ -131,6 +196,15 @@ export type FetchByUidOutcome = {
     readonly uidValidity: string;
 } | {
     readonly kind: 'not-found';
+} | {
+    readonly kind: 'too-large';
+    readonly refused: RefusedMessage;
+} | {
+    readonly kind: 'size-mismatch';
+    readonly refused: RefusedMessage;
+} | {
+    readonly kind: 'malformed';
+    readonly refused: RefusedMessage;
 };
 export declare function fetchByUid(client: ImapClientLike, params: {
     readonly mailbox: string;
@@ -139,6 +213,7 @@ export declare function fetchByUid(client: ImapClientLike, params: {
     readonly markSeen: boolean;
     readonly includeAttachments: boolean;
     readonly attachmentSizeLimit: number;
+    readonly limits?: Partial<ImapLimits>;
 }): Promise<FetchByUidOutcome>;
 export interface SearchResult {
     readonly mailbox: string;
@@ -150,6 +225,7 @@ export declare function searchEmails(client: ImapClientLike, params: {
     readonly criteria: ImapSearchCriteria;
     readonly limit: number;
     readonly sort: 'oldest' | 'newest';
+    readonly limits?: Partial<ImapLimits>;
 }): Promise<SearchResult>;
 export interface MarkResult {
     readonly mailbox: string;
@@ -162,8 +238,13 @@ export declare function markMessages(client: ImapClientLike, params: {
     readonly uid: string;
     readonly flags: readonly string[];
 }): Promise<MarkResult>;
-export declare function makeFetchAction(factory: ImapClientFactory): OutboundActionHandler;
-export declare function makeFetchByUidAction(factory: ImapClientFactory): OutboundActionHandler;
-export declare function makeSearchAction(factory: ImapClientFactory): OutboundActionHandler;
-export declare function makeMarkAction(factory: ImapClientFactory): OutboundActionHandler;
+export interface ImapActionOptions {
+    readonly limits?: Partial<ImapLimits>;
+    readonly operationMs?: number;
+    readonly log?: MailEventLog;
+}
+export declare function makeFetchAction(factory: ImapClientFactory, options?: ImapActionOptions): OutboundActionHandler;
+export declare function makeFetchByUidAction(factory: ImapClientFactory, options?: ImapActionOptions): OutboundActionHandler;
+export declare function makeSearchAction(factory: ImapClientFactory, options?: ImapActionOptions): OutboundActionHandler;
+export declare function makeMarkAction(factory: ImapClientFactory, options?: ImapActionOptions): OutboundActionHandler;
 //# sourceMappingURL=imap-fetch.d.ts.map

package/dist/connector-adapters/imap-message-parts.d.ts

@@ -38,7 +38,14 @@ export interface FlatAttachment {
     readonly size: number;
     readonly partId: string;
 }
-export declare function flattenAttachmentParts(node: MimePartNode, parentId?: string): FlatAttachment[];
+export declare const MAX_BODYSTRUCTURE_DEPTH = 32;
+export declare const MAIL_BODYSTRUCTURE_TOO_DEEP: "MAIL_BODYSTRUCTURE_TOO_DEEP";
+export declare class MailBodyStructureTooDeepError extends Error {
+    readonly limit: number;
+    readonly code: "MAIL_BODYSTRUCTURE_TOO_DEEP";
+    constructor(limit: number);
+}
+export declare function flattenAttachmentParts(node: MimePartNode, parentId?: string, depth?: number): FlatAttachment[];
 export declare function extractBodies(raw: string): MessageBody;
 export declare function extractReferences(raw: string): string[] | undefined;
 export declare function parseSource(raw: string): ParsedSource;