@layerzerolabs/deterministic-zip 0.2.121 → 0.2.124

package/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026 - LayerZero Labs Ltd.
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -35,7 +35,8 @@ export declare const DEFAULT_DETERMINISTIC_ZIP_MTIME: Date;
  * Build a byte-deterministic ZIP of `sourceDir`.
  *
  * Entry order and timestamps are normalized so equivalent directories produce
- * stable archive bytes.
+ * stable archive bytes. Directory entries with no included child files are
+ * omitted so empty folders cannot change the archive hash.
  */
 export declare const zipDirectoryToUint8Array: (sourceDir: string, options?: ZipDirectoryOptions) => Promise<Uint8Array>;
 export declare const zipDirectoryToBuffer: (sourceDir: string, options?: ZipDirectoryOptions) => Promise<Buffer>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjE,oBAAY,YAAY;IACpB,IAAI,SAAS;IACb,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAChC,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAiC,CAAC;AAyC9E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACjC,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,UAAU,CAiBpB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC7B,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,MAAM,CAAoE,CAAC;AAEtF,eAAO,MAAM,oBAAoB,GAC7B,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,MAAM,CAAwE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjE,oBAAY,YAAY;IACpB,IAAI,SAAS;IACb,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAChC,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAiC,CAAC;AA6D9E;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACjC,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,UAAU,CAiBpB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC7B,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,MAAM,CAAoE,CAAC;AAEtF,eAAO,MAAM,oBAAoB,GAC7B,WAAW,MAAM,EACjB,UAAU,mBAAmB,KAC9B,OAAO,CAAC,MAAM,CAAwE,CAAC"}

package/dist/index.js

@@ -11,6 +11,18 @@ var ZipEntryType = /* @__PURE__ */ (function(ZipEntryType2) {
 })({});
 var DEFAULT_DETERMINISTIC_ZIP_MTIME = new Date(2026, 5, 15, 0, 0, 0);
 var INCLUDE_EVERYTHING = /* @__PURE__ */ __name(() => true, "INCLUDE_EVERYTHING");
