@decaf-ts/decorator-validation 1.5.1 → 1.5.2

package/lib/utils/constants.d.ts

@@ -1,26 +0,0 @@
-/**
- * @summary Defines the various Model keys used for reflection
- *
- * @property {string} REFLECT prefix to all other keys
- * @property {string} TYPE type key
- * @property {string} PARAMS method params key
- * @property {string} RETURN method return key
- * @property {string} MODEL model key
- * @property {string} ANCHOR anchor key. will serve as a ghost property in the model
- *
- * @constant ModelKeys
- * @memberOf module:decorator-validation.Model
- * @category Model
- */
-export declare enum ModelKeys {
-    REFLECT = "decaf.model.",
-    TYPE = "design:type",
-    PARAMS = "design:paramtypes",
-    RETURN = "design:returntype",
-    MODEL = "model",
-    ANCHOR = "__model",
-    CONSTRUCTION = "constructed-by",
-    ATTRIBUTE = "__attributes",
-    HASHING = "hashing",
-    SERIALIZATION = "serialization"
-}

package/lib/utils/dates.cjs

@@ -1,251 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dateFromFormat = dateFromFormat;
-exports.bindDateToString = bindDateToString;
-exports.isValidDate = isValidDate;
-exports.twoDigitPad = twoDigitPad;
-exports.formatDate = formatDate;
-exports.parseDate = parseDate;
-require("reflect-metadata");
-const constants_1 = require("../validation/Validators/constants.cjs");
-const strings_1 = require("./strings.cjs");
-/**
- * @summary Reverses the process from {@link formatDate}
- *
- * @param {string} date the date string to be converted back into date
- * @param {string} format the date format
- * @return {Date} the date from the format or the standard new Date({@prop date}) if the string couldn't be parsed (are you sure the format matches the string?)
- *
- * @function dateFromFormat
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-function dateFromFormat(date, format) {
-    let formatRegexp = format;
-    // Hour
-    if (formatRegexp.match(/hh/))
-        formatRegexp = formatRegexp.replace("hh", "(?<hour>\\d{2})");
-    else if (formatRegexp.match(/h/))
-        formatRegexp = formatRegexp.replace("h", "(?<hour>\\d{1,2})");
-    else if (formatRegexp.match(/HH/))
-        formatRegexp = formatRegexp.replace("HH", "(?<hour>\\d{2})");
-    else if (formatRegexp.match(/H/))
-        formatRegexp = formatRegexp.replace("H", "(?<hour>\\d{1,2})");
-    // Minutes
-    if (formatRegexp.match(/mm/))
-        formatRegexp = formatRegexp.replace("mm", "(?<minutes>\\d{2})");
-    else if (formatRegexp.match(/m/))
-        formatRegexp = formatRegexp.replace("m", "(?<minutes>\\d{1,2})");
-    // Seconds
-    if (formatRegexp.match(/ss/))
-        formatRegexp = formatRegexp.replace("ss", "(?<seconds>\\d{2})");
-    else if (formatRegexp.match(/s/))
-        formatRegexp = formatRegexp.replace("s", "(?<seconds>\\d{1,2})");
-    // Day
-    if (formatRegexp.match(/dd/))
-        formatRegexp = formatRegexp.replace("dd", "(?<day>\\d{2})");
-    else if (formatRegexp.match(/d/))
-        formatRegexp = formatRegexp.replace("d", "(?<day>\\d{1,2})");
-    // Day Of Week
-    if (formatRegexp.match(/EEEE/))
-        formatRegexp = formatRegexp.replace("EEEE", "(?<dayofweek>\\w+)");
-    // eslint-disable-next-line no-dupe-else-if
-    else if (formatRegexp.match(/EEEE/))
-        formatRegexp = formatRegexp.replace("EEE", "(?<dayofweek>\\w+)");
-    // Year
-    if (formatRegexp.match(/yyyy/))
-        formatRegexp = formatRegexp.replace("yyyy", "(?<year>\\d{4})");
-    else if (formatRegexp.match(/yy/))
-        formatRegexp = formatRegexp.replace("yy", "(?<year>\\d{2})");
-    // Month
-    if (formatRegexp.match(/MMMM/))
-        formatRegexp = formatRegexp.replace("MMMM", "(?<monthname>\\w+)");
-    else if (formatRegexp.match(/MMM/))
-        formatRegexp = formatRegexp.replace("MMM", "(?<monthnamesmall>\\w+)");
-    if (formatRegexp.match(/MM/))
-        formatRegexp = formatRegexp.replace("MM", "(?<month>\\d{2})");
-    else if (formatRegexp.match(/M/))
-        formatRegexp = formatRegexp.replace("M", "(?<month>\\d{1,2})");
-    // Milis and Am Pm
-    formatRegexp = formatRegexp
-        .replace("S", "(?<milis>\\d{1,3})")
-        .replace("aaa", "(?<ampm>\\w{2})");
-    const regexp = new RegExp(formatRegexp, "g");
-    const match = regexp.exec(date);
-    if (!match || !match.groups)
-        return new Date(date);
-    const safeParseInt = function (n) {
-        if (!n)
-            return 0;
-        const result = parseInt(n);
-        return isNaN(result) ? 0 : result;
-    };
-    const year = safeParseInt(match.groups.year);
-    const day = safeParseInt(match.groups.day);
-    const amPm = match.groups.ampm;
-    let hour = safeParseInt(match.groups.hour);
-    if (amPm)
-        hour = amPm === "PM" ? hour + 12 : hour;
-    const minutes = safeParseInt(match.groups.minutes);
-    const seconds = safeParseInt(match.groups.seconds);
-    const ms = safeParseInt(match.groups.milis);
-    const monthName = match.groups.monthname;
-    const monthNameSmall = match.groups.monthnamesmall;
-    let month = match.groups.month;
-    if (monthName)
-        month = constants_1.MONTH_NAMES.indexOf(monthName);
-    else if (monthNameSmall) {
-        const m = constants_1.MONTH_NAMES.find((m) => m.toLowerCase().startsWith(monthNameSmall.toLowerCase()));
-        if (!m)
-            return new Date(date);
-        month = constants_1.MONTH_NAMES.indexOf(m);
-    }
-    else
-        month = safeParseInt(`${month}`);
-    return new Date(year, month - 1, day, hour, minutes, seconds, ms);
-}
-/**
- * @summary Binds a date format to a string
- * @param {Date} [date]
- * @param {string} [format]
- * @memberOf module:decorator-validation.Utils.Format
- * @category Utilities
- */
-function bindDateToString(date, format) {
-    if (!date)
-        return;
-    const func = () => formatDate(date, format);
-    Object.defineProperty(date, "toISOString", {
-        enumerable: false,
-        configurable: false,
-        value: func,
-    });
-    Object.defineProperty(date, "toString", {
-        enumerable: false,
-        configurable: false,
-        value: func,
-    });
-    // Object.setPrototypeOf(date, Date.prototype);
-    return date;
-}
-/**
- * @summary Helper function to be used instead of instanceOf Date
- * @param date
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Validation
- */
-function isValidDate(date) {
-    return (date &&
-        Object.prototype.toString.call(date) === "[object Date]" &&
-        !Number.isNaN(date));
-}
-/**
- * @summary Util function to pad numbers
- * @param {number} num
- *
- * @return {string}
- *
- * @function twoDigitPad
- * @memberOf module:decorator-validation.Utils.Format
- * @category Format
- */
-function twoDigitPad(num) {
-    return num < 10 ? "0" + num : num.toString();
-}
-/**
- * @summary Date Format Handling
- * @description Code from {@link https://stackoverflow.com/questions/3552461/how-to-format-a-javascript-date}
- *
- * <pre>
- *      Using similar formatting as Moment.js, Class DateTimeFormatter (Java), and Class SimpleDateFormat (Java),
- *      I implemented a comprehensive solution formatDate(date, patternStr) where the code is easy to read and modify.
- *      You can display date, time, AM/PM, etc.
- *
- *      Date and Time Patterns
- *      yy = 2-digit year; yyyy = full year
- *      M = digit month; MM = 2-digit month; MMM = short month name; MMMM = full month name
- *      EEEE = full weekday name; EEE = short weekday name
- *      d = digit day; dd = 2-digit day
- *      h = hours am/pm; hh = 2-digit hours am/pm; H = hours; HH = 2-digit hours
- *      m = minutes; mm = 2-digit minutes; aaa = AM/PM
- *      s = seconds; ss = 2-digit seconds
- *      S = miliseconds
- * </pre>
- *
- * @param {Date} date
- * @param {string} [patternStr] defaults to 'yyyy/MM/dd'
- * @return {string} the formatted date
- *
- * @function formatDate
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-function formatDate(date, patternStr = "yyyy/MM/dd") {
-    const day = date.getDate(), month = date.getMonth(), year = date.getFullYear(), hour = date.getHours(), minute = date.getMinutes(), second = date.getSeconds(), miliseconds = date.getMilliseconds(), h = hour % 12, hh = twoDigitPad(h), HH = twoDigitPad(hour), mm = twoDigitPad(minute), ss = twoDigitPad(second), aaa = hour < 12 ? "AM" : "PM", EEEE = constants_1.DAYS_OF_WEEK_NAMES[date.getDay()], EEE = EEEE.substr(0, 3), dd = twoDigitPad(day), M = month + 1, MM = twoDigitPad(M), MMMM = constants_1.MONTH_NAMES[month], MMM = MMMM.substr(0, 3), yyyy = year + "", yy = yyyy.substr(2, 2);
-    // checks to see if month name will be used
-    patternStr = patternStr
-        .replace("hh", hh)
-        .replace("h", h.toString())
-        .replace("HH", HH)
-        .replace("H", hour.toString())
-        .replace("mm", mm)
-        .replace("m", minute.toString())
-        .replace("ss", ss)
-        .replace("s", second.toString())
-        .replace("S", miliseconds.toString())
-        .replace("dd", dd)
-        .replace("d", day.toString())
-        .replace("EEEE", EEEE)
-        .replace("EEE", EEE)
-        .replace("yyyy", yyyy)
-        .replace("yy", yy)
-        .replace("aaa", aaa);
-    if (patternStr.indexOf("MMM") > -1) {
-        patternStr = patternStr.replace("MMMM", MMMM).replace("MMM", MMM);
-    }
-    else {
-        patternStr = patternStr.replace("MM", MM).replace("M", M.toString());
-    }
-    return patternStr;
-}
-/**
- * @summary Parses a date from a specified format
- * @param {string} format
- * @param {string | Date | number} [v]
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-function parseDate(format, v) {
-    let value = undefined;
-    if (!v)
-        return undefined;
-    if (v instanceof Date)
-        try {
-            value = dateFromFormat(formatDate(v, format), format);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        }
-        catch (e) {
-            throw new Error((0, strings_1.sf)("Could not convert date {0} to format: {1}", v.toString(), format));
-        }
-    else if (typeof v === "string") {
-        value = dateFromFormat(v, format);
-    }
-    else if (typeof v === "number") {
-        const d = new Date(v);
-        value = dateFromFormat(formatDate(d, format), format);
-    }
-    else if (isValidDate(v)) {
-        try {
-            const d = new Date(v);
-            value = dateFromFormat(formatDate(d, format), format);
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        }
-        catch (e) {
-            throw new Error((0, strings_1.sf)("Could not convert date {0} to format: {1}", v, format));
-        }
-    }
-    else {
-        throw new Error(`Invalid value provided ${v}`);
-    }
-    return bindDateToString(value, format);
-}

package/lib/utils/dates.d.ts

@@ -1,76 +0,0 @@
-import "reflect-metadata";
-/**
- * @summary Reverses the process from {@link formatDate}
- *
- * @param {string} date the date string to be converted back into date
- * @param {string} format the date format
- * @return {Date} the date from the format or the standard new Date({@prop date}) if the string couldn't be parsed (are you sure the format matches the string?)
- *
- * @function dateFromFormat
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-export declare function dateFromFormat(date: string, format: string): Date;
-/**
- * @summary Binds a date format to a string
- * @param {Date} [date]
- * @param {string} [format]
- * @memberOf module:decorator-validation.Utils.Format
- * @category Utilities
- */
-export declare function bindDateToString(date: Date | undefined, format: string): Date | undefined;
-/**
- * @summary Helper function to be used instead of instanceOf Date
- * @param date
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Validation
- */
-export declare function isValidDate(date: any): boolean;
-/**
- * @summary Util function to pad numbers
- * @param {number} num
- *
- * @return {string}
- *
- * @function twoDigitPad
- * @memberOf module:decorator-validation.Utils.Format
- * @category Format
- */
-export declare function twoDigitPad(num: number): string;
-/**
- * @summary Date Format Handling
- * @description Code from {@link https://stackoverflow.com/questions/3552461/how-to-format-a-javascript-date}
- *
- * <pre>
- *      Using similar formatting as Moment.js, Class DateTimeFormatter (Java), and Class SimpleDateFormat (Java),
- *      I implemented a comprehensive solution formatDate(date, patternStr) where the code is easy to read and modify.
- *      You can display date, time, AM/PM, etc.
- *
- *      Date and Time Patterns
- *      yy = 2-digit year; yyyy = full year
- *      M = digit month; MM = 2-digit month; MMM = short month name; MMMM = full month name
- *      EEEE = full weekday name; EEE = short weekday name
- *      d = digit day; dd = 2-digit day
- *      h = hours am/pm; hh = 2-digit hours am/pm; H = hours; HH = 2-digit hours
- *      m = minutes; mm = 2-digit minutes; aaa = AM/PM
- *      s = seconds; ss = 2-digit seconds
- *      S = miliseconds
- * </pre>
- *
- * @param {Date} date
- * @param {string} [patternStr] defaults to 'yyyy/MM/dd'
- * @return {string} the formatted date
- *
- * @function formatDate
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-export declare function formatDate(date: Date, patternStr?: string): string;
-/**
- * @summary Parses a date from a specified format
- * @param {string} format
- * @param {string | Date | number} [v]
- * @memberOf module:decorator-validation.Utils.Dates
- * @category Format
- */
-export declare function parseDate(format: string, v?: string | Date | number): Date | undefined;

