@fgv/ts-res 5.1.0-3 → 5.1.0-30

package/lib/packlets/runtime/resourceTreeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeResolver.js","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceTreeResolver.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, MessageAggregator, succeed, fail, captureResult } from '@fgv/ts-utils';\nimport { JsonValue, JsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { IResourceManager, IResource } from './iResourceManager';\nimport { IReadOnlyResourceTreeNode, IReadOnlyResourceTreeRoot } from './resource-tree/common';\nimport { ResourceResolver } from './resourceResolver';\n\n/**\n * Type for handling resource resolution errors during tree traversal.\n * The handler receives the resource that failed to resolve, the error message, and the resolver for recovery attempts.\n * It can return:\n * - Success(undefined) to omit the property from the result\n * - Success(value) to use an alternate value\n * - Failure to propagate the error\n * @public\n */\nexport type ResourceErrorHandler = (\n  resource: IResource,\n  message: string,\n  resolver: ResourceResolver\n) => Result<JsonValue | undefined>;\n\n/**\n * Type for handling empty branch nodes during tree composition.\n * The handler receives the branch node, names of failed children, and the resolver for recovery attempts.\n * It can return:\n * - Success(undefined) to omit the branch from the result\n * - Success(value) to use an alternate value for the branch\n * - Failure to propagate the error\n * @public\n */\nexport type EmptyBranchHandler = (\n  branchNode: IReadOnlyResourceTreeNode<IResource>,\n  failedChildNames: string[],\n  resolver: ResourceResolver\n) => Result<JsonValue | undefined>;\n\n/**\n * Options for configuring resource tree resolution.\n * @public\n */\nexport interface IResolveResourceTreeOptions {\n  /**\n   * Controls how errors are handled when resolving individual resources in the tree.\n   * - 'fail': Aggregate all errors and fail if any resource fails to resolve\n   * - 'ignore': Skip failed resources and omit them from the result\n   * - callback: Custom error handler that can provide alternate values or propagate errors\n   * @defaultValue 'fail'\n   */\n  onResourceError?: 'fail' | 'ignore' | ResourceErrorHandler;\n\n  /**\n   * Controls how empty branch nodes are handled during tree composition.\n   * - 'allow': Include empty branches as empty objects in the result\n   * - 'omit': Exclude empty branches from the parent object\n   * - callback: Custom handler that can provide alternate values or recovery logic\n   * @defaultValue 'allow'\n   */\n  onEmptyBranch?: 'allow' | 'omit' | EmptyBranchHandler;\n}\n\n/**\n * Specialized resolver for resource tree operations, providing enhanced APIs for\n * resolving entire resource trees from either resource IDs or pre-built tree nodes.\n *\n * This class provides a clean separation between individual resource resolution\n * (handled by ResourceResolver) and tree-based operations, with support for\n * lazy tree construction and enhanced error handling.\n *\n * @public\n */\nexport class ResourceTreeResolver {\n  /**\n   * The {@link Runtime.ResourceResolver | ResourceResolver} to use for individual resource resolution\n   */\n  public readonly resolver: ResourceResolver;\n\n  /**\n   * The {@link Runtime.IResourceManager | IResourceManager} to use for lazy tree construction.\n   * @internal\n   */\n  private readonly _resourceManager: IResourceManager<IResource>;\n  /**\n   * The built resource tree, lazily built on first access.\n   * @internal\n   */\n  private _tree?: Result<IReadOnlyResourceTreeRoot<IResource>>;\n\n  /**\n   * Creates a {@link Runtime.ResourceTreeResolver | ResourceTreeResolver} instance.\n   * @param resolver - The ResourceResolver to use for individual resource resolution\n   */\n  public constructor(resolver: ResourceResolver) {\n    this.resolver = resolver;\n    this._resourceManager = resolver.resourceManager;\n  }\n\n  /**\n   * Creates a {@link Runtime.ResourceTreeResolver | ResourceTreeResolver} instance.\n   * @param resolver - The ResourceResolver to use for individual resource resolution\n   */\n  public static create(resolver: ResourceResolver): Result<ResourceTreeResolver> {\n    return captureResult(() => new ResourceTreeResolver(resolver));\n  }\n\n  /**\n   * Gets the built resource tree, building it lazily on first access.\n   * @returns The resource tree root\n   * @throws Error if no resource manager was provided or tree building fails\n   * @public\n   */\n  public get tree(): IReadOnlyResourceTreeRoot<IResource> {\n    return this._getTree().orThrow();\n  }\n\n  /**\n   * Resolves a resource tree from a resource ID, building the tree lazily from the resource manager.\n   * @param resourceId - The ID of the root resource to resolve\n   * @param options - Optional configuration for error handling during resolution\n   * @returns Success with the composed JsonObject or undefined, or Failure with error message\n   * @public\n   */\n  public resolveComposedResourceTree(\n    resourceId: string,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined>;\n\n  /**\n   * Resolves a pre-built resource tree node.\n   * @param node - The resource tree node to resolve\n   * @param options - Optional configuration for error handling during resolution\n   * @returns Success with the composed JsonObject or undefined, or Failure with error message\n   * @public\n   */\n  public resolveComposedResourceTree(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined>;\n\n  /**\n   * Implementation for both overloads.\n   */\n  public resolveComposedResourceTree(\n    idOrNode: string | IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    if (typeof idOrNode === 'string') {\n      return this._resolveFromResourceId(idOrNode, options);\n    }\n    return this._resolveFromTreeNode(idOrNode, options);\n  }\n\n  private _getTree(): Result<IReadOnlyResourceTreeRoot<IResource>> {\n    if (!this._tree) {\n      this._tree = this._resourceManager.getBuiltResourceTree();\n    }\n    return this._tree;\n  }\n\n  /**\n   * Resolves a tree from a resource ID by first building the tree from the resource manager.\n   * @internal\n   */\n  private _resolveFromResourceId(\n    resourceId: string,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    return this._getTree().onSuccess((tree) => {\n      return tree.children.validating\n        .getById(resourceId)\n        .onFailure((message) => fail(`${resourceId}: Resource not found in resource tree: ${message}`))\n        .onSuccess((rootNode) => this._resolveFromTreeNode(rootNode, options));\n    });\n  }\n\n  /**\n   * Resolves a pre-built tree node using the extracted tree resolution logic.\n   * @internal\n   */\n  private _resolveFromTreeNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    const resourceErrorMode = options?.onResourceError ?? 'fail';\n    const emptyBranchMode = options?.onEmptyBranch ?? 'allow';\n\n    // Handle root node with proper Result chaining\n    return node.isLeaf\n      ? this._processLeafNode(node, '', resourceErrorMode).onSuccess((value) =>\n          value !== undefined ? JsonConverters.jsonObject.convert(value) : succeed(undefined)\n        )\n      : this._processBranchNode(node, '', {\n          onResourceError: resourceErrorMode,\n          onEmptyBranch: emptyBranchMode\n        }).onSuccess((value) => {\n          // Only convert undefined to {} if emptyBranchMode is 'allow'\n          // For 'omit' mode or custom handlers returning undefined, preserve undefined\n          /* c8 ignore next 3 - defense in depth */\n          return succeed(value === undefined && emptyBranchMode === 'allow' ? {} : value);\n        });\n  }\n\n  /**\n   * Handles resource resolution errors according to the specified mode.\n   * @param resource - The resource that failed to resolve\n   * @param message - The error message from the failed resolution\n   * @param mode - The error handling mode\n   * @param path - The path to the resource in the tree (for error context)\n   * @internal\n   */\n  private _handleResourceError(\n    resource: IResource,\n    message: string,\n    mode: 'fail' | 'ignore' | ResourceErrorHandler,\n    path: string\n  ): Result<JsonValue | undefined> {\n    if (mode === 'ignore') {\n      return succeed(undefined);\n    }\n    if (mode === 'fail') {\n      const errorMessage = path ? `${path}: ${message}` : message;\n      return fail(errorMessage);\n    }\n    // Custom handler - pass the resolver for recovery attempts\n    return mode(resource, message, this.resolver);\n  }\n\n  /**\n   * Handles empty branch nodes according to the specified mode.\n   * @param node - The empty branch node\n   * @param failedChildren - Names of children that failed to resolve\n   * @param mode - The empty branch handling mode\n   * @param path - The path to the branch in the tree (for error context)\n   * @internal\n   */\n  private _handleEmptyBranch(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    failedChildren: string[],\n    mode: 'allow' | 'omit' | EmptyBranchHandler,\n    path: string\n  ): Result<JsonValue | undefined> {\n    if (mode === 'omit') {\n      return succeed(undefined);\n    }\n    if (mode === 'allow') {\n      return succeed({});\n    }\n    // Custom handler - pass the resolver for recovery attempts\n    return mode(node, failedChildren, this.resolver);\n  }\n\n  /**\n   * Processes a leaf node by resolving its resource value.\n   * @param node - The leaf node to process (must be a leaf node)\n   * @param path - The path to the node in the tree\n   * @param resourceErrorMode - How to handle resource resolution errors\n   * @internal\n   */\n  private _processLeafNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    path: string,\n    resourceErrorMode: 'fail' | 'ignore' | ResourceErrorHandler\n  ): Result<JsonValue | undefined> {\n    /* c8 ignore next 3 - defense in depth */\n    if (!node.isLeaf) {\n      return fail(`Internal error: processLeafNode called on non-leaf node at ${path}`);\n    }\n\n    return this.resolver\n      .resolveComposedResourceValue(node.resource)\n      .onSuccess<JsonValue | undefined>((value) => succeed(value))\n      .onFailure((message) => this._handleResourceError(node.resource, message, resourceErrorMode, path));\n  }\n\n  /**\n   * Processes a branch node by recursively resolving all its children.\n   * @param node - The branch node to process (must be a branch node)\n   * @param path - The path to the node in the tree\n   * @param options - Resolution options\n   * @internal\n   */\n  private _processBranchNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    path: string,\n    options: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    /* c8 ignore next 3 - defense in depth */\n    if (node.isLeaf) {\n      return fail(`Internal error: processBranchNode called on leaf node at ${path}`);\n    }\n\n    /* c8 ignore next 2 - ?? is defense in depth */\n    const resourceErrorMode = options.onResourceError ?? 'fail';\n    const emptyBranchMode = options.onEmptyBranch ?? 'allow';\n    const aggregator = new MessageAggregator();\n\n    // Process all children\n    const childResults: JsonObject = {};\n    const failedChildren: string[] = [];\n\n    for (const [childName, childNode] of node.children) {\n      const childPath = path ? `${path}.${childName}` : childName;\n\n      const childResult = childNode.isLeaf\n        ? this._processLeafNode(childNode, childPath, resourceErrorMode)\n        : this._processBranchNode(childNode, childPath, options);\n\n      // Process the child result and update our state\n      if (childResult.isSuccess()) {\n        const value = childResult.value;\n        if (value !== undefined) {\n          childResults[childName] = value;\n        } else {\n          failedChildren.push(childName);\n        }\n      } else {\n        if (resourceErrorMode === 'fail') {\n          aggregator.addMessage(childResult.message);\n        }\n        failedChildren.push(childName);\n      }\n    }\n\n    // Check for accumulated errors in 'fail' mode\n    if (resourceErrorMode === 'fail' && aggregator.hasMessages) {\n      return fail(aggregator.toString('; '));\n    }\n\n    // Handle empty branch\n    if (Object.keys(childResults).length === 0) {\n      return this._handleEmptyBranch(node, failedChildren, emptyBranchMode, path).onSuccess((value) => {\n        if (value === undefined) {\n          return succeed(undefined);\n        }\n        // Ensure we return JsonObject or undefined\n        return JsonConverters.jsonObject.convert(value);\n      });\n    }\n\n    return succeed(childResults);\n  }\n}\n"]}

package/lib/packlets/runtime/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/validate.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,SAAS,EAAE,MAAM,eAAe,CAAC;AAKtD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAQjE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,CAejD,CAAC"}

package/lib/packlets/runtime/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/packlets/runtime/validate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AACtD,oDAAiE;AACjE,sCAAiD;AACjD,sDAAiD;AACjD,4CAAgD;AAGhD;;;GAGG;AACU,QAAA,iBAAiB,GAC5B,qBAAU,CAAC,MAAM,CAAqB;IACpC,IAAI,EAAE,yBAAc,CAAC,UAAU;IAC/B,SAAS,EAAE,qBAAU,CAAC,OAAO;IAC7B,WAAW,EAAE,qBAAU,CAAC,GAAG,CACzB,6BAA6B,EAC7B,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,CACnG;CACF,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,QAAQ,GAAkC,qBAAU,CAAC,MAAM,CAAY;IAClF,EAAE,EAAE,qBAAU,CAAC,GAAG,CAChB,YAAY,EACZ,CAAC,CAAC,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,iBAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAC/E;IACD,IAAI,EAAE,qBAAU,CAAC,GAAG,CAClB,cAAc,EACd,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,iBAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAC7E;IACD,YAAY,EAAE,qBAAU,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,YAAY,6BAAY,CAAC;IAC1G,QAAQ,EAAE,qBAAU,CAAC,GAAG,CACtB,2BAA2B,EAC3B,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,YAAY,4BAAgB,CAC5D;IACD,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,yBAAiB,CAAC;CAClD,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 { Validators, Validator } from '@fgv/ts-utils';\nimport { Validators as JsonValidators } from '@fgv/ts-json-base';\nimport { Validate, ResourceId } from '../common';\nimport { ResourceType } from '../resource-types';\nimport { ConcreteDecision } from '../decisions';\nimport { IResource, IResourceCandidate } from './iResourceManager';\n\n/**\n * Validates an {@link Runtime.IResourceCandidate | IResourceCandidate} object.\n * @public\n */\nexport const resourceCandidate: Validator<IResourceCandidate, unknown> =\n  Validators.object<IResourceCandidate>({\n    json: JsonValidators.jsonObject,\n    isPartial: Validators.boolean,\n    mergeMethod: Validators.isA(\n      'resource value merge method',\n      (v): v is 'augment' | 'delete' | 'replace' => v === 'augment' || v === 'delete' || v === 'replace'\n    )\n  });\n\n/**\n * Validates an {@link Runtime.IResource | IResource} object.\n * @public\n */\nexport const resource: Validator<IResource, unknown> = Validators.object<IResource>({\n  id: Validators.isA(\n    'ResourceId',\n    (v): v is ResourceId => typeof v === 'string' && Validate.isValidResourceId(v)\n  ),\n  name: Validators.isA(\n    'ResourceName',\n    (v): v is string => typeof v === 'string' && Validate.isValidResourceName(v)\n  ),\n  resourceType: Validators.isA('ResourceType instance', (v): v is ResourceType => v instanceof ResourceType),\n  decision: Validators.isA(\n    'ConcreteDecision instance',\n    (v): v is ConcreteDecision => v instanceof ConcreteDecision\n  ),\n  candidates: Validators.arrayOf(resourceCandidate)\n});\n"]}

package/lib/packlets/zip-archive/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/convert.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAc,SAAS,EAAc,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,KAAK,IAAI,WAAW,EAA4B,MAAM,WAAW,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,MAAM,GAAG,WAAW,CAGrD,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAiD,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAKjE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,IAAI,CAAC,qBAAqB,CAKnE,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAK/D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAqB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,aAAa,CAKrD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAS/D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,WAAW,CAAC,oBAAoB,CAK3E,CAAC"}

package/lib/packlets/zip-archive/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/convert.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAA6E;AAE7E,sCAA2E;AAE3E;;;GAGG;AACU,QAAA,mBAAmB,GAAoC,qBAAU,CAAC,eAAe,CAAC;IAC7F,MAAM;IACN,WAAW;CACH,CAAC,CAAC;AAEZ;;;GAGG;AACU,QAAA,oBAAoB,GAAsB,qBAAU,CAAC,eAAe,CAAC,CAAC,MAAM,CAAU,CAAC,CAAC;AAErG;;;GAGG;AACU,QAAA,mBAAmB,GAC9B,qBAAU,CAAC,MAAM,CAA4B;IAC3C,IAAI,EAAE,2BAAmB;IACzB,YAAY,EAAE,qBAAU,CAAC,MAAM;IAC/B,WAAW,EAAE,qBAAU,CAAC,MAAM;CAC/B,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,oBAAoB,GAC/B,qBAAU,CAAC,MAAM,CAA6B;IAC5C,IAAI,EAAE,4BAAoB;IAC1B,YAAY,EAAE,qBAAU,CAAC,MAAM;IAC/B,WAAW,EAAE,qBAAU,CAAC,MAAM;CAC/B,CAAC,CAAC;AAEL;;;;GAIG;AACU,QAAA,kBAAkB,GAC7B,qBAAU,CAAC,MAAM,CAA2B;IAC1C,SAAS,EAAE,qBAAU,CAAC,MAAM;IAC5B,KAAK,EAAE,2BAAmB,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,4BAAoB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,QAAQ,GAAsB,qBAAU,CAAC,MAAM,CAAC;AAE7D;;;GAGG;AACU,QAAA,YAAY,GAAkC,qBAAU,CAAC,YAAY,CAAqB;IACrG,IAAI,EAAE,qBAAU,CAAC,MAAM;IACvB,IAAI,EAAE,qBAAU,CAAC,MAAM;IACvB,OAAO,EAAE,qBAAU,CAAC,MAAM;IAC1B,IAAI,EAAE,qBAAU,CAAC,MAAM,CAAC,sBAAsB;CAC/C,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,iBAAiB,GAAuC,qBAAU,CAAC,OAAO,CAGrF,CAAC,IAAa,EAAE,IAAiD,EAAE,OAAiB,EAAE,EAAE;IACxF,OAAO,qBAAU,CAAC,YAAY,CAA0B;QACtD,IAAI,EAAE,qBAAU,CAAC,MAAM;QACvB,KAAK,EAAE,qBAAU,CAAC,OAAO,CAAC,oBAAY,CAAC;QACvC,cAAc,EAAE,qBAAU,CAAC,OAAO,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,mBAAmB,GAAgD,qBAAU,CAAC,GAAG,CAC5F,sBAAsB,EACtB,CAAC,KAAc,EAA6C,EAAE;IAC5D,OAAO,gBAAa,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;AACtE,CAAC,CACF,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 { Validator, Validators, Converter, Converters } from '@fgv/ts-utils';\nimport * as Json from './json';\nimport { Model as ConfigModel, Convert as ConfigConvert } from '../config';\n\n/**\n * Validator for ZIP archive input type\n * @public\n */\nexport const zipArchiveInputType: Validator<'file' | 'directory'> = Validators.enumeratedValue([\n  'file',\n  'directory'\n] as const);\n\n/**\n * Validator for ZIP archive config type\n * @public\n */\nexport const zipArchiveConfigType: Validator<'file'> = Validators.enumeratedValue(['file'] as const);\n\n/**\n * Validator for ZIP archive input information\n * @public\n */\nexport const zipArchiveInputInfo: Validator<Json.IZipArchiveInputInfo> =\n  Validators.object<Json.IZipArchiveInputInfo>({\n    type: zipArchiveInputType,\n    originalPath: Validators.string,\n    archivePath: Validators.string\n  });\n\n/**\n * Validator for ZIP archive config information\n * @public\n */\nexport const zipArchiveConfigInfo: Validator<Json.IZipArchiveConfigInfo> =\n  Validators.object<Json.IZipArchiveConfigInfo>({\n    type: zipArchiveConfigType,\n    originalPath: Validators.string,\n    archivePath: Validators.string\n  });\n\n/**\n * Validator for ZIP archive manifest\n * Compatible with existing tools from ts-res-browser-cli\n * @public\n */\nexport const zipArchiveManifest: Validator<Json.IZipArchiveManifest> =\n  Validators.object<Json.IZipArchiveManifest>({\n    timestamp: Validators.string,\n    input: zipArchiveInputInfo.optional(),\n    config: zipArchiveConfigInfo.optional()\n  });\n\n/**\n * Validator for MIME type strings\n * @public\n */\nexport const mimeType: Validator<string> = Validators.string;\n\n/**\n * Converter for imported file\n * @public\n */\nexport const importedFile: Converter<Json.IImportedFile> = Converters.strictObject<Json.IImportedFile>({\n  name: Converters.string,\n  path: Converters.string,\n  content: Converters.string,\n  type: Converters.string // MIME type as string\n});\n\n/**\n * Converter for imported directory structure (recursive)\n * Note: Uses Converter pattern because Validators don't support recursion with self parameter\n * @public\n */\nexport const importedDirectory: Converter<Json.IImportedDirectory> = Converters.generic<\n  Json.IImportedDirectory,\n  unknown\n>((from: unknown, self: Converter<Json.IImportedDirectory, unknown>, context?: unknown) => {\n  return Converters.strictObject<Json.IImportedDirectory>({\n    name: Converters.string,\n    files: Converters.arrayOf(importedFile),\n    subdirectories: Converters.arrayOf(self)\n  }).convert(from, context);\n});\n\n/**\n * Validator for system configuration (delegates to config packlet)\n * This validates that the parsed JSON conforms to the system configuration schema\n * @public\n */\nexport const systemConfiguration: Validator<ConfigModel.ISystemConfiguration> = Validators.isA(\n  'system configuration',\n  (value: unknown): value is ConfigModel.ISystemConfiguration => {\n    return ConfigConvert.systemConfiguration.convert(value).isSuccess();\n  }\n);\n"]}

package/lib/packlets/zip-archive/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.browser.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/lib/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,6CAA+B;AAItB,oBAAI;AAHb,mDAAqC;AAGtB,0BAAO;AAEtB,4EAA4E;AAC5E,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAgBzB,mBAAmB;AACnB,uDAU4B;AAT1B,4HAAA,wBAAwB,OAAA;AACxB,2HAAA,uBAAuB,OAAA;AACvB,8HAAA,0BAA0B,OAAA;AAC1B,gIAAA,4BAA4B,OAAA;AAC5B,8HAAA,0BAA0B,OAAA;AAC1B,iHAAA,aAAa,OAAA;AACb,oHAAA,gBAAgB,OAAA;AAChB,oHAAA,gBAAgB,OAAA;AAChB,6GAAA,SAAS,OAAA;AAGX,YAAY;AACZ,iCAA8C;AAArC,4GAAA,mBAAmB,OAAA;AAE5B,+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/lib/packlets/zip-archive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/lib/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,6CAA+B;AAItB,oBAAI;AAHb,mDAAqC;AAGtB,0BAAO;AAEtB,eAAe;AACf,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAgBzB,mBAAmB;AACnB,uDAU4B;AAT1B,4HAAA,wBAAwB,OAAA;AACxB,2HAAA,uBAAuB,OAAA;AACvB,8HAAA,0BAA0B,OAAA;AAC1B,gIAAA,4BAA4B,OAAA;AAC5B,8HAAA,0BAA0B,OAAA;AAC1B,iHAAA,aAAa,OAAA;AACb,oHAAA,gBAAgB,OAAA;AAChB,oHAAA,gBAAgB,OAAA;AAChB,6GAAA,SAAS,OAAA;AAGX,YAAY;AACZ,iCAA8C;AAArC,4GAAA,mBAAmB,OAAA","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/lib/packlets/zip-archive/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/json.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB;IACrB,cAAc,EAAE,kBAAkB,EAAE,CAAC;CACtC"}

package/lib/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/lib/packlets/zip-archive/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/types.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC;IAClC,kCAAkC;IAClC,UAAU,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,0BAA0B,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,SAAS,EAAE,UAAU,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,QAAQ,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC,oBAAoB,GAAG,SAAS,CAAC;IACrD,2CAA2C;IAC3C,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,uCAAuC;IACvC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EACD,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,sBAAsB,GACtB,cAAc,EAClB,QAAQ,EAAE,MAAM,EAAE,QAAQ;AAC1B,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;AAEV;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,yBAAyB;;IAEzB,8BAA8B;;IAE9B,4BAA4B;;IAE5B,oCAAoC;;CAE5B,CAAC"}

package/lib/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;AACU,QAAA,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/lib/packlets/zip-archive/zipArchiveCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveCreator.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveCreator.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAIhG;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;;;OAKG;IACU,gBAAgB,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,CAAC,EAAE,0BAA0B,GACtC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAkGrC;;;;;;OAMG;YACW,qBAAqB;IAYnC;;;;;;;OAOG;YACW,sBAAsB;IAoCpC,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,sBAAsB;CAY/B"}

package/lib/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/lib/packlets/zip-archive/zipArchiveFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveFormat.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveFormat.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAG/B;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAAC,mBAAmB,CAmB1B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAO9F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAOzG;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/lib/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/lib/packlets/zip-archive/zipArchiveLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveLoader.d.ts","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveLoader.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAItD,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAG3B,MAAM,SAAS,CAAC;AAKjB;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACU,YAAY,CACvB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,sBAA2B,EACpC,UAAU,CAAC,EAAE,0BAA0B,GACtC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAkBzC;;;;;;OAMG;IACU,cAAc,CACzB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,sBAA2B,EACpC,UAAU,CAAC,EAAE,0BAA0B,GACtC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAkDzC;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAiBlC;;;;;;OAMG;IACH,OAAO,CAAC,+BAA+B;IAwBvC;;;;;OAKG;YACW,0BAA0B;IAmCxC;;;;;;;;;OASG;YACW,qBAAqB;IAsDnC;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAuBrB"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveLoader.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveLoader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AAEtD,4EAA4E;AAC5E,8CAA6C;AAU7C,yDAAsG;AAEtG;;;GAGG;AACH,MAAa,gBAAgB;IAC3B;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CACvB,IAAU,EACV,UAAkC,EAAE,EACpC,UAAuC;QAEvC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,cAAc,EAAE,CAAC,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9D,IAAI,CAAC,IAAA,4BAAS,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAA,eAAI,EAAC,QAAQ,IAAI,CAAC,IAAI,oBAAoB,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,cAAc,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC;YAExD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YAC9D,gEAAgE;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CACzB,MAAmB,EACnB,UAAkC,EAAE,EACpC,UAAuC;QAEvC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,aAAa,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAEtD,MAAM,kBAAkB,GAAG,uBAAW,CAAC,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/E,IAAI,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;YACnC,OAAO,IAAA,eAAI,EAAC,wBAAwB,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC;QAC9C,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,aAAa,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAEvD,gBAAgB;QAChB,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAA,eAAI,EAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC;QACtC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAEzD,qBAAqB;QACrB,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,gBAAgB,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,+BAA+B,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3F,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;YAC7B,OAAO,IAAA,eAAI,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC;QAClC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,gBAAgB,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAE5D,wCAAwC;QACxC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACxD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACpF,gEAAgE;QAChE,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YAC5B,OAAO,IAAA,eAAI,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC;QAC/C,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,GAAG,EAAE,aAAa,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAEzE,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAE9D,OAAO,IAAA,kBAAO,EAAC;YACb,QAAQ;YACR,MAAM;YACN,KAAK;YACL,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,0BAA0B,CAChC,YAA8C;QAE9C,MAAM,cAAc,GAAG,YAAY,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QACrE,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,uDAAuD;YACvD,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,0CAAuB,EAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YAC5B,OAAO,IAAA,eAAI,EAAC,kCAAkC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,IAAA,kBAAO,EAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACK,+BAA+B,CACrC,YAA8C,EAC9C,QAA8C,EAC9C,OAA+B;QAE/B,4CAA4C;QAC5C,MAAM,uBAAuB,GAAG,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,MAAK,SAAS,CAAC;QAE/D,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,yDAAyD;YACzD,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAED,wCAAwC;QACxC,MAAM,UAAU,GAAG,QAAS,CAAC,MAAO,CAAC,WAAW,CAAC;QACjD,OAAO,YAAY;aAChB,eAAe,CAAC,UAAU,CAAC;aAC3B,eAAe,CACd,GAAG,EAAE,CAAC,sCAAsC,UAAU,mCAAmC,CAC1F;aACA,SAAS,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,IAAA,+CAA4B,EAAC,aAAa,CAAC,CAAC;aACzE,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gCAAgC,UAAU,MAAM,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,0BAA0B,CACtC,YAA8C,EAC9C,UAAuC;QAEvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAoB,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;YAE1D,6BAA6B;YAC7B,MAAM,kBAAkB,GAAG,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzD,gEAAgE;YAChE,IAAI,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACnC,OAAO,IAAA,eAAI,EAAC,gCAAgC,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,gCAAgC;YAChC,MAAM,IAAI,CAAC,qBAAqB,CAC9B,YAAY,EACZ,GAAG,EACH,kBAAkB,CAAC,KAAK,EACxB,KAAK,EACL,WAAW,EACX,UAAU,CACX,CAAC;YAEF,4BAA4B;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAEpE,OAAO,IAAA,kBAAO,EAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACrC,gEAAgE;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,qBAAqB,CACjC,YAA8C,EAC9C,WAAmB,EACnB,KAAuC,EACvC,KAAsB,EACtB,WAA4C,EAC5C,UAAuC,EACvC,YAA+B,EAAE,KAAK,EAAE,CAAC,EAAE;QAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,yCAAyC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YAExG,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC9B,kBAAkB;gBAClB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/B,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE;wBACxB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,KAAK,EAAE,EAAE;wBACT,cAAc,EAAE,EAAE;qBACnB,CAAC,CAAC;gBACL,CAAC;gBAED,+BAA+B;gBAC/B,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACnE,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC/B,MAAM,IAAI,CAAC,qBAAqB,CAC9B,YAAY,EACZ,IAAI,CAAC,YAAY,EACjB,cAAc,CAAC,KAAK,EACpB,KAAK,EACL,WAAW,EACX,UAAU,EACV,SAAS,CACV,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAChC,mBAAmB;gBACnB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBAE5C,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,QAAQ;oBACd,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;iBACnC,CAAC,CAAC;YACL,CAAC;YAED,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,kBAAkB,EAAE,CAAC,EAAE,cAAc,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,wBAAwB,CAC9B,KAAsB,EACtB,WAA4C;QAE5C,wDAAwD;QACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAuB;YAClC,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,EAAE;YACT,cAAc,EAAE,EAAE;SACnB,CAAC;QAEF,6CAA6C;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEjF,6DAA6D;YAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAErC,sCAAsC;YACtC,IAAI,UAAU,GAAG,OAAO,CAAC;YACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;gBAEzE,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG;wBACT,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE;wBACT,cAAc,EAAE,EAAE;qBACnB,CAAC;oBACF,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC3C,CAAC;gBAED,UAAU,GAAG,QAAQ,CAAC;YACxB,CAAC;YAED,mCAAmC;YACnC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACK,YAAY,CAAC,QAAgB;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACpD,mDAAmD;QACnD,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM;gBACT,OAAO,kBAAkB,CAAC;YAC5B,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK;gBACR,OAAO,kBAAkB,CAAC;YAC5B,KAAK,KAAK;gBACR,OAAO,iBAAiB,CAAC;YAC3B,KAAK,KAAK;gBACR,OAAO,YAAY,CAAC;YACtB,KAAK,IAAI;gBACP,OAAO,eAAe,CAAC;YACzB,KAAK,IAAI;gBACP,OAAO,wBAAwB,CAAC;YAClC,KAAK,IAAI;gBACP,OAAO,wBAAwB,CAAC;YAClC;gBACE,OAAO,0BAA0B,CAAC;QACtC,CAAC;IACH,CAAC;CACF;AA1UD,4CA0UC","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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-res",
-  "version": "5.1.0-3",
+  "version": "5.1.0-30",
   "description": "Multi-dimensional Resource Runtime",
   "main": "lib/index.js",
   "types": "dist/ts-res.d.ts",
@@ -39,22 +39,24 @@
     "typescript": "5.9.3",
     "eslint-plugin-n": "^17.23.1",
     "@rushstack/eslint-config": "4.6.4",
-    "@rushstack/heft": "1.2.6",
+    "@rushstack/heft": "1.2.7",
     "@rushstack/heft-jest-plugin": "1.2.6",
-    "@rushstack/heft-node-rig": "2.11.26",
+    "@rushstack/heft-node-rig": "2.11.27",
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-tsdoc": "~0.5.2",
-    "@fgv/ts-utils-jest": "5.1.0-3",
-    "@fgv/heft-dual-rig": "5.1.0-3",
-    "@fgv/ts-extras": "5.1.0-3"
+    "typedoc": "~0.28.16",
+    "@fgv/heft-dual-rig": "5.1.0-30",
+    "@fgv/typedoc-compact-theme": "5.1.0-30",
+    "@fgv/ts-extras": "5.1.0-30",
+    "@fgv/ts-utils-jest": "5.1.0-30"
   },
   "dependencies": {
     "luxon": "^3.7.2",
     "fflate": "~0.8.2",
-    "@fgv/ts-utils": "5.1.0-3",
-    "@fgv/ts-json-base": "5.1.0-3",
-    "@fgv/ts-bcp47": "5.1.0-3",
-    "@fgv/ts-json": "5.1.0-3"
+    "@fgv/ts-utils": "5.1.0-30",
+    "@fgv/ts-json": "5.1.0-30",
+    "@fgv/ts-bcp47": "5.1.0-30",
+    "@fgv/ts-json-base": "5.1.0-30"
   },
   "exports": {
     ".": {

package/dist/test/data/sample.json

@@ -1,32 +0,0 @@
-[
-  {
-    "id": "some.resource.path",
-    "json": { "home": "United States" },
-    "conditions": {
-      "homeTerritory": "US"
-    }
-  },
-  {
-    "id": "some.resource.path",
-    "json": { "speaks": "English" },
-    "conditions": {
-      "language": "en"
-    }
-  },
-  {
-    "id": "some.resource.path",
-    "json": { "home": "Canada", "speaks": "Canadian English" },
-    "conditions": {
-      "homeTerritory": "CA",
-      "language": "en-CA"
-    },
-    "mergeMethod": "replace"
-  },
-  {
-    "id": "some.resource.path",
-    "json": { "speaks": "Español" },
-    "conditions": {
-      "language": "es"
-    }
-  }
-]

package/dist/test/unit/qualifier-types/testQualifierType.js

@@ -1,76 +0,0 @@
-/*
- * 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 { captureResult, fail, succeed } from '@fgv/ts-utils';
-import * as TsRes from '../../../index';
-export class TestQualifierType extends TsRes.QualifierTypes.QualifierType {
-    constructor(params) {
-        var _a;
-        super({
-            name: (_a = params === null || params === void 0 ? void 0 : params.name) !== null && _a !== void 0 ? _a : 'test',
-            allowContextList: (params === null || params === void 0 ? void 0 : params.allowContextList) === 'true',
-            index: params === null || params === void 0 ? void 0 : params.index
-        });
-        this.systemTypeName = TsRes.Convert.qualifierTypeName
-            .convert('test')
-            .orThrow();
-    }
-    static create(params) {
-        return captureResult(() => new TestQualifierType(params));
-    }
-    isValidConditionValue(value) {
-        return true;
-    }
-    validateCondition(value, operator) {
-        return this.isValidConditionValue(value) ? succeed(value) : fail(`Invalid condition value: ${value}`);
-    }
-    getConfigurationJson() {
-        return succeed({
-            name: this.name,
-            systemType: 'test',
-            configuration: {}
-        });
-    }
-    validateConfigurationJson(from) {
-        // Simple validation for test class
-        if (typeof from !== 'object' || from === null) {
-            return fail('Expected object');
-        }
-        const obj = from;
-        if (typeof obj.name !== 'string') {
-            return fail('name must be string');
-        }
-        if (obj.systemType !== 'test') {
-            return fail('systemType must be test');
-        }
-        return succeed(from);
-    }
-    _matchOne(condition, context, operator) {
-        if (condition === context) {
-            return TsRes.PerfectMatch;
-        }
-        if (condition.toLowerCase() === context.toLowerCase()) {
-            return 0.5;
-        }
-        return TsRes.NoMatch;
-    }
-}
-//# sourceMappingURL=testQualifierType.js.map

package/dist/test/unit/resource-types/testDerivedResourceType.js

@@ -1,109 +0,0 @@
-/*
- * 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 { captureResult, fail, succeed } from '@fgv/ts-utils';
-import { Convert } from '../../../packlets/common';
-// eslint-disable-next-line @rushstack/packlets/mechanics
-import { ResourceType } from '../../../packlets/resource-types/resourceType';
-/**
- * A derived resource type for testing that demonstrates:
- * 1. Custom validation logic
- * 2. Using a resource resolver to look up template values
- * 3. Type-specific defaults and error handling
- */
-export class TestDerivedResourceType extends ResourceType {
-    constructor(key, index, template, templateResourceId) {
-        super(key, index, template);
-        this.systemTypeName = Convert.resourceTypeName
-            .convert('test-derived')
-            .orThrow();
-        this._templateResourceId = templateResourceId;
-    }
-    /**
-     * Factory method to create a new TestDerivedResourceType instance.
-     */
-    static create(params) {
-        var _a;
-        return Convert.resourceTypeName.convert((_a = params === null || params === void 0 ? void 0 : params.key) !== null && _a !== void 0 ? _a : 'test-derived').onSuccess((key) => {
-            return captureResult(() => new TestDerivedResourceType(key, params === null || params === void 0 ? void 0 : params.index, params === null || params === void 0 ? void 0 : params.template, params === null || params === void 0 ? void 0 : params.templateResourceId));
-        });
-    }
-    /**
-     * Validates a resource candidate declaration with custom logic.
-     */
-    validateDeclaration(props) {
-        // Custom validation: merge method must be 'replace' for full candidates
-        if (props.completeness === 'full' && props.mergeMethod !== 'replace') {
-            return fail(`${this.key}: Full candidates must use 'replace' merge method, got '${props.mergeMethod}'`);
-        }
-        return this.validate(props.json, props.completeness);
-    }
-    validate(json, completeness) {
-        if (typeof json !== 'object' || json === null || Array.isArray(json)) {
-            return fail(`${this.key}: Expected JSON object, got ${typeof json}`);
-        }
-        const obj = json;
-        // Validate required title field for full resources
-        if (completeness === 'full' && (typeof obj.title !== 'string' || !obj.title.trim())) {
-            return fail(`${this.key}: 'title' field is required and must be a non-empty string`);
-        }
-        // Validate optional description
-        if (obj.description !== undefined && typeof obj.description !== 'string') {
-            return fail(`${this.key}: 'description' field must be a string if provided`);
-        }
-        // Validate optional metadata
-        if (obj.metadata !== undefined) {
-            if (typeof obj.metadata !== 'object' || obj.metadata === null || Array.isArray(obj.metadata)) {
-                return fail(`${this.key}: 'metadata' field must be an object if provided`);
-            }
-        }
-        const result = Object.assign(Object.assign(Object.assign({}, (obj.title && { title: obj.title })), (obj.description && { description: obj.description })), (obj.metadata && { metadata: obj.metadata }));
-        return succeed(result);
-    }
-    /**
-     * Override to demonstrate looking up template values from another resource.
-     */
-    getDefaultTemplateCandidate(json, conditions, resolver) {
-        // If a template resource ID is configured and resolver is available, try to resolve it
-        if (this._templateResourceId && resolver && !json) {
-            return resolver
-                .resolveComposedResourceValue(this._templateResourceId)
-                .onFailure((error) => fail(`${this.key}: Failed to resolve template resource '${this._templateResourceId}': ${error}`))
-                .onSuccess((resolvedValue) => {
-                // Use the resolved value as our JSON template
-                return super.getDefaultTemplateCandidate(resolvedValue, conditions, resolver);
-            });
-        }
-        // Use provided JSON or fall back to base implementation
-        return super.getDefaultTemplateCandidate(json, conditions, resolver);
-    }
-    /**
-     * Override createTemplate to add additional validation for the derived type.
-     */
-    createTemplate(resourceId, init, conditions, resolver) {
-        // Additional validation: warn if trying to use resolver functionality without a resolver
-        if (this._templateResourceId && !resolver) {
-            return fail(`${this.key}: Template resource ID '${this._templateResourceId}' is configured but no resolver provided`);
-        }
-        return super.createTemplate(resourceId, init, conditions, resolver);
-    }
-}
-//# sourceMappingURL=testDerivedResourceType.js.map