@msssystems/mss-link-sdk 0.1.11 → 0.1.12

package/dist/client/drive-key-wrapping.contracts.d.ts

@@ -1,6 +1,7 @@
 import type { DriveItemType, DriveWrappedItemKey } from './drive-sharing.contracts';
 export type DriveRecipientPublicKeyAlgorithm = 'X25519';
 export type DriveWrappedItemKeyAlgorithm = 'MSS-DRIVE-PUBLIC-KEY-WRAPPED-ITEM-KEY-v1';
+export type DriveItemKeyMaterialKind = 'content-key' | 'folder-metadata-envelope';
 export interface DriveRecipientPublicKey {
     algorithm: DriveRecipientPublicKeyAlgorithm;
     keyId: string;
@@ -14,6 +15,7 @@ export interface DriveRecipientKeyTarget {
 }
 export interface DriveItemContentKeyEnvelope {
     algorithm?: 'AES-256-GCM' | string | null;
+    keyMaterialKind?: DriveItemKeyMaterialKind | string | null;
     keyId?: string | null;
     nonce?: string | null;
     wrappedKey: string;
@@ -39,10 +41,20 @@ export interface CreateDriveWrappedItemKeyForRecipientInput {
     recipient: DriveRecipientKeyTarget;
     wrappingAdapter: DrivePublicKeyWrappingAdapter;
 }
+export interface CreateDriveWrappedFolderKeyForRecipientInput {
+    encryptedFolderMetadata: {
+        encryptedName: string;
+        schema?: 'mss.link.drive-folder-metadata.v1' | string;
+    };
+    folderId: string;
+    recipient: DriveRecipientKeyTarget;
+    wrappingAdapter: DrivePublicKeyWrappingAdapter;
+}
 export interface DriveWrappedItemKeyPayload {
     contentAlgorithm: string;
     contentKey: string;
     contentKeyId?: string;
+    contentKeyMaterialKind: DriveItemKeyMaterialKind;
     contentNonce?: string;
     createdAt: string;
     itemId: string;

package/dist/client/drive-key-wrapping.d.ts

@@ -1,2 +1,3 @@
-import type { CreateDriveWrappedItemKeyForRecipientInput, DriveWrappedItemKeyForRecipientResult } from './drive-key-wrapping.contracts';
+import type { CreateDriveWrappedFolderKeyForRecipientInput, CreateDriveWrappedItemKeyForRecipientInput, DriveWrappedItemKeyForRecipientResult } from './drive-key-wrapping.contracts';
 export declare function createDriveWrappedItemKeyForRecipient(input: CreateDriveWrappedItemKeyForRecipientInput): Promise<DriveWrappedItemKeyForRecipientResult>;
+export declare function createDriveWrappedFolderKeyForRecipient(input: CreateDriveWrappedFolderKeyForRecipientInput): Promise<DriveWrappedItemKeyForRecipientResult>;

package/dist/client/drive-key-wrapping.js

@@ -1,5 +1,7 @@
+import { normalizeEncryptedDriveFolderMetadataInput } from './storage-metadata-crypto';
 const CONTENT_KEY_SCHEMA = 'mss.link.drive.item-key.v1';
 const WRAPPED_ITEM_KEY_ALGORITHM = 'MSS-DRIVE-PUBLIC-KEY-WRAPPED-ITEM-KEY-v1';
+const FOLDER_METADATA_KEY_ID_PREFIX = 'drive-folder-metadata';
 export async function createDriveWrappedItemKeyForRecipient(input) {
     const itemId = normalizeRequiredText(input.itemId, 'Drive item id is required for key wrapping.');
     const itemType = input.itemType;
@@ -29,6 +31,24 @@ export async function createDriveWrappedItemKeyForRecipient(input) {
         }),
     };
 }
+export function createDriveWrappedFolderKeyForRecipient(input) {
+    const folderId = normalizeRequiredText(input.folderId, 'Drive folder id is required for key wrapping.');
+    const metadata = normalizeEncryptedDriveFolderMetadataInput({
+        encryptedName: input.encryptedFolderMetadata.encryptedName,
+    });
+    return createDriveWrappedItemKeyForRecipient({
+        contentKey: {
+            algorithm: 'AES-256-GCM',
+            keyId: `${FOLDER_METADATA_KEY_ID_PREFIX}:${folderId}`,
+            keyMaterialKind: 'folder-metadata-envelope',
+            wrappedKey: metadata.encryptedName,
+        },
+        itemId: folderId,
+        itemType: 'folder',
+        recipient: input.recipient,
+        wrappingAdapter: input.wrappingAdapter,
+    });
+}
 function buildWrappedItemKeyPayload({ contentKey, itemId, itemType, }) {
     return {
         schema: CONTENT_KEY_SCHEMA,
@@ -36,6 +56,7 @@ function buildWrappedItemKeyPayload({ contentKey, itemId, itemType, }) {
         itemType,
         contentAlgorithm: contentKey.algorithm,
         contentKey: contentKey.wrappedKey,
+        contentKeyMaterialKind: contentKey.keyMaterialKind,
         createdAt: new Date().toISOString(),
         ...(contentKey.keyId ? { contentKeyId: contentKey.keyId } : {}),
         ...(contentKey.nonce ? { contentNonce: contentKey.nonce } : {}),
@@ -74,10 +95,19 @@ function normalizeContentKey(contentKey) {
     return {
         algorithm,
         keyId: normalizeOptionalText(contentKey.keyId) ?? '',
+        keyMaterialKind: normalizeKeyMaterialKind(contentKey.keyMaterialKind),
         nonce: normalizeOptionalText(contentKey.nonce) ?? '',
         wrappedKey: normalizeRequiredText(contentKey.wrappedKey, 'Drive item content key is required.'),
     };
 }
+function normalizeKeyMaterialKind(kind) {
+    const normalized = normalizeOptionalText(kind) ?? 'content-key';
+    if (normalized !== 'content-key' &&
+        normalized !== 'folder-metadata-envelope') {
+        throw new Error(`Unsupported Drive item key material kind: ${normalized}`);
+    }
+    return normalized;
+}
 function normalizeWrappingAdapter(adapter) {
     if (!adapter || typeof adapter.wrapDriveItemKey !== 'function') {
         throw new Error('Drive public-key wrapping adapter is not configured.');

package/dist/client/mss-link-browser-client.d.ts

@@ -4,7 +4,7 @@ import type { DecryptMediaBlobInput, DecryptedMediaBlobResult, EncryptedMediaBlo
 import type { SendMediaMessageParams } from './media-message.contracts';
 import type { DecryptedMessage } from './message.contracts';
 import type { DecryptDriveFileMetadataInput, DecryptDriveFolderMetadataInput, DecryptedDriveFileMetadata, DecryptedDriveFolderMetadata, EncryptedDriveFileMetadata, EncryptedDriveFolderMetadata, EncryptDriveFileMetadataInput, EncryptDriveFolderMetadataInput } from './storage-metadata-crypto.contracts';
-import type { CreateDriveWrappedItemKeyForRecipientInput, DriveWrappedItemKeyForRecipientResult } from './drive-key-wrapping.contracts';
+import type { CreateDriveWrappedFolderKeyForRecipientInput, CreateDriveWrappedItemKeyForRecipientInput, DriveWrappedItemKeyForRecipientResult } from './drive-key-wrapping.contracts';
 export declare class MssLinkBrowserClient {
     private readonly userId;
     private readonly apiBaseUrl;
@@ -36,6 +36,7 @@ export declare class MssLinkBrowserClient {
     encryptDriveFileMetadata(input: EncryptDriveFileMetadataInput): Promise<EncryptedDriveFileMetadata>;
     decryptDriveFileMetadata(input: DecryptDriveFileMetadataInput): Promise<DecryptedDriveFileMetadata>;
     createDriveWrappedItemKeyForRecipient(input: CreateDriveWrappedItemKeyForRecipientInput): Promise<DriveWrappedItemKeyForRecipientResult>;
+    createDriveWrappedFolderKeyForRecipient(input: CreateDriveWrappedFolderKeyForRecipientInput): Promise<DriveWrappedItemKeyForRecipientResult>;
     syncMessages(): Promise<void>;
     getLocalMessages(chatId: string): Promise<DecryptedMessage[]>;
     reset(): void;

package/dist/client/mss-link-browser-client.js

@@ -4,7 +4,7 @@ import { checkLocalCryptoHealth } from './local-crypto-health';
 import { buildMediaMessageMetadataPayload, extractMediaAssetIds, serializeMediaMessageMetadata, } from './media-message-metadata';
 import { mapLocalSdkMessage } from './message.mapper';
 import { buildDecryptedDriveFileMetadata, buildDecryptedDriveFolderMetadata, buildEncryptedDriveFileMetadata, buildEncryptedDriveFolderMetadata, normalizeDriveFileMetadataInput, normalizeDriveFolderMetadataInput, normalizeEncryptedDriveFileMetadataInput, normalizeEncryptedDriveFolderMetadataInput, } from './storage-metadata-crypto';
-import { createDriveWrappedItemKeyForRecipient } from './drive-key-wrapping';
+import { createDriveWrappedFolderKeyForRecipient, createDriveWrappedItemKeyForRecipient, } from './drive-key-wrapping';
 import { WasmCallQueue } from './wasm-call-queue';
 const DEFAULT_DEVICE_ID = 1;
 const DEFAULT_REGISTRATION_ID = 1;
@@ -213,6 +213,9 @@ export class MssLinkBrowserClient {
     createDriveWrappedItemKeyForRecipient(input) {
         return createDriveWrappedItemKeyForRecipient(input);
     }
+    createDriveWrappedFolderKeyForRecipient(input) {
+        return createDriveWrappedFolderKeyForRecipient(input);
+    }
     async syncMessages() {
         try {
             await this.runWithClient((client) => client.syncMessages());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msssystems/mss-link-sdk",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Official managed application SDK for MSS ecosystem",
   "type": "module",
   "main": "./dist/index.js",