@tstdl/base 0.71.87 → 0.78.0-beta1

package/schema/types.d.ts

@@ -1,30 +1,150 @@
-import type { Simplify, TypedOmit } from "../types";
-import type { SchemaValidator } from './schema.validator';
-declare const schemaTypes: unique symbol;
-export declare type SchemaDefinition<Type extends string = string, Input = unknown, Output = unknown> = {
-    type: Type;
-    [schemaTypes]?: {
-        input: Input;
-        output: Output;
+import type { JsonPath } from "../json-path/json-path";
+import type { OneOrMany, Record, Type } from "../types";
+import type { Schema } from './schema';
+import type { SchemaError } from './schema.error';
+declare const schemaTypeSymbol: unique symbol;
+export declare type SchemaFactoryFunction<T extends Record> = (data: T) => T;
+export declare type SchemaFactory<T extends Record> = {
+    type: Type<T, []>;
+    builder?: undefined;
+} | {
+    type?: undefined;
+    builder: SchemaFactoryFunction<T>;
+};
+export declare type ObjectSchemaProperties<T extends Record> = {
+    [K in keyof T]-?: MaybeDeferredValueTypes<T[K]>;
+};
+export declare type SchemaOutput<T extends Schema | Type> = T extends ObjectSchema<infer U> ? U : T extends ValueSchema<infer U> ? U : T extends Type<infer U> ? U : never;
+export declare type ObjectSchema<T extends Record = any> = {
+    factory?: SchemaFactory<T>;
+    properties: ObjectSchemaProperties<T>;
+    mask?: boolean;
+    allowUnknownProperties?: MaybeDeferredValueTypes;
+};
+export declare type ValueSchema<T = any> = {
+    [schemaTypeSymbol]?: T;
+    type: MaybeDeferredValueTypes;
+    array?: boolean;
+    optional?: boolean;
+    nullable?: boolean;
+    /** use default coercers */
+    coerce?: boolean;
+    /** custom coercers */
+    coercers?: OneOrMany<SchemaValueCoercer>;
+    transformers?: OneOrMany<SchemaValueTransformer>;
+    arrayConstraints?: OneOrMany<SchemaArrayConstraint>;
+    valueConstraints?: OneOrMany<SchemaValueConstraint>;
+};
+export declare type NormalizedObjectSchema<T extends Record = any> = {
+    factory?: SchemaFactory<T>;
+    properties: {
+        [K in keyof T]: Schema<T[K]>;
     };
+    mask?: boolean;
+    allowUnknownProperties: Set<Schema>;
+};
+export declare type NormalizedValueSchema<T = any> = {
+    type: Set<ValueType<T>>;
+    array: boolean;
+    optional: boolean;
+    nullable: boolean;
+    coerce: boolean;
+    coercers: Map<ValueType, SchemaValueCoercer[]>;
+    transformers: readonly SchemaValueTransformer[];
+    arrayConstraints: readonly SchemaArrayConstraint[];
+    valueConstraints: readonly SchemaValueConstraint[];
+};
+export declare type SchemaContext = {
+    schema: NormalizedValueSchema;
+    options: SchemaTestOptions;
 };
-export declare type Schema<T> = SchemaValidator<SchemaDefinition<string, unknown, T>>;
-export declare type SchemaOptions<T extends SchemaDefinition, K extends keyof T = never> = Simplify<Partial<TypedOmit<T, keyof SchemaDefinition | K>>>;
-export declare type SchemaInput<T extends SchemaDefinition | SchemaValidator> = T extends SchemaDefinition<string, infer I, any> ? I : T extends SchemaValidator ? T['inputType'] : never;
-export declare type SchemaOutput<T extends SchemaDefinition | SchemaValidator> = T extends SchemaDefinition<string, any, infer O> ? O : T extends SchemaValidator ? T['outputType'] : never;
+export declare type ConstraintContext = SchemaContext;
+export declare type TransformerContext = SchemaContext;
+export declare type CoercerContext = SchemaContext;
+export declare type ValueType<T = any> = Schema<T> | Type<T> | typeof BigInt | typeof Symbol | typeof Function | 'undefined' | 'null' | 'any';
+export declare type DeferredValueType<T> = {
+    deferred: () => ValueType<T>;
+};
+export declare type MaybeDeferredValueType<T = any> = ValueType<T> | DeferredValueType<T>;
+export declare type ValueTypes<T = any> = OneOrMany<ValueType<T>>;
+export declare type DeferredValueTypes<T = any> = {
+    deferred: () => ValueTypes<T>;
+};
+export declare type MaybeDeferredValueTypes<T = any> = OneOrMany<ValueTypes<T> | DeferredValueTypes<T>> | MaybeDeferredValueTypes<T>[];
 export declare type Coercible = {
+    coerce?: boolean;
+};
+export declare const primitiveValueTypes: ValueType[];
+export declare const primitiveValueTypesSet: Set<ValueType<any>>;
+export declare abstract class SchemaArrayConstraint {
+    abstract validate(value: readonly unknown[], path: JsonPath, context: ConstraintContext): ConstraintResult;
+}
+export declare type OptionKeys<T extends Record> = readonly (keyof T)[];
+export declare abstract class SchemaValueConstraint {
+    abstract readonly suitableTypes: ValueTypes;
+    abstract readonly expects: OneOrMany<string>;
+    abstract validate(value: unknown, path: JsonPath, context: ConstraintContext): ConstraintResult;
+}
+export declare abstract class SchemaValueTransformer {
+    abstract readonly sourceType: ValueTypes;
+    abstract readonly targetType: ValueType;
+    abstract transform(value: unknown, path: JsonPath, context: TransformerContext): TransformResult;
+}
+export declare abstract class SchemaValueCoercer {
+    abstract readonly sourceType: ValueTypes;
+    abstract readonly targetType: ValueType;
+    abstract coerce(value: unknown, path: JsonPath, context: CoercerContext): CoerceResult;
+}
+export declare type SchemaTestOptions = {
     /**
      * try to convert wrong input into desired output.
      * Can be specified on definition and validation. If specified on both, definition has higher priority
      */
     coerce?: boolean;
-};
-export declare type Maskable = {
     /**
      * remove unspecified fields on input data instead of raising an error.
      * Can be specified on definition and validation. If specified on both, definition has higher priority
      */
     mask?: boolean;
 };
-export declare function schemaHelper<T extends SchemaDefinition>(schema: TypedOmit<T, typeof schemaTypes>): T;
+export declare type SchemaTestResult<T> = {
+    success: true;
+    value: T;
+    error?: undefined;
+} | {
+    success: false;
+    value?: undefined;
+    error: SchemaError;
+};
+export declare type ConstraintResult = {
+    success: true;
+    error?: undefined;
+} | {
+    success: false;
+    error: SchemaError;
+};
+export declare type CoerceResult = {
+    success: true;
+    value: any;
+    error?: undefined;
+} | {
+    success: false;
+    value?: undefined;
+    error: SchemaError;
+};
+export declare type TransformResult = {
+    success: true;
+    value: any;
+    error?: undefined;
+} | {
+    success: false;
+    value?: undefined;
+    error: SchemaError;
+};
+export declare function objectSchema<T extends ObjectSchema>(schema: T): T;
+export declare function valueSchema<T extends ValueSchema>(schema: T): T;
+export declare function isSchema<T>(value: ValueType<T>): value is Schema<T>;
+export declare function isObjectSchema<T>(value: ValueType<T>): value is ObjectSchema<T>;
+export declare function isValueSchema<T>(value: ValueType<T>): value is ValueSchema<T>;
+export declare function isDeferredValueType<T>(value: MaybeDeferredValueTypes<T>): value is (DeferredValueType<T> | DeferredValueTypes<T>);
 export {};

package/schema/types.js

@@ -1,8 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.schemaHelper = void 0;
-function schemaHelper(schema) {
+exports.isDeferredValueType = exports.isValueSchema = exports.isObjectSchema = exports.isSchema = exports.valueSchema = exports.objectSchema = exports.SchemaValueCoercer = exports.SchemaValueTransformer = exports.SchemaValueConstraint = exports.SchemaArrayConstraint = exports.primitiveValueTypesSet = exports.primitiveValueTypes = void 0;
+const object_1 = require("../utils/object/object");
+const type_guards_1 = require("../utils/type-guards");
+exports.primitiveValueTypes = [String, Number, Boolean, BigInt, Symbol, Function, 'undefined', 'null', 'any'];
+exports.primitiveValueTypesSet = new Set(exports.primitiveValueTypes);
+class SchemaArrayConstraint {
+}
+exports.SchemaArrayConstraint = SchemaArrayConstraint;
+class SchemaValueConstraint {
+}
+exports.SchemaValueConstraint = SchemaValueConstraint;
+class SchemaValueTransformer {
+}
+exports.SchemaValueTransformer = SchemaValueTransformer;
+class SchemaValueCoercer {
+}
+exports.SchemaValueCoercer = SchemaValueCoercer;
+function objectSchema(schema) {
+    return schema;
+}
+exports.objectSchema = objectSchema;
+function valueSchema(schema) {
     return schema;
 }
-exports.schemaHelper = schemaHelper;
+exports.valueSchema = valueSchema;
+function isSchema(value) {
+    return isObjectSchema(value) || isValueSchema(value);
+}
+exports.isSchema = isSchema;
+function isObjectSchema(value) {
+    return (0, type_guards_1.isObject)(value?.properties);
+}
+exports.isObjectSchema = isObjectSchema;
+function isValueSchema(value) {
+    return (0, type_guards_1.isObject)(value) && (0, type_guards_1.isDefined)(value?.type);
+}
+exports.isValueSchema = isValueSchema;
+function isDeferredValueType(value) {
+    return (0, type_guards_1.isObject)(value) && (0, object_1.hasOwnProperty)(value, 'deferred');
+}
+exports.isDeferredValueType = isDeferredValueType;
 //# sourceMappingURL=types.js.map

package/schema/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../source/schema/types.ts"],"names":[],"mappings":";;;AAwCA,SAAgB,YAAY,CAA6B,MAAwC;IAC/F,OAAO,MAAW,CAAC;AACrB,CAAC;AAFD,oCAEC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../source/schema/types.ts"],"names":[],"mappings":";;;AAEA,mDAAuD;AACvD,sDAA0D;AAuF7C,QAAA,mBAAmB,GAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACnH,QAAA,sBAAsB,GAAG,IAAI,GAAG,CAAC,2BAAmB,CAAC,CAAC;AAEnE,MAAsB,qBAAqB;CAE1C;AAFD,sDAEC;AAID,MAAsB,qBAAqB;CAK1C;AALD,sDAKC;AAED,MAAsB,sBAAsB;CAK3C;AALD,wDAKC;AAED,MAAsB,kBAAkB;CAKvC;AALD,gDAKC;AAgCD,SAAgB,YAAY,CAAyB,MAAS;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAFD,oCAEC;AAED,SAAgB,WAAW,CAAwB,MAAS;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAFD,kCAEC;AAED,SAAgB,QAAQ,CAAI,KAAmB;IAC7C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAFD,4BAEC;AAED,SAAgB,cAAc,CAAI,KAAmB;IACnD,OAAO,IAAA,sBAAQ,EAAE,KAA2C,EAAE,UAAU,CAAC,CAAC;AAC5E,CAAC;AAFD,wCAEC;AAED,SAAgB,aAAa,CAAI,KAAmB;IAClD,OAAO,IAAA,sBAAQ,EAAC,KAAK,CAAC,IAAI,IAAA,uBAAS,EAAE,KAA0C,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC;AAFD,sCAEC;AAED,SAAgB,mBAAmB,CAAI,KAAiC;IACtE,OAAO,IAAA,sBAAQ,EAAC,KAAK,CAAC,IAAI,IAAA,uBAAc,EAAE,KAA4B,EAAE,UAAU,CAAC,CAAC;AACtF,CAAC;AAFD,kDAEC"}

package/schema/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './value-type';

package/{old-api/validation → schema/utils}/index.js

@@ -14,5 +14,6 @@ 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("./types"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./value-type"), exports);
 //# sourceMappingURL=index.js.map

package/schema/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/schema/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B"}

package/schema/utils/schema.d.ts

@@ -0,0 +1,12 @@
+import type { Schema } from '../schema';
+import type { MaybeDeferredValueTypes, NormalizedObjectSchema, NormalizedValueSchema, ObjectSchema, ValueSchema, ValueTypes } from '../types';
+export declare const normalizeSchema: typeof _normalizeObjectSchema;
+export declare const normalizeValueSchema: typeof _normalizeValueSchema;
+export declare const getArrayItemSchema: typeof _getArrayItemSchema;
+export declare function _normalizeObjectSchema<T>(objectSchema: ObjectSchema<T>): NormalizedObjectSchema<T>;
+export declare function _normalizeValueSchema<T>(valueSchema: ValueSchema<T>): NormalizedValueSchema<T>;
+declare function _getArrayItemSchema<T>(valueSchema: ValueSchema<T>): ValueSchema<T>;
+export declare function maybeDeferredValueTypesToValueTypes<T>(valueTypes: MaybeDeferredValueTypes<T>): ValueTypes<T>;
+export declare function valueTypesToSchema<T>(valueType: ValueTypes<T>): Schema<T>;
+export declare function maybeDeferredValueTypesToSchema<T>(valueType: MaybeDeferredValueTypes<T>): Schema<T>;
+export {};

package/schema/utils/schema.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maybeDeferredValueTypesToSchema = exports.valueTypesToSchema = exports.maybeDeferredValueTypesToValueTypes = exports._normalizeValueSchema = exports._normalizeObjectSchema = exports.getArrayItemSchema = exports.normalizeValueSchema = exports.normalizeSchema = void 0;
+const array_1 = require("../../utils/array/array");
+const memoize_1 = require("../../utils/function/memoize");
+const object_1 = require("../../utils/object/object");
+const type_guards_1 = require("../../utils/type-guards");
+const types_1 = require("../types");
+exports.normalizeSchema = (0, memoize_1.memoizeSingle)(_normalizeObjectSchema, { weak: true });
+exports.normalizeValueSchema = (0, memoize_1.memoizeSingle)(_normalizeValueSchema, { weak: true });
+exports.getArrayItemSchema = (0, memoize_1.memoizeSingle)(_getArrayItemSchema, { weak: true });
+function _normalizeObjectSchema(objectSchema) {
+    const normalizedObjectSchema = {
+        factory: objectSchema.factory,
+        properties: (0, object_1.mapObjectValues)(objectSchema.properties, maybeDeferredValueTypesToSchema),
+        mask: objectSchema.mask,
+        allowUnknownProperties: new Set((0, array_1.toArray)(objectSchema.allowUnknownProperties ?? []).map(maybeDeferredValueTypesToSchema))
+    };
+    return normalizedObjectSchema;
+}
+exports._normalizeObjectSchema = _normalizeObjectSchema;
+function _normalizeValueSchema(valueSchema) {
+    const valueTypes = maybeDeferredValueTypesToValueTypes(valueSchema.type);
+    const normalizedValueSchema = {
+        type: new Set((0, array_1.toArray)(valueTypes)),
+        array: valueSchema.array ?? false,
+        optional: valueSchema.optional ?? false,
+        nullable: valueSchema.nullable ?? false,
+        coerce: valueSchema.coerce ?? false,
+        coercers: new Map(),
+        transformers: (0, array_1.toArray)(valueSchema.transformers ?? []),
+        arrayConstraints: (0, array_1.toArray)(valueSchema.arrayConstraints ?? []),
+        valueConstraints: (0, array_1.toArray)(valueSchema.valueConstraints ?? [])
+    };
+    for (const coercer of (0, array_1.toArray)(valueSchema.coercers ?? [])) {
+        for (const sourceType of (0, array_1.toArray)(coercer.sourceType)) {
+            if (!normalizedValueSchema.coercers.has(sourceType)) {
+                normalizedValueSchema.coercers.set(sourceType, []);
+            }
+            normalizedValueSchema.coercers.get(sourceType).push(coercer);
+        }
+    }
+    return normalizedValueSchema;
+}
+exports._normalizeValueSchema = _normalizeValueSchema;
+function _getArrayItemSchema(valueSchema) {
+    const itemSchema = {
+        type: valueSchema.type,
+        array: false,
+        optional: false,
+        nullable: false,
+        transformers: valueSchema.transformers,
+        valueConstraints: valueSchema.valueConstraints
+    };
+    return itemSchema;
+}
+function maybeDeferredValueTypesToValueTypes(valueTypes) {
+    if ((0, type_guards_1.isArray)(valueTypes)) {
+        return valueTypes.flatMap((valueType) => maybeDeferredValueTypesToValueTypes(valueType));
+    }
+    return (0, types_1.isDeferredValueType)(valueTypes)
+        ? valueTypes.deferred()
+        : valueTypes;
+}
+exports.maybeDeferredValueTypesToValueTypes = maybeDeferredValueTypesToValueTypes;
+function valueTypesToSchema(valueType) {
+    if ((0, type_guards_1.isFunction)(valueType) || (0, type_guards_1.isArray)(valueType) || (0, type_guards_1.isString)(valueType)) {
+        return { type: valueType };
+    }
+    return valueType;
+}
+exports.valueTypesToSchema = valueTypesToSchema;
+function maybeDeferredValueTypesToSchema(valueType) {
+    const deferredValueTypes = maybeDeferredValueTypesToValueTypes(valueType);
+    return valueTypesToSchema(deferredValueTypes);
+}
+exports.maybeDeferredValueTypesToSchema = maybeDeferredValueTypesToSchema;
+//# sourceMappingURL=schema.js.map

package/schema/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../source/schema/utils/schema.ts"],"names":[],"mappings":"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"}

package/schema/utils/value-type.d.ts

@@ -0,0 +1,4 @@
+import type { ValueType } from '../types';
+export declare function getValueType(value: unknown): ValueType;
+export declare function getValueTypeName(valueType: ValueType): string;
+export declare function valueTypeHasValueType(valueType: ValueType, typeToCheck: ValueType): boolean;

package/schema/utils/value-type.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.valueTypeHasValueType = exports.getValueTypeName = exports.getValueType = void 0;
+const type_guards_1 = require("../../utils/type-guards");
+const types_1 = require("../types");
+const schema_1 = require("./schema");
+function getValueType(value) {
+    if ((0, type_guards_1.isUndefined)(value)) {
+        return 'undefined';
+    }
+    if ((0, type_guards_1.isNull)(value)) {
+        return 'null';
+    }
+    return value.constructor;
+}
+exports.getValueType = getValueType;
+function getValueTypeName(valueType) {
+    return (0, type_guards_1.isString)(valueType) ? valueType : (0, type_guards_1.isFunction)(valueType) ? valueType.name : 'object';
+}
+exports.getValueTypeName = getValueTypeName;
+function valueTypeHasValueType(valueType, typeToCheck) {
+    if ((0, types_1.isValueSchema)(valueType)) {
+        const resolvedValueTypes = (0, schema_1.maybeDeferredValueTypesToValueTypes)(valueType.type);
+        if ((0, type_guards_1.isArray)(resolvedValueTypes)) {
+            return resolvedValueTypes.some((innerType) => valueTypeHasValueType(innerType, typeToCheck));
+        }
+        return valueTypeHasValueType(resolvedValueTypes, typeToCheck);
+    }
+    if ((0, types_1.isObjectSchema)(valueType)) {
+        return false;
+    }
+    return valueType == typeToCheck;
+}
+exports.valueTypeHasValueType = valueTypeHasValueType;
+//# sourceMappingURL=value-type.js.map

package/schema/utils/value-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-type.js","sourceRoot":"","sources":["../../../source/schema/utils/value-type.ts"],"names":[],"mappings":";;;AACA,yDAAyF;AAEzF,oCAAyD;AACzD,qCAA+D;AAE/D,SAAgB,YAAY,CAAC,KAAc;IACzC,IAAI,IAAA,yBAAW,EAAC,KAAK,CAAC,EAAE;QACtB,OAAO,WAAW,CAAC;KACpB;IAED,IAAI,IAAA,oBAAM,EAAC,KAAK,CAAC,EAAE;QACjB,OAAO,MAAM,CAAC;KACf;IAED,OAAQ,KAAgB,CAAC,WAAmB,CAAC;AAC/C,CAAC;AAVD,oCAUC;AAED,SAAgB,gBAAgB,CAAC,SAAoB;IACnD,OAAO,IAAA,sBAAQ,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,wBAAU,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7F,CAAC;AAFD,4CAEC;AAED,SAAgB,qBAAqB,CAAC,SAAoB,EAAE,WAAsB;IAChF,IAAI,IAAA,qBAAa,EAAC,SAAS,CAAC,EAAE;QAC5B,MAAM,kBAAkB,GAAG,IAAA,4CAAmC,EAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE/E,IAAI,IAAA,qBAAO,EAAC,kBAAkB,CAAC,EAAE;YAC/B,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;SAC9F;QAED,OAAO,qBAAqB,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;KAC/D;IAED,IAAI,IAAA,sBAAc,EAAC,SAAS,CAAC,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,OAAO,SAAS,IAAI,WAAW,CAAC;AAClC,CAAC;AAhBD,sDAgBC"}

package/templates/providers/file-template.provider.base.d.ts

@@ -1,4 +1,4 @@
-import type { Schema } from "../../schema";
+import { Schema } from "../../schema";
 import type { TypedOmit } from "../../types";
 import type { Template } from '../template.model';
 export declare type FileTemplateBase = TypedOmit<Template, 'template'>;

package/templates/providers/file-template.provider.base.js

@@ -2,10 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileTemplateProviderBase = void 0;
 const bad_request_error_1 = require("../../error/bad-request.error");
+const schema_1 = require("../../schema");
 const type_guards_1 = require("../../utils/type-guards");
 const fs = require("fs/promises");
 const path = require("path");
-const keyPattern = /^[\w\-\/]+$/u;
+const keyPattern = /^[\w\-/]+$/u;
 class FileTemplateProviderBase {
     constructor(schema, basePath, fileForwards) {
         this.schema = schema;
@@ -19,7 +20,7 @@ class FileTemplateProviderBase {
         const filePath = path.resolve(this.basePath, `${key}.js`);
         const templateModule = await Promise.resolve().then(() => require(filePath));
         const fileContent = templateModule.default;
-        const fileTemplate = this.schema.parse(fileContent);
+        const fileTemplate = schema_1.Schema.parse(this.schema, fileContent);
         const result = {};
         const entries = Object.entries(fileTemplate);
         for (const [property, value] of entries) {

package/templates/providers/file-template.provider.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-template.provider.base.js","sourceRoot":"","sources":["../../../source/templates/providers/file-template.provider.base.ts"],"names":[],"mappings":";;;AAAA,qEAA4D;AAG5D,yDAAkE;AAClE,kCAAkC;AAClC,6BAA6B;AAO7B,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC,MAAa,wBAAwB;IAKnC,YAAY,MAAiB,EAAE,QAAgB,EAAE,YAAiC;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACzB,MAAM,IAAI,mCAAe,CAAC,gEAAgE,CAAC,CAAC;SAC7F;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,2CAAa,QAAQ,EAAyB,CAAC;QACtE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAW,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAyB,CAAC;QAErE,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACpC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;aAC1B;SACF;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE;YACpD,IAAI,IAAA,uBAAS,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE;gBAChC,IAAI,IAAA,uBAAS,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE;oBACpC,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;iBAC7F;gBAED,SAAS;aACV;YAED,IAAI,IAAA,uBAAS,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE;gBACpC,MAAM,eAAe,GAAG,IAAA,8BAAgB,EAAC,YAAY,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC,CAAC;gBAC/F,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEtG,MAAM,CAAC,SAAS,CAAC,GAAG,OAAc,CAAC;gBACnC,SAAS;aACV;YAED,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;SAC7F;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApDD,4DAoDC"}
+{"version":3,"file":"file-template.provider.base.js","sourceRoot":"","sources":["../../../source/templates/providers/file-template.provider.base.ts"],"names":[],"mappings":";;;AAAA,qEAA4D;AAC5D,yCAAkC;AAElC,yDAAkE;AAClE,kCAAkC;AAClC,6BAA6B;AAO7B,MAAM,UAAU,GAAG,aAAa,CAAC;AAEjC,MAAa,wBAAwB;IAKnC,YAAY,MAAiB,EAAE,QAAgB,EAAE,YAAiC;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACzB,MAAM,IAAI,mCAAe,CAAC,gEAAgE,CAAC,CAAC;SAC7F;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,2CAAa,QAAQ,EAAyB,CAAC;QACtE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC;QAC3C,MAAM,YAAY,GAAG,eAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAW,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAyB,CAAC;QAErE,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACpC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;aAC1B;SACF;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE;YACpD,IAAI,IAAA,uBAAS,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE;gBAChC,IAAI,IAAA,uBAAS,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE;oBACpC,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;iBAC7F;gBAED,SAAS;aACV;YAED,IAAI,IAAA,uBAAS,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE;gBACpC,MAAM,eAAe,GAAG,IAAA,8BAAgB,EAAC,YAAY,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC,CAAC;gBAC/F,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEtG,MAAM,CAAC,SAAS,CAAC,GAAG,OAAc,CAAC;gBACnC,SAAS;aACV;YAED,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;SAC7F;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApDD,4DAoDC"}

package/types.d.ts

@@ -37,7 +37,8 @@ export declare type UndefinableJsonObject = {
 export declare type UndefinableJsonArray = UndefinableJsonInnerNode[];
 export declare type Enumeration = EnumerationArray | EnumerationObject;
 export declare type EnumerationArray = readonly [string | number, ...(string | number)[]];
-export declare type EnumerationObject = StringMap<string | number>;
+export declare type EnumerationObject = Record<string, string | number>;
+export declare type EnumerationValue<T extends Enumeration = Enumeration> = T extends EnumerationArray ? T[number] : T[Extract<keyof T, string>];
 export declare type Type<T = any, Arguments extends any[] = any> = Constructor<T, Arguments> & {
     prototype: T;
 };
@@ -94,6 +95,9 @@ export declare type Simplify<T> = T extends (Primitive | Function | Date | RegEx
 export declare type SimplifyObject<T extends Record> = {
     [K in keyof T]: T[K];
 } & {};
+export declare type UndefinableObject<T extends Record> = {
+    [K in keyof T]: T[K] | undefined;
+};
 /**
  * pick properties from a type that extend from a specific type.
  */

package/utils/clone.d.ts

@@ -0,0 +1 @@
+export declare function clone<T>(object: T, deep: boolean): T;

package/utils/clone.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clone = void 0;
+const object_1 = require("./object/object");
+const type_guards_1 = require("./type-guards");
+function clone(object, deep) {
+    if ((0, type_guards_1.isPrimitive)(object)) {
+        return object;
+    }
+    if ((0, type_guards_1.isDate)(object)) {
+        return new Date(object);
+    }
+    if ((0, type_guards_1.isRegExp)(object)) {
+        return new RegExp(object.source, object.flags);
+    }
+    if ((0, type_guards_1.isSet)(object)) {
+        return new Set(object);
+    }
+    if ((0, type_guards_1.isMap)(object)) {
+        return new Map(object);
+    }
+    if ((0, type_guards_1.isArrayBuffer)(object)) {
+        return object.slice(0);
+    }
+    if ((0, type_guards_1.isTypedArray)(object)) {
+        return object.slice();
+    }
+    if ((0, type_guards_1.isDataView)(object)) {
+        const clonedBuffer = object.buffer.slice(0);
+        return new DataView(clonedBuffer, object.byteOffset, object.byteLength);
+    }
+    if ((0, type_guards_1.isArray)(object)) {
+        return deep
+            ? object.map((value) => clone(value, true))
+            : [...object];
+    }
+    (0, type_guards_1.assertObject)(object);
+    if (!deep) {
+        return { ...object };
+    }
+    const entries = (0, object_1.objectEntries)(object).map(([key, value]) => [key, clone(value, true)]);
+    return Object.fromEntries(entries);
+}
+exports.clone = clone;
+//# sourceMappingURL=clone.js.map

package/utils/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../source/utils/clone.ts"],"names":[],"mappings":";;;AAAA,4CAAgD;AAChD,+CAA4I;AAE5I,SAAgB,KAAK,CAAI,MAAS,EAAE,IAAa;IAC/C,IAAI,IAAA,yBAAW,EAAC,MAAM,CAAC,EAAE;QACvB,OAAO,MAAM,CAAC;KACf;IAED,IAAI,IAAA,oBAAM,EAAC,MAAM,CAAC,EAAE;QAClB,OAAO,IAAI,IAAI,CAAC,MAAM,CAAiB,CAAC;KACzC;IAED,IAAI,IAAA,sBAAQ,EAAC,MAAM,CAAC,EAAE;QACpB,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAiB,CAAC;KAChE;IAED,IAAI,IAAA,mBAAK,EAAC,MAAM,CAAC,EAAE;QACjB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAiB,CAAC;KACxC;IAED,IAAI,IAAA,mBAAK,EAAC,MAAM,CAAC,EAAE;QACjB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAiB,CAAC;KACxC;IAED,IAAI,IAAA,2BAAa,EAAC,MAAM,CAAC,EAAE;QACzB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAiB,CAAC;KACxC;IAED,IAAI,IAAA,0BAAY,EAAC,MAAM,CAAC,EAAE;QACxB,OAAO,MAAM,CAAC,KAAK,EAAkB,CAAC;KACvC;IAED,IAAI,IAAA,wBAAU,EAAC,MAAM,CAAC,EAAE;QACtB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAiB,CAAC;KACzF;IAED,IAAI,IAAA,qBAAO,EAAC,MAAM,CAAC,EAAE;QACnB,OAAO,IAAI;YACT,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAO,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAa;YAC5D,CAAC,CAAC,CAAC,GAAG,MAAM,CAAiB,CAAC;KACjC;IAED,IAAA,0BAAY,EAAC,MAAM,CAAC,CAAC;IAErB,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,GAAG,MAAM,EAAO,CAAC;KAC3B;IAED,MAAM,OAAO,GAAG,IAAA,sBAAa,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAU,CAAC,CAAC;IAChG,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAiB,CAAC;AACrD,CAAC;AAhDD,sBAgDC"}

package/utils/enum.d.ts

@@ -1,7 +1,7 @@
 import type { EnumerationObject, Simplify } from "../types";
 export declare type EnumEntry<T> = [EnumKey<T>, EnumValue<T>];
 export declare type EnumKey<T> = Extract<keyof T, string>;
-export declare type EnumValue<T> = Simplify<T[Extract<keyof T, string>]>;
+export declare type EnumValue<T> = Simplify<T[EnumKey<T>]>;
 export declare function enumEntries<T extends EnumerationObject>(enumeration: T): EnumEntry<T>[];
 export declare function enumKeys<T extends EnumerationObject>(enumeration: T): EnumKey<T>[];
 export declare function enumValues<T extends EnumerationObject>(enumeration: T): EnumValue<T>[];

package/utils/format-error.d.ts

@@ -0,0 +1,20 @@
+import type { UndefinableJson } from "../types";
+export declare type FormatErrorOptions = {
+    /**
+     * include all error properties beside name and message
+     */
+    includeRest?: boolean | 'if-no-extra-info';
+    /**
+     * include extraInfo from errors implementing {@link ErrorExtraInfo}
+     */
+    includeExtraInfo?: boolean;
+    /**
+     * include stack trace
+     */
+    includeStack?: boolean;
+};
+export interface ErrorExtraInfo {
+    /** format extra data (without message and stack) as JSON */
+    getExtraInfo(): UndefinableJson | undefined;
+}
+export declare function formatError(error: any, options?: FormatErrorOptions): string;

package/utils/format-error.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatError = void 0;
+const decycle_1 = require("./object/decycle");
+const type_guards_1 = require("./type-guards");
+// eslint-disable-next-line max-statements, complexity
+function formatError(error, options = {}) {
+    const { includeRest = 'if-no-extra-info', includeExtraInfo = true, includeStack = true } = options;
+    let name;
+    let message;
+    let stack;
+    let rest;
+    let extraInfo;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    const wrappedError = error?.rejection ?? error?.reason ?? error?.error;
+    if ((error instanceof Error) && !(error.message.startsWith('Uncaught') && (wrappedError instanceof Error))) {
+        ({ name, message, stack, ...rest } = error);
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        if (includeExtraInfo && (0, type_guards_1.isFunction)(error.getExtraInfo)) {
+            extraInfo = error.getExtraInfo();
+        }
+    }
+    else if (wrappedError instanceof Error) {
+        return formatError(wrappedError, options);
+    }
+    if ((0, type_guards_1.isUndefined)(name) && ((0, type_guards_1.isUndefined)(message) || message.trim().length == 0)) {
+        try {
+            const decycledError = (0, decycle_1.decycle)(error);
+            message = JSON.stringify(decycledError, null, 2);
+        }
+        catch {
+            throw error;
+        }
+    }
+    const decycledRest = (0, type_guards_1.isDefined)(rest) ? (0, decycle_1.decycle)(rest) : undefined;
+    const restString = (((includeRest == true) || ((includeRest == 'if-no-extra-info') && (0, type_guards_1.isUndefined)(extraInfo))) && (0, type_guards_1.isDefined)(decycledRest) && (Object.keys(rest ?? {}).length > 0)) ? `\n${JSON.stringify(decycledRest, null, 2)}` : '';
+    const extraInfoString = (0, type_guards_1.isDefined)(extraInfo) ? `\n${JSON.stringify(extraInfo, null, 2)}` : '';
+    const stackString = (includeStack && (0, type_guards_1.isDefined)(stack)) ? `\n${stack}` : '';
+    return `${name ?? 'Error'}: ${message}${restString}${extraInfoString}${stackString}`;
+}
+exports.formatError = formatError;
+//# sourceMappingURL=format-error.js.map

package/utils/format-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.js","sourceRoot":"","sources":["../../source/utils/format-error.ts"],"names":[],"mappings":";;;AACA,8CAA2C;AAC3C,+CAAmE;AAwBnE,sDAAsD;AACtD,SAAgB,WAAW,CAAC,KAAU,EAAE,UAA8B,EAAE;IACtE,MAAM,EAAE,WAAW,GAAG,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEnG,IAAI,IAAwB,CAAC;IAC7B,IAAI,OAA2B,CAAC;IAChC,IAAI,KAAyB,CAAC;IAC9B,IAAI,IAAwB,CAAC;IAC7B,IAAI,SAAsC,CAAC;IAE3C,sEAAsE;IACtE,MAAM,YAAY,GAAG,KAAK,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,KAAK,CAAC;IAEvE,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,YAAY,KAAK,CAAC,CAAC,EAAE;QAC1G,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;QAE5C,6DAA6D;QAC7D,IAAI,gBAAgB,IAAI,IAAA,wBAAU,EAAE,KAAmC,CAAC,YAAY,CAAC,EAAE;YACrF,SAAS,GAAI,KAAmC,CAAC,YAAY,EAAE,CAAC;SACjE;KACF;SACI,IAAI,YAAY,YAAY,KAAK,EAAE;QACtC,OAAO,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;KAC3C;IAED,IAAI,IAAA,yBAAW,EAAC,IAAI,CAAC,IAAI,CAAC,IAAA,yBAAW,EAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE;QAC7E,IAAI;YACF,MAAM,aAAa,GAAG,IAAA,iBAAO,EAAC,KAAK,CAAC,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;SAClD;QACD,MAAM;YACJ,MAAM,KAAK,CAAC;SACb;KACF;IAED,MAAM,YAAY,GAAG,IAAA,uBAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAO,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,kBAAkB,CAAC,IAAI,IAAA,yBAAW,EAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAA,uBAAS,EAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvO,MAAM,eAAe,GAAG,IAAA,uBAAS,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,MAAM,WAAW,GAAG,CAAC,YAAY,IAAI,IAAA,uBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3E,OAAO,GAAG,IAAI,IAAI,OAAO,KAAK,OAAO,GAAG,UAAU,GAAG,eAAe,GAAG,WAAW,EAAE,CAAC;AACvF,CAAC;AAxCD,kCAwCC"}

package/utils/function/memoize.d.ts

@@ -1,11 +1,15 @@
+export declare type MemoizeOptions = {
+    /** Use WeakMap instead of Map for caching. Can be used with object parameters only */
+    weak?: boolean;
+};
 /**
  * memoizes a function with an arbitrary number of parameters. If you only need a single parameter, {@link memoizeSingle} is faster
  * @param fn function memoize
  * @returns memoized function
- */ export declare function memoize<Fn extends (...parameters: any[]) => any>(fn: Fn): Fn;
+ */ export declare function memoize<Fn extends (...parameters: any[]) => any>(fn: Fn, options?: MemoizeOptions): Fn;
 /**
  * memoizes a function with a single parameter. Faster than {@link memoize}
  * @param fn function memoize
  * @returns memoized function
  */
-export declare function memoizeSingle<Fn extends (parameter: any) => any>(fn: Fn): Fn;
+export declare function memoizeSingle<Fn extends (parameter: any) => any>(fn: Fn, options?: MemoizeOptions): Fn;