@majikah/majik-message 0.1.7 → 0.1.9

package/README.md

@@ -30,7 +30,6 @@ Also available on [Microsoft Store](https://apps.microsoft.com/detail/9pmjgvzzjs
 Also available on [Google Chrome Web Store](https://chromewebstore.google.com/detail/dhlafmkpgjagkhiokoighjaakajbckck) for free.
 
 
-
 ---
 
 - [Majik Message](#majik-message)
@@ -42,6 +41,7 @@ Also available on [Google Chrome Web Store](https://chromewebstore.google.com/de
     - [Offline Operation](#offline-operation)
     - [Realtime Messaging (Free for Everyone)](#realtime-messaging-free-for-everyone)
     - [Group Messaging](#group-messaging)
+    - [Persistent Message Threads](#persistent-message-threads)
     - [Message Expiration Timer](#message-expiration-timer)
     - [Encrypted Message Export](#encrypted-message-export)
     - [Solo Messages for Personal Storage](#solo-messages-for-personal-storage)
@@ -53,6 +53,7 @@ Also available on [Google Chrome Web Store](https://chromewebstore.google.com/de
       - [For Solo Messages (sender-only):](#for-solo-messages-sender-only)
       - [For Group Messages (2+ recipients):](#for-group-messages-2-recipients)
     - [Receiving and Decrypting a Message](#receiving-and-decrypting-a-message)
+    - [Thread Message Integrity](#thread-message-integrity)
   - [Platform Availability](#platform-availability)
     - [Desktop App](#desktop-app)
     - [Web App](#web-app)
@@ -71,6 +72,11 @@ Also available on [Google Chrome Web Store](https://chromewebstore.google.com/de
       - [Encrypting Messages](#encrypting-messages)
       - [Decrypting Messages](#decrypting-messages)
       - [Managing Accounts](#managing-accounts)
+      - [Threads (Persistent Messaging)](#threads-persistent-messaging)
+        - [Creating a Thread](#creating-a-thread)
+        - [Adding Messages to a Thread](#adding-messages-to-a-thread)
+        - [Managing Threads](#managing-threads)
+        - [Threads Validation:](#threads-validation)
     - [Chrome Extension](#chrome-extension-1)
       - [Encrypting Text on Any Webpage](#encrypting-text-on-any-webpage)
       - [Decrypting Text on Any Webpage](#decrypting-text-on-any-webpage)
@@ -168,6 +174,17 @@ Secure group conversations with up to 25 participants:
 - Same security guarantees as one-on-one messaging
 - Typing indicators and read receipts work in group chats
 
+### Persistent Message Threads
+
+Cryptographic hash-chain history for important conversations:
+
+- Immutable message records with cryptographic integrity
+- Each message cryptographically linked to the previous (blockchain-style)
+- Tamper-resistant conversation history
+- Messages cannot be edited or deleted individually
+- Thread validation tool to verify message integrity
+- Perfect for contracts, formal communications, and audit trails
+
 ### Message Expiration Timer
 
 Set custom expiration times for sensitive conversations. Messages automatically delete after the specified duration, reducing your digital footprint.
@@ -257,6 +274,17 @@ This ensures only authorized recipients can decrypt the message, and the ephemer
 
 If decryption fails (due to tampering or incorrect keys), an authentication error is thrown and the message is rejected.
 
+### Thread Message Integrity
+
+Threads use blockchain-style message chaining:
+
+1. Each message is encrypted using the same end-to-end encryption as regular messages
+2. A cryptographic hash is computed from the message content
+3. This hash is linked to the hash of the previous message in the thread
+4. The chain of hashes creates an immutable, verifiable history
+5. Any tampering breaks the hash chain and is immediately detectable
+6. Downloaded thread logs can be independently verified at any time
+
 ---
 
 ## Platform Availability
@@ -380,6 +408,54 @@ Or share your own invite key:
 - **Export backup**: Hover over account → Export
 - **Import account**: Accounts tab → Import Account button
 
+#### Threads (Persistent Messaging)
+
+##### Creating a Thread
+
+1. Navigate to the **Threads** tab in the top navigation
+2. Click the **plus (+) icon** (New Thread button)
+3. Select participants from your contact directory
+   - All participants must be registered online
+   - Participants cannot be changed after creation
+4. Optionally set a thread topic/subject
+5. Click **Create**
+
+##### Adding Messages to a Thread
+
+1. Open the thread from the Threads tab
+2. Click the **plus (+) icon** in the Thread Viewer
+3. Enter an optional subject and your message content
+4. Click **Send** to add to the thread
+   - Messages are encrypted and permanently stored
+   - Messages cannot be edited or deleted after sending
+
+##### Managing Threads
+
+**Rename Thread Topic:**
+- Any participant can rename the thread at any time
+- Click the **pencil/edit icon** in Thread Viewer
+- Enter new topic and click **Apply Changes**
+
+**Close Thread (Owner Only):**
+- Click the **check icon** in Thread Viewer
+- Choose whether to auto-delete after closing
+- Closed threads cannot accept new messages
+
+**Request Deletion:**
+- Any participant can request thread deletion
+- Requires approval from all participants
+- Owner can delete immediately by closing with auto-delete enabled
+- All participants receive encrypted backup before deletion
+
+**Verify Thread Integrity:**
+- Visit [https://message.majikah.solutions/threads/validate](https://message.majikah.solutions/threads/validate)
+- Import downloaded thread log JSON file
+- System validates blockchain hash chain
+- Tampered messages are detected and flagged
+
+##### Threads Validation: 
+[https://message.majikah.solutions/threads/validate](https://message.majikah.solutions/threads/validate)
+
 ### Chrome Extension
 
 #### Encrypting Text on Any Webpage
@@ -414,6 +490,7 @@ Enable automatic detection and decryption:
 
 Once enabled, any page you load will be automatically scanned for encrypted content.
 
+
 ---
 
 ## Technical Specifications
@@ -452,6 +529,7 @@ All cryptographic operations use the **@stablelib** library suite for consistent
 | Feature            | Status                    |
 | ------------------ | ------------------------- |
 | Text Messages      | ✓ Supported               |
+| Persistent Threads | ✓ Blockchain-style-hashing    |
 | Group Chats        | ✓ Up to 25 participants   |
 | Typing Indicators  | ✓ Supported               |
 | Read Receipts      | ✓ Supported               |
@@ -468,6 +546,8 @@ All cryptographic operations use the **@stablelib** library suite for consistent
 - **Identity privacy**: No phone numbers or email addresses required
 - **Private keys**: Never transmitted; encrypted at rest with PBKDF2-derived passphrase
 - **Forward secrecy**: Ephemeral keys ensure past messages remain secure even if current keys are compromised
+- **Message integrity**: Thread messages use blockchain-style chaining to detect tampering
+- **Audit trails**: Downloadable, verifiable thread histories for compliance and records
 
 ### What Users Must Protect
 

package/dist/core/database/thread/majik-message-thread.d.ts

@@ -89,7 +89,7 @@ export declare class MajikMessageThread {
     private constructor();
     get id(): MajikMessageThreadID;
     get userID(): MajikUserID;
-    get owner(): MajikMessagePublicKey;
+    get owner(): MajikMessageAccountID;
     get metadata(): Readonly<ThreadMetadata>;
     get timestamp(): Date;
     get participants(): readonly MajikMessagePublicKey[];
@@ -144,9 +144,11 @@ export declare class MajikMessageThread {
     updateMetadata(metadata: Partial<ThreadMetadata>): this;
     toJSON(): MajikMessageThreadJSON;
     static fromJSON(json: MajikMessageThreadJSON | string): MajikMessageThread;
-    isOwner(publicKey: MajikMessagePublicKey): boolean;
+    isOwner(accountID: MajikMessageAccountID): boolean;
     isParticipant(publicKey: MajikMessagePublicKey): boolean;
     toString(): string;
+    isClosed(): boolean;
+    canBeClosed(): boolean;
     /**
      * Deduplicates and sorts participants to ensure consistent ordering
      */

package/dist/core/database/thread/majik-message-thread.js

@@ -506,8 +506,8 @@ export class MajikMessageThread {
         }
     }
     // ==================== Utility Methods ====================
-    isOwner(publicKey) {
-        return this._owner === publicKey;
+    isOwner(accountID) {
+        return this._owner === accountID;
     }
     isParticipant(publicKey) {
         return this._participants.includes(publicKey);
@@ -515,6 +515,12 @@ export class MajikMessageThread {
     toString() {
         return JSON.stringify(this.toJSON(), null, 2);
     }
+    isClosed() {
+        return this._status === ThreadStatus.CLOSED;
+    }
+    canBeClosed() {
+        return this._status === ThreadStatus.ONGOING;
+    }
     /**
      * Deduplicates and sorts participants to ensure consistent ordering
      */
@@ -542,10 +548,6 @@ export class MajikMessageThread {
                 !Number.isInteger(messageCount)) {
                 throw new ValidationError("messageCount must be a non-negative integer");
             }
-            // Cannot finalize a thread marked for deletion
-            if (this._status === ThreadStatus.MARKED_FOR_DELETION) {
-                throw new OperationNotAllowedError("Cannot export final stats for a thread marked for deletion");
-            }
             // Merge tags
             const existingTags = this._metadata.tags || [];
             const mergedTags = additionalTags

package/package.json

@@ -2,7 +2,7 @@
   "name": "@majikah/majik-message",
   "type": "module",
   "description": "Encrypt and decrypt messages on any website or platform. Secure chats with keypairs and seed-based accounts. Open source.",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "license": "Apache-2.0",
   "author": "Zelijah",
   "main": "./dist/index.js",