@fgv/ts-res 5.1.0-2 → 5.1.0-20

package/dist/packlets/zip-archive/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEzB,4EAA4E;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,+EAA+E;AAC/E,iEAAiE;AACjE,6EAA6E","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 * Browser-safe ZIP archive functionality for ts-res source file archives\n *\n * This packlet provides consolidated ZIP archive creation and loading functionality\n * for source files, compatible with browsers using fflate.\n *\n * @remarks\n * ZIP archives contain source files for resource ingestion with directory\n * structure preserved and optional validation but no processing or transformation.\n * This is distinct from ZIP bundles which contain processed resource output.\n *\n * ZipArchiveCreator supports browser usage when FileTreeItems are provided directly.\n * Methods accepting file paths require Node.js fs access and should not be called in browser.\n *\n * ZipArchiveLoader is fully browser-compatible and works with File API or ArrayBuffer.\n *\n * @packageDocumentation\n */\n\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n// Namespaces\nexport { Json, Convert };\n\n// Core classes (browser-compatible when used with FileTreeItems or buffers)\nexport { ZipArchiveCreator } from './zipArchiveCreator';\nexport { ZipArchiveLoader } from './zipArchiveLoader';\n\n// Types and interfaces\nexport type {\n  IZipArchivePathOptions,\n  IZipArchiveFileTreeOptions,\n  ZipArchiveOptions,\n  IZipArchiveResult,\n  IZipArchiveManifest,\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  IImportedFile,\n  IImportedDirectory,\n  ZipArchiveProgressCallback\n} from './types';\n\n// Format utilities\nexport {\n  createZipArchiveManifest,\n  parseZipArchiveManifest,\n  validateZipArchiveManifest,\n  parseZipArchiveConfiguration,\n  generateZipArchiveFilename,\n  normalizePath,\n  getDirectoryName,\n  sanitizeFilename,\n  isZipFile\n} from './zipArchiveFormat';\n\n// Constants\nexport { ZipArchiveConstants } from './types';\n\n// Note: ZipArchiveCreator._getInputFileTreeItem() and _getConfigFileTreeItem()\n// use FileTree.forFilesystem() internally when given file paths.\n// In browser, provide FileTreeItems directly via IZipArchiveFileTreeOptions.\n"]}

package/dist/packlets/zip-archive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEzB,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,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 * ZIP archive functionality for ts-res source file archives\n *\n * This packlet provides consolidated ZIP archive creation and loading functionality\n * for source files, compatible with existing tools while using fflate for\n * universal browser compatibility.\n *\n * @remarks\n * ZIP archives contain source files for resource ingestion with directory\n * structure preserved and optional validation but no processing or transformation.\n * This is distinct from ZIP bundles which contain processed resource output.\n *\n * @packageDocumentation\n */\n\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n// Namespaces\nexport { Json, Convert };\n\n// Core classes\nexport { ZipArchiveCreator } from './zipArchiveCreator';\nexport { ZipArchiveLoader } from './zipArchiveLoader';\n\n// Types and interfaces\nexport type {\n  IZipArchivePathOptions,\n  IZipArchiveFileTreeOptions,\n  ZipArchiveOptions,\n  IZipArchiveResult,\n  IZipArchiveManifest,\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  IImportedFile,\n  IImportedDirectory,\n  ZipArchiveProgressCallback\n} from './types';\n\n// Format utilities\nexport {\n  createZipArchiveManifest,\n  parseZipArchiveManifest,\n  validateZipArchiveManifest,\n  parseZipArchiveConfiguration,\n  generateZipArchiveFilename,\n  normalizePath,\n  getDirectoryName,\n  sanitizeFilename,\n  isZipFile\n} from './zipArchiveFormat';\n\n// Constants\nexport { ZipArchiveConstants } from './types';\n"]}

