@opra/common 1.26.2 → 1.26.4

package/document/api-document.js

@@ -120,11 +120,11 @@ export class ApiDocument extends DocumentElement {
         return out;
     }
     invalidate() {
-        /** Generate id */
+        /* Generate id */
         const x = this.export({});
         delete x.id;
         this.id = md5(JSON.stringify(x));
-        /** Clear [kTypeNSMap] */
+        /* Clear [kTypeNSMap] */
         this[kTypeNSMap] = new WeakMap();
     }
     _findDataType(nameOrCtor, scope, visitedRefs) {
@@ -155,7 +155,7 @@ export class ApiDocument extends DocumentElement {
         visitedRefs = visitedRefs || new WeakMap();
         visitedRefs.set(this, true);
         const references = Array.from(this.references.keys()).reverse();
-        /** First step, lookup for own types */
+        /* First step, lookup for own types */
         for (const refNs of references) {
             const ref = this.references.get(refNs);
             result = ref?.types.get(nameOrCtor);
@@ -164,7 +164,7 @@ export class ApiDocument extends DocumentElement {
                 return result;
             }
         }
-        /** If not found lookup for child references */
+        /* If not found lookup for child references */
         for (const refNs of references) {
             const ref = this.references.get(refNs);
             visitedRefs.set(ref, true);

package/document/common/document-node.js

@@ -47,6 +47,8 @@ export class DocumentNode {
         }
         else if (typeof nameOrCtor === 'object') {
             const metadata = nameOrCtor[DATATYPE_METADATA];
+            if (!metadata)
+                throw new TypeError(`OPRA Metadata not found for data type (${nameOrCtor})`);
             name = metadata?.name;
         }
         if (!name) {

package/document/data-type/api-field.d.ts

@@ -44,7 +44,6 @@ declare class ApiFieldClass extends DocumentElement {
     readonly name: string;
     readonly type: DataType;
     readonly description?: string;
-    /** @deprecated */
     readonly isArray?: boolean;
     readonly isNestedEntity?: boolean;
     readonly default?: any;

package/document/data-type/complex-type-base.js

@@ -251,12 +251,12 @@ class ComplexTypeBaseClass extends DataType {
         let fieldName;
         for (const field of this.fields('*')) {
             if (
-            /** Ignore field if required scope(s) do not match field scopes */
+            /* Ignore field if required scope(s) do not match field scopes */
             !field.inScope(context.scope) ||
                 (!(context.keepKeyFields && this.keyField) &&
-                    /** Ignore field if readonly and ignoreReadonlyFields option true */
+                    /* Ignore field if readonly and ignoreReadonlyFields option true */
                     ((context.ignoreReadonlyFields && field.readonly) ||
-                        /** Ignore field if writeonly and ignoreWriteonlyFields option true */
+                        /* Ignore field if writeonly and ignoreWriteonlyFields option true */
                         (context.ignoreWriteonlyFields && field.writeonly)))) {
                 schema[field.name] = vg.isUndefined({ coerce: true });
                 continue;
@@ -266,11 +266,11 @@ class ComplexTypeBaseClass extends DataType {
             if (projection !== '*') {
                 p = projection?.[fieldName.toLowerCase()];
                 if (
-                /** Ignore if field is omitted */
+                /* Ignore if field is omitted */
                 p?.sign === '-' ||
-                    /** Ignore if default fields ignored and field is not in projection */
+                    /* Ignore if default fields ignored and field is not in projection */
                     (pickList && !p) ||
-                    /** Ignore if default fields enabled and fields is exclusive */
+                    /* Ignore if default fields enabled and fields is exclusive */
                     (!pickList && field.exclusive && !p)) {
                     schema[field.name] = vg.isUndefined({ coerce: true });
                     continue;
@@ -288,7 +288,7 @@ class ComplexTypeBaseClass extends DataType {
                 context.fieldCache.set(field, cacheItem);
             }
             let fn = cacheItem[cacheKey];
-            /** If in progress (circular) */
+            /* If in progress (circular) */
             if (fn === null) {
                 // Temporary set any
                 fn = vg.isAny();

package/document/data-type/complex-type.js

@@ -32,7 +32,7 @@ export const ComplexType = function (...args) {
             _this.base = initArgs.base;
             _this.additionalFields = _this.base.additionalFields;
             _this.keyField = _this.base.keyField;
-            /** Copy fields from base */
+            /* Copy fields from base */
             for (const v of _this.base.fields('*')) {
                 _this._fields.set(v.name, new ApiField(this, v));
             }
@@ -43,7 +43,7 @@ export const ComplexType = function (...args) {
     if (initArgs.keyField !== undefined)
         _this.keyField = initArgs.keyField;
     _this.ctor = initArgs.ctor || _this.base?.ctor;
-    /** Add own fields */
+    /* Add own fields */
     if (initArgs.fields) {
         context.enter('.fields', () => {
             for (const [k, v] of Object.entries(initArgs.fields)) {

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

@@ -40,7 +40,7 @@ class DataTypeClass extends DocumentElement {
         return testScopeMatch(scope, this.scopePattern);
     }
     toJSON(options) {
-        /** Locate base model which is not available for given scope */
+        /* Locate base model which is not available for given scope */
         const outOfScope = this._locateBase(dt => !dt.inScope(options?.scope));
         if (outOfScope) {
             const baseName = this.node.getDataTypeNameWithNs(outOfScope);

package/document/data-type/extended-types/field-path.type.js

@@ -25,7 +25,7 @@ let FieldPathType = class FieldPathType {
         const dataType = properties.dataType
             ? element.node.getComplexType(properties.dataType)
             : element.node.getComplexType('object');
-        /** Test scope */
+        /* Test scope */
         DataType.prototype.toJSON.call(dataType, options);
         const typeName = dataType
             ? element.node.getDataTypeNameWithNs(dataType)

package/document/data-type/extended-types/filter.type.js

@@ -28,7 +28,7 @@ let FilterType = class FilterType {
         const dataType = properties.dataType
             ? element.node.getComplexType(properties.dataType)
             : element.node.getComplexType('object');
-        /** Test scope */
+        /* Test scope */
         DataType.prototype.toJSON.call(dataType, options);
         const typeName = dataType
             ? element.node.getDataTypeNameWithNs(dataType)

package/document/data-type/mapped-type.js

@@ -38,7 +38,7 @@ export const MappedType = function (...args) {
                 ? initArgs.required.map(f => _this.base.normalizeFieldPath(f))
                 : initArgs.required;
         }
-        /** Copy fields from base */
+        /* Copy fields from base */
         const isInheritedPredicate = getIsInheritedPredicateFn(_this.pick, _this.omit);
         const partial = Array.isArray(_this.partial)
             ? _this.partial.map(x => x.toLowerCase())

package/document/decorators/http-operation-entity-create.decorator.js

@@ -14,7 +14,7 @@ HttpOperation.Entity.Create = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'POST',

package/document/decorators/http-operation-entity-delete-many.decorator.js

@@ -13,7 +13,7 @@ HttpOperation.Entity.DeleteMany = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'DELETE',

package/document/decorators/http-operation-entity-delete.decorator.js

@@ -13,7 +13,7 @@ HttpOperation.Entity.Delete = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'DELETE',

package/document/decorators/http-operation-entity-find-many.decorator.js

@@ -15,7 +15,7 @@ HttpOperation.Entity.FindMany = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'GET',

package/document/decorators/http-operation-entity-get.decorator.js

@@ -14,7 +14,7 @@ HttpOperation.Entity.Get = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'GET',

package/document/decorators/http-operation-entity-replace.decorator.js

@@ -14,7 +14,7 @@ HttpOperation.Entity.Replace = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'POST',

package/document/decorators/http-operation-entity-update-many.decorator.js

@@ -13,7 +13,7 @@ HttpOperation.Entity.UpdateMany = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'PATCH',

package/document/decorators/http-operation-entity-update.decorator.js

@@ -14,7 +14,7 @@ HttpOperation.Entity.Update = function (arg0, arg1) {
     }
     else
         args = { ...arg1, type: arg0 };
-    /** Initialize the decorator and the chain */
+    /* Initialize the decorator and the chain */
     const decoratorChain = [];
     const decorator = HttpOperationDecoratorFactory(decoratorChain, {
         method: 'PATCH',

package/document/decorators/http-operation-entity.decorator.d.ts

@@ -5,7 +5,6 @@ import { HttpOperation } from '../http/http-operation.js';
 import type { HttpParameter } from '../http/http-parameter.js';
 import { HttpRequestBody } from '../http/http-request-body.js';
 import { type HttpOperationDecorator } from './http-operation.decorator.js';
-/** Augmentation **/
 declare module '../http/http-operation.js' {
     /**
      * HttpOperationStatic
@@ -33,7 +32,6 @@ declare module '../http/http-operation.js' {
     }
     namespace HttpOperation {
         namespace Entity {
-            /** Create */
             interface CreateDecorator extends HttpOperationDecorator {
             }
             interface CreateArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
@@ -43,14 +41,12 @@ declare module '../http/http-operation.js' {
                     immediateFetch?: boolean;
                 };
             }
-            /** Delete */
             interface DeleteDecorator extends HttpOperationDecorator {
                 KeyParam(name: string, optionsOrType?: StrictOmit<HttpParameter.Options, 'location'> | string | TypeThunkAsync): this;
             }
             interface DeleteArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
             }
-            /** DeleteMany */
             interface FilterOptions {
                 mappedField?: string;
                 operators?: OpraFilter.ComparisonOperator[];
@@ -64,7 +60,6 @@ declare module '../http/http-operation.js' {
             interface DeleteManyArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
             }
-            /** FindMany */
             interface FindManyDecorator extends HttpOperationDecorator {
                 SortFields(...fields: OpraSchema.Field.QualifiedName[]): FindManyDecorator;
                 SortFields(fieldsMap: Record<OpraSchema.Field.QualifiedName, OpraSchema.Field.QualifiedName>): FindManyDecorator;
@@ -78,21 +73,18 @@ declare module '../http/http-operation.js' {
                 defaultProjection?: string[];
                 maxLimit?: number;
             }
-            /** Get */
             interface GetDecorator extends HttpOperationDecorator {
                 KeyParam(name: string, optionsOrType?: StrictOmit<HttpParameter.Options, 'location'> | string | TypeThunkAsync): this;
             }
             interface GetArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
             }
-            /** Replace */
             interface ReplaceDecorator extends HttpOperationDecorator {
                 KeyParam(name: string, optionsOrType?: StrictOmit<HttpParameter.Options, 'location'> | string | TypeThunkAsync): this;
             }
             interface ReplaceArgs extends StrictOmit<HttpOperation.Options, 'method' | 'requestBody'> {
                 type: Type | string;
             }
-            /** Update */
             interface UpdateDecorator extends HttpOperationDecorator {
                 KeyParam(name: string, optionsOrType?: StrictOmit<HttpParameter.Options, 'location'> | string | TypeThunkAsync): this;
                 Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string): this;
@@ -106,7 +98,6 @@ declare module '../http/http-operation.js' {
                     allowPatchOperators?: boolean;
                 };
             }
-            /** UpdateMany */
             interface UpdateManyDecorator extends HttpOperationDecorator {
                 Filter(field: OpraSchema.Field.QualifiedName, operators?: OpraFilter.ComparisonOperator[] | string): this;
                 Filter(field: string, options?: FilterOptions): this;

package/document/decorators/http-operation-entity.decorator.js

@@ -4,7 +4,7 @@ import { FIELD_PATH_PATTERN } from '../data-type/complex-type-base.js';
 import { EnumType } from '../data-type/enum-type.js';
 import { FilterType } from '../data-type/extended-types/index.js';
 import { HttpOperation } from '../http/http-operation.js';
-/** Implementation **/
+/* Implementation **/
 HttpOperation.Entity = {};
 /**
  *

package/document/factory/api-document.factory.js

@@ -82,7 +82,7 @@ export class ApiDocumentFactory {
         document.url = init.url;
         if (init.info)
             document.info = { ...init.info };
-        /** Add references  */
+        /* Add references  */
         if (init.references) {
             await context.enterAsync('.references', async () => {
                 let ns;
@@ -141,7 +141,7 @@ export class ApiDocumentFactory {
             });
         }
         document.invalidate();
-        /** Add document to global registry */
+        /* Add document to global registry */
         if (!this._allDocuments[document.id])
             this._allDocuments[document.id] = document;
     }
@@ -158,7 +158,7 @@ export class ApiDocumentFactory {
                 version: OpraSchema.SpecVersion,
                 title: 'Opra built-in types',
                 license: {
-                    url: 'https://github.com/oprajs/opra/blob/main/LICENSE',
+                    url: 'https://github.com/panates/opra/blob/main/LICENSE',
                     name: 'MIT',
                 },
             },

package/document/factory/data-type.factory.js

@@ -38,9 +38,9 @@ export class DataTypeFactory {
                 return dt;
         }
         if (v) {
-            /** To throw not found error */
+            /* To throw not found error */
             const dt = owner.node.getDataType(v);
-            /** istanbul ignore next */
+            /* istanbul ignore next */
             if (dt)
                 return dt;
         }
@@ -222,7 +222,7 @@ export class DataTypeFactory {
             return context.addError(`No DataType metadata found`);
         }
         return context.enterAsync(metadata.name ? `[${metadata.name}]` : '', async () => {
-            /** Check for circular dependencies */
+            /* Check for circular dependencies */
             if (metadata.name) {
                 const curr = initArgsMap?.get(metadata.name);
                 if (curr) {
@@ -235,7 +235,7 @@ export class DataTypeFactory {
                 kind: metadata.kind,
                 name: metadata.name,
             };
-            /** Mark "out" object as initializing. This will help us to detect circular dependencies */
+            /* Mark "out" object as initializing. This will help us to detect circular dependencies */
             out[initializingSymbol] = true;
             try {
                 if (out.name) {
@@ -274,7 +274,7 @@ export class DataTypeFactory {
                         await this._prepareUnionTypeArgs(context, owner, out, metadata);
                         break;
                     default:
-                        /** istanbul ignore next */
+                        /* istanbul ignore next */
                         return context.addError(`Invalid data type kind ${metadata.kind}`);
                 }
             }
@@ -522,7 +522,7 @@ export class DataTypeFactory {
                 initArgs.base = this._createDataType(context, owner, args.base);
             });
         }
-        /** Set additionalFields */
+        /* Set additionalFields */
         if (args.additionalFields) {
             context.enter('.additionalFields', () => {
                 if (typeof args.additionalFields === 'boolean' ||
@@ -534,7 +534,7 @@ export class DataTypeFactory {
                 }
             });
         }
-        /** Add own fields */
+        /* Add own fields */
         initArgs.fields = {};
         if (args.fields) {
             context.enter('.fields', () => {

package/document/http/http-controller.js

@@ -47,11 +47,11 @@ class HttpControllerClass extends DocumentElement {
     }
     findController(arg0) {
         if (typeof arg0 === 'function') {
-            /** Check for cached mapping */
+            /* Check for cached mapping */
             let controller = this._controllerReverseMap.get(arg0);
             if (controller != null)
                 return controller;
-            /** Lookup for ctor in all controllers */
+            /* Lookup for ctor in all controllers */
             for (const c of this.controllers.values()) {
                 if (c.ctor === arg0) {
                     this._controllerReverseMap.set(arg0, c);

package/document/mq/mq-api.js

@@ -15,11 +15,11 @@ export class MQApi extends ApiBase {
     }
     findController(arg0) {
         if (typeof arg0 === 'function') {
-            /** Check for cached mapping */
+            /* Check for cached mapping */
             const controller = this._controllerReverseMap.get(arg0);
             if (controller != null)
                 return controller;
-            /** Lookup for ctor in all controllers */
+            /* Lookup for ctor in all controllers */
             for (const c of this.controllers.values()) {
                 if (c.ctor === arg0) {
                     this._controllerReverseMap.set(arg0, c);

package/document/ws/ws-api.js

@@ -13,11 +13,11 @@ export class WSApi extends ApiBase {
     }
     findController(arg0) {
         if (typeof arg0 === 'function') {
-            /** Check for cached mapping */
+            /* Check for cached mapping */
             const controller = this._controllerReverseMap.get(arg0);
             if (controller != null)
                 return controller;
-            /** Lookup for ctor in all controllers */
+            /* Lookup for ctor in all controllers */
             for (const c of this.controllers.values()) {
                 if (c.ctor === arg0) {
                     this._controllerReverseMap.set(arg0, c);

package/filter/filter-rules.js

@@ -100,13 +100,13 @@ export class FilterRules {
             return ast;
         }
         if (ast instanceof Literal) {
-            /** Check if comparison expression has in stack */
+            /* Check if comparison expression has in stack */
             const compIdx = stack.findLastIndex(x => x instanceof ComparisonExpression);
             if (compIdx >= 0) {
                 const comp = stack[compIdx];
-                /** If calling for right side of comparison */
+                /* If calling for right side of comparison */
                 if (ast === comp.right || stack[compIdx + 1] === comp.right) {
-                    /** Check if comparison expression left side is a field */
+                    /* Check if comparison expression left side is a field */
                     if (comp &&
                         comp.left instanceof QualifiedIdentifier &&
                         comp.left.field) {

package/helpers/parse-fields-projection.js

@@ -23,7 +23,7 @@ export function parseFieldsProjection(projection, keepCase) {
     return out;
 }
 export function parse(input, target) {
-    /** Add dot before brackets which is required to split fields */
+    /* Add dot before brackets which is required to split fields */
     input = input.replace(NO_DOT_BRACKET_PATTERN, s => s.charAt(0) + '.' + s.substring(1));
     const fields = splitString(input, {
         delimiters: '.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opra/common",
-  "version": "1.26.2",
+  "version": "1.26.4",
   "description": "Opra common package",
   "author": "Panates",
   "license": "MIT",

package/schema/types.d.ts

@@ -1,14 +1,4 @@
 export type HttpMethod = 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'POST' | 'PUT' | 'PATCH' | 'SEARCH';
 export type HttpParameterLocation = 'cookie' | 'header' | 'query' | 'path';
 export type HttpMultipartFieldType = 'field' | 'file';
-export type Transport = 
-/** Custom **/
-'custom'
-/** HTTP **/
- | 'http'
-/** WebSocket*/
- | 'ws'
-/** Message Queue (Kafka, RabbitMQ, MQTT etc) */
- | 'mq'
-/** Remote Procedure Call (gRPC etc) */
- | 'rpc';
+export type Transport = 'custom' | 'http' | 'ws' | 'mq' | 'rpc';