@internxt/sdk 1.17.10 → 1.17.12

package/dist/mail/schema.d.ts

@@ -68,7 +68,7 @@ export interface paths {
         };
         /**
          * List emails
-         * @description Paginated list of email summaries. Filter by mailbox or omit to list all.
+         * @description Paginated list of email summaries. Filter by mailbox or omit to list all. Responses collapse by thread in every mailbox except `drafts`: each row represents the most recent email of the thread in that mailbox and carries `threadSize`, `lastReceivedAt` and `participants` (cross-mailbox).
          */
         get: operations['EmailController_list'];
         put?: never;
@@ -468,6 +468,18 @@ export interface components {
             size: number;
             /** @description Present only for encrypted emails. Carries the encrypted preview and the de-identified wrapped keys for inline client-side decryption. */
             encryption?: components['schemas']['EncryptedSummaryDto'] | null;
+            /**
+             * @description Total number of emails in the thread (cross-mailbox). Set only when the list collapses threads.
+             * @example 3
+             */
+            threadSize?: number;
+            /**
+             * @description receivedAt of the most recent email in the thread (cross-mailbox). Set only when the list collapses threads.
+             * @example 2025-06-15T10:30:00Z
+             */
+            lastReceivedAt?: string;
+            /** @description Unique senders that have written in the thread (cross-mailbox), deduplicated by email. Set only when the list collapses threads. */
+            participants?: components['schemas']['EmailAddressDto'][];
         };
         EmailListResponseDto: {
             emails: components['schemas']['EmailSummaryResponseDto'][];
@@ -564,6 +576,18 @@ export interface components {
             size: number;
             /** @description Present only for encrypted emails. Carries the encrypted preview and the de-identified wrapped keys for inline client-side decryption. */
             encryption?: components['schemas']['EncryptedSummaryDto'] | null;
+            /**
+             * @description Total number of emails in the thread (cross-mailbox). Set only when the list collapses threads.
+             * @example 3
+             */
+            threadSize?: number;
+            /**
+             * @description receivedAt of the most recent email in the thread (cross-mailbox). Set only when the list collapses threads.
+             * @example 2025-06-15T10:30:00Z
+             */
+            lastReceivedAt?: string;
+            /** @description Unique senders that have written in the thread (cross-mailbox), deduplicated by email. Set only when the list collapses threads. */
+            participants?: components['schemas']['EmailAddressDto'][];
             cc: components['schemas']['EmailAddressDto'][];
             bcc: components['schemas']['EmailAddressDto'][];
             replyTo: components['schemas']['EmailAddressDto'][];

package/dist/network/download.d.ts

@@ -1,8 +1,11 @@
 import { Network } from '.';
-import { Crypto, DecryptFileFunction, DownloadFileFunction, ToBinaryDataFunction } from './types';
+import { Crypto, DecryptFileFunction, DownloadFileFunction, ToBinaryDataFunction, CryptoWithBucketKey } from './types';
 export declare class FileVersionOneError extends Error {
     constructor();
 }
 export declare function downloadFile(fileId: string, bucketId: string, mnemonic: string, network: Network, crypto: Crypto, toBinaryData: ToBinaryDataFunction, downloadFile: DownloadFileFunction, decryptFile: DecryptFileFunction, opts?: {
     token: string;
 }): Promise<void>;
+export declare function downloadFileWithBucketKey(fileId: string, bucketId: string, bucketKey: Buffer, network: Network, crypto: CryptoWithBucketKey, toBinaryData: ToBinaryDataFunction, downloadFile: DownloadFileFunction, decryptFile: DecryptFileFunction, opts?: {
+    token: string;
+}): Promise<void>;

package/dist/network/download.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileVersionOneError = void 0;
 exports.downloadFile = downloadFile;
+exports.downloadFileWithBucketKey = downloadFileWithBucketKey;
 const errors_1 = require("./errors");
 const types_1 = require("./types");
 class FileVersionOneError extends Error {
@@ -45,3 +46,31 @@ async function downloadFile(fileId, bucketId, mnemonic, network, crypto, toBinar
         throw err;
     }
 }
+async function downloadFileWithBucketKey(fileId, bucketId, bucketKey, network, crypto, toBinaryData, downloadFile, decryptFile, opts) {
+    let iv;
+    let key;
+    try {
+        const fileInfo = await network.getDownloadLinks(bucketId, fileId, opts?.token);
+        const { index, shards, version, size } = fileInfo;
+        if (!version || version === 1) {
+            throw new FileVersionOneError();
+        }
+        iv = toBinaryData(index, types_1.BinaryDataEncoding.HEX).slice(0, 16);
+        key = await crypto.generateFileKeyFromBucketKey(bucketKey, toBinaryData(index, types_1.BinaryDataEncoding.HEX));
+        const downloadables = shards.sort((sA, sB) => sA.index - sB.index);
+        await downloadFile(downloadables, fileInfo);
+        await decryptFile(crypto.algorithm.type, key, iv, size);
+    }
+    catch (err) {
+        const context = (0, errors_1.getNetworkErrorContext)({
+            bucketId,
+            fileId,
+            user: network.credentials.username,
+            crypto: {
+                bucketKey,
+            },
+        }, err);
+        err.context = context;
+        throw err;
+    }
+}

package/dist/network/errors/context.d.ts

@@ -4,6 +4,7 @@ export type NetworkUploadContext = {
     user: string;
     crypto: {
         mnemonic?: string;
+        bucketKey?: Buffer;
     };
 };
 export type NetworkDownloadContext = {
@@ -12,6 +13,7 @@ export type NetworkDownloadContext = {
     user: string;
     crypto: {
         mnemonic?: string;
+        bucketKey?: Buffer;
     };
 };
 export type NetworkContext = NetworkUploadContext | NetworkDownloadContext;

package/dist/network/errors/context.js

@@ -15,8 +15,10 @@ exports.ErrorWithContext = ErrorWithContext;
 function getNetworkErrorContext(input, err) {
     const output = Object.assign({}, input);
     delete output.crypto.mnemonic;
+    delete output.crypto.bucketKey;
     if (err instanceof upload_1.UploadInvalidMnemonicError || err instanceof download_1.DownloadInvalidMnemonicError) {
         output.crypto.mnemonic = input.crypto.mnemonic;
+        output.crypto.bucketKey = input.crypto.bucketKey;
     }
     return output;
 }

package/dist/network/types.d.ts

@@ -101,13 +101,18 @@ export type Algorithm = {
     ivSize: number;
 };
 export declare const ALGORITHMS: Record<SymmetricCryptoAlgorithm, Algorithm>;
-export type Crypto = {
+type CryptoBase = {
     algorithm: Algorithm;
-    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 Crypto = CryptoBase & {
+    validateMnemonic: (mnemonic: string) => boolean;
+    generateFileKey: (mnemonic: string, bucketId: string, index: BinaryData | string) => Promise<BinaryData>;
+};
+export type CryptoWithBucketKey = CryptoBase & {
+    generateFileKeyFromBucketKey: (bucketKey: Buffer, index: BinaryData) => Promise<BinaryData>;
+};
 export type EncryptFileFunction = (algorithm: SymmetricCryptoAlgorithm, key: BinaryData, iv: BinaryData) => Promise<void>;
 export type DecryptFileFunction = (algorithm: SymmetricCryptoAlgorithm, key: BinaryData, iv: BinaryData, fileSize: number) => Promise<void>;
 export {};

package/package.json

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