package/dist/packlets/zip-archive/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 * JSON representation of ZIP archive input information\n * @public\n */\nexport interface IZipArchiveInputInfo {\n  /** Type of input (file or directory) */\n  type: 'file' | 'directory';\n  /** Original file/directory path */\n  originalPath: string;\n  /** Path within the archive (e.g., \"input/mydir\") */\n  archivePath: string;\n}\n\n/**\n * JSON representation of ZIP archive config information\n * @public\n */\nexport interface IZipArchiveConfigInfo {\n  /** Type of config (always 'file') */\n  type: 'file';\n  /** Original config file path */\n  originalPath: string;\n  /** Path within the archive (e.g., \"config.json\") */\n  archivePath: string;\n}\n\n/**\n * JSON representation of a ZIP archive manifest\n * Compatible with existing tools from ts-res-browser-cli\n * @public\n */\nexport interface IZipArchiveManifest {\n  /** Archive creation timestamp */\n  timestamp: string;\n\n  /** Optional input source information */\n  input?: IZipArchiveInputInfo;\n\n  /** Optional configuration file information */\n  config?: IZipArchiveConfigInfo;\n}\n\n/**\n * JSON representation of an imported file\n * @public\n */\nexport interface IImportedFile {\n  /** File name */\n  name: string;\n  /** Full path within archive */\n  path: string;\n  /** File content as string */\n  content: string;\n  /** MIME type */\n  type: string;\n}\n\n/**\n * JSON representation of an imported directory structure\n * @public\n */\nexport interface IImportedDirectory {\n  /** Directory name */\n  name: string;\n  /** Files in this directory */\n  files: IImportedFile[];\n  /** Subdirectories */\n  subdirectories: IImportedDirectory[];\n}\n"]}

