@fgv/ts-res 5.0.0-11 → 5.0.0-14

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

@@ -0,0 +1,89 @@
+"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.TestQualifierType = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const TsRes = __importStar(require("../../../index"));
+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
+        });
+    }
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new TestQualifierType(params));
+    }
+    isValidConditionValue(value) {
+        return true;
+    }
+    validateCondition(value, operator) {
+        return this.isValidConditionValue(value) ? (0, ts_utils_1.succeed)(value) : (0, ts_utils_1.fail)(`Invalid condition value: ${value}`);
+    }
+    _matchOne(condition, context, operator) {
+        if (condition === context) {
+            return TsRes.PerfectMatch;
+        }
+        if (condition.toLowerCase() === context.toLowerCase()) {
+            return 0.5;
+        }
+        return TsRes.NoMatch;
+    }
+}
+exports.TestQualifierType = TestQualifierType;
+//# sourceMappingURL=testQualifierType.js.map

package/lib/test/unit/qualifiers/convert.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=convert.test.d.ts.map

package/lib/test/unit/qualifiers/qualifierCollector.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=qualifierCollector.test.d.ts.map

package/lib/test/unit/qualifiers/qualifierDefaultValue.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=qualifierDefaultValue.test.d.ts.map

package/lib/test/unit/qualifiers/qualifierDefaultValueToken.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=qualifierDefaultValueToken.test.d.ts.map

package/lib/test/unit/resource-json/convert.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=convert.test.d.ts.map

package/lib/test/unit/resource-json/nameInheritance.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=nameInheritance.test.d.ts.map

package/lib/test/unit/resource-json/resourceDeclCollection.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceDeclCollection.test.d.ts.map

package/lib/test/unit/resource-json/resourceDeclTree.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceDeclTree.test.d.ts.map

package/lib/test/unit/resource-types/jsonResourceType.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=jsonResourceType.test.d.ts.map

package/lib/test/unit/resource-types/resourceTypeCollector.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceTypeCollector.test.d.ts.map

package/lib/test/unit/resources/candidateReducer.integration.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=candidateReducer.integration.test.d.ts.map

package/lib/test/unit/resources/candidateReducer.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=candidateReducer.test.d.ts.map

package/lib/test/unit/resources/reduceCandidates.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=reduceCandidates.test.d.ts.map

package/lib/test/unit/resources/reduceQualifiers.comprehensive.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=reduceQualifiers.comprehensive.test.d.ts.map

package/lib/test/unit/resources/reduceQualifiers.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=reduceQualifiers.test.d.ts.map

package/lib/test/unit/resources/resource.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resource.test.d.ts.map

package/lib/test/unit/resources/resourceBuilder.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceBuilder.test.d.ts.map

package/lib/test/unit/resources/resourceCandidate.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceCandidate.test.d.ts.map

package/lib/test/unit/resources/resourceManagerBuilder.getBuiltResourceTree.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceManagerBuilder.getBuiltResourceTree.test.d.ts.map

package/lib/test/unit/resources/resourceManagerBuilder.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceManagerBuilder.test.d.ts.map

package/lib/test/unit/runtime/cacheListener.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=cacheListener.test.d.ts.map

package/lib/test/unit/runtime/cacheMetrics.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=cacheMetrics.test.d.ts.map

package/lib/test/unit/runtime/compiledResourceCollection.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=compiledResourceCollection.test.d.ts.map

package/lib/test/unit/runtime/conditionSetResolutionResult.comprehensive.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=conditionSetResolutionResult.comprehensive.test.d.ts.map

package/lib/test/unit/runtime/conditionSetResolutionResult.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=conditionSetResolutionResult.test.d.ts.map

package/lib/test/unit/runtime/context/contextQualifierProvider.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=contextQualifierProvider.test.d.ts.map

package/lib/test/unit/runtime/context/contextQualifierProviderValidator.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=contextQualifierProviderValidator.test.d.ts.map

package/lib/test/unit/runtime/context/simpleContextQualifierProvider.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=simpleContextQualifierProvider.test.d.ts.map

package/lib/test/unit/runtime/context/validatingSimpleContextQualifierProvider.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=validatingSimpleContextQualifierProvider.test.d.ts.map

package/lib/test/unit/runtime/resource-tree/readOnlyResourceTree.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=readOnlyResourceTree.test.d.ts.map

package/lib/test/unit/runtime/resource-tree/resourceTreeChildren.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceTreeChildren.test.d.ts.map

package/lib/test/unit/runtime/resource-tree/resourceTreeChildrenValidator.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceTreeChildrenValidator.test.d.ts.map

package/lib/test/unit/runtime/resourceResolver.defaultResolution.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceResolver.defaultResolution.test.d.ts.map

