@majikah/majik-file 0.0.12 → 0.0.13

package/dist/majik-file.d.ts

@@ -61,10 +61,10 @@ export declare class MajikFile {
     private _isShared;
     private _shareToken;
     private readonly _context;
-    private readonly _chatMessageId;
-    private readonly _threadMessageId;
-    private readonly _threadId;
-    private readonly _conversationId;
+    private _chatMessageId;
+    private _threadMessageId;
+    private _threadId;
+    private _conversationId;
     private _participants;
     private _expiresAt;
     private readonly _timestamp;
@@ -208,6 +208,18 @@ export declare class MajikFile {
      * via the recipients array). To check owner access use `userIsOwner()`.
      */
     hasParticipantAccess(publicKey: MajikMessagePublicKey): boolean;
+    /**
+     * Bind this file to a thread mail after initial creation.
+     * Can only be called once — throws if either ID is already set.
+     * Call toJSON() and persist to Supabase after binding.
+     */
+    bindToThreadMail(threadId: string, threadMessageId: string): void;
+    /**
+     * Bind this file to a chat conversation after initial creation.
+     * Can only be called once — throws if either ID is already set.
+     * Call toJSON() and persist to Supabase after binding.
+     */
+    bindToChatConversation(conversationID: string, chatMessageID: string): void;
     /**
      * Decrypt a .mjkb Blob, Uint8Array, or ArrayBuffer.
      *

package/dist/majik-file.js

@@ -526,6 +526,52 @@ export class MajikFile {
             return false;
         return this._participants.includes(publicKey);
     }
+    /**
+     * Bind this file to a thread mail after initial creation.
+     * Can only be called once — throws if either ID is already set.
+     * Call toJSON() and persist to Supabase after binding.
+     */
+    bindToThreadMail(threadId, threadMessageId) {
+        if (this._context !== "thread_attachment") {
+            throw MajikFileError.invalidInput("bindToThreadMail: only thread_attachment files can be bound to a mail");
+        }
+        if (this._threadId || this._threadMessageId) {
+            throw MajikFileError.invalidInput("bindToThreadMail: this file is already bound to a thread mail — " +
+                "IDs are immutable once set");
+        }
+        if (!threadId?.trim()) {
+            throw MajikFileError.invalidInput("bindToThreadMail: threadId is required");
+        }
+        if (!threadMessageId?.trim()) {
+            throw MajikFileError.invalidInput("bindToThreadMail: threadMessageId is required");
+        }
+        this._threadId = threadId;
+        this._threadMessageId = threadMessageId;
+        this._lastUpdate = new Date().toISOString();
+    }
+    /**
+     * Bind this file to a chat conversation after initial creation.
+     * Can only be called once — throws if either ID is already set.
+     * Call toJSON() and persist to Supabase after binding.
+     */
+    bindToChatConversation(conversationID, chatMessageID) {
+        if (this._context !== "chat_attachment") {
+            throw MajikFileError.invalidInput("bindToChatConversation: only chat_attachment files can be bound to a mail");
+        }
+        if (this._chatMessageId || this._conversationId) {
+            throw MajikFileError.invalidInput("bindToChatConversation: this file is already bound to a chat conversation — " +
+                "IDs are immutable once set");
+        }
+        if (!conversationID?.trim()) {
+            throw MajikFileError.invalidInput("bindToChatConversation: conversationID is required");
+        }
+        if (!chatMessageID?.trim()) {
+            throw MajikFileError.invalidInput("bindToChatConversation: chatMessageID is required");
+        }
+        this._conversationId = conversationID;
+        this._chatMessageId = chatMessageID;
+        this._lastUpdate = new Date().toISOString();
+    }
     // ── DECRYPT (static) ──────────────────────────────────────────────────────
     /**
      * Decrypt a .mjkb Blob, Uint8Array, or ArrayBuffer.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@majikah/majik-file",
   "type": "module",
   "description": "Majik File is the core cryptographic engine for secure file handling in the Majikah ecosystem. It provides a post-quantum secure \"MJKB\" format designed for file encryption, multi-recipient key encapsulation, and transparent compression using NIST-standardized algorithms.",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "license": "Apache-2.0",
   "author": "Zelijah",
   "main": "./dist/index.js",