mono/packages/fs/dist/utils/validate.js
2025-01-23 07:22:43 +01:00

97 lines
3.1 KiB
JavaScript

const prettyPrintTypes = (types) => {
const addArticle = (str) => {
const vowels = ["a", "e", "i", "o", "u"];
if (vowels.includes(str[0])) {
return `an ${str}`;
}
return `a ${str}`;
};
return types.map(addArticle).join(" or ");
};
const isArrayOfNotation = function (typeDefinition) {
return typeDefinition.includes('array of ');
};
const extractTypeFromArrayOfNotation = function (typeDefinition) {
// The notation is e.g. 'array of string'
return typeDefinition.split(' of ')[1];
};
const isValidTypeDefinition = (typeStr) => {
if (isArrayOfNotation(typeStr)) {
return isValidTypeDefinition(extractTypeFromArrayOfNotation(typeStr));
}
return [
"string",
"number",
"boolean",
"array",
"object",
"buffer",
"null",
"undefined",
"function",
].some((validType) => validType === typeStr);
};
const detectType = function (value) {
if (value === null) {
return 'null';
}
if (Array.isArray(value)) {
return 'array';
}
if (Buffer.isBuffer(value)) {
return 'buffer';
}
return typeof value;
};
const onlyUniqueValuesInArrayFilter = function (value, index, self) {
return self.indexOf(value) === index;
};
const detectTypeDeep = (value) => {
let type = detectType(value);
let typesInArray;
if (type === "array") {
typesInArray = value
.map((element) => {
return detectType(element);
})
.filter(onlyUniqueValuesInArrayFilter);
type += ` of ${typesInArray.join(", ")}`;
}
return type;
};
const validateArray = (argumentValue, typeToCheck) => {
const allowedTypeInArray = extractTypeFromArrayOfNotation(typeToCheck);
if (detectType(argumentValue) !== "array") {
return false;
}
return argumentValue.every((element) => detectType(element) === allowedTypeInArray);
};
export const validateArgument = (methodName, argumentName, argumentValue, argumentMustBe) => {
const isOneOfAllowedTypes = argumentMustBe.some((type) => {
if (!isValidTypeDefinition(type)) {
throw new Error(`Unknown type "${type}"`);
}
if (isArrayOfNotation(type)) {
return validateArray(argumentValue, type);
}
return type === detectType(argumentValue);
});
if (!isOneOfAllowedTypes) {
throw new Error(`Argument "${argumentName}" passed to ${methodName} must be ${prettyPrintTypes(argumentMustBe)}. Received ${detectTypeDeep(argumentValue)}`);
}
};
export const validateOptions = (methodName, optionsObjName, obj, allowedOptions) => {
if (obj !== undefined) {
validateArgument(methodName, optionsObjName, obj, ["object"]);
Object.keys(obj).forEach((key) => {
const argName = `${optionsObjName}.${key}`;
if (allowedOptions[key] !== undefined) {
validateArgument(methodName, argName, obj[key], allowedOptions[key]);
}
else {
throw new Error(`Unknown argument "${argName}" passed to ${methodName}`);
}
});
}
};