@elaraai/east-node-io 0.0.1-beta.0 → 0.0.1-beta.2

package/dist/compression/index.js

@@ -0,0 +1,289 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Compression platform functions for East Node IO.
+ *
+ * Provides functions for compressing and decompressing data using various
+ * formats like gzip, zip, and tar.
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const compressText = East.function([StringType], BlobType, ($, text) => {
+ *     const data = $.let(text.encodeUtf8());
+ *     const options = $.let({
+ *         level: { tag: "some", value: 9n },
+ *     });
+ *     const compressed = $.let(Compression.Gzip.compress(data, options));
+ *     return $.return(compressed);
+ * });
+ *
+ * const compiled = East.compileAsync(compressText.toIR(), Compression.Gzip.Implementation);
+ * await compiled("Hello, World!");  // Compressed gzip blob
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Export types
+export * from "./types.js";
+// Export platform functions and implementation
+export { gzip_compress, gzip_decompress, GzipImpl } from "./gzip.js";
+export { zip_compress, zip_decompress, ZipImpl } from "./zip.js";
+export { tar_create, tar_extract, TarImpl } from "./tar.js";
+// Import for grouped exports
+import { gzip_compress, gzip_decompress, GzipImpl } from "./gzip.js";
+import { zip_compress, zip_decompress, ZipImpl } from "./zip.js";
+import { tar_create, tar_extract, TarImpl } from "./tar.js";
+import { GzipLevelType, GzipOptionsType, ZipLevelType, ZipOptionsType, ZipEntryType, ZipEntriesType, ZipExtractedType, TarEntryType, TarEntriesType, TarExtractedType, } from "./types.js";
+/**
+ * Compression platform functions grouped by compression type.
+ *
+ * Provides organized access to compression-specific operations for compressing
+ * and decompressing data in East programs.
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const compressAndDecompress = East.function([StringType], StringType, ($, text) => {
+ *     const data = $.let(text.encodeUtf8());
+ *     const options = $.let({
+ *         level: { tag: "some", value: 9n },
+ *     });
+ *
+ *     const compressed = $.let(Compression.Gzip.compress(data, options));
+ *     const decompressed = $.let(Compression.Gzip.decompress(compressed));
+ *     const result = $.let(decompressed.decodeUtf8());
+ *     return $.return(result);
+ * });
+ *
+ * const compiled = East.compileAsync(compressAndDecompress.toIR(), Compression.Gzip.Implementation);
+ * await compiled("Hello, World!");  // "Hello, World!"
+ * ```
+ */
+export const Compression = {
+    /**
+     * Gzip compression operations.
+     *
+     * Provides functions for compressing and decompressing data using gzip (RFC 1952).
+     */
+    Gzip: {
+        /**
+         * Compresses data using gzip compression.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const compressText = East.function([StringType], BlobType, ($, text) => {
+         *     const data = $.let(text.encodeUtf8());
+         *     const options = $.let({
+         *         level: { tag: "some", value: 9n },
+         *     });
+         *     const compressed = $.let(Compression.Gzip.compress(data, options));
+         *     return $.return(compressed);
+         * });
+         *
+         * const compiled = East.compileAsync(compressText.toIR(), Compression.Gzip.Implementation);
+         * await compiled("Hello, World!");
+         * ```
+         */
+        compress: gzip_compress,
+        /**
+         * Decompresses gzip-compressed data.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const decompressText = East.function([BlobType], StringType, ($, compressed) => {
+         *     const decompressed = $.let(Compression.Gzip.decompress(compressed));
+         *     const text = $.let(decompressed.decodeUtf8());
+         *     return $.return(text);
+         * });
+         *
+         * const compiled = East.compileAsync(decompressText.toIR(), Compression.Gzip.Implementation);
+         * await compiled(compressedBlob);
+         * ```
+         */
+        decompress: gzip_decompress,
+        /**
+         * Node.js implementation of Gzip platform functions.
+         *
+         * Pass this to {@link East.compileAsync} to enable gzip operations.
+         */
+        Implementation: GzipImpl,
+        /**
+         * Type definitions for Gzip operations.
+         */
+        Types: {
+            /**
+             * Compression level (0-9).
+             */
+            Level: GzipLevelType,
+            /**
+             * Gzip compression options.
+             */
+            Options: GzipOptionsType,
+        },
+    },
+    /**
+     * ZIP archive operations.
+     *
+     * Provides functions for creating and extracting ZIP archives with multiple files.
+     */
+    Zip: {
+        /**
+         * Creates a ZIP archive from a list of files.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const createZip = East.function([StringType, StringType], BlobType, ($, file1, file2) => {
+         *     const entries = $.let([
+         *         { name: "file1.txt", data: file1.encodeUtf8() },
+         *         { name: "file2.txt", data: file2.encodeUtf8() },
+         *     ]);
+         *     const options = $.let({
+         *         level: { tag: "some", value: 9n },
+         *     });
+         *     const zipBlob = $.let(Compression.Zip.compress(entries, options));
+         *     return $.return(zipBlob);
+         * });
+         *
+         * const compiled = East.compileAsync(createZip.toIR(), Compression.Zip.Implementation);
+         * await compiled("Hello", "World");
+         * ```
+         */
+        compress: zip_compress,
+        /**
+         * Extracts files from a ZIP archive.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, DictType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const extractZip = East.function([BlobType], DictType(StringType, BlobType), ($, zipBlob) => {
+         *     const files = $.let(Compression.Zip.decompress(zipBlob));
+         *     return $.return(files);
+         * });
+         *
+         * const compiled = East.compileAsync(extractZip.toIR(), Compression.Zip.Implementation);
+         * await compiled(zipBlob);
+         * ```
+         */
+        decompress: zip_decompress,
+        /**
+         * Node.js implementation of ZIP platform functions.
+         *
+         * Pass this to {@link East.compileAsync} to enable ZIP operations.
+         */
+        Implementation: ZipImpl,
+        /**
+         * Type definitions for ZIP operations.
+         */
+        Types: {
+            /**
+             * Compression level (0-9).
+             */
+            Level: ZipLevelType,
+            /**
+             * ZIP compression options.
+             */
+            Options: ZipOptionsType,
+            /**
+             * Entry in a ZIP archive.
+             */
+            Entry: ZipEntryType,
+            /**
+             * List of entries for creating a ZIP archive.
+             */
+            Entries: ZipEntriesType,
+            /**
+             * Extracted files from a ZIP archive.
+             */
+            Extracted: ZipExtractedType,
+        },
+    },
+    /**
+     * TAR archive operations.
+     *
+     * Provides functions for creating and extracting TAR archives (without compression).
+     */
+    Tar: {
+        /**
+         * Creates a TAR archive from a list of files.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const createTar = East.function([StringType, StringType], BlobType, ($, file1, file2) => {
+         *     const entries = $.let([
+         *         { name: "file1.txt", data: file1.encodeUtf8() },
+         *         { name: "file2.txt", data: file2.encodeUtf8() },
+         *     ]);
+         *     const tarBlob = $.let(Compression.Tar.create(entries));
+         *     return $.return(tarBlob);
+         * });
+         *
+         * const compiled = East.compileAsync(createTar.toIR(), Compression.Tar.Implementation);
+         * await compiled("Hello", "World");
+         * ```
+         */
+        create: tar_create,
+        /**
+         * Extracts files from a TAR archive.
+         *
+         * @example
+         * ```ts
+         * import { East, BlobType, DictType, StringType } from "@elaraai/east";
+         * import { Compression } from "@elaraai/east-node-io";
+         *
+         * const extractTar = East.function([BlobType], DictType(StringType, BlobType), ($, tarBlob) => {
+         *     const files = $.let(Compression.Tar.extract(tarBlob));
+         *     return $.return(files);
+         * });
+         *
+         * const compiled = East.compileAsync(extractTar.toIR(), Compression.Tar.Implementation);
+         * await compiled(tarBlob);
+         * ```
+         */
+        extract: tar_extract,
+        /**
+         * Node.js implementation of TAR platform functions.
+         *
+         * Pass this to {@link East.compileAsync} to enable TAR operations.
+         */
+        Implementation: TarImpl,
+        /**
+         * Type definitions for TAR operations.
+         */
+        Types: {
+            /**
+             * Entry in a TAR archive.
+             */
+            Entry: TarEntryType,
+            /**
+             * List of entries for creating a TAR archive.
+             */
+            Entries: TarEntriesType,
+            /**
+             * Extracted files from a TAR archive.
+             */
+            Extracted: TarExtractedType,
+        },
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/compression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compression/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAE3B,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE5D,6BAA6B;AAC7B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACH,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,GACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB;;;;OAIG;IACH,IAAI,EAAE;QACF;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,QAAQ,EAAE,aAAa;QAEvB;;;;;;;;;;;;;;;;;WAiBG;QACH,UAAU,EAAE,eAAe;QAE3B;;;;WAIG;QACH,cAAc,EAAE,QAAQ;QAExB;;WAEG;QACH,KAAK,EAAE;YACH;;eAEG;YACH,KAAK,EAAE,aAAa;YAEpB;;eAEG;YACH,OAAO,EAAE,eAAe;SAC3B;KACJ;IAED;;;;OAIG;IACH,GAAG,EAAE;QACD;;;;;;;;;;;;;;;;;;;;;;;WAuBG;QACH,QAAQ,EAAE,YAAY;QAEtB;;;;;;;;;;;;;;;;WAgBG;QACH,UAAU,EAAE,cAAc;QAE1B;;;;WAIG;QACH,cAAc,EAAE,OAAO;QAEvB;;WAEG;QACH,KAAK,EAAE;YACH;;eAEG;YACH,KAAK,EAAE,YAAY;YAEnB;;eAEG;YACH,OAAO,EAAE,cAAc;YAEvB;;eAEG;YACH,KAAK,EAAE,YAAY;YAEnB;;eAEG;YACH,OAAO,EAAE,cAAc;YAEvB;;eAEG;YACH,SAAS,EAAE,gBAAgB;SAC9B;KACJ;IAED;;;;OAIG;IACH,GAAG,EAAE;QACD;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,MAAM,EAAE,UAAU;QAElB;;;;;;;;;;;;;;;;WAgBG;QACH,OAAO,EAAE,WAAW;QAEpB;;;;WAIG;QACH,cAAc,EAAE,OAAO;QAEvB;;WAEG;QACH,KAAK,EAAE;YACH;;eAEG;YACH,KAAK,EAAE,YAAY;YAEnB;;eAEG;YACH,OAAO,EAAE,cAAc;YAEvB;;eAEG;YACH,SAAS,EAAE,gBAAgB;SAC9B;KACJ;CACK,CAAC"}

package/dist/compression/tar.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * TAR archive platform functions for East Node IO.
+ *
+ * Provides TAR archive creation and extraction operations for East programs,
+ * enabling file archiving using the TAR format (without compression).
+ *
+ * @packageDocumentation
+ */
+import { BlobType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * Creates a TAR archive from a list of files.
+ *
+ * Archives multiple files into a single TAR file. Each file entry contains
+ * a name (path) and its data. TAR archives are not compressed by default,
+ * but can be compressed separately using gzip (creating .tar.gz files).
+ *
+ * This is a platform function for the East language, enabling TAR archive
+ * creation in East programs running on Node.js.
+ *
+ * @param entries - List of files to include in the archive
+ * @returns TAR archive as blob
+ *
+ * @throws {EastError} When archiving fails due to:
+ * - Empty file name (location: "tar_create")
+ * - File name too long (> 100 characters) (location: "tar_create")
+ * - Memory allocation errors (location: "tar_create")
+ * - Internal errors (location: "tar_create")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const createTar = East.function([StringType, StringType], BlobType, ($, file1Content, file2Content) => {
+ *     const entries = $.let([
+ *         {
+ *             name: "file1.txt",
+ *             data: file1Content.encodeUtf8(),
+ *         },
+ *         {
+ *             name: "file2.txt",
+ *             data: file2Content.encodeUtf8(),
+ *         },
+ *     ]);
+ *     const tarBlob = $.let(Compression.Tar.create(entries));
+ *     return $.return(tarBlob);
+ * });
+ *
+ * const compiled = East.compile(createTar.toIR(), Compression.Tar.Implementation);
+ * const result = compiled("Hello", "World");  // TAR archive blob
+ * ```
+ *
+ * @remarks
+ * - Uses POSIX ustar format (IEEE 1003.1-1988)
+ * - File names are limited to 100 characters (or 256 with prefix)
+ * - TAR does not include compression - use with gzip for .tar.gz
+ * - File permissions default to 0644 (readable/writable by owner)
+ * - Operations are asynchronous (use East.compileAsync)
+ */
+export declare const tar_create: import("@elaraai/east").AsyncPlatformDefinition<[import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+    name: import("@elaraai/east").StringType;
+    data: BlobType;
+}>>], BlobType>;
+/**
+ * Extracts files from a TAR archive.
+ *
+ * Extracts all files from a TAR archive into a dictionary mapping file
+ * names to their data. Supports POSIX ustar format.
+ *
+ * This is a platform function for the East language, enabling TAR archive
+ * extraction in East programs running on Node.js.
+ *
+ * @param tarData - TAR archive blob
+ * @returns Dictionary mapping file names to their data
+ *
+ * @throws {EastError} When extraction fails due to:
+ * - Invalid TAR format (location: "tar_extract")
+ * - Corrupted archive (location: "tar_extract")
+ * - Invalid checksum (location: "tar_extract")
+ * - Memory allocation errors (location: "tar_extract")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, DictType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const extractTar = East.function([BlobType], DictType(StringType, BlobType), ($, tarBlob) => {
+ *     const files = $.let(Compression.Tar.extract(tarBlob));
+ *     return $.return(files);
+ * });
+ *
+ * const compiled = East.compile(extractTar.toIR(), Compression.Tar.Implementation);
+ * const result = compiled(tarBlob);
+ * // Map { "file1.txt" => Uint8Array, "file2.txt" => Uint8Array }
+ * ```
+ *
+ * @remarks
+ * - Supports POSIX ustar format (IEEE 1003.1-1988)
+ * - Validates header checksums
+ * - Skips directory entries (only extracts files)
+ * - Operations are asynchronous (use East.compileAsync)
+ */
+export declare const tar_extract: import("@elaraai/east").AsyncPlatformDefinition<[BlobType], import("@elaraai/east").DictType<import("@elaraai/east").StringType, BlobType>>;
+/**
+ * Node.js implementation of TAR platform functions.
+ *
+ * Pass this array to {@link East.compileAsync} to enable TAR archive operations.
+ */
+export declare const TarImpl: PlatformFunction[];
+//# sourceMappingURL=tar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["../../src/compression/tar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAQ,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,UAAU;;;eAA+D,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,WAAW,6IAAkE,CAAC;AAyI3F;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,gBAAgB,EAwBrC,CAAC"}

package/dist/compression/tar.js

@@ -0,0 +1,254 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * TAR archive platform functions for East Node IO.
+ *
+ * Provides TAR archive creation and extraction operations for East programs,
+ * enabling file archiving using the TAR format (without compression).
+ *
+ * @packageDocumentation
+ */
+import { East, BlobType } from "@elaraai/east";
+import { EastError } from "@elaraai/east/internal";
+import { pack, extract } from "tar-stream";
+import { Readable } from "node:stream";
+import { TarEntriesType, TarExtractedType } from "./types.js";
+/**
+ * Creates a TAR archive from a list of files.
+ *
+ * Archives multiple files into a single TAR file. Each file entry contains
+ * a name (path) and its data. TAR archives are not compressed by default,
+ * but can be compressed separately using gzip (creating .tar.gz files).
+ *
+ * This is a platform function for the East language, enabling TAR archive
+ * creation in East programs running on Node.js.
+ *
+ * @param entries - List of files to include in the archive
+ * @returns TAR archive as blob
+ *
+ * @throws {EastError} When archiving fails due to:
+ * - Empty file name (location: "tar_create")
+ * - File name too long (> 100 characters) (location: "tar_create")
+ * - Memory allocation errors (location: "tar_create")
+ * - Internal errors (location: "tar_create")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const createTar = East.function([StringType, StringType], BlobType, ($, file1Content, file2Content) => {
+ *     const entries = $.let([
+ *         {
+ *             name: "file1.txt",
+ *             data: file1Content.encodeUtf8(),
+ *         },
+ *         {
+ *             name: "file2.txt",
+ *             data: file2Content.encodeUtf8(),
+ *         },
+ *     ]);
+ *     const tarBlob = $.let(Compression.Tar.create(entries));
+ *     return $.return(tarBlob);
+ * });
+ *
+ * const compiled = East.compile(createTar.toIR(), Compression.Tar.Implementation);
+ * const result = compiled("Hello", "World");  // TAR archive blob
+ * ```
+ *
+ * @remarks
+ * - Uses POSIX ustar format (IEEE 1003.1-1988)
+ * - File names are limited to 100 characters (or 256 with prefix)
+ * - TAR does not include compression - use with gzip for .tar.gz
+ * - File permissions default to 0644 (readable/writable by owner)
+ * - Operations are asynchronous (use East.compileAsync)
+ */
+export const tar_create = East.asyncPlatform("tar_create", [TarEntriesType], BlobType);
+/**
+ * Extracts files from a TAR archive.
+ *
+ * Extracts all files from a TAR archive into a dictionary mapping file
+ * names to their data. Supports POSIX ustar format.
+ *
+ * This is a platform function for the East language, enabling TAR archive
+ * extraction in East programs running on Node.js.
+ *
+ * @param tarData - TAR archive blob
+ * @returns Dictionary mapping file names to their data
+ *
+ * @throws {EastError} When extraction fails due to:
+ * - Invalid TAR format (location: "tar_extract")
+ * - Corrupted archive (location: "tar_extract")
+ * - Invalid checksum (location: "tar_extract")
+ * - Memory allocation errors (location: "tar_extract")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, DictType, StringType } from "@elaraai/east";
+ * import { Compression } from "@elaraai/east-node-io";
+ *
+ * const extractTar = East.function([BlobType], DictType(StringType, BlobType), ($, tarBlob) => {
+ *     const files = $.let(Compression.Tar.extract(tarBlob));
+ *     return $.return(files);
+ * });
+ *
+ * const compiled = East.compile(extractTar.toIR(), Compression.Tar.Implementation);
+ * const result = compiled(tarBlob);
+ * // Map { "file1.txt" => Uint8Array, "file2.txt" => Uint8Array }
+ * ```
+ *
+ * @remarks
+ * - Supports POSIX ustar format (IEEE 1003.1-1988)
+ * - Validates header checksums
+ * - Skips directory entries (only extracts files)
+ * - Operations are asynchronous (use East.compileAsync)
+ */
+export const tar_extract = East.asyncPlatform("tar_extract", [BlobType], TarExtractedType);
+/**
+ * Helper function to create a TAR archive using tar-stream.
+ *
+ * @param entries - List of file entries
+ * @returns TAR archive as Uint8Array
+ */
+async function createTar(entries) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const tarPack = pack();
+        // Collect chunks
+        tarPack.on('data', (chunk) => {
+            chunks.push(new Uint8Array(chunk));
+        });
+        tarPack.on('end', () => {
+            const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+            const result = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                result.set(chunk, offset);
+                offset += chunk.length;
+            }
+            resolve(result);
+        });
+        tarPack.on('error', (err) => {
+            reject(new EastError(`TAR creation failed: ${err.message}`, {
+                location: { filename: "tar_create", line: 0n, column: 0n },
+                cause: err
+            }));
+        });
+        // Add all entries to the archive
+        for (const entry of entries) {
+            const name = entry.name;
+            const data = entry.data;
+            if (!name || name.length === 0) {
+                reject(new EastError("File name cannot be empty", {
+                    location: { filename: "tar_create", line: 0n, column: 0n }
+                }));
+                return;
+            }
+            // Write entry to tar stream
+            const entryStream = tarPack.entry({
+                name: name,
+                size: data.length,
+                mode: 0o644,
+                mtime: new Date()
+            }, (err) => {
+                if (err) {
+                    reject(new EastError(`Failed to add entry ${name}: ${err.message}`, {
+                        location: { filename: "tar_create", line: 0n, column: 0n },
+                        cause: err
+                    }));
+                }
+            });
+            entryStream.write(Buffer.from(data));
+            entryStream.end();
+        }
+        // Finalize the archive
+        tarPack.finalize();
+    });
+}
+/**
+ * Helper function to extract files from a TAR archive.
+ *
+ * @param tarData - TAR archive data
+ * @returns Map of file names to their data
+ */
+async function extractTar(tarData) {
+    return new Promise((resolve, reject) => {
+        const files = new Map();
+        const tarExtract = extract();
+        tarExtract.on('entry', (header, stream, next) => {
+            const chunks = [];
+            stream.on('data', (chunk) => {
+                chunks.push(new Uint8Array(chunk));
+            });
+            stream.on('end', () => {
+                // Only store files, not directories
+                if (header.type === 'file') {
+                    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+                    const result = new Uint8Array(totalLength);
+                    let offset = 0;
+                    for (const chunk of chunks) {
+                        result.set(chunk, offset);
+                        offset += chunk.length;
+                    }
+                    files.set(header.name, result);
+                }
+                next();
+            });
+            stream.on('error', (err) => {
+                reject(new EastError(`Failed to extract entry ${header.name}: ${err.message}`, {
+                    location: { filename: "tar_extract", line: 0n, column: 0n },
+                    cause: err
+                }));
+            });
+            stream.resume();
+        });
+        tarExtract.on('finish', () => {
+            resolve(files);
+        });
+        tarExtract.on('error', (err) => {
+            reject(new EastError(`TAR extraction failed: ${err.message}`, {
+                location: { filename: "tar_extract", line: 0n, column: 0n },
+                cause: err
+            }));
+        });
+        // Feed the tar data to the extractor
+        const readable = Readable.from(Buffer.from(tarData));
+        readable.pipe(tarExtract);
+    });
+}
+/**
+ * Node.js implementation of TAR platform functions.
+ *
+ * Pass this array to {@link East.compileAsync} to enable TAR archive operations.
+ */
+export const TarImpl = [
+    tar_create.implement(async (entries) => {
+        try {
+            return await createTar(entries);
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`TAR creation failed: ${err.message}`, {
+                location: { filename: "tar_create", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    tar_extract.implement(async (tarData) => {
+        try {
+            return await extractTar(tarData);
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`TAR extraction failed: ${err.message}`, {
+                location: { filename: "tar_extract", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+];
+//# sourceMappingURL=tar.js.map

package/dist/compression/tar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.js","sourceRoot":"","sources":["../../src/compression/tar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,KAAK,UAAU,SAAS,CAAC,OAA2C;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;QAEvB,iBAAiB;QACjB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACjC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACnB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;YAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;YAC3B,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC/B,MAAM,CAAC,IAAI,SAAS,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,EAAE;gBACxD,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC1D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,CAAC;QAEH,iCAAiC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAExB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,SAAS,CAAC,2BAA2B,EAAE;oBAC9C,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;iBAC7D,CAAC,CAAC,CAAC;gBACJ,OAAO;YACX,CAAC;YAED,4BAA4B;YAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC9B,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,IAAI,IAAI,EAAE;aACpB,EAAE,CAAC,GAAG,EAAE,EAAE;gBACP,IAAI,GAAG,EAAE,CAAC;oBACN,MAAM,CAAC,IAAI,SAAS,CAAC,uBAAuB,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;wBAChE,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;wBAC1D,KAAK,EAAE,GAAG;qBACb,CAAC,CAAC,CAAC;gBACR,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,WAAW,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QAED,uBAAuB;QACvB,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CAAC,OAAqC;IAC3D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC5C,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC;QAE7B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAiB,EAAE,CAAC;YAEhC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBAChC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBAClB,oCAAoC;gBACpC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACzB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBACzE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;oBAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;oBAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;wBACzB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;wBAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;oBAC3B,CAAC;oBAED,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACnC,CAAC;gBAED,IAAI,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,MAAM,CAAC,IAAI,SAAS,CAAC,2BAA2B,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;oBAC3E,QAAQ,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;oBAC3D,KAAK,EAAE,GAAG;iBACb,CAAC,CAAC,CAAC;YACR,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACzB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3B,MAAM,CAAC,IAAI,SAAS,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC1D,QAAQ,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC3D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAuB;IACvC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,OAA2C,EAAE,EAAE;QACvE,IAAI,CAAC;YACD,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,EAAE;gBACvD,QAAQ,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC1D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IAEF,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,OAAqC,EAAE,EAAE;QAClE,IAAI,CAAC;YACD,OAAO,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE;gBACzD,QAAQ,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC3D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;CACL,CAAC"}