@fgv/ts-web-extras 5.0.1-8 → 5.0.1

package/dist/packlets/helpers/fileTreeHelpers.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+import { FileTree } from '@fgv/ts-json-base';
+import { FileApiTreeAccessors } from '../file-tree/fileApiTreeAccessors';
+/**
+ * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.
+ * @public
+ */
+export const defaultFileApiTreeInitParams = {
+    inferContentType: FileTree.FileItem.defaultAcceptContentType
+};
+/**
+ * Helper function to create a new FileTree instance
+ * from a browser FileList (e.g., from input[type="file"]).
+ * @param fileList - FileList from a file input element
+ * @param params - Optional `IFileTreeInitParams` for the file tree.
+ * @returns Promise resolving to a successful Result with the new FileTree instance
+ * if successful, or a failed Result with an error message otherwise
+ * @remarks The content type of the files is always `string` and the default
+ * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is
+ * used, so content type is derived from the mime type of the file, when
+ * available.
+ * @public
+ */
+export function fromFileList(fileList, params) {
+    params = Object.assign(Object.assign({}, defaultFileApiTreeInitParams), (params !== null && params !== void 0 ? params : {}));
+    return FileApiTreeAccessors.fromFileList(fileList, params);
+}
+/**
+ * Helper function to create a new FileTree instance
+ * from a directory upload with webkitRelativePath support.
+ * @param fileList - FileList from a directory upload (input with webkitdirectory)
+ * @param params - Optional `IFileTreeInitParams` for the file tree.
+ * @returns Promise resolving to a successful Result with the new FileTree instance
+ * if successful, or a failed Result with an error message otherwise
+ * @remarks The content type of the files is always `string` and the default
+ * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is
+ * is used, so content type is derived from the mime type of the file, when
+ * available.
+ * @public
+ */
+export function fromDirectoryUpload(fileList, params) {
+    params = Object.assign(Object.assign({}, defaultFileApiTreeInitParams), (params !== null && params !== void 0 ? params : {}));
+    return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);
+}
+/**
+ * Helper function to get the original File object from a FileList by path.
+ * @param fileList - The original FileList
+ * @param path - The path to the file
+ * @returns A successful Result with the File object if found,
+ * or a failed Result with an error message otherwise
+ * @public
+ */
+export function getOriginalFile(fileList, path) {
+    return FileApiTreeAccessors.getOriginalFile(fileList, path);
+}
+/**
+ * Helper function to extract metadata from a `FileList`.
+ * @param fileList - The `FileList` to extract metadata from
+ * @returns Array of {@link IFileMetadata | file metadata} objects
+ * @public
+ */
+export function extractFileListMetadata(fileList) {
+    return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));
+}
+/**
+ * Helper function to extract metadata from a `File`.
+ * @param file - The File to extract metadata from
+ * @returns {@link IFileMetadata | file metadata} object
+ * @public
+ */
+export function extractFileMetadata(file) {
+    return FileApiTreeAccessors.extractFileMetadata(file);
+}
+//# sourceMappingURL=fileTreeHelpers.js.map

