@push.rocks/smartjmap 1.0.0

package/dist_ts/classes.jmapserver.d.ts

@@ -0,0 +1,110 @@
+import type { IJmapEmailAddress } from './classes.jmapclient.js';
+export interface IJmapServerMailbox {
+    id: string;
+    name: string;
+    role: string | null;
+    parentId: string | null;
+    sortOrder: number;
+}
+export interface IJmapServerBlob {
+    data: Buffer;
+    type: string;
+    name?: string;
+}
+export interface IJmapServerChangeEntry {
+    state: number;
+    created: string[];
+    updated: string[];
+    destroyed: string[];
+}
+export interface IJmapServerIdentity {
+    id: string;
+    name: string;
+    email: string;
+    mayDelete: boolean;
+}
+export interface IJmapServerSubmission {
+    id: string;
+    emailId: string;
+    identityId: string;
+    undoStatus: string;
+    sendAt: string;
+}
+export interface IJmapServerUser {
+    username: string;
+    password: string;
+    bearerTokens: Set<string>;
+    accountId: string;
+    mailboxes: Map<string, IJmapServerMailbox>;
+    emails: Map<string, Record<string, any>>;
+    blobs: Map<string, IJmapServerBlob>;
+    submissions: Map<string, IJmapServerSubmission>;
+    identities: IJmapServerIdentity[];
+    state: number;
+    changes: IJmapServerChangeEntry[];
+    idCounter: number;
+}
+export interface IJmapServerEmailInput {
+    from: IJmapEmailAddress | IJmapEmailAddress[];
+    to: IJmapEmailAddress | IJmapEmailAddress[];
+    cc?: IJmapEmailAddress[];
+    bcc?: IJmapEmailAddress[];
+    subject?: string;
+    textBody?: string;
+    htmlBody?: string;
+    keywords?: Record<string, boolean>;
+    receivedAt?: string;
+    attachments?: Array<{
+        name: string;
+        type: string;
+        content: string | Uint8Array;
+    }>;
+}
+/**
+ * A minimal in-memory JMAP server (RFC 8620 core + RFC 8621 mail subset)
+ * for offline testing. Serves the session resource at /.well-known/jmap and
+ * /jmap/session, the API at /jmap/api, blob downloads at /jmap/download/...,
+ * and StateChange pushes via SSE at /jmap/eventsource.
+ */
+export declare class JmapServer {
+    users: Map<string, IJmapServerUser>;
+    private server;
+    private sockets;
+    private eventStreams;
+    constructor();
+    addUser(username: string, password: string): void;
+    /** Registers a valid Bearer token for a user. */
+    addBearerToken(username: string, token: string): void;
+    createMailbox(username: string, name: string, role?: string): string;
+    /** Seeds an email into a user's mailbox; bumps state and pushes a StateChange. Returns the email id. */
+    addEmail(username: string, mailboxName: string, input: IJmapServerEmailInput): string;
+    /** Starts the server. Resolves with the bound port (pass 0 for an ephemeral port). */
+    start(port: number): Promise<number>;
+    /** Stops the server, ending open event streams and destroying open connections. */
+    stop(): Promise<void>;
+    private handleRequest;
+    private authenticate;
+    private handleSession;
+    private handleApi;
+    private handleEventSource;
+    private handleDownload;
+    private dispatchMethod;
+    private methodMailboxGet;
+    private methodMailboxQuery;
+    private methodEmailGet;
+    private methodEmailQuery;
+    private methodEmailChanges;
+    private methodEmailSet;
+    private methodIdentityGet;
+    private methodEmailSubmissionSet;
+    private requireUser;
+    private createEmailFromSpec;
+    /**
+     * Applies an Email/set update patch: either whole properties (e.g. keywords)
+     * or JSON-pointer style paths like "keywords/$seen" (RFC 8620 §5.3).
+     */
+    private applyPatch;
+    /** Increments the account state, records the change, and pushes a StateChange to open event streams. */
+    private bumpState;
+    private notifyStateChange;
+}