npm - @fgv/ts-res - Versions diffs - 5.1.0-19 → 5.1.0-20 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (443) hide show

package/lib/packlets/runtime/resourceResolver.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"resourceResolver.js","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceResolver.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, fail, succeed } from '@fgv/ts-utils';\nimport { JsonValue, JsonObject, isJsonObject } from '@fgv/ts-json-base';\nimport { JsonEditor } from '@fgv/ts-json';\nimport { IResourceResolver, NoMatch, ResourceId } from '../common';\nimport { Condition, ConditionSet } from '../conditions';\nimport { AbstractDecision } from '../decisions';\nimport { ReadOnlyQualifierTypeCollector } from '../qualifier-types';\nimport { IContextQualifierProvider, ValidatingSimpleContextQualifierProvider } from './context';\nimport { IResourceManager, IResource, IResourceCandidate } from './iResourceManager';\nimport {\n ConditionMatchType,\n ConditionSetResolutionResult,\n IConditionMatchResult\n} from './conditionSetResolutionResult';\nimport { IResourceResolverCacheListener } from './cacheListener';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\n\n/**\n * Represents the cached result of resolving a decision.\n * Contains either a failure indicator or a list of instance indices for matching condition sets,\n * ordered by condition set priority.\n * @public\n */\nexport type DecisionResolutionResult =\n | { success: false }\n | { success: true; instanceIndices: ReadonlyArray<number>; defaultInstanceIndices: ReadonlyArray<number> };\n\n/**\n * Options for configuring a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverOptions {\n /**\n * Controls whether null values in resource composition should suppress properties\n * instead of setting them to null. When true, properties with null values from\n * higher-priority partial candidates will be omitted from the final composed resource.\n * @defaultValue false\n */\n suppressNullAsDelete?: boolean;\n}\n\n/**\n * Parameters for creating a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverCreateParams {\n /**\n * The {@link Runtime.IResourceManager | resource manager} that defines the resources available\n * and provides access to qualifiers and conditions.\n */\n resourceManager: IResourceManager;\n\n /**\n * The {@link QualifierTypes.ReadOnlyQualifierTypeCollector | readonly qualifier type collector}\n * that provides qualifier implementations for condition evaluation.\n */\n qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n /**\n * The {@link Runtime.Context.IContextQualifierProvider | context qualifier provider} that resolves\n * qualifier values for the current context.\n */\n contextQualifierProvider: IContextQualifierProvider;\n\n /**\n * An optional listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n */\n listener?: IResourceResolverCacheListener;\n\n /**\n * Optional configuration options for the {@link Runtime.ResourceResolver | ResourceResolver}.\n */\n options?: IResourceResolverOptions;\n}\n\n/**\n * High-performance runtime resource resolver with O(1) condition caching.\n * Resolves resources for a given context by evaluating conditions against qualifier values\n * and caching results for optimal performance.\n * @public\n */\nexport class ResourceResolver implements IResourceResolver {\n /**\n * The resource manager that defines available resources and provides condition access.\n */\n public readonly resourceManager: IResourceManager;\n\n /**\n * The readonly qualifier type collector that provides qualifier implementations.\n */\n public readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n /**\n * The context qualifier provider that resolves qualifier values.\n */\n public readonly contextQualifierProvider: IContextQualifierProvider;\n\n /**\n * The configuration options for this resource resolver.\n */\n public readonly options: IResourceResolverOptions;\n\n /**\n * The readonly qualifier collector that provides qualifier implementations.\n */\n public get qualifiers(): IReadOnlyQualifierCollector {\n return this.contextQualifierProvider.qualifiers;\n }\n\n /**\n * The resource IDs that this resolver can resolve.\n */\n public get resourceIds(): ReadonlyArray<ResourceId> {\n return this.resourceManager.resourceIds;\n }\n\n /**\n * The cache array for resolved conditions, indexed by condition index for O(1) lookup.\n * Each entry stores the resolved {@link Runtime.IConditionMatchResult | condition match result} for\n * the corresponding condition.\n */\n public get conditionCache(): ReadonlyArray<IConditionMatchResult | undefined> {\n return this._conditionCache;\n }\n\n /**\n * The cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n */\n public get conditionSetCache(): ReadonlyArray<ConditionSetResolutionResult | undefined> {\n return this._conditionSetCache;\n }\n\n /**\n * The cache array for resolved decisions, indexed by decision index for O(1) lookup.\n * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n */\n public get decisionCache(): ReadonlyArray<DecisionResolutionResult | undefined> {\n return this._decisionCache;\n }\n\n /**\n * Cache array for resolved conditions, indexed by condition index for O(1) lookup.\n * Each entry stores the resolved QualifierMatchScore for the corresponding condition.\n */\n private readonly _conditionCache: Array<IConditionMatchResult | undefined>;\n\n /**\n * Cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n */\n private readonly _conditionSetCache: Array<ConditionSetResolutionResult | undefined>;\n\n /**\n * Cache array for resolved decisions, indexed by decision index for O(1) lookup.\n * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n */\n private readonly _decisionCache: Array<DecisionResolutionResult | undefined>;\n\n /**\n * The listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n */\n private readonly _listener?: IResourceResolverCacheListener;\n\n /**\n * Constructor for a {@link Runtime.ResourceResolver | ResourceResolver} object.\n * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n */\n protected constructor(params: IResourceResolverCreateParams) {\n this.resourceManager = params.resourceManager;\n this.qualifierTypes = params.qualifierTypes;\n this.contextQualifierProvider = params.contextQualifierProvider;\n this.options = {\n suppressNullAsDelete: params.options?.suppressNullAsDelete ?? false\n };\n\n // Initialize condition cache array with size matching the condition collector\n const conditionCollectorSize = this.resourceManager.conditions.size;\n this._conditionCache = new Array<IConditionMatchResult | undefined>(conditionCollectorSize);\n\n // Initialize condition set cache array with size matching the condition set collector\n const conditionSetCollectorSize = this.resourceManager.conditionSets.size;\n this._conditionSetCache = new Array<ConditionSetResolutionResult | undefined>(conditionSetCollectorSize);\n\n // Initialize decision cache array with size matching the decision collector\n const decisionCollectorSize = this.resourceManager.decisions.size;\n this._decisionCache = new Array<DecisionResolutionResult | undefined>(decisionCollectorSize);\n\n this._listener = params.listener;\n }\n\n /**\n * Creates a new {@link Runtime.ResourceResolver | ResourceResolver} object.\n * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n * @returns `Success` with the new {@link Runtime.ResourceResolver | ResourceResolver} object if successful,\n * or `Failure` with an error message if not.\n * @public\n */\n public static create(params: IResourceResolverCreateParams): Result<ResourceResolver> {\n return captureResult(() => new ResourceResolver(params));\n }\n\n /**\n * Resolves a condition by evaluating it against the current context.\n * Uses O(1) caching based on the condition's globally unique sequential index.\n * @param condition - The {@link Conditions.Condition | condition} to resolve.\n * @returns `Success` with the {@link QualifierMatchScore | match score} if successful,\n * or `Failure` with an error message if the condition cannot be resolved.\n * @public\n */\n public resolveCondition(condition: Condition): Result<IConditionMatchResult> {\n // Get the condition's index for cache lookup\n const conditionIndex = condition.index;\n if (conditionIndex === undefined) {\n return fail(`Condition \"${condition.key}\" does not have a valid index`);\n }\n\n // Check cache first for O(1) lookup\n const cachedResult = this._conditionCache[conditionIndex];\n if (cachedResult !== undefined) {\n this._listener?.onCacheHit('condition', conditionIndex);\n return succeed(cachedResult);\n }\n\n // Resolve the condition by getting qualifier value and evaluating with qualifier type\n const score = this.contextQualifierProvider\n .get(condition.qualifier)\n .onSuccess((qualifierValue) => {\n // Evaluate the condition using the qualifier type's matching logic\n return succeed(condition.qualifier.type.matches(condition.value, qualifierValue, condition.operator));\n })\n .onFailure((err) => {\n this._listener?.onContextError(condition.qualifier.name, err);\n return fail(err);\n })\n .orDefault(NoMatch);\n\n const priority = condition.priority;\n const scoreAsDefault = condition.scoreAsDefault ?? NoMatch;\n const matchResult: IConditionMatchResult =\n score > NoMatch\n ? { score, priority, matchType: 'match' }\n : scoreAsDefault > NoMatch\n ? { score: scoreAsDefault, priority, matchType: 'matchAsDefault' }\n : { score: NoMatch, priority, matchType: 'noMatch' };\n\n // Cache the resolved value for future O(1) lookup\n this._conditionCache[conditionIndex] = matchResult;\n this._listener?.onCacheMiss('condition', conditionIndex);\n\n return succeed(matchResult);\n }\n\n /**\n * Resolves a condition set by evaluating all its constituent conditions against the current context.\n * Uses O(1) caching based on the condition set's globally unique sequential index.\n * @param conditionSet - The {@link Conditions.ConditionSet | condition set} to resolve.\n * @returns `Success` with the {@link Runtime.ConditionSetResolutionResult | resolution result} if successful,\n * or `Failure` with an error message if the condition set cannot be resolved.\n * @public\n */\n public resolveConditionSet(conditionSet: ConditionSet): Result<ConditionSetResolutionResult> {\n // Get the condition set's index for cache lookup\n const conditionSetIndex = conditionSet.index;\n if (conditionSetIndex === undefined) {\n return fail(`ConditionSet \"${conditionSet.key}\" does not have a valid index`);\n }\n\n // Check cache first for O(1) lookup\n const cachedResult = this._conditionSetCache[conditionSetIndex];\n if (cachedResult !== undefined) {\n this._listener?.onCacheHit('conditionSet', conditionSetIndex);\n return succeed(cachedResult);\n }\n\n // Resolve all conditions in the condition set\n const conditions: Array<IConditionMatchResult> = [];\n let matchType: ConditionMatchType = 'match';\n\n for (const condition of conditionSet.conditions) {\n const { value: conditionResult, message: conditionMessage } = this.resolveCondition(condition);\n\n /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n if (conditionMessage !== undefined) {\n this._listener?.onCacheError('conditionSet', conditionSetIndex);\n return fail(`Failed to resolve condition \"${condition.key}\": ${conditionMessage}`);\n }\n\n conditions.push(conditionResult);\n\n if (conditionResult.matchType === 'noMatch') {\n // Cache the failure result\n return ConditionSetResolutionResult.create('noMatch', conditions)\n .onSuccess((result) => {\n this._conditionSetCache[conditionSetIndex] = result;\n this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n return succeed(result);\n })\n .onFailure((err) => {\n /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n this._conditionSetCache[conditionSetIndex] = undefined;\n this._listener?.onCacheError('conditionSet', conditionSetIndex);\n return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n });\n }\n\n /* c8 ignore next 3 - edge case: matchAsDefault fallback logic rarely triggered */\n if (conditionResult.matchType === 'matchAsDefault') {\n matchType = 'matchAsDefault';\n }\n }\n\n // Cache the successful result\n return ConditionSetResolutionResult.create(matchType, conditions)\n .onSuccess((result) => {\n this._conditionSetCache[conditionSetIndex] = result;\n this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n return succeed(result);\n })\n .onFailure((err) => {\n /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n this._conditionSetCache[conditionSetIndex] = undefined;\n this._listener?.onCacheError('conditionSet', conditionSetIndex);\n return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n });\n }\n\n /**\n * Resolves a decision by evaluating all its constituent condition sets against the current context.\n * Uses O(1) caching based on the decision's globally unique sequential index.\n * @param decision - The {@link Decisions.AbstractDecision | abstract decision} to resolve.\n * @returns `Success` with the {@link Runtime.DecisionResolutionResult | resolution result} if successful,\n * or `Failure` with an error message if the decision cannot be resolved.\n * @public\n */\n public resolveDecision(decision: AbstractDecision): Result<DecisionResolutionResult> {\n // Get the decision's index for cache lookup\n const decisionIndex = decision.index;\n if (decisionIndex === undefined) {\n return fail(`Decision \"${decision.key}\" does not have a valid index`);\n }\n\n // Check cache first for O(1) lookup\n const cachedResult = this._decisionCache[decisionIndex];\n if (cachedResult !== undefined) {\n this._listener?.onCacheHit('decision', decisionIndex);\n return succeed(cachedResult);\n }\n\n // Resolve all condition sets in the decision\n const matchingInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n const matchingDefaultInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n\n for (let instanceIndex = 0; instanceIndex < decision.candidates.length; instanceIndex++) {\n const candidate = decision.candidates[instanceIndex];\n const conditionSetResult = this.resolveConditionSet(candidate.conditionSet);\n\n /* c8 ignore next 4 - defensive in depth */\n if (conditionSetResult.isFailure()) {\n this._listener?.onCacheError('decision', decisionIndex);\n return fail(`${decision.key}: Failed to resolve condition set\": ${conditionSetResult.message}`);\n }\n\n const resolution = conditionSetResult.value;\n\n // Only include condition sets that match\n if (resolution.matchType === 'match') {\n matchingInstanceResults.push({\n index: instanceIndex,\n result: resolution\n });\n } else if (resolution.matchType === 'matchAsDefault') {\n matchingDefaultInstanceResults.push({\n index: instanceIndex,\n result: resolution\n });\n }\n // If condition set doesn't match, we simply skip it and continue (don't fail the decision)\n }\n\n // Sort by condition set resolution priority using the proper comparison logic\n matchingInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n matchingDefaultInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n\n // Extract just the instance indices in priority order\n const instanceIndices = matchingInstanceResults.map((item) => item.index);\n const defaultInstanceIndices = matchingDefaultInstanceResults.map((item) => item.index);\n\n // Cache the successful result\n const successResult: DecisionResolutionResult = {\n success: true,\n instanceIndices,\n defaultInstanceIndices\n };\n this._decisionCache[decisionIndex] = successResult;\n this._listener?.onCacheMiss('decision', decisionIndex);\n\n return succeed(successResult);\n }\n\n /**\n * Resolves a resource by finding the best matching candidate.\n * Uses the resource's associated decision to determine the best match based on the current context.\n * @param resource - The {@link Resources.Resource | resource} to resolve.\n * @returns `Success` with the best matching candidate if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveResource(resource: IResource): Result<IResourceCandidate>;\n\n /**\n * Resolves a resource by finding the best matching candidate.\n * Uses the resource's associated decision to determine the best match based on the current context.\n * @param resource - The string id of the resource to resolve.\n * @returns `Success` with the best matching candidate if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveResource(resource: string): Result<IResourceCandidate>;\n public resolveResource(idOrResource: string | IResource): Result<IResourceCandidate> {\n /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n if (typeof idOrResource === 'string') {\n return this.resourceManager\n .getBuiltResource(idOrResource)\n .onSuccess((resource) => this.resolveResource(resource));\n }\n\n const resource = idOrResource;\n\n // Get the abstract decision from the resource's concrete decision\n const abstractDecision = resource.decision.baseDecision;\n\n // Resolve the decision to get candidate indices in priority order\n const decisionResult = this.resolveDecision(abstractDecision);\n /* c8 ignore next 3 - defense in depth almost impossible to hit */\n if (decisionResult.isFailure()) {\n return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n }\n\n const resolution = decisionResult.value;\n\n // Check if any candidates matched (regular or default)\n if (\n !resolution.success ||\n (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n ) {\n return fail(`No matching candidates found for resource \"${resource.id}\"`);\n }\n\n // Prefer regular matches over default matches\n const candidateIndex =\n resolution.instanceIndices.length > 0\n ? resolution.instanceIndices[0] // Best regular match\n : resolution.defaultInstanceIndices[0]; // Best default match\n\n if (candidateIndex >= resource.candidates.length) {\n return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n }\n\n const bestCandidate = resource.candidates[candidateIndex];\n return succeed(bestCandidate);\n }\n\n /**\n * Resolves all matching resource candidates in priority order.\n * Uses the resource's associated decision to determine all matching candidates based on the current context.\n * @param resource - The {@link Resources.Resource | resource} to resolve.\n * @returns `Success` with an array of all matching candidates in priority order if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveAllResourceCandidates(resource: IResource): Result<ReadonlyArray<IResourceCandidate>>;\n\n /**\n * Resolves all matching resource candidates in priority order.\n * Uses the resource's associated decision to determine all matching candidates based on the current context.\n * @param resource - The string id of the resource to resolve.\n * @returns `Success` with an array of all matching candidates in priority order if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveAllResourceCandidates(resource: string): Result<ReadonlyArray<IResourceCandidate>>;\n public resolveAllResourceCandidates(\n idOrResource: string | IResource\n ): Result<ReadonlyArray<IResourceCandidate>> {\n if (typeof idOrResource === 'string') {\n return this.resourceManager\n .getBuiltResource(idOrResource)\n .onSuccess((resource) => this.resolveAllResourceCandidates(resource));\n }\n\n const resource = idOrResource;\n\n // Get the abstract decision from the resource's concrete decision\n const abstractDecision = resource.decision.baseDecision;\n\n // Resolve the decision to get candidate indices in priority order\n const decisionResult = this.resolveDecision(abstractDecision);\n /* c8 ignore next 3 - defense in depth almost impossible to hit */\n if (decisionResult.isFailure()) {\n return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n }\n\n const resolution = decisionResult.value;\n\n // Check if any candidates matched (regular or default)\n if (\n !resolution.success ||\n (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n ) {\n return fail(`No matching candidates found for resource \"${resource.id}\"`);\n }\n\n // Get all matching candidates: regular matches first, then default matches\n const candidates: IResourceCandidate[] = [];\n\n // Add all regular matches first (already sorted by priority)\n for (const candidateIndex of resolution.instanceIndices) {\n if (candidateIndex >= resource.candidates.length) {\n return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n }\n const candidate = resource.candidates[candidateIndex];\n candidates.push(candidate);\n }\n\n // Add all default matches after regular matches (already sorted by priority)\n for (const candidateIndex of resolution.defaultInstanceIndices) {\n /* c8 ignore next 3 - defense in depth should not happen */\n if (candidateIndex >= resource.candidates.length) {\n return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n }\n const candidate = resource.candidates[candidateIndex];\n candidates.push(candidate);\n }\n\n return succeed(candidates);\n }\n\n /**\n * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n * priority \"partial\" candidates into it in ascending order of priority.\n * @param resource - The {@link Resources.Resource | resource} to resolve.\n * @returns `Success` with the composed JsonValue if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveComposedResourceValue(resource: IResource): Result<JsonValue>;\n\n /**\n * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n * priority \"partial\" candidates into it in ascending order of priority.\n * @param resource - The string id of the resource to resolve.\n * @returns `Success` with the composed JsonValue if successful,\n * or `Failure` with an error message if no candidates match or resolution fails.\n * @public\n */\n public resolveComposedResourceValue(resource: string): Result<JsonValue>;\n public resolveComposedResourceValue(idOrResource: string | IResource): Result<JsonValue> {\n /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n if (typeof idOrResource === 'string') {\n return this.resourceManager\n .getBuiltResource(idOrResource)\n .onSuccess((resource) => this.resolveComposedResourceValue(resource));\n }\n\n const resource = idOrResource;\n\n return this.resolveAllResourceCandidates(resource).onSuccess((candidates) => {\n /* c8 ignore next 3 - defense in depth should never occur */\n if (candidates.length === 0) {\n return fail(`${resource.id}: No matching candidates found.`);\n }\n\n // Find the first full candidate and collect all partial candidates above it\n let fullCandidateIndex = -1;\n const partialCandidates: IResourceCandidate[] = [];\n\n for (let i = 0; i < candidates.length; i++) {\n const candidate = candidates[i];\n if (!candidate.isPartial) {\n // Found the first full candidate\n fullCandidateIndex = i;\n break;\n } else {\n // Collect partial candidates (these are in ascending priority order)\n partialCandidates.unshift(candidate);\n }\n }\n\n // If no full candidate found, use the last candidate as the base\n const baseCandidateIndex = fullCandidateIndex >= 0 ? fullCandidateIndex : candidates.length - 1;\n const baseCandidate = candidates[baseCandidateIndex];\n\n // If there are no partial candidates to merge, but null-as-delete is enabled,\n // still process through JsonEditor to handle null properties in the base candidate\n if (partialCandidates.length === 0) {\n if (this.options.suppressNullAsDelete || !isJsonObject(baseCandidate.json)) {\n return succeed(baseCandidate.json);\n }\n\n // Process single candidate through JsonEditor to apply null-as-delete\n const editor = JsonEditor.create({\n merge: {\n arrayMergeBehavior: 'replace',\n nullAsDelete: true\n }\n }).orThrow(); // Should never fail with valid options\n\n return editor\n .mergeObjectsInPlace({}, [baseCandidate.json])\n .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n }\n\n const allCandidates = [\n baseCandidate.json,\n ...partialCandidates.map((candidate) => candidate.json)\n ].filter((v): v is JsonObject => isJsonObject(v));\n\n /* c8 ignore next 3 - defensive check: non-object values in resource candidates should be prevented at validation time */\n if (allCandidates.length !== partialCandidates.length + 1) {\n return fail(`${resource.id}: Unable to compose non-object candidate values.`);\n }\n\n // Create JsonEditor with array replacement behavior and null-as-delete for resource composition\n const editor = JsonEditor.create({\n merge: {\n arrayMergeBehavior: 'replace',\n nullAsDelete: !this.options.suppressNullAsDelete\n }\n }).orThrow(); // Should never fail with valid options\n\n return editor\n .mergeObjectsInPlace({}, allCandidates)\n .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n });\n }\n\n /**\n * {@inheritDoc IResourceResolver.withContext}\n */\n public withContext(context: Record<string, string>): Result<ResourceResolver> {\n const { resourceManager, qualifierTypes, options } = this;\n return ValidatingSimpleContextQualifierProvider.create({\n qualifiers: this.qualifiers,\n qualifierValues: context\n }).onSuccess((contextQualifierProvider) => {\n return ResourceResolver.create({\n resourceManager,\n qualifierTypes,\n options,\n contextQualifierProvider\n });\n });\n }\n\n /**\n * Clears all caches (condition, condition set, and decision), forcing all cached items\n * to be re-evaluated on next access. This should be called when the context changes and cached\n * results are no longer valid.\n * @public\n */\n public clearConditionCache(): void {\n this._conditionCache.fill(undefined);\n this._conditionSetCache.fill(undefined);\n this._decisionCache.fill(undefined);\n\n this._listener?.onCacheClear('condition');\n this._listener?.onCacheClear('conditionSet');\n this._listener?.onCacheClear('decision');\n }\n\n /**\n * Gets the current size of the condition cache array.\n * @returns The size of the condition cache array.\n * @public\n */\n public get conditionCacheSize(): number {\n return this._conditionCache.length;\n }\n\n /**\n * Gets the current size of the condition set cache array.\n * @returns The size of the condition set cache array.\n * @public\n */\n public get conditionSetCacheSize(): number {\n return this._conditionSetCache.length;\n }\n\n /**\n * Gets the current size of the decision cache array.\n * @returns The size of the decision cache array.\n * @public\n */\n public get decisionCacheSize(): number {\n return this._decisionCache.length;\n }\n}\n"]}

