@opra/common 0.33.13 → 1.0.0-alpha.10

package/esm/document/data-type/primitive-types/any.type.js

@@ -0,0 +1,23 @@
+import { __decorate, __metadata } from "tslib";
+import { isAny } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+let AnyType = class AnyType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+    [DECODER]() {
+        return isAny;
+    }
+    [ENCODER]() {
+        return isAny;
+    }
+};
+AnyType = __decorate([
+    SimpleType({
+        description: 'Represents any value',
+    }),
+    __metadata("design:paramtypes", [Object])
+], AnyType);
+export { AnyType };

package/esm/document/data-type/primitive-types/bigint.type.js

@@ -0,0 +1,32 @@
+import { __decorate, __metadata } from "tslib";
+import { toBigint, vg } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+import { NumberType } from './number.type.js';
+let BigintType = class BigintType extends NumberType {
+    constructor(attributes) {
+        super(attributes);
+    }
+    [DECODER](properties) {
+        const x = [];
+        if (properties.minValue)
+            x.push(vg.isGte(properties.minValue));
+        if (properties.maxValue)
+            x.push(vg.isLte(properties.maxValue));
+        return x.length > 0 ? vg.pipe([toBigint, ...x], { returnIndex: 0 }) : toBigint;
+    }
+    [ENCODER](properties) {
+        return this[DECODER](properties);
+    }
+};
+BigintType = __decorate([
+    SimpleType({
+        description: 'BigInt number',
+        nameMappings: {
+            js: 'bigint',
+            json: 'string',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], BigintType);
+export { BigintType };

package/esm/document/data-type/primitive-types/boolean.type.js

@@ -0,0 +1,27 @@
+import { __decorate, __metadata } from "tslib";
+import { toBoolean } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+let BooleanType = class BooleanType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+    [DECODER]() {
+        return toBoolean;
+    }
+    [ENCODER]() {
+        return toBoolean;
+    }
+};
+BooleanType = __decorate([
+    SimpleType({
+        description: 'Simple true/false value',
+        nameMappings: {
+            js: 'boolean',
+            json: 'boolean',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], BooleanType);
+export { BooleanType };

package/esm/document/data-type/primitive-types/index.js

@@ -0,0 +1,8 @@
+export * from './any.type.js';
+export * from './bigint.type.js';
+export * from './boolean.type.js';
+export * from './integer.type.js';
+export * from './null.type.js';
+export * from './number.type.js';
+export * from './object.type.js';
+export * from './string.type.js';

package/esm/document/data-type/primitive-types/integer.type.js

@@ -0,0 +1,32 @@
+import { __decorate, __metadata } from "tslib";
+import { toInteger, vg } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+import { NumberType } from './number.type.js';
+let IntegerType = class IntegerType extends NumberType {
+    constructor(properties) {
+        super(properties);
+    }
+    [DECODER](properties) {
+        const x = [];
+        if (properties.minValue)
+            x.push(vg.isGte(properties.minValue));
+        if (properties.maxValue)
+            x.push(vg.isLte(properties.maxValue));
+        return x.length > 0 ? vg.pipe([toInteger, ...x], { returnIndex: 0 }) : toInteger;
+    }
+    [ENCODER](properties) {
+        return this[DECODER](properties);
+    }
+};
+IntegerType = __decorate([
+    SimpleType({
+        description: 'An integer number',
+        nameMappings: {
+            js: 'number',
+            json: 'number',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], IntegerType);
+export { IntegerType };

package/esm/document/data-type/primitive-types/null.type.js

@@ -0,0 +1,27 @@
+import { __decorate, __metadata } from "tslib";
+import { isNull } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+let NullType = class NullType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+    [DECODER]() {
+        return isNull;
+    }
+    [ENCODER]() {
+        return isNull;
+    }
+};
+NullType = __decorate([
+    SimpleType({
+        description: 'A Null value',
+        nameMappings: {
+            js: 'null',
+            json: 'null',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], NullType);
+export { NullType };

package/esm/document/data-type/primitive-types/number.type.js

@@ -0,0 +1,44 @@
+import { __decorate, __metadata } from "tslib";
+import { toNumber, vg } from 'valgen';
+import { DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+let NumberType = class NumberType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+    [DECODER](properties) {
+        const x = [];
+        if (properties.minValue)
+            x.push(vg.isGte(properties.minValue));
+        if (properties.maxValue)
+            x.push(vg.isLte(properties.maxValue));
+        return x.length > 0 ? vg.pipe([toNumber, ...x], { returnIndex: 0 }) : toNumber;
+    }
+    [ENCODER](properties) {
+        return this[DECODER](properties);
+    }
+};
+__decorate([
+    SimpleType.Attribute({
+        description: 'Determines the minimum value',
+    }),
+    __metadata("design:type", Number)
+], NumberType.prototype, "minValue", void 0);
+__decorate([
+    SimpleType.Attribute({
+        description: 'Determines the maximum value',
+    }),
+    __metadata("design:type", Number)
+], NumberType.prototype, "maxValue", void 0);
+NumberType = __decorate([
+    SimpleType({
+        description: 'Both Integer as well as Floating-Point numbers',
+        nameMappings: {
+            js: 'number',
+            json: 'number',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], NumberType);
+export { NumberType };

package/esm/document/data-type/primitive-types/object.type.js

@@ -0,0 +1,20 @@
+import { __decorate, __metadata } from "tslib";
+import { DATATYPE_METADATA } from '../../constants.js';
+import { ComplexType } from '../complex-type.js';
+let ObjectType = class ObjectType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+};
+ObjectType = __decorate([
+    ComplexType({
+        name: 'object',
+        description: 'A non modelled object',
+        additionalFields: true,
+    }),
+    __metadata("design:paramtypes", [Object])
+], ObjectType);
+export { ObjectType };
+const metadata = Reflect.getMetadata(DATATYPE_METADATA, ObjectType);
+metadata.ctor = Object;

package/esm/document/data-type/primitive-types/string.type.js

@@ -0,0 +1,64 @@
+import { __decorate, __metadata } from "tslib";
+import { toString, vg } from 'valgen';
+import { DATATYPE_METADATA, DECODER, ENCODER } from '../../constants.js';
+import { SimpleType } from '../simple-type.js';
+let StringType = class StringType {
+    constructor(properties) {
+        if (properties)
+            Object.assign(this, properties);
+    }
+    [DECODER](properties) {
+        const x = [];
+        if (properties.pattern) {
+            let formatName = properties.patternName;
+            if (!formatName) {
+                const meta = Reflect.getMetadata(DATATYPE_METADATA, Object.getPrototypeOf(this).constructor);
+                formatName = meta.name;
+            }
+            x.push(vg.matches(properties.pattern, { formatName }));
+        }
+        if (properties.minLength)
+            x.push(vg.lengthMin(properties.minLength));
+        if (properties.maxLength)
+            x.push(vg.lengthMax(properties.maxLength));
+        return x.length > 0 ? vg.pipe([toString, ...x], { returnIndex: 0 }) : toString;
+    }
+    [ENCODER](properties) {
+        return this[DECODER](properties);
+    }
+};
+__decorate([
+    SimpleType.Attribute({
+        description: 'Regex pattern to be used for validation',
+    }),
+    __metadata("design:type", Object)
+], StringType.prototype, "pattern", void 0);
+__decorate([
+    SimpleType.Attribute({
+        description: 'Name of the pattern',
+    }),
+    __metadata("design:type", String)
+], StringType.prototype, "patternName", void 0);
+__decorate([
+    SimpleType.Attribute({
+        description: 'Minimum number of characters',
+    }),
+    __metadata("design:type", Number)
+], StringType.prototype, "minLength", void 0);
+__decorate([
+    SimpleType.Attribute({
+        description: 'Minimum number of characters',
+    }),
+    __metadata("design:type", Number)
+], StringType.prototype, "maxLength", void 0);
+StringType = __decorate([
+    SimpleType({
+        description: 'A sequence of characters',
+        nameMappings: {
+            js: 'string',
+            json: 'string',
+        },
+    }),
+    __metadata("design:paramtypes", [Object])
+], StringType);
+export { StringType };

package/esm/document/data-type/required-type.js

@@ -0,0 +1,9 @@
+import { createMappedClass } from './utils/create-mapped-class.js';
+/**
+ *
+ */
+export function RequiredType(base, ...args) {
+    const keys = Array.isArray(args[0]) ? args[0] : true;
+    const options = Array.isArray(args[0]) ? args[1] : args[0];
+    return createMappedClass(base, { required: keys }, options);
+}

package/esm/document/data-type/simple-type.js

@@ -1,21 +1,107 @@
 import 'reflect-metadata';
-import merge from 'putil-merge';
+import { asMutable } from 'ts-gems';
+import { isAny } from 'valgen';
+import { cloneObject, omitUndefined } from '../../helpers/index.js';
+import { OpraSchema } from '../../schema/index.js';
 import { DECORATOR } from '../constants.js';
-import { SimpleTypeDecorator } from './simple-type.decorator.js';
-import { SimpleTypeClass } from './simple-type-class.js';
+import { AttributeDecoratorFactory, SimpleTypeDecoratorFactory } from '../decorators/simple-type.decorator.js';
+import { DataType } from './data-type.js';
 /**
- * @class SimpleType
+ * SimpleType constructor
  */
 export const SimpleType = function (...args) {
     // Decorator
-    if (!this) {
-        const [options] = args;
-        return SimpleType[DECORATOR](options);
-    }
+    if (!this)
+        return SimpleType[DECORATOR](...args);
     // Constructor
-    const [document, init] = args;
-    merge(this, new SimpleTypeClass(document, init), { descriptor: true });
+    const [owner, initArgs, context] = args;
+    DataType.call(this, owner, initArgs, context);
+    const _this = asMutable(this);
+    _this.kind = OpraSchema.SimpleType.Kind;
+    if (initArgs.base) {
+        // noinspection SuspiciousTypeOfGuard
+        if (!(initArgs.base instanceof SimpleType)) {
+            throw new TypeError(`"${initArgs.base.kind}" can't be set as base for a "${this.kind}"`);
+        }
+        _this.base = initArgs.base;
+    }
+    _this.properties = initArgs.properties;
+    _this.ownNameMappings = { ...initArgs.nameMappings };
+    _this.nameMappings = { ..._this.base?.nameMappings, ...initArgs.nameMappings };
+    _this.ownAttributes = cloneObject(initArgs.attributes || {});
+    _this.attributes = _this.base ? cloneObject(_this.base.attributes) : {};
+    if (_this.ownAttributes) {
+        for (const [k, el] of Object.entries(_this.ownAttributes)) {
+            if (_this.attributes[k]?.sealed)
+                throw new TypeError(`Sealed attribute "${k}" can not be overwritten`);
+            _this.attributes[k] = el;
+        }
+    }
+    _this._generateDecoder = initArgs.generateDecoder;
+    _this._generateEncoder = initArgs.generateEncoder;
 };
+/**
+ *
+ * @class SimpleType
+ */
+class SimpleTypeClass extends DataType {
+    extendsFrom(baseType) {
+        if (!(baseType instanceof DataType))
+            baseType = this.node.getDataType(baseType);
+        if (!(baseType instanceof SimpleType))
+            return false;
+        if (baseType === this)
+            return true;
+        return !!this.base?.extendsFrom(baseType);
+    }
+    generateCodec(codec, options, properties) {
+        const prop = {
+            ...this.properties,
+            ...properties,
+        };
+        if (codec === 'decode') {
+            let t = this;
+            while (t) {
+                if (t._generateDecoder)
+                    return t._generateDecoder(prop, options?.documentElement || this.owner);
+                t = this.base;
+            }
+            return isAny;
+        }
+        let t = this;
+        while (t) {
+            if (t._generateEncoder)
+                return t._generateEncoder(prop, options?.documentElement || this.owner);
+            t = this.base;
+        }
+        return isAny;
+    }
+    toJSON() {
+        const attributes = omitUndefined(this.ownAttributes);
+        let properties;
+        if (this.properties && typeof this.properties.toJSON === 'function') {
+            properties = this.properties.toJSON(this.properties, this.owner);
+        }
+        else
+            properties = this.properties || {};
+        properties = Object.keys(this.attributes).reduce((o, k) => {
+            if (properties[k] !== undefined)
+                o[k] = properties[k];
+            return o;
+        }, {});
+        const baseName = this.base ? this.node.getDataTypeNameWithNs(this.base) : undefined;
+        const out = omitUndefined({
+            ...DataType.prototype.toJSON.apply(this),
+            base: this.base ? (baseName ? baseName : this.base.toJSON()) : undefined,
+            attributes: attributes && Object.keys(attributes).length ? attributes : undefined,
+            properties: Object.keys(properties).length ? properties : undefined,
+        });
+        if (Object.keys(this.ownNameMappings).length)
+            out.nameMappings = { ...this.ownNameMappings };
+        return out;
+    }
+}
 SimpleType.prototype = SimpleTypeClass.prototype;
-Object.assign(SimpleType, SimpleTypeDecorator);
-SimpleType[DECORATOR] = SimpleTypeDecorator;
+Object.assign(SimpleType, SimpleTypeDecoratorFactory);
+SimpleType[DECORATOR] = SimpleTypeDecoratorFactory;
+SimpleType.Attribute = AttributeDecoratorFactory;

package/esm/document/data-type/utils/create-mapped-class.js

@@ -0,0 +1,51 @@
+import { inheritPropertyInitializers, mergePrototype } from '../../../helpers/index.js';
+import { OpraSchema } from '../../../schema/index.js';
+import { DATATYPE_METADATA } from '../../constants.js';
+import { MappedType } from '../mapped-type.js';
+import { getIsInheritedPredicateFn } from './get-is-inherited-predicate-fn.js';
+export function createMappedClass(source, config, options) {
+    const isInheritedPredicate = getIsInheritedPredicateFn(config.pick, config.omit);
+    const sourceName = typeof source === 'string' ? source.charAt(0).toUpperCase() + source.substring(1) : source.name;
+    const className = options?.name || sourceName + 'Mapped';
+    const MappedClass = {
+        [className]: class {
+            constructor() {
+                if (typeof source === 'function')
+                    inheritPropertyInitializers(this, source, isInheritedPredicate);
+            }
+        },
+    }[className];
+    if (typeof source === 'function')
+        mergePrototype(MappedClass.prototype, source.prototype);
+    if (typeof source === 'function') {
+        const m = Reflect.getOwnMetadata(DATATYPE_METADATA, source);
+        if (!m)
+            throw new TypeError(`Class "${source}" doesn't have datatype metadata information`);
+        if (!(m.kind === OpraSchema.ComplexType.Kind ||
+            m.kind === OpraSchema.MappedType.Kind ||
+            m.kind === OpraSchema.MixinType.Kind)) {
+            throw new TypeError(`Class "${source}" is not a ${OpraSchema.ComplexType.Kind}`);
+        }
+    }
+    const metadata = {
+        ...options,
+        kind: 'MappedType',
+        base: source,
+    };
+    if (config.pick)
+        metadata.pick = config.pick;
+    if (config.omit)
+        metadata.omit = config.omit;
+    if (config.partial)
+        metadata.partial = config.partial;
+    if (config.required)
+        metadata.required = config.required;
+    Reflect.defineMetadata(DATATYPE_METADATA, metadata, MappedClass);
+    if (typeof source === 'function') {
+        MappedType._applyMixin(MappedClass, source, {
+            ...config,
+            isInheritedPredicate,
+        });
+    }
+    return MappedClass;
+}

package/esm/document/data-type/utils/get-is-inherited-predicate-fn.js

@@ -0,0 +1,11 @@
+export function getIsInheritedPredicateFn(pick, omit) {
+    const pickKeys = pick?.map(x => String(x).toLowerCase());
+    const omitKeys = omit?.map(x => String(x).toLowerCase());
+    return (propertyName) => {
+        if (omitKeys && omitKeys.includes(propertyName.toLowerCase()))
+            return false;
+        if (pickKeys)
+            return pickKeys.includes(propertyName.toLowerCase());
+        return true;
+    };
+}

package/esm/document/{data-type/field-decorator.js → decorators/api-field-decorator.js}

@@ -1,7 +1,7 @@
 import { omitUndefined } from '../../helpers/index.js';
 import { OpraSchema } from '../../schema/index.js';
 import { DATATYPE_METADATA } from '../constants.js';
-export function FieldDecorator(options) {
+export function ApiFieldDecorator(options) {
     return function (target, propertyKey) {
         if (typeof propertyKey !== 'string')
             throw new TypeError(`Symbol properties can't be used as a field`);
@@ -9,14 +9,14 @@ export function FieldDecorator(options) {
         metadata.kind = OpraSchema.ComplexType.Kind;
         metadata.fields = metadata.fields || {};
         const designType = Reflect.getMetadata('design:type', target, propertyKey);
-        const elemMeta = metadata.fields[propertyKey] = {
+        const elemMeta = (metadata.fields[propertyKey] = {
             ...options,
-            designType
-        };
+        });
         if (designType === Array) {
             elemMeta.isArray = true;
-            delete elemMeta.designType;
         }
+        else
+            elemMeta.type = elemMeta.type || designType;
         Reflect.defineMetadata(DATATYPE_METADATA, omitUndefined(metadata), target.constructor);
     };
 }

package/esm/document/{data-type → decorators}/complex-type.decorator.js

@@ -1,9 +1,19 @@
 import omit from 'lodash.omit';
 import { OpraSchema } from '../../schema/index.js';
-import { DATATYPE_METADATA, TYPENAME_PATTERN } from '../constants.js';
+import { CLASS_NAME_PATTERN, DATATYPE_METADATA, EXTRACT_TYPENAME_PATTERN } from '../constants.js';
 export function ComplexTypeDecorator(options) {
     return function (target) {
-        const name = options?.name || target.name.match(TYPENAME_PATTERN)?.[1] || target.name;
+        let name;
+        if (!options?.embedded) {
+            if (options?.name) {
+                if (!CLASS_NAME_PATTERN.test(options.name))
+                    throw new TypeError(`"${options.name}" is not a valid type name`);
+                name = options.name;
+            }
+            else {
+                name = target.name.match(EXTRACT_TYPENAME_PATTERN)?.[1] || target.name;
+            }
+        }
         let metadata = Reflect.getOwnMetadata(DATATYPE_METADATA, target);
         if (!metadata) {
             metadata = {};

package/esm/document/decorators/http-controller.decorator.js

@@ -0,0 +1,137 @@
+import omit from 'lodash.omit';
+import merge from 'putil-merge';
+import { OpraSchema } from '../../schema/index.js';
+import { HTTP_CONTROLLER_METADATA } from '../constants.js';
+const CLASS_NAME_PATTERN = /^(.*)(Collection|Singleton|Resource|Controller)$/;
+export function HttpControllerDecoratorFactory(options) {
+    const decoratorChain = [];
+    /**
+     *
+     */
+    const decorator = function (target) {
+        let name = options?.name;
+        if (!name)
+            name = CLASS_NAME_PATTERN.exec(target.name)?.[1] || target.name;
+        const metadata = {};
+        const baseMetadata = Reflect.getOwnMetadata(HTTP_CONTROLLER_METADATA, Object.getPrototypeOf(target));
+        if (baseMetadata)
+            merge(metadata, baseMetadata, { deep: true });
+        const oldMetadata = Reflect.getOwnMetadata(HTTP_CONTROLLER_METADATA, target);
+        if (oldMetadata)
+            merge(metadata, oldMetadata, { deep: true });
+        merge(metadata, {
+            kind: OpraSchema.HttpController.Kind,
+            name,
+            path: name,
+            ...omit(options, ['kind', 'name', 'instance', 'endpoints', 'key']),
+        }, { deep: true });
+        Reflect.defineMetadata(HTTP_CONTROLLER_METADATA, metadata, target);
+        for (const fn of decoratorChain)
+            fn(metadata);
+        Reflect.defineMetadata(HTTP_CONTROLLER_METADATA, metadata, target);
+    };
+    /**
+     *
+     */
+    decorator.Cookie = (name, arg1) => {
+        decoratorChain.push((meta) => {
+            const paramMeta = typeof arg1 === 'string' || typeof arg1 === 'function'
+                ? {
+                    name,
+                    location: 'cookie',
+                    type: arg1,
+                }
+                : { ...arg1, name, location: 'cookie' };
+            meta.parameters = meta.parameters || [];
+            meta.parameters.push(paramMeta);
+        });
+        return decorator;
+    };
+    /**
+     *
+     */
+    decorator.Header = (name, arg1) => {
+        decoratorChain.push((meta) => {
+            const paramMeta = typeof arg1 === 'string' || typeof arg1 === 'function'
+                ? {
+                    name,
+                    location: 'header',
+                    type: arg1,
+                }
+                : { ...arg1, name, location: 'header' };
+            meta.parameters = meta.parameters || [];
+            meta.parameters.push(paramMeta);
+        });
+        return decorator;
+    };
+    /**
+     *
+     */
+    decorator.QueryParam = (name, arg1) => {
+        decoratorChain.push((meta) => {
+            const paramMeta = typeof arg1 === 'string' || typeof arg1 === 'function'
+                ? {
+                    name,
+                    location: 'query',
+                    type: arg1,
+                }
+                : { ...arg1, name, location: 'query' };
+            meta.parameters = meta.parameters || [];
+            meta.parameters.push(paramMeta);
+        });
+        return decorator;
+    };
+    /**
+     *
+     */
+    decorator.PathParam = (name, arg1) => {
+        decoratorChain.push((meta) => {
+            const paramMeta = typeof arg1 === 'string' || typeof arg1 === 'function'
+                ? {
+                    name,
+                    location: 'path',
+                    type: arg1,
+                }
+                : { ...arg1, name, location: 'path' };
+            meta.parameters = meta.parameters || [];
+            meta.parameters.push(paramMeta);
+        });
+        return decorator;
+    };
+    /**
+     *
+     */
+    decorator.KeyParam = (name, arg1) => {
+        decoratorChain.push((meta) => {
+            if (!meta.path?.includes(':' + name))
+                meta.path = (meta.path || '') + '@:' + name;
+            const paramMeta = typeof arg1 === 'string' || typeof arg1 === 'function'
+                ? {
+                    name,
+                    location: 'path',
+                    type: arg1,
+                    keyParam: true,
+                }
+                : {
+                    ...arg1,
+                    name,
+                    location: 'path',
+                    keyParam: true,
+                };
+            meta.parameters = meta.parameters || [];
+            meta.parameters.push(paramMeta);
+        });
+        return decorator;
+    };
+    /**
+     *
+     */
+    decorator.UseType = (...type) => {
+        decoratorChain.push((meta) => {
+            meta.types = meta.types || [];
+            meta.types.push(...type);
+        });
+        return decorator;
+    };
+    return decorator;
+}