@push.rocks/smartjmap 1.0.0 → 2.1.0

package/.smartconfig.json

@@ -1,12 +1,13 @@
 {
   "@git.zone/cli": {
+    "schemaVersion": 2,
     "projectType": "npm",
     "module": {
       "githost": "code.foss.global",
       "gitscope": "push.rocks",
       "gitrepo": "smartjmap",
-      "shortDescription": "JMAP client for mail (RFC 8620/8621)",
-      "description": "A TypeScript JMAP client for reading, sending, and watching mail via the JSON Meta Application Protocol (RFC 8620/8621), with a bundled test server for offline testing.",
+      "shortDescription": "JMAP client and server core for mail (RFC 8620/8621)",
+      "description": "A TypeScript JMAP toolkit (RFC 8620/8621): an event-driven mail client for reading, sending, and watching mail, plus an embeddable JMAP server core with pluggable storage.",
       "npmPackagename": "@push.rocks/smartjmap",
       "license": "MIT",
       "projectDomain": "push.rocks",
@@ -21,6 +22,8 @@
         "json",
         "http",
         "client",
+        "server",
+        "deno",
         "typescript",
         "event-driven",
         "push",

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartjmap',
-    version: '1.0.0',
-    description: 'A TypeScript JMAP client for reading, sending, and watching mail via the JSON Meta Application Protocol (RFC 8620/8621), with a bundled test server for offline testing.'
+    version: '2.1.0',
+    description: 'A TypeScript JMAP toolkit (RFC 8620/8621): an event-driven mail client for reading, sending, and watching mail, plus an embeddable JMAP server core with pluggable storage.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBLQUEwSztDQUN4TCxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDZLQUE2SztDQUMzTCxDQUFBIn0=

package/dist_ts/classes.jmapclient.d.ts

@@ -125,6 +125,12 @@ export interface ISmartJmapMessage {
     /** The full raw JMAP Email object as returned by Email/get. */
     raw: IJmapEmail;
 }
+/** An attachment reference for outgoing mail; upload the bytes first via `uploadBlob`. */
+export interface IJmapOutgoingAttachment {
+    blobId: string;
+    type: string;
+    name?: string;
+}
 export interface IJmapOutgoingEmail {
     /** Sender; defaults to the address of the account's first JMAP Identity. */
     from?: IJmapEmailAddress;
@@ -134,11 +140,20 @@ export interface IJmapOutgoingEmail {
     subject?: string;
     textBody?: string;
     htmlBody?: string;
+    /** Attachments referencing blobs previously uploaded with `uploadBlob`. */
+    attachments?: IJmapOutgoingAttachment[];
 }
 export interface IJmapSendResult {
     emailId: string;
     submissionId: string;
 }
+/** The upload endpoint's response (RFC 8620 §6.1). */
+export interface IJmapUploadResult {
+    accountId: string;
+    blobId: string;
+    type: string;
+    size: number;
+}
 /** Error thrown for HTTP-level (RFC 7807 problem details) and JMAP method-level errors. */
 export declare class JmapError extends Error {
     httpStatus?: number;
@@ -151,18 +166,8 @@ export declare class JmapError extends Error {
 }
 export declare class JmapClient extends plugins.events.EventEmitter {
     private config;
-    private session;
-    private accountId;
-    private apiUrl;
-    private mailbox;
-    private connected;
-    private stopped;
-    private lastEmailState;
-    private seenEmailIds;
-    private pollTimer;
-    private sseAbortController;
-    private fetchingDeltas;
-    private deltaQueued;
+    private generationCounter;
+    private connectionGeneration;
     constructor(config: IJmapClientConfig);
     /**
      * Fetches and validates the JMAP session, resolves the target mailbox,
@@ -184,30 +189,56 @@ export declare class JmapClient extends plugins.events.EventEmitter {
      * JmapError with `httpStatus`/`problemType`/`jmapErrorType` fields.
      */
     request(methodCalls: TJmapMethodCall[]): Promise<TJmapMethodResponse[]>;
+    private requestWithGeneration;
     /** Returns all mailboxes of the account (Mailbox/get with ids: null). */
     getMailboxes(): Promise<IJmapMailbox[]>;
+    private getMailboxesWithGeneration;
     /**
      * Runs Email/query (default filter: the watched mailbox) followed by a full
      * Email/get and returns resolved messages, newest first.
      */
     queryEmails(filter?: Record<string, any>, limit?: number): Promise<ISmartJmapMessage[]>;
+    private queryEmailsWithGeneration;
     /** Fetches a single email with all body values resolved (RFC 8621 §4.2, fetchAllBodyValues). */
     getEmail(id: string): Promise<ISmartJmapMessage>;
     /** Replaces the full keywords object of an email via Email/set. */
     setKeywords(emailId: string, keywords: Record<string, boolean>): Promise<void>;
     /** Convenience: sets the $seen keyword via an Email/set keywords patch. */
     markSeen(emailId: string): Promise<void>;
+    /** Convenience: removes the $seen keyword via an Email/set keywords patch. */
+    markUnseen(emailId: string): Promise<void>;
+    /** Convenience: adds or removes the $flagged keyword. */
+    setFlagged(emailId: string, flagged: boolean): Promise<void>;
+    /**
+     * Replaces the email's mailbox membership. Pass one mailbox id for a
+     * provider-style move, or multiple ids when the remote JMAP account
+     * supports multi-mailbox membership.
+     */
+    setMailboxes(emailId: string, mailboxIds: string[]): Promise<void>;
+    /** Permanently destroys an email via Email/set. */
+    destroyEmail(emailId: string): Promise<void>;
     /**
      * Sends an email: Identity/get lookup, Email/set create (into the mailbox
      * with role 'sent', falling back to 'drafts', then the watched mailbox) and
      * EmailSubmission/set referencing the created email.
      */
     sendEmail(outgoing: IJmapOutgoingEmail): Promise<IJmapSendResult>;
+    /**
+     * Uploads raw bytes to the session's uploadUrl (RFC 8620 §6.1) and returns
+     * the stored blob's id, type, and size. Use the blobId in
+     * `sendEmail({ attachments: [...] })` or any other blob reference.
+     */
+    uploadBlob(data: Uint8Array, type?: string): Promise<IJmapUploadResult>;
     /**
      * Downloads a blob's raw bytes using the session downloadUrl template
      * (RFC 8620 §6.2: {accountId}, {blobId}, {type}, {name}).
      */
     downloadBlob(blobId: string, type?: string, name?: string): Promise<Uint8Array>;
+    private createConnectionGeneration;
+    private isCurrentGeneration;
+    private assertCurrentGeneration;
+    private requireConnectedGeneration;
+    private teardownGeneration;
     private getAuthHeader;
     private createHttpError;
     private resolveMailbox;
@@ -232,5 +263,4 @@ export declare class JmapClient extends plugins.events.EventEmitter {
     private fetchDeltasOnce;
     /** Full resync fallback when the server cannot calculate changes. */
     private resyncViaQuery;
-    private teardownWatchers;
 }