@majikah/majik-file 0.0.8 → 0.0.9

package/dist/core/types.d.ts

@@ -53,6 +53,8 @@ export interface MjkbSinglePayload {
     n: string | null;
     /** Original MIME type (e.g. "image/png"). Short key keeps the binary compact. */
     m: string | null;
+    /** Usage context — determines downstream UX and access control. */
+    c: FileContext | null;
 }
 /**
  * JSON payload embedded in a group .mjkb binary.
@@ -66,6 +68,8 @@ export interface MjkbGroupPayload {
     n: string | null;
     /** Original MIME type (e.g. "image/png"). Short key keeps the binary compact. */
     m: string | null;
+    /** Usage context — determines downstream UX and access control. */
+    c: FileContext | null;
 }
 export type MjkbPayload = MjkbSinglePayload | MjkbGroupPayload;
 export declare function isMjkbGroupPayload(p: MjkbPayload): p is MjkbGroupPayload;

package/dist/majik-file.js

@@ -214,7 +214,7 @@ export class MajikFile {
      * @throws MajikFileError on validation or crypto failure
      */
     static async create(options) {
-        const { data, identity, context, recipients = [], originalName = null, mimeType: rawMimeType = null, isTemporary = false, isShared = false, id = generateUUID(), bypassSizeLimit = false, expiresAt = null, chatMessageId = null, threadMessageId = null, conversationId = null, userId } = options;
+        const { data, identity, context, recipients = [], originalName = null, mimeType: rawMimeType = null, isTemporary = false, isShared = false, id = generateUUID(), bypassSizeLimit = false, expiresAt = null, chatMessageId = null, threadMessageId = null, conversationId = null, userId, } = options;
         // ── Input validation ─────────────────────────────────────────────────
         if (!data)
             throw MajikFileError.invalidInput("data is required");
@@ -292,7 +292,9 @@ export class MajikFile {
             // WebP and therefore skipped here — WebP is already codec-compressed.
             // For user_upload and thread_attachment, compressible images (PNG, BMP,
             // TIFF, SVG, etc.) are Zstd-compressed at level 22.
-            const compressible = shouldCompress(resolvedMimeType);
+            const compressible = context === "user_upload" || context === "thread_attachment"
+                ? true
+                : shouldCompress(resolvedMimeType);
             const compressed = compressible
                 ? await MajikCompressor.compress(processedBytes)
                 : processedBytes;
@@ -317,6 +319,7 @@ export class MajikFile {
                     mlKemCipherText: arrayToBase64(mlKemCT),
                     n: originalName ?? null,
                     m: resolvedMimeType ?? null,
+                    c: context ?? null,
                 };
             }
             else {
@@ -349,6 +352,7 @@ export class MajikFile {
                     keys,
                     n: originalName ?? null,
                     m: resolvedMimeType ?? null,
+                    c: context ?? null,
                 };
             }
             // ── 6. Encode .mjkb ───────────────────────────────────────────────
@@ -451,11 +455,17 @@ export class MajikFile {
             else {
                 throw MajikFileError.formatError(".mjkb payload JSON is neither a single nor group payload");
             }
-            const compressed = aesGcmDecrypt(aesKey, iv, ciphertext);
-            if (!compressed) {
+            const decrypted = aesGcmDecrypt(aesKey, iv, ciphertext);
+            if (!decrypted) {
                 throw MajikFileError.decryptionFailed("Decryption failed — wrong key or corrupted .mjkb file");
             }
-            return await MajikCompressor.decompress(compressed);
+            const compressible = payload.c === "user_upload" || payload.c === "thread_attachment"
+                ? true
+                : shouldCompress(payload.m);
+            const returnData = compressible
+                ? await MajikCompressor.decompress(decrypted)
+                : decrypted;
+            return returnData;
         }
         catch (err) {
             if (err instanceof MajikFileError)
@@ -509,11 +519,16 @@ export class MajikFile {
             else {
                 throw MajikFileError.formatError(".mjkb payload JSON is neither a single nor group payload");
             }
-            const compressed = aesGcmDecrypt(aesKey, iv, ciphertext);
-            if (!compressed) {
+            const decrypted = aesGcmDecrypt(aesKey, iv, ciphertext);
+            if (!decrypted) {
                 throw MajikFileError.decryptionFailed("Decryption failed — wrong key or corrupted .mjkb file");
             }
-            const bytes = await MajikCompressor.decompress(compressed);
+            const compressible = payload.c === "user_upload" || payload.c === "thread_attachment"
+                ? true
+                : shouldCompress(payload.m);
+            const bytes = compressible
+                ? await MajikCompressor.decompress(decrypted)
+                : decrypted;
             // Extract original filename and MIME type from the payload.
             // Written at encryption time as short keys n/m to keep the binary compact.
             // Older .mjkb files without these fields return null — callers should fall

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.8",
+  "version": "0.0.9",
   "license": "Apache-2.0",
   "author": "Zelijah",
   "main": "./dist/index.js",