text-compress 2.0.0

package/dist/cli/detect.js

@@ -0,0 +1,78 @@
+/**
+ * @module cli/detect
+ *
+ * Detect whether input is a valid compressed payload for auto-routing.
+ */
+import { brotliDecompressSync } from "node:zlib";
+import { decryptBuffer, isEncrypted } from "../crypto/password.js";
+import { decodeBuffer } from "../encoding/index.js";
+import { decompressPayload, TAG_FOLDER, TAG_TEXT } from "../payload/tags.js";
+/** True when an error means the payload is locked, not that it is plain text. */
+export function isPasswordRelatedError(err) {
+    const message = err.message ?? "";
+    return message.includes("password-protected") || message === "Invalid password.";
+}
+/**
+ * Return whether trimmed encoded text is a valid compressed payload.
+ *
+ * When `-e` is omitted, both Base64 and Z85 are tried. Encrypted payloads
+ * without a password return `password-required` instead of `not-compressed`.
+ */
+export function detectCompressedPayload(encoded, encoding, password) {
+    const trimmed = encoded.trim();
+    if (trimmed.length === 0)
+        return "not-compressed";
+    const encodings = encoding ? [encoding] : [64, 85];
+    let sawEncryptedWithoutPassword = false;
+    for (const enc of encodings) {
+        let decoded;
+        try {
+            decoded = decodeBuffer(trimmed, enc);
+        }
+        catch {
+            continue;
+        }
+        if (isEncrypted(decoded)) {
+            if (!password) {
+                sawEncryptedWithoutPassword = true;
+                continue;
+            }
+            decoded = decryptBuffer(decoded, password);
+        }
+        try {
+            const raw = brotliDecompressSync(decoded);
+            const tag = raw[0];
+            if (tag === TAG_TEXT || tag === TAG_FOLDER) {
+                return "compressed";
+            }
+        }
+        catch { }
+    }
+    if (sawEncryptedWithoutPassword)
+        return "password-required";
+    return "not-compressed";
+}
+/**
+ * Resolve the best encoding for decompress after auto-detection.
+ *
+ * When `-e` is set, use it. Otherwise return the encoding that validates.
+ */
+export function resolveDetectedEncoding(encoded, encoding, password) {
+    if (encoding)
+        return encoding;
+    const trimmed = encoded.trim();
+    for (const enc of [64, 85]) {
+        if (detectCompressedPayload(trimmed, enc, password) === "compressed") {
+            return enc;
+        }
+    }
+    return 64;
+}
+/** Validate using the full decompress path (used when forcing decompress). */
+export function assertDecompressible(encoded, encoding, password) {
+    const { tag } = decompressPayload(encoded.trim(), encoding, password);
+    if (tag !== TAG_TEXT && tag !== TAG_FOLDER) {
+        throw new Error(`Corrupt or unrecognized payload (tag 0x${tag.toString(16)}).`);
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/cli/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/cli/detect.ts"],"names":[],"mappings":"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"}

package/dist/cli/main.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module cli/main
+ *
+ * CLI entry logic — parses argv and auto-routes to compress or decompress.
+ */
+/** Main CLI dispatcher. */
+export declare function main(): void;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyCH,2BAA2B;AAC3B,wBAAgB,IAAI,SAgCnB"}

package/dist/cli/main.js

@@ -0,0 +1,74 @@
+/**
+ * @module cli/main
+ *
+ * CLI entry logic — parses argv and auto-routes to compress or decompress.
+ */
+import { readSplitInput } from "../split/parts.js";
+import { parseArgs, resolveEncodingOptional, resolveInputArgs } from "./args.js";
+import { runCompress } from "./commands/compress.js";
+import { runDecompress } from "./commands/decompress.js";
+import { detectCompressedPayload } from "./detect.js";
+import { printUsage } from "./usage.js";
+function wantsHelp(argv) {
+    return argv.length === 0 || argv.includes("-h") || argv.includes("--help");
+}
+/** Strip an optional legacy leading compress/decompress command. */
+function normalizeArgv(argv) {
+    const [first, ...rest] = argv;
+    if (first === "compress" || first === "c")
+        return { argv: rest, forcedMode: "compress" };
+    if (first === "decompress" || first === "d")
+        return { argv: rest, forcedMode: "decompress" };
+    return { argv };
+}
+function readEncodedInput(args) {
+    if (args.file)
+        return readSplitInput(args.file).content;
+    if (args.text !== undefined)
+        return args.text;
+    throw new Error("No input provided. Pass a path, or use -t <text>.");
+}
+function resolveCliMode(args) {
+    if (args.mode === "compress")
+        return "compress";
+    if (args.mode === "decompress")
+        return "decompress";
+    if (args.dir)
+        return "compress";
+    const encoded = readEncodedInput(args);
+    const detection = detectCompressedPayload(encoded, resolveEncodingOptional(args), args.password);
+    if (detection === "password-required") {
+        throw new Error("This payload is password-protected. Pass -p/--password to decompress.");
+    }
+    if (detection === "compressed")
+        return "decompress";
+    return "compress";
+}
+/** Main CLI dispatcher. */
+export function main() {
+    let argv = process.argv.slice(2);
+    if (wantsHelp(argv)) {
+        printUsage();
+        process.exit(argv.length === 0 ? 1 : 0);
+    }
+    const legacy = normalizeArgv(argv);
+    argv = legacy.argv;
+    const args = parseArgs(argv);
+    if (legacy.forcedMode && !args.mode) {
+        args.mode = legacy.forcedMode;
+    }
+    const run = async () => {
+        resolveInputArgs(args, args.mode === "decompress" ? "decompress" : "compress");
+        const mode = resolveCliMode(args);
+        if (mode === "decompress") {
+            runDecompress(args);
+            return;
+        }
+        await runCompress(args);
+    };
+    run().catch((err) => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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"}

package/dist/cli/output.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module cli/output
+ *
+ * Write compressed output to disk, optionally split into numbered parts.
+ */
+/**
+ * Write an encoded string to one file or multiple split part files.
+ */
+export declare function writeCompressedOutput(encoded: string, outputPath: string, explicitSplit?: number): {
+    paths: string[];
+    splitChunkSize?: number;
+};
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAe9C"}

package/dist/cli/output.js

@@ -0,0 +1,26 @@
+/**
+ * @module cli/output
+ *
+ * Write compressed output to disk, optionally split into numbered parts.
+ */
+import { writeFileSync } from "node:fs";
+import { formatSplitOutputPath, resolveSplitChunkSize, splitString, wrapSplitChunk, } from "../split/parts.js";
+/**
+ * Write an encoded string to one file or multiple split part files.
+ */
+export function writeCompressedOutput(encoded, outputPath, explicitSplit) {
+    const splitChunkSize = resolveSplitChunkSize(encoded.length, explicitSplit);
+    if (splitChunkSize === undefined) {
+        writeFileSync(outputPath, encoded, "utf-8");
+        return { paths: [outputPath] };
+    }
+    const chunks = splitString(encoded, splitChunkSize);
+    const totalParts = chunks.length;
+    const paths = chunks.map((chunk, index) => {
+        const partPath = formatSplitOutputPath(outputPath, index + 1, totalParts);
+        writeFileSync(partPath, wrapSplitChunk(index + 1, totalParts, chunk), "utf-8");
+        return partPath;
+    });
+    return { paths, splitChunkSize };
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAA;AAE1B;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,UAAkB,EAClB,aAAsB;IAEtB,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC3E,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3C,OAAO,EAAE,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAA;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,CAAC,CAAA;QACzE,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,GAAG,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;QAC9E,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;AAClC,CAAC"}

package/dist/cli/paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module cli/paths
+ *
+ * Output path resolution for CLI commands.
+ */
+import type { Args } from "./args.js";
+/**
+ * Derive an output path from input args or use an explicit `-o` value.
+ *
+ * Prevents accidentally overwriting the input file when defaults collide.
+ */
+export declare function resolveOutputPath(args: Args, fallbackName: string, suffix: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe1F"}

package/dist/cli/paths.js

@@ -0,0 +1,24 @@
+/**
+ * @module cli/paths
+ *
+ * Output path resolution for CLI commands.
+ */
+import { resolve } from "node:path";
+/**
+ * Derive an output path from input args or use an explicit `-o` value.
+ *
+ * Prevents accidentally overwriting the input file when defaults collide.
+ */
+export function resolveOutputPath(args, fallbackName, suffix) {
+    if (args.output)
+        return args.output;
+    const inputPath = args.dir ?? args.file;
+    const defaultPath = inputPath
+        ? inputPath.replace(/\.[^/.]+$/, "").replace(/[/\\]+$/, "") + suffix
+        : fallbackName;
+    if (inputPath && resolve(defaultPath) === resolve(inputPath)) {
+        throw new Error(`Default output path "${defaultPath}" would overwrite the input. Specify -o <output path> explicitly.`);
+    }
+    return defaultPath;
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU,EAAE,YAAoB,EAAE,MAAc;IAChF,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,MAAM,CAAA;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAA;IACvC,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,MAAM;QACpE,CAAC,CAAC,YAAY,CAAA;IAEhB,IAAI,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,wBAAwB,WAAW,mEAAmE,CACvG,CAAA;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/cli/usage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module cli/usage
+ *
+ * Help text for the `text-compress` CLI.
+ */
+/** Print usage guide to stdout. */
+export declare function printUsage(): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,wBAAgB,UAAU,SAiEzB"}

package/dist/cli/usage.js

@@ -0,0 +1,73 @@
+/**
+ * @module cli/usage
+ *
+ * Help text for the `text-compress` CLI.
+ */
+/** Print usage guide to stdout. */
+export function printUsage() {
+    console.log(`
+text-compress - brotli (max quality) compress/decompress with base64 or base85 output
+
+Usage:
+  text-compress [path|options]
+  npx text-compress <path> [options]
+
+Auto-detect:
+  Pass a file or folder path with no subcommand. Plain files and folders are
+  compressed; valid compressed payloads are decompressed automatically.
+  Folders are always compressed.
+
+Options:
+  <path>                  Input path (auto-detects file vs folder)
+  -t, --text <string>     Input given directly as a string
+  -f, --file <path>       Input file (optional; same as passing <path>)
+  -d, --dir <path>        Input folder (optional; same as passing <path>)
+  -C, --compress          Always compress (even if input looks compressed)
+  -D, --decompress        Always decompress
+  -o, --output <path>     Output path (optional, see defaults below)
+  -s, --split <chars>     Split compressed output into multiple files, each
+                           at most this many characters (compress only).
+                           If omitted, auto-splits at 30,000 characters when
+                           the output is larger. Parts are named by inserting
+                           .NNN before the extension, e.g. output.001.txt
+  -e, --encoding <64|85>  Text encoding for the compressed output (default: 64)
+                             64: standard base64 [A-Za-z0-9+/=] — safe to
+                                 paste literally anywhere (chat, email, etc.)
+                             85: Z85 base85 — ~8% smaller, but uses extra
+                                 punctuation; only paste it somewhere that
+                                 preserves text verbatim (e.g. a code block)
+  -p, --password <string>  Password-protect on compress, or unlock on decompress
+  -h, --help               Show this usage guide
+
+Split output (decompress):
+  Pass any one sibling file. All files sharing the same basename prefix
+  (segment before the first ".") are scanned; invalid siblings are skipped.
+  Part order comes from embedded headers, not filenames.
+
+Defaults:
+  If -o is omitted, the output path is derived from the input's name:
+    compress (file/text): <input>.txt
+    compress (folder):    <folder-name>.txt
+    decompress (text):    <input>.de.txt
+    decompress (folder):  <input>.de   (recreated as a directory)
+
+Examples:
+  text-compress notes.md
+  text-compress notes.md -p "my secret"
+  text-compress ./my-project
+  text-compress notes.md -e 85
+  text-compress notes.md -s 4000
+  text-compress output.txt
+  text-compress output.txt -p "my secret"
+  text-compress output.01.txt
+  text-compress -t "some text" -o output.txt
+  text-compress --compress notes.txt
+  npx text-compress ./somefile.md -p "hello-world"
+
+Every run prints analytics (encoding, size, ratio, time taken) after
+writing the output.
+
+v1 CLI (@startdoing/tc) remains on npm at 1.0.4. v2 is published as text-compress.
+`);
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Db,CAAC,CAAA;AACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * CLI binary entry point (`text-compress` command).
+ *
+ * This thin file exists because `package.json` points `"bin"."text-compress"` at
+ * `dist/cli.js`. All logic lives under `src/cli/`.
+ */
+import { main } from "./cli/main.js";
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEpC,IAAI,EAAE,CAAA"}

package/dist/compression/brotli.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @module compression/brotli
+ *
+ * Brotli compression wrappers around Node.js `zlib`.
+ *
+ * ## Why Brotli?
+ *
+ * Brotli (RFC 7932) is a modern LZ77 + Huffman + context-modelling codec
+ * developed by Google. For text and source code it typically beats gzip and
+ * deflate by 15–25 % at comparable speed. We always use maximum quality
+ * because this tool optimises for smallest output, not speed.
+ *
+ * ## Parameters
+ *
+ * | Parameter          | Value              | Effect                          |
+ * |--------------------|--------------------|---------------------------------|
+ * | `QUALITY`          | `BROTLI_MAX_QUALITY` (11) | Best ratio, slowest      |
+ * | `LGWIN`            | `BROTLI_MAX_WINDOW_BITS`   | Largest LZ77 window      |
+ * | `SIZE_HINT`        | input byte length  | Helps encoder pre-allocate      |
+ *
+ * ## Sync vs streaming
+ *
+ * - `brotliCompress` — in-memory, used by the library API for text and
+ *   small folder archives loaded entirely into RAM.
+ * - `createMaxQualityBrotliCompress` — streaming transform, used when
+ *   compressing large folder archives without loading them into memory.
+ *
+ * @see https://github.com/google/brotli — reference implementation
+ */
+/**
+ * Compress a buffer synchronously (in-memory path).
+ *
+ * Suitable for text payloads and folder archives that fit in RAM.
+ */
+export declare function brotliCompress(input: Buffer): Buffer;
+/**
+ * Create a streaming Brotli compressor transform.
+ *
+ * Used by the folder streaming pipeline: archive bytes flow through this
+ * transform into a file on disk without ever being fully buffered.
+ */
+export declare function createMaxQualityBrotliCompress(sizeHint: number): import("node:zlib").BrotliCompress;
+//# sourceMappingURL=brotli.d.ts.map

package/dist/compression/brotli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brotli.d.ts","sourceRoot":"","sources":["../../src/compression/brotli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAaH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,sCAE9D"}

package/dist/compression/brotli.js

@@ -0,0 +1,56 @@
+/**
+ * @module compression/brotli
+ *
+ * Brotli compression wrappers around Node.js `zlib`.
+ *
+ * ## Why Brotli?
+ *
+ * Brotli (RFC 7932) is a modern LZ77 + Huffman + context-modelling codec
+ * developed by Google. For text and source code it typically beats gzip and
+ * deflate by 15–25 % at comparable speed. We always use maximum quality
+ * because this tool optimises for smallest output, not speed.
+ *
+ * ## Parameters
+ *
+ * | Parameter          | Value              | Effect                          |
+ * |--------------------|--------------------|---------------------------------|
+ * | `QUALITY`          | `BROTLI_MAX_QUALITY` (11) | Best ratio, slowest      |
+ * | `LGWIN`            | `BROTLI_MAX_WINDOW_BITS`   | Largest LZ77 window      |
+ * | `SIZE_HINT`        | input byte length  | Helps encoder pre-allocate      |
+ *
+ * ## Sync vs streaming
+ *
+ * - `brotliCompress` — in-memory, used by the library API for text and
+ *   small folder archives loaded entirely into RAM.
+ * - `createMaxQualityBrotliCompress` — streaming transform, used when
+ *   compressing large folder archives without loading them into memory.
+ *
+ * @see https://github.com/google/brotli — reference implementation
+ */
+import { brotliCompressSync, createBrotliCompress, constants as zlibConstants } from "node:zlib";
+/** Shared Brotli parameters for maximum compression ratio. */
+function maxQualityParams(sizeHint) {
+    return {
+        [zlibConstants.BROTLI_PARAM_QUALITY]: zlibConstants.BROTLI_MAX_QUALITY,
+        [zlibConstants.BROTLI_PARAM_LGWIN]: zlibConstants.BROTLI_MAX_WINDOW_BITS,
+        [zlibConstants.BROTLI_PARAM_SIZE_HINT]: sizeHint,
+    };
+}
+/**
+ * Compress a buffer synchronously (in-memory path).
+ *
+ * Suitable for text payloads and folder archives that fit in RAM.
+ */
+export function brotliCompress(input) {
+    return brotliCompressSync(input, { params: maxQualityParams(input.length) });
+}
+/**
+ * Create a streaming Brotli compressor transform.
+ *
+ * Used by the folder streaming pipeline: archive bytes flow through this
+ * transform into a file on disk without ever being fully buffered.
+ */
+export function createMaxQualityBrotliCompress(sizeHint) {
+    return createBrotliCompress({ params: maxQualityParams(sizeHint) });
+}
+//# sourceMappingURL=brotli.js.map

package/dist/compression/brotli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brotli.js","sourceRoot":"","sources":["../../src/compression/brotli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAA;AAEhG,8DAA8D;AAC9D,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO;QACL,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC,kBAAkB;QACtE,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC,sBAAsB;QACxE,CAAC,aAAa,CAAC,sBAAsB,CAAC,EAAE,QAAQ;KACjD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,kBAAkB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAAgB;IAC7D,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC"}

package/dist/crypto/password.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module crypto/password
+ *
+ * Optional password protection for compressed payloads.
+ *
+ * When a password is set at compress time, the Brotli-compressed bytes are
+ * encrypted with AES-256-GCM before Base64/Z85 encoding. The wire format is:
+ *
+ * ```
+ *   [MAGIC: 4][salt: 16][iv: 12][authTag: 16][ciphertext…]
+ * ```
+ *
+ * Unencrypted payloads omit the magic prefix and remain compatible with
+ * earlier versions of the tool.
+ */
+/** True when decoded binary data starts with the password-protection magic. */
+export declare function isEncrypted(data: Buffer): boolean;
+/** Encrypt Brotli-compressed bytes with a user password. */
+export declare function encryptBuffer(plaintext: Buffer, password: string): Buffer;
+/** Decrypt password-protected bytes back to the original Brotli blob. */
+export declare function decryptBuffer(data: Buffer, password: string): Buffer;
+//# sourceMappingURL=password.d.ts.map

package/dist/crypto/password.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"password.d.ts","sourceRoot":"","sources":["../../src/crypto/password.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAMD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBpE"}

package/dist/crypto/password.js

@@ -0,0 +1,62 @@
+/**
+ * @module crypto/password
+ *
+ * Optional password protection for compressed payloads.
+ *
+ * When a password is set at compress time, the Brotli-compressed bytes are
+ * encrypted with AES-256-GCM before Base64/Z85 encoding. The wire format is:
+ *
+ * ```
+ *   [MAGIC: 4][salt: 16][iv: 12][authTag: 16][ciphertext…]
+ * ```
+ *
+ * Unencrypted payloads omit the magic prefix and remain compatible with
+ * earlier versions of the tool.
+ */
+import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from "node:crypto";
+const MAGIC = Buffer.from("TCP\x01");
+const SALT_LENGTH = 16;
+const IV_LENGTH = 12;
+const AUTH_TAG_LENGTH = 16;
+const KEY_LENGTH = 32;
+const SCRYPT_N = 16384;
+const SCRYPT_R = 8;
+const SCRYPT_P = 1;
+/** True when decoded binary data starts with the password-protection magic. */
+export function isEncrypted(data) {
+    return data.length >= MAGIC.length && data.subarray(0, MAGIC.length).equals(MAGIC);
+}
+function deriveKey(password, salt) {
+    return scryptSync(password, salt, KEY_LENGTH, { N: SCRYPT_N, r: SCRYPT_R, p: SCRYPT_P });
+}
+/** Encrypt Brotli-compressed bytes with a user password. */
+export function encryptBuffer(plaintext, password) {
+    const salt = randomBytes(SALT_LENGTH);
+    const iv = randomBytes(IV_LENGTH);
+    const key = deriveKey(password, salt);
+    const cipher = createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    return Buffer.concat([MAGIC, salt, iv, authTag, encrypted]);
+}
+/** Decrypt password-protected bytes back to the original Brotli blob. */
+export function decryptBuffer(data, password) {
+    if (!isEncrypted(data)) {
+        throw new Error("This payload is not password-protected.");
+    }
+    const offset = MAGIC.length;
+    const salt = data.subarray(offset, offset + SALT_LENGTH);
+    const iv = data.subarray(offset + SALT_LENGTH, offset + SALT_LENGTH + IV_LENGTH);
+    const authTag = data.subarray(offset + SALT_LENGTH + IV_LENGTH, offset + SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
+    const ciphertext = data.subarray(offset + SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
+    const key = deriveKey(password, salt);
+    const decipher = createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(authTag);
+    try {
+        return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    }
+    catch {
+        throw new Error("Invalid password.");
+    }
+}
+//# sourceMappingURL=password.js.map

package/dist/crypto/password.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"password.js","sourceRoot":"","sources":["../../src/crypto/password.ts"],"names":[],"mappings":"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"}

package/dist/encoding/base64.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module encoding/base64
+ *
+ * Thin wrapper around Node.js built-in Base64 encoding.
+ *
+ * Base64 maps every 3 bytes → 4 ASCII characters using a 64-character
+ * alphabet (`A–Z a–z 0–9 + /`) plus `=` padding. It expands data by
+ * ~33 % but is universally supported and paste-safe.
+ *
+ * We delegate to `Buffer.toString("base64")` rather than reimplementing
+ * the algorithm — Node's implementation is well-tested and SIMD-optimised.
+ */
+/** Encode raw bytes to a standard Base64 string. */
+export declare function encodeBase64(buffer: Buffer): string;
+/** Decode a Base64 string back to raw bytes. */
+export declare function decodeBase64(str: string): Buffer;
+//# sourceMappingURL=base64.d.ts.map

package/dist/encoding/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/encoding/base64.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/encoding/base64.js

@@ -0,0 +1,21 @@
+/**
+ * @module encoding/base64
+ *
+ * Thin wrapper around Node.js built-in Base64 encoding.
+ *
+ * Base64 maps every 3 bytes → 4 ASCII characters using a 64-character
+ * alphabet (`A–Z a–z 0–9 + /`) plus `=` padding. It expands data by
+ * ~33 % but is universally supported and paste-safe.
+ *
+ * We delegate to `Buffer.toString("base64")` rather than reimplementing
+ * the algorithm — Node's implementation is well-tested and SIMD-optimised.
+ */
+/** Encode raw bytes to a standard Base64 string. */
+export function encodeBase64(buffer) {
+    return buffer.toString("base64");
+}
+/** Decode a Base64 string back to raw bytes. */
+export function decodeBase64(str) {
+    return Buffer.from(str, "base64");
+}
+//# sourceMappingURL=base64.js.map

package/dist/encoding/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/encoding/base64.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC"}