package/dist/packlets/zip-archive/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA2GH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,yBAAyB;IACzB,aAAa,EAAE,eAAe;IAC9B,8BAA8B;IAC9B,WAAW,EAAE,aAAa;IAC1B,4BAA4B;IAC5B,SAAS,EAAE,OAAO;IAClB,oCAAoC;IACpC,UAAU,EAAE,QAAQ;CACZ,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 { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport {} from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n\n/**\n * Options for creating a ZIP archive buffer\n * @public\n */\nexport interface IZipArchivePathOptions {\n  /** File or directory path to include in the archive */\n  inputPath?: string;\n  /** Optional configuration file path */\n  configPath?: string;\n}\n\n/**\n * Options for creating a ZIP archive buffer from a file tree\n * @public\n */\nexport interface IZipArchiveFileTreeOptions {\n  /** Input file or directory */\n  inputItem?: FileTree.FileTreeItem;\n  /** Optional configuration file */\n  configItem?: FileTree.IFileTreeFileItem;\n}\n\n/**\n * Options for creating a ZIP archive buffer\n * @public\n */\nexport type ZipArchiveOptions = IZipArchivePathOptions | IZipArchiveFileTreeOptions;\n\n/**\n * Standardized ZIP archive manifest format (compatible with existing tools)\n * @public\n */\nexport type IZipArchiveManifest = Json.IZipArchiveManifest;\n\n/**\n * Result of ZIP archive buffer creation\n * @public\n */\nexport interface IZipArchiveResult {\n  /** Raw ZIP data buffer */\n  zipBuffer: Uint8Array;\n  /** Archive manifest with metadata */\n  manifest: IZipArchiveManifest;\n  /** Total ZIP size in bytes */\n  size: number;\n}\n\n/**\n * Options for loading a ZIP archive\n * @public\n */\nexport interface IZipArchiveLoadOptions {\n  /** Validate manifest strictly */\n  strictManifestValidation?: boolean;\n}\n\n/**\n * Result of ZIP archive loading\n * @public\n */\nexport interface IZipArchiveLoadResult {\n  /** Parsed archive manifest */\n  manifest: IZipArchiveManifest | undefined;\n  /** Loaded configuration */\n  config: ConfigModel.ISystemConfiguration | undefined;\n  /** All files extracted from the archive */\n  files: IImportedFile[];\n  /** Directory structure if available */\n  directory: IImportedDirectory | undefined;\n}\n\n/**\n * Imported file representation\n * @public\n */\nexport type IImportedFile = Json.IImportedFile;\n\n/**\n * Imported directory structure\n * @public\n */\nexport type IImportedDirectory = Json.IImportedDirectory;\n\n/**\n * Progress callback for ZIP operations\n * @public\n */\nexport type ZipArchiveProgressCallback = (\n  stage:\n    | 'reading-file'\n    | 'parsing-zip'\n    | 'loading-manifest'\n    | 'loading-config'\n    | 'extracting-files'\n    | 'processing-resources'\n    | 'creating-zip',\n  progress: number, // 0-100\n  details: string\n) => void;\n\n/**\n * Constants for ZIP archive structure\n * @public\n */\nexport const ZipArchiveConstants = {\n  /** Manifest file name */\n  MANIFEST_FILE: 'manifest.json',\n  /** Configuration file name */\n  CONFIG_FILE: 'config.json',\n  /** Input files directory */\n  INPUT_DIR: 'input',\n  /** Configuration files directory */\n  CONFIG_DIR: 'config'\n} as const;\n"]}

package/dist/packlets/zip-archive/zipArchiveCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveCreator.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveCreator.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 { zipSync } from 'fflate';\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport type { IZipArchiveResult, ZipArchiveOptions, ZipArchiveProgressCallback } from './types';\nimport { normalizePath } from './zipArchiveFormat';\nimport * as Json from './json';\n\n/**\n * ZIP archive creator using fflate for universal compatibility\n * @public\n */\nexport class ZipArchiveCreator {\n  /**\n   * Create a ZIP archive buffer from a supplied buffer\n   * @param options - Input paths and configuration\n   * @param onProgress - Optional progress callback\n   * @returns Result containing ZIP buffer and manifest\n   */\n  public async createFromBuffer(\n    options: ZipArchiveOptions,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveResult>> {\n    try {\n      onProgress?.('creating-zip', 0, 'Starting ZIP archive creation');\n\n      const files: Record<string, Uint8Array> = {};\n      const manifest: Json.IZipArchiveManifest = {\n        timestamp: new Date().toISOString()\n      };\n\n      const { value: inputItem, message: inputItemError } = this._getInputFileTreeItem(options);\n      if (inputItemError !== undefined) {\n        return fail(inputItemError);\n      }\n\n      if (inputItem !== undefined) {\n        onProgress?.('reading-file', 10, `Processing input: ${inputItem.absolutePath}`);\n\n        if (inputItem.type === 'directory') {\n          // Add entire directory recursively, preserving structure\n          const archivePath = `input/${inputItem.name}`;\n\n          const addDirResult = await this._addDirectoryTreeToZip(files, inputItem, archivePath, onProgress);\n          /* c8 ignore next 3 - defense in depth against internal error */\n          if (addDirResult.isFailure()) {\n            return fail(addDirResult.message);\n          }\n\n          manifest.input = {\n            type: 'directory',\n            originalPath: inputItem.absolutePath,\n            archivePath\n          };\n        } else if (inputItem.type === 'file') {\n          // Add single file\n          const archivePath = `input/${inputItem.name}`;\n\n          const addFileResult = await this._addFileTreeItemToZip(files, inputItem, archivePath);\n          /* c8 ignore next 3 - defense in depth against internal error */\n          if (addFileResult.isFailure()) {\n            return fail(addFileResult.message);\n          }\n\n          manifest.input = {\n            type: 'file',\n            originalPath: inputItem.absolutePath,\n            archivePath\n          };\n        }\n      }\n\n      const { value: configItem, message: configItemError } = this._getConfigFileTreeItem(options);\n      if (configItemError !== undefined) {\n        return fail(configItemError);\n      }\n\n      if (configItem !== undefined) {\n        onProgress?.('reading-file', 40, `Processing config: ${configItem.absolutePath}`);\n\n        const archivePath = `config/${configItem.name}`;\n\n        const addConfigResult = await this._addFileTreeItemToZip(files, configItem, archivePath);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addConfigResult.isFailure()) {\n          return fail(addConfigResult.message);\n        }\n\n        // Update manifest with config info\n        manifest.config = {\n          type: 'file',\n          originalPath: configItem.absolutePath,\n          archivePath\n        };\n      }\n\n      // Add manifest to ZIP\n      onProgress?.('creating-zip', 70, 'Adding manifest');\n      const manifestJson = JSON.stringify(manifest, null, 2);\n      files['manifest.json'] = new TextEncoder().encode(manifestJson);\n\n      // Create ZIP buffer using fflate\n      onProgress?.('creating-zip', 80, 'Compressing files');\n      const zipBuffer = zipSync(files, { level: 6 });\n\n      const result: IZipArchiveResult = {\n        zipBuffer,\n        manifest,\n        size: zipBuffer.length\n      };\n\n      onProgress?.('creating-zip', 100, 'ZIP archive buffer created');\n\n      return succeed(result);\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to create ZIP archive: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Add a single FileTree item to the ZIP archive\n   * @param files - ZIP files collection\n   * @param fileItem - FileTree file item to add\n   * @param archivePath - Path within the archive\n   * @returns Result indicating success or failure\n   */\n  private async _addFileTreeItemToZip(\n    files: Record<string, Uint8Array>,\n    fileItem: FileTree.IFileTreeFileItem,\n    archivePath: string\n  ): Promise<Result<void>> {\n    return fileItem.getRawContents().onSuccess((content) => {\n      const contentBuffer = new TextEncoder().encode(content);\n      files[normalizePath(archivePath)] = contentBuffer;\n      return succeed(undefined);\n    });\n  }\n\n  /**\n   * Add a directory recursively to the ZIP archive using FileTree\n   * @param files - ZIP files collection\n   * @param directoryItem - FileTree directory item to add\n   * @param archivePrefix - Prefix path within the archive\n   * @param onProgress - Optional progress callback\n   * @returns Result indicating success or failure\n   */\n  private async _addDirectoryTreeToZip(\n    files: Record<string, Uint8Array>,\n    directoryItem: FileTree.IFileTreeDirectoryItem,\n    archivePrefix: string,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<void>> {\n    const childrenResult = directoryItem.getChildren();\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (childrenResult.isFailure()) {\n      return fail(`Failed to read directory ${directoryItem.absolutePath}: ${childrenResult.message}`);\n    }\n\n    for (const child of childrenResult.value) {\n      const itemArchivePath = normalizePath(`${archivePrefix}/${child.name}`);\n\n      if (child.type === 'directory') {\n        // Recursively add subdirectory\n        const addDirResult = await this._addDirectoryTreeToZip(files, child, itemArchivePath, onProgress);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addDirResult.isFailure()) {\n          return fail(addDirResult.message);\n        }\n      } else if (child.type === 'file') {\n        // Add file\n        const addFileResult = await this._addFileTreeItemToZip(files, child, itemArchivePath);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addFileResult.isFailure()) {\n          return fail(addFileResult.message);\n        }\n        onProgress?.('reading-file', 0, `Added file: ${itemArchivePath}`);\n      }\n    }\n\n    return succeed(undefined);\n  }\n\n  private _getInputFileTreeItem(options: ZipArchiveOptions): Result<FileTree.FileTreeItem | undefined> {\n    if ('inputPath' in options && options.inputPath !== undefined) {\n      return FileTree.forFilesystem()\n        .withErrorFormat((msg) => `Failed to create file tree: ${msg}`)\n        .onSuccess((fileTree) =>\n          fileTree.getItem(options.inputPath!).withErrorFormat((msg) => `Failed to get item: ${msg}`)\n        );\n    } else if ('inputItem' in options) {\n      return succeed(options.inputItem);\n    }\n    return succeed(undefined);\n  }\n\n  private _getConfigFileTreeItem(options: ZipArchiveOptions): Result<FileTree.IFileTreeFileItem | undefined> {\n    if ('configPath' in options && options.configPath !== undefined) {\n      return FileTree.forFilesystem()\n        .withErrorFormat((msg) => `Failed to create file tree: ${msg}`)\n        .onSuccess((fileTree) =>\n          fileTree.getFile(options.configPath!).withErrorFormat((msg) => `Failed to get config file: ${msg}`)\n        );\n    } else if ('configItem' in options && options.configItem !== undefined) {\n      return succeed(options.configItem);\n    }\n    return succeed(undefined);\n  }\n}\n"]}

package/dist/packlets/zip-archive/zipArchiveFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveFormat.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveFormat.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 { Result, captureResult } from '@fgv/ts-utils';\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n/**\n * Create a ZIP archive manifest object\n * @param inputType - Type of input (file or directory)\n * @param originalPath - Original file/directory path\n * @param archivePath - Path within the archive\n * @param configPath - Optional configuration file path\n * @returns ZIP archive manifest\n * @public\n */\nexport function createZipArchiveManifest(\n  inputType: 'file' | 'directory',\n  originalPath: string,\n  archivePath: string,\n  configPath?: string\n): Json.IZipArchiveManifest {\n  const manifest: Json.IZipArchiveManifest = {\n    timestamp: new Date().toISOString(),\n    input: {\n      type: inputType,\n      originalPath,\n      archivePath\n    }\n  };\n\n  if (configPath) {\n    manifest.config = {\n      type: 'file',\n      originalPath: configPath,\n      archivePath: 'config.json'\n    };\n  }\n\n  return manifest;\n}\n\n/**\n * Parse and validate a ZIP archive manifest\n * @param manifestData - JSON string containing manifest data\n * @returns Result containing validated manifest\n * @public\n */\nexport function parseZipArchiveManifest(manifestData: string): Result<Json.IZipArchiveManifest> {\n  return captureResult(() => {\n    const parsed = JSON.parse(manifestData);\n    return parsed;\n  })\n    .onSuccess((parsed) => Convert.zipArchiveManifest.validate(parsed))\n    .withErrorFormat((e) => `Failed to parse ZIP archive manifest: ${e}`);\n}\n\n/**\n * Validate a ZIP archive manifest object\n * @param manifest - Object to validate as manifest\n * @returns Result containing validated manifest\n * @public\n */\nexport function validateZipArchiveManifest(manifest: unknown): Result<Json.IZipArchiveManifest> {\n  return Convert.zipArchiveManifest.validate(manifest);\n}\n\n/**\n * Parse and validate configuration JSON\n * @param configData - JSON string containing configuration\n * @returns Result containing validated configuration\n * @public\n */\nexport function parseZipArchiveConfiguration(configData: string): Result<ConfigModel.ISystemConfiguration> {\n  return captureResult(() => {\n    const parsed = JSON.parse(configData);\n    return parsed;\n  })\n    .onSuccess((parsed) => Convert.systemConfiguration.validate(parsed))\n    .withErrorFormat((e) => `Failed to parse ZIP archive configuration: ${e}`);\n}\n\n/**\n * Generate a timestamp-based filename for ZIP archives\n * @param customName - Optional custom name prefix\n * @returns Generated filename\n * @public\n */\nexport function generateZipArchiveFilename(customName?: string): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').slice(0, -5);\n  return customName ? `${customName}-${timestamp}.zip` : `ts-res-archive-${timestamp}.zip`;\n}\n\n/**\n * Normalize path separators for cross-platform compatibility\n * @param path - Path to normalize\n * @returns Normalized path\n * @public\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\\\/g, '/').replace(/\\/+/g, '/');\n}\n\n/**\n * Extract directory name from a file path\n * @param path - File path\n * @returns Directory name\n * @public\n */\nexport function getDirectoryName(path: string): string {\n  const normalized = normalizePath(path);\n  const parts = normalized.split('/');\n  return parts[parts.length - 1] || 'archive';\n}\n\n/**\n * Create a safe filename by removing invalid characters\n * @param filename - Original filename\n * @returns Sanitized filename\n * @public\n */\nexport function sanitizeFilename(filename: string): string {\n  return filename\n    .replace(/[<>:\"/\\\\|?*]/g, '_')\n    .replace(/\\s+/g, '_')\n    .replace(/_+/g, '_')\n    .trim();\n}\n\n/**\n * Validate ZIP file extension\n * @param filename - Filename to validate\n * @returns True if filename has .zip extension\n * @public\n */\nexport function isZipFile(filename: string): boolean {\n  return filename.toLowerCase().endsWith('.zip');\n}\n"]}

package/dist/packlets/zip-archive/zipArchiveLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveLoader.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveLoader.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 { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n// ZipFileTree is browser-safe - doesn't depend on Node.js crypto/fs modules\nimport { ZipFileTree } from '@fgv/ts-extras';\nimport type {\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  ZipArchiveProgressCallback,\n  IImportedFile,\n  IImportedDirectory\n} from './types';\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport { parseZipArchiveManifest, parseZipArchiveConfiguration, isZipFile } from './zipArchiveFormat';\n\n/**\n * ZIP archive loader extending ts-extras foundation\n * @public\n */\nexport class ZipArchiveLoader {\n  /**\n   * Load ZIP archive from File object (Browser)\n   * @param file - File object from file input\n   * @param options - Loading options\n   * @param onProgress - Optional progress callback\n   * @returns Result containing loaded archive data\n   */\n  public async loadFromFile(\n    file: File,\n    options: IZipArchiveLoadOptions = {},\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveLoadResult>> {\n    onProgress?.('reading-file', 0, `Reading file: ${file.name}`);\n\n    if (!isZipFile(file.name)) {\n      return fail(`File ${file.name} is not a ZIP file`);\n    }\n\n    try {\n      const buffer = await file.arrayBuffer();\n      onProgress?.('reading-file', 100, 'File read complete');\n\n      return await this.loadFromBuffer(buffer, options, onProgress);\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to read file: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Load ZIP archive from ArrayBuffer (Universal)\n   * @param buffer - ZIP data buffer\n   * @param options - Loading options\n   * @param onProgress - Optional progress callback\n   * @returns Result containing loaded archive data\n   */\n  public async loadFromBuffer(\n    buffer: ArrayBuffer,\n    options: IZipArchiveLoadOptions = {},\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveLoadResult>> {\n    onProgress?.('parsing-zip', 0, 'Parsing ZIP archive');\n\n    const zipAccessorsResult = ZipFileTree.ZipFileTreeAccessors.fromBuffer(buffer);\n    if (zipAccessorsResult.isFailure()) {\n      return fail(`Failed to parse ZIP: ${zipAccessorsResult.message}`);\n    }\n\n    const zipAccessors = zipAccessorsResult.value;\n    onProgress?.('parsing-zip', 100, 'ZIP archive parsed');\n\n    // Load manifest\n    onProgress?.('loading-manifest', 0, 'Loading manifest');\n    const manifestResult = this._loadManifestFromAccessors(zipAccessors);\n    if (manifestResult.isFailure()) {\n      return fail(manifestResult.message);\n    }\n    const manifest = manifestResult.value;\n    onProgress?.('loading-manifest', 100, 'Manifest loaded');\n\n    // Load configuration\n    onProgress?.('loading-config', 0, 'Loading configuration');\n    const configResult = this._loadConfigurationFromAccessors(zipAccessors, manifest, options);\n    if (configResult.isFailure()) {\n      return fail(configResult.message);\n    }\n    const config = configResult.value;\n    onProgress?.('loading-config', 100, 'Configuration loaded');\n\n    // Extract files and directory structure\n    onProgress?.('extracting-files', 0, 'Extracting files');\n    const filesResult = await this._extractFilesFromAccessors(zipAccessors, onProgress);\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (filesResult.isFailure()) {\n      return fail(filesResult.message);\n    }\n\n    const { files, directory } = filesResult.value;\n    onProgress?.('extracting-files', 100, `Extracted ${files.length} files`);\n\n    onProgress?.('extracting-files', 100, 'ZIP loading complete');\n\n    return succeed({\n      manifest,\n      config,\n      files,\n      directory\n    });\n  }\n\n  /**\n   * Load manifest from ZIP using ZipFileTreeAccessors\n   * @param zipAccessors - ZIP file tree accessors\n   * @returns Result containing parsed manifest\n   */\n  private _loadManifestFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors\n  ): Result<Json.IZipArchiveManifest | undefined> {\n    const manifestResult = zipAccessors.getFileContents('manifest.json');\n    if (manifestResult.isFailure()) {\n      // Manifest is optional - return success with undefined\n      return succeed(undefined);\n    }\n\n    const parseResult = parseZipArchiveManifest(manifestResult.value);\n    if (parseResult.isFailure()) {\n      return fail(`Failed to parse manifest.json: ${parseResult.message}`);\n    }\n\n    return succeed(parseResult.value);\n  }\n\n  /**\n   * Load configuration from ZIP using ZipFileTreeAccessors\n   * @param zipAccessors - ZIP file tree accessors\n   * @param manifest - Parsed manifest (may be undefined)\n   * @param options - Loading options\n   * @returns Result containing parsed configuration\n   */\n  private _loadConfigurationFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    manifest: Json.IZipArchiveManifest | undefined,\n    options: IZipArchiveLoadOptions\n  ): Result<ConfigModel.ISystemConfiguration | undefined> {\n    // Check if manifest specifies a config file\n    const manifestSpecifiesConfig = manifest?.config !== undefined;\n\n    if (!manifestSpecifiesConfig) {\n      // If no config specified in manifest, config is optional\n      return succeed(undefined);\n    }\n\n    // Get the config path from the manifest\n    const configPath = manifest!.config!.archivePath;\n    return zipAccessors\n      .getFileContents(configPath)\n      .withErrorFormat(\n        () => `Manifest specifies config file at '${configPath}' but it was not found in archive`\n      )\n      .onSuccess((configContent) => parseZipArchiveConfiguration(configContent))\n      .withErrorFormat((e) => `Failed to parse config file '${configPath}': ${e}`);\n  }\n\n  /**\n   * Extract files and directory structure from ZIP\n   * @param zipAccessors - ZIP file tree accessors\n   * @param onProgress - Optional progress callback\n   * @returns Result containing files and directory structure\n   */\n  private async _extractFilesFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<{ files: IImportedFile[]; directory: IImportedDirectory | undefined }>> {\n    try {\n      const files: IImportedFile[] = [];\n      const directories = new Map<string, IImportedDirectory>();\n\n      // Get all children from root\n      const rootChildrenResult = zipAccessors.getChildren('/');\n      /* c8 ignore next 3 - defense in depth against internal error */\n      if (rootChildrenResult.isFailure()) {\n        return fail(`Failed to read ZIP contents: ${rootChildrenResult.message}`);\n      }\n\n      // Process all items recursively\n      await this._processFileTreeItems(\n        zipAccessors,\n        '/',\n        rootChildrenResult.value,\n        files,\n        directories,\n        onProgress\n      );\n\n      // Build directory structure\n      const directory = this._buildDirectoryStructure(files, directories);\n\n      return succeed({ files, directory });\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to extract files: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Recursively process file tree items\n   * @param zipAccessors - ZIP file tree accessors\n   * @param currentPath - Current directory path\n   * @param items - Items to process\n   * @param files - Files collection\n   * @param directories - Directories collection\n   * @param onProgress - Optional progress callback\n   * @param processed - Processing counter\n   */\n  private async _processFileTreeItems(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    currentPath: string,\n    items: readonly FileTree.FileTreeItem[],\n    files: IImportedFile[],\n    directories: Map<string, IImportedDirectory>,\n    onProgress?: ZipArchiveProgressCallback,\n    processed: { count: number } = { count: 0 }\n  ): Promise<void> {\n    for (const item of items) {\n      /* c8 ignore next 1 - defense in depth */\n      const itemPath = item.absolutePath.startsWith('/') ? item.absolutePath.substring(1) : item.absolutePath;\n\n      if (item.type === 'directory') {\n        // Track directory\n        if (!directories.has(itemPath)) {\n          directories.set(itemPath, {\n            name: item.name,\n            files: [],\n            subdirectories: []\n          });\n        }\n\n        // Recursively process children\n        const childrenResult = zipAccessors.getChildren(item.absolutePath);\n        if (childrenResult.isSuccess()) {\n          await this._processFileTreeItems(\n            zipAccessors,\n            item.absolutePath,\n            childrenResult.value,\n            files,\n            directories,\n            onProgress,\n            processed\n          );\n        }\n      } else if (item.type === 'file') {\n        // Get file content\n        const contentResult = item.getRawContents();\n        const content = contentResult.orDefault('');\n\n        files.push({\n          name: item.name,\n          path: itemPath,\n          content,\n          type: this._getFileType(item.name)\n        });\n      }\n\n      processed.count++;\n      onProgress?.('extracting-files', 0, `Processing ${itemPath}`);\n    }\n  }\n\n  /**\n   * Build directory structure from files\n   * @param files - Extracted files\n   * @param directories - Directories map\n   * @returns Root directory structure or null\n   */\n  private _buildDirectoryStructure(\n    files: IImportedFile[],\n    directories: Map<string, IImportedDirectory>\n  ): IImportedDirectory | undefined {\n    /* c8 ignore next 3 - should never happen with fflate */\n    if (files.length === 0) {\n      return undefined;\n    }\n\n    const rootDir: IImportedDirectory = {\n      name: 'root',\n      files: [],\n      subdirectories: []\n    };\n\n    // Process files to build directory structure\n    for (const file of files) {\n      const pathParts = file.path.split('/').filter((part: string) => part.length > 0);\n\n      /* c8 ignore next 1 - defense in depth should never happen */\n      if (pathParts.length === 0) continue;\n\n      // Ensure all parent directories exist\n      let currentDir = rootDir;\n      for (let i = 0; i < pathParts.length - 1; i++) {\n        const dirName = pathParts[i];\n        let foundDir = currentDir.subdirectories.find((d) => d.name === dirName);\n\n        if (!foundDir) {\n          foundDir = {\n            name: dirName,\n            files: [],\n            subdirectories: []\n          };\n          currentDir.subdirectories.push(foundDir);\n        }\n\n        currentDir = foundDir;\n      }\n\n      // Add file to its parent directory\n      currentDir.files.push(file);\n    }\n\n    return rootDir;\n  }\n\n  /**\n   * Get file MIME type based on extension\n   * @param filename - Filename\n   * @returns MIME type\n   */\n  private _getFileType(filename: string): string {\n    const ext = filename.toLowerCase().split('.').pop();\n    /* c8 ignore next 20 - no need to test every one */\n    switch (ext) {\n      case 'json':\n        return 'application/json';\n      case 'yaml':\n      case 'yml':\n        return 'application/yaml';\n      case 'xml':\n        return 'application/xml';\n      case 'txt':\n        return 'text/plain';\n      case 'md':\n        return 'text/markdown';\n      case 'js':\n        return 'application/javascript';\n      case 'ts':\n        return 'application/typescript';\n      default:\n        return 'application/octet-stream';\n    }\n  }\n}\n"]}