@internxt/sdk 1.17.8 → 1.17.10

package/dist/mail/index.d.ts

@@ -102,9 +102,30 @@ export declare class MailApi {
      * Saves a draft email
      *
      * @param body - The body of the draft email to save
-     * @returns The created email - `EmailCreatedResponse`
+     * @returns The created email - `EmailResponse`
      */
-    saveDraft(body: DraftEmailRequest): Promise<EmailCreatedResponse>;
+    saveDraft(body: DraftEmailRequest): Promise<EmailResponse>;
+    /**
+     * Updates the draft with the corresponding id
+     *
+     * @param id - The id of the draft to update
+     * @param body - The new body of the draft
+     * @returns The new Draft Id for this email
+     */
+    updateDraft(id: string, body: DraftEmailRequest): Promise<EmailResponse>;
+    /**
+     * Gets the draft with the corresponding id
+     *
+     * @param id - The id of the draft
+     * @returns The draft with the corresponding id - `EmailResponse`
+     */
+    getDraft(id: string): Promise<EmailResponse>;
+    /**
+     * Discards an existent mail draft
+     * @param id - The id of the draft we want to discard
+     * @returns A promise that resolves when the draft is discarded
+     */
+    discardDraft(id: string): Promise<void>;
     /**
      * Returns the list of active domains for the email gateway
      *

package/dist/mail/index.js

@@ -138,11 +138,38 @@ class MailApi {
      * Saves a draft email
      *
      * @param body - The body of the draft email to save
-     * @returns The created email - `EmailCreatedResponse`
+     * @returns The created email - `EmailResponse`
      */
     saveDraft(body) {
         return this.client.post('/email/drafts', body, this.headers());
     }
+    /**
+     * Updates the draft with the corresponding id
+     *
+     * @param id - The id of the draft to update
+     * @param body - The new body of the draft
+     * @returns The new Draft Id for this email
+     */
+    updateDraft(id, body) {
+        return this.client.patch(`/email/drafts/${id}`, body, this.headers());
+    }
+    /**
+     * Gets the draft with the corresponding id
+     *
+     * @param id - The id of the draft
+     * @returns The draft with the corresponding id - `EmailResponse`
+     */
+    getDraft(id) {
+        return this.client.get(`/email/drafts/${id}`, this.headers());
+    }
+    /**
+     * Discards an existent mail draft
+     * @param id - The id of the draft we want to discard
+     * @returns A promise that resolves when the draft is discarded
+     */
+    discardDraft(id) {
+        return this.client.delete(`/email/drafts/${id}`, this.headers());
+    }
     /**
      * Returns the list of active domains for the email gateway
      *

package/dist/mail/schema.d.ts

@@ -170,7 +170,7 @@ export interface paths {
         put?: never;
         /**
          * Save a draft
-         * @description Creates a new draft email. All fields are optional so partial drafts can be saved.
+         * @description Creates a new draft email. All fields are optional so partial drafts can be saved. Pass `encryption` to store the body encrypted only with the sender's key — the sender is the only reader and can decrypt it on retrieval.
          */
         post: operations['EmailController_saveDraft'];
         delete?: never;
@@ -179,6 +179,34 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    '/email/drafts/{id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a draft
+         * @description Returns a draft
+         */
+        get: operations['EmailController_getDraft'];
+        put?: never;
+        post?: never;
+        /**
+         * Discard a draft
+         * @description Permanently discards a draft by ID. Returns 404 if the email exists but is not a draft.
+         */
+        delete: operations['EmailController_discardDraft'];
+        options?: never;
+        head?: never;
+        /**
+         * Update a draft
+         * @description Updates a draft email. All fields are optional so partial drafts can be saved. Pass `encryption` with a fresh envelope to replace the stored body — the previous envelope is dropped together with the destroyed draft.
+         */
+        patch: operations['EmailController_updateDraft'];
+        trace?: never;
+    };
     '/email/attachment': {
         parameters: {
             query?: never;
@@ -430,6 +458,8 @@ export interface components {
             /** @example false */
             isFlagged: boolean;
             /** @example false */
+            isDraft: boolean;
+            /** @example false */
             hasAttachment: boolean;
             /**
              * @description Size in bytes
@@ -524,6 +554,8 @@ export interface components {
             /** @example false */
             isFlagged: boolean;
             /** @example false */
+            isDraft: boolean;
+            /** @example false */
             hasAttachment: boolean;
             /**
              * @description Size in bytes
@@ -616,6 +648,11 @@ export interface components {
              * @example Ma1f09b…
              */
             inReplyToEmailId?: string;
+            /**
+             * @description JMAP id of the draft being sent. When present, the draft is destroyed after the email is sent so it no longer appears in the Drafts folder.
+             * @example Ma1f09b…
+             */
+            draftId?: string;
         };
         EmailCreatedResponseDto: {
             /**
@@ -634,6 +671,8 @@ export interface components {
             textBody?: string;
             /** @example <p>Still working on this…</p> */
             htmlBody?: string;
+            /** @description When present, the draft body is stored encrypted. Only the sender can decrypt it later, so wrappedKeys / attachmentWrappedKeys should contain a single entry built from the sender's own public key. */
+            encryption?: components['schemas']['EncryptionBlockDto'];
             attachments?: components['schemas']['AttachmentRefDto'][];
         };
         UploadAttachmentResponseDto: {
@@ -944,8 +983,98 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['EmailCreatedResponseDto'];
+                    'application/json': components['schemas']['EmailResponseDto'];
+                };
+            };
+        };
+    };
+    EmailController_getDraft: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content: {
+                    'application/json': components['schemas']['EmailResponseDto'];
+                };
+            };
+            /** @description Draft not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EmailController_discardDraft: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Draft discarded successfully */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Draft not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EmailController_updateDraft: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['DraftEmailRequestDto'];
+            };
+        };
+        responses: {
+            /** @description Draft updated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['EmailResponseDto'];
+                };
+            };
+            /** @description Draft not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
             };
         };
     };

package/dist/mail/types.d.ts

@@ -11,6 +11,8 @@ export type LookupRecipientKeysRequest = components['schemas']['LookupRecipientK
 export type LookupRecipientKeysResponse = components['schemas']['LookupRecipientKeysResponseDto'];
 export type RecipientKey = components['schemas']['RecipientKeyDto'];
 export type DraftEmailRequest = components['schemas']['DraftEmailRequestDto'];
+export type GetDraftPayload = operations['EmailController_getDraft']['parameters']['query'];
+export type DiscardDraftPayload = operations['EmailController_discardDraft']['parameters']['query'];
 export type UpdateEmailRequest = components['schemas']['UpdateEmailRequestDto'];
 export type EmailAddress = components['schemas']['EmailAddressDto'];
 export type ListEmailsQuery = operations['EmailController_list']['parameters']['query'];

package/dist/network/types.d.ts

@@ -62,13 +62,19 @@ type UploadPayload = {
 export type StartUploadPayload = {
     uploads: UploadPayload[];
 };
+export type HmacPayload = {
+    type: 'sha512';
+    value: string;
+};
 export type FinishUploadPayload = {
     index: string;
     shards: Shard[];
+    hmac?: HmacPayload;
 };
 export type FinishMultipartUploadPayload = {
     index: string;
     shards: ShardForMultipart[];
+    hmac?: HmacPayload;
 };
 export type UploadFileFunction = (url: string) => Promise<Hash>;
 export type UploadFileMultipartFunction = (urls: string[]) => Promise<{
@@ -100,6 +106,7 @@ export type Crypto = {
     validateMnemonic: (mnemonic: string) => boolean;
     randomBytes: (bytesLength: number) => BinaryData;
     generateFileKey: (mnemonic: string, bucketId: string, index: BinaryData | string) => Promise<BinaryData>;
+    computeHmac?: (key: BinaryData, shardHashes: string[]) => Promise<HmacPayload>;
 };
 export type EncryptFileFunction = (algorithm: SymmetricCryptoAlgorithm, key: BinaryData, iv: BinaryData) => Promise<void>;
 export type DecryptFileFunction = (algorithm: SymmetricCryptoAlgorithm, key: BinaryData, iv: BinaryData, fileSize: number) => Promise<void>;

package/dist/network/upload.js

@@ -22,9 +22,11 @@ async function uploadFile(network, crypto, bucketId, mnemonic, fileSize, encrypt
         }
         await encryptFile(crypto.algorithm.type, key, iv);
         const hash = await uploadFile(url);
+        const hmac = crypto.computeHmac ? await crypto.computeHmac(key, [hash]) : undefined;
         const finishUploadPayload = {
             index: index.toString('hex'),
             shards: [{ hash, uuid }],
+            hmac,
         };
         const finishUploadResponse = await network.finishUpload(bucketId, finishUploadPayload, signal);
         return finishUploadResponse.id;
@@ -60,9 +62,11 @@ async function uploadMultipartFile(network, crypto, bucketId, mnemonic, fileSize
     }
     await encryptFile(crypto.algorithm.type, key, iv);
     const { hash, parts: uploadedPartsReference } = await uploadMultiparts(urls);
+    const hmac = crypto.computeHmac ? await crypto.computeHmac(key, [hash]) : undefined;
     const finishUploadPayload = {
         index: index.toString('hex'),
         shards: [{ hash, uuid, UploadId, parts: uploadedPartsReference }],
+        hmac,
     };
     const finishUploadResponse = await network.finishMultipartUpload(bucketId, finishUploadPayload, signal);
     return finishUploadResponse.id;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@internxt/sdk",
   "author": "Internxt <hello@internxt.com>",
-  "version": "1.17.8",
+  "version": "1.17.10",
   "description": "An sdk for interacting with Internxt's services",
   "repository": {
     "type": "git",