package/dist/packlets/helpers/fileTreeHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTreeHelpers.js","sourceRoot":"","sources":["../../../src/packlets/helpers/fileTreeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAiB,MAAM,mCAAmC,CAAC;AAExF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAyC;IAChF,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,wBAAwB;CAC7D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,MAA6C;IAE7C,MAAM,mCAAQ,4BAA4B,GAAK,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAE,CAAC;IAChE,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,oBAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAU;IAC5C,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 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 { Result } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { FileApiTreeAccessors, IFileMetadata } from '../file-tree/fileApiTreeAccessors';\n\n/**\n * Default initialization parameters for a `FileTree` using {@link FileApiTreeAccessors}.\n * @public\n */\nexport const defaultFileApiTreeInitParams: FileTree.IFileTreeInitParams<string> = {\n  inferContentType: FileTree.FileItem.defaultAcceptContentType\n};\n\n/**\n * Helper function to create a new FileTree instance\n * from a browser FileList (e.g., from input[type=\"file\"]).\n * @param fileList - FileList from a file input element\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromFileList(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromFileList(fileList, params);\n}\n\n/**\n * Helper function to create a new FileTree instance\n * from a directory upload with webkitRelativePath support.\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n * @returns Promise resolving to a successful Result with the new FileTree instance\n * if successful, or a failed Result with an error message otherwise\n * @remarks The content type of the files is always `string` and the default\n * accept contentType function (`FileTree.FileItem.defaultAcceptContentType`) is\n * is used, so content type is derived from the mime type of the file, when\n * available.\n * @public\n */\nexport function fromDirectoryUpload(\n  fileList: FileList,\n  params?: FileTree.IFileTreeInitParams<string>\n): Promise<Result<FileTree.FileTree<string>>> {\n  params = { ...defaultFileApiTreeInitParams, ...(params ?? {}) };\n  return FileApiTreeAccessors.fromDirectoryUpload(fileList, params);\n}\n\n/**\n * Helper function to get the original File object from a FileList by path.\n * @param fileList - The original FileList\n * @param path - The path to the file\n * @returns A successful Result with the File object if found,\n * or a failed Result with an error message otherwise\n * @public\n */\nexport function getOriginalFile(fileList: FileList, path: string): Result<File> {\n  return FileApiTreeAccessors.getOriginalFile(fileList, path);\n}\n\n/**\n * Helper function to extract metadata from a `FileList`.\n * @param fileList - The `FileList` to extract metadata from\n * @returns Array of {@link IFileMetadata | file metadata} objects\n * @public\n */\nexport function extractFileListMetadata(fileList: FileList): Array<IFileMetadata> {\n  return Array.from(fileList).map((f) => FileApiTreeAccessors.extractFileMetadata(f));\n}\n\n/**\n * Helper function to extract metadata from a `File`.\n * @param file - The File to extract metadata from\n * @returns {@link IFileMetadata | file metadata} object\n * @public\n */\nexport function extractFileMetadata(file: File): IFileMetadata {\n  return FileApiTreeAccessors.extractFileMetadata(file);\n}\n"]}

package/dist/packlets/helpers/index.js

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+/**
+ * Tree-shakeable helper functions for browser-compatible file operations.
+ * @packageDocumentation
+ */
+export * as FileTreeHelpers from './fileTreeHelpers';
+//# sourceMappingURL=index.js.map

package/dist/packlets/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AAEH,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 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\n/**\n * Tree-shakeable helper functions for browser-compatible file operations.\n * @packageDocumentation\n */\n\nexport * as FileTreeHelpers from './fileTreeHelpers';\n"]}

package/dist/packlets/url-utils/index.js

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+/**
+ * URL parameter parsing utilities for web applications.
+ * @packageDocumentation
+ */
+export * from './urlParams';
+//# sourceMappingURL=index.js.map

package/dist/packlets/url-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/url-utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AAEH,cAAc,aAAa,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 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\n/**\n * URL parameter parsing utilities for web applications.\n * @packageDocumentation\n */\n\nexport * from './urlParams';\n"]}

package/dist/packlets/url-utils/urlParams.js

