@decaf-ts/decorator-validation
Version:
simple decorator based validation engine
89 lines • 12.9 kB
JavaScript
import { COMPARISON_ERROR_MESSAGES, VALIDATION_PARENT_KEY } from "./../constants/index.js";
import { sf } from "./strings.js";
const fallbackGetParent = (target) => {
return target[VALIDATION_PARENT_KEY];
};
const fallbackGetValue = (target, prop) => {
if (!Object.prototype.hasOwnProperty.call(target, prop))
throw new Error(sf(COMPARISON_ERROR_MESSAGES.PROPERTY_NOT_EXIST, prop));
return target[prop];
};
/**
* Standard path resolution utility for accessing nested object properties.
* Provides consistent dot-notation access to both parent and child properties
* across complex object structures.
*
* - Dot-notation path resolution ('object.child.property')
* - Parent traversal using '../' notation
* - Configurable property access behavior
* - Null/undefined safety checks
*/
export class PathProxyEngine {
/**
* Creates a path-aware proxy for the target object
* @template T - The type of the target object
* @param {T} rootTarget - The target object to proxy
* @param opts - Configuration options
* @param opts.getValue - Custom function to get property value
* @param opts.getParent - Custom function to get parent object
* @param opts.ignoreUndefined - Whether to ignore undefined values in paths
* @param opts.ignoreNull - Whether to ignore null values in paths
* @returns A proxy object with path access capabilities
*/
static create(rootTarget, opts) {
const { getValue, getParent, ignoreUndefined, ignoreNull } = {
getParent: fallbackGetParent,
getValue: fallbackGetValue,
ignoreNull: false,
ignoreUndefined: false,
...opts,
};
const proxy = new Proxy({}, {
get(target, prop) {
if (prop === "getValueFromPath") {
return function (path) {
const parts = PathProxyEngine.parsePath(path);
let current = rootTarget;
for (let i = 0; i < parts.length; i++) {
const part = parts[i];
if (part === "..") {
const parent = getParent(current);
if (!parent || typeof parent !== "object") {
throw new Error(sf(COMPARISON_ERROR_MESSAGES.CONTEXT_NOT_OBJECT_COMPARISON, i + 1, path));
}
current = parent; //PathProxyEngine.create(parentTarget, opts);
continue;
}
current = getValue(current, part);
if (!ignoreUndefined && typeof current === "undefined")
throw new Error(sf(COMPARISON_ERROR_MESSAGES.PROPERTY_INVALID, path, part));
if (!ignoreNull && current === null)
throw new Error(sf(COMPARISON_ERROR_MESSAGES.PROPERTY_INVALID, path, part));
}
return current;
};
}
return target[prop];
},
});
// Object.defineProperty(proxy, PROXY_PROP, {
// value: true, // overwrite by proxy behavior
// enumerable: false,
// configurable: false,
// writable: false,
// });
return proxy;
}
/**
* Parses a path string into individual components
* @param path - The path string to parse (e.g., "user.address.city")
* @returns An array of path components
* @throws Error if the path is invalid
*/
static parsePath(path) {
if (typeof path !== "string" || !path.trim())
throw new Error(sf(COMPARISON_ERROR_MESSAGES.INVALID_PATH, path));
return path.match(/(\.\.|[^/.]+)/g) || [];
}
}
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGF0aFByb3h5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3V0aWxzL1BhdGhQcm94eS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUseUJBQXlCLEVBQUUscUJBQXFCLEVBQUUsZ0NBQXFCO0FBQ2hGLE9BQU8sRUFBRSxFQUFFLEVBQUUscUJBQWtCO0FBRS9CLE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxNQUFXLEVBQUUsRUFBRTtJQUN4QyxPQUFPLE1BQU0sQ0FBQyxxQkFBcUIsQ0FBQyxDQUFDO0FBQ3ZDLENBQUMsQ0FBQztBQUVGLE1BQU0sZ0JBQWdCLEdBQUcsQ0FBQyxNQUFXLEVBQUUsSUFBWSxFQUFFLEVBQUU7SUFDckQsSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDO1FBQ3JELE1BQU0sSUFBSSxLQUFLLENBQUMsRUFBRSxDQUFDLHlCQUF5QixDQUFDLGtCQUFrQixFQUFFLElBQUksQ0FBQyxDQUFDLENBQUM7SUFDMUUsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDdEIsQ0FBQyxDQUFDO0FBV0Y7Ozs7Ozs7OztHQVNHO0FBQ0gsTUFBTSxPQUFPLGVBQWU7SUFDMUI7Ozs7Ozs7Ozs7T0FVRztJQUNILE1BQU0sQ0FBQyxNQUFNLENBQ1gsVUFBYSxFQUNiLElBS0M7UUFFRCxNQUFNLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxlQUFlLEVBQUUsVUFBVSxFQUFFLEdBQUc7WUFDM0QsU0FBUyxFQUFFLGlCQUFpQjtZQUM1QixRQUFRLEVBQUUsZ0JBQWdCO1lBQzFCLFVBQVUsRUFBRSxLQUFLO1lBQ2pCLGVBQWUsRUFBRSxLQUFLO1lBQ3RCLEdBQUcsSUFBSTtTQUNSLENBQUM7UUFFRixNQUFNLEtBQUssR0FBRyxJQUFJLEtBQUssQ0FBQyxFQUFTLEVBQUU7WUFDakMsR0FBRyxDQUFDLE1BQU0sRUFBRSxJQUFJO2dCQUNkLElBQUksSUFBSSxLQUFLLGtCQUFrQixFQUFFLENBQUM7b0JBQ2hDLE9BQU8sVUFBVSxJQUFZO3dCQUMzQixNQUFNLEtBQUssR0FBRyxlQUFlLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxDQUFDO3dCQUM5QyxJQUFJLE9BQU8sR0FBUSxVQUFVLENBQUM7d0JBRTlCLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7NEJBQ3RDLE1BQU0sSUFBSSxHQUFHLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQzs0QkFDdEIsSUFBSSxJQUFJLEtBQUssSUFBSSxFQUFFLENBQUM7Z0NBQ2xCLE1BQU0sTUFBTSxHQUFHLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztnQ0FDbEMsSUFBSSxDQUFDLE1BQU0sSUFBSSxPQUFPLE1BQU0sS0FBSyxRQUFRLEVBQUUsQ0FBQztvQ0FDMUMsTUFBTSxJQUFJLEtBQUssQ0FDYixFQUFFLENBQ0EseUJBQXlCLENBQUMsNkJBQTZCLEVBQ3ZELENBQUMsR0FBRyxDQUFDLEVBQ0wsSUFBSSxDQUNMLENBQ0YsQ0FBQztnQ0FDSixDQUFDO2dDQUNELE9BQU8sR0FBRyxNQUFNLENBQUMsQ0FBQyw2Q0FBNkM7Z0NBQy9ELFNBQVM7NEJBQ1gsQ0FBQzs0QkFFRCxPQUFPLEdBQUcsUUFBUSxDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsQ0FBQzs0QkFDbEMsSUFBSSxDQUFDLGVBQWUsSUFBSSxPQUFPLE9BQU8sS0FBSyxXQUFXO2dDQUNwRCxNQUFNLElBQUksS0FBSyxDQUNiLEVBQUUsQ0FBQyx5QkFBeUIsQ0FBQyxnQkFBZ0IsRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQzNELENBQUM7NEJBRUosSUFBSSxDQUFDLFVBQVUsSUFBSSxPQUFPLEtBQUssSUFBSTtnQ0FDakMsTUFBTSxJQUFJLEtBQUssQ0FDYixFQUFFLENBQUMseUJBQXlCLENBQUMsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUMzRCxDQUFDO3dCQUNOLENBQUM7d0JBRUQsT0FBTyxPQUFPLENBQUM7b0JBQ2pCLENBQUMsQ0FBQztnQkFDSixDQUFDO2dCQUVELE9BQU8sTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ3RCLENBQUM7U0FDRixDQUFDLENBQUM7UUFFSCw2Q0FBNkM7UUFDN0MsZ0RBQWdEO1FBQ2hELHVCQUF1QjtRQUN2Qix5QkFBeUI7UUFDekIscUJBQXFCO1FBQ3JCLE1BQU07UUFFTixPQUFPLEtBQXFCLENBQUM7SUFDL0IsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0ssTUFBTSxDQUFDLFNBQVMsQ0FBQyxJQUFZO1FBQ25DLElBQUksT0FBTyxJQUFJLEtBQUssUUFBUSxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRTtZQUMxQyxNQUFNLElBQUksS0FBSyxDQUFDLEVBQUUsQ0FBQyx5QkFBeUIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQztRQUNwRSxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDNUMsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ09NUEFSSVNPTl9FUlJPUl9NRVNTQUdFUywgVkFMSURBVElPTl9QQVJFTlRfS0VZIH0gZnJvbSBcIi4uL2NvbnN0YW50c1wiO1xuaW1wb3J0IHsgc2YgfSBmcm9tIFwiLi9zdHJpbmdzXCI7XG5cbmNvbnN0IGZhbGxiYWNrR2V0UGFyZW50ID0gKHRhcmdldDogYW55KSA9PiB7XG4gIHJldHVybiB0YXJnZXRbVkFMSURBVElPTl9QQVJFTlRfS0VZXTtcbn07XG5cbmNvbnN0IGZhbGxiYWNrR2V0VmFsdWUgPSAodGFyZ2V0OiBhbnksIHByb3A6IHN0cmluZykgPT4ge1xuICBpZiAoIU9iamVjdC5wcm90b3R5cGUuaGFzT3duUHJvcGVydHkuY2FsbCh0YXJnZXQsIHByb3ApKVxuICAgIHRocm93IG5ldyBFcnJvcihzZihDT01QQVJJU09OX0VSUk9SX01FU1NBR0VTLlBST1BFUlRZX05PVF9FWElTVCwgcHJvcCkpO1xuICByZXR1cm4gdGFyZ2V0W3Byb3BdO1xufTtcblxuLyoqXG4gKiBQcm94eSBvYmplY3QgdGhhdCBwcm92aWRlcyBwYXRoLWJhc2VkIGFjY2VzcyB0byBuZXN0ZWQgcHJvcGVydGllc1xuICogQHRlbXBsYXRlIFQgLSBUaGUgdHlwZSBvZiB0aGUgdGFyZ2V0IG9iamVjdCBiZWluZyBwcm94aWVkXG4gKi9cbmV4cG9ydCB0eXBlIFBhdGhQcm94eTxUPiA9IFQgJiB7XG4gIC8vIFtQUk9YWV9QUk9QXTogYm9vbGVhbjtcbiAgZ2V0VmFsdWVGcm9tUGF0aDogKHBhdGg6IHN0cmluZywgZmFsbGJhY2s/OiBhbnkpID0+IGFueTtcbn07XG5cbi8qKlxuICogU3RhbmRhcmQgcGF0aCByZXNvbHV0aW9uIHV0aWxpdHkgZm9yIGFjY2Vzc2luZyBuZXN0ZWQgb2JqZWN0IHByb3BlcnRpZXMuXG4gKiBQcm92aWRlcyBjb25zaXN0ZW50IGRvdC1ub3RhdGlvbiBhY2Nlc3MgdG8gYm90aCBwYXJlbnQgYW5kIGNoaWxkIHByb3BlcnRpZXNcbiAqIGFjcm9zcyBjb21wbGV4IG9iamVjdCBzdHJ1Y3R1cmVzLlxuICpcbiAqIC0gRG90LW5vdGF0aW9uIHBhdGggcmVzb2x1dGlvbiAoJ29iamVjdC5jaGlsZC5wcm9wZXJ0eScpXG4gKiAtIFBhcmVudCB0cmF2ZXJzYWwgdXNpbmcgJy4uLycgbm90YXRpb25cbiAqIC0gQ29uZmlndXJhYmxlIHByb3BlcnR5IGFjY2VzcyBiZWhhdmlvclxuICogLSBOdWxsL3VuZGVmaW5lZCBzYWZldHkgY2hlY2tzXG4gKi9cbmV4cG9ydCBjbGFzcyBQYXRoUHJveHlFbmdpbmUge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIHBhdGgtYXdhcmUgcHJveHkgZm9yIHRoZSB0YXJnZXQgb2JqZWN0XG4gICAqIEB0ZW1wbGF0ZSBUIC0gVGhlIHR5cGUgb2YgdGhlIHRhcmdldCBvYmplY3RcbiAgICogQHBhcmFtIHtUfSByb290VGFyZ2V0IC0gVGhlIHRhcmdldCBvYmplY3QgdG8gcHJveHlcbiAgICogQHBhcmFtIG9wdHMgLSBDb25maWd1cmF0aW9uIG9wdGlvbnNcbiAgICogQHBhcmFtIG9wdHMuZ2V0VmFsdWUgLSBDdXN0b20gZnVuY3Rpb24gdG8gZ2V0IHByb3BlcnR5IHZhbHVlXG4gICAqIEBwYXJhbSBvcHRzLmdldFBhcmVudCAtIEN1c3RvbSBmdW5jdGlvbiB0byBnZXQgcGFyZW50IG9iamVjdFxuICAgKiBAcGFyYW0gb3B0cy5pZ25vcmVVbmRlZmluZWQgLSBXaGV0aGVyIHRvIGlnbm9yZSB1bmRlZmluZWQgdmFsdWVzIGluIHBhdGhzXG4gICAqIEBwYXJhbSBvcHRzLmlnbm9yZU51bGwgLSBXaGV0aGVyIHRvIGlnbm9yZSBudWxsIHZhbHVlcyBpbiBwYXRoc1xuICAgKiBAcmV0dXJucyBBIHByb3h5IG9iamVjdCB3aXRoIHBhdGggYWNjZXNzIGNhcGFiaWxpdGllc1xuICAgKi9cbiAgc3RhdGljIGNyZWF0ZTxUIGV4dGVuZHMgb2JqZWN0PihcbiAgICByb290VGFyZ2V0OiBULFxuICAgIG9wdHM/OiB7XG4gICAgICBnZXRWYWx1ZT86ICh0YXJnZXQ6IFQsIHByb3A6IHN0cmluZykgPT4gYW55O1xuICAgICAgZ2V0UGFyZW50PzogKHRhcmdldDogVCkgPT4gYW55O1xuICAgICAgaWdub3JlVW5kZWZpbmVkOiBib29sZWFuO1xuICAgICAgaWdub3JlTnVsbDogYm9vbGVhbjtcbiAgICB9XG4gICk6IFBhdGhQcm94eTxUPiB7XG4gICAgY29uc3QgeyBnZXRWYWx1ZSwgZ2V0UGFyZW50LCBpZ25vcmVVbmRlZmluZWQsIGlnbm9yZU51bGwgfSA9IHtcbiAgICAgIGdldFBhcmVudDogZmFsbGJhY2tHZXRQYXJlbnQsXG4gICAgICBnZXRWYWx1ZTogZmFsbGJhY2tHZXRWYWx1ZSxcbiAgICAgIGlnbm9yZU51bGw6IGZhbHNlLFxuICAgICAgaWdub3JlVW5kZWZpbmVkOiBmYWxzZSxcbiAgICAgIC4uLm9wdHMsXG4gICAgfTtcblxuICAgIGNvbnN0IHByb3h5ID0gbmV3IFByb3h5KHt9IGFzIGFueSwge1xuICAgICAgZ2V0KHRhcmdldCwgcHJvcCkge1xuICAgICAgICBpZiAocHJvcCA9PT0gXCJnZXRWYWx1ZUZyb21QYXRoXCIpIHtcbiAgICAgICAgICByZXR1cm4gZnVuY3Rpb24gKHBhdGg6IHN0cmluZyk6IGFueSB7XG4gICAgICAgICAgICBjb25zdCBwYXJ0cyA9IFBhdGhQcm94eUVuZ2luZS5wYXJzZVBhdGgocGF0aCk7XG4gICAgICAgICAgICBsZXQgY3VycmVudDogYW55ID0gcm9vdFRhcmdldDtcblxuICAgICAgICAgICAgZm9yIChsZXQgaSA9IDA7IGkgPCBwYXJ0cy5sZW5ndGg7IGkrKykge1xuICAgICAgICAgICAgICBjb25zdCBwYXJ0ID0gcGFydHNbaV07XG4gICAgICAgICAgICAgIGlmIChwYXJ0ID09PSBcIi4uXCIpIHtcbiAgICAgICAgICAgICAgICBjb25zdCBwYXJlbnQgPSBnZXRQYXJlbnQoY3VycmVudCk7XG4gICAgICAgICAgICAgICAgaWYgKCFwYXJlbnQgfHwgdHlwZW9mIHBhcmVudCAhPT0gXCJvYmplY3RcIikge1xuICAgICAgICAgICAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICAgICAgICAgICBzZihcbiAgICAgICAgICAgICAgICAgICAgICBDT01QQVJJU09OX0VSUk9SX01FU1NBR0VTLkNPTlRFWFRfTk9UX09CSkVDVF9DT01QQVJJU09OLFxuICAgICAgICAgICAgICAgICAgICAgIGkgKyAxLFxuICAgICAgICAgICAgICAgICAgICAgIHBhdGhcbiAgICAgICAgICAgICAgICAgICAgKVxuICAgICAgICAgICAgICAgICAgKTtcbiAgICAgICAgICAgICAgICB9XG4gICAgICAgICAgICAgICAgY3VycmVudCA9IHBhcmVudDsgLy9QYXRoUHJveHlFbmdpbmUuY3JlYXRlKHBhcmVudFRhcmdldCwgb3B0cyk7XG4gICAgICAgICAgICAgICAgY29udGludWU7XG4gICAgICAgICAgICAgIH1cblxuICAgICAgICAgICAgICBjdXJyZW50ID0gZ2V0VmFsdWUoY3VycmVudCwgcGFydCk7XG4gICAgICAgICAgICAgIGlmICghaWdub3JlVW5kZWZpbmVkICYmIHR5cGVvZiBjdXJyZW50ID09PSBcInVuZGVmaW5lZFwiKVxuICAgICAgICAgICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgICAgICAgIHNmKENPTVBBUklTT05fRVJST1JfTUVTU0FHRVMuUFJPUEVSVFlfSU5WQUxJRCwgcGF0aCwgcGFydClcbiAgICAgICAgICAgICAgICApO1xuXG4gICAgICAgICAgICAgIGlmICghaWdub3JlTnVsbCAmJiBjdXJyZW50ID09PSBudWxsKVxuICAgICAgICAgICAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgICAgICAgICAgIHNmKENPTVBBUklTT05fRVJST1JfTUVTU0FHRVMuUFJPUEVSVFlfSU5WQUxJRCwgcGF0aCwgcGFydClcbiAgICAgICAgICAgICAgICApO1xuICAgICAgICAgICAgfVxuXG4gICAgICAgICAgICByZXR1cm4gY3VycmVudDtcbiAgICAgICAgICB9O1xuICAgICAgICB9XG5cbiAgICAgICAgcmV0dXJuIHRhcmdldFtwcm9wXTtcbiAgICAgIH0sXG4gICAgfSk7XG5cbiAgICAvLyBPYmplY3QuZGVmaW5lUHJvcGVydHkocHJveHksIFBST1hZX1BST1AsIHtcbiAgICAvLyAgIHZhbHVlOiB0cnVlLCAvLyBvdmVyd3JpdGUgYnkgcHJveHkgYmVoYXZpb3JcbiAgICAvLyAgIGVudW1lcmFibGU6IGZhbHNlLFxuICAgIC8vICAgY29uZmlndXJhYmxlOiBmYWxzZSxcbiAgICAvLyAgIHdyaXRhYmxlOiBmYWxzZSxcbiAgICAvLyB9KTtcblxuICAgIHJldHVybiBwcm94eSBhcyBQYXRoUHJveHk8VD47XG4gIH1cblxuICAvKipcbiAgICogUGFyc2VzIGEgcGF0aCBzdHJpbmcgaW50byBpbmRpdmlkdWFsIGNvbXBvbmVudHNcbiAgICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCBzdHJpbmcgdG8gcGFyc2UgKGUuZy4sIFwidXNlci5hZGRyZXNzLmNpdHlcIilcbiAgICogQHJldHVybnMgQW4gYXJyYXkgb2YgcGF0aCBjb21wb25lbnRzXG4gICAqIEB0aHJvd3MgRXJyb3IgaWYgdGhlIHBhdGggaXMgaW52YWxpZFxuICAgKi9cbiAgcHJpdmF0ZSBzdGF0aWMgcGFyc2VQYXRoKHBhdGg6IHN0cmluZyk6IHN0cmluZ1tdIHtcbiAgICBpZiAodHlwZW9mIHBhdGggIT09IFwic3RyaW5nXCIgfHwgIXBhdGgudHJpbSgpKVxuICAgICAgdGhyb3cgbmV3IEVycm9yKHNmKENPTVBBUklTT05fRVJST1JfTUVTU0FHRVMuSU5WQUxJRF9QQVRILCBwYXRoKSk7XG4gICAgcmV0dXJuIHBhdGgubWF0Y2goLyhcXC5cXC58W14vLl0rKS9nKSB8fCBbXTtcbiAgfVxufVxuIl19