@opra/common 1.20.0 → 1.22.0

package/{esm/document → document}/common/document-node.js

@@ -4,6 +4,10 @@ import { DATATYPE_METADATA, kDataTypeMap, kTypeNSMap } from '../constants.js';
  * @class DocumentNode
  */
 export class DocumentNode {
+    [kDataTypeMap];
+    _document;
+    parent;
+    element;
     constructor(element, parent) {
         this.element = element;
         this.parent = parent;

package/{esm/document → document}/common/opra-document-error.js

@@ -1,8 +1,8 @@
 import { OpraException } from '../../exception/opra-exception.js';
 export class OpraDocumentError extends OpraException {
+    details = [];
     constructor() {
         super('');
-        this.details = [];
     }
     add(detail) {
         this.details.push(detail);

package/{esm/document → document}/common/value.js

@@ -17,6 +17,10 @@ export const Value = function (owner, initArgs) {
  * @class Value
  */
 class ValueClass extends DocumentElement {
+    type;
+    description;
+    examples;
+    isArray;
     toJSON(options) {
         const typeName = this.type
             ? this.node.getDataTypeNameWithNs(this.type)

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

@@ -54,6 +54,7 @@ export const ApiField = function (...args) {
  * This class extends DocumentElement, inheriting base document structure capabilities.
  */
 class ApiFieldClass extends DocumentElement {
+    origin;
     inScope(scope) {
         return testScopeMatch(scope, this.scopePattern);
     }

package/{types/document → document}/data-type/array-type.d.ts

@@ -46,7 +46,7 @@ export interface ArrayTypeStatic {
     /**
      * Create a new mixin type from the given data type
      */
-    (type: string | Type, options?: ArrayType.Options): Type;
+    (type: string | Type | EnumType.EnumObject, options?: ArrayType.Options): Type;
     prototype: ArrayType;
 }
 /**

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

@@ -22,6 +22,9 @@ export const ComplexTypeBase = function (...args) {
  *
  */
 class ComplexTypeBaseClass extends DataType {
+    ctor;
+    additionalFields;
+    keyField;
     fieldCount(scope) {
         if (scope === '*')
             return this._fields.size;

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

@@ -61,6 +61,7 @@ export const ComplexType = function (...args) {
  * @class ComplexType
  */
 class ComplexTypeClass extends ComplexTypeBase {
+    base;
     extendsFrom(baseType) {
         if (!(baseType instanceof DataType))
             baseType = this.node.getDataType(baseType);

package/{esm/document → document}/data-type/extended-types/base64.type.js

@@ -3,6 +3,7 @@ import { isBase64, validator, vg } from 'valgen';
 import { DECODER, ENCODER } from '../../constants.js';
 import { SimpleType } from '../simple-type.js';
 let Base64Type = class Base64Type {
+    designType;
     constructor(attributes) {
         if (attributes)
             Object.assign(this, attributes);

package/{esm/document → document}/data-type/extended-types/date-time-tz.type.js

@@ -33,6 +33,8 @@ let DateTimeTypeTz = class DateTimeTypeTz {
         }
         return x.length > 0 ? vg.pipe(x, { returnIndex: 0 }) : fn;
     }
+    minValue;
+    maxValue;
 };
 __decorate([
     SimpleType.Attribute({

package/{esm/document → document}/data-type/extended-types/date-time.type.js

@@ -11,6 +11,7 @@ const _isDate = vg.isDate({
     coerce: true,
 });
 let DateTimeType = class DateTimeType {
+    designType;
     constructor(attributes) {
         if (attributes)
             Object.assign(this, attributes);
@@ -43,6 +44,8 @@ let DateTimeType = class DateTimeType {
         }
         return x.length > 0 ? vg.pipe(x, { returnIndex: 0 }) : fn;
     }
+    minValue;
+    maxValue;
 };
 __decorate([
     SimpleType.Attribute({

package/{esm/document → document}/data-type/extended-types/date.type.js

@@ -12,6 +12,7 @@ const _isDate = vg.isDate({
     coerce: true,
 });
 let DateType = class DateType {
+    designType;
     constructor(attributes) {
         if (attributes)
             Object.assign(this, attributes);
@@ -44,6 +45,8 @@ let DateType = class DateType {
         }
         return x.length > 0 ? vg.pipe(x, { returnIndex: 0 }) : fn;
     }
+    minValue;
+    maxValue;
 };
 __decorate([
     SimpleType.Attribute({

package/{esm/document → document}/data-type/extended-types/email.type.js

@@ -7,6 +7,15 @@ let EmailType = class EmailType {
         if (attributes)
             Object.assign(this, attributes);
     }
+    allowDisplayName;
+    requireDisplayName;
+    utf8LocalPart;
+    ignoreMaxLength;
+    allowIpDomain;
+    domainSpecificValidation;
+    hostBlacklist;
+    hostWhitelist;
+    blacklistedChars;
     [DECODER](properties) {
         return vg.isEmail({ ...properties, coerce: true });
     }

package/{esm/document → document}/data-type/extended-types/field-path.type.js

@@ -8,6 +8,8 @@ let FieldPathType = class FieldPathType {
         if (attributes)
             Object.assign(this, attributes);
     }
+    dataType;
+    allowSigns;
     [DECODER](properties, { element, scope, }) {
         const dataType = properties.dataType
             ? element.node.getComplexType(properties.dataType)

package/{esm/document → document}/data-type/extended-types/filter.type.js

@@ -10,6 +10,8 @@ let FilterType = class FilterType {
         if (attributes)
             Object.assign(this, attributes);
     }
+    dataType;
+    rules;
     [DECODER](properties, { element }) {
         const dataType = properties.dataType
             ? element.node.getComplexType(properties.dataType)

package/{esm/document → document}/data-type/extended-types/partial-date.type.js

@@ -33,6 +33,8 @@ let PartialDateType = class PartialDateType {
         }
         return x.length > 0 ? vg.pipe([fn, ...x], { returnIndex: 0 }) : fn;
     }
+    minValue;
+    maxValue;
 };
 __decorate([
     SimpleType.Attribute({

package/{esm/document → document}/data-type/extended-types/time.type.js

@@ -8,6 +8,8 @@ let TimeType = class TimeType {
         if (attributes)
             Object.assign(this, attributes);
     }
+    minValue;
+    maxValue;
     [DECODER](properties) {
         const fn = vg.matches(TIME_PATTERN, {
             formatName: 'time',

package/{esm/document → document}/data-type/extended-types/uuid.type.js

@@ -7,6 +7,7 @@ let UuidType = class UuidType {
         if (attributes)
             Object.assign(this, attributes);
     }
+    version;
     [DECODER](properties) {
         return vg.isUUID(properties?.version, { coerce: true });
     }

package/{esm/document → document}/data-type/mapped-type.js

@@ -78,6 +78,10 @@ export const MappedType = function (...args) {
  * @class MappedType
  */
 class MappedTypeClass extends ComplexTypeBase {
+    omit;
+    pick;
+    partial;
+    required;
     extendsFrom(baseType) {
         if (!(baseType instanceof DataType))
             baseType = this.node.getDataType(baseType);

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

@@ -7,6 +7,8 @@ let NumberType = class NumberType {
         if (properties)
             Object.assign(this, properties);
     }
+    minValue;
+    maxValue;
     [DECODER](properties) {
         const x = [];
         if (properties.minValue != null)

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

@@ -7,6 +7,10 @@ let StringType = class StringType {
         if (properties)
             Object.assign(this, properties);
     }
+    pattern;
+    patternName;
+    minLength;
+    maxLength;
     [DECODER](properties) {
         const x = [];
         if (properties.pattern) {

package/{esm/document → document}/data-type/simple-type.js

@@ -49,6 +49,9 @@ export const SimpleType = function (...args) {
  * @class SimpleType
  */
 class SimpleTypeClass extends DataType {
+    _generateDecoder;
+    _generateEncoder;
+    properties;
     extend(properties) {
         Object.setPrototypeOf(properties, this);
         return properties;

package/document/decorators/ws-param.decorator.d.ts

@@ -0,0 +1,7 @@
+import { TypeThunkAsync } from 'ts-gems';
+export declare function WsParam(type?: TypeThunkAsync | string, options?: WsParam.Options): ParameterDecorator;
+export declare namespace WsParam {
+    interface Options {
+        required?: boolean;
+    }
+}

package/{esm/document → document}/decorators/ws-param.decorator.js

@@ -1,5 +1,5 @@
 import { WS_PARAM_METADATA } from '../constants.js';
-export function WsParam(type) {
+export function WsParam(type, options) {
     return (target, propertyKey, parameterIndex) => {
         if (typeof propertyKey !== 'string')
             throw new TypeError(`Un-named properties can not be decorated`);
@@ -14,6 +14,6 @@ export function WsParam(type) {
             paramMetadata = [];
             Reflect.defineMetadata(WS_PARAM_METADATA, paramMetadata, target, propertyKey);
         }
-        paramMetadata[parameterIndex] = type;
+        paramMetadata.push({ ...options, type, parameterIndex });
     };
 }

package/{esm/document → document}/factory/api-document.factory.js

@@ -15,9 +15,7 @@ const OPRA_SPEC_URL = 'https://oprajs.com/spec/v' + OpraSchema.SpecVersion;
  * @class ApiDocumentFactory
  */
 export class ApiDocumentFactory {
-    constructor() {
-        this._allDocuments = {};
-    }
+    _allDocuments = {};
     /**
      * Creates ApiDocument instance from given schema object
      */

package/{esm/document → document}/factory/ws-api.factory.js

@@ -101,6 +101,7 @@ export class WSApiFactory {
                             type: undefined,
                             keyType: undefined,
                             arguments: undefined,
+                            response: undefined,
                         });
                         await this._initWSOperation(context, operation, operationMeta);
                         controller.operations.set(operationName, operation);
@@ -126,9 +127,19 @@ export class WSApiFactory {
         if (metadata.arguments?.length) {
             await context.enterAsync('.arguments', async () => {
                 operation.arguments = [];
-                for (const x of metadata.arguments) {
-                    const t = await DataTypeFactory.resolveDataType(context, operation, x);
-                    operation.arguments?.push(t);
+                let x;
+                for (x of metadata.arguments) {
+                    const xx = {};
+                    if (typeof x === 'object' && x.type && x.parameterIndex !== null) {
+                        Object.assign(xx, x);
+                    }
+                    else
+                        xx.type = x;
+                    const t = await DataTypeFactory.resolveDataType(context, operation, xx.type);
+                    operation.arguments?.push({
+                        type: t,
+                        parameterIndex: xx.parameterIndex,
+                    });
                 }
             });
         }

package/{esm/document → document}/http/http-api.js

@@ -5,12 +5,13 @@ import { HttpController } from './http-controller.js';
  * @class HttpApi
  */
 export class HttpApi extends ApiBase {
+    // noinspection JSUnusedGlobalSymbols
+    _controllerReverseMap = new WeakMap();
+    transport = 'http';
+    controllers = new ResponsiveMap();
+    url;
     constructor(init) {
         super(init);
-        // noinspection JSUnusedGlobalSymbols
-        this._controllerReverseMap = new WeakMap();
-        this.transport = 'http';
-        this.controllers = new ResponsiveMap();
         this.url = init.url;
     }
     findController(arg0) {

package/{esm/document → document}/http/http-multipart-field.js

@@ -6,6 +6,9 @@ import { HttpMediaType } from './http-media-type.js';
  * @class HttpMultipartField
  */
 export class HttpMultipartField extends HttpMediaType {
+    fieldName;
+    fieldType;
+    required;
     constructor(owner, initArgs) {
         super(owner, initArgs);
         this.fieldName =

package/{esm/document → document}/http/http-operation-response.js

@@ -5,6 +5,9 @@ import { HttpStatusRange } from './http-status-range.js';
  * @class HttpOperationResponse
  */
 export class HttpOperationResponse extends HttpMediaType {
+    statusCode;
+    parameters;
+    partial;
     constructor(owner, init) {
         super(owner, init);
         this.parameters = [];

package/{esm/document → document}/http/http-request-body.js

@@ -4,9 +4,16 @@ import { DocumentElement } from '../common/document-element.js';
  * @class HttpRequestBody
  */
 export class HttpRequestBody extends DocumentElement {
+    description;
+    content = [];
+    required;
+    maxContentSize;
+    immediateFetch;
+    partial;
+    allowPatchOperators;
+    keepKeyFields;
     constructor(owner) {
         super(owner);
-        this.content = [];
     }
     toJSON(options) {
         return omitUndefined({

package/{esm/document → document}/http/http-status-range.js

@@ -3,9 +3,9 @@ const STATUS_RANGE_PATTERN = /^([1-6]\d{2})(?:-([1-6]\d{2}))?$/;
  * @class HttpStatusRange
  */
 export class HttpStatusRange {
+    start = 0;
+    end = 0;
     constructor(arg0, arg1) {
-        this.start = 0;
-        this.end = 0;
         if (arg0 && typeof arg0 === 'object') {
             this.start = arg0.start || 0;
             this.end = arg0.end || 0;

package/{esm/document → document}/mq/mq-api.js

@@ -4,12 +4,13 @@ import { ApiBase } from '../common/api-base.js';
  * @class MQApi
  */
 export class MQApi extends ApiBase {
+    // noinspection JSUnusedGlobalSymbols
+    _controllerReverseMap = new WeakMap();
+    transport = 'mq';
+    platform;
+    controllers = new ResponsiveMap();
     constructor(init) {
         super(init);
-        // noinspection JSUnusedGlobalSymbols
-        this._controllerReverseMap = new WeakMap();
-        this.transport = 'mq';
-        this.controllers = new ResponsiveMap();
         this.platform = init.platform;
     }
     findController(arg0) {

package/{esm/document → document}/mq/mq-operation-response.js

@@ -5,9 +5,15 @@ import { DataType } from '../data-type/data-type.js';
  * @class MQOperationResponse
  */
 export class MQOperationResponse extends DocumentElement {
+    channel;
+    description;
+    type;
+    keyType;
+    headers = [];
+    designType;
+    keyDesignType;
     constructor(owner, initArgs) {
         super(owner);
-        this.headers = [];
         this.channel = initArgs?.channel;
         this.description = initArgs?.description;
         if (initArgs?.type) {

package/{esm/document → document}/ws/ws-api.js

@@ -4,12 +4,12 @@ import { ApiBase } from '../common/api-base.js';
  * @class WSApi
  */
 export class WSApi extends ApiBase {
+    // noinspection JSUnusedGlobalSymbols
+    _controllerReverseMap = new WeakMap();
+    transport = 'ws';
+    controllers = new ResponsiveMap();
     constructor(init) {
         super(init);
-        // noinspection JSUnusedGlobalSymbols
-        this._controllerReverseMap = new WeakMap();
-        this.transport = 'ws';
-        this.controllers = new ResponsiveMap();
     }
     findController(arg0) {
         if (typeof arg0 === 'function') {

package/{types/document → document}/ws/ws-operation.d.ts

@@ -11,7 +11,11 @@ import { WSController } from './ws-controller.js';
  */
 export declare namespace WSOperation {
     interface Metadata extends Pick<OpraSchema.WSOperation, 'description' | 'event'> {
-        arguments?: (ThunkAsync<Type | EnumType.EnumObject | EnumType.EnumArray> | string)[];
+        arguments?: {
+            type: ThunkAsync<Type | EnumType.EnumObject | EnumType.EnumArray> | string;
+            parameterIndex: number;
+            required?: boolean;
+        }[];
         types?: ThunkAsync<Type | EnumType.EnumObject | EnumType.EnumArray>[];
         response?: ThunkAsync<Type | EnumType.EnumObject | EnumType.EnumArray>[];
     }
@@ -22,7 +26,11 @@ export declare namespace WSOperation {
     interface InitArguments extends Combine<{
         name: string;
         types?: DataType[];
-        arguments?: (DataType | string | Type)[];
+        arguments?: {
+            type: DataType | string | Type;
+            parameterIndex: number;
+            required?: boolean;
+        }[];
     }, Pick<Metadata, 'description'>> {
         event?: string | RegExp;
         response?: DataType | string | Type;
@@ -62,7 +70,11 @@ declare class WSOperationClass extends DocumentElement {
     readonly name: string;
     description?: string;
     event: string | RegExp;
-    arguments?: DataType[];
+    arguments: {
+        type: DataType;
+        parameterIndex: number;
+        required?: boolean;
+    }[];
     types: DataTypeMap;
     response?: DataType;
     toJSON(): OpraSchema.WSOperation;

package/{esm/document → document}/ws/ws-operation.js

@@ -24,6 +24,7 @@ export const WSOperation = function (...args) {
         throw new TypeError(`Invalid operation name (${initArgs.name})`);
     const _this = asMutable(this);
     _this.types = _this.node[kDataTypeMap] = new DataTypeMap();
+    // noinspection JSConstantReassignment
     _this.name = initArgs.name;
     _this.description = initArgs.description;
     if (initArgs.event)
@@ -36,8 +37,15 @@ export const WSOperation = function (...args) {
     else
         _this.event = this.name;
     if (initArgs?.arguments) {
-        _this.arguments = initArgs.arguments.map(arg => arg instanceof DataType ? arg : _this.owner.node.getDataType(arg));
+        _this.arguments = initArgs.arguments.map(arg => {
+            const type = arg.type instanceof DataType
+                ? arg.type
+                : _this.owner.node.getDataType(arg.type);
+            return { type, parameterIndex: arg.parameterIndex };
+        });
     }
+    else
+        _this.arguments = [];
     if (initArgs?.response)
         _this.response =
             initArgs.response instanceof DataType
@@ -53,7 +61,7 @@ class WSOperationClass extends DocumentElement {
             kind: OpraSchema.WSOperation.Kind,
             description: this.description,
             event: this.event,
-            arguments: this.arguments?.map(arg => arg.name ? arg.name : arg.toJSON()),
+            arguments: this.arguments?.map(arg => arg.type.name ? arg.type.name : arg.type.toJSON()),
         });
     }
 }

package/{esm/exception → exception}/http-errors/bad-request.error.js

@@ -5,10 +5,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).
  */
 export class BadRequestError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 400;
-    }
+    status = 400;
     init(issue) {
         super.init({
             message: 'Bad request',

package/{esm/exception → exception}/http-errors/conflict.error.js

@@ -4,10 +4,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * This response is sent when a request conflicts with the current state of the server.
  */
 export class ConflictError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 409;
-    }
+    status = 409;
     init(issue) {
         super.init({
             message: 'Conflict',

package/{esm/exception → exception}/http-errors/failed-dependency.error.js

@@ -4,10 +4,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * The request failed due to failure of a previous request.
  */
 export class FailedDependencyError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 424;
-    }
+    status = 424;
     init(issue) {
         super.init({
             message: 'The request failed due to failure of a previous request',

package/{esm/exception → exception}/http-errors/forbidden.error.js

@@ -7,10 +7,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * the client's identity is known to the server.
  */
 export class ForbiddenError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = HttpStatusCode.FORBIDDEN;
-    }
+    status = HttpStatusCode.FORBIDDEN;
     init(issue) {
         super.init({
             message: 'You are not authorized to perform this action',

package/{esm/exception → exception}/http-errors/internal-server.error.js

@@ -4,10 +4,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * The server has encountered a situation it does not know how to handle.
  */
 export class InternalServerError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 500;
-    }
+    status = 500;
     init(issue) {
         super.init({
             message: 'Internal server error',

package/{esm/exception → exception}/http-errors/method-not-allowed.error.js

@@ -5,10 +5,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * For example, an API may not allow calling DELETE to remove a resource.
  */
 export class MethodNotAllowedError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 405;
-    }
+    status = 405;
     init(issue) {
         super.init({
             message: 'Method not allowed',

package/{esm/exception → exception}/http-errors/not-acceptable.error.js

@@ -5,10 +5,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * doesn't find any content that conforms to the criteria given by the user agent.
  */
 export class NotAcceptableError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 406;
-    }
+    status = 406;
     init(issue) {
         super.init({
             message: 'Not Acceptable',

package/{esm/exception → exception}/http-errors/not-found.error.js

@@ -8,10 +8,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * frequent occurrence on the web.
  */
 export class NotFoundError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 404;
-    }
+    status = 404;
     init(issue) {
         super.init({
             message: 'Not found',

package/{esm/exception → exception}/http-errors/resource-conflict.error.js

@@ -1,5 +1,6 @@
 import { OpraHttpError } from '../opra-http-error.js';
 export class ResourceConflictError extends OpraHttpError {
+    status = 409;
     constructor(resource, fields, cause) {
         super({
             message: `There is already an other "${resource}" resource with same values for field(s) [${fields}]`,
@@ -10,6 +11,5 @@ export class ResourceConflictError extends OpraHttpError {
                 location: fields,
             },
         }, cause);
-        this.status = 409;
     }
 }

package/{esm/exception → exception}/http-errors/unauthorized.error.js

@@ -5,10 +5,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * That is, the client must authenticate itself to get the requested response.
  */
 export class UnauthorizedError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 401;
-    }
+    status = 401;
     init(issue) {
         super.init({
             message: `You don't have permission to perform this action`,

package/{esm/exception → exception}/http-errors/unprocessable-entity.error.js

@@ -4,10 +4,7 @@ import { OpraHttpError } from '../opra-http-error.js';
  * The request was well-formed but was unable to be followed due to semantic errors.
  */
 export class UnprocessableEntityError extends OpraHttpError {
-    constructor() {
-        super(...arguments);
-        this.status = 422;
-    }
+    status = 422;
     init(issue) {
         super.init({
             message: 'Unprocessable entity',