@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+/**
+ * Parses URL parameters and extracts configuration options
+ * @public
+ */
+export function parseUrlParameters() {
+    const params = new URLSearchParams(window.location.search);
+    const options = {};
+    // Parse string parameters
+    const input = params.get('input');
+    if (input) {
+        options.input = input;
+        // Set starting directory for input file picker
+        if (isFilePath(input)) {
+            options.inputStartDir = extractDirectoryPath(input);
+        }
+    }
+    const config = params.get('config');
+    if (config) {
+        options.config = config;
+        // Set starting directory for config file picker
+        if (isFilePath(config)) {
+            options.configStartDir = extractDirectoryPath(config);
+        }
+    }
+    const contextFilter = params.get('contextFilter');
+    if (contextFilter)
+        options.contextFilter = contextFilter;
+    const qualifierDefaults = params.get('qualifierDefaults');
+    if (qualifierDefaults)
+        options.qualifierDefaults = qualifierDefaults;
+    const resourceTypes = params.get('resourceTypes');
+    if (resourceTypes)
+        options.resourceTypes = resourceTypes;
+    // Parse numeric parameters
+    const maxDistance = params.get('maxDistance');
+    if (maxDistance) {
+        const parsed = parseInt(maxDistance, 10);
+        if (!isNaN(parsed))
+            options.maxDistance = parsed;
+    }
+    // Parse boolean parameters
+    const reduceQualifiers = params.get('reduceQualifiers');
+    if (reduceQualifiers === 'true')
+        options.reduceQualifiers = true;
+    const interactive = params.get('interactive');
+    if (interactive === 'true')
+        options.interactive = true;
+    // Parse ZIP loading parameters
+    const loadZip = params.get('loadZip');
+    if (loadZip === 'true')
+        options.loadZip = true;
+    const zipPath = params.get('zipPath');
+    if (zipPath)
+        options.zipPath = zipPath;
+    const zipFile = params.get('zipFile');
+    if (zipFile)
+        options.zipFile = zipFile;
+    return options;
+}
+/**
+ * Converts context filter token to context object
+ * Example: "language=en-US|territory=US" -\> \{ language: "en-US", territory: "US" \}
+ * @public
+ */
+export function parseContextFilter(contextFilter) {
+    const context = {};
+    const tokens = contextFilter.split('|');
+    for (const token of tokens) {
+        const [key, value] = token.split('=');
+        if (key && value) {
+            context[key.trim()] = value.trim();
+        }
+    }
+    return context;
+}
+/**
+ * Converts qualifier defaults token to structured format
+ * Example: "language=en-US,en-CA|territory=US" -\> \{ language: ["en-US", "en-CA"], territory: ["US"] \}
+ * @public
+ */
+export function parseQualifierDefaults(qualifierDefaults) {
+    const defaults = {};
+    const tokens = qualifierDefaults.split('|');
+    for (const token of tokens) {
+        const [key, values] = token.split('=');
+        if (key && values) {
+            defaults[key.trim()] = values.split(',').map((v) => v.trim());
+        }
+    }
+    return defaults;
+}
+/**
+ * Converts resource types string to array
+ * Example: "json,string" -\> ["json", "string"]
+ * @public
+ */
+export function parseResourceTypes(resourceTypes) {
+    return resourceTypes
+        .split(',')
+        .map((t) => t.trim())
+        .filter((t) => t.length > 0);
+}
+/**
+ * Extracts the directory path from a file or directory path
+ * If the path appears to be a directory (no extension), returns it as-is
+ * If the path appears to be a file, returns the parent directory
+ * @public
+ */
+export function extractDirectoryPath(path) {
+    if (!path)
+        return '';
+    // Normalize path separators
+    const normalizedPath = path.replace(/\\/g, '/');
+    // Check if it looks like a file (has an extension)
+    const parts = normalizedPath.split('/');
+    const lastPart = parts[parts.length - 1];
+    // If the last part has an extension, treat as file and return directory
+    if (lastPart.includes('.') && !lastPart.startsWith('.')) {
+        return parts.slice(0, -1).join('/') || '/';
+    }
+    // Otherwise, treat as directory
+    return normalizedPath;
+}
+/**
+ * Determines if a path appears to be a file (has extension) or directory
+ * @public
+ */
+export function isFilePath(path) {
+    if (!path)
+        return false;
+    const parts = path.split('/');
+    const lastPart = parts[parts.length - 1];
+    // Has extension and doesn't start with dot (hidden files)
+    return lastPart.includes('.') && !lastPart.startsWith('.');
+}
+//# sourceMappingURL=urlParams.js.map

