imapflow 1.7.7 → 2.0.0

package/dist/cjs/handler/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * A parsed IMAP token. `type` is one of ATOM, STRING, LITERAL, SEQUENCE, TEXT or
+ * NUMBER. A section (`BODY[...]`) and a partial range (`<0.1024>`) are attached to the
+ * token they follow.
+ */
+export interface ImapAttributeNode {
+    type: string;
+    value?: string | Buffer | number | null | undefined;
+    section?: ImapAttributeList | undefined;
+    partial?: number[] | undefined;
+    /** Redacted from logs and from the raw traffic log when set on an outgoing token */
+    sensitive?: boolean | undefined;
+    /** Emit the literal as a literal8 (RFC 3516) */
+    isLiteral8?: boolean | undefined;
+}
+/**
+ * A parenthesized list of tokens. The token properties are declared as absent so that
+ * `entry.value` can be read across the `ImapAttribute` union without narrowing first.
+ */
+export interface ImapAttributeList extends Array<ImapAttribute> {
+    type?: undefined;
+    value?: undefined;
+    section?: undefined;
+    partial?: undefined;
+}
+/**
+ * One attribute of a parsed response: a token, a nested list, or `null` for NIL
+ */
+export type ImapAttribute = ImapAttributeNode | ImapAttributeList | null;
+/**
+ * A parsed IMAP response line, or a command being compiled for the wire
+ */
+export interface ImapResponse {
+    /** The IMAP tag: "*" for untagged responses, "+" for continuation requests, or a command tag */
+    tag?: string | undefined;
+    /** The response or command name, e.g. "OK", "FETCH", or a message sequence number */
+    command?: string | undefined;
+    /** Parsed attributes of the response */
+    attributes?: ImapAttributeList | undefined;
+    /** Number of leading NUL bytes stripped from the line, if any */
+    nullBytesRemoved?: number | undefined;
+}
+/**
+ * What the command compiler accepts as a node: parsed tokens and lists, and also bare
+ * strings, numbers and Buffers, which are written as quoted strings and numbers
+ */
+export type ImapCompileNode = ImapAttributeNode | string | number | Buffer | null | undefined | false | ImapCompileNode[];
+export interface ImapCompileInput {
+    tag?: string | undefined;
+    command?: string | undefined;
+    attributes?: ImapCompileNode | ImapCompileNode[] | undefined;
+}
+export interface CompilerOptions {
+    /** Return an array of Buffers, one per literal segment, instead of a single Buffer */
+    asArray?: boolean | undefined;
+    /** Redact sensitive values and truncate long strings for logging */
+    isLogging?: boolean | undefined;
+    /** Use the LITERAL+ extension (non-synchronizing literals of any size) */
+    literalPlus?: boolean | undefined;
+    /** Use the LITERAL- extension (non-synchronizing literals up to 4096 bytes) */
+    literalMinus?: boolean | undefined;
+}
+export interface ParserOptions {
+    /** Whether the LITERAL+ extension is in use */
+    literalPlus?: boolean | undefined;
+    /** Pre-parsed literal values extracted from the input stream */
+    literals?: Buffer[] | undefined;
+    /** Maximum size in bytes of a literal parsed inline from the input */
+    maxLiteralSize?: number | undefined;
+}
+/**
+ * One assembled response as pushed by ImapStream: the line payload, its literals and the
+ * backpressure callback that must be called once the response has been processed
+ */
+export interface ImapStreamItem {
+    payload: Buffer;
+    literals: Buffer[];
+    next: () => void;
+    /** Whether more buffered input already followed this response on the wire */
+    trailingAfterLine: boolean;
+    /** Set once `next` has been called, see ImapFlow#releaseStreamData */
+    released?: boolean | undefined;
+}
+/**
+ * The SELECT or EXAMINE command that opened the current mailbox, kept so fallback polling
+ * can re-select the mailbox with the same access mode
+ */
+export interface SelectCommand {
+    command: string;
+    arguments: ImapCompileNode[];
+}

package/dist/cjs/handler/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Protocol level data shapes shared by the parser, the compiler, the command
+// implementations and the connection class.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/imap-commands.d.ts