package/lib/packlets/runtime/resourceTreeResolver.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"resourceTreeResolver.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceTreeResolver.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAmD,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAgC,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAoB,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,KACvB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,UAAU,EAAE,yBAAyB,CAAC,SAAS,CAAC,EAChD,gBAAgB,EAAE,MAAM,EAAE,EAC1B,QAAQ,EAAE,gBAAgB,KACvB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,oBAAoB,CAAC;IAE3D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,kBAAkB,CAAC;CACvD;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IAC/D;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAA+C;IAE7D;;;OAGG;gBACgB,QAAQ,EAAE,gBAAgB;IAK7C;;;OAGG;WACW,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAI9E;;;;;OAKG;IACH,IAAW,IAAI,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAEtD;IAED;;;;;;OAMG;IACI,2BAA2B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAEjC;;;;;;OAMG;IACI,2BAA2B,CAChC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,EAC1C,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAejC,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CA4D3B"}

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

@@ -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 ADDED Viewed

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"zipArchiveLoader.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveLoader.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n// ZipFileTree is browser-safe - doesn't depend on Node.js crypto/fs modules\nimport { ZipFileTree } from '@fgv/ts-extras';\nimport type {\n IZipArchiveLoadOptions,\n IZipArchiveLoadResult,\n ZipArchiveProgressCallback,\n IImportedFile,\n IImportedDirectory\n} from './types';\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport { parseZipArchiveManifest, parseZipArchiveConfiguration, isZipFile } from './zipArchiveFormat';\n\n/**\n * ZIP archive loader extending ts-extras foundation\n * @public\n */\nexport class ZipArchiveLoader {\n /**\n * Load ZIP archive from File object (Browser)\n * @param file - File object from file input\n * @param options - Loading options\n * @param onProgress - Optional progress callback\n * @returns Result containing loaded archive data\n */\n public async loadFromFile(\n file: File,\n options: IZipArchiveLoadOptions = {},\n onProgress?: ZipArchiveProgressCallback\n ): Promise<Result<IZipArchiveLoadResult>> {\n onProgress?.('reading-file', 0, `Reading file: ${file.name}`);\n\n if (!isZipFile(file.name)) {\n return fail(`File ${file.name} is not a ZIP file`);\n }\n\n try {\n const buffer = await file.arrayBuffer();\n onProgress?.('reading-file', 100, 'File read complete');\n\n return await this.loadFromBuffer(buffer, options, onProgress);\n /* c8 ignore next 3 - defense in depth against internal error */\n } catch (error) {\n return fail(`Failed to read file: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n\n /**\n * Load ZIP archive from ArrayBuffer (Universal)\n * @param buffer - ZIP data buffer\n * @param options - Loading options\n * @param onProgress - Optional progress callback\n * @returns Result containing loaded archive data\n */\n public async loadFromBuffer(\n buffer: ArrayBuffer,\n options: IZipArchiveLoadOptions = {},\n onProgress?: ZipArchiveProgressCallback\n ): Promise<Result<IZipArchiveLoadResult>> {\n onProgress?.('parsing-zip', 0, 'Parsing ZIP archive');\n\n const zipAccessorsResult = ZipFileTree.ZipFileTreeAccessors.fromBuffer(buffer);\n if (zipAccessorsResult.isFailure()) {\n return fail(`Failed to parse ZIP: ${zipAccessorsResult.message}`);\n }\n\n const zipAccessors = zipAccessorsResult.value;\n onProgress?.('parsing-zip', 100, 'ZIP archive parsed');\n\n // Load manifest\n onProgress?.('loading-manifest', 0, 'Loading manifest');\n const manifestResult = this._loadManifestFromAccessors(zipAccessors);\n if (manifestResult.isFailure()) {\n return fail(manifestResult.message);\n }\n const manifest = manifestResult.value;\n onProgress?.('loading-manifest', 100, 'Manifest loaded');\n\n // Load configuration\n onProgress?.('loading-config', 0, 'Loading configuration');\n const configResult = this._loadConfigurationFromAccessors(zipAccessors, manifest, options);\n if (configResult.isFailure()) {\n return fail(configResult.message);\n }\n const config = configResult.value;\n onProgress?.('loading-config', 100, 'Configuration loaded');\n\n // Extract files and directory structure\n onProgress?.('extracting-files', 0, 'Extracting files');\n const filesResult = await this._extractFilesFromAccessors(zipAccessors, onProgress);\n /* c8 ignore next 3 - defense in depth against internal error */\n if (filesResult.isFailure()) {\n return fail(filesResult.message);\n }\n\n const { files, directory } = filesResult.value;\n onProgress?.('extracting-files', 100, `Extracted ${files.length} files`);\n\n onProgress?.('extracting-files', 100, 'ZIP loading complete');\n\n return succeed({\n manifest,\n config,\n files,\n directory\n });\n }\n\n /**\n * Load manifest from ZIP using ZipFileTreeAccessors\n * @param zipAccessors - ZIP file tree accessors\n * @returns Result containing parsed manifest\n */\n private _loadManifestFromAccessors(\n zipAccessors: ZipFileTree.ZipFileTreeAccessors\n ): Result<Json.IZipArchiveManifest | undefined> {\n const manifestResult = zipAccessors.getFileContents('manifest.json');\n if (manifestResult.isFailure()) {\n // Manifest is optional - return success with undefined\n return succeed(undefined);\n }\n\n const parseResult = parseZipArchiveManifest(manifestResult.value);\n if (parseResult.isFailure()) {\n return fail(`Failed to parse manifest.json: ${parseResult.message}`);\n }\n\n return succeed(parseResult.value);\n }\n\n /**\n * Load configuration from ZIP using ZipFileTreeAccessors\n * @param zipAccessors - ZIP file tree accessors\n * @param manifest - Parsed manifest (may be undefined)\n * @param options - Loading options\n * @returns Result containing parsed configuration\n */\n private _loadConfigurationFromAccessors(\n zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n manifest: Json.IZipArchiveManifest | undefined,\n options: IZipArchiveLoadOptions\n ): Result<ConfigModel.ISystemConfiguration | undefined> {\n // Check if manifest specifies a config file\n const manifestSpecifiesConfig = manifest?.config !== undefined;\n\n if (!manifestSpecifiesConfig) {\n // If no config specified in manifest, config is optional\n return succeed(undefined);\n }\n\n // Get the config path from the manifest\n const configPath = manifest!.config!.archivePath;\n return zipAccessors\n .getFileContents(configPath)\n .withErrorFormat(\n () => `Manifest specifies config file at '${configPath}' but it was not found in archive`\n )\n .onSuccess((configContent) => parseZipArchiveConfiguration(configContent))\n .withErrorFormat((e) => `Failed to parse config file '${configPath}': ${e}`);\n }\n\n /**\n * Extract files and directory structure from ZIP\n * @param zipAccessors - ZIP file tree accessors\n * @param onProgress - Optional progress callback\n * @returns Result containing files and directory structure\n */\n private async _extractFilesFromAccessors(\n zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n onProgress?: ZipArchiveProgressCallback\n ): Promise<Result<{ files: IImportedFile[]; directory: IImportedDirectory | undefined }>> {\n try {\n const files: IImportedFile[] = [];\n const directories = new Map<string, IImportedDirectory>();\n\n // Get all children from root\n const rootChildrenResult = zipAccessors.getChildren('/');\n /* c8 ignore next 3 - defense in depth against internal error */\n if (rootChildrenResult.isFailure()) {\n return fail(`Failed to read ZIP contents: ${rootChildrenResult.message}`);\n }\n\n // Process all items recursively\n await this._processFileTreeItems(\n zipAccessors,\n '/',\n rootChildrenResult.value,\n files,\n directories,\n onProgress\n );\n\n // Build directory structure\n const directory = this._buildDirectoryStructure(files, directories);\n\n return succeed({ files, directory });\n /* c8 ignore next 3 - defense in depth against internal error */\n } catch (error) {\n return fail(`Failed to extract files: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n\n /**\n * Recursively process file tree items\n * @param zipAccessors - ZIP file tree accessors\n * @param currentPath - Current directory path\n * @param items - Items to process\n * @param files - Files collection\n * @param directories - Directories collection\n * @param onProgress - Optional progress callback\n * @param processed - Processing counter\n */\n private async _processFileTreeItems(\n zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n currentPath: string,\n items: readonly FileTree.FileTreeItem[],\n files: IImportedFile[],\n directories: Map<string, IImportedDirectory>,\n onProgress?: ZipArchiveProgressCallback,\n processed: { count: number } = { count: 0 }\n ): Promise<void> {\n for (const item of items) {\n /* c8 ignore next 1 - defense in depth */\n const itemPath = item.absolutePath.startsWith('/') ? item.absolutePath.substring(1) : item.absolutePath;\n\n if (item.type === 'directory') {\n // Track directory\n if (!directories.has(itemPath)) {\n directories.set(itemPath, {\n name: item.name,\n files: [],\n subdirectories: []\n });\n }\n\n // Recursively process children\n const childrenResult = zipAccessors.getChildren(item.absolutePath);\n if (childrenResult.isSuccess()) {\n await this._processFileTreeItems(\n zipAccessors,\n item.absolutePath,\n childrenResult.value,\n files,\n directories,\n onProgress,\n processed\n );\n }\n } else if (item.type === 'file') {\n // Get file content\n const contentResult = item.getRawContents();\n const content = contentResult.orDefault('');\n\n files.push({\n name: item.name,\n path: itemPath,\n content,\n type: this._getFileType(item.name)\n });\n }\n\n processed.count++;\n onProgress?.('extracting-files', 0, `Processing ${itemPath}`);\n }\n }\n\n /**\n * Build directory structure from files\n * @param files - Extracted files\n * @param directories - Directories map\n * @returns Root directory structure or null\n */\n private _buildDirectoryStructure(\n files: IImportedFile[],\n directories: Map<string, IImportedDirectory>\n ): IImportedDirectory | undefined {\n /* c8 ignore next 3 - should never happen with fflate */\n if (files.length === 0) {\n return undefined;\n }\n\n const rootDir: IImportedDirectory = {\n name: 'root',\n files: [],\n subdirectories: []\n };\n\n // Process files to build directory structure\n for (const file of files) {\n const pathParts = file.path.split('/').filter((part: string) => part.length > 0);\n\n /* c8 ignore next 1 - defense in depth should never happen */\n if (pathParts.length === 0) continue;\n\n // Ensure all parent directories exist\n let currentDir = rootDir;\n for (let i = 0; i < pathParts.length - 1; i++) {\n const dirName = pathParts[i];\n let foundDir = currentDir.subdirectories.find((d) => d.name === dirName);\n\n if (!foundDir) {\n foundDir = {\n name: dirName,\n files: [],\n subdirectories: []\n };\n currentDir.subdirectories.push(foundDir);\n }\n\n currentDir = foundDir;\n }\n\n // Add file to its parent directory\n currentDir.files.push(file);\n }\n\n return rootDir;\n }\n\n /**\n * Get file MIME type based on extension\n * @param filename - Filename\n * @returns MIME type\n */\n private _getFileType(filename: string): string {\n const ext = filename.toLowerCase().split('.').pop();\n /* c8 ignore next 20 - no need to test every one */\n switch (ext) {\n case 'json':\n return 'application/json';\n case 'yaml':\n case 'yml':\n return 'application/yaml';\n case 'xml':\n return 'application/xml';\n case 'txt':\n return 'text/plain';\n case 'md':\n return 'text/markdown';\n case 'js':\n return 'application/javascript';\n case 'ts':\n return 'application/typescript';\n default:\n return 'application/octet-stream';\n }\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-res",
-  "version": "5.1.0-19",
+  "version": "5.1.0-20",
   "description": "Multi-dimensional Resource Runtime",
   "main": "lib/index.js",
   "types": "dist/ts-res.d.ts",
