@fgv/ts-extras 5.0.0-30 → 5.0.0-31

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,7 +572,7 @@ 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 unzipped file data.
      */
@@ -530,6 +581,10 @@ declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors {
      * 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.
      */
@@ -537,30 +592,54 @@ declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors {
     /**
      * Constructor for ZipFileTreeAccessors.
      * @param files - The unzipped file data from fflate.
-     * @param prefix - Optional prefix to prepend to paths.
+     * @param params - Optional initialization parameters.
      */
     private constructor();
+    /**
+     * 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(zipBuffer: ArrayBuffer | Uint8Array, prefix?: string): Promise<Result<ZipFileTreeAccessors>>;
+    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.
      */
@@ -584,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/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,56 +20,19 @@
  * 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 : {};
         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/record-jar/index.d.ts

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

package/lib/packlets/record-jar/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("./recordJarHelpers"), exports);
+// Filesystem helpers in separate module for tree-shaking
+__exportStar(require("./recordJarFileHelpers"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/record-jar/recordJarFileHelpers.d.ts

@@ -0,0 +1,23 @@
+import { Result } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { JarRecord, JarRecordParserOptions } from './recordJarHelpers';
+/**
+ * Reads a record-jar file from a supplied path.
+ * @param srcPath - Source path from which the file is read.
+ * @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
+ */
+export 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
+ */
+export declare function readRecordJarFromTree(fileTree: FileTree.FileTree, filePath: string, options?: JarRecordParserOptions): Result<JarRecord[]>;
+//# sourceMappingURL=recordJarFileHelpers.d.ts.map

package/lib/packlets/record-jar/recordJarFileHelpers.js

@@ -0,0 +1,97 @@
+"use strict";
+/*
+ * Copyright (c) 2022 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.readRecordJarFileSync = readRecordJarFileSync;
+exports.readRecordJarFromTree = readRecordJarFromTree;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const recordJarHelpers_1 = require("./recordJarHelpers");
+/**
+ * Reads a record-jar file from a supplied path.
+ * @param srcPath - Source path from which the file is read.
+ * @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
+ */
+function readRecordJarFileSync(srcPath, options) {
+    return (0, ts_utils_1.captureResult)(() => {
+        const fullPath = path.resolve(srcPath);
+        return fs.readFileSync(fullPath, 'utf8').toString().split(/\r?\n/);
+    }).onSuccess((lines) => {
+        return (0, recordJarHelpers_1.parseRecordJarLines)(lines, options);
+    });
+}
+/**
+ * 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
+ */
+function readRecordJarFromTree(fileTree, filePath, options) {
+    return fileTree
+        .getFile(filePath)
+        .onSuccess((file) => file.getRawContents())
+        .onSuccess((contents) => {
+        const lines = contents.split(/\r?\n/);
+        return (0, recordJarHelpers_1.parseRecordJarLines)(lines, options);
+    });
+}
+//# sourceMappingURL=recordJarFileHelpers.js.map

package/lib/packlets/record-jar/recordJarHelpers.d.ts

@@ -25,13 +25,4 @@ export interface JarRecordParserOptions {
  * @public
  */
 export declare function parseRecordJarLines(lines: string[], options?: JarRecordParserOptions): Result<JarRecord[]>;
-/**
- * Reads a record-jar file from a supplied path.
- * @param srcPath - Source path from which the file is read.
- * @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
- */
-export declare function readRecordJarFileSync(srcPath: string, options?: JarRecordParserOptions): Result<JarRecord[]>;
 //# sourceMappingURL=recordJarHelpers.d.ts.map

package/lib/packlets/record-jar/recordJarHelpers.js

@@ -20,44 +20,8 @@
  * 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.parseRecordJarLines = parseRecordJarLines;
-exports.readRecordJarFileSync = readRecordJarFileSync;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const ts_utils_1 = require("@fgv/ts-utils");
 class RecordParser {
     constructor(options) {
@@ -252,20 +216,4 @@ class RecordParser {
 function parseRecordJarLines(lines, options) {
     return RecordParser.parse(lines, options);
 }
-/**
- * Reads a record-jar file from a supplied path.
- * @param srcPath - Source path from which the file is read.
- * @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
- */
-function readRecordJarFileSync(srcPath, options) {
-    return (0, ts_utils_1.captureResult)(() => {
-        const fullPath = path.resolve(srcPath);
-        return fs.readFileSync(fullPath, 'utf8').toString().split(/\r?\n/);
-    }).onSuccess((lines) => {
-        return parseRecordJarLines(lines, options);
-    });
-}
 //# sourceMappingURL=recordJarHelpers.js.map

package/lib/packlets/zip-file-tree/zipFileTreeAccessors.d.ts

@@ -1,9 +1,10 @@
-import { Result, Converter, Validator, FileTree } from '@fgv/ts-utils';
+import { Result, Converter, Validator } from '@fgv/ts-utils';
+import { FileTree, JsonValue } from '@fgv/ts-json-base';
 /**
  * Implementation of `FileTree.IFileTreeFileItem` for files in a ZIP archive.
  * @public
  */
-export declare class ZipFileItem implements FileTree.IFileTreeFileItem {
+export declare class ZipFileItem<TCT extends string = string> implements FileTree.IFileTreeFileItem<TCT> {
     /**
      * Indicates that this `FileTree.FileTreeItem` is a file.
      */
@@ -24,6 +25,10 @@ export 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.
      */
@@ -32,17 +37,30 @@ export 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.
@@ -53,7 +71,7 @@ export declare class ZipFileItem implements FileTree.IFileTreeFileItem {
  * Implementation of `IFileTreeDirectoryItem` for directories in a ZIP archive.
  * @public
  */
-export declare class ZipDirectoryItem implements FileTree.IFileTreeDirectoryItem {
+export declare class ZipDirectoryItem<TCT extends string = string> implements FileTree.IFileTreeDirectoryItem<TCT> {
     /**
      * Indicates that this `FileTree.FileTreeItem` is a directory.
      */
@@ -75,17 +93,17 @@ export 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>>>;
 }
 /**
  * File tree accessors for ZIP archives.
  * @public
  */
-export declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors {
+export declare class ZipFileTreeAccessors<TCT extends string = string> implements FileTree.IFileTreeAccessors<TCT> {
     /**
      * The unzipped file data.
      */
@@ -94,6 +112,10 @@ export declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors
      * 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.
      */
@@ -101,30 +123,54 @@ export declare class ZipFileTreeAccessors implements FileTree.IFileTreeAccessors
     /**
      * Constructor for ZipFileTreeAccessors.
      * @param files - The unzipped file data from fflate.
-     * @param prefix - Optional prefix to prepend to paths.
+     * @param params - Optional initialization parameters.
      */
     private constructor();
+    /**
+     * 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(zipBuffer: ArrayBuffer | Uint8Array, prefix?: string): Promise<Result<ZipFileTreeAccessors>>;
+    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.
      */
@@ -148,15 +194,19 @@ export 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/lib/packlets/zip-file-tree/zipFileTreeAccessors.js

@@ -29,6 +29,16 @@ const ts_utils_1 = require("@fgv/ts-utils");
  * @public
  */
 class ZipFileItem {
+    /**
+     * The content type of the file.
+     */
+    get contentType() {
+        if (this._contentType === undefined && this._shouldInferContentType) {
+            this._contentType = this._accessors.getFileContentType(this.absolutePath).orDefault();
+            this._shouldInferContentType = false;
+        }
+        return this._contentType;
+    }
     /**
      * Constructor for ZipFileItem.
      * @param zipFilePath - The path of the file within the ZIP.
@@ -40,6 +50,10 @@ class ZipFileItem {
          * Indicates that this `FileTree.FileTreeItem` is a file.
          */
         this.type = 'file';
+        /**
+         * Flag to track if content type should be inferred on first access.
+         */
+        this._shouldInferContentType = true;
         this._contents = contents;
         this._accessors = accessors;
         this.absolutePath = '/' + zipFilePath;
@@ -47,16 +61,25 @@ class ZipFileItem {
         this.extension = accessors.getExtension(zipFilePath);
         this.baseName = accessors.getBaseName(zipFilePath, this.extension);
     }
+    /**
+     * Sets the content type of the file.
+     * @param contentType - The content type of the file.
+     */
+    setContentType(contentType) {
+        this._contentType = contentType;
+        this._shouldInferContentType = false;
+    }
     getContents(converter) {
         return this.getRawContents()
             .onSuccess((contents) => {
-            return (0, ts_utils_1.captureResult)(() => {
-                const parsed = JSON.parse(contents);
+            return (0, ts_utils_1.captureResult)(() => JSON.parse(contents))
+                .onSuccess((parsed) => {
                 if (converter) {
                     return converter.convert(parsed);
                 }
                 return (0, ts_utils_1.succeed)(parsed);
-            }).onFailure(() => {
+            })
+                .onFailure(() => {
                 return (0, ts_utils_1.fail)(`Failed to parse JSON from file: ${this.absolutePath}`);
             });
         })
@@ -107,42 +130,45 @@ class ZipFileTreeAccessors {
     /**
      * Constructor for ZipFileTreeAccessors.
      * @param files - The unzipped file data from fflate.
-     * @param prefix - Optional prefix to prepend to paths.
+     * @param params - Optional initialization parameters.
      */
-    constructor(files, prefix) {
+    constructor(files, params) {
+        var _a;
         /**
          * Cache of all items in the ZIP for efficient lookups.
          */
         this._itemCache = new Map();
         this._files = files;
-        this._prefix = prefix || '';
+        this._prefix = (params === null || params === void 0 ? void 0 : params.prefix) || '';
+        this._inferContentType = (_a = params === null || params === void 0 ? void 0 : params.inferContentType) !== null && _a !== void 0 ? _a : ZipFileTreeAccessors.defaultInferContentType;
         this._buildItemCache();
     }
     /**
-     * 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.
+     * 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 fromBuffer(zipBuffer, prefix) {
+    static defaultInferContentType(__filePath, __provided) {
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    static fromBuffer(zipBuffer, params) {
         try {
             /* c8 ignore next 1 - defense in depth */
             const uint8Buffer = zipBuffer instanceof Uint8Array ? zipBuffer : new Uint8Array(zipBuffer);
             const files = (0, fflate_1.unzipSync)(uint8Buffer);
-            return (0, ts_utils_1.succeed)(new ZipFileTreeAccessors(files, prefix));
+            const normalizedParams = typeof params === 'string' ? { prefix: params } : params;
+            return (0, ts_utils_1.succeed)(new ZipFileTreeAccessors(files, normalizedParams));
         }
         catch (error) {
             /* c8 ignore next 1 - defensive coding: fflate always throws Error objects in practice */
             return (0, ts_utils_1.fail)(`Failed to load ZIP archive: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    /**
-     * 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 async fromBufferAsync(zipBuffer, prefix) {
+    static async fromBufferAsync(zipBuffer, params) {
         return new Promise((resolve) => {
             try {
                 /* c8 ignore next 1 - defense in depth */
@@ -152,7 +178,8 @@ class ZipFileTreeAccessors {
                         resolve((0, ts_utils_1.fail)(`Failed to load ZIP archive: ${err.message}`));
                     }
                     else {
-                        resolve((0, ts_utils_1.succeed)(new ZipFileTreeAccessors(files, prefix)));
+                        const normalizedParams = typeof params === 'string' ? { prefix: params } : params;
+                        resolve((0, ts_utils_1.succeed)(new ZipFileTreeAccessors(files, normalizedParams)));
                     }
                 });
             }
@@ -165,13 +192,14 @@ class ZipFileTreeAccessors {
     /**
      * 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 async fromFile(file, prefix) {
+    static async fromFile(file, params) {
         try {
             const arrayBuffer = await file.arrayBuffer();
-            return await ZipFileTreeAccessors.fromBufferAsync(new Uint8Array(arrayBuffer), prefix);
+            const uint8Buffer = new Uint8Array(arrayBuffer);
+            return await ZipFileTreeAccessors.fromBufferAsync(uint8Buffer, params);
         }
         catch (error) {
             return (0, ts_utils_1.fail)(`Failed to read file: ${error instanceof Error ? error.message : String(error)}`);
@@ -275,6 +303,18 @@ class ZipFileTreeAccessors {
             return item.getRawContents();
         });
     }
+    /**
+     * Gets the content type of a file in the file tree.
+     */
+    getFileContentType(path, provided) {
+        // If provided contentType is given, use it directly (highest priority)
+        if (provided !== undefined) {
+            return (0, ts_utils_1.succeed)(provided);
+        }
+        // For files that exist in the ZIP, we don't store explicit contentType
+        // so we always fall back to inference
+        return this._inferContentType(path);
+    }
     /**
      * Gets the children of a directory in the file tree.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-extras",
-  "version": "5.0.0-30",
+  "version": "5.0.0-31",
   "description": "Assorted Typescript Utilities",
   "main": "lib/index.js",
   "types": "dist/ts-extras.d.ts",
@@ -45,17 +45,18 @@
     "@types/heft-jest": "1.0.6",
     "@rushstack/heft-jest-plugin": "0.16.13",
     "eslint-plugin-tsdoc": "~0.4.0",
-    "@fgv/ts-utils-jest": "5.0.0-30",
-    "@fgv/ts-utils": "5.0.0-30"
+    "@fgv/ts-utils": "5.0.0-31",
+    "@fgv/ts-utils-jest": "5.0.0-31"
   },
   "dependencies": {
     "luxon": "^3.7.2",
     "mustache": "^4.2.0",
     "papaparse": "^5.4.1",
-    "fflate": "~0.8.2"
+    "fflate": "~0.8.2",
+    "@fgv/ts-json-base": "5.0.0-31"
   },
   "peerDependencies": {
-    "@fgv/ts-utils": "5.0.0-30"
+    "@fgv/ts-utils": "5.0.0-31"
   },
   "scripts": {
     "build": "heft test --clean",