+var omitEmptyDirectories = /* @__PURE__ */ __name((entries) => {
+  const dirsWithFiles = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (entry.isDirectory) continue;
+    let dir = path.posix.dirname(entry.relPath);
+    while (dir !== "" && dir !== ".") {
+      dirsWithFiles.add(`${dir}/`);
+      dir = path.posix.dirname(dir);
+    }
+  }
+  return entries.filter((entry) => !entry.isDirectory || dirsWithFiles.has(entry.relPath));
+}, "omitEmptyDirectories");
 var collectSortedEntries = /* @__PURE__ */ __name(async (root, includeEntry) => {
   const zipEntries = [];
   const walk = /* @__PURE__ */ __name(async (rel) => {
@@ -44,7 +56,7 @@ var collectSortedEntries = /* @__PURE__ */ __name(async (root, includeEntry) =>
     }
   }, "walk");
   await walk("");
-  return zipEntries.sort((a, b) => a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0);
+  return omitEmptyDirectories(zipEntries).sort((a, b) => a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0);
 }, "collectSortedEntries");
 var zipDirectoryToUint8Array = /* @__PURE__ */ __name(async (sourceDir, options) => {
   const entries = await collectSortedEntries(sourceDir, options?.pathInclusionPredicate ?? INCLUDE_EVERYTHING);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["ZipEntryType","DEFAULT_DETERMINISTIC_ZIP_MTIME","Date","INCLUDE_EVERYTHING","collectSortedEntries","root","includeEntry","zipEntries","walk","rel","entries","fs","readdir","path","join","withFileTypes","entry","childRel","posix","name","isDirectory","relPath","type","push","isFile","isSymbolicLink","Error","sort","a","b","zipDirectoryToUint8Array","sourceDir","options","pathInclusionPredicate","fileMap","Uint8Array","readFile","zipSync","level","mtime","zipDirectoryToBuffer","Buffer","from","zipDirectoryToBase64","toString"],"mappings":"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","file":"index.js","sourcesContent":["import { type Zippable, zipSync } from 'fflate';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\n/** fflate deflate compression levels (0 = store, 9 = max). */\nexport type DeflateLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\nexport enum ZipEntryType {\n    File = 'file',\n    Directory = 'directory',\n}\n\nexport interface ZipEntryInfo {\n    /** POSIX-relative path from the zip root, no trailing slash. */\n    relPath: string;\n    type: ZipEntryType;\n}\n\nexport type PathInclusionPredicate = (entry: ZipEntryInfo) => boolean;\n\nexport interface ZipDirectoryOptions {\n    /** Deflate compression level passed to fflate. Defaults to `6`. */\n    level?: DeflateLevel;\n    /** Modification time stamped onto every ZIP entry. */\n    mtime?: Date;\n    /**\n     * Called for every file and directory. Return `false` to drop the entry;\n     * `false` on a directory prunes its entire subtree (children are never\n     * visited). Omitted = include everything.\n     *\n     * Symlinks are not supported and always throw.\n     */\n    pathInclusionPredicate?: PathInclusionPredicate;\n}\n\n/**\n * Fixed modification time stamped onto every archive entry.\n *\n * fflate writes ZIP timestamps from local date fields, so this value is built\n * with local fields to keep the encoded timestamp stable across timezones.\n */\nexport const DEFAULT_DETERMINISTIC_ZIP_MTIME = new Date(2026, 5, 15, 0, 0, 0);\n\nconst INCLUDE_EVERYTHING: PathInclusionPredicate = () => true;\n\ntype DeterministicZipEntry = { relPath: string; isDirectory: boolean };\n\n/**\n * Recursively collect every included file and directory under `root`, sorted\n * by POSIX-relative path (UTF-16 code unit order).\n *\n * Filesystem `readdir` order varies by platform, so sorting is required for\n * reproducible archives.\n */\nconst collectSortedEntries = async (\n    root: string,\n    includeEntry: PathInclusionPredicate,\n): Promise<DeterministicZipEntry[]> => {\n    const zipEntries: DeterministicZipEntry[] = [];\n\n    const walk = async (rel: string): Promise<void> => {\n        const entries = await fs.readdir(path.join(root, rel), { withFileTypes: true });\n        for (const entry of entries) {\n            const childRel = rel ? path.posix.join(rel, entry.name) : entry.name;\n            if (entry.isDirectory()) {\n                if (!includeEntry({ relPath: childRel, type: ZipEntryType.Directory })) continue;\n                // fflate treats trailing-slash zero-length entries as directories.\n                zipEntries.push({ relPath: `${childRel}/`, isDirectory: true });\n                await walk(childRel);\n            } else if (entry.isFile()) {\n                if (!includeEntry({ relPath: childRel, type: ZipEntryType.File })) continue;\n                zipEntries.push({ relPath: childRel, isDirectory: false });\n            } else if (entry.isSymbolicLink()) {\n                throw new Error(`symlink entries are not supported: ${childRel}`);\n            }\n        }\n    };\n\n    await walk('');\n    return zipEntries.sort((a, b) => (a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0));\n};\n\n/**\n * Build a byte-deterministic ZIP of `sourceDir`.\n *\n * Entry order and timestamps are normalized so equivalent directories produce\n * stable archive bytes.\n */\nexport const zipDirectoryToUint8Array = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<Uint8Array> => {\n    const entries = await collectSortedEntries(\n        sourceDir,\n        options?.pathInclusionPredicate ?? INCLUDE_EVERYTHING,\n    );\n    const fileMap: Zippable = {};\n\n    for (const entry of entries) {\n        fileMap[entry.relPath] = entry.isDirectory\n            ? new Uint8Array(0)\n            : new Uint8Array(await fs.readFile(path.join(sourceDir, entry.relPath)));\n    }\n\n    return zipSync(fileMap, {\n        level: options?.level ?? 6,\n        mtime: options?.mtime ?? DEFAULT_DETERMINISTIC_ZIP_MTIME,\n    });\n};\n\nexport const zipDirectoryToBuffer = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<Buffer> => Buffer.from(await zipDirectoryToUint8Array(sourceDir, options));\n\nexport const zipDirectoryToBase64 = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<string> => (await zipDirectoryToBuffer(sourceDir, options)).toString('base64');\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["ZipEntryType","DEFAULT_DETERMINISTIC_ZIP_MTIME","Date","INCLUDE_EVERYTHING","omitEmptyDirectories","entries","dirsWithFiles","Set","entry","isDirectory","dir","path","posix","dirname","relPath","add","filter","has","collectSortedEntries","root","includeEntry","zipEntries","walk","rel","fs","readdir","join","withFileTypes","childRel","name","type","push","isFile","isSymbolicLink","Error","sort","a","b","zipDirectoryToUint8Array","sourceDir","options","pathInclusionPredicate","fileMap","Uint8Array","readFile","zipSync","level","mtime","zipDirectoryToBuffer","Buffer","from","zipDirectoryToBase64","toString"],"mappings":"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","file":"index.js","sourcesContent":["import { type Zippable, zipSync } from 'fflate';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\n/** fflate deflate compression levels (0 = store, 9 = max). */\nexport type DeflateLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\nexport enum ZipEntryType {\n    File = 'file',\n    Directory = 'directory',\n}\n\nexport interface ZipEntryInfo {\n    /** POSIX-relative path from the zip root, no trailing slash. */\n    relPath: string;\n    type: ZipEntryType;\n}\n\nexport type PathInclusionPredicate = (entry: ZipEntryInfo) => boolean;\n\nexport interface ZipDirectoryOptions {\n    /** Deflate compression level passed to fflate. Defaults to `6`. */\n    level?: DeflateLevel;\n    /** Modification time stamped onto every ZIP entry. */\n    mtime?: Date;\n    /**\n     * Called for every file and directory. Return `false` to drop the entry;\n     * `false` on a directory prunes its entire subtree (children are never\n     * visited). Omitted = include everything.\n     *\n     * Symlinks are not supported and always throw.\n     */\n    pathInclusionPredicate?: PathInclusionPredicate;\n}\n\n/**\n * Fixed modification time stamped onto every archive entry.\n *\n * fflate writes ZIP timestamps from local date fields, so this value is built\n * with local fields to keep the encoded timestamp stable across timezones.\n */\nexport const DEFAULT_DETERMINISTIC_ZIP_MTIME = new Date(2026, 5, 15, 0, 0, 0);\n\nconst INCLUDE_EVERYTHING: PathInclusionPredicate = () => true;\n\ntype DeterministicZipEntry = { relPath: string; isDirectory: boolean };\n\n/**\n * Drop directory entries that have no included descendant file. Empty dirs (or dirs whose files\n * were all filtered out) must not affect archive bytes / hashes.\n */\nconst omitEmptyDirectories = (entries: DeterministicZipEntry[]): DeterministicZipEntry[] => {\n    const dirsWithFiles = new Set<string>();\n    for (const entry of entries) {\n        if (entry.isDirectory) continue;\n        let dir = path.posix.dirname(entry.relPath);\n        while (dir !== '' && dir !== '.') {\n            dirsWithFiles.add(`${dir}/`);\n            dir = path.posix.dirname(dir);\n        }\n    }\n    return entries.filter((entry) => !entry.isDirectory || dirsWithFiles.has(entry.relPath));\n};\n\n/**\n * Recursively collect every included file and directory under `root`, sorted\n * by POSIX-relative path (UTF-16 code unit order). Directories with no included\n * child files are omitted.\n *\n * Filesystem `readdir` order varies by platform, so sorting is required for\n * reproducible archives.\n */\nconst collectSortedEntries = async (\n    root: string,\n    includeEntry: PathInclusionPredicate,\n): Promise<DeterministicZipEntry[]> => {\n    const zipEntries: DeterministicZipEntry[] = [];\n\n    const walk = async (rel: string): Promise<void> => {\n        const entries = await fs.readdir(path.join(root, rel), { withFileTypes: true });\n        for (const entry of entries) {\n            const childRel = rel ? path.posix.join(rel, entry.name) : entry.name;\n            if (entry.isDirectory()) {\n                if (!includeEntry({ relPath: childRel, type: ZipEntryType.Directory })) continue;\n                // fflate treats trailing-slash zero-length entries as directories.\n                zipEntries.push({ relPath: `${childRel}/`, isDirectory: true });\n                await walk(childRel);\n            } else if (entry.isFile()) {\n                if (!includeEntry({ relPath: childRel, type: ZipEntryType.File })) continue;\n                zipEntries.push({ relPath: childRel, isDirectory: false });\n            } else if (entry.isSymbolicLink()) {\n                throw new Error(`symlink entries are not supported: ${childRel}`);\n            }\n        }\n    };\n\n    await walk('');\n    return omitEmptyDirectories(zipEntries).sort((a, b) =>\n        a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0,\n    );\n};\n\n/**\n * Build a byte-deterministic ZIP of `sourceDir`.\n *\n * Entry order and timestamps are normalized so equivalent directories produce\n * stable archive bytes. Directory entries with no included child files are\n * omitted so empty folders cannot change the archive hash.\n */\nexport const zipDirectoryToUint8Array = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<Uint8Array> => {\n    const entries = await collectSortedEntries(\n        sourceDir,\n        options?.pathInclusionPredicate ?? INCLUDE_EVERYTHING,\n    );\n    const fileMap: Zippable = {};\n\n    for (const entry of entries) {\n        fileMap[entry.relPath] = entry.isDirectory\n            ? new Uint8Array(0)\n            : new Uint8Array(await fs.readFile(path.join(sourceDir, entry.relPath)));\n    }\n\n    return zipSync(fileMap, {\n        level: options?.level ?? 6,\n        mtime: options?.mtime ?? DEFAULT_DETERMINISTIC_ZIP_MTIME,\n    });\n};\n\nexport const zipDirectoryToBuffer = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<Buffer> => Buffer.from(await zipDirectoryToUint8Array(sourceDir, options));\n\nexport const zipDirectoryToBase64 = async (\n    sourceDir: string,\n    options?: ZipDirectoryOptions,\n): Promise<string> => (await zipDirectoryToBuffer(sourceDir, options)).toString('base64');\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/deterministic-zip",
-  "version": "0.2.121",
+  "version": "0.2.124",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -12,19 +12,30 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
   "dependencies": {
     "fflate": "^0.8.3"
   },
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.6",
-    "@layerzerolabs/tsup-configuration": "0.2.121",
-    "@layerzerolabs/typescript-configuration": "0.2.121"
+    "@layerzerolabs/tsup-configuration": "0.2.124",
+    "@layerzerolabs/typescript-configuration": "0.2.124"
   },
   "publishConfig": {
-    "access": "restricted",
+    "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "externalRepoConfig": {
+    "targets": [
+      "audit-external",
+      "console-pen-test",
+      "monorepo-external",
+      "onesig-client"
+    ]
+  },
   "scripts": {
     "build": "tsup",
     "lint": "eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)",

package/.turbo/turbo-build.log

@@ -1,15 +0,0 @@
- WARN  Issue while reading "/home/runner/work/monorepo-internal/monorepo-internal/.npmrc". Failed to replace env in config: ${NPM_TOKEN}
-
-> @layerzerolabs/deterministic-zip@0.0.0 build /home/runner/work/monorepo-internal/monorepo-internal/tools/vm-utils/common/deterministic-zip
-> tsup
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/tools/vm-utils/common/deterministic-zip/tsup.config.ts
-CLI Target: ES2023
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js     2.74 KB
-ESM dist/index.js.map 7.33 KB
-ESM ⚡️ Build success in 85ms

package/.turbo/turbo-lint.log

@@ -1,8 +0,0 @@
-
-> @layerzerolabs/deterministic-zip@0.0.0 lint /home/runner/work/monorepo-internal/monorepo-internal/tools/vm-utils/common/deterministic-zip
-> eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)
-
-(node:93356) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1783715897758 is not specified and it doesn't parse as CommonJS.
-Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
-To eliminate this warning, add "type": "module" to /home/runner/work/monorepo-internal/monorepo-internal/package.json.
-(Use `node --trace-warnings ...` to show where the warning was created)

package/.turbo/turbo-test.log

@@ -1,17 +0,0 @@
-
-> @layerzerolabs/deterministic-zip@0.0.0 test /home/runner/work/monorepo-internal/monorepo-internal/tools/vm-utils/common/deterministic-zip
-> vitest --run --pass-with-no-tests --typecheck
-
-Testing types with tsc and vue-tsc is an experimental feature.
-Breaking changes might not follow SemVer, please pin Vitest's version when using it.
-
- RUN  v3.2.6 /home/runner/work/monorepo-internal/monorepo-internal/tools/vm-utils/common/deterministic-zip
-
- ✓ tests/deterministicZip.test.ts (8 tests) 120ms
-
- Test Files  1 passed (1)
-      Tests  8 passed (8)
-Type Errors  no errors
-   Start at  20:42:42
-   Duration  619ms (transform 93ms, setup 0ms, collect 81ms, tests 120ms, environment 0ms, prepare 158ms)
-

package/src/index.ts

@@ -1,119 +0,0 @@
-import { type Zippable, zipSync } from 'fflate';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-/** fflate deflate compression levels (0 = store, 9 = max). */
-export type DeflateLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
-
-export enum ZipEntryType {
-    File = 'file',
-    Directory = 'directory',
-}
-
-export interface ZipEntryInfo {
-    /** POSIX-relative path from the zip root, no trailing slash. */
-    relPath: string;
-    type: ZipEntryType;
-}
-
-export type PathInclusionPredicate = (entry: ZipEntryInfo) => boolean;
-
-export interface ZipDirectoryOptions {
-    /** Deflate compression level passed to fflate. Defaults to `6`. */
-    level?: DeflateLevel;
-    /** Modification time stamped onto every ZIP entry. */
-    mtime?: Date;
-    /**
-     * Called for every file and directory. Return `false` to drop the entry;
-     * `false` on a directory prunes its entire subtree (children are never
-     * visited). Omitted = include everything.
-     *
-     * Symlinks are not supported and always throw.
-     */
-    pathInclusionPredicate?: PathInclusionPredicate;
-}
-
-/**
- * Fixed modification time stamped onto every archive entry.
- *
- * fflate writes ZIP timestamps from local date fields, so this value is built
- * with local fields to keep the encoded timestamp stable across timezones.
- */
-export const DEFAULT_DETERMINISTIC_ZIP_MTIME = new Date(2026, 5, 15, 0, 0, 0);
-
-const INCLUDE_EVERYTHING: PathInclusionPredicate = () => true;
-
-type DeterministicZipEntry = { relPath: string; isDirectory: boolean };
-
-/**
- * Recursively collect every included file and directory under `root`, sorted
- * by POSIX-relative path (UTF-16 code unit order).
- *
- * Filesystem `readdir` order varies by platform, so sorting is required for
- * reproducible archives.
- */
-const collectSortedEntries = async (
-    root: string,
-    includeEntry: PathInclusionPredicate,
-): Promise<DeterministicZipEntry[]> => {
-    const zipEntries: DeterministicZipEntry[] = [];
-
-    const walk = async (rel: string): Promise<void> => {
-        const entries = await fs.readdir(path.join(root, rel), { withFileTypes: true });
-        for (const entry of entries) {
-            const childRel = rel ? path.posix.join(rel, entry.name) : entry.name;
-            if (entry.isDirectory()) {
-                if (!includeEntry({ relPath: childRel, type: ZipEntryType.Directory })) continue;
-                // fflate treats trailing-slash zero-length entries as directories.
-                zipEntries.push({ relPath: `${childRel}/`, isDirectory: true });
-                await walk(childRel);
-            } else if (entry.isFile()) {
-                if (!includeEntry({ relPath: childRel, type: ZipEntryType.File })) continue;
-                zipEntries.push({ relPath: childRel, isDirectory: false });
-            } else if (entry.isSymbolicLink()) {
-                throw new Error(`symlink entries are not supported: ${childRel}`);
-            }
-        }
-    };
-
-    await walk('');
-    return zipEntries.sort((a, b) => (a.relPath < b.relPath ? -1 : a.relPath > b.relPath ? 1 : 0));
-};
-
-/**
- * Build a byte-deterministic ZIP of `sourceDir`.
- *
- * Entry order and timestamps are normalized so equivalent directories produce
- * stable archive bytes.
- */
-export const zipDirectoryToUint8Array = async (
-    sourceDir: string,
-    options?: ZipDirectoryOptions,
-): Promise<Uint8Array> => {
-    const entries = await collectSortedEntries(
-        sourceDir,
-        options?.pathInclusionPredicate ?? INCLUDE_EVERYTHING,
-    );
-    const fileMap: Zippable = {};
-
-    for (const entry of entries) {
-        fileMap[entry.relPath] = entry.isDirectory
-            ? new Uint8Array(0)
-            : new Uint8Array(await fs.readFile(path.join(sourceDir, entry.relPath)));
-    }
-
-    return zipSync(fileMap, {
-        level: options?.level ?? 6,
-        mtime: options?.mtime ?? DEFAULT_DETERMINISTIC_ZIP_MTIME,
-    });
-};
-
-export const zipDirectoryToBuffer = async (
-    sourceDir: string,
-    options?: ZipDirectoryOptions,
-): Promise<Buffer> => Buffer.from(await zipDirectoryToUint8Array(sourceDir, options));
-
-export const zipDirectoryToBase64 = async (
-    sourceDir: string,
-    options?: ZipDirectoryOptions,
-): Promise<string> => (await zipDirectoryToBuffer(sourceDir, options)).toString('base64');

package/tests/deterministicZip.test.ts

@@ -1,148 +0,0 @@
-import { unzipSync } from 'fflate';
-import fs from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { afterEach, describe, expect, it } from 'vitest';
-
-import {
-    zipDirectoryToBase64,
-    zipDirectoryToUint8Array,
-    type ZipEntryInfo,
-    ZipEntryType,
-} from '../src';
-
-const testDirs: string[] = [];
-
-const createTempDir = async () => {
-    const dir = await fs.mkdtemp(path.join(tmpdir(), 'deterministic-zip-'));
-    testDirs.push(dir);
-    return dir;
-};
-
-afterEach(async () => {
-    await Promise.all(
-        testDirs.splice(0).map((dir) => fs.rm(dir, { recursive: true, force: true })),
-    );
-});
-
-describe('deterministic zip', () => {
-    it('sorts entries and keeps empty directories', async () => {
-        const dir = await createTempDir();
-        await fs.mkdir(path.join(dir, 'z-empty'), { recursive: true });
-        await fs.mkdir(path.join(dir, 'a'), { recursive: true });
-        await fs.writeFile(path.join(dir, 'b.txt'), 'b');
-        await fs.writeFile(path.join(dir, 'a', 'c.txt'), 'c');
-
-        const unzipped = unzipSync(await zipDirectoryToUint8Array(dir));
-
-        expect(Object.keys(unzipped)).toEqual(['a/', 'a/c.txt', 'b.txt', 'z-empty/']);
-    });
-
-    it('produces stable bytes for equivalent directories', async () => {
-        const first = await createTempDir();
-        const second = await createTempDir();
-
-        await fs.mkdir(path.join(first, 'sources'), { recursive: true });
-        await fs.writeFile(path.join(first, 'sources', 'module.move'), 'module first::m {}');
-        await fs.writeFile(path.join(first, 'Move.toml'), '[package]\nname = "first"\n');
-
-        await fs.writeFile(path.join(second, 'Move.toml'), '[package]\nname = "first"\n');
-        await fs.mkdir(path.join(second, 'sources'), { recursive: true });
-        await fs.writeFile(path.join(second, 'sources', 'module.move'), 'module first::m {}');
-
-        expect(await zipDirectoryToBase64(first)).toEqual(await zipDirectoryToBase64(second));
-    });
-
-    it('writes directory entries into the zip', async () => {
-        const dir = await createTempDir();
-        await fs.mkdir(path.join(dir, 'empty'), { recursive: true });
-
-        const unzipped = unzipSync(await zipDirectoryToUint8Array(dir));
-
-        expect(Object.keys(unzipped)).toEqual(['empty/']);
-    });
-
-    describe('pathInclusionPredicate', () => {
-        it('includes everything when no predicate is given', async () => {
-            const dir = await createTempDir();
-            await fs.writeFile(path.join(dir, '.env'), 'SECRET=1');
-            await fs.writeFile(path.join(dir, 'id_rsa'), 'key');
-
-            const unzipped = unzipSync(await zipDirectoryToUint8Array(dir));
-
-            expect(Object.keys(unzipped)).toEqual(['.env', 'id_rsa']);
-        });
-
-        it('filters files through the predicate while directories remain', async () => {
-            const dir = await createTempDir();
-            await fs.mkdir(path.join(dir, 'sources'), { recursive: true });
-            await fs.writeFile(path.join(dir, 'sources', 'module.move'), 'module a::m {}');
-            await fs.writeFile(path.join(dir, 'sources', '.env'), 'SECRET=1');
-            await fs.writeFile(path.join(dir, 'Move.toml'), '[package]\n');
-            await fs.writeFile(path.join(dir, 'notes.txt'), 'n');
-
-            const unzipped = unzipSync(
-                await zipDirectoryToUint8Array(dir, {
-                    pathInclusionPredicate: ({ relPath, type }) =>
-                        type === ZipEntryType.Directory ||
-                        (type === ZipEntryType.File &&
-                            /(^|\/)Move\.(toml|lock)$|\.move$/.test(relPath)),
-                }),
-            );
-
-            expect(Object.keys(unzipped)).toEqual(['Move.toml', 'sources/', 'sources/module.move']);
-        });
-
-        it('prunes an excluded directory subtree without visiting its children', async () => {
-            const dir = await createTempDir();
-            await fs.mkdir(path.join(dir, 'tests', 'nested'), { recursive: true });
-            await fs.writeFile(path.join(dir, 'tests', 't.move'), 'x');
-            await fs.writeFile(path.join(dir, 'tests', 'nested', 'u.move'), 'y');
-            await fs.writeFile(path.join(dir, 'keep.move'), 'k');
-
-            const seen: string[] = [];
-            const unzipped = unzipSync(
-                await zipDirectoryToUint8Array(dir, {
-                    pathInclusionPredicate: (entry) => {
-                        seen.push(entry.relPath);
-                        return entry.relPath !== 'tests';
-                    },
-                }),
-            );
-
-            expect(Object.keys(unzipped)).toEqual(['keep.move']);
-            // Children of the pruned directory are never offered to the predicate.
-            expect([...seen].sort()).toEqual(['keep.move', 'tests']);
-        });
-
-        it('passes a POSIX relPath without trailing slash and the entry type', async () => {
-            const dir = await createTempDir();
-            await fs.mkdir(path.join(dir, 'a'), { recursive: true });
-            await fs.writeFile(path.join(dir, 'a', 'b.txt'), 'b');
-
-            const seen: ZipEntryInfo[] = [];
-            await zipDirectoryToUint8Array(dir, {
-                pathInclusionPredicate: (entry) => {
-                    seen.push(entry);
-                    return true;
-                },
-            });
-
-            expect(seen).toEqual([
-                { relPath: 'a', type: ZipEntryType.Directory },
-                { relPath: 'a/b.txt', type: ZipEntryType.File },
-            ]);
-        });
-    });
-
-    describe('symlinks', () => {
-        it('throws when a symlink is encountered', async () => {
-            const dir = await createTempDir();
-            await fs.symlink('missing-target', path.join(dir, 'link.txt'));
-
-            await expect(zipDirectoryToUint8Array(dir)).rejects.toThrow(
-                'symlink entries are not supported: link.txt',
-            );
-        });
-    });
-});

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-    "extends": "@layerzerolabs/typescript-configuration/tsconfig.base.json",
-    "compilerOptions": {
-        "rootDir": "./src",
-        "outDir": "./dist",
-        "lib": ["ESNext"],
-        "strictPropertyInitialization": false,
-        "noUnusedLocals": false,
-        "noUnusedParameters": false,
-        "jsx": "react-jsx"
-    },
-    "exclude": [
-        "node_modules",
-        "**/__mocks__/*",
-        "**/__tests__/*",
-        "**/*.spec.ts",
-        "**/*.test.ts",
-        "dist"
-    ],
-    "include": ["src/**/*"]
-}

package/tsup.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from 'tsup';
-
-import { createPackageTsupConfig } from '@layerzerolabs/tsup-configuration';
-
-export default defineConfig(({ watch }) => ({
-    ...createPackageTsupConfig(),
-    clean: !watch,
-}));