package/lib/utils/decorators.cjs

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.prop = prop;
-exports.propMetadata = propMetadata;
-const reflection_1 = require("@decaf-ts/reflection");
-const constants_1 = require("./constants.cjs");
-function prop(key = constants_1.ModelKeys.ATTRIBUTE) {
-    return (model, propertyKey) => {
-        let props;
-        if (Object.prototype.hasOwnProperty.call(model, key)) {
-            props = model[key];
-        }
-        else {
-            props = model[key] = [];
-        }
-        if (!props.includes(propertyKey))
-            props.push(propertyKey);
-    };
-}
-function propMetadata(key, value) {
-    return (0, reflection_1.apply)(prop(), (0, reflection_1.metadata)(key, value));
-}

package/lib/utils/decorators.d.ts

@@ -1,2 +0,0 @@
-export declare function prop(key?: string): (model: object, propertyKey?: any) => void;
-export declare function propMetadata<V>(key: string, value: V): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor) => void;

package/lib/utils/hashing.cjs

@@ -1,106 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Hashing = exports.DefaultHashingMethod = void 0;
-exports.hashCode = hashCode;
-exports.hashSerialization = hashSerialization;
-exports.hashObj = hashObj;
-const serialization_1 = require("./serialization.cjs");
-/**
- * @summary Mimics Java's String's Hash implementation
- *
- * @param {string | number | symbol | Date} obj
- * @return {number} hash value of obj
- *
- * @function hashCode
- * @memberOf module:decorator-validation.Utils.Hashing
- * @category Hashing
- */
-function hashCode(obj) {
-    obj = String(obj);
-    let hash = 0;
-    for (let i = 0; i < obj.length; i++) {
-        const character = obj.charCodeAt(i);
-        hash = (hash << 5) - hash + character;
-        hash = hash & hash; // Convert to 32bit integer
-    }
-    return hash.toString();
-}
-/**
- * @summary Hashes an object serializing it and then hashing the string
- * @description The Serialization algorithm used by default (JSON.stringify)
- * is not deterministic and should not be used for hashing
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashSerialization
- * @memberOf module:decorator-validation.Utils.Hashing
- *
- * @category Hashing
- */
-function hashSerialization(obj) {
-    return hashCode(serialization_1.Serialization.serialize(obj));
-}
-/**
- * @summary Hashes an object by combining the hash of all its properties
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashObj
- * @memberOf module:decorator-validation.Utils.Hashing
- * @category Hashing
- */
-function hashObj(obj) {
-    const hashReducer = function (h, el) {
-        const elHash = hashFunction(el);
-        if (typeof elHash === "string")
-            return hashFunction((h || "") + hashFunction(el));
-        h = h || 0;
-        h = (h << 5) - h + elHash;
-        return h & h;
-    };
-    const func = hashCode;
-    const hashFunction = function (value) {
-        if (typeof value === "undefined")
-            return "";
-        if (["string", "number", "symbol"].indexOf(typeof value) !== -1)
-            return func(value.toString());
-        if (value instanceof Date)
-            return func(value.getTime());
-        if (Array.isArray(value))
-            return value.reduce(hashReducer, undefined);
-        return Object.values(value).reduce(hashReducer, undefined);
-    };
-    const result = Object.values(obj).reduce(hashReducer, 0);
-    return (typeof result === "number" ? Math.abs(result) : result).toString();
-}
-exports.DefaultHashingMethod = "default";
-class Hashing {
-    static { this.current = exports.DefaultHashingMethod; }
-    static { this.cache = {
-        default: hashObj,
-    }; }
-    constructor() { }
-    static get(key) {
-        if (key in this.cache)
-            return this.cache[key];
-        throw new Error(`No hashing method registered under ${key}`);
-    }
-    static register(key, func, setDefault = false) {
-        if (key in this.cache)
-            throw new Error(`Hashing method ${key} already registered`);
-        this.cache[key] = func;
-        if (setDefault)
-            this.current = key;
-    }
-    static hash(obj, method, ...args) {
-        if (!method)
-            return this.get(this.current)(obj, ...args);
-        return this.get(method)(obj, ...args);
-    }
-    static setDefault(method) {
-        this.current = this.get(method);
-    }
-}
-exports.Hashing = Hashing;

