@fgv/ts-res 4.5.0-0

package/lib/packlets/common/validate/conditions.d.ts

@@ -0,0 +1,248 @@
+import { Result } from '@fgv/ts-utils';
+import { ConditionPriority, QualifierName, QualifierTypeName, QualifierIndex, QualifierTypeIndex, ConditionIndex, ConditionSetIndex, QualifierMatchScore, ConditionKey, ConditionSetKey, DecisionKey, DecisionIndex, ConditionSetHash, ConditionOperator, ConditionToken, ConditionSetToken } from '../conditions';
+/**
+ * Determines whether a string is a valid qualifier name.
+ * @param name - the string to validate
+ * @returns true if the string is a valid qualifier name, false otherwise.
+ * @public
+ */
+export declare function isValidQualifierName(name: string): name is QualifierName;
+/***
+ * Determines whether a string is a valid qualifier type name.
+ * @param name - the string to validate
+ * @returns true if the string is a valid qualifier type name, false otherwise.
+ * @public
+ */
+export declare function isValidQualifierTypeName(name: string): name is QualifierTypeName;
+/**
+ * Determines whether a number is a valid priority.
+ * @param priority - the number to validate
+ * @returns true if the number is a valid priority, false otherwise.
+ * @public
+ */
+export declare function isValidConditionPriority(priority: number): priority is ConditionPriority;
+/**
+ * Determines whether a number is a valid qualifier index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid qualifier index, false otherwise.
+ * @public
+ */
+export declare function isValidQualifierIndex(index: number): index is QualifierIndex;
+/**
+ * Determines whether a number is a valid qualifier type index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid qualifier type index, false otherwise.
+ * @public
+ */
+export declare function isValidQualifierTypeIndex(index: number): index is QualifierTypeIndex;
+/**
+ * Determines whether a supplied value is a valid {@link QualifierMatchScore | match score}.
+ * @param value - The value to validate.
+ * @returns - `true` if the value is a valid match score, `false` otherwise.
+ * @public
+ */
+export declare function isValidQualifierMatchScore(value: number): value is QualifierMatchScore;
+/**
+ * Determines whether a number is a valid condition index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid condition index, false otherwise.
+ * @public
+ */
+export declare function isValidConditionIndex(index: number): index is ConditionIndex;
+/**
+ * Determines whether a string is a valid condition operator.
+ * @param operator - the string to validate
+ * @returns true if the string is a valid condition operator, false otherwise.
+ * @public
+ */
+export declare function isValidConditionOperator(operator: string): operator is ConditionOperator;
+/**
+ * Determines whether a string is a valid condition key.  A condition key has
+ * the format:
+ * `<qualifierName>(-<operator>)?-[<value>]@<priority>`
+ * where operator is omitted for the default 'matches' operator.
+ * @param key - the string to validate
+ * @returns `true` if the string is a valid condition key, `false` otherwise.
+ * @public
+ */
+export declare function isValidConditionKey(key: string): key is ConditionKey;
+/**
+ * Determines whether a string is a valid {@link ConditionToken | condition token}.
+ * A condition token has the format:
+ * `<qualifierName>=<value>` or `<value>`
+ * @param token -
+ * @returns `true` if the string is a valid condition token, `false` otherwise.
+ * @public
+ */
+export declare function isValidConditionToken(token: string): token is ConditionToken;
+/**
+ * Determines whether a number is a valid condition set index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid condition set index, false otherwise.
+ * @public
+ */
+export declare function isValidConditionSetIndex(index: number): index is ConditionSetIndex;
+/**
+ * Determines whether a string is a valid condition set key.
+ * @param key - the string to validate.
+ * @returns `true` if the string is a valid condition set key, `false` otherwise.
+ * @public
+ */
+export declare function isValidConditionSetKey(key: string): key is ConditionSetKey;
+/**
+ * Determines whether a string is a valid condition set token.
+ * @param token - the string to validate.
+ * @returns `true` if the string is a valid condition set token, `false` otherwise.
+ * @public
+ */
+export declare function isValidConditionSetToken(token: string): token is ConditionSetToken;
+/**
+ * Determines whether a string is a valid condition set hash.
+ * @param hash - the string to validate.
+ * @returns `true` if the string is a valid condition set hash, `false` otherwise.
+ * @public
+ */
+export declare function isValidConditionSetHash(hash: string): hash is ConditionSetHash;
+/**
+ * Determines whether a string is a valid decision key.
+ * @param key - the string to validate
+ * @returns `true` if the string is a valid decision key, `false` otherwise.
+ * @public
+ */
+export declare function isValidDecisionKey(key: string): key is DecisionKey;
+/**
+ * Determines whether a number is a valid decision index.
+ * @param index - the number to validate
+ * @returns `true` if the number is a valid decision index, `false` otherwise.
+ * @public
+ */
+export declare function isValidDecisionIndex(index: number): index is DecisionIndex;
+/**
+ * Converts a string to a {@link QualifierName} if it is a valid qualifier name.
+ * @param name - the string to convert
+ * @returns `Success` with the converted {@link QualifierName} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toQualifierName(name: string): Result<QualifierName>;
+/**
+ * Converts a number to a {@link QualifierIndex} if it is a valid qualifier index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link QualifierIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toQualifierIndex(index: number): Result<QualifierIndex>;
+/**
+ * Converts a string to a {@link QualifierTypeName} if it is a valid qualifier type name.
+ * @param name - the string to convert
+ * @returns `Success` with the converted {@link QualifierTypeName} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toQualifierTypeName(name: string): Result<QualifierTypeName>;
+/**
+ * Converts a number to a {@link QualifierTypeIndex} if it is a valid qualifier type index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link QualifierTypeIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toQualifierTypeIndex(index: number): Result<QualifierTypeIndex>;
+/**
+ * Converts a number to a {@link QualifierMatchScore | match score} if it is a valid score.
+ * @param value - The number to convert.
+ * @returns `Success` with the converted score if successful, or `Failure` with an error message
+ * if not.
+ * @public
+ */
+export declare function toQualifierMatchScore(value: number): Result<QualifierMatchScore>;
+/**
+ * Converts a number to a {@link ConditionPriority} if it is a valid priority.
+ * @param priority - the number to convert
+ * @returns `Success` with the converted {@link ConditionPriority} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionPriority(priority: number): Result<ConditionPriority>;
+/**
+ * Converts a number to a {@link ConditionIndex} if it is a valid condition index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link ConditionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionIndex(index: number): Result<ConditionIndex>;
+/**
+ * Converts a string to a {@link ConditionOperator} if it is a valid condition operator.
+ * @param operator - the string to convert
+ * @returns `Success` with the converted {@link ConditionOperator} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionOperator(operator: string): Result<ConditionOperator>;
+/**
+ * Converts a string to a {@link ConditionKey} if it is a valid condition key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionKey} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionKey(key: string): Result<ConditionKey>;
+/**
+ * Converts a string to a {@link ConditionToken} if it is a valid condition token.
+ * @param token - the string to convert
+ * @returns `Success` with the converted {@link ConditionToken} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionToken(token: string): Result<ConditionToken>;
+/**
+ * Converts a number to a {@link ConditionSetIndex} if it is a valid condition set index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link ConditionSetIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionSetIndex(index: number): Result<ConditionSetIndex>;
+/**
+ * Converts a string to a {@link ConditionSetKey} if it is a valid condition set key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetKey} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionSetKey(key: string): Result<ConditionSetKey>;
+/**
+ * Converts a string to a {@link ConditionSetToken} if it is a valid condition set token.
+ * @param token - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetToken} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionSetToken(token: string): Result<ConditionSetToken>;
+/**
+ * Converts a string to a {@link ConditionSetHash} if it is a valid condition set hash.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetHash} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toConditionSetHash(hash: string): Result<ConditionSetHash>;
+/**
+ * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toDecisionKey(key: string): Result<DecisionKey>;
+/**
+ * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+export declare function toDecisionIndex(index: number): Result<DecisionIndex>;
+//# sourceMappingURL=conditions.d.ts.map

package/lib/packlets/common/validate/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../../src/packlets/common/validate/conditions.ts"],"names":[],"mappings":"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"}

package/lib/packlets/common/validate/conditions.js

@@ -0,0 +1,436 @@
+"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.isValidQualifierName = isValidQualifierName;
+exports.isValidQualifierTypeName = isValidQualifierTypeName;
+exports.isValidConditionPriority = isValidConditionPriority;
+exports.isValidQualifierIndex = isValidQualifierIndex;
+exports.isValidQualifierTypeIndex = isValidQualifierTypeIndex;
+exports.isValidQualifierMatchScore = isValidQualifierMatchScore;
+exports.isValidConditionIndex = isValidConditionIndex;
+exports.isValidConditionOperator = isValidConditionOperator;
+exports.isValidConditionKey = isValidConditionKey;
+exports.isValidConditionToken = isValidConditionToken;
+exports.isValidConditionSetIndex = isValidConditionSetIndex;
+exports.isValidConditionSetKey = isValidConditionSetKey;
+exports.isValidConditionSetToken = isValidConditionSetToken;
+exports.isValidConditionSetHash = isValidConditionSetHash;
+exports.isValidDecisionKey = isValidDecisionKey;
+exports.isValidDecisionIndex = isValidDecisionIndex;
+exports.toQualifierName = toQualifierName;
+exports.toQualifierIndex = toQualifierIndex;
+exports.toQualifierTypeName = toQualifierTypeName;
+exports.toQualifierTypeIndex = toQualifierTypeIndex;
+exports.toQualifierMatchScore = toQualifierMatchScore;
+exports.toConditionPriority = toConditionPriority;
+exports.toConditionIndex = toConditionIndex;
+exports.toConditionOperator = toConditionOperator;
+exports.toConditionKey = toConditionKey;
+exports.toConditionToken = toConditionToken;
+exports.toConditionSetIndex = toConditionSetIndex;
+exports.toConditionSetKey = toConditionSetKey;
+exports.toConditionSetToken = toConditionSetToken;
+exports.toConditionSetHash = toConditionSetHash;
+exports.toDecisionKey = toDecisionKey;
+exports.toDecisionIndex = toDecisionIndex;
+const ts_utils_1 = require("@fgv/ts-utils");
+const conditions_1 = require("../conditions");
+const regularExpressions_1 = require("./regularExpressions");
+/**
+ * Determines whether a string is a valid qualifier name.
+ * @param name - the string to validate
+ * @returns true if the string is a valid qualifier name, false otherwise.
+ * @public
+ */
+function isValidQualifierName(name) {
+    return regularExpressions_1.identifier.test(name);
+}
+/***
+ * Determines whether a string is a valid qualifier type name.
+ * @param name - the string to validate
+ * @returns true if the string is a valid qualifier type name, false otherwise.
+ * @public
+ */
+function isValidQualifierTypeName(name) {
+    return regularExpressions_1.identifier.test(name);
+}
+/**
+ * Determines whether a number is a valid priority.
+ * @param priority - the number to validate
+ * @returns true if the number is a valid priority, false otherwise.
+ * @public
+ */
+function isValidConditionPriority(priority) {
+    return priority >= conditions_1.MinConditionPriority && priority <= conditions_1.MaxConditionPriority;
+}
+/**
+ * Determines whether a number is a valid qualifier index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid qualifier index, false otherwise.
+ * @public
+ */
+function isValidQualifierIndex(index) {
+    return index >= 0;
+}
+/**
+ * Determines whether a number is a valid qualifier type index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid qualifier type index, false otherwise.
+ * @public
+ */
+function isValidQualifierTypeIndex(index) {
+    return index >= 0;
+}
+/**
+ * Determines whether a supplied value is a valid {@link QualifierMatchScore | match score}.
+ * @param value - The value to validate.
+ * @returns - `true` if the value is a valid match score, `false` otherwise.
+ * @public
+ */
+function isValidQualifierMatchScore(value) {
+    return value >= conditions_1.NoMatch && value <= conditions_1.PerfectMatch;
+}
+/**
+ * Determines whether a number is a valid condition index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid condition index, false otherwise.
+ * @public
+ */
+function isValidConditionIndex(index) {
+    return index >= 0;
+}
+/**
+ * Determines whether a string is a valid condition operator.
+ * @param operator - the string to validate
+ * @returns true if the string is a valid condition operator, false otherwise.
+ * @public
+ */
+function isValidConditionOperator(operator) {
+    return conditions_1.allConditionOperators.includes(operator);
+}
+/**
+ * Determines whether a string is a valid condition key.  A condition key has
+ * the format:
+ * `<qualifierName>(-<operator>)?-[<value>]@<priority>`
+ * where operator is omitted for the default 'matches' operator.
+ * @param key - the string to validate
+ * @returns `true` if the string is a valid condition key, `false` otherwise.
+ * @public
+ */
+function isValidConditionKey(key) {
+    return regularExpressions_1.conditionKey.test(key);
+}
+/**
+ * Determines whether a string is a valid {@link ConditionToken | condition token}.
+ * A condition token has the format:
+ * `<qualifierName>=<value>` or `<value>`
+ * @param token -
+ * @returns `true` if the string is a valid condition token, `false` otherwise.
+ * @public
+ */
+function isValidConditionToken(token) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (token === '') {
+        return true;
+    }
+    return regularExpressions_1.conditionToken.test(token);
+}
+/**
+ * Determines whether a number is a valid condition set index.
+ * @param index - the number to validate
+ * @returns true if the number is a valid condition set index, false otherwise.
+ * @public
+ */
+function isValidConditionSetIndex(index) {
+    return index >= 0;
+}
+/**
+ * Determines whether a string is a valid condition set key.
+ * @param key - the string to validate.
+ * @returns `true` if the string is a valid condition set key, `false` otherwise.
+ * @public
+ */
+function isValidConditionSetKey(key) {
+    if (key === '') {
+        return true;
+    }
+    // a condition set key is a `+` separated list of condition keys
+    return key.split('+').every(isValidConditionKey);
+}
+/**
+ * Determines whether a string is a valid condition set token.
+ * @param token - the string to validate.
+ * @returns `true` if the string is a valid condition set token, `false` otherwise.
+ * @public
+ */
+function isValidConditionSetToken(token) {
+    return token.split(',').every(isValidConditionToken);
+}
+/**
+ * Determines whether a string is a valid condition set hash.
+ * @param hash - the string to validate.
+ * @returns `true` if the string is a valid condition set hash, `false` otherwise.
+ * @public
+ */
+function isValidConditionSetHash(hash) {
+    return regularExpressions_1.conditionSetHash.test(hash);
+}
+/**
+ * Determines whether a string is a valid decision key.
+ * @param key - the string to validate
+ * @returns `true` if the string is a valid decision key, `false` otherwise.
+ * @public
+ */
+function isValidDecisionKey(key) {
+    if (key === '') {
+        return true;
+    }
+    return regularExpressions_1.decisionKey.test(key);
+}
+/**
+ * Determines whether a number is a valid decision index.
+ * @param index - the number to validate
+ * @returns `true` if the number is a valid decision index, `false` otherwise.
+ * @public
+ */
+function isValidDecisionIndex(index) {
+    return index >= 0;
+}
+/**
+ * Converts a string to a {@link QualifierName} if it is a valid qualifier name.
+ * @param name - the string to convert
+ * @returns `Success` with the converted {@link QualifierName} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toQualifierName(name) {
+    if (!isValidQualifierName(name)) {
+        return (0, ts_utils_1.fail)(`${name}: not a valid qualifier name`);
+    }
+    return (0, ts_utils_1.succeed)(name);
+}
+/**
+ * Converts a number to a {@link QualifierIndex} if it is a valid qualifier index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link QualifierIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toQualifierIndex(index) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidQualifierIndex(index)) {
+        return (0, ts_utils_1.fail)(`${index}: not a valid qualifier index`);
+    }
+    return (0, ts_utils_1.succeed)(index);
+}
+/**
+ * Converts a string to a {@link QualifierTypeName} if it is a valid qualifier type name.
+ * @param name - the string to convert
+ * @returns `Success` with the converted {@link QualifierTypeName} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toQualifierTypeName(name) {
+    if (!isValidQualifierTypeName(name)) {
+        return (0, ts_utils_1.fail)(`${name}: not a valid qualifier type name`);
+    }
+    return (0, ts_utils_1.succeed)(name);
+}
+/**
+ * Converts a number to a {@link QualifierTypeIndex} if it is a valid qualifier type index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link QualifierTypeIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toQualifierTypeIndex(index) {
+    if (!isValidQualifierTypeIndex(index)) {
+        return (0, ts_utils_1.fail)(`${index}: not a valid qualifier type index`);
+    }
+    return (0, ts_utils_1.succeed)(index);
+}
+/**
+ * Converts a number to a {@link QualifierMatchScore | match score} if it is a valid score.
+ * @param value - The number to convert.
+ * @returns `Success` with the converted score if successful, or `Failure` with an error message
+ * if not.
+ * @public
+ */
+function toQualifierMatchScore(value) {
+    if (!isValidQualifierMatchScore(value)) {
+        return (0, ts_utils_1.fail)(`${value}: not a valid match score`);
+    }
+    return (0, ts_utils_1.succeed)(value);
+}
+/**
+ * Converts a number to a {@link ConditionPriority} if it is a valid priority.
+ * @param priority - the number to convert
+ * @returns `Success` with the converted {@link ConditionPriority} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionPriority(priority) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionPriority(priority)) {
+        return (0, ts_utils_1.fail)(`${priority}: not a valid priority`);
+    }
+    return (0, ts_utils_1.succeed)(priority);
+}
+/**
+ * Converts a number to a {@link ConditionIndex} if it is a valid condition index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link ConditionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionIndex(index) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionIndex(index)) {
+        return (0, ts_utils_1.fail)(`${index}: not a valid condition index`);
+    }
+    return (0, ts_utils_1.succeed)(index);
+}
+/**
+ * Converts a string to a {@link ConditionOperator} if it is a valid condition operator.
+ * @param operator - the string to convert
+ * @returns `Success` with the converted {@link ConditionOperator} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionOperator(operator) {
+    if (!isValidConditionOperator(operator)) {
+        return (0, ts_utils_1.fail)(`${operator}: not a valid condition operator`);
+    }
+    return (0, ts_utils_1.succeed)(operator);
+}
+/**
+ * Converts a string to a {@link ConditionKey} if it is a valid condition key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionKey} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionKey(key) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionKey(key)) {
+        return (0, ts_utils_1.fail)(`${key}: not a valid condition key`);
+    }
+    return (0, ts_utils_1.succeed)(key);
+}
+/**
+ * Converts a string to a {@link ConditionToken} if it is a valid condition token.
+ * @param token - the string to convert
+ * @returns `Success` with the converted {@link ConditionToken} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionToken(token) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionToken(token)) {
+        return (0, ts_utils_1.fail)(`${token}: not a valid condition token`);
+    }
+    return (0, ts_utils_1.succeed)(token);
+}
+/**
+ * Converts a number to a {@link ConditionSetIndex} if it is a valid condition set index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link ConditionSetIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionSetIndex(index) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionSetIndex(index)) {
+        return (0, ts_utils_1.fail)(`${index}: not a valid condition set index`);
+    }
+    return (0, ts_utils_1.succeed)(index);
+}
+/**
+ * Converts a string to a {@link ConditionSetKey} if it is a valid condition set key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetKey} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionSetKey(key) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidConditionSetKey(key)) {
+        return (0, ts_utils_1.fail)(`${key}: not a valid condition set key`);
+    }
+    return (0, ts_utils_1.succeed)(key);
+}
+/**
+ * Converts a string to a {@link ConditionSetToken} if it is a valid condition set token.
+ * @param token - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetToken} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionSetToken(token) {
+    if (!isValidConditionSetToken(token)) {
+        return (0, ts_utils_1.fail)(`${token}: not a valid condition set token`);
+    }
+    return (0, ts_utils_1.succeed)(token);
+}
+/**
+ * Converts a string to a {@link ConditionSetHash} if it is a valid condition set hash.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link ConditionSetHash} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toConditionSetHash(hash) {
+    if (!isValidConditionSetHash(hash)) {
+        return (0, ts_utils_1.fail)(`${hash}: not a valid condition set hash`);
+    }
+    return (0, ts_utils_1.succeed)(hash);
+}
+/**
+ * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toDecisionKey(key) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidDecisionKey(key)) {
+        return (0, ts_utils_1.fail)(`${key}: not a valid decision key`);
+    }
+    return (0, ts_utils_1.succeed)(key);
+}
+/**
+ * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
+ * @param index - the number to convert
+ * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * error message if not.
+ * @public
+ */
+function toDecisionIndex(index) {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!isValidDecisionIndex(index)) {
+        return (0, ts_utils_1.fail)(`${index}: not a valid decision index`);
+    }
+    return (0, ts_utils_1.succeed)(index);
+}
+//# sourceMappingURL=conditions.js.map