@fgv/ts-res 5.0.1-8 → 5.0.1

package/dist/packlets/runtime/cacheListener.js

@@ -0,0 +1,58 @@
+/*
+ * 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.
+ */
+/**
+ * A no-op implementation of {@link Runtime.IResourceResolverCacheListener}.
+ * @public
+ */
+export class NoOpResourceResolverCacheListener {
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}
+     */
+    onCacheHit(cache, index) {
+        // no-op
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}
+     */
+    onCacheMiss(cache, index) {
+        // no-op
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}
+     */
+    onCacheError(cache, index) {
+        // no-op
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onContextError}
+     */
+    onContextError(qualifier, error) {
+        // no-op
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}
+     */
+    onCacheClear(cache) {
+        // no-op
+    }
+}
+//# sourceMappingURL=cacheListener.js.map

package/dist/packlets/runtime/cacheMetrics.js

@@ -0,0 +1,149 @@
+/*
+ * 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.
+ */
+/**
+ * Aggregate cache metrics for a specific cache type.
+ * @public
+ */
+export class AggregateCacheMetrics {
+    constructor() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+    }
+    onHit(__index) {
+        this._hits++;
+    }
+    onMiss(__index) {
+        this._misses++;
+    }
+    onError(__index) {
+        this._errors++;
+    }
+    onClear() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears++;
+    }
+    get hits() {
+        return this._hits;
+    }
+    get misses() {
+        return this._misses;
+    }
+    get errors() {
+        return this._errors;
+    }
+    get clears() {
+        return this._clears;
+    }
+    get totalAccesses() {
+        return this._hits + this._misses + this._errors;
+    }
+    get hitRate() {
+        return this.totalAccesses > 0 ? (this._hits / this.totalAccesses) * 100 : 0;
+    }
+    get errorRate() {
+        return this.totalAccesses > 0 ? (this._errors / this.totalAccesses) * 100 : 0;
+    }
+    reset() {
+        this._hits = 0;
+        this._misses = 0;
+        this._errors = 0;
+        this._clears = 0;
+    }
+}
+/**
+ * A metrics implementation of {@link Runtime.IResourceResolverCacheListener} that tracks
+ * hit counts and rates across all cache types.
+ * @public
+ */
+export class ResourceResolverCacheMetricsListener {
+    get numContextErrors() {
+        return this._contextErrors;
+    }
+    constructor(factoryOrMetrics) {
+        if (typeof factoryOrMetrics === 'function') {
+            this._metrics = {
+                condition: factoryOrMetrics(),
+                conditionSet: factoryOrMetrics(),
+                decision: factoryOrMetrics()
+            };
+        }
+        else {
+            this._metrics = factoryOrMetrics;
+        }
+        this._contextErrors = 0;
+    }
+    /**
+     * Get the metrics for all cache types.
+     * @returns The metrics for all cache types.
+     */
+    get metrics() {
+        return this._metrics;
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}
+     */
+    onCacheHit(cache, index) {
+        this._metrics[cache].onHit(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}
+     */
+    onCacheMiss(cache, index) {
+        this._metrics[cache].onMiss(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}
+     */
+    onCacheError(cache, index) {
+        this._metrics[cache].onError(index);
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onContextError}
+     */
+    onContextError(qualifier, error) {
+        this._contextErrors++;
+    }
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}
+     */
+    onCacheClear(cache) {
+        this._metrics[cache].onClear();
+    }
+    /**
+     * Reset all metrics to zero.
+     */
+    reset() {
+        this._metrics.condition.reset();
+        this._metrics.conditionSet.reset();
+        this._metrics.decision.reset();
+        this._contextErrors = 0;
+    }
+}
+//# sourceMappingURL=cacheMetrics.js.map

package/dist/packlets/runtime/compiledResourceCollection.js

@@ -0,0 +1,473 @@
+/*
+ * 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, Collections, fail, mapResults, MessageAggregator, succeed, ValidatingResultMap } from '@fgv/ts-utils';
+import { ConditionCollector, ConditionSetCollector } from '../conditions';
+import { AbstractDecisionCollector } from '../decisions';
+import { QualifierCollector } from '../qualifiers';
+import { ResourceTypeCollector } from '../resource-types';
+import { QualifierTypeCollector } from '../qualifier-types';
+import { Convert, Helpers } from '../common';
+import { isJsonObject } from '@fgv/ts-json-base';
+import { ConcreteDecision } from '../decisions';
+import * as Validate from './validate';
+import { ReadOnlyResourceTreeRoot } from './resource-tree';
+import * as Context from '../context';
+/**
+ * A compiled resource collection implements {@link Runtime.IResourceManager | IResourceManager}
+ * by reconstructing runtime objects from compiled data. This provides an efficient way to load
+ * and use pre-compiled resource collections without rebuilding them from scratch.
+ * @public
+ */
+export class CompiledResourceCollection {
+    /**
+     * A {@link QualifierTypes.ReadOnlyQualifierTypeCollector | ReadOnlyQualifierTypeCollector} which
+     * contains the {@link QualifierTypes.QualifierType | qualifier types} used in this collection.
+     */
+    get qualifierTypes() {
+        return this._qualifierTypes;
+    }
+    /**
+     * A {@link Qualifiers.IReadOnlyQualifierCollector | ReadOnlyQualifierCollector} which
+     * contains the {@link Qualifiers.Qualifier | qualifiers} used in this collection.
+     */
+    get qualifiers() {
+        return this._qualifiers;
+    }
+    /**
+     * The resource IDs contained in this compiled resource collection.
+     */
+    get resourceIds() {
+        return Array.from(this._builtResources.keys()).sort();
+    }
+    /**
+     * A {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector} which
+     * contains the {@link ResourceTypes.ResourceType | resource types} used in this collection.
+     */
+    get resourceTypes() {
+        return this._resourceTypes;
+    }
+    /**
+     * The candidate values in the collection.
+     */
+    get candidateValues() {
+        return this._candidateValues;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     */
+    get builtResources() {
+        return this._builtResources;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numResources}
+     */
+    get numResources() {
+        return this._builtResources.size;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     */
+    get numCandidates() {
+        if (this._numCandidates === undefined) {
+            this._numCandidates = [...this._builtResources.values()].reduce((acc, resource) => acc + resource.candidates.length, 0);
+        }
+        return this._numCandidates;
+    }
+    /**
+     * Constructor for a {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
+     * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
+     * @internal
+     */
+    constructor(params) {
+        // Reconstruct collectors from compiled data
+        this._qualifierTypes = this._buildQualifierTypes(params.compiledCollection, params.qualifierTypes).orThrow();
+        this._qualifiers = this._buildQualifiers(params.compiledCollection, this._qualifierTypes).orThrow();
+        this._resourceTypes = this._buildResourceTypes(params.compiledCollection, params.resourceTypes).orThrow();
+        // Build collectors from compiled data
+        const conditionCollector = this._buildConditions(params.compiledCollection, this._qualifiers).orThrow();
+        const conditionSetCollector = this._buildConditionSets(params.compiledCollection, conditionCollector).orThrow();
+        const decisionCollector = this._buildDecisions(params.compiledCollection, conditionSetCollector).orThrow();
+        this.conditions = conditionCollector;
+        this.conditionSets = conditionSetCollector;
+        this.decisions = decisionCollector;
+        this._candidateValues = [...params.compiledCollection.candidateValues];
+        // Build resources from compiled data
+        this._builtResources = this._buildResources(params.compiledCollection, this._resourceTypes, decisionCollector).orThrow();
+    }
+    /**
+     * Creates a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object.
+     * @param params - Parameters to create a new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection}.
+     * @returns `Success` with the new {@link Runtime.CompiledResourceCollection | CompiledResourceCollection} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params) {
+        return captureResult(() => new CompiledResourceCollection(params));
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.getBuiltResource}
+     */
+    getBuiltResource(id) {
+        return this._builtResources.validating.get(id);
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.validateContext}
+     */
+    validateContext(context) {
+        return Context.Convert.validatedContextDecl.convert(context, {
+            qualifiers: this._qualifiers
+        });
+    }
+    /**
+     * Gets a resource tree built from the resources in this collection.
+     * The tree provides hierarchical access to resources based on their ResourceId structure.
+     * For example, resources with IDs like "app.messages.welcome" create a tree structure
+     * where "app" and "messages" are branch nodes, and "welcome" is a leaf containing the resource.
+     *
+     * String-based validation is available through the `children.validating` property,
+     * allowing callers to use `tree.children.validating.getById(stringId)` for validated access.
+     *
+     * Uses lazy initialization with caching for performance.
+     * @returns Result containing the resource tree root, or failure if tree construction fails
+     * @public
+     */
+    getBuiltResourceTree() {
+        if (this._cachedResourceTree) {
+            return succeed(this._cachedResourceTree);
+        }
+        // Convert all built resources to [ResourceId, IResource] pairs
+        const resources = [];
+        for (const [id, resource] of this._builtResources.entries()) {
+            resources.push([id, resource]);
+        }
+        // Create the resource tree with lazy initialization
+        return ReadOnlyResourceTreeRoot.create(resources).onSuccess((tree) => {
+            this._cachedResourceTree = tree;
+            return succeed(tree);
+        });
+    }
+    /**
+     * Reconstructs a QualifierTypeCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifierTypes - Map of qualifier type names to qualifier type objects
+     * @returns The reconstructed QualifierTypeCollector
+     * @internal
+     */
+    _buildQualifierTypes(compiled, qualifierTypes) {
+        return mapResults(compiled.qualifierTypes.map((compiledQualifierType) => qualifierTypes.get(compiledQualifierType.name))).onSuccess((referencedQualifierTypes) => {
+            return QualifierTypeCollector.create({
+                qualifierTypes: referencedQualifierTypes
+            });
+        });
+    }
+    /**
+     * Reconstructs a QualifierCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifierTypes - The reconstructed QualifierTypeCollector
+     * @returns The reconstructed QualifierCollector
+     * @internal
+     */
+    _buildQualifiers(compiled, qualifierTypes) {
+        return mapResults(compiled.qualifiers.map((compiledQualifier) => {
+            return qualifierTypes.getAt(compiledQualifier.type).onSuccess((qualifierType) => {
+                return succeed({
+                    name: compiledQualifier.name,
+                    typeName: qualifierType.name,
+                    defaultPriority: compiledQualifier.defaultPriority
+                });
+            });
+        })).onSuccess((qualifierDecls) => {
+            return QualifierCollector.create({
+                qualifierTypes,
+                qualifiers: qualifierDecls
+            });
+        });
+    }
+    /**
+     * Reconstructs a ResourceTypeCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param resourceTypes - Map of resource type names to resource type objects
+     * @returns The reconstructed ResourceTypeCollector
+     * @internal
+     */
+    _buildResourceTypes(compiled, resourceTypes) {
+        return mapResults(compiled.resourceTypes.map((compiledResourceType) => resourceTypes.get(compiledResourceType.name))).onSuccess((referencedResourceTypes) => {
+            return ResourceTypeCollector.create({
+                resourceTypes: referencedResourceTypes
+            });
+        });
+    }
+    /**
+     * Reconstructs a ConditionCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param qualifiers - The reconstructed QualifierCollector
+     * @returns The reconstructed ConditionCollector
+     * @internal
+     */
+    _buildConditions(compiled, qualifiers) {
+        var _a;
+        const errors = new MessageAggregator();
+        const conditionCollectorResult = ConditionCollector.create({ qualifiers });
+        /* c8 ignore next 3 - defensive coding for ConditionCollector creation failure */
+        if (conditionCollectorResult.isFailure()) {
+            return conditionCollectorResult;
+        }
+        const conditionCollector = conditionCollectorResult.value;
+        for (const [index, compiledCondition] of compiled.conditions.entries()) {
+            const qualifierResult = qualifiers.getAt(compiledCondition.qualifierIndex);
+            /* c8 ignore next 5 - defensive coding: invalid qualifier index should not occur in compiled data */
+            if (qualifierResult.isFailure()) {
+                errors.addMessage(`Invalid qualifier index ${compiledCondition.qualifierIndex} at condition ${index}: ${qualifierResult.message}`);
+                continue;
+            }
+            const qualifier = qualifierResult.value;
+            /* c8 ignore next 1 - not really testable atm as "matches" is the only supported operator */
+            const operator = (_a = compiledCondition.operator) !== null && _a !== void 0 ? _a : 'matches'; // Default to 'matches' if not provided
+            const conditionDecl = {
+                qualifierName: qualifier.name,
+                value: compiledCondition.value,
+                operator,
+                priority: compiledCondition.priority,
+                scoreAsDefault: compiledCondition.scoreAsDefault
+            };
+            const conditionResult = conditionCollector.validating.add(conditionDecl);
+            /* c8 ignore next 4 - defensive coding for condition addition failure */
+            if (conditionResult.isFailure()) {
+                errors.addMessage(`Failed to add condition at index ${index}: ${conditionResult.message}`);
+                continue;
+            }
+            const condition = conditionResult.value;
+            // Validate that the assigned index matches our expected index
+            const expectedIndexResult = Convert.conditionIndex.convert(index);
+            /* c8 ignore next 4 - defensive coding for invalid condition index conversion */
+            if (expectedIndexResult.isFailure()) {
+                errors.addMessage(`Invalid condition index ${index}: ${expectedIndexResult.message}`);
+                continue;
+            }
+            const expectedIndex = expectedIndexResult.value;
+            /* c8 ignore next 5 - defensive coding for condition index mismatch */
+            if (condition.index !== expectedIndex) {
+                errors.addMessage(`Index mismatch at condition ${index}: expected ${expectedIndex}, got ${condition.index}`);
+            }
+        }
+        return errors.hasMessages ? fail(errors.toString()) : succeed(conditionCollector);
+    }
+    /**
+     * Reconstructs a ConditionSetCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param conditions - The reconstructed ConditionCollector
+     * @returns The reconstructed ConditionSetCollector
+     * @internal
+     */
+    _buildConditionSets(compiled, conditions) {
+        const errors = new MessageAggregator();
+        const conditionSetCollectorResult = ConditionSetCollector.create({ conditions });
+        /* c8 ignore next 3 - defensive coding for ConditionSetCollector creation failure */
+        if (conditionSetCollectorResult.isFailure()) {
+            return conditionSetCollectorResult;
+        }
+        const conditionSetCollector = conditionSetCollectorResult.value;
+        for (const [index, compiledConditionSet] of compiled.conditionSets.entries()) {
+            const referencedConditionsResult = mapResults(compiledConditionSet.conditions.map((conditionIndex) => conditions.getAt(conditionIndex)));
+            if (referencedConditionsResult.isFailure()) {
+                errors.addMessage(`Failed to resolve conditions for condition set ${index}: ${referencedConditionsResult.message}`);
+                continue;
+            }
+            const referencedConditions = referencedConditionsResult.value;
+            const conditionSetResult = conditionSetCollector.validating.getOrAdd(referencedConditions);
+            /* c8 ignore next 4 - defensive coding for condition set addition failure */
+            if (conditionSetResult.isFailure()) {
+                errors.addMessage(`Failed to add condition set at index ${index}: ${conditionSetResult.message}`);
+                continue;
+            }
+            const conditionSet = conditionSetResult.value;
+            // Validate that the assigned index matches our expected index
+            const expectedIndexResult = Convert.conditionSetIndex.convert(index);
+            /* c8 ignore next 4 - defensive coding for invalid condition set index conversion */
+            if (expectedIndexResult.isFailure()) {
+                errors.addMessage(`Invalid condition set index ${index}: ${expectedIndexResult.message}`);
+                continue;
+            }
+            const expectedIndex = expectedIndexResult.value;
+            /* c8 ignore next 5 - defensive coding for condition set index mismatch */
+            if (conditionSet.index !== expectedIndex) {
+                errors.addMessage(`Index mismatch at condition set ${index}: expected ${expectedIndex}, got ${conditionSet.index}`);
+            }
+        }
+        return errors.hasMessages ? fail(errors.toString()) : succeed(conditionSetCollector);
+    }
+    /**
+     * Reconstructs an AbstractDecisionCollector from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param conditionSets - The reconstructed ConditionSetCollector
+     * @returns The reconstructed AbstractDecisionCollector
+     * @internal
+     */
+    _buildDecisions(compiled, conditionSets) {
+        const errors = new MessageAggregator();
+        const decisionCollectorResult = AbstractDecisionCollector.create({ conditionSets });
+        /* c8 ignore next 3 - defensive coding for AbstractDecisionCollector creation failure */
+        if (decisionCollectorResult.isFailure()) {
+            return decisionCollectorResult;
+        }
+        const decisionCollector = decisionCollectorResult.value;
+        for (const [index, compiledDecision] of compiled.decisions.entries()) {
+            const referencedConditionSetsResult = mapResults(compiledDecision.conditionSets.map((conditionSetIndex) => conditionSets.getAt(conditionSetIndex)));
+            /* c8 ignore next 5 - defensive coding: condition set resolution should not fail with valid compiled data */
+            if (referencedConditionSetsResult.isFailure()) {
+                errors.addMessage(`Failed to resolve condition sets for decision ${index}: ${referencedConditionSetsResult.message}`);
+                continue;
+            }
+            const referencedConditionSets = referencedConditionSetsResult.value;
+            const decisionResult = decisionCollector.validating.getOrAdd(referencedConditionSets);
+            /* c8 ignore next 4 - defensive coding for decision addition failure */
+            if (decisionResult.isFailure()) {
+                errors.addMessage(`Failed to add decision at index ${index}: ${decisionResult.message}`);
+                continue;
+            }
+            const decision = decisionResult.value;
+            // Validate that the assigned index matches our expected index
+            const expectedIndexResult = Convert.decisionIndex.convert(index);
+            /* c8 ignore next 4 - defensive coding for invalid decision index conversion */
+            if (expectedIndexResult.isFailure()) {
+                errors.addMessage(`Invalid decision index ${index}: ${expectedIndexResult.message}`);
+                continue;
+            }
+            const expectedIndex = expectedIndexResult.value;
+            /* c8 ignore next 5 - defensive coding for decision index mismatch */
+            if (decision.index !== expectedIndex) {
+                errors.addMessage(`Index mismatch at decision ${index}: expected ${expectedIndex}, got ${decision.index}`);
+            }
+        }
+        return errors.hasMessages ? fail(errors.toString()) : succeed(decisionCollector);
+    }
+    /**
+     * Gets a candidate value from the collection.
+     * @param valueIndex - The index of the candidate value to get.
+     * @returns
+     */
+    _getCandidateValue(valueIndex) {
+        /* c8 ignore next 3 - defensive coding: candidate value index should be valid in compiled data */
+        if (valueIndex < 0 || valueIndex >= this._candidateValues.length) {
+            return fail(`Invalid candidate value index ${valueIndex}`);
+        }
+        /* c8 ignore next 3 - defensive coding for invalid candidate value conversion */
+        if (!isJsonObject(this._candidateValues[valueIndex])) {
+            return fail(`${valueIndex}: candidate value not a JSON object.`);
+        }
+        return succeed(this._candidateValues[valueIndex]);
+    }
+    /**
+     * Reconstructs a ValidatingResultMap of resources from compiled data.
+     * @param compiled - The compiled resource collection
+     * @param resourceTypes - The reconstructed ResourceTypeCollector
+     * @param decisions - The reconstructed AbstractDecisionCollector
+     * @returns The reconstructed ValidatingResultMap of resources
+     * @internal
+     */
+    _buildResources(compiled, resourceTypes, decisions) {
+        const errors = new MessageAggregator();
+        const resourceMap = new ValidatingResultMap({
+            converters: new Collections.KeyValueConverters({
+                key: Convert.resourceId,
+                /* c8 ignore next 3 - covered but coverage is confused */
+                value: (from) => {
+                    return Validate.resource.validate(from);
+                }
+            })
+        });
+        for (const compiledResource of compiled.resources) {
+            const resourceType = resourceTypes
+                .getAt(compiledResource.type)
+                .aggregateError(errors, (message) => `Invalid resource type index ${compiledResource.type} for resource ${compiledResource.id}: ${message}`)
+                .orDefault();
+            /* c8 ignore next 3 - defensive coding: resource type index should be valid in compiled data */
+            if (resourceType === undefined) {
+                continue;
+            }
+            const decision = decisions
+                .getAt(compiledResource.decision)
+                .aggregateError(errors, (message) => `Invalid decision index ${compiledResource.decision} for resource ${compiledResource.id}: ${message}`)
+                .orDefault();
+            /* c8 ignore next 3 - defensive coding: decision index should be valid in compiled data */
+            if (decision === undefined) {
+                continue;
+            }
+            // Build candidates from compiled data
+            const candidateDecls = mapResults(compiledResource.candidates.map((compiledCandidate) => this._getCandidateValue(compiledCandidate.valueIndex)
+                .aggregateError(errors, (message) => `Failed to convert candidate JSON for resource ${compiledResource.id}: ${message}`)
+                .onSuccess((json) => {
+                return succeed({
+                    json,
+                    isPartial: compiledCandidate.isPartial,
+                    mergeMethod: compiledCandidate.mergeMethod
+                });
+            })))
+                .aggregateError(errors, (message) => `Failed to convert candidate JSON for resource ${compiledResource.id}: ${message}`)
+                .orDefault();
+            /* c8 ignore next 3 - defensive coding: candidate JSON conversion should not fail with valid compiled data */
+            if (candidateDecls === undefined) {
+                continue;
+            }
+            // Create minimal candidates that implement IResourceCandidate
+            const candidates = candidateDecls.map((candidateDecl) => ({
+                json: candidateDecl.json,
+                isPartial: candidateDecl.isPartial,
+                mergeMethod: candidateDecl.mergeMethod
+            }));
+            const candidatesWithConditionSets = decision.candidates.map((baseCandidate, idx) => ({
+                conditionSet: baseCandidate.conditionSet,
+                value: candidates[idx].json
+            }));
+            const concreteDecision = ConcreteDecision.create({
+                decisions,
+                candidates: candidatesWithConditionSets
+            })
+                .aggregateError(errors, (message) => `Failed to create concrete decision for resource ${compiledResource.id}: ${message}`)
+                .orDefault();
+            /* c8 ignore next 3 - defensive coding for ConcreteDecision creation failure */
+            if (concreteDecision === undefined) {
+                continue;
+            }
+            const name = Helpers.getNameForResourceId(compiledResource.id)
+                .aggregateError(errors, (message) => `Failed to get name for resource ${compiledResource.id}: ${message}`)
+                .orDefault();
+            /* c8 ignore next 3 - defensive coding: name should be valid in compiled data */
+            if (name === undefined) {
+                continue;
+            }
+            // Create minimal resource that implements IResource
+            const resource = {
+                id: compiledResource.id,
+                name,
+                resourceType,
+                decision: concreteDecision,
+                candidates
+            };
+            resourceMap
+                .set(compiledResource.id, resource)
+                .aggregateError(errors, (message) => `Failed to add resource ${compiledResource.id}: ${message}`);
+        }
+        return errors.returnOrReport(succeed(resourceMap));
+    }
+}
+//# sourceMappingURL=compiledResourceCollection.js.map