package/lib/utils/hashing.d.ts

@@ -1,52 +0,0 @@
-/**
- * @summary Mimics Java's String's Hash implementation
- *
- * @param {string | number | symbol | Date} obj
- * @return {number} hash value of obj
- *
- * @function hashCode
- * @memberOf module:decorator-validation.Utils.Hashing
- * @category Hashing
- */
-export declare function hashCode(obj: string | number | symbol | Date): string;
-/**
- * @summary Defines teh type for a Hashing function
- * @memberOf module:decorator-validation.Utils.Hashing
- * @category Hashing
- */
-export type HashingFunction = (value: any, ...args: any[]) => string;
-/**
- * @summary Hashes an object serializing it and then hashing the string
- * @description The Serialization algorithm used by default (JSON.stringify)
- * is not deterministic and should not be used for hashing
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashSerialization
- * @memberOf module:decorator-validation.Utils.Hashing
- *
- * @category Hashing
- */
-export declare function hashSerialization(obj: Record<string, any> | any[]): string;
-/**
- * @summary Hashes an object by combining the hash of all its properties
- *
- * @param {Record<string, any>} obj
- * @return {string} the resulting hash
- *
- * @function hashObj
- * @memberOf module:decorator-validation.Utils.Hashing
- * @category Hashing
- */
-export declare function hashObj(obj: Record<string, any> | any[]): string;
-export declare const DefaultHashingMethod = "default";
-export declare class Hashing {
-    private static current;
-    private static cache;
-    private constructor();
-    private static get;
-    static register(key: string, func: HashingFunction, setDefault?: boolean): void;
-    static hash(obj: any, method?: string, ...args: any[]): any;
-    static setDefault(method: string): void;
-}

