spd-lib 1.3.2 → 1.3.4

package/README.md

@@ -219,17 +219,20 @@ const spd = await SPD.loadFromString(b64, 'MyStr0ng!Passphrase#2024');
 Split a payload into chunks for HTTP uploads or any transport with a body-size limit.
 
 ```ts
-// Sender
-const chunks = await spd.saveDataChunked('MyStr0ng!Passphrase#2024', 512 * 1024); // 512 KB chunks
+// Sender — chunk size is chosen automatically
+const chunks = await spd.saveDataChunked('MyStr0ng!Passphrase#2024');
 // chunks is string[] — send each element, then the manifest (last element) last
 
+// Override chunk size when you have a strict body limit (e.g. 256 KB per request)
+const chunks = await spd.saveDataChunked('MyStr0ng!Passphrase#2024', 256 * 1024);
+
 // Receiver — pass all chunks in order including the manifest
 const spd = await SPD.loadFromChunks(chunks, 'MyStr0ng!Passphrase#2024');
 ```
 
 The last element of the array is always a JSON manifest (`{ totalChunks, chunkSize, totalBytes, version }`). The receiver validates chunk count and byte count before decrypting.
 
-Default chunk size is **1 MB**. Tune down for strict API body limits.
+**Auto chunk size** (when `chunkSize` is omitted): targets ~32 chunks, clamped between 64 KB and 8 MB, rounded to the nearest 64 KB boundary. Pass an explicit `chunkSize` to override (e.g. `256 * 1024` for strict API body limits).
 
 ---
 

package/index.d.mts

@@ -134,6 +134,11 @@ declare class SPD {
      * Splits the payload into base64 chunks for chunked internet transfer.
      * The manifest (last element) records totalChunks/totalBytes for validation.
      * Reassemble with `SPD.loadFromChunks(chunks, passcode)`.
+     *
+     * If `chunkSize` is omitted (or 0), a size is computed automatically:
+     *   - Targets ~32 chunks so the manifest stays small
+     *   - Clamped between 64 KB (min) and 8 MB (max)
+     *   - Rounded up to the nearest 64 KB boundary for alignment
      */
     saveDataChunked(passcode: string, chunkSize?: number): Promise<string[]>;
     static loadFromFile(filePath: string, passcode: string): Promise<SPD>;

package/index.d.ts

@@ -134,6 +134,11 @@ declare class SPD {
      * Splits the payload into base64 chunks for chunked internet transfer.
      * The manifest (last element) records totalChunks/totalBytes for validation.
      * Reassemble with `SPD.loadFromChunks(chunks, passcode)`.
+     *
+     * If `chunkSize` is omitted (or 0), a size is computed automatically:
+     *   - Targets ~32 chunks so the manifest stays small
+     *   - Clamped between 64 KB (min) and 8 MB (max)
+     *   - Rounded up to the nearest 64 KB boundary for alignment
      */
     saveDataChunked(passcode: string, chunkSize?: number): Promise<string[]>;
     static loadFromFile(filePath: string, passcode: string): Promise<SPD>;