package/dist/packlets/url-utils/urlParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlParams.js","sourceRoot":"","sources":["../../../src/packlets/url-utils/urlParams.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 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\n/**\n * Configuration options that can be passed via URL parameters\n * @public\n */\nexport interface IUrlConfigOptions {\n  /**\n   * Input file path\n   */\n  input?: string;\n\n  /**\n   * Configuration name or path\n   */\n  config?: string;\n\n  /**\n   * Context filter token (pipe-separated)\n   */\n  contextFilter?: string;\n\n  /**\n   * Qualifier defaults token (pipe-separated)\n   */\n  qualifierDefaults?: string;\n\n  /**\n   * Resource types filter (comma-separated)\n   */\n  resourceTypes?: string;\n\n  /**\n   * Maximum distance for language matching\n   */\n  maxDistance?: number;\n\n  /**\n   * Whether to reduce qualifiers\n   */\n  reduceQualifiers?: boolean;\n\n  /**\n   * Whether to launch in interactive mode\n   */\n  interactive?: boolean;\n\n  /**\n   * Starting directory for input file picker (derived from input path)\n   */\n  inputStartDir?: string;\n\n  /**\n   * Starting directory for config file picker (derived from config path)\n   */\n  configStartDir?: string;\n\n  /**\n   * Whether to use ZIP loading mode\n   */\n  loadZip?: boolean;\n\n  /**\n   * Path to ZIP file to load (for CLI-generated ZIPs)\n   */\n  zipPath?: string;\n\n  /**\n   * Name of ZIP file to load from Downloads (filename only)\n   */\n  zipFile?: string;\n}\n\n/**\n * Parses URL parameters and extracts configuration options\n * @public\n */\nexport function parseUrlParameters(): IUrlConfigOptions {\n  const params = new URLSearchParams(window.location.search);\n\n  const options: IUrlConfigOptions = {};\n\n  // Parse string parameters\n  const input = params.get('input');\n  if (input) {\n    options.input = input;\n    // Set starting directory for input file picker\n    if (isFilePath(input)) {\n      options.inputStartDir = extractDirectoryPath(input);\n    }\n  }\n\n  const config = params.get('config');\n  if (config) {\n    options.config = config;\n    // Set starting directory for config file picker\n    if (isFilePath(config)) {\n      options.configStartDir = extractDirectoryPath(config);\n    }\n  }\n\n  const contextFilter = params.get('contextFilter');\n  if (contextFilter) options.contextFilter = contextFilter;\n\n  const qualifierDefaults = params.get('qualifierDefaults');\n  if (qualifierDefaults) options.qualifierDefaults = qualifierDefaults;\n\n  const resourceTypes = params.get('resourceTypes');\n  if (resourceTypes) options.resourceTypes = resourceTypes;\n\n  // Parse numeric parameters\n  const maxDistance = params.get('maxDistance');\n  if (maxDistance) {\n    const parsed = parseInt(maxDistance, 10);\n    if (!isNaN(parsed)) options.maxDistance = parsed;\n  }\n\n  // Parse boolean parameters\n  const reduceQualifiers = params.get('reduceQualifiers');\n  if (reduceQualifiers === 'true') options.reduceQualifiers = true;\n\n  const interactive = params.get('interactive');\n  if (interactive === 'true') options.interactive = true;\n\n  // Parse ZIP loading parameters\n  const loadZip = params.get('loadZip');\n  if (loadZip === 'true') options.loadZip = true;\n\n  const zipPath = params.get('zipPath');\n  if (zipPath) options.zipPath = zipPath;\n\n  const zipFile = params.get('zipFile');\n  if (zipFile) options.zipFile = zipFile;\n\n  return options;\n}\n\n/**\n * Converts context filter token to context object\n * Example: \"language=en-US|territory=US\" -\\> \\{ language: \"en-US\", territory: \"US\" \\}\n * @public\n */\nexport function parseContextFilter(contextFilter: string): Record<string, string> {\n  const context: Record<string, string> = {};\n\n  const tokens = contextFilter.split('|');\n  for (const token of tokens) {\n    const [key, value] = token.split('=');\n    if (key && value) {\n      context[key.trim()] = value.trim();\n    }\n  }\n\n  return context;\n}\n\n/**\n * Converts qualifier defaults token to structured format\n * Example: \"language=en-US,en-CA|territory=US\" -\\> \\{ language: [\"en-US\", \"en-CA\"], territory: [\"US\"] \\}\n * @public\n */\nexport function parseQualifierDefaults(qualifierDefaults: string): Record<string, string[]> {\n  const defaults: Record<string, string[]> = {};\n\n  const tokens = qualifierDefaults.split('|');\n  for (const token of tokens) {\n    const [key, values] = token.split('=');\n    if (key && values) {\n      defaults[key.trim()] = values.split(',').map((v) => v.trim());\n    }\n  }\n\n  return defaults;\n}\n\n/**\n * Converts resource types string to array\n * Example: \"json,string\" -\\> [\"json\", \"string\"]\n * @public\n */\nexport function parseResourceTypes(resourceTypes: string): string[] {\n  return resourceTypes\n    .split(',')\n    .map((t) => t.trim())\n    .filter((t) => t.length > 0);\n}\n\n/**\n * Extracts the directory path from a file or directory path\n * If the path appears to be a directory (no extension), returns it as-is\n * If the path appears to be a file, returns the parent directory\n * @public\n */\nexport function extractDirectoryPath(path: string): string {\n  if (!path) return '';\n\n  // Normalize path separators\n  const normalizedPath = path.replace(/\\\\/g, '/');\n\n  // Check if it looks like a file (has an extension)\n  const parts = normalizedPath.split('/');\n  const lastPart = parts[parts.length - 1];\n\n  // If the last part has an extension, treat as file and return directory\n  if (lastPart.includes('.') && !lastPart.startsWith('.')) {\n    return parts.slice(0, -1).join('/') || '/';\n  }\n\n  // Otherwise, treat as directory\n  return normalizedPath;\n}\n\n/**\n * Determines if a path appears to be a file (has extension) or directory\n * @public\n */\nexport function isFilePath(path: string): boolean {\n  if (!path) return false;\n\n  const parts = path.split('/');\n  const lastPart = parts[parts.length - 1];\n\n  // Has extension and doesn't start with dot (hidden files)\n  return lastPart.includes('.') && !lastPart.startsWith('.');\n}\n"]}

package/dist/test/setupTests.js

@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+import { webcrypto } from 'crypto';
+import { TextEncoder, TextDecoder } from 'util';
+// Setup Web Crypto API using Node.js webcrypto
+Object.defineProperty(global, 'crypto', {
+    value: webcrypto,
+    writable: true,
+    configurable: true
+});
+// Setup TextEncoder/TextDecoder for Node environment
+Object.defineProperty(global, 'TextEncoder', {
+    value: TextEncoder,
+    writable: true,
+    configurable: true
+});
+Object.defineProperty(global, 'TextDecoder', {
+    value: TextDecoder,
+    writable: true,
+    configurable: true
+});
+// Mock DataTransfer for File API testing
+class MockDataTransfer {
+    constructor() {
+        const fileArray = [];
+        this.items = {
+            add: (file) => {
+                fileArray.push(file);
+                this.files = createFileList(fileArray);
+            }
+        };
+        this.files = createFileList([]);
+    }
+}
+function createFileList(files) {
+    const fileList = {
+        length: files.length,
+        item: (index) => files[index] || null,
+        [Symbol.iterator]: function* () {
+            for (const file of files) {
+                yield file;
+            }
+        }
+    };
+    for (let i = 0; i < files.length; i++) {
+        fileList[i] = files[i];
+    }
+    return fileList;
+}
+Object.defineProperty(global, 'DataTransfer', {
+    value: MockDataTransfer,
+    writable: true,
+    configurable: true
+});
+//# sourceMappingURL=setupTests.js.map

package/dist/test/setupTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTests.js","sourceRoot":"","sources":["../../src/test/setupTests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;IACtC,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE;IAC3C,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE;IAC3C,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC;AAEH,yCAAyC;AACzC,MAAM,gBAAgB;IAIpB;QACE,MAAM,SAAS,GAAW,EAAE,CAAC;QAE7B,IAAI,CAAC,KAAK,GAAG;YACX,GAAG,EAAE,CAAC,IAAU,EAAE,EAAE;gBAClB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;SACF,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI;QAC7C,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;KACF,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAA4C,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,QAA+B,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE;IAC5C,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 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 { webcrypto } from 'crypto';\nimport { TextEncoder, TextDecoder } from 'util';\n\n// Setup Web Crypto API using Node.js webcrypto\nObject.defineProperty(global, 'crypto', {\n  value: webcrypto,\n  writable: true,\n  configurable: true\n});\n\n// Setup TextEncoder/TextDecoder for Node environment\nObject.defineProperty(global, 'TextEncoder', {\n  value: TextEncoder,\n  writable: true,\n  configurable: true\n});\n\nObject.defineProperty(global, 'TextDecoder', {\n  value: TextDecoder,\n  writable: true,\n  configurable: true\n});\n\n// Mock DataTransfer for File API testing\nclass MockDataTransfer {\n  items: { add: (file: File) => void };\n  files: FileList;\n\n  constructor() {\n    const fileArray: File[] = [];\n\n    this.items = {\n      add: (file: File) => {\n        fileArray.push(file);\n        this.files = createFileList(fileArray);\n      }\n    };\n\n    this.files = createFileList([]);\n  }\n}\n\nfunction createFileList(files: File[]): FileList {\n  const fileList = {\n    length: files.length,\n    item: (index: number) => files[index] || null,\n    [Symbol.iterator]: function* () {\n      for (const file of files) {\n        yield file;\n      }\n    }\n  };\n\n  for (let i = 0; i < files.length; i++) {\n    (fileList as unknown as Record<number, File>)[i] = files[i];\n  }\n\n  return fileList as unknown as FileList;\n}\n\nObject.defineProperty(global, 'DataTransfer', {\n  value: MockDataTransfer,\n  writable: true,\n  configurable: true\n});\n"]}

package/dist/test/unit/browserHashProvider.test.js

@@ -0,0 +1,140 @@
+/*
+ * Copyright (c) 2025 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.
+ */
+import '@fgv/ts-utils-jest';
+import { BrowserHashProvider } from '../../packlets/crypto';
+describe('BrowserHashProvider', () => {
+    describe('hashString', () => {
+        test('successfully hashes a string with SHA-256', async () => {
+            const result = await BrowserHashProvider.hashString('test data', 'SHA-256');
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(typeof hash).toBe('string');
+                expect(hash).toMatch(/^[a-f0-9]{64}$/); // SHA-256 produces 64 hex characters
+            });
+        });
+        test('successfully hashes a string with SHA-1', async () => {
+            const result = await BrowserHashProvider.hashString('test data', 'SHA-1');
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(typeof hash).toBe('string');
+                expect(hash).toMatch(/^[a-f0-9]{40}$/); // SHA-1 produces 40 hex characters
+            });
+        });
+        test('successfully hashes a string with SHA-512', async () => {
+            const result = await BrowserHashProvider.hashString('test data', 'SHA-512');
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(typeof hash).toBe('string');
+                expect(hash).toMatch(/^[a-f0-9]{128}$/); // SHA-512 produces 128 hex characters
+            });
+        });
+        test('uses SHA-256 as default algorithm', async () => {
+            const result = await BrowserHashProvider.hashString('test data');
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(hash).toMatch(/^[a-f0-9]{64}$/); // SHA-256 produces 64 hex characters
+            });
+        });
+        test('produces consistent hash for same input', async () => {
+            const input = 'consistent input';
+            const result1 = await BrowserHashProvider.hashString(input);
+            const result2 = await BrowserHashProvider.hashString(input);
+            expect(result1).toSucceed();
+            expect(result2).toSucceed();
+            if (result1.isSuccess() && result2.isSuccess()) {
+                expect(result1.value).toBe(result2.value);
+            }
+        });
+        test('produces different hashes for different inputs', async () => {
+            const result1 = await BrowserHashProvider.hashString('input1');
+            const result2 = await BrowserHashProvider.hashString('input2');
+            expect(result1).toSucceed();
+            expect(result2).toSucceed();
+            if (result1.isSuccess() && result2.isSuccess()) {
+                expect(result1.value).not.toBe(result2.value);
+            }
+        });
+        test('handles empty string input', async () => {
+            const result = await BrowserHashProvider.hashString('');
+            expect(result).toSucceed();
+        });
+        test('handles unicode input', async () => {
+            const result = await BrowserHashProvider.hashString('🚀 Unicode test 测试');
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(hash).toMatch(/^[a-f0-9]{64}$/);
+            });
+        });
+        test('fails when crypto.subtle is unavailable', async () => {
+            const originalCrypto = global.crypto;
+            // @ts-ignore - Intentionally removing crypto for test
+            delete global.crypto;
+            const result = await BrowserHashProvider.hashString('test');
+            expect(result).toFailWith(/Hash computation failed/);
+            global.crypto = originalCrypto;
+        });
+        test('handles invalid algorithm gracefully', async () => {
+            const result = await BrowserHashProvider.hashString('test', 'INVALID-ALG');
+            expect(result).toFailWith(/Hash computation failed/);
+        });
+    });
+    describe('hashParts', () => {
+        test('hashes multiple parts with default separator', async () => {
+            const parts = ['part1', 'part2', 'part3'];
+            const result = await BrowserHashProvider.hashParts(parts);
+            expect(result).toSucceedAndSatisfy((hash) => {
+                expect(hash).toMatch(/^[a-f0-9]{64}$/);
+            });
+        });
+        test('hashes multiple parts with custom separator', async () => {
+            const parts = ['part1', 'part2', 'part3'];
+            const result1 = await BrowserHashProvider.hashParts(parts, 'SHA-256', '|');
+            const result2 = await BrowserHashProvider.hashParts(parts, 'SHA-256', ',');
+            expect(result1).toSucceed();
+            expect(result2).toSucceed();
+            if (result1.isSuccess() && result2.isSuccess()) {
+                expect(result1.value).not.toBe(result2.value);
+            }
+        });
+        test('produces same hash as hashString for joined parts', async () => {
+            const parts = ['a', 'b', 'c'];
+            const separator = '-';
+            const joined = parts.join(separator);
+            const partsResult = await BrowserHashProvider.hashParts(parts, 'SHA-256', separator);
+            const stringResult = await BrowserHashProvider.hashString(joined);
+            expect(partsResult).toSucceed();
+            expect(stringResult).toSucceed();
+            if (partsResult.isSuccess() && stringResult.isSuccess()) {
+                expect(partsResult.value).toBe(stringResult.value);
+            }
+        });
+        test('handles empty array', async () => {
+            const result = await BrowserHashProvider.hashParts([]);
+            expect(result).toSucceed();
+        });
+        test('handles single part', async () => {
+            const result = await BrowserHashProvider.hashParts(['single']);
+            const stringResult = await BrowserHashProvider.hashString('single');
+            expect(result).toSucceed();
+            expect(stringResult).toSucceed();
+            if (result.isSuccess() && stringResult.isSuccess()) {
+                expect(result.value).toBe(stringResult.value);
+            }
+        });
+    });
+});
+//# sourceMappingURL=browserHashProvider.test.js.map

