@fgv/ts-extras 5.1.0-5 → 5.1.0-50

package/dist/packlets/zip-file-tree/zipFileTreeWriter.js

@@ -23,15 +23,30 @@ import { zipSync, strToU8 } from 'fflate';
 import { captureResult } from '@fgv/ts-utils';
 /**
  * Creates a zip file from an array of text files.
+ *
+ * @remarks
+ * Contents are encoded as UTF-8. Use `createZipFromFiles` to write entries whose
+ * contents are raw bytes.
  * @public
  */
 export function createZipFromTextFiles(files, options) {
+    return createZipFromFiles(files, options);
+}
+/**
+ * Creates a zip file from an array of files whose contents are either text or raw bytes.
+ *
+ * @remarks
+ * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim, so
+ * arbitrary binary payloads round-trip through the archive unchanged.
+ * @public
+ */
+export function createZipFromFiles(files, options) {
     return captureResult(() => {
         var _a;
         const out = {};
         for (const f of files) {
             const normalizedPath = f.path.replace(/^\/+/, '');
-            out[normalizedPath] = strToU8(f.contents);
+            out[normalizedPath] = typeof f.contents === 'string' ? strToU8(f.contents) : f.contents;
         }
         return zipSync(out, { level: (_a = options === null || options === void 0 ? void 0 : options.level) !== null && _a !== void 0 ? _a : 6 });
         /* c8 ignore next - defensive: zipSync only throws on internal library errors */

package/dist/packlets/zip-file-tree/zipFileTreeWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipFileTreeWriter.js","sourceRoot":"","sources":["../../../src/packlets/zip-file-tree/zipFileTreeWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAU,aAAa,EAAE,MAAM,eAAe,CAAC;AAsCtD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAkC,EAClC,OAA2B;IAE3B,OAAO,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA8B,EAC9B,OAA2B;IAE3B,OAAO,aAAa,CAAC,GAAG,EAAE;;QACxB,MAAM,GAAG,GAA+B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClD,GAAG,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1F,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,CAAC,EAAE,CAAC,CAAC;QACpD,gFAAgF;IAClF,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { zipSync, strToU8 } from 'fflate';\nimport { Result, captureResult } from '@fgv/ts-utils';\n\n/**\n * Simple interface for a text file to be added to a zip file.\n * @public\n */\nexport interface IZipTextFile {\n  readonly path: string;\n  readonly contents: string;\n}\n\n/**\n * Interface for a file to be added to a zip file, whose contents are either text or\n * raw bytes.\n *\n * @remarks\n * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim.\n * @public\n */\nexport interface IZipFile {\n  readonly path: string;\n  readonly contents: string | Uint8Array;\n}\n\n/**\n * Supported compression levels for zip files.\n * @public\n */\nexport type ZipCompressionLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\n/**\n * Options for creating a zip file from text files.\n * @public\n */\nexport interface ICreateZipOptions {\n  readonly level?: ZipCompressionLevel;\n}\n\n/**\n * Creates a zip file from an array of text files.\n *\n * @remarks\n * Contents are encoded as UTF-8. Use `createZipFromFiles` to write entries whose\n * contents are raw bytes.\n * @public\n */\nexport function createZipFromTextFiles(\n  files: ReadonlyArray<IZipTextFile>,\n  options?: ICreateZipOptions\n): Result<Uint8Array> {\n  return createZipFromFiles(files, options);\n}\n\n/**\n * Creates a zip file from an array of files whose contents are either text or raw bytes.\n *\n * @remarks\n * String contents are encoded as UTF-8; `Uint8Array` contents are stored verbatim, so\n * arbitrary binary payloads round-trip through the archive unchanged.\n * @public\n */\nexport function createZipFromFiles(\n  files: ReadonlyArray<IZipFile>,\n  options?: ICreateZipOptions\n): Result<Uint8Array> {\n  return captureResult(() => {\n    const out: Record<string, Uint8Array> = {};\n    for (const f of files) {\n      const normalizedPath = f.path.replace(/^\\/+/, '');\n      out[normalizedPath] = typeof f.contents === 'string' ? strToU8(f.contents) : f.contents;\n    }\n    return zipSync(out, { level: options?.level ?? 6 });\n    /* c8 ignore next - defensive: zipSync only throws on internal library errors */\n  }).withErrorFormat((e) => `Failed to create zip: ${e}`);\n}\n"]}