@majikah/majik-message 0.2.1 → 0.2.2

package/dist/core/types.d.ts

@@ -85,6 +85,22 @@ export interface MajikKeyMetadata {
     kdfVersion: number;
     hasMlKem: boolean;
 }
+/**
+ * Explicit integer compression level for Zstd, 1–22.
+ *
+ * Recommended values:
+ *  - 1   → Fastest possible; still meaningfully compresses text/code.
+ *  - 3   → Good speed/ratio balance for real-time paths.
+ *  - 6   → Inflection point — noticeably better ratio, modest speed cost.
+ *  - 9   → Strong compression; gains plateau significantly after this.
+ *  - 15  → High-effort; use only for smaller, latency-insensitive uploads.
+ *  - 19  → Near-maximum ratio without WASM memory pressure.
+ *  - 22  → Archival-grade; not safe for files > 10 MB in WASM environments.
+ *
+ * For production use, prefer a CompressionPreset over a raw integer unless
+ * you have a specific tuning requirement.
+ */
+export type CompressionLevel = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22;
 /**
  * Options for MajikMessage.encryptFile().
  *
@@ -137,6 +153,25 @@ export interface EncryptFileOptions {
     threadMessageId?: string;
     /** Foreign-key association with a thread. */
     threadId?: string;
+    /**
+     * Zstd compression level or preset for this file.
+     *
+     * Accepts either a raw integer (`CompressionLevel` 1–22) or a named
+     * `CompressionPreset` value. The level is always run through
+     * `MajikCompressor.adaptiveLevel()` before use, so it will be silently
+     * clamped downward for large files to avoid WASM out-of-memory errors.
+     *
+     * Defaults to ZSTD_MAX_LEVEL (22) when omitted — existing behaviour.
+     *
+     * @example
+     * // Raw integer
+     * compressionLevel: 9
+     *
+     * // Named preset
+     * compressionLevel: CompressionPreset.GOOD  // 9
+     * compressionLevel: CompressionPreset.BALANCED // 6
+     */
+    compressionLevel?: CompressionLevel | number;
 }
 /**
  * Returned by MajikMessage.encryptFile().

package/dist/majik-message.js

@@ -659,7 +659,7 @@ export class MajikMessage {
      * ```
      */
     async encryptFile(options) {
-        const { data, context, originalName, mimeType, recipients = [], conversationId, isTemporary = false, expiresAt, bypassSizeLimit = false, chatMessageId, threadMessageId, threadId, userId, } = options;
+        const { data, context, originalName, mimeType, recipients = [], conversationId, isTemporary = false, expiresAt, bypassSizeLimit = false, chatMessageId, threadMessageId, threadId, userId, compressionLevel, } = options;
         // ── 1. Resolve sender identity ──────────────────────────────────────────
         // Builds MajikFileIdentity with both public + secret keys from keystore.
         const identity = await this._resolveFileIdentity();
@@ -687,6 +687,7 @@ export class MajikMessage {
             threadMessageId,
             userId: finalUserID,
             threadId: threadId,
+            compressionLevel,
         });
         // ── 4. Package the result ───────────────────────────────────────────────
         return {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@majikah/majik-message",
   "type": "module",
   "description": "Post-quantum end-to-end encryption with ML-KEM-768. Seed phrase–based accounts. Auto-expiring messages. Offline-ready. Exportable encrypted messages. Tamper-proof threads with blockchain-like integrity. Quantum-resistant messaging.",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "Apache-2.0",
   "author": "Zelijah",
   "main": "./dist/index.js",
@@ -81,7 +81,7 @@
   "dependencies": {
     "@bokuweb/zstd-wasm": "^0.0.27",
     "@majikah/majik-envelope": "^0.0.1",
-    "@majikah/majik-file": "^0.0.13",
+    "@majikah/majik-file": "^0.0.14",
     "@majikah/majik-key": "^0.1.10",
     "@noble/hashes": "^2.0.1",
     "@noble/post-quantum": "^0.5.4",