@trayio/tray-openapi 2.11.0 → 2.12.0

package/README.md

@@ -0,0 +1,39 @@
+This module speeds up the development process of creating a new Tray CDK connector by parsing an OpenAPI specification file for a given API and generating operation handlers, meta data, input and output types.
+
+This beta functionality is available from the @trayio/cdk-cli module via the `tray-cdk import-openapi-spec` command. If you encounter any issues that you wish the team to investigate further please supply us with OpenApi specification you are importing and the `errors.json` that has been generated during the import process.
+
+These are the features that are currently supported/unsupported:
+- OpenAPI spec interpretation:
+    - Supported:
+        - schema internal component references
+        - JSON OpenAPI specification version 3
+        - If your version is older you can use this to update it: [Swagger Editor](https://editor.swagger.io/) (From the top menu bar, select edit, convert to Open API 3, you can also use this to convert from YAML to JSON)
+    - Unsupported:
+        - Swagger API version 2
+        - YAML spec files
+        - open API specs with multiple server URLs, manually edit the file to set your desired server to the first in the array
+        - recursive schema references
+        - external schema references
+        - schema references that target nested components
+- Authentication
+    - Unsupported:
+        - generation of Auth type
+        - handlers utilising the auth token in handlers
+- Input/output types:
+    - Supported:
+        - Primitive types: number, string, boolean
+        - Objects
+        - 2XX response schemas
+        - Empty input/output
+    - Unsupported:
+        - enum types
+        - array types
+        - non 2XX response schemas
+- Request/Response types:
+    - Supported:
+        - Json request/response
+    - Unsupported:
+        - xml request/response
+        - text request/response
+        - file request/response
+        - form request/response

package/dist/OpenApiSchemaImporter.d.ts

@@ -1,22 +1,7 @@
 import * as TE from 'fp-ts/TaskEither';
 import { FileStorage } from '@trayio/commons/file/File';
 import { Generator } from '@trayio/generator/generator/Generator';
-import { OpenApiHttpMethod } from './OpenApiTypeDescriptors';
-type BaseOperation = {
-    httpMethod: OpenApiHttpMethod;
-    path: string;
-};
-type OperationError = BaseOperation & {
-    tag: 'error';
-    errorMessage: string;
-};
-type OperationSuccess = BaseOperation & {
-    tag: 'success';
-};
-export type BuildConnectorResponse = {
-    successes: OperationSuccess[];
-    errors: OperationError[];
-};
+import { BuildConnectorResponse } from './OpenApiTypeDescriptors';
 export declare class OpenApiSchemaImporter {
     private generator;
     private fileStorage;
@@ -29,5 +14,4 @@ export declare class OpenApiSchemaImporter {
     private generateConnectorDirectory;
     private generateOperationDirectory;
 }
-export {};
 //# sourceMappingURL=OpenApiSchemaImporter.d.ts.map

package/dist/OpenApiSchemaImporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiSchemaImporter.d.ts","sourceRoot":"","sources":["../src/OpenApiSchemaImporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASvC,OAAO,EAAQ,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGlE,OAAO,EACN,iBAAiB,EAGjB,MAAM,0BAA0B,CAAC;AAgClC,KAAK,aAAa,GAAG;IACpB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,KAAK,cAAc,GAAG,aAAa,GAAG;IACrC,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,gBAAgB,GAAG,aAAa,GAAG;IACvC,GAAG,EAAE,SAAS,CAAC;CACf,CAAC;AAIF,MAAM,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,qBAAa,qBAAqB;IACrB,OAAO,CAAC,SAAS;IAAa,OAAO,CAAC,WAAW;gBAAzC,SAAS,EAAE,SAAS,EAAU,WAAW,EAAE,WAAW;IAE1E,cAAc,CACb,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACnB,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,sBAAsB,CAAC;IAqD/C,OAAO,CAAC,yBAAyB;IAyDjC,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,oCAAoC;IAgF5C,OAAO,CAAC,0BAA0B;IAwBlC,OAAO,CAAC,0BAA0B;CAclC"}
+{"version":3,"file":"OpenApiSchemaImporter.d.ts","sourceRoot":"","sources":["../src/OpenApiSchemaImporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASvC,OAAO,EAAQ,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGlE,OAAO,EAEN,sBAAsB,EAMtB,MAAM,0BAA0B,CAAC;AAalC,qBAAa,qBAAqB;IACrB,OAAO,CAAC,SAAS;IAAa,OAAO,CAAC,WAAW;gBAAzC,SAAS,EAAE,SAAS,EAAU,WAAW,EAAE,WAAW;IAE1E,cAAc,CACb,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACnB,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,sBAAsB,CAAC;IAoD/C,OAAO,CAAC,yBAAyB;IAyDjC,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,oCAAoC;IAgF5C,OAAO,CAAC,0BAA0B;IAwBlC,OAAO,CAAC,0BAA0B;CAclC"}

package/dist/OpenApiSchemaImporter.js

@@ -33,8 +33,8 @@ const Apply_1 = require("fp-ts/Apply");
 const json_ref_resolver_1 = require("@stoplight/json-ref-resolver");
 const StringExtensions_1 = require("@trayio/commons/string/StringExtensions");
 const lodash_1 = require("lodash");
-const stream_1 = require("stream");
 const BufferExtensions_1 = require("@trayio/commons/buffer/BufferExtensions");
+const stream_1 = require("stream");
 const OpenApiCodecs_1 = require("./OpenApiCodecs");
 const GenerateHandler_1 = require("./file-generators/GenerateHandler");
 const GenerateOutput_1 = require("./file-generators/types/GenerateOutput");
@@ -42,6 +42,7 @@ const GenerateInputTypes_1 = require("./file-generators/types/GenerateInputTypes
 const GenerateHandlerTest_1 = require("./file-generators/GenerateHandlerTest");
 const GenerateOperationJson_1 = require("./file-generators/GenerateOperationJson");
 const GenerateInputSchema_1 = require("./file-generators/types/GenerateInputSchema");
+const OpenApiSchemaTransformer_1 = require("./OpenApiSchemaTransformer");
 class OpenApiSchemaImporter {
     constructor(generator, fileStorage) {
         this.generator = generator;
@@ -60,7 +61,6 @@ class OpenApiSchemaImporter {
                 })),
             })));
         }), TE.chain(({ openApiSpec, connectorPath, paths }) => (0, Array_1.traverse)(TE.ApplicativeSeq)((path) => this.generateOperationFromPath(path, connectorPath, openApiSpec.servers[0].url, connectorName))(paths)), TE.map((operation) => {
-            console.log(operation);
             const flatOperations = operation.flat();
             const buildConnectorResponse = flatOperations.reduce((acc, curr) => {
                 if (curr.tag === 'error') {
@@ -72,7 +72,7 @@ class OpenApiSchemaImporter {
         }));
     }
     generateOperationFromPath(path, connectorPath, baseUrl, connectorName) {
-        return (0, function_1.pipe)((0, Array_1.traverse)(TE.ApplicativeSeq)((route) => (0, function_1.pipe)(this.decodeOperation(route.path, path.path, route.method), TE.bindTo('decodedPath'), TE.chain(({ decodedPath }) => (0, function_1.pipe)(this.generateOperationDirectory(connectorPath, decodedPath.operationId), TE.bind('inputs', () => TE.right((0, GenerateInputSchema_1.generateInputSchema)(decodedPath))), TE.bind('outputs', () => (0, GenerateOutput_1.generateOutputSchema)(decodedPath.responses)), TE.bind('decodedPath', () => TE.right(decodedPath)))), TE.chain(({ inputs, outputs, decodedPath }) => this.generateHandlerFilesAndOperationJson(route.method, decodedPath, `${connectorPath}/src/${(0, lodash_1.kebabCase)(decodedPath.operationId)}`, baseUrl, path.path, connectorName, inputs, outputs)), TE.map(() => ({
+        return (0, function_1.pipe)((0, Array_1.traverse)(TE.ApplicativeSeq)((route) => (0, function_1.pipe)(this.decodeOperation(route.path, path.path, route.method), TE.bindTo('decodedPath'), TE.chain(({ decodedPath }) => (0, function_1.pipe)(this.generateOperationDirectory(connectorPath, decodedPath.operationId), TE.bind('inputs', () => TE.fromEither((0, GenerateInputSchema_1.generateInputSchema)(decodedPath))), TE.bind('outputs', () => (0, GenerateOutput_1.generateOutputSchema)(decodedPath.responses)), TE.bind('decodedPath', () => TE.right(decodedPath)))), TE.chain(({ inputs, outputs, decodedPath }) => this.generateHandlerFilesAndOperationJson(route.method, decodedPath, `${connectorPath}/src/${(0, lodash_1.kebabCase)(decodedPath.operationId)}`, baseUrl, path.path, connectorName, inputs, outputs)), TE.map(() => ({
             tag: 'success',
             httpMethod: route.method,
             path: path.path,
@@ -91,7 +91,7 @@ class OpenApiSchemaImporter {
             const resolver = new json_ref_resolver_1.Resolver({});
             const resolvedOpenApiSpec = resolver.resolve(openApiSpec, {});
             return resolvedOpenApiSpec;
-        }, (reason) => new Error(`Failed to resolve references in schema: ${reason}`))), TE.chain((openApiSpec) => TE.right(openApiSpec.result)));
+        }, (reason) => new Error(`Failed to resolve references in schema: ${reason}`))), TE.chain((openApiSpec) => TE.fromEither((0, OpenApiSchemaTransformer_1.mergePathLevelParamsIntoHttpMethod)(openApiSpec.result))));
     }
     generateHandlerFilesAndOperationJson(method, path, operationPath, baseUrl, httpPath, connectorName, input, output) {
         const writeFile = (content, fileName) => this.fileStorage.write({
@@ -129,7 +129,7 @@ class OpenApiSchemaImporter {
             connectorNameKebabCase: (0, lodash_1.kebabCase)(connectorName),
             connectorNamePascalCase: StringExtensions_1.StringExtensions.pascalCase(connectorName),
             connectorNameCamelCase: (0, lodash_1.camelCase)(connectorName),
-        }), TE.chain((parameters) => this.generator.generate(`${__dirname}/templates/connector-template.zip`, `${process.cwd()}/test`, parameters)), TE.map(() => `/test/${(0, lodash_1.kebabCase)(connectorName)}`), TE.mapLeft((error) => new Error(`Failed to generate connector directory: ${error}`)));
+        }), TE.chain((parameters) => this.generator.generate(`${__dirname}/templates/connector-template.zip`, process.cwd(), parameters)), TE.map(() => `/${(0, lodash_1.kebabCase)(connectorName)}`), TE.mapLeft((error) => new Error(`Failed to generate connector directory: ${error}`)));
     }
     generateOperationDirectory(connectorPath, operationName) {
         return (0, function_1.pipe)(TE.tryCatch(this.fileStorage.createDirectory(`${connectorPath}/src/${(0, lodash_1.kebabCase)(operationName)}`), (error) => new Error(`Failed to create operation directory: ${error}`)), TE.map(() => `${connectorPath}/src/${(0, lodash_1.kebabCase)(operationName)}`));

package/dist/OpenApiSchemaImporter.test.js

@@ -44,40 +44,42 @@ describe('openApiSchemaImporter', () => {
     const fileStorage = new FakeFileStorage_1.FakeFileStorage();
     const openApiSchemaImporter = new OpenApiSchemaImporter_1.OpenApiSchemaImporter(generator, fileStorage);
     let result;
+    const spec = 'test-openapi-spec.json';
     beforeAll(() => __awaiter(void 0, void 0, void 0, function* () {
         fileStorage.write({
-            key: `${__dirname}/test-openapi-spec.json`,
-            metadata: { name: 'test-openapi-spec.json' },
+            key: `${__dirname}/${spec}`,
+            metadata: { name: spec },
             content: stream_1.Readable.from(Buffer.from(JSON.stringify(openApiSpec))),
         });
-        result = yield openApiSchemaImporter.buildConnector(`${__dirname}/test-openapi-spec.json`, 'testConnector')();
+        result = yield openApiSchemaImporter.buildConnector(`${__dirname}/${spec}`, 'testConnector')();
     }));
     afterAll(() => __awaiter(void 0, void 0, void 0, function* () {
         yield fs.rm(`${process.cwd()}/test/`, { recursive: true, force: true });
     }));
     it('should import successfully', () => {
         const buildConnectorResponse = E.getOrElse((error) => {
+            console.error(error);
             throw new Error('Should have been right');
         })(result);
         expect(buildConnectorResponse.successes.length).toEqual(1);
         expect(buildConnectorResponse.errors.length).toEqual(1);
     });
     it('should generate a operation handler', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/get-post/handler.ts`)).toEqual(true);
+        expect(fileStorage.files.has(`/test-connector/src/get-post/handler.ts`)).toEqual(true);
     });
     it('should generate an operation handler test', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/get-post/handler.test.ts`)).toEqual(true);
+        expect(fileStorage.files.has(`/test-connector/src/get-post/handler.test.ts`)).toEqual(true);
     });
     it('should generate an operation.json', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/get-post/operation.json`)).toEqual(true);
+        expect(fileStorage.files.has(`/test-connector/src/get-post/operation.json`)).toEqual(true);
     });
     it('should generate an output.ts', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/get-post/output.ts`)).toEqual(true);
+        expect(fileStorage.files.has(`/test-connector/src/get-post/output.ts`)).toEqual(true);
     });
     it('should generate a operation directory', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/get-post`)).toEqual(true);
+        expect(fileStorage.files.has(`/test-connector/src/get-post`)).toEqual(true);
     });
     it('should not generate a operation directory when failing to decode', () => {
-        expect(fileStorage.files.has(`/test/test-connector/src/update-post`)).toEqual(false);
+        expect(fileStorage.files.has(`/test-connector/src/update-post`)).toEqual(false);
     });
 });

package/dist/OpenApiSchemaTransformer.d.ts

@@ -0,0 +1,9 @@
+import * as E from 'fp-ts/Either';
+import { BaseOpenApiSpec } from './OpenApiTypeDescriptors';
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isObjectWithParameters: (value: unknown) => value is Record<string, unknown> & {
+    parameters: unknown[];
+};
+export declare const getMergedParameters: (pathValue: Record<string, unknown>, httpMethodValue: Record<string, unknown>) => unknown[];
+export declare const mergePathLevelParamsIntoHttpMethod: (openApiSpec: BaseOpenApiSpec) => E.Either<Error, BaseOpenApiSpec>;
+//# sourceMappingURL=OpenApiSchemaTransformer.d.ts.map

package/dist/OpenApiSchemaTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiSchemaTransformer.d.ts","sourceRoot":"","sources":["../src/OpenApiSchemaTransformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,eAAO,MAAM,QAAQ,UAAW,OAAO,qCACK,CAAC;AAE7C,eAAO,MAAM,sBAAsB,UAC3B,OAAO;gBACqC,OAAO,EAAE;CACpB,CAAC;AAE1C,eAAO,MAAM,mBAAmB,cACpB,OAAO,MAAM,EAAE,OAAO,CAAC,mBACjB,OAAO,MAAM,EAAE,OAAO,CAAC,KACtC,OAAO,EAcT,CAAC;AAEF,eAAO,MAAM,kCAAkC,gBACjC,eAAe,KAC1B,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,CAkCjC,CAAC"}

package/dist/OpenApiSchemaTransformer.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePathLevelParamsIntoHttpMethod = exports.getMergedParameters = exports.isObjectWithParameters = exports.isObject = void 0;
+const E = __importStar(require("fp-ts/Either"));
+const isObject = (value) => typeof value === 'object' && value !== null;
+exports.isObject = isObject;
+const isObjectWithParameters = (value) => (0, exports.isObject)(value) && 'parameters' in value;
+exports.isObjectWithParameters = isObjectWithParameters;
+const getMergedParameters = (pathValue, httpMethodValue) => {
+    if (!Array.isArray(pathValue.parameters)) {
+        throw new Error('Path parameters is not an array');
+    }
+    // if the method contains existing parameters, we merge them with the path parameters
+    if ('parameters' in httpMethodValue &&
+        Array.isArray(httpMethodValue.parameters)) {
+        return [...httpMethodValue.parameters, ...pathValue.parameters];
+    }
+    return pathValue.parameters;
+};
+exports.getMergedParameters = getMergedParameters;
+const mergePathLevelParamsIntoHttpMethod = (openApiSpec) => {
+    const paths = Object.entries(openApiSpec.paths).reduce((pathAcc, [pathName, pathValue]) => {
+        // if the path doesn't contain top level params, we just return it
+        if (!(0, exports.isObjectWithParameters)(pathValue)) {
+            pathAcc[pathName] = pathValue;
+            return pathAcc;
+        }
+        const updatedPathValue = Object.entries(pathValue).reduce((methodAcc, [httpMethodName, httpMethodValue]) => {
+            if (!(0, exports.isObject)(httpMethodValue)) {
+                throw new Error('Http method value is not an object');
+            }
+            // we skip adding the parameters object to the path object
+            if (httpMethodName === 'parameters') {
+                return methodAcc;
+            }
+            const parameters = (0, exports.getMergedParameters)(pathValue, httpMethodValue);
+            methodAcc[httpMethodName] = Object.assign(Object.assign({}, httpMethodValue), { parameters });
+            return methodAcc;
+        }, {});
+        pathAcc[pathName] = updatedPathValue;
+        return pathAcc;
+    }, {});
+    return E.right(Object.assign(Object.assign({}, openApiSpec), { paths }));
+};
+exports.mergePathLevelParamsIntoHttpMethod = mergePathLevelParamsIntoHttpMethod;

package/dist/OpenApiSchemaTransformer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OpenApiSchemaTransformer.test.d.ts.map

package/dist/OpenApiSchemaTransformer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiSchemaTransformer.test.d.ts","sourceRoot":"","sources":["../src/OpenApiSchemaTransformer.test.ts"],"names":[],"mappings":""}

package/dist/OpenApiSchemaTransformer.test.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const E = __importStar(require("fp-ts/Either"));
+const OpenApiSchemaTransformer_1 = require("./OpenApiSchemaTransformer");
+describe('mergePathLevelParamsIntoHttpMethod', () => {
+    it('should merge path level parameters into HTTP methods', () => {
+        const openApiSpec = {
+            openapi: '3.0.0',
+            info: {
+                version: '1.0.0',
+                title: 'JSON Placeholder API',
+                description: 'See https://jsonplaceholder.typicode.com/',
+            },
+            servers: [
+                {
+                    url: 'https://jsonplaceholder.typicode.com',
+                },
+            ],
+            paths: {
+                '/path': {
+                    parameters: [{ name: 'param1', in: 'query', required: false }],
+                    get: {
+                        parameters: [{ name: 'param2', in: 'query', required: true }],
+                    },
+                },
+            },
+        };
+        const result = (0, OpenApiSchemaTransformer_1.mergePathLevelParamsIntoHttpMethod)(openApiSpec);
+        E.fold((error) => {
+            throw new Error(`Test failed with error: ${error.message}`);
+        }, (updatedOpenApiSpec) => {
+            expect(updatedOpenApiSpec.paths['/path'].get.parameters).toEqual([
+                { name: 'param2', in: 'query', required: true },
+                { name: 'param1', in: 'query', required: false },
+            ]);
+        })(result);
+    });
+    it('should return the original spec if no top level parameters', () => {
+        const openApiSpec = {
+            openapi: '3.0.0',
+            info: {
+                version: '1.0.0',
+                title: 'JSON Placeholder API',
+                description: 'See https://jsonplaceholder.typicode.com/',
+            },
+            servers: [
+                {
+                    url: 'https://jsonplaceholder.typicode.com',
+                },
+            ],
+            paths: {
+                '/path': {
+                    get: {
+                        parameters: [{ name: 'param2', in: 'query', required: true }],
+                    },
+                },
+            },
+        };
+        const result = (0, OpenApiSchemaTransformer_1.mergePathLevelParamsIntoHttpMethod)(openApiSpec);
+        E.fold((error) => {
+            throw new Error(`Test failed with error: ${error.message}`);
+        }, (updatedOpenApiSpec) => {
+            expect(updatedOpenApiSpec).toEqual(openApiSpec);
+        })(result);
+    });
+    it('should add path level parameters into HTTP methods, if no method params already exist', () => {
+        const openApiSpec = {
+            openapi: '3.0.0',
+            info: {
+                version: '1.0.0',
+                title: 'JSON Placeholder API',
+                description: 'See https://jsonplaceholder.typicode.com/',
+            },
+            servers: [
+                {
+                    url: 'https://jsonplaceholder.typicode.com',
+                },
+            ],
+            paths: {
+                '/path': {
+                    parameters: [{ name: 'param1', in: 'query', required: false }],
+                    get: {},
+                },
+            },
+        };
+        const result = (0, OpenApiSchemaTransformer_1.mergePathLevelParamsIntoHttpMethod)(openApiSpec);
+        E.fold((error) => {
+            throw new Error(`Test failed with error: ${error.message}`);
+        }, (updatedOpenApiSpec) => {
+            expect(updatedOpenApiSpec.paths['/path'].get.parameters).toEqual([
+                { name: 'param1', in: 'query', required: false },
+            ]);
+        })(result);
+    });
+});

package/dist/OpenApiTypeDescriptors.d.ts

@@ -1,5 +1,41 @@
 import * as t from 'io-ts';
 import * as O from 'fp-ts/Option';
+export type FlatPath = {
+    path: string;
+    routes: {
+        method: OpenApiHttpMethod;
+        path: unknown;
+    }[];
+};
+export type Server = {
+    url: string;
+};
+export type BaseOpenApiSpec = {
+    openapi: string;
+    info: {
+        version: string;
+        title: string;
+        description: string;
+    };
+    servers: Server[];
+    paths: Record<string, Record<string, unknown>>;
+};
+export type BaseOperation = {
+    httpMethod: OpenApiHttpMethod;
+    path: string;
+};
+export type OperationError = BaseOperation & {
+    tag: 'error';
+    errorMessage: string;
+};
+export type OperationSuccess = BaseOperation & {
+    tag: 'success';
+};
+export type Operation = OperationError | OperationSuccess;
+export type BuildConnectorResponse = {
+    successes: OperationSuccess[];
+    errors: OperationError[];
+};
 export type Path = {
     description: string;
     tags: O.Option<string[]>;
@@ -12,12 +48,8 @@ export type Parameter = {
     name: string;
     in: string;
     description: string;
-    required: boolean;
-    schema: {
-        type: string;
-        format: O.Option<string>;
-        items: O.Option<SchemaObject>;
-    };
+    required: O.Option<boolean>;
+    schema: SchemaObject;
 };
 export type RequestBody = {
     content: Record<string, MediaTypeObject>;
@@ -57,6 +89,7 @@ export interface NonArraySchemaObject extends BaseSchemaObject {
     type: O.Option<NonArraySchemaObjectType>;
 }
 export type BaseSchemaObject = {
+    title: O.Option<string>;
     additionalProperties: O.Option<boolean | SchemaObject>;
     properties: O.Option<Record<string, SchemaObject>>;
     required: O.Option<string[]>;

package/dist/OpenApiTypeDescriptors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiTypeDescriptors.d.ts","sourceRoot":"","sources":["../src/OpenApiTypeDescriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,OAAO,CAAC;AAE3B,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAGlC,MAAM,MAAM,IAAI,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;KAC9B,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEjD,MAAM,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E,KAAK,eAAe,GAAG;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAChE,UAAU,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAEpE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IAC1D,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,wBAAwB,GACjC,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEb,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACrB,CAAC;AAYF,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,IAAI,CACxD,gBAAgB,EAChB,OAAO,CAgBP,CAAC;AAyBF,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAMnE,CAAC;AAEH,eAAO,MAAM,qBAAqB,wDAOjC,CAAC;AAuBF,eAAO,MAAM,6BAA6B,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAYpE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAO9D,CAAC;AAUH,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAWpE,CAAC"}
+{"version":3,"file":"OpenApiTypeDescriptors.d.ts","sourceRoot":"","sources":["../src/OpenApiTypeDescriptors.ts"],"names":[],"mappings":"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"}

package/dist/OpenApiTypeDescriptors.js

@@ -27,7 +27,7 @@ exports.openApiSpecTypeDescriptor = exports.openApiSpecPathTypeDescriptor = expo
 const t = __importStar(require("io-ts"));
 const io_ts_types_1 = require("io-ts-types");
 const TypeCodec_1 = require("@trayio/commons/codec/TypeCodec");
-// Codecs
+// Type Descriptors
 const nonArraySchemaObjectType = t.keyof({
     boolean: null,
     object: null,
@@ -36,6 +36,7 @@ const nonArraySchemaObjectType = t.keyof({
     integer: null,
 });
 exports.baseSchemaObjectSchemaTypeDescriptor = t.recursion('baseSchema', () => t.type({
+    title: (0, io_ts_types_1.optionFromNullable)(t.string),
     additionalProperties: (0, io_ts_types_1.optionFromNullable)(t.union([t.boolean, exports.schemaObjectTypeDescriptor])),
     properties: (0, io_ts_types_1.optionFromNullable)(t.record(t.string, exports.schemaObjectTypeDescriptor)),
     required: (0, io_ts_types_1.optionFromNullable)(t.array(t.string)),
@@ -61,10 +62,7 @@ exports.schemaObjectTypeDescriptor = t.recursion('schemaObject', () => t.union([
     arraySchemaObjectSchemaTypeDescriptor,
     nonArraySchemaObjectSchemaTypeDescriptor,
 ]));
-exports.schemaObjectTypeCodec = TypeCodec_1.TypeCodec.fromDescriptor(t.recursion('schemaObject', () => t.union([
-    arraySchemaObjectSchemaTypeDescriptor,
-    nonArraySchemaObjectSchemaTypeDescriptor,
-])));
+exports.schemaObjectTypeCodec = TypeCodec_1.TypeCodec.fromDescriptor(exports.schemaObjectTypeDescriptor);
 const componentSchemaTypeDescriptor = t.type({
     schemas: (0, io_ts_types_1.optionFromNullable)(t.record(t.string, exports.schemaObjectTypeDescriptor)),
 });
@@ -82,12 +80,8 @@ exports.parameterSchemaTypeDescriptor = t.type({
     name: t.string,
     in: t.string,
     description: t.string,
-    required: t.boolean,
-    schema: t.type({
-        type: t.string,
-        format: (0, io_ts_types_1.optionFromNullable)(t.string),
-        items: (0, io_ts_types_1.optionFromNullable)(exports.schemaObjectTypeDescriptor),
-    }),
+    required: (0, io_ts_types_1.optionFromNullable)(t.boolean),
+    schema: exports.schemaObjectTypeDescriptor,
 });
 exports.openApiSpecPathTypeDescriptor = t.type({
     description: t.string,

package/dist/file-generators/GenerateHandler.test.js

@@ -27,6 +27,7 @@ const E = __importStar(require("fp-ts/Either"));
 const O = __importStar(require("fp-ts/Option"));
 const GenerateHandler_1 = require("./GenerateHandler");
 const getGenerateHandlerInput = (input) => (Object.assign({ connectorNamePascalCase: 'OpenApiTest', operationNamePascalCase: 'GetPhoto', operationNameCamelCase: 'getPhoto', httpMethod: 'get', baseUrl: 'https://jsonplaceholder.typicode.com', input: {
+        title: O.none,
         properties: O.none,
         additionalProperties: O.none,
         required: O.none,
@@ -62,8 +63,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a path parameter', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 photoId: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('path'),
                     properties: O.none,
@@ -109,8 +112,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a body input as json', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 photoId: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('body'),
                     properties: O.none,
@@ -153,8 +158,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a query string input', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 id: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('query'),
                     properties: O.none,
@@ -197,8 +204,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a header input', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 'Content-Type': {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('header'),
                     properties: O.none,
@@ -241,8 +250,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler and transform number type to string for input', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 'Content-Type': {
+                    title: O.none,
                     type: O.some('integer'),
                     in: O.some('header'),
                     properties: O.none,
@@ -285,8 +296,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a query string and path param input', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 id: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('query'),
                     properties: O.none,
@@ -298,6 +311,7 @@ describe('GenerateHandler', () => {
                     not: O.none,
                 },
                 photoId: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('path'),
                     properties: O.none,
@@ -309,6 +323,7 @@ describe('GenerateHandler', () => {
                     not: O.none,
                 },
                 commentId: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('path'),
                     properties: O.none,
@@ -354,8 +369,10 @@ describe('GenerateHandler', () => {
     it('it should generate a handler with a query string and body param input', () => {
         const input = {
             type: O.some('object'),
+            title: O.none,
             properties: O.some({
                 id: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('query'),
                     properties: O.none,
@@ -367,6 +384,7 @@ describe('GenerateHandler', () => {
                     not: O.none,
                 },
                 photoId: {
+                    title: O.none,
                     type: O.some('string'),
                     in: O.some('body'),
                     properties: O.none,