package/dist/test/unit/browserHashProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserHashProvider.test.js","sourceRoot":"","sources":["../../../src/test/unit/browserHashProvider.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 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 '@fgv/ts-utils-jest';\nimport { BrowserHashProvider } from '../../packlets/crypto';\n\ndescribe('BrowserHashProvider', () => {\n  describe('hashString', () => {\n    test('successfully hashes a string with SHA-256', async () => {\n      const result = await BrowserHashProvider.hashString('test data', 'SHA-256');\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(typeof hash).toBe('string');\n        expect(hash).toMatch(/^[a-f0-9]{64}$/); // SHA-256 produces 64 hex characters\n      });\n    });\n\n    test('successfully hashes a string with SHA-1', async () => {\n      const result = await BrowserHashProvider.hashString('test data', 'SHA-1');\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(typeof hash).toBe('string');\n        expect(hash).toMatch(/^[a-f0-9]{40}$/); // SHA-1 produces 40 hex characters\n      });\n    });\n\n    test('successfully hashes a string with SHA-512', async () => {\n      const result = await BrowserHashProvider.hashString('test data', 'SHA-512');\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(typeof hash).toBe('string');\n        expect(hash).toMatch(/^[a-f0-9]{128}$/); // SHA-512 produces 128 hex characters\n      });\n    });\n\n    test('uses SHA-256 as default algorithm', async () => {\n      const result = await BrowserHashProvider.hashString('test data');\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(hash).toMatch(/^[a-f0-9]{64}$/); // SHA-256 produces 64 hex characters\n      });\n    });\n\n    test('produces consistent hash for same input', async () => {\n      const input = 'consistent input';\n      const result1 = await BrowserHashProvider.hashString(input);\n      const result2 = await BrowserHashProvider.hashString(input);\n      expect(result1).toSucceed();\n      expect(result2).toSucceed();\n      if (result1.isSuccess() && result2.isSuccess()) {\n        expect(result1.value).toBe(result2.value);\n      }\n    });\n\n    test('produces different hashes for different inputs', async () => {\n      const result1 = await BrowserHashProvider.hashString('input1');\n      const result2 = await BrowserHashProvider.hashString('input2');\n      expect(result1).toSucceed();\n      expect(result2).toSucceed();\n      if (result1.isSuccess() && result2.isSuccess()) {\n        expect(result1.value).not.toBe(result2.value);\n      }\n    });\n\n    test('handles empty string input', async () => {\n      const result = await BrowserHashProvider.hashString('');\n      expect(result).toSucceed();\n    });\n\n    test('handles unicode input', async () => {\n      const result = await BrowserHashProvider.hashString('🚀 Unicode test 测试');\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(hash).toMatch(/^[a-f0-9]{64}$/);\n      });\n    });\n\n    test('fails when crypto.subtle is unavailable', async () => {\n      const originalCrypto = global.crypto;\n      // @ts-ignore - Intentionally removing crypto for test\n      delete global.crypto;\n      const result = await BrowserHashProvider.hashString('test');\n      expect(result).toFailWith(/Hash computation failed/);\n      global.crypto = originalCrypto;\n    });\n\n    test('handles invalid algorithm gracefully', async () => {\n      const result = await BrowserHashProvider.hashString('test', 'INVALID-ALG');\n      expect(result).toFailWith(/Hash computation failed/);\n    });\n  });\n\n  describe('hashParts', () => {\n    test('hashes multiple parts with default separator', async () => {\n      const parts = ['part1', 'part2', 'part3'];\n      const result = await BrowserHashProvider.hashParts(parts);\n      expect(result).toSucceedAndSatisfy((hash) => {\n        expect(hash).toMatch(/^[a-f0-9]{64}$/);\n      });\n    });\n\n    test('hashes multiple parts with custom separator', async () => {\n      const parts = ['part1', 'part2', 'part3'];\n      const result1 = await BrowserHashProvider.hashParts(parts, 'SHA-256', '|');\n      const result2 = await BrowserHashProvider.hashParts(parts, 'SHA-256', ',');\n      expect(result1).toSucceed();\n      expect(result2).toSucceed();\n      if (result1.isSuccess() && result2.isSuccess()) {\n        expect(result1.value).not.toBe(result2.value);\n      }\n    });\n\n    test('produces same hash as hashString for joined parts', async () => {\n      const parts = ['a', 'b', 'c'];\n      const separator = '-';\n      const joined = parts.join(separator);\n      const partsResult = await BrowserHashProvider.hashParts(parts, 'SHA-256', separator);\n      const stringResult = await BrowserHashProvider.hashString(joined);\n      expect(partsResult).toSucceed();\n      expect(stringResult).toSucceed();\n      if (partsResult.isSuccess() && stringResult.isSuccess()) {\n        expect(partsResult.value).toBe(stringResult.value);\n      }\n    });\n\n    test('handles empty array', async () => {\n      const result = await BrowserHashProvider.hashParts([]);\n      expect(result).toSucceed();\n    });\n\n    test('handles single part', async () => {\n      const result = await BrowserHashProvider.hashParts(['single']);\n      const stringResult = await BrowserHashProvider.hashString('single');\n      expect(result).toSucceed();\n      expect(stringResult).toSucceed();\n      if (result.isSuccess() && stringResult.isSuccess()) {\n        expect(result.value).toBe(stringResult.value);\n      }\n    });\n  });\n});\n"]}