@fgv/ts-res 4.5.0-3 → 5.0.0-2

package/lib/packlets/resources/resourceManagerBuilder.js

@@ -0,0 +1,451 @@
+"use strict";
+/*
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceManagerBuilder = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const conditions_1 = require("../conditions");
+const decisions_1 = require("../decisions");
+const common_1 = require("../common");
+const resourceBuilder_1 = require("./resourceBuilder");
+const resource_1 = require("./resource");
+const ResourceJson = __importStar(require("../resource-json"));
+const Context = __importStar(require("../context"));
+/**
+ * Builder for a collection of {@link Resources.Resource | resources}. Collects
+ * {@link Resources.ResourceCandidate | candidates} for each resource into a
+ * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,
+ * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.
+ * @public
+ */
+class ResourceManagerBuilder {
+    /**
+     * A {@link Conditions.ConditionCollector | ConditionCollector} which
+     * contains the {@link Conditions.Condition | conditions} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get conditions() {
+        return this._conditions;
+    }
+    /**
+     * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which
+     * contains the {@link Conditions.ConditionSet | condition sets} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get conditionSets() {
+        return this._conditionSets;
+    }
+    /**
+     * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which
+     * contains the {@link Decisions.Decision | abstract decisions} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get decisions() {
+        return this._decisions;
+    }
+    /**
+     * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.
+     */
+    get resources() {
+        return this._resources;
+    }
+    /**
+     * The number of {@link Resources.Resource | resources} contained by the manager.
+     */
+    get size() {
+        return this._resources.size;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numResources}
+     */
+    get numResources() {
+        return this._resources.size;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     */
+    get numCandidates() {
+        if (this._numCandidates === undefined) {
+            this._numCandidates = this.getAllCandidates().length;
+        }
+        return this._numCandidates;
+    }
+    /**
+     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     */
+    get builtResources() {
+        return this._performBuild().orThrow();
+    }
+    /**
+     * Constructor for a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.
+     * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.
+     * @public
+     */
+    constructor(params) {
+        this.qualifiers = params.qualifiers;
+        this.resourceTypes = params.resourceTypes;
+        this._conditions = conditions_1.ConditionCollector.create({ qualifiers: params.qualifiers }).orThrow();
+        this._conditionSets = conditions_1.ConditionSetCollector.create({ conditions: this._conditions }).orThrow();
+        this._decisions = decisions_1.AbstractDecisionCollector.create({ conditionSets: this._conditionSets }).orThrow();
+        this._resources = new ts_utils_1.ValidatingResultMap({
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: common_1.Convert.resourceId,
+                /* c8 ignore next 2 - defense in depth against internal error */
+                value: (from) => from instanceof resourceBuilder_1.ResourceBuilder ? (0, ts_utils_1.succeed)(from) : (0, ts_utils_1.fail)('not a resource builder')
+            })
+        });
+        this._builtResources = new ts_utils_1.ValidatingResultMap({
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: common_1.Convert.resourceId,
+                /* c8 ignore next 1 - defense in depth against internal error */
+                value: (from) => (from instanceof resource_1.Resource ? (0, ts_utils_1.succeed)(from) : (0, ts_utils_1.fail)('not a resource'))
+            })
+        });
+        this._built = false;
+    }
+    /**
+     * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.
+     * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.
+     * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new ResourceManagerBuilder(params));
+    }
+    /**
+     * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
+     * a {@link Resources.ResourceCandidate | candidate} to the manager.
+     * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.
+     * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    addLooseCandidate(decl) {
+        const { value: id, message } = common_1.Validate.toResourceId(decl.id);
+        if (message !== undefined) {
+            return (0, ts_utils_1.failWithDetail)(`${id}: invalid id - ${message}`, 'failure');
+        }
+        const builderResult = this._resources.getOrAdd(id, () => resourceBuilder_1.ResourceBuilder.create({
+            id,
+            resourceTypes: this.resourceTypes,
+            conditionSets: this._conditionSets,
+            decisions: this._decisions
+        }));
+        /* c8 ignore next 6 - defense in depth against internal error */
+        if (builderResult.isFailure()) {
+            return (0, ts_utils_1.failWithDetail)(`${id}: unable to get or add resource\n${builderResult.message}`, builderResult.detail);
+        }
+        return builderResult.value.addLooseCandidate(decl).onSuccess((c, d) => {
+            this._builtResources.delete(id);
+            this._built = false;
+            this._numCandidates = undefined;
+            return (0, ts_utils_1.succeedWithDetail)(c, d);
+        });
+    }
+    addResource(decl) {
+        var _a;
+        const { value: id, message } = common_1.Validate.toResourceId(decl.id);
+        if (message !== undefined) {
+            return (0, ts_utils_1.failWithDetail)(`${id}: invalid id - ${message}`, 'failure');
+        }
+        const { value: builder, message: getOrAddMessage, detail } = this._resources.getOrAdd(id, () => resourceBuilder_1.ResourceBuilder.create({
+            id,
+            typeName: decl.resourceTypeName,
+            resourceTypes: this.resourceTypes,
+            conditionSets: this._conditionSets,
+            decisions: this._decisions
+        }));
+        /* c8 ignore next 3 - defense in depth against internal error */
+        if (getOrAddMessage !== undefined) {
+            return (0, ts_utils_1.failWithDetail)(`${id}: unable to get or add resource\n${getOrAddMessage}`, detail);
+        }
+        if (detail === 'exists') {
+            const { message } = builder.setResourceType(decl.resourceTypeName);
+            if (message !== undefined) {
+                return (0, ts_utils_1.failWithDetail)(`${id}: unable to set resource type\n${message}`, 'type-mismatch');
+            }
+        }
+        const candidates = (_a = decl.candidates) !== null && _a !== void 0 ? _a : [];
+        return (0, ts_utils_1.mapResults)(candidates.map((c) => builder.addChildCandidate(c)))
+            .onSuccess(() => {
+            return (0, ts_utils_1.succeed)(builder);
+        })
+            .withDetail('failure', detail);
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} present in the manager.
+     * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder} if successful,
+     * or `Failure` with an error message if not.
+     */
+    getAllResources() {
+        return Array.from(this._resources.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} present in the manager.
+     */
+    getAllCandidates() {
+        return this.getAllResources().flatMap((r) => r.candidates);
+    }
+    /**
+     * Gets an individual {@link Resources.Resource | built resource} from the manager.
+     * @param id - The {@link ResourceId | id} of the resource to get.
+     * @returns `Success` with the resource if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltResource(id) {
+        return this._resources.validating
+            .get(id)
+            .onSuccess((builder) => this._builtResources.validating.getOrAdd(id, () => builder.build()));
+    }
+    /**
+     * Validates a context declaration against the qualifiers managed by this resource manager.
+     * @param context - The context declaration to validate
+     * @returns Success with the validated context if successful, Failure otherwise
+     * @public
+     */
+    /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */
+    validateContext(context) {
+        return Context.Convert.validatedContextDecl.convert(context, {
+            qualifiers: this.qualifiers
+        });
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.
+     * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getAllBuiltResources() {
+        return this.build().onSuccess((manager) => (0, ts_utils_1.succeed)(Array.from(manager._builtResources.values()).sort((a, b) => a.id.localeCompare(b.id))));
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.
+     * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getAllBuiltCandidates() {
+        return this.getAllBuiltResources().onSuccess((built) => (0, ts_utils_1.succeed)(built.flatMap((r) => r.candidates)));
+    }
+    /**
+     * Internal helper method that performs the actual building of resources.
+     * @returns `Success` with the built resources if all resources were built successfully, `Failure` otherwise.
+     * @internal
+     */
+    _performBuild() {
+        if (this._built) {
+            return (0, ts_utils_1.succeed)(this._builtResources);
+        }
+        const errors = new ts_utils_1.MessageAggregator();
+        this._resources.forEach((r, id) => {
+            this._builtResources.getOrAdd(id, () => r.build()).aggregateError(errors);
+        });
+        /* c8 ignore next 3 - defense in depth against internal error */
+        if (errors.hasMessages) {
+            return (0, ts_utils_1.fail)(`build failed: ${errors.toString()}`);
+        }
+        this._built = true;
+        return (0, ts_utils_1.succeed)(this._builtResources);
+    }
+    /**
+     * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.
+     * @returns `Success` with the {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    build() {
+        return this._performBuild().onSuccess(() => (0, ts_utils_1.succeed)(this));
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns A read-only array of {@link Resources.ResourceCandidate | candidates} that can match the context.
+     * @public
+     */
+    getCandidatesForContext(context, options) {
+        return this.getAllCandidates().filter((candidate) => candidate.canMatchPartialContext(context, options));
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} that have at least one candidate
+     * that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns A read-only array of {@link Resources.ResourceBuilder | resource builders} with matching candidates.
+     * @public
+     */
+    getResourcesForContext(context, options) {
+        return this.getAllResources().filter((resource) => resource.getCandidatesForContext(context, options).length > 0);
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | built resource candidates} that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns `Success` with an array of {@link Resources.ResourceCandidate | candidates} if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltCandidatesForContext(context, options) {
+        return this.getAllBuiltCandidates().onSuccess((candidates) => (0, ts_utils_1.succeed)(candidates.filter((candidate) => candidate.canMatchPartialContext(context, options))));
+    }
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} that have at least one candidate
+     * that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns `Success` with an array of {@link Resources.Resource | resources} if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltResourcesForContext(context, options) {
+        return this.getAllBuiltResources().onSuccess((resources) => (0, ts_utils_1.succeed)(resources.filter((resource) => resource.getCandidatesForContext(context, options).length > 0)));
+    }
+    /**
+     * Gets a compiled resource collection from the current state of the resource manager builder.
+     * This method generates an optimized, index-based representation of all resources, conditions,
+     * and decisions that can be used for serialization or efficient runtime processing.
+     * @param options - Optional compilation options controlling the output format.
+     * @returns Success with the compiled resource collection if successful, Failure otherwise.
+     * @public
+     */
+    getCompiledResourceCollection(options) {
+        // Build resources first to ensure all data is available
+        const buildResult = this._performBuild();
+        if (buildResult.isFailure()) {
+            return (0, ts_utils_1.fail)(`Failed to build resources: ${buildResult.message}`);
+        }
+        // Generate compiled data from internal collections using the new toCompiled methods
+        // Note: All objects have a defined index property due to the collector pattern - indices are assigned during collection building
+        const compiledData = {
+            qualifierTypes: Array.from(this.qualifiers.qualifierTypes.values()).map((qt) => ({
+                name: qt.name
+            })),
+            qualifiers: Array.from(this.qualifiers.values()).map((q) => ({
+                name: q.name,
+                type: q.type.index,
+                defaultPriority: q.defaultPriority
+            })),
+            resourceTypes: Array.from(this.resourceTypes.values()).map((rt) => ({
+                name: rt.key
+            })),
+            conditions: Array.from(this._conditions.values()).map((c) => c.toCompiled(options)),
+            conditionSets: Array.from(this._conditionSets.values()).map((cs) => cs.toCompiled(options)),
+            decisions: Array.from(this._decisions.values()).map((d) => d.toCompiled(options)),
+            resources: Array.from(this._builtResources.values()).map((r) => r.toCompiled(options))
+        };
+        // Apply validation through the converter
+        return ResourceJson.Compiled.Convert.compiledResourceCollection.convert(compiledData);
+    }
+    /**
+     * Gets a resource collection declaration containing all built resources in a flat array structure.
+     * This method returns all built resources as an {@link ResourceJson.Normalized.IResourceCollectionDecl | IResourceCollectionDecl}
+     * that can be used for serialization, export, or re-import. Resources are sorted by ID for consistent ordering.
+     * @param options - Optional {@link Resources.IResourceDeclarationOptions | declaration options} controlling the output format.
+     * If `options.normalized` is `true`, applies hash-based normalization for additional consistency guarantees.
+     * @returns Success with the resource collection declaration if successful, Failure otherwise.
+     * @public
+     */
+    getResourceCollectionDecl(options) {
+        return this._performBuild().onSuccess(() => {
+            // Get all built resources and convert to loose resource declarations
+            const resources = Array.from(this._builtResources.values()).map((resource) => resource.toLooseResourceDecl(options));
+            // Sort resources by ID for consistent ordering
+            resources.sort((a, b) => a.id.localeCompare(b.id));
+            // Create the collection declaration structure
+            const collectionData = {
+                resources
+            };
+            // Convert and validate using the normalized converter
+            return ResourceJson.Convert.resourceCollectionDecl
+                .convert(collectionData)
+                .onSuccess((compiledCollection) => {
+                // Apply hash-based normalization only if requested
+                if ((options === null || options === void 0 ? void 0 : options.normalized) === true) {
+                    const normalizer = new ts_utils_1.Hash.Crc32Normalizer();
+                    return normalizer
+                        .normalize(compiledCollection)
+                        .withErrorFormat((e) => `Failed to normalize resource collection: ${e}`);
+                }
+                return (0, ts_utils_1.succeed)(compiledCollection);
+            });
+        });
+    }
+    /**
+     * Creates a filtered clone of this ResourceManagerBuilder using the specified context.
+     * This is a convenience method that creates a new ResourceManagerBuilder with the same
+     * configuration but filtered to include only candidates that match the provided context.
+     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.
+     * @returns A Result containing the new filtered ResourceManagerBuilder.
+     * @public
+     */
+    /* c8 ignore next 21 - functional code path tested but coverage intermittently missed */
+    clone(options) {
+        return this.getResourceCollectionDecl(options).onSuccess((collection) => {
+            return ResourceManagerBuilder.create({
+                qualifiers: this.qualifiers,
+                resourceTypes: this.resourceTypes
+            }).onSuccess((newManager) => {
+                // Add each resource from the filtered collection to the new manager
+                if (collection.resources) {
+                    for (const resourceDecl of collection.resources) {
+                        const addResult = newManager.addResource(resourceDecl);
+                        if (addResult.isFailure()) {
+                            return (0, ts_utils_1.fail)(`${resourceDecl.id}: Failed to add resource to cloned manager: ${addResult.message}`);
+                        }
+                    }
+                }
+                return (0, ts_utils_1.succeed)(newManager);
+            });
+        });
+    }
+}
+exports.ResourceManagerBuilder = ResourceManagerBuilder;
+//# sourceMappingURL=resourceManagerBuilder.js.map

package/lib/packlets/resources/resourceManagerBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceManagerBuilder.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManagerBuilder.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 {\n  captureResult,\n  Collections,\n  DetailedResult,\n  fail,\n  failWithDetail,\n  Hash,\n  mapResults,\n  MessageAggregator,\n  Result,\n  succeed,\n  succeedWithDetail,\n  ValidatingResultMap\n} from '@fgv/ts-utils';\nimport {\n  ConditionCollector,\n  ConditionSetCollector,\n  ReadOnlyConditionCollector,\n  ReadOnlyConditionSetCollector\n} from '../conditions';\nimport { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\nimport { ReadOnlyResourceTypeCollector } from '../resource-types';\nimport { Convert, ResourceId, Validate } from '../common';\nimport { IResourceManager } from '../runtime';\nimport { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';\nimport { Resource } from './resource';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { IResourceDeclarationOptions } from './common';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n/**\n * Interface for parameters to the {@link Resources.ResourceManagerBuilder.create | ResourceManagerBuilder create method}.\n * @public\n */\nexport interface IResourceManagerBuilderCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  resourceTypes: ReadOnlyResourceTypeCollector;\n}\n\n/**\n * Error details that can be returned by a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n * @public\n */\nexport type ResourceManagerBuilderResultDetail =\n  | Collections.ResultMapResultDetail\n  | ResourceBuilderResultDetail;\n\n/**\n * Builder for a collection of {@link Resources.Resource | resources}. Collects\n * {@link Resources.ResourceCandidate | candidates} for each resource into a\n * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,\n * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.\n * @public\n */\nexport class ResourceManagerBuilder implements IResourceManager {\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n  public readonly resourceTypes: ReadOnlyResourceTypeCollector;\n\n  protected readonly _conditions: ConditionCollector;\n  protected readonly _conditionSets: ConditionSetCollector;\n  protected readonly _decisions: AbstractDecisionCollector;\n  protected readonly _resources: ValidatingResultMap<ResourceId, ResourceBuilder>;\n  public readonly _builtResources: ValidatingResultMap<ResourceId, Resource>;\n\n  protected _built: boolean;\n\n  /**\n   * A {@link Conditions.ConditionCollector | ConditionCollector} which\n   * contains the {@link Conditions.Condition | conditions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditions(): ReadOnlyConditionCollector {\n    return this._conditions;\n  }\n\n  /**\n   * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which\n   * contains the {@link Conditions.ConditionSet | condition sets} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditionSets(): ReadOnlyConditionSetCollector {\n    return this._conditionSets;\n  }\n\n  /**\n   * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which\n   * contains the {@link Decisions.Decision | abstract decisions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get decisions(): ReadOnlyAbstractDecisionCollector {\n    return this._decisions;\n  }\n\n  /**\n   * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.\n   */\n  public get resources(): Collections.IReadOnlyValidatingResultMap<ResourceId, ResourceBuilder> {\n    return this._resources;\n  }\n\n  /**\n   * The number of {@link Resources.Resource | resources} contained by the manager.\n   */\n  public get size(): number {\n    return this._resources.size;\n  }\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.numResources}\n   */\n  public get numResources(): number {\n    return this._resources.size;\n  }\n\n  /**\n   * The number of candidates in this resource manager.\n   */\n  protected _numCandidates?: number;\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.numCandidates}\n   */\n  public get numCandidates(): number {\n    if (this._numCandidates === undefined) {\n      this._numCandidates = this.getAllCandidates().length;\n    }\n    return this._numCandidates;\n  }\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.builtResources}\n   */\n  public get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, Resource> {\n    return this._performBuild().orThrow();\n  }\n\n  /**\n   * Constructor for a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n   * @public\n   */\n  protected constructor(params: IResourceManagerBuilderCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.resourceTypes = params.resourceTypes;\n    this._conditions = ConditionCollector.create({ qualifiers: params.qualifiers }).orThrow();\n    this._conditionSets = ConditionSetCollector.create({ conditions: this._conditions }).orThrow();\n    this._decisions = AbstractDecisionCollector.create({ conditionSets: this._conditionSets }).orThrow();\n    this._resources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, ResourceBuilder>({\n        key: Convert.resourceId,\n        /* c8 ignore next 2 - defense in depth against internal error */\n        value: (from: unknown) =>\n          from instanceof ResourceBuilder ? succeed(from) : fail('not a resource builder')\n      })\n    });\n    this._builtResources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, Resource>({\n        key: Convert.resourceId,\n        /* c8 ignore next 1 - defense in depth against internal error */\n        value: (from: unknown) => (from instanceof Resource ? succeed(from) : fail('not a resource'))\n      })\n    });\n    this._built = false;\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n   * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceManagerBuilderCreateParams): Result<ResourceManagerBuilder> {\n    return captureResult(() => new ResourceManagerBuilder(params));\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds\n   * a {@link Resources.ResourceCandidate | candidate} to the manager.\n   * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.\n   * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public addLooseCandidate(\n    decl: ResourceJson.Json.ILooseResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const builderResult = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets,\n        decisions: this._decisions\n      })\n    );\n    /* c8 ignore next 6 - defense in depth against internal error */\n    if (builderResult.isFailure()) {\n      return failWithDetail(\n        `${id}: unable to get or add resource\\n${builderResult.message}`,\n        builderResult.detail\n      );\n    }\n    return builderResult.value.addLooseCandidate(decl).onSuccess((c, d) => {\n      this._builtResources.delete(id);\n      this._built = false;\n      this._numCandidates = undefined;\n      return succeedWithDetail(c, d);\n    });\n  }\n\n  public addResource(\n    decl: ResourceJson.Json.ILooseResourceDecl\n  ): DetailedResult<ResourceBuilder, ResourceBuilderResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const {\n      value: builder,\n      message: getOrAddMessage,\n      detail\n    } = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        typeName: decl.resourceTypeName,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets,\n        decisions: this._decisions\n      })\n    );\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (getOrAddMessage !== undefined) {\n      return failWithDetail(`${id}: unable to get or add resource\\n${getOrAddMessage}`, detail);\n    }\n\n    if (detail === 'exists') {\n      const { message } = builder.setResourceType(decl.resourceTypeName);\n      if (message !== undefined) {\n        return failWithDetail(`${id}: unable to set resource type\\n${message}`, 'type-mismatch');\n      }\n    }\n\n    const candidates = decl.candidates ?? [];\n    return mapResults(candidates.map((c) => builder.addChildCandidate(c)))\n      .onSuccess(() => {\n        return succeed(builder);\n      })\n      .withDetail('failure', detail);\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} present in the manager.\n   * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder} if successful,\n   * or `Failure` with an error message if not.\n   */\n  public getAllResources(): ReadonlyArray<ResourceBuilder> {\n    return Array.from(this._resources.values()).sort((a, b) => a.id.localeCompare(b.id));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} present in the manager.\n   */\n  public getAllCandidates(): ReadonlyArray<ResourceCandidate> {\n    return this.getAllResources().flatMap((r) => r.candidates);\n  }\n\n  /**\n   * Gets an individual {@link Resources.Resource | built resource} from the manager.\n   * @param id - The {@link ResourceId | id} of the resource to get.\n   * @returns `Success` with the resource if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltResource(id: string): Result<Resource> {\n    return this._resources.validating\n      .get(id)\n      .onSuccess((builder) => this._builtResources.validating.getOrAdd(id, () => builder.build()));\n  }\n\n  /**\n   * Validates a context declaration against the qualifiers managed by this resource manager.\n   * @param context - The context declaration to validate\n   * @returns Success with the validated context if successful, Failure otherwise\n   * @public\n   */\n  /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */\n  public validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl> {\n    return Context.Convert.validatedContextDecl.convert(context, {\n      qualifiers: this.qualifiers\n    });\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.\n   * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getAllBuiltResources(): Result<ReadonlyArray<Resource>> {\n    return this.build().onSuccess((manager) =>\n      succeed(Array.from(manager._builtResources.values()).sort((a, b) => a.id.localeCompare(b.id)))\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.\n   * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getAllBuiltCandidates(): Result<ReadonlyArray<ResourceCandidate>> {\n    return this.getAllBuiltResources().onSuccess((built) => succeed(built.flatMap((r) => r.candidates)));\n  }\n\n  /**\n   * Internal helper method that performs the actual building of resources.\n   * @returns `Success` with the built resources if all resources were built successfully, `Failure` otherwise.\n   * @internal\n   */\n  public _performBuild(): Result<Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>> {\n    if (this._built) {\n      return succeed(this._builtResources);\n    }\n\n    const errors: MessageAggregator = new MessageAggregator();\n    this._resources.forEach((r, id) => {\n      this._builtResources.getOrAdd(id, () => r.build()).aggregateError(errors);\n    });\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (errors.hasMessages) {\n      return fail(`build failed: ${errors.toString()}`);\n    }\n    this._built = true;\n    return succeed(this._builtResources);\n  }\n\n  /**\n   * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.\n   * @returns `Success` with the {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public build(): Result<this> {\n    return this._performBuild().onSuccess(() => succeed(this));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} that can match the supplied context.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - {@link Context.IContextMatchOptions | options} for the context match.\n   * @returns A read-only array of {@link Resources.ResourceCandidate | candidates} that can match the context.\n   * @public\n   */\n  public getCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceCandidate> {\n    return this.getAllCandidates().filter((candidate) => candidate.canMatchPartialContext(context, options));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} that have at least one candidate\n   * that can match the supplied context.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - {@link Context.IContextMatchOptions | options} for the context match.\n   * @returns A read-only array of {@link Resources.ResourceBuilder | resource builders} with matching candidates.\n   * @public\n   */\n  public getResourcesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceBuilder> {\n    return this.getAllResources().filter(\n      (resource) => resource.getCandidatesForContext(context, options).length > 0\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | built resource candidates} that can match the supplied context.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - {@link Context.IContextMatchOptions | options} for the context match.\n   * @returns `Success` with an array of {@link Resources.ResourceCandidate | candidates} if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): Result<ReadonlyArray<ResourceCandidate>> {\n    return this.getAllBuiltCandidates().onSuccess((candidates) =>\n      succeed(candidates.filter((candidate) => candidate.canMatchPartialContext(context, options)))\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} that have at least one candidate\n   * that can match the supplied context.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - {@link Context.IContextMatchOptions | options} for the context match.\n   * @returns `Success` with an array of {@link Resources.Resource | resources} if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltResourcesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): Result<ReadonlyArray<Resource>> {\n    return this.getAllBuiltResources().onSuccess((resources) =>\n      succeed(resources.filter((resource) => resource.getCandidatesForContext(context, options).length > 0))\n    );\n  }\n\n  /**\n   * Gets a compiled resource collection from the current state of the resource manager builder.\n   * This method generates an optimized, index-based representation of all resources, conditions,\n   * and decisions that can be used for serialization or efficient runtime processing.\n   * @param options - Optional compilation options controlling the output format.\n   * @returns Success with the compiled resource collection if successful, Failure otherwise.\n   * @public\n   */\n  public getCompiledResourceCollection(\n    options?: ResourceJson.Compiled.ICompiledResourceOptions\n  ): Result<ResourceJson.Compiled.ICompiledResourceCollection> {\n    // Build resources first to ensure all data is available\n    const buildResult = this._performBuild();\n    if (buildResult.isFailure()) {\n      return fail(`Failed to build resources: ${buildResult.message}`);\n    }\n\n    // Generate compiled data from internal collections using the new toCompiled methods\n    // Note: All objects have a defined index property due to the collector pattern - indices are assigned during collection building\n    const compiledData = {\n      qualifierTypes: Array.from(this.qualifiers.qualifierTypes.values()).map((qt) => ({\n        name: qt.name\n      })),\n      qualifiers: Array.from(this.qualifiers.values()).map((q) => ({\n        name: q.name,\n        type: q.type.index!,\n        defaultPriority: q.defaultPriority\n      })),\n      resourceTypes: Array.from(this.resourceTypes.values()).map((rt) => ({\n        name: rt.key\n      })),\n      conditions: Array.from(this._conditions.values()).map((c) => c.toCompiled(options)),\n      conditionSets: Array.from(this._conditionSets.values()).map((cs) => cs.toCompiled(options)),\n      decisions: Array.from(this._decisions.values()).map((d) => d.toCompiled(options)),\n      resources: Array.from(this._builtResources.values()).map((r) => r.toCompiled(options))\n    };\n\n    // Apply validation through the converter\n    return ResourceJson.Compiled.Convert.compiledResourceCollection.convert(compiledData);\n  }\n\n  /**\n   * Gets a resource collection declaration containing all built resources in a flat array structure.\n   * This method returns all built resources as an {@link ResourceJson.Normalized.IResourceCollectionDecl | IResourceCollectionDecl}\n   * that can be used for serialization, export, or re-import. Resources are sorted by ID for consistent ordering.\n   * @param options - Optional {@link Resources.IResourceDeclarationOptions | declaration options} controlling the output format.\n   * If `options.normalized` is `true`, applies hash-based normalization for additional consistency guarantees.\n   * @returns Success with the resource collection declaration if successful, Failure otherwise.\n   * @public\n   */\n  public getResourceCollectionDecl(\n    options?: IResourceDeclarationOptions\n  ): Result<ResourceJson.Normalized.IResourceCollectionDecl> {\n    return this._performBuild().onSuccess(() => {\n      // Get all built resources and convert to loose resource declarations\n      const resources = Array.from(this._builtResources.values()).map((resource) =>\n        resource.toLooseResourceDecl(options)\n      );\n\n      // Sort resources by ID for consistent ordering\n      resources.sort((a, b) => a.id.localeCompare(b.id));\n\n      // Create the collection declaration structure\n      const collectionData = {\n        resources\n      };\n\n      // Convert and validate using the normalized converter\n      return ResourceJson.Convert.resourceCollectionDecl\n        .convert(collectionData)\n        .onSuccess((compiledCollection) => {\n          // Apply hash-based normalization only if requested\n          if (options?.normalized === true) {\n            const normalizer = new Hash.Crc32Normalizer();\n            return normalizer\n              .normalize(compiledCollection)\n              .withErrorFormat((e) => `Failed to normalize resource collection: ${e}`);\n          }\n          return succeed(compiledCollection);\n        });\n    });\n  }\n\n  /**\n   * Creates a filtered clone of this ResourceManagerBuilder using the specified context.\n   * This is a convenience method that creates a new ResourceManagerBuilder with the same\n   * configuration but filtered to include only candidates that match the provided context.\n   * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.\n   * @returns A Result containing the new filtered ResourceManagerBuilder.\n   * @public\n   */\n  /* c8 ignore next 21 - functional code path tested but coverage intermittently missed */\n  public clone(options?: IResourceDeclarationOptions): Result<ResourceManagerBuilder> {\n    return this.getResourceCollectionDecl(options).onSuccess((collection) => {\n      return ResourceManagerBuilder.create({\n        qualifiers: this.qualifiers,\n        resourceTypes: this.resourceTypes\n      }).onSuccess((newManager) => {\n        // Add each resource from the filtered collection to the new manager\n        if (collection.resources) {\n          for (const resourceDecl of collection.resources) {\n            const addResult = newManager.addResource(resourceDecl);\n            if (addResult.isFailure()) {\n              return fail(\n                `${resourceDecl.id}: Failed to add resource to cloned manager: ${addResult.message}`\n              );\n            }\n          }\n        }\n        return succeed(newManager);\n      });\n    });\n  }\n}\n"]}

package/lib/packlets/runtime/cacheListener.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Type indicating which {@link Runtime.ResourceResolver | ResourceResolver} cache is affected.
+ * @public
+ */
+export type ResourceResolverCacheType = 'condition' | 'conditionSet' | 'decision';
+/**
+ * Type indicating the action performed on a {@link Runtime.ResourceResolver | ResourceResolver} cache.
+ * @public
+ */
+export type ResourceResolverCacheActivity = 'hit' | 'miss' | 'error' | 'clear';
+/**
+ * A listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.
+ * @public
+ */
+export interface IResourceResolverCacheListener {
+    /**
+     * Called when a cache hit occurs.
+     * @param cache - The type of cache that was hit.
+     * @param index - The index of the cache that was hit.
+     */
+    onCacheHit(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * Called when a cache miss occurs.
+     * @param cache - The type of cache that was missed.
+     * @param index - The index of the cache that was missed.
+     */
+    onCacheMiss(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * Called when a cache error occurs.
+     * @param cache - The type of cache that had an error.
+     * @param index - The index of the cache that had an error.
+     */
+    onCacheError(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * Called when a cache is cleared.
+     * @param cache - The type of cache that was cleared.
+     */
+    onCacheClear(cache: ResourceResolverCacheType): void;
+}
+/**
+ * A no-op implementation of {@link Runtime.IResourceResolverCacheListener}.
+ * @public
+ */
+export declare class NoOpResourceResolverCacheListener implements IResourceResolverCacheListener {
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}
+     */
+    onCacheHit(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}
+     */
+    onCacheMiss(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}
+     */
+    onCacheError(cache: ResourceResolverCacheType, index: number): void;
+    /**
+     * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}
+     */
+    onCacheClear(cache: ResourceResolverCacheType): void;
+}
+//# sourceMappingURL=cacheListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cacheListener.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheListener.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElE;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpE;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,iCAAkC,YAAW,8BAA8B;IACtF;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxE;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzE;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1E;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;CAG5D"}

package/lib/packlets/runtime/cacheListener.js

@@ -0,0 +1,56 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpResourceResolverCacheListener = void 0;
+/**
+ * A no-op implementation of {@link Runtime.IResourceResolverCacheListener}.
+ * @public
+ */
+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.onCacheClear}
+     */
+    onCacheClear(cache) {
+        // no-op
+    }
+}
+exports.NoOpResourceResolverCacheListener = NoOpResourceResolverCacheListener;
+//# sourceMappingURL=cacheListener.js.map