@kaapi/kaapi 0.0.24 → 0.0.25

package/lib/services/docs/docs-modifiers.js

@@ -0,0 +1,430 @@
+"use strict";
+var _SchemaModifier_instances, _a, _SchemaModifier_convertOne, _SchemaModifier_convertMany, _SchemaModifier_convertObjectOf;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupResponseDocsModifier = exports.ContextResponseDocsModifier = exports.ResponseDocsModifier = exports.RequestBodyDocsModifier = exports.MediaTypeModifier = exports.SchemaModifier = exports.ExampleModifier = void 0;
+exports.groupResponses = groupResponses;
+const tslib_1 = require("tslib");
+const deep_extend_1 = require("./deep-extend");
+const api_doc_generator_1 = require("@novice1/api-doc-generator");
+// -------------------- CLASSES --------------------
+class ExampleModifier {
+    constructor(name, example) {
+        this.name = name;
+        if (example) {
+            this.value = example.value;
+            this.externalValue = example.externalValue;
+            this.summary = example.summary;
+            this.description = example.description;
+        }
+    }
+    getName() {
+        return this.name;
+    }
+    setValue(value) {
+        this.value = value;
+        return this;
+    }
+    getValue() {
+        return this.value;
+    }
+    setExternalValue(externalValue) {
+        this.externalValue = externalValue;
+        return this;
+    }
+    getExternalValue() {
+        return this.externalValue;
+    }
+    setSummary(summary) {
+        this.summary = summary;
+        return this;
+    }
+    getSummary() {
+        return this.summary;
+    }
+    setDescription(description) {
+        this.description = description;
+        return this;
+    }
+    getDescription() {
+        return this.description;
+    }
+    ref() {
+        return { $ref: `#/components/examples/${this.name}` };
+    }
+    toObject() {
+        return {
+            description: this.description,
+            externalValue: this.externalValue,
+            summary: this.summary,
+            value: this.value
+        };
+    }
+    toJSON() {
+        return this.toObject();
+    }
+}
+exports.ExampleModifier = ExampleModifier;
+class SchemaModifier {
+    constructor(name, schema) {
+        _SchemaModifier_instances.add(this);
+        this.schema = {};
+        this.name = name;
+        if (schema) {
+            this.setSchema(schema);
+        }
+    }
+    getName() {
+        return this.name;
+    }
+    setSchema(schema) {
+        this.schema = schema;
+        return this;
+    }
+    ref() {
+        return { $ref: `#/components/schemas/${this.name}` };
+    }
+    toObject() {
+        const _b = this.schema, { allOf, anyOf, oneOf, not, items, properties, additionalProperties } = _b, value = tslib_1.__rest(_b, ["allOf", "anyOf", "oneOf", "not", "items", "properties", "additionalProperties"]);
+        const valueToKeep = value;
+        if (allOf) {
+            valueToKeep.allOf = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertMany).call(this, allOf);
+        }
+        if (anyOf) {
+            valueToKeep.anyOf = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertMany).call(this, anyOf);
+        }
+        if (oneOf) {
+            valueToKeep.oneOf = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertMany).call(this, oneOf);
+        }
+        if (not) {
+            valueToKeep.not = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertOne).call(this, not);
+        }
+        if (items) {
+            valueToKeep.items = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertOne).call(this, items);
+        }
+        if (properties) {
+            valueToKeep.properties = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertObjectOf).call(this, properties);
+        }
+        if (typeof additionalProperties !== 'undefined') {
+            if (typeof additionalProperties === 'boolean') {
+                valueToKeep.additionalProperties = additionalProperties;
+            }
+            else {
+                valueToKeep.additionalProperties = tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertOne).call(this, additionalProperties);
+            }
+        }
+        return Object.assign({}, valueToKeep);
+    }
+    toJSON() {
+        return this.toObject();
+    }
+}
+exports.SchemaModifier = SchemaModifier;
+_a = SchemaModifier, _SchemaModifier_instances = new WeakSet(), _SchemaModifier_convertOne = function _SchemaModifier_convertOne(v) {
+    if ('ref' in v && typeof v.ref == 'function') {
+        return v.ref();
+    }
+    else {
+        return new _a('tmp', v).toObject();
+    }
+}, _SchemaModifier_convertMany = function _SchemaModifier_convertMany(v) {
+    const r = [];
+    for (const element of v) {
+        r.push(tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertOne).call(this, element));
+    }
+    return r;
+}, _SchemaModifier_convertObjectOf = function _SchemaModifier_convertObjectOf(v) {
+    const r = {};
+    for (const k in v) {
+        const vk = v[k];
+        r[k] = (tslib_1.__classPrivateFieldGet(this, _SchemaModifier_instances, "m", _SchemaModifier_convertOne).call(this, vk));
+    }
+    return r;
+};
+class MediaTypeModifier extends api_doc_generator_1.MediaTypeUtil {
+    constructor(mediaType) {
+        if (mediaType) {
+            const { examples, schema } = mediaType, rest = tslib_1.__rest(mediaType, ["examples", "schema"]);
+            super(rest);
+            if (examples) {
+                this.setExamples(examples);
+            }
+            if (schema) {
+                this.setSchema(schema);
+            }
+        }
+        else {
+            super();
+        }
+    }
+    setExamples(examples) {
+        this.examples = examples;
+        return this;
+    }
+    setSchema(schema) {
+        this.schema = schema;
+        return this;
+    }
+    toObject(noRef) {
+        const withSchema = {};
+        if (typeof this.schema !== 'undefined') {
+            if (this.schema instanceof SchemaModifier) {
+                withSchema.schema = this.schema.ref();
+            }
+            else {
+                withSchema.schema = new SchemaModifier('tmp', this.schema).toObject();
+            }
+        }
+        if (typeof this.examples !== 'undefined') {
+            withSchema.examples = {};
+            for (const key in this.examples) {
+                const example = this.examples[key];
+                if (example instanceof ExampleModifier) {
+                    if (noRef) {
+                        withSchema.examples[key] = example.toObject();
+                    }
+                    else {
+                        withSchema.examples[key] = example.ref();
+                    }
+                }
+                else {
+                    withSchema.examples[key] = example;
+                }
+            }
+        }
+        const copy = (0, deep_extend_1.deepExtend)(super.toObject(), withSchema);
+        return copy;
+    }
+    toModel() {
+        return Object.assign(Object.assign({}, super.toObject()), { schema: this.schema, examples: this.examples });
+    }
+}
+exports.MediaTypeModifier = MediaTypeModifier;
+class RequestBodyDocsModifier {
+    constructor(name) {
+        this.content = {};
+        this.name = name || this.constructor.name;
+    }
+    /**
+     *
+     * @param description A short description of the response.
+     * CommonMark syntax MAY be used for rich text representation.
+     */
+    setDescription(description) {
+        this.description = description;
+        return this;
+    }
+    setName(name) {
+        this.name = name;
+        return this;
+    }
+    setRequired(isRequired) {
+        this.required = isRequired;
+        return this;
+    }
+    setRef(requestBodyRef) {
+        this.requestBodyRef = requestBodyRef;
+        return this;
+    }
+    getDescription() {
+        return this.description;
+    }
+    getName() {
+        return this.name;
+    }
+    isRequired() {
+        return !!this.required;
+    }
+    addMediaType(contentType, mediaType = {}) {
+        this.content = this.content || {};
+        if (mediaType instanceof MediaTypeModifier) {
+            this.content[contentType] = mediaType;
+        }
+        else {
+            this.content[contentType] = new MediaTypeModifier(mediaType);
+        }
+        return this;
+    }
+    ref() {
+        return { $ref: this.requestBodyRef || `#/components/requestBodies/${this.name}` };
+    }
+    toPostman() {
+        var _b;
+        const result = {};
+        for (const contentType in this.content) {
+            const mediaTypeModel = this.content[contentType].toModel();
+            const contentSchema = mediaTypeModel.schema;
+            result.mode = 'raw';
+            if (contentType === 'multipart/form-data') {
+                result.mode = 'form-data';
+                result.formdata = [];
+                if (contentSchema) {
+                    if (contentSchema instanceof SchemaModifier) {
+                        const rawSchema = contentSchema.toObject();
+                        if (rawSchema.properties) {
+                            for (const key in rawSchema.properties) {
+                                const propSchema = rawSchema.properties[key];
+                                if ('$ref' in propSchema) {
+                                    result.formdata.push({
+                                        key,
+                                        type: 'text'
+                                    });
+                                }
+                                else {
+                                    const fieldType = propSchema.contentMediaType ? 'file' : 'text';
+                                    result.formdata.push({
+                                        key,
+                                        type: fieldType,
+                                        description: propSchema.description,
+                                        src: fieldType === 'file' ? [] : undefined,
+                                        disabled: ((_b = rawSchema.required) === null || _b === void 0 ? void 0 : _b.includes(key)) ? false : true
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            else if (!contentSchema || Object.keys(contentSchema).length === 0) {
+                result.mode = 'file';
+                result.disabled = false;
+            }
+            else {
+                // create raw value
+                if (typeof mediaTypeModel.example !== 'undefined') {
+                    result.raw = `${mediaTypeModel.example}`;
+                }
+                if (typeof mediaTypeModel.examples !== 'undefined' && Object.keys(mediaTypeModel.examples).length !== 0) {
+                    for (const key in mediaTypeModel.examples) {
+                        const example = mediaTypeModel.examples[key];
+                        if (example instanceof ExampleModifier) {
+                            result.raw = `${example.getValue()}`;
+                            break;
+                        }
+                        else if (example && 'value' in example && typeof example.value !== 'undefined') {
+                            result.raw = `${example.value}`;
+                            break;
+                        }
+                    }
+                }
+            }
+            break;
+        }
+        return result;
+    }
+    toOpenAPI() {
+        const content = {};
+        for (const contentType in this.content) {
+            const modifier = this.content[contentType];
+            content[contentType] = modifier.toObject();
+        }
+        const result = {
+            content
+        };
+        if (this.description) {
+            result.description = this.description;
+        }
+        if (this.isRequired()) {
+            result.required = true;
+        }
+        return result;
+    }
+}
+exports.RequestBodyDocsModifier = RequestBodyDocsModifier;
+/**
+ * Set a name (setName) or a ref (setRef) for it to be used as a reference.
+ */
+class ResponseDocsModifier extends api_doc_generator_1.ResponseUtil {
+    constructor(name) {
+        super(name);
+        if (!name)
+            this.setName('');
+    }
+    toOpenAPIRefPreferred(ctxt = {}) {
+        let name = this.name;
+        if (this.code) {
+            name = `${this.code}`;
+        }
+        if (ctxt.code) {
+            name = `${ctxt.code}`;
+        }
+        if (ctxt.default) {
+            name = 'default';
+        }
+        if (this.default) {
+            name = 'default';
+        }
+        if (ctxt.ref) {
+            return {
+                [name]: {
+                    $ref: ctxt.ref
+                }
+            };
+        }
+        if (this.ref) {
+            return {
+                [name]: {
+                    $ref: this.ref
+                }
+            };
+        }
+        if (this.name) {
+            return {
+                [name]: {
+                    $ref: `#/components/responses/${this.name}`
+                }
+            };
+        }
+        return this.toOpenAPI(ctxt);
+    }
+    withContext() {
+        return new ContextResponseDocsModifier(this);
+    }
+}
+exports.ResponseDocsModifier = ResponseDocsModifier;
+class ContextResponseDocsModifier extends api_doc_generator_1.ContextResponseUtil {
+    toOpenAPI() {
+        const ctxt = {};
+        if (this.code) {
+            ctxt.code = this.code;
+        }
+        if (this.ref) {
+            ctxt.ref = this.ref;
+        }
+        if (this.links) {
+            ctxt.links = this.links;
+        }
+        if (this.default) {
+            ctxt.default = this.default;
+        }
+        if (this.responseUtil instanceof ResponseDocsModifier) {
+            return this.responseUtil.toOpenAPIRefPreferred(ctxt);
+        }
+        else {
+            return this.responseUtil.toOpenAPI(ctxt);
+        }
+    }
+}
+exports.ContextResponseDocsModifier = ContextResponseDocsModifier;
+class GroupResponseDocsModifier extends api_doc_generator_1.GroupResponseUtil {
+    constructor(responseUtils) {
+        super(responseUtils);
+        this.responseUtils = responseUtils;
+    }
+    toOpenAPIRefPreferred() {
+        let r = {};
+        this.responseUtils.forEach(builder => {
+            if (builder instanceof ResponseDocsModifier) {
+                r = Object.assign(Object.assign({}, r), builder.toOpenAPIRefPreferred());
+            }
+            else {
+                r = Object.assign(Object.assign({}, r), builder.toOpenAPI());
+            }
+        });
+        return r;
+    }
+}
+exports.GroupResponseDocsModifier = GroupResponseDocsModifier;
+function groupResponses(...modifiers) {
+    return new GroupResponseDocsModifier(modifiers);
+}
+//# sourceMappingURL=docs-modifiers.js.map

package/lib/services/docs/docs-modifiers.js.map

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

package/lib/services/docs/docs.d.ts

@@ -2,9 +2,9 @@ import { ExampleObject, LicenseObject, ReferenceObject, SchemaObject, ServerObje
 import { Folder } from '@novice1/api-doc-generator/lib/generators/postman/definitions';
 import { BaseAuthUtil } from '@novice1/api-doc-generator/lib/utils/auth/baseAuthUtils';
 import { BaseResponseUtil } from '@novice1/api-doc-generator/lib/utils/responses/baseResponseUtils';
-import { OpenAPIOptions, Postman, PostmanOptions } from '@novice1/api-doc-generator';
+import { OpenAPIOptions, PostmanOptions } from '@novice1/api-doc-generator';
 import { SwaggerUiOptions } from './swagger-ui-generator';
-import { KaapiOpenAPI } from './generators';
+import { KaapiOpenAPI, KaapiPostman } from './generators';
 import { HandlerDecorations, Lifecycle, ReqRef, ReqRefDefaults } from '@hapi/hapi';
 import { KaapiServerRoute } from '@kaapi/server';
 export type DocsTag = TagObject & Omit<Folder, 'item'>;
@@ -34,7 +34,7 @@ export interface DocsConfig {
 }
 export declare function createDocsRouter<Refs extends ReqRef = ReqRefDefaults>(path: string, { openapi, postman }: {
     openapi: KaapiOpenAPI;
-    postman: Postman;
+    postman: KaapiPostman;
 }, options?: DocsUIOptions): [
     route: KaapiServerRoute<Refs>,
     handler: HandlerDecorations | Lifecycle.Method<Refs, Lifecycle.ReturnValue<Refs>>

package/lib/services/docs/docs.js.map

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

package/lib/services/docs/generators.d.ts

@@ -1,9 +1,10 @@
-import { OpenAPI, OpenAPIHelperClass, OpenAPIHelperInterface, OpenAPIOptions, OpenAPIResult, Postman, PostmanHelperClass, PostmanOptions, ProcessedRoute } from '@novice1/api-doc-generator';
+import { OpenAPI, OpenAPIHelperClass, OpenAPIHelperInterface, OpenAPIOptions, OpenAPIResult, Postman, PostmanCollection, PostmanHelperClass, PostmanOptions, ProcessedRoute } from '@novice1/api-doc-generator';
 import { KaapiServerRoute } from '@kaapi/server';
 import { type RouteMeta } from '@novice1/routing';
 import { ReqRef, ReqRefDefaults, RequestRoute, ServerAuthConfig } from '@hapi/hapi';
 import { BaseAuthUtil, BaseOpenAPIAuthUtil } from '@novice1/api-doc-generator/lib/utils/auth/baseAuthUtils';
 import { ReferenceObject, SecuritySchemeObject } from '@novice1/api-doc-generator/lib/generators/openapi/definitions';
+import { PostmanRequestBodyModel, RequestBodyDocsModifier } from './modifiers';
 export interface KaapiOpenAPIHelperInterface extends OpenAPIHelperInterface {
     isFile(): boolean | undefined;
     getFilesChildren(): Record<string, unknown>;
@@ -14,18 +15,20 @@ export type KaapiOpenAPIHelperClass = {
         value: unknown;
     }): KaapiOpenAPIHelperInterface;
 };
-export type OpenApiSchemaExtension = {
+export type RouteModifier = {
     path: string;
     method: string;
     definition: object;
+    name?: string | undefined;
+    tags?: string[] | undefined;
 };
 export declare function formatRoutes<Refs extends ReqRef = ReqRefDefaults>(serverRoutes: KaapiServerRoute<Refs>[] | KaapiServerRoute<Refs>, securitySchemes?: Map<string, BaseAuthUtil>, authConfigDefault?: ServerAuthConfig): {
     routes: RouteMeta[];
-    extensions?: OpenApiSchemaExtension[];
+    modifiers?: RouteModifier[];
 };
 export declare function formatRequestRoute<Refs extends ReqRef = ReqRefDefaults>(reqRoute: RequestRoute<Refs>, securitySchemes?: Map<string, BaseAuthUtil>, authConfigDefault?: ServerAuthConfig): {
     routes: RouteMeta[];
-    extensions?: OpenApiSchemaExtension[];
+    modifiers?: RouteModifier[];
 };
 export interface KaapiDocGenerator {
     addRoutes<Refs extends ReqRef = ReqRefDefaults>(serverRoute: KaapiServerRoute<Refs>): ProcessedRoute[];
@@ -55,8 +58,8 @@ export declare class KaapiOpenAPI extends OpenAPI implements KaapiDocGenerator {
      * @override
      */
     result(): OpenAPIResult;
-    extendRoute(path: string, method: string, definition: object): void;
-    addCustom(routes: RouteMeta[], extensions?: OpenApiSchemaExtension[]): ProcessedRoute[];
+    modifyRoute(path: string, method: string, definition: object): void;
+    addCustom(routes: RouteMeta[], modifiers?: RouteModifier[]): ProcessedRoute[];
     getSecuritySchemeUtils(): Map<string, BaseAuthUtil>;
     getSecuritySchemeUtil(name: string): BaseAuthUtil | undefined;
     addHelperClass(helperClass: OpenAPIHelperClass): void;
@@ -64,10 +67,30 @@ export declare class KaapiOpenAPI extends OpenAPI implements KaapiDocGenerator {
     addRoutes<Refs extends ReqRef = ReqRefDefaults>(serverRoutes: KaapiServerRoute<Refs>[] | KaapiServerRoute<Refs>): ProcessedRoute[];
     addRequestRoute<Refs extends ReqRef = ReqRefDefaults>(reqRoute: RequestRoute<Refs>): ProcessedRoute[];
 }
+type ExtensionsByMethod = Record<string, {
+    name?: string | undefined;
+    definition: PostmanRequestBodyModel;
+}>;
+type ExtensionsByPath = Record<string, ExtensionsByMethod>;
 export declare class KaapiPostman extends Postman implements KaapiDocGenerator {
+    protected routeExtensions: {
+        tagged: Record<string, ExtensionsByPath>;
+        notTagged: ExtensionsByPath;
+    };
     constructor(options?: PostmanOptions);
+    /**
+     * @override
+     */
+    removeAll(): ProcessedRoute[];
+    /**
+     * @override
+     */
+    result(): PostmanCollection;
+    modifyRoute(path: string, method: string, definition: RequestBodyDocsModifier, name?: string, tags?: string[] | undefined): void;
+    addCustom(routes: RouteMeta[], modifiers?: RouteModifier[]): ProcessedRoute[];
     addHelperClass(helperClass: PostmanHelperClass): void;
     removeHelperClass(helperClass: PostmanHelperClass): void;
     addRoutes<Refs extends ReqRef = ReqRefDefaults>(serverRoutes: KaapiServerRoute<Refs>[] | KaapiServerRoute<Refs>): ProcessedRoute[];
     addRequestRoute<Refs extends ReqRef = ReqRefDefaults>(reqRoute: RequestRoute<Refs>): ProcessedRoute[];
 }
+export {};