package/lib/utils/index.cjs

@@ -1,23 +0,0 @@
-"use strict";
-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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./constants.cjs"), exports);
-__exportStar(require("./dates.cjs"), exports);
-__exportStar(require("./decorators.cjs"), exports);
-__exportStar(require("./hashing.cjs"), exports);
-__exportStar(require("./registry.cjs"), exports);
-__exportStar(require("./serialization.cjs"), exports);
-__exportStar(require("./strings.cjs"), exports);

package/lib/utils/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./constants";
-export * from "./dates";
-export * from "./decorators";
-export * from "./hashing";
-export * from "./registry";
-export * from "./serialization";
-export * from "./strings";

package/lib/utils/registry.cjs

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/registry.d.ts

@@ -1,68 +0,0 @@
-import { Constructor } from "../model/types";
-/**
- * @summary Basic interface for Registries
- *
- * @interface IRegistry
- *
- * @category Utilities
- */
-export interface IRegistry<T> {
-    /**
-     * @summary Registers an Object
-     *
-     * @param {T} obj
-     * @param {any[]} args
-     *
-     * @method
-     */
-    register(obj: T | any, ...args: any[]): void;
-    /**
-     * @summary Retrieves an Object if it can find it
-     *
-     * @param {any} key
-     * @param {any[]} args
-     * @return {T | undefined}
-     *
-     * @method
-     */
-    get(key: any, ...args: any[]): T | undefined;
-}
-/**
- * @summary Basic Builder Registry Interface
- *
- * @typedef T
- * @interface BuilderRegistry<T>
- *
- * @category Construction
- */
-export interface BuilderRegistry<T> extends IRegistry<Constructor<T>> {
-    /**
-     * @summary Retrieves an Builder Object by name if it can
-     *
-     * @param {string} name
-     * @param {any[]} args
-     *
-     * @method
-     */
-    get(name: string, ...args: any[]): Constructor<T> | undefined;
-    /**
-     * @summary Registers a constructor by name
-     *
-     * @param {Constructor<T>} [constructor]
-     * @param {name} name
-     * @param {any[]} args
-     *
-     * @method
-     */
-    register(constructor: Constructor<T>, name?: string, ...args: any[]): void;
-    /**
-     * @summary Builds an Object by name
-     *
-     * @param {{}} obj
-     * @param {any[]} args
-     * @return T
-     *
-     * @method
-     */
-    build(obj: Record<string, any> | T, ...args: any[]): T;
-}