@opra/common 1.0.0-alpha.3 → 1.0.0-alpha.30

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

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const filter_rules_js_1 = require("../../filter/filter-rules.js");
-const index_js_1 = require("../../helpers/index.js");
-const index_js_2 = require("../../http/index.js");
+const index_js_1 = require("../../http/index.js");
 const constants_js_1 = require("../constants.js");
-const index_js_3 = require("../data-type/extended-types/index.js");
-const index_js_4 = require("../data-type/primitive-types/index.js");
+const index_js_2 = require("../data-type/extended-types/index.js");
+const index_js_3 = require("../data-type/primitive-types/index.js");
 const http_operation_js_1 = require("../http/http-operation.js");
 const http_operation_decorator_js_1 = require("./http-operation.decorator.js");
 /** Implementation **/
@@ -22,20 +21,20 @@ http_operation_js_1.HttpOperation.Entity.Create = function (arg0, arg1) {
         args = { ...arg1, type: arg0 };
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'POST',
+        ...args,
         composition: 'Entity.Create',
         requestBody: {
             immediateFetch: true,
             ...args.requestBody,
             required: true,
         },
-    }));
+    });
     decorator
         .QueryParam('projection', {
         description: 'Determines fields projection',
-        type: new index_js_3.FieldPathType({
+        type: new index_js_2.FieldPathType({
             dataType: args.type,
             allowSigns: 'each',
         }),
@@ -43,18 +42,16 @@ http_operation_js_1.HttpOperation.Entity.Create = function (arg0, arg1) {
         arraySeparator: ',',
     })
         .RequestContent(args.requestBody?.type || args.type)
-        .Response(index_js_2.HttpStatusCode.CREATED, {
+        .Response(index_js_1.HttpStatusCode.CREATED, {
         description: 'Operation is successful. Returns OperationResult with "payload" field that contains the created resource.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
         type: args.type,
         partial: 'deep',
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     decoratorChain.push((operationMeta) => {
         const compositionOptions = (operationMeta.compositionOptions = operationMeta.compositionOptions || {});
         compositionOptions.type = getDataTypeName(args.type);
@@ -73,31 +70,42 @@ http_operation_js_1.HttpOperation.Entity.Delete = function (arg0, arg1) {
         args = { ...arg1, type: arg0 };
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'DELETE',
+        ...args,
         composition: 'Entity.Delete',
-    }));
+    });
     decorator
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "affected" field.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     /**
      *
      */
     decorator.KeyParam = (name, prmOptions) => {
-        decorator.PathParam(name, prmOptions);
+        const paramMeta = typeof prmOptions === 'string' || typeof prmOptions === 'function'
+            ? {
+                name,
+                location: 'path',
+                type: prmOptions,
+                keyParam: true,
+            }
+            : {
+                ...prmOptions,
+                name,
+                location: 'path',
+                keyParam: true,
+            };
+        decorator.PathParam(name, paramMeta);
         decoratorChain.push((meta) => {
-            meta.path = (meta.path || '') + '@:' + name;
-            meta.compositionOptions = meta.compositionOptions || {};
-            meta.compositionOptions.keyParameter = name;
+            if (!meta.path?.includes(':' + name))
+                meta.path = (meta.path || '') + '@:' + name;
+            meta.mergePath = true;
         });
         return decorator;
     };
@@ -120,28 +128,26 @@ http_operation_js_1.HttpOperation.Entity.DeleteMany = function (arg0, arg1) {
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
     const filterRules = new filter_rules_js_1.FilterRules();
-    const filterType = new index_js_3.FilterType({ dataType: args.type });
+    const filterType = new index_js_2.FilterType({ dataType: args.type });
     filterType.rules = {};
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'DELETE',
+        ...args,
         composition: 'Entity.DeleteMany',
-    }));
+    });
     decorator
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "affected" field.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
         .QueryParam('filter', {
         type: filterType,
         description: 'Determines filter fields',
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     decoratorChain.push((operationMeta) => {
         const compositionOptions = (operationMeta.compositionOptions = operationMeta.compositionOptions || {});
         compositionOptions.type = getDataTypeName(args.type);
@@ -168,32 +174,32 @@ http_operation_js_1.HttpOperation.Entity.FindMany = function (arg0, arg1) {
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
     const filterRules = new filter_rules_js_1.FilterRules();
-    const filterType = new index_js_3.FilterType({ dataType: args.type });
+    const filterType = new index_js_2.FilterType({ dataType: args.type });
     filterType.rules = {};
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'GET',
+        ...args,
         composition: 'Entity.FindMany',
-    }));
+    });
     decorator
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "payload" field that contains list of resources.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
         type: args.type,
         partial: 'deep',
         isArray: true,
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
         .QueryParam('limit', {
         description: 'Determines number of returning instances',
-        type: new index_js_4.IntegerType({ minValue: 1 }),
+        type: new index_js_3.IntegerType({ minValue: 1, maxValue: args.maxLimit }),
     })
         .QueryParam('skip', {
         description: 'Determines number of returning instances',
-        type: new index_js_4.IntegerType({ minValue: 1 }),
+        type: new index_js_3.IntegerType({ minValue: 1 }),
     })
         .QueryParam('count', {
         description: 'Counts all matching instances if enabled',
@@ -201,7 +207,7 @@ http_operation_js_1.HttpOperation.Entity.FindMany = function (arg0, arg1) {
     })
         .QueryParam('projection', {
         description: 'Determines fields projection',
-        type: new index_js_3.FieldPathType({
+        type: new index_js_2.FieldPathType({
             dataType: args.type,
             allowSigns: 'each',
         }),
@@ -214,18 +220,22 @@ http_operation_js_1.HttpOperation.Entity.FindMany = function (arg0, arg1) {
     })
         .QueryParam('sort', {
         description: 'Determines sort fields',
-        type: new index_js_3.FieldPathType({
+        type: new index_js_2.FieldPathType({
             dataType: args.type,
             allowSigns: 'first',
         }),
         isArray: true,
         arraySeparator: ',',
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     decoratorChain.push((operationMeta) => {
         const compositionOptions = (operationMeta.compositionOptions = operationMeta.compositionOptions || {});
         compositionOptions.type = getDataTypeName(args.type);
+        if (args.defaultLimit)
+            compositionOptions.defaultLimit = args.defaultLimit;
+        if (args.defaultProjection)
+            compositionOptions.defaultProjection = args.defaultProjection;
+        if (args.maxLimit)
+            compositionOptions.maxLimit = args.maxLimit;
     });
     decorator.DefaultSort = (...fields) => {
         decoratorChain.push((operationMeta) => {
@@ -262,45 +272,56 @@ http_operation_js_1.HttpOperation.Entity.Get = function (arg0, arg1) {
         args = { ...arg1, type: arg0 };
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'GET',
+        ...args,
         composition: 'Entity.Get',
-    }));
+    });
     decorator
         .QueryParam('projection', {
         description: 'Determines fields projection',
-        type: new index_js_3.FieldPathType({
+        type: new index_js_2.FieldPathType({
             dataType: args.type,
             allowSigns: 'each',
         }),
         isArray: true,
         arraySeparator: ',',
     })
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "payload" field that contains the resource asked for.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
         type: args.type,
         partial: 'deep',
     })
-        .Response(index_js_2.HttpStatusCode.NO_CONTENT, {
+        .Response(index_js_1.HttpStatusCode.NO_CONTENT, {
         description: 'Operation is successful but no resource found',
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     /**
      *
      */
     decorator.KeyParam = (name, prmOptions) => {
-        decorator.PathParam(name, prmOptions);
+        const paramMeta = typeof prmOptions === 'string' || typeof prmOptions === 'function'
+            ? {
+                name,
+                location: 'path',
+                type: prmOptions,
+                keyParam: true,
+            }
+            : {
+                ...prmOptions,
+                name,
+                location: 'path',
+                keyParam: true,
+            };
+        decorator.PathParam(name, paramMeta);
         decoratorChain.push((meta) => {
-            meta.path = (meta.path || '') + '@:' + name;
-            meta.compositionOptions = meta.compositionOptions || {};
-            meta.compositionOptions.keyParameter = name;
+            if (!meta.path?.includes(':' + name))
+                meta.path = (meta.path || '') + '@:' + name;
+            meta.mergePath = true;
         });
         return decorator;
     };
@@ -322,12 +343,12 @@ http_operation_js_1.HttpOperation.Entity.UpdateMany = function (arg0, arg1) {
         args = { ...arg1, type: arg0 };
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
-    const filterType = new index_js_3.FilterType({ dataType: args.type });
+    const filterType = new index_js_2.FilterType({ dataType: args.type });
     filterType.rules = {};
     const filterRules = new filter_rules_js_1.FilterRules();
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'PATCH',
+        ...args,
         composition: 'Entity.UpdateMany',
         requestBody: {
             immediateFetch: true,
@@ -335,18 +356,16 @@ http_operation_js_1.HttpOperation.Entity.UpdateMany = function (arg0, arg1) {
             ...args.requestBody,
             required: true,
         },
-    }));
-    decorator.RequestContent(args.requestBody?.type || args.type);
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
+    });
     decorator
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .RequestContent(args.requestBody?.type || args.type)
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "affected" field.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     })
         .QueryParam('filter', {
         type: filterType,
@@ -378,11 +397,11 @@ http_operation_js_1.HttpOperation.Entity.Update = function (arg0, arg1) {
     /** Initialize the decorator and the chain */
     const decoratorChain = [];
     const filterRules = new filter_rules_js_1.FilterRules();
-    const filterType = new index_js_3.FilterType({ dataType: args.type });
+    const filterType = new index_js_2.FilterType({ dataType: args.type });
     filterType.rules = {};
-    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, (0, index_js_1.omitUndefined)({
-        description: args.description,
+    const decorator = (0, http_operation_decorator_js_1.HttpOperationDecoratorFactory)(decoratorChain, {
         method: 'PATCH',
+        ...args,
         composition: 'Entity.Update',
         requestBody: {
             partial: 'deep',
@@ -390,11 +409,11 @@ http_operation_js_1.HttpOperation.Entity.Update = function (arg0, arg1) {
             ...args.requestBody,
             required: true,
         },
-    }));
+    });
     decorator
         .QueryParam('projection', {
         description: 'Determines fields projection',
-        type: new index_js_3.FieldPathType({
+        type: new index_js_2.FieldPathType({
             dataType: args.type,
             allowSigns: 'each',
         }),
@@ -406,30 +425,41 @@ http_operation_js_1.HttpOperation.Entity.Update = function (arg0, arg1) {
         description: 'Determines filter fields',
     })
         .RequestContent(args.requestBody?.type || args.type)
-        .Response(index_js_2.HttpStatusCode.OK, {
+        .Response(index_js_1.HttpStatusCode.OK, {
         description: 'Operation is successful. Returns OperationResult with "payload" field that contains updated resource.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
         type: args.type,
         partial: 'deep',
     })
-        .Response(index_js_2.HttpStatusCode.NO_CONTENT, {
+        .Response(index_js_1.HttpStatusCode.NO_CONTENT, {
         description: 'Operation is successful but no resource found',
     })
-        .Response(index_js_2.HttpStatusCode.UNPROCESSABLE_ENTITY, {
+        .Response(index_js_1.HttpStatusCode.UNPROCESSABLE_ENTITY, {
         description: 'The request was well-formed but was unable to process operation due to one or many errors.',
-        contentType: index_js_2.MimeTypes.opra_response_json,
+        contentType: index_js_1.MimeTypes.opra_response_json,
     });
-    if (typeof args.type === 'function')
-        decorator.UseType(args.type);
     /**
      *
      */
     decorator.KeyParam = (name, prmOptions) => {
-        decorator.PathParam(name, prmOptions);
+        const paramMeta = typeof prmOptions === 'string' || typeof prmOptions === 'function'
+            ? {
+                name,
+                location: 'path',
+                type: prmOptions,
+                keyParam: true,
+            }
+            : {
+                ...prmOptions,
+                name,
+                location: 'path',
+                keyParam: true,
+            };
+        decorator.PathParam(name, paramMeta);
         decoratorChain.push((meta) => {
-            meta.path = (meta.path || '') + '@:' + name;
-            meta.compositionOptions = meta.compositionOptions || {};
-            meta.compositionOptions.keyParameter = name;
+            if (!meta.path?.includes(':' + name))
+                meta.path = (meta.path || '') + '@:' + name;
+            meta.mergePath = true;
         });
         return decorator;
     };

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpOperationDecoratorFactory = void 0;
+exports.HttpOperationDecoratorFactory = HttpOperationDecoratorFactory;
 const tslib_1 = require("tslib");
 const lodash_omit_1 = tslib_1.__importDefault(require("lodash.omit"));
 const index_js_1 = require("../../http/index.js");
@@ -37,8 +37,9 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
                     type: arg1,
                 }
                 : { ...arg1, name, location: 'cookie' };
-            if (meta.parameters)
+            if (meta.parameters) {
                 meta.parameters = meta.parameters.filter(p => !(p.location === 'cookie' && String(p.name) === String(name)));
+            }
             else
                 meta.parameters = [];
             meta.parameters.push(paramMeta);
@@ -57,8 +58,9 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
                     type: arg1,
                 }
                 : { ...arg1, name, location: 'header' };
-            if (meta.parameters)
+            if (meta.parameters) {
                 meta.parameters = meta.parameters.filter(p => !(p.location === 'header' && String(p.name) === String(name)));
+            }
             else
                 meta.parameters = [];
             meta.parameters.push(paramMeta);
@@ -77,8 +79,9 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
                     type: arg1,
                 }
                 : { ...arg1, name, location: 'query' };
-            if (meta.parameters)
+            if (meta.parameters) {
                 meta.parameters = meta.parameters.filter(p => !(p.location === 'query' && String(p.name) === String(name)));
+            }
             else
                 meta.parameters = [];
             meta.parameters.push(paramMeta);
@@ -97,8 +100,9 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
                     type: arg1,
                 }
                 : { ...arg1, name, location: 'path' };
-            if (meta.parameters)
+            if (meta.parameters) {
                 meta.parameters = meta.parameters.filter(p => !(p.location === 'path' && String(p.name) === String(name)));
+            }
             else
                 meta.parameters = [];
             meta.parameters.push(paramMeta);
@@ -114,6 +118,9 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
             responseMeta.contentType = responseMeta.contentType || index_js_1.MimeTypes.opra_response_json;
             responseMeta.contentEncoding = responseMeta.contentEncoding || 'utf-8';
         }
+        if (responseMeta.contentType === index_js_1.MimeTypes.opra_response_json) {
+            responseMeta.contentEncoding = responseMeta.contentEncoding || 'utf-8';
+        }
         decoratorChain.push((meta) => {
             meta.responses = meta.responses || [];
             meta.responses.push(responseMeta);
@@ -180,4 +187,3 @@ function HttpOperationDecoratorFactory(decoratorChain, options) {
     };
     return decorator;
 }
-exports.HttpOperationDecoratorFactory = HttpOperationDecoratorFactory;

package/cjs/document/decorators/simple-type.decorator.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AttributeDecoratorFactory = exports.SimpleTypeDecoratorFactory = void 0;
+exports.SimpleTypeDecoratorFactory = SimpleTypeDecoratorFactory;
+exports.AttributeDecoratorFactory = AttributeDecoratorFactory;
 const tslib_1 = require("tslib");
 const lodash_omit_1 = tslib_1.__importDefault(require("lodash.omit"));
 const index_js_1 = require("../../schema/index.js");
@@ -42,7 +43,6 @@ function SimpleTypeDecoratorFactory(options) {
     };
     return decorator;
 }
-exports.SimpleTypeDecoratorFactory = SimpleTypeDecoratorFactory;
 function AttributeDecoratorFactory(options) {
     return (target, propertyKey) => {
         if (typeof propertyKey !== 'string')
@@ -64,4 +64,3 @@ function AttributeDecoratorFactory(options) {
         Reflect.defineMetadata(constants_js_1.DATATYPE_METADATA, metadata, target.constructor);
     };
 }
-exports.AttributeDecoratorFactory = AttributeDecoratorFactory;

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

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiDocumentFactory = void 0;
-const tslib_1 = require("tslib");
-const node_crypto_1 = tslib_1.__importDefault(require("node:crypto"));
-const ts_gems_1 = require("ts-gems");
 const index_js_1 = require("../../helpers/index.js");
 const index_js_2 = require("../../schema/index.js");
 const api_document_js_1 = require("../api-document.js");
@@ -46,9 +43,7 @@ class ApiDocumentFactory {
                 context.error.message = `(${l}) error${l > 1 ? 's' : ''} found in document schema.`;
                 if (context.showErrorDetails) {
                     context.error.message += context.error.details
-                        .map(d => {
-                        return `\n\n  - ${d.message}` + (d.path ? `\n    @${d.path}` : '');
-                    })
+                        .map(d => `\n\n  - ${d.message}` + (d.path ? `\n    @${d.path}` : ''))
                         .join('');
                 }
             }
@@ -70,9 +65,14 @@ class ApiDocumentFactory {
         else
             init = schemaOrUrl;
         // Add builtin data types if this document is the root
+        let builtinDocument;
         if (!document[constants_js_1.BUILTIN]) {
-            const builtinDocument = await this.createBuiltinDocument(context);
-            document.references.set('opra', builtinDocument);
+            const t = document.node.findDataType('string');
+            builtinDocument = t?.node.getDocument();
+            if (!builtinDocument) {
+                builtinDocument = await this.createBuiltinDocument(context);
+                document.references.set('opra', builtinDocument);
+            }
         }
         init.spec = init.spec || index_js_2.OpraSchema.SpecVersion;
         document.url = init.url;
@@ -93,8 +93,12 @@ class ApiDocumentFactory {
                             return;
                         }
                         const refDoc = new api_document_js_1.ApiDocument();
+                        if (builtinDocument)
+                            refDoc.references.set('opra', builtinDocument);
                         await this.initDocument(refDoc, context, r);
-                        document.references.set(ns, refDoc);
+                        /** If same document already exists in document tree, we use it except the new one */
+                        const preDoc = document.findDocument(refDoc.id);
+                        document.references.set(ns, preDoc || refDoc);
                     });
                 }
             });
@@ -115,8 +119,7 @@ class ApiDocumentFactory {
                     context.addError(`Unknown service protocol (${init.api.protocol})`);
             });
         }
-        const x = document.export();
-        (0, ts_gems_1.asMutable)(document).id = node_crypto_1.default.createHash('md5').update(JSON.stringify(x)).digest('base64url');
+        document.invalidate();
     }
     /**
      *