@fgv/ts-extras 5.0.0-9 → 5.0.1-0

package/CHANGELOG.json

@@ -1,17 +1,23 @@
 {
   "name": "@fgv/ts-extras",
   "entries": [
+    {
+      "version": "5.0.1",
+      "tag": "@fgv/ts-extras_v5.0.1",
+      "date": "Tue, 23 Sep 2025 03:13:55 GMT",
+      "comments": {}
+    },
     {
       "version": "5.0.0",
       "tag": "@fgv/ts-extras_v5.0.0",
-      "date": "Thu, 17 Jul 2025 00:13:24 GMT",
+      "date": "Tue, 23 Sep 2025 02:54:20 GMT",
       "comments": {
         "none": [
           {
-            "comment": "upgrade dependencies"
+            "comment": "New zip file tree accessors allow FileTree operations on zip files"
           },
           {
-            "comment": "bump version"
+            "comment": "update rushstack"
           }
         ]
       }

package/dist/ts-extras.d.ts

@@ -1,7 +1,8 @@
 import { Conversion } from '@fgv/ts-utils';
 import { Converter } from '@fgv/ts-utils';
-import { FileTree } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
 import { Hash as Hash_2 } from '@fgv/ts-utils';
+import { JsonValue } from '@fgv/ts-json-base';
 import { Result } from '@fgv/ts-utils';
 import { Validator } from '@fgv/ts-utils';
 
@@ -18,8 +19,10 @@ export { Converters }
 
 declare namespace Csv {
     export {
+        parseCsvString,
+        CsvOptions,
         readCsvFileSync,
-        CsvOptions
+        readCsvFromTree
     }
 }
 export { Csv }
@@ -238,6 +241,15 @@ declare class Md5Normalizer extends Hash_2.HashingNormalizer {
     static md5Hash(parts: string[]): string;
 }
 
+/**
+ * Parses CSV data from a string.
+ * @param body - The CSV string to parse.
+ * @param options - optional parameters to control the processing
+ * @returns The parsed CSV data.
+ * @beta
+ */
+declare function parseCsvString(body: string, options?: CsvOptions): Result<unknown>;
+
 /**
  * Reads a record-jar from an array of strings, each of which represents one
  * line in the source file.
@@ -391,6 +403,16 @@ declare function rangeTypeOf<T, RT extends RangeOf<T>, TC = unknown>(converter:
  */
 declare function readCsvFileSync(srcPath: string, options?: CsvOptions): Result<unknown>;
 
+/**
+ * Reads a CSV file from a FileTree.
+ * @param fileTree - The FileTree to read from.
+ * @param filePath - Path of the file within the tree.
+ * @param options - optional parameters to control the processing
+ * @returns The parsed CSV data.
+ * @beta
+ */
+declare function readCsvFromTree(fileTree: FileTree.FileTree, filePath: string, options?: CsvOptions): Result<unknown>;
+
 /**
  * Reads a record-jar file from a supplied path.
  * @param srcPath - Source path from which the file is read.
@@ -401,13 +423,25 @@ declare function readCsvFileSync(srcPath: string, options?: CsvOptions): Result<
  */
 declare function readRecordJarFileSync(srcPath: string, options?: JarRecordParserOptions): Result<JarRecord[]>;
 
+/**
+ * Reads a record-jar file from a FileTree.
+ * @param fileTree - The FileTree to read from.
+ * @param filePath - Path of the file within the tree.
+ * @param options - Optional parser configuration
+ * @returns The contents of the file as an array of `Record<string, string>`
+ * @see https://datatracker.ietf.org/doc/html/draft-phillips-record-jar-01
+ * @public
+ */
+declare function readRecordJarFromTree(fileTree: FileTree.FileTree, filePath: string, options?: JarRecordParserOptions): Result<JarRecord[]>;
+
 declare namespace RecordJar {
     export {
         parseRecordJarLines,
-        readRecordJarFileSync,
         JarRecord,
         JarFieldPicker,
-        JarRecordParserOptions
+        JarRecordParserOptions,
+        readRecordJarFileSync,
+        readRecordJarFromTree
     }
 }
 export { RecordJar }
@@ -428,7 +462,7 @@ declare function templateString(defaultContext?: unknown): Conversion.StringConv
  * Implementation of `IFileTreeDirectoryItem` for directories in a ZIP archive.
  * @public
  */
-declare class ZipDirectoryItem implements FileTree.IFileTreeDirectoryItem {
+declare class ZipDirectoryItem<TCT extends string = string> implements FileTree.IFileTreeDirectoryItem<TCT> {
     /**
      * Indicates that this `FileTree.FileTreeItem` is a directory.
      */
@@ -450,18 +484,18 @@ declare class ZipDirectoryItem implements FileTree.IFileTreeDirectoryItem {
      * @param directoryPath - The path of the directory within the ZIP.
      * @param accessors - The ZIP file tree accessors.
      */
-    constructor(directoryPath: string, accessors: ZipFileTreeAccessors);
+    constructor(directoryPath: string, accessors: ZipFileTreeAccessors<TCT>);
     /**
      * Gets the children of the directory.
      */
-    getChildren(): Result<ReadonlyArray<FileTree.FileTreeItem>>;
+    getChildren(): Result<ReadonlyArray<FileTree.FileTreeItem<TCT>>>;
 }
 
 /**
  * Implementation of `FileTree.IFileTreeFileItem` for files in a ZIP archive.
  * @public
  */
-declare class ZipFileItem implements FileTree.IFileTreeFileItem {
+declare class ZipFileItem<TCT extends string = string> implements FileTree.IFileTreeFileItem<TCT> {
     /**
      * Indicates that this `FileTree.FileTreeItem` is a file.
      */
@@ -482,6 +516,10 @@ declare class ZipFileItem implements FileTree.IFileTreeFileItem {
      * The extension of the file
      */
     readonly extension: string;
+    /**
+     * The content type of the file.
+     */
+    get contentType(): TCT | undefined;
     /**
      * The pre-loaded contents of the file.
      */
@@ -490,17 +528,30 @@ declare class ZipFileItem implements FileTree.IFileTreeFileItem {
      * The ZIP file tree accessors that created this item.
      */
     private readonly _accessors;
+    /**
+     * Mutable content type of the file.
+     */
+    private _contentType;
+    /**
+     * Flag to track if content type should be inferred on first access.
+     */
+    private _shouldInferContentType;
     /**
      * Constructor for ZipFileItem.
      * @param zipFilePath - The path of the file within the ZIP.
      * @param contents - The pre-loaded contents of the file.
      * @param accessors - The ZIP file tree accessors.
      */
-    constructor(zipFilePath: string, contents: string, accessors: ZipFileTreeAccessors);
+    constructor(zipFilePath: string, contents: string, accessors: ZipFileTreeAccessors<TCT>);
+    /**
+     * Sets the content type of the file.
+     * @param contentType - The content type of the file.
+     */
+    setContentType(contentType: TCT | undefined): void;
     /**
      * Gets the contents of the file as parsed JSON.
      */
-    getContents(): Result<unknown>;
+    getContents(): Result<JsonValue>;
     getContents<T>(converter: Validator<T> | Converter<T>): Result<T>;
     /**
      * Gets the raw contents of the file as a string.
@@ -521,39 +572,74 @@ export { ZipFileTree }
  * File tree accessors for ZIP archives.
  * @public
  */
-declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors {
+declare class ZipFileTreeAccessors<TCT extends string = string> implements FileTree.IFileTreeAccessors<TCT> {
     /**
-     * The AdmZip instance containing the archive.
+     * The unzipped file data.
      */
-    private readonly _zip;
+    private readonly _files;
     /**
      * Optional prefix to prepend to paths.
      */
     private readonly _prefix;
+    /**
+     * Content type inference function.
+     */
+    private readonly _inferContentType;
     /**
      * Cache of all items in the ZIP for efficient lookups.
      */
     private readonly _itemCache;
     /**
      * Constructor for ZipFileTreeAccessors.
-     * @param zip - The AdmZip instance.
-     * @param prefix - Optional prefix to prepend to paths.
+     * @param files - The unzipped file data from fflate.
+     * @param params - Optional initialization parameters.
      */
     private constructor();
     /**
-     * Creates a new ZipFileTreeAccessors instance from a ZIP file buffer.
+     * Default function to infer the content type of a file.
+     * @param filePath - The path of the file.
+     * @param provided - Optional supplied content type.
+     * @returns `Success` with the content type of the file if successful, or
+     * `Failure` with an error message otherwise.
+     * @remarks This default implementation always returns `Success` with `undefined`.
+     * @public
+     */
+    static defaultInferContentType<TCT extends string = string>(__filePath: string, __provided?: string): Result<TCT | undefined>;
+    /**
+     * Creates a new ZipFileTreeAccessors instance from a ZIP file buffer (synchronous).
      * @param zipBuffer - The ZIP file as an ArrayBuffer or Uint8Array.
      * @param prefix - Optional prefix to prepend to paths.
      * @returns Result containing the ZipFileTreeAccessors instance.
      */
-    static fromBuffer(zipBuffer: ArrayBuffer | Uint8Array, prefix?: string): Result<ZipFileTreeAccessors>;
+    static fromBuffer<TCT extends string = string>(zipBuffer: ArrayBuffer | Uint8Array, prefix?: string): Result<ZipFileTreeAccessors<TCT>>;
+    /**
+     * Creates a new ZipFileTreeAccessors instance from a ZIP file buffer (synchronous).
+     * @param zipBuffer - The ZIP file as an ArrayBuffer or Uint8Array.
+     * @param params - Optional initialization parameters.
+     * @returns Result containing the ZipFileTreeAccessors instance.
+     */
+    static fromBuffer<TCT extends string = string>(zipBuffer: ArrayBuffer | Uint8Array, params?: FileTree.IFileTreeInitParams<TCT>): Result<ZipFileTreeAccessors<TCT>>;
+    /**
+     * Creates a new ZipFileTreeAccessors instance from a ZIP file buffer (asynchronous).
+     * @param zipBuffer - The ZIP file as an ArrayBuffer or Uint8Array.
+     * @param prefix - Optional prefix to prepend to paths.
+     * @returns Promise containing Result with the ZipFileTreeAccessors instance.
+     */
+    static fromBufferAsync<TCT extends string = string>(zipBuffer: ArrayBuffer | Uint8Array, prefix?: string): Promise<Result<ZipFileTreeAccessors<TCT>>>;
+    /**
+     * Creates a new ZipFileTreeAccessors instance from a ZIP file buffer (asynchronous).
+     * @param zipBuffer - The ZIP file as an ArrayBuffer or Uint8Array.
+     * @param params - Optional initialization parameters.
+     * @returns Promise containing Result with the ZipFileTreeAccessors instance.
+     */
+    static fromBufferAsync<TCT extends string = string>(zipBuffer: ArrayBuffer | Uint8Array, params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<ZipFileTreeAccessors<TCT>>>;
     /**
      * Creates a new ZipFileTreeAccessors instance from a File object (browser environment).
      * @param file - The File object containing ZIP data.
-     * @param prefix - Optional prefix to prepend to paths.
+     * @param params - Optional initialization parameters.
      * @returns Result containing the ZipFileTreeAccessors instance.
      */
-    static fromFile(file: File, prefix?: string): Promise<Result<ZipFileTreeAccessors>>;
+    static fromFile<TCT extends string = string>(file: File, params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<ZipFileTreeAccessors<TCT>>>;
     /**
      * Builds the cache of all items in the ZIP archive.
      */
@@ -577,15 +663,19 @@ declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors {
     /**
      * Gets an item from the file tree.
      */
-    getItem(path: string): Result<FileTree.FileTreeItem>;
+    getItem(path: string): Result<FileTree.FileTreeItem<TCT>>;
     /**
      * Gets the contents of a file in the file tree.
      */
     getFileContents(path: string): Result<string>;
+    /**
+     * Gets the content type of a file in the file tree.
+     */
+    getFileContentType(path: string, provided?: string): Result<TCT | undefined>;
     /**
      * Gets the children of a directory in the file tree.
      */
-    getChildren(path: string): Result<ReadonlyArray<FileTree.FileTreeItem>>;
+    getChildren(path: string): Result<ReadonlyArray<FileTree.FileTreeItem<TCT>>>;
     /**
      * Checks if childPath is a direct child of parentPath.
      */

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.49.1"
+      "packageVersion": "7.52.12"
     }
   ]
 }

package/eslint.config.js

@@ -0,0 +1,16 @@
+// ESLint 9 flat config
+const nodeProfile = require('@rushstack/eslint-config/flat/profile/node');
+const packletsPlugin = require('@rushstack/eslint-config/flat/mixins/packlets');
+const tsdocPlugin = require('@rushstack/eslint-config/flat/mixins/tsdoc');
+
+module.exports = [
+  ...nodeProfile,
+  packletsPlugin,
+  ...tsdocPlugin,
+  {
+    // Override specific rules if needed
+    rules: {
+      '@rushstack/packlets/mechanics': 'warn'
+    }
+  }
+];

package/lib/index.browser.d.ts

@@ -0,0 +1,6 @@
+import * as Experimental from './packlets/experimental';
+import * as Hash from './packlets/hash/index.browser';
+import * as ZipFileTree from './packlets/zip-file-tree';
+import { Converters } from './packlets/conversion';
+export { Converters, Experimental, Hash, ZipFileTree };
+//# sourceMappingURL=index.browser.d.ts.map

package/lib/index.browser.js

@@ -0,0 +1,69 @@
+"use strict";
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZipFileTree = exports.Hash = exports.Experimental = exports.Converters = void 0;
+/* c8 ignore start - Browser-specific export used conditionally in package.json */
+const Experimental = __importStar(require("./packlets/experimental"));
+exports.Experimental = Experimental;
+// eslint-disable-next-line @rushstack/packlets/mechanics
+const Hash = __importStar(require("./packlets/hash/index.browser"));
+exports.Hash = Hash;
+const ZipFileTree = __importStar(require("./packlets/zip-file-tree"));
+exports.ZipFileTree = ZipFileTree;
+const conversion_1 = require("./packlets/conversion");
+Object.defineProperty(exports, "Converters", { enumerable: true, get: function () { return conversion_1.Converters; } });
+/* c8 ignore stop */
+//# sourceMappingURL=index.browser.js.map

package/lib/packlets/csv/csvFileHelpers.d.ts

@@ -0,0 +1,21 @@
+import { Result } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { CsvOptions } from './csvHelpers';
+/**
+ * Reads a CSV file from a supplied path.
+ * @param srcPath - Source path from which the file is read.
+ * @param options - optional parameters to control the processing
+ * @returns The contents of the file.
+ * @beta
+ */
+export declare function readCsvFileSync(srcPath: string, options?: CsvOptions): Result<unknown>;
+/**
+ * Reads a CSV file from a FileTree.
+ * @param fileTree - The FileTree to read from.
+ * @param filePath - Path of the file within the tree.
+ * @param options - optional parameters to control the processing
+ * @returns The parsed CSV data.
+ * @beta
+ */
+export declare function readCsvFromTree(fileTree: FileTree.FileTree, filePath: string, options?: CsvOptions): Result<unknown>;
+//# sourceMappingURL=csvFileHelpers.d.ts.map

package/lib/packlets/csv/csvFileHelpers.js

@@ -0,0 +1,92 @@
+"use strict";
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCsvFileSync = readCsvFileSync;
+exports.readCsvFromTree = readCsvFromTree;
+const ts_utils_1 = require("@fgv/ts-utils");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const csvHelpers_1 = require("./csvHelpers");
+/**
+ * Reads a CSV file from a supplied path.
+ * @param srcPath - Source path from which the file is read.
+ * @param options - optional parameters to control the processing
+ * @returns The contents of the file.
+ * @beta
+ */
+function readCsvFileSync(srcPath, options) {
+    return (0, ts_utils_1.captureResult)(() => {
+        const fullPath = path.resolve(srcPath);
+        return fs.readFileSync(fullPath, 'utf8').toString();
+    }).onSuccess((body) => {
+        return (0, csvHelpers_1.parseCsvString)(body, options);
+    });
+}
+/**
+ * Reads a CSV file from a FileTree.
+ * @param fileTree - The FileTree to read from.
+ * @param filePath - Path of the file within the tree.
+ * @param options - optional parameters to control the processing
+ * @returns The parsed CSV data.
+ * @beta
+ */
+function readCsvFromTree(fileTree, filePath, options) {
+    return fileTree
+        .getFile(filePath)
+        .onSuccess((file) => file.getRawContents())
+        .onSuccess((contents) => (0, csvHelpers_1.parseCsvString)(contents, options));
+}
+//# sourceMappingURL=csvFileHelpers.js.map

package/lib/packlets/csv/csvHelpers.d.ts

@@ -7,11 +7,11 @@ export interface CsvOptions {
     delimiter?: string;
 }
 /**
- * Reads a CSV file from a supplied path.
- * @param srcPath - Source path from which the file is read.
+ * Parses CSV data from a string.
+ * @param body - The CSV string to parse.
  * @param options - optional parameters to control the processing
- * @returns The contents of the file.
+ * @returns The parsed CSV data.
  * @beta
  */
-export declare function readCsvFileSync(srcPath: string, options?: CsvOptions): Result<unknown>;
+export declare function parseCsvString(body: string, options?: CsvOptions): Result<unknown>;
 //# sourceMappingURL=csvHelpers.d.ts.map

package/lib/packlets/csv/csvHelpers.js

@@ -20,58 +20,20 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readCsvFileSync = readCsvFileSync;
+exports.parseCsvString = parseCsvString;
 const ts_utils_1 = require("@fgv/ts-utils");
-const fs = __importStar(require("fs"));
 const papaparse_1 = require("papaparse");
-const path = __importStar(require("path"));
 /**
- * Reads a CSV file from a supplied path.
- * @param srcPath - Source path from which the file is read.
+ * Parses CSV data from a string.
+ * @param body - The CSV string to parse.
  * @param options - optional parameters to control the processing
- * @returns The contents of the file.
+ * @returns The parsed CSV data.
  * @beta
  */
-function readCsvFileSync(srcPath, options) {
+function parseCsvString(body, options) {
     return (0, ts_utils_1.captureResult)(() => {
-        const fullPath = path.resolve(srcPath);
-        const body = fs.readFileSync(fullPath, 'utf8').toString();
         options = options !== null && options !== void 0 ? options : {};
-        // eslint-disable-next-line
         return (0, papaparse_1.parse)(body, Object.assign({ transform: (s) => s.trim(), header: false, dynamicTyping: false, skipEmptyLines: 'greedy' }, options)).data.slice(1);
     });
 }

package/lib/packlets/csv/index.d.ts

@@ -1,2 +1,3 @@
 export * from './csvHelpers';
+export * from './csvFileHelpers';
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/csv/index.js

@@ -35,5 +35,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// Export tree-shakeable functions
 __exportStar(require("./csvHelpers"), exports);
+// Filesystem helpers in separate module for tree-shaking
+__exportStar(require("./csvFileHelpers"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/hash/index.browser.d.ts

@@ -0,0 +1,2 @@
+export * from './md5Normalizer.browser';
+//# sourceMappingURL=index.browser.d.ts.map

package/lib/packlets/hash/index.browser.js

@@ -0,0 +1,40 @@
+"use strict";
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Browser-safe hash exports - excludes Node.js crypto dependencies
+__exportStar(require("./md5Normalizer.browser"), exports);
+//# sourceMappingURL=index.browser.js.map

package/lib/packlets/hash/index.node.d.ts

@@ -0,0 +1,2 @@
+export * from './md5Normalizer';
+//# sourceMappingURL=index.node.d.ts.map