@@ -0,0 +1,16 @@
+import type { ImapFlow } from './imap-flow.js';
+/**
+ * A command implementation: receives the connection and the arguments passed to
+ * `ImapFlow#run()` for that command
+ */
+export type CommandHandler = (connection: ImapFlow, ...args: any[]) => Promise<any>;
+/**
+ * IMAP command registry. Maps IMAP command names (uppercase strings) to their
+ * corresponding implementation modules from the `commands/` directory.
+ *
+ * Each entry maps a command name (e.g., "FETCH", "SELECT", "IDLE") to a function
+ * that builds the command request and processes the server response. This Map is
+ * used by the main ImapFlow client to look up and execute IMAP commands.
+ */
+declare const imapCommands: Map<string, CommandHandler>;
+export default imapCommands;

package/dist/cjs/imap-commands.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const id_js_1 = __importDefault(require("./commands/id.js"));
+const capability_js_1 = __importDefault(require("./commands/capability.js"));
+const namespace_js_1 = __importDefault(require("./commands/namespace.js"));
+const login_js_1 = __importDefault(require("./commands/login.js"));
+const logout_js_1 = __importDefault(require("./commands/logout.js"));
+const starttls_js_1 = __importDefault(require("./commands/starttls.js"));
+const list_js_1 = __importDefault(require("./commands/list.js"));
+const enable_js_1 = __importDefault(require("./commands/enable.js"));
+const select_js_1 = __importDefault(require("./commands/select.js"));
+const fetch_js_1 = __importDefault(require("./commands/fetch.js"));
+const create_js_1 = __importDefault(require("./commands/create.js"));
+const delete_js_1 = __importDefault(require("./commands/delete.js"));
+const rename_js_1 = __importDefault(require("./commands/rename.js"));
+const close_js_1 = __importDefault(require("./commands/close.js"));
+const subscribe_js_1 = __importDefault(require("./commands/subscribe.js"));
+const unsubscribe_js_1 = __importDefault(require("./commands/unsubscribe.js"));
+const store_js_1 = __importDefault(require("./commands/store.js"));
+const search_js_1 = __importDefault(require("./commands/search.js"));
+const noop_js_1 = __importDefault(require("./commands/noop.js"));
+const expunge_js_1 = __importDefault(require("./commands/expunge.js"));
+const append_js_1 = __importDefault(require("./commands/append.js"));
+const status_js_1 = __importDefault(require("./commands/status.js"));
+const copy_js_1 = __importDefault(require("./commands/copy.js"));
+const move_js_1 = __importDefault(require("./commands/move.js"));
+const compress_js_1 = __importDefault(require("./commands/compress.js"));
+const quota_js_1 = __importDefault(require("./commands/quota.js"));
+const idle_js_1 = __importDefault(require("./commands/idle.js"));
+const authenticate_js_1 = __importDefault(require("./commands/authenticate.js"));
+/**
+ * IMAP command registry. Maps IMAP command names (uppercase strings) to their
+ * corresponding implementation modules from the `commands/` directory.
+ *
+ * Each entry maps a command name (e.g., "FETCH", "SELECT", "IDLE") to a function
+ * that builds the command request and processes the server response. This Map is
+ * used by the main ImapFlow client to look up and execute IMAP commands.
+ */
+const imapCommands = new Map([
+    ['ID', id_js_1.default],
+    ['CAPABILITY', capability_js_1.default],
+    ['NAMESPACE', namespace_js_1.default],
+    ['LOGIN', login_js_1.default],
+    ['LOGOUT', logout_js_1.default],
+    ['STARTTLS', starttls_js_1.default],
+    ['LIST', list_js_1.default],
+    ['ENABLE', enable_js_1.default],
+    ['SELECT', select_js_1.default],
+    ['FETCH', fetch_js_1.default],
+    ['CREATE', create_js_1.default],
+    ['DELETE', delete_js_1.default],
+    ['RENAME', rename_js_1.default],
+    ['CLOSE', close_js_1.default],
+    ['SUBSCRIBE', subscribe_js_1.default],
+    ['UNSUBSCRIBE', unsubscribe_js_1.default],
+    ['STORE', store_js_1.default],
+    ['SEARCH', search_js_1.default],
+    ['NOOP', noop_js_1.default],
+    ['EXPUNGE', expunge_js_1.default],
+    ['APPEND', append_js_1.default],
+    ['STATUS', status_js_1.default],
+    ['COPY', copy_js_1.default],
+    ['MOVE', move_js_1.default],
+    ['COMPRESS', compress_js_1.default],
+    ['QUOTA', quota_js_1.default],
+    ['IDLE', idle_js_1.default],
+    ['AUTHENTICATE', authenticate_js_1.default]
+]);
+exports.default = imapCommands;
+module.exports = exports.default;
+Object.defineProperty(module.exports, 'default', { value: exports.default, enumerable: false, writable: true, configurable: true });