@@ -45,18 +45,18 @@
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-tsdoc": "~0.5.2",
     "typedoc": "~0.28.16",
-    "@fgv/heft-dual-rig": "5.1.0-19",
-    "@fgv/typedoc-compact-theme": "5.1.0-19",
-    "@fgv/ts-extras": "5.1.0-19",
-    "@fgv/ts-utils-jest": "5.1.0-19"
+    "@fgv/heft-dual-rig": "5.1.0-20",
+    "@fgv/typedoc-compact-theme": "5.1.0-20",
+    "@fgv/ts-utils-jest": "5.1.0-20",
+    "@fgv/ts-extras": "5.1.0-20"
   },
   "dependencies": {
     "luxon": "^3.7.2",
     "fflate": "~0.8.2",
-    "@fgv/ts-utils": "5.1.0-19",
-    "@fgv/ts-json-base": "5.1.0-19",
-    "@fgv/ts-bcp47": "5.1.0-19",
-    "@fgv/ts-json": "5.1.0-19"
+    "@fgv/ts-utils": "5.1.0-20",
+    "@fgv/ts-json-base": "5.1.0-20",
+    "@fgv/ts-json": "5.1.0-20",
+    "@fgv/ts-bcp47": "5.1.0-20"
   },
   "exports": {
     ".": {

package/dist/test/data/sample.json DELETED Viewed

@@ -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 DELETED Viewed

@@ -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