package/lib/test/unit/runtime/resourceResolver.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceResolver.test.d.ts.map

package/lib/test/unit/runtime/validate.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=validate.test.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-res",
-  "version": "5.0.0-11",
+  "version": "5.0.0-14",
   "description": "Multi-dimensional Resource Runtime",
   "main": "lib/index.js",
   "types": "dist/ts-res.d.ts",
@@ -18,48 +18,41 @@
   "homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-res#readme",
   "sideEffects": false,
   "devDependencies": {
-    "@microsoft/api-documenter": "^7.26.29",
-    "@microsoft/api-extractor": "^7.49.1",
+    "@microsoft/api-documenter": "^7.26.31",
+    "@microsoft/api-extractor": "^7.52.10",
     "@types/jest": "^29.5.14",
-    "@types/luxon": "^3.6.2",
+    "@types/luxon": "^3.7.1",
     "@types/node": "^20.14.9",
     "@typescript-eslint/eslint-plugin": "^7.14.1",
     "@typescript-eslint/parser": "^7.14.1",
     "eslint": "^8.57.0",
-    "eslint-config-prettier": "^10.1.5",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^5.5.1",
+    "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-promise": "^6.2.0",
     "jest": "^29.7.0",
     "prettier": "^3.6.2",
     "rimraf": "^5.0.7",
-    "ts-jest": "^29.4.0",
+    "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "eslint-plugin-n": "^16.6.2",
     "@rushstack/eslint-config": "~4.4.0",
-    "@rushstack/heft": "~0.74.0",
-    "@rushstack/heft-jest-plugin": "~0.16.9",
-    "@rushstack/heft-node-rig": "~2.9.0",
+    "@rushstack/heft": "~0.74.2",
+    "@rushstack/heft-jest-plugin": "~0.16.11",
+    "@rushstack/heft-node-rig": "~2.9.3",
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-tsdoc": "~0.4.0",
-    "@fgv/ts-utils-jest": "5.0.0-11",
-    "@fgv/ts-extras": "5.0.0-11",
-    "@fgv/ts-utils": "5.0.0-11",
-    "@fgv/ts-bcp47": "5.0.0-11",
-    "@fgv/ts-json": "5.0.0-11",
-    "@fgv/ts-json-base": "5.0.0-11"
+    "@fgv/ts-utils-jest": "5.0.0-14"
   },
   "dependencies": {
-    "luxon": "^3.6.1"
-  },
-  "peerDependencies": {
-    "@fgv/ts-utils": "5.0.0-11",
-    "@fgv/ts-json-base": "5.0.0-11",
-    "@fgv/ts-extras": "5.0.0-11",
-    "@fgv/ts-bcp47": "5.0.0-11",
-    "@fgv/ts-json": "5.0.0-11"
+    "luxon": "^3.7.1",
+    "@fgv/ts-utils": "5.0.0-14",
+    "@fgv/ts-extras": "5.0.0-14",
+    "@fgv/ts-json": "5.0.0-14",
+    "@fgv/ts-json-base": "5.0.0-14",
+    "@fgv/ts-bcp47": "5.0.0-14"
   },
   "scripts": {
     "build": "heft build --clean",

package/src/index.ts

@@ -0,0 +1,73 @@
+/*
+ * 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 * as Bundle from './packlets/bundle';
+import * as QualifierTypes from './packlets/qualifier-types';
+import * as Qualifiers from './packlets/qualifiers';
+import * as Conditions from './packlets/conditions';
+import * as Config from './packlets/config';
+import * as Context from './packlets/context';
+import * as Decisions from './packlets/decisions';
+import * as ResourceJson from './packlets/resource-json';
+import * as Resources from './packlets/resources';
+import * as ResourceTypes from './packlets/resource-types';
+import * as Import from './packlets/import';
+import * as Runtime from './packlets/runtime';
+
+export * from './packlets/common';
+
+import { Condition, ConditionSet } from './packlets/conditions';
+import { Decision } from './packlets/decisions';
+import { QualifierType } from './packlets/qualifier-types';
+import { Qualifier } from './packlets/qualifiers';
+import { ResourceType } from './packlets/resource-types';
+import { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';
+import { IResourceManager, ResourceResolver } from './packlets/runtime';
+import { BundleBuilder, BundleLoader } from './packlets/bundle';
+
+export {
+  Bundle,
+  BundleBuilder,
+  BundleLoader,
+  Condition,
+  Conditions,
+  ConditionSet,
+  Config,
+  Context,
+  Decision,
+  Decisions,
+  Import,
+  IResourceManager,
+  Qualifier,
+  QualifierType,
+  QualifierTypes,
+  Qualifiers,
+  Resource,
+  ResourceCandidate,
+  ResourceJson,
+  ResourceResolver,
+  ResourceManagerBuilder,
+  ResourceType,
+  ResourceTypes,
+  Resources,
+  Runtime
+};

package/src/packlets/bundle/bundleBuilder.ts

@@ -0,0 +1,159 @@
+/*
+ * 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 { Result, succeed, Hash } from '@fgv/ts-utils';
+import { ResourceManagerBuilder } from '../resources';
+import {
+  SystemConfiguration,
+  PredefinedSystemConfiguration,
+  getPredefinedSystemConfiguration
+} from '../config';
+import { IBundle, IBundleCreateParams, IBundleMetadata } from './model';
+import { BundleNormalizer } from './bundleNormalizer';
+
+/**
+ * Builder for creating resource bundles from a ResourceManagerBuilder.
+ * Handles the compilation, configuration extraction, and integrity verification
+ * needed to create a complete, portable bundle.
+ * @public
+ */
+export class BundleBuilder {
+  /**
+   * Creates a resource bundle from a ResourceManagerBuilder.
+   * @param builder - The ResourceManagerBuilder containing the resources to bundle
+   * @param systemConfig - The SystemConfiguration used to create the builder
+   * @param params - Optional parameters for bundle creation
+   * @returns Success with the created bundle if successful, Failure with error message otherwise
+   * @public
+   */
+  public static create(
+    builder: ResourceManagerBuilder,
+    systemConfig: SystemConfiguration,
+    params?: IBundleCreateParams
+  ): Result<IBundle> {
+    /* c8 ignore next 2 - defense in depth */
+    params = params ?? {};
+    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();
+
+    const builderToUse =
+      params.normalize === true
+        ? BundleNormalizer.normalize(builder, systemConfig)
+        : /* c8 ignore next 1 - is tested but coverage gets confused */
+          succeed(builder);
+
+    return builderToUse.onSuccess((targetBuilder) => {
+      return systemConfig.getConfig().onSuccess((config) => {
+        return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {
+          return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess((checksum) => {
+            /* c8 ignore next 1 - defense in depth */
+            const dateBuilt = params.dateBuilt ?? new Date().toISOString();
+
+            const metadata: IBundleMetadata = {
+              dateBuilt,
+              checksum,
+              version: params.version,
+              description: params.description
+            };
+
+            const bundle: IBundle = {
+              metadata,
+              config,
+              compiledCollection
+            };
+
+            return succeed(bundle);
+          });
+        });
+      });
+    });
+  }
+
+  /**
+   * Creates a resource bundle from a ResourceManagerBuilder using a predefined system configuration.
+   * This is a convenience method for the common case of using predefined configurations.
+   * @param builder - The ResourceManagerBuilder containing the resources to bundle
+   * @param configName - The name of the predefined system configuration used
+   * @param params - Optional parameters for bundle creation
+   * @returns Success with the created bundle if successful, Failure with error message otherwise
+   * @public
+   */
+  public static createFromPredefined(
+    builder: ResourceManagerBuilder,
+    configName: PredefinedSystemConfiguration,
+    params?: IBundleCreateParams
+  ): Result<IBundle> {
+    /* c8 ignore next 1 */
+    params = params ?? {};
+    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();
+
+    // Determine which builder to use based on normalization setting
+    const builderToUse = params.normalize
+      ? BundleNormalizer.normalizeFromPredefined(builder, configName)
+      : succeed(builder);
+
+    return builderToUse.onSuccess((targetBuilder) => {
+      return getPredefinedSystemConfiguration(configName).onSuccess((systemConfig) => {
+        return systemConfig.getConfig().onSuccess((config) => {
+          return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {
+            return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess(
+              (checksum) => {
+                /* c8 ignore next 1 - defense in depth */
+                const dateBuilt = params.dateBuilt ?? new Date().toISOString();
+
+                const metadata: IBundleMetadata = {
+                  dateBuilt,
+                  checksum,
+                  version: params.version,
+                  /* c8 ignore next 1 - defense in depth */
+                  description: params?.description
+                };
+
+                const bundle: IBundle = {
+                  metadata,
+                  config,
+                  compiledCollection
+                };
+
+                return succeed(bundle);
+              }
+            );
+          });
+        });
+      });
+    });
+  }
+
+  /**
+   * Generates a hash checksum for the compiled resource collection.
+   * The checksum is calculated using the provided hash normalizer.
+   * @param compiledCollection - The compiled resource collection to generate checksum for
+   * @param hashNormalizer - The hash normalizer to use for checksum generation
+   * @returns Success with the checksum string if successful, Failure otherwise
+   * @internal
+   */
+  private static _generateChecksum(
+    compiledCollection: unknown,
+    hashNormalizer: Hash.HashingNormalizer
+  ): Result<string> {
+    return hashNormalizer.computeHash(compiledCollection);
+  }
+}