@rxap/workspace-open-api 19.0.3-dev.0 → 19.0.3-dev.1

package/src/lib/utilities/create-component-type-alias-source-file.d.ts

@@ -1,4 +1,23 @@
 import { ArrayRefSchemaObject } from '@rxap/workspace-open-api';
 import { Project } from 'ts-morph';
 import { RefSchemaObject } from './ref-schema-object';
+/**
+ * Creates a TypeScript source file in a specified project with a type alias derived from a given schema object.
+ * This function is particularly useful for generating type definitions based on OpenAPI schema components.
+ *
+ * @param {Project} project - The project within which the source file will be created.
+ * @param {string} operationId - A unique identifier for the operation, used to name the generated file and type alias.
+ * @param {RefSchemaObject | ArrayRefSchemaObject} schema - The schema object that defines the structure of the type.
+ * This can be a direct reference to a schema (`RefSchemaObject`) or a reference to an array of schemas (`ArrayRefSchemaObject`).
+ * @param {string} basePath - The base directory path where the new source file will be created.
+ * @param {string} fileSuffix - A suffix to append to the operationId for the filename and type alias, aiding in the creation of distinct, descriptive names.
+ *
+ * The function performs the following operations:
+ * 1. Constructs the filename from the operationId and fileSuffix, then creates a new TypeScript file in the specified project.
+ * 2. Determines the reference path from the schema object, extracting the component name to be used in type alias and import declarations.
+ * 3. Adds a type alias to the source file that corresponds to the schema reference, appending '[]' to the type if the schema is an array type.
+ * 4. Adds necessary import declarations for the type based on the extracted component name.
+ *
+ * Note: This function relies on utility functions like `dasherize`, `classify`, and path manipulation functions (`join`, `relative`) to format names and paths.
+ */
 export declare function CreateComponentTypeAliasSourceFile(project: Project, operationId: string, schema: RefSchemaObject | ArrayRefSchemaObject, basePath: string, fileSuffix: string): void;

package/src/lib/utilities/create-component-type-alias-source-file.js

@@ -4,6 +4,25 @@ exports.CreateComponentTypeAliasSourceFile = void 0;
 const utilities_1 = require("@rxap/utilities");
 const workspace_open_api_1 = require("@rxap/workspace-open-api");
 const path_1 = require("path");
+/**
+ * Creates a TypeScript source file in a specified project with a type alias derived from a given schema object.
+ * This function is particularly useful for generating type definitions based on OpenAPI schema components.
+ *
+ * @param {Project} project - The project within which the source file will be created.
+ * @param {string} operationId - A unique identifier for the operation, used to name the generated file and type alias.
+ * @param {RefSchemaObject | ArrayRefSchemaObject} schema - The schema object that defines the structure of the type.
+ * This can be a direct reference to a schema (`RefSchemaObject`) or a reference to an array of schemas (`ArrayRefSchemaObject`).
+ * @param {string} basePath - The base directory path where the new source file will be created.
+ * @param {string} fileSuffix - A suffix to append to the operationId for the filename and type alias, aiding in the creation of distinct, descriptive names.
+ *
+ * The function performs the following operations:
+ * 1. Constructs the filename from the operationId and fileSuffix, then creates a new TypeScript file in the specified project.
+ * 2. Determines the reference path from the schema object, extracting the component name to be used in type alias and import declarations.
+ * 3. Adds a type alias to the source file that corresponds to the schema reference, appending '[]' to the type if the schema is an array type.
+ * 4. Adds necessary import declarations for the type based on the extracted component name.
+ *
+ * Note: This function relies on utility functions like `dasherize`, `classify`, and path manipulation functions (`join`, `relative`) to format names and paths.
+ */
 function CreateComponentTypeAliasSourceFile(project, operationId, schema, basePath, fileSuffix) {
     const sourceFile = project.createSourceFile((0, path_1.join)(basePath, `${(0, utilities_1.dasherize)(operationId)}.${fileSuffix}.ts`));
     const ref = (0, workspace_open_api_1.IsRefSchemaObject)(schema) ? schema.$ref : schema.items.$ref;

package/src/lib/utilities/create-component-type-alias-source-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-component-type-alias-source-file.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/create-component-type-alias-source-file.ts"],"names":[],"mappings":";;;AAAA,+CAGyB;AACzB,iEAKkC;AAClC,+BAGc;AAId,SAAgB,kCAAkC,CAChD,OAAgB,EAChB,WAAmB,EACnB,MAA8C,EAC9C,QAAgB,EAChB,UAAkB;IAElB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAA,WAAI,EAAC,QAAQ,EAAE,GAAI,IAAA,qBAAS,EAAC,WAAW,CAAE,IAAK,UAAW,KAAK,CAAC,CAAC,CAAC;IAC9G,MAAM,GAAG,GAAG,IAAA,sCAAiB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACxE,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,IAAI,GAAG,IAAA,oBAAQ,EAAC,aAAa,CAAC,CAAC;IACnC,IAAI,IAAA,2CAAsB,EAAC,MAAM,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,UAAU,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,IAAA,oBAAQ,EAAC,WAAW,CAAC,GAAG,IAAA,oBAAQ,EAAC,UAAU,CAAC;QAClD,UAAU,EAAE,IAAI;QAChB,IAAI;KACL,CAAC,CAAC;IACH,UAAU,CAAC,qBAAqB,CAAC,CAAC;YAChC,YAAY,EAAE,CAAC,IAAA,oBAAQ,EAAC,aAAa,CAAC,CAAC;YACvC,eAAe,EAAE,GAAG,IAAA,eAAQ,EAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,yCAAoB,IAAK,IAAA,qBAAS,EAAC,aAAa,CAAE,EAAE;SACnG,CAAC,CAAC,CAAC;AACN,CAAC;AAvBD,gFAuBC"}
+{"version":3,"file":"create-component-type-alias-source-file.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/create-component-type-alias-source-file.ts"],"names":[],"mappings":";;;AAAA,+CAGyB;AACzB,iEAKkC;AAClC,+BAGc;AAId;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,kCAAkC,CAChD,OAAgB,EAChB,WAAmB,EACnB,MAA8C,EAC9C,QAAgB,EAChB,UAAkB;IAElB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAA,WAAI,EAAC,QAAQ,EAAE,GAAI,IAAA,qBAAS,EAAC,WAAW,CAAE,IAAK,UAAW,KAAK,CAAC,CAAC,CAAC;IAC9G,MAAM,GAAG,GAAG,IAAA,sCAAiB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACxE,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,IAAI,GAAG,IAAA,oBAAQ,EAAC,aAAa,CAAC,CAAC;IACnC,IAAI,IAAA,2CAAsB,EAAC,MAAM,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,UAAU,CAAC,YAAY,CAAC;QACtB,IAAI,EAAE,IAAA,oBAAQ,EAAC,WAAW,CAAC,GAAG,IAAA,oBAAQ,EAAC,UAAU,CAAC;QAClD,UAAU,EAAE,IAAI;QAChB,IAAI;KACL,CAAC,CAAC;IACH,UAAU,CAAC,qBAAqB,CAAC,CAAC;YAChC,YAAY,EAAE,CAAC,IAAA,oBAAQ,EAAC,aAAa,CAAC,CAAC;YACvC,eAAe,EAAE,GAAG,IAAA,eAAQ,EAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,yCAAoB,IAAK,IAAA,qBAAS,EAAC,aAAa,CAAE,EAAE;SACnG,CAAC,CAAC,CAAC;AACN,CAAC;AAvBD,gFAuBC"}

package/src/lib/utilities/get-parameter-type.d.ts

@@ -1,2 +1,12 @@
 import { OpenAPIV3 } from 'openapi-types';
+/**
+ * Generates a string representing the type of parameter for a given OpenAPI operation.
+ *
+ * This function examines the provided `operation` object to determine if it contains parameters and an operation ID.
+ * If both are present, it constructs a parameter type string using the operation ID and a predefined suffix.
+ * If either is absent, it defaults to returning 'void'.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {string} A string representing the parameter type. Returns 'void' if the necessary conditions are not met.
+ */
 export declare function GetParameterType(operation: OpenAPIV3.OperationObject): string;

package/src/lib/utilities/get-parameter-type.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetParameterType = void 0;
 const utilities_1 = require("@rxap/utilities");
 const config_1 = require("../config");
+/**
+ * Generates a string representing the type of parameter for a given OpenAPI operation.
+ *
+ * This function examines the provided `operation` object to determine if it contains parameters and an operation ID.
+ * If both are present, it constructs a parameter type string using the operation ID and a predefined suffix.
+ * If either is absent, it defaults to returning 'void'.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {string} A string representing the parameter type. Returns 'void' if the necessary conditions are not met.
+ */
 function GetParameterType(operation) {
     let parameterType = 'void';
     if (operation.parameters && operation.parameters.length && operation.operationId) {

package/src/lib/utilities/get-parameter-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-parameter-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-parameter-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,sCAAkD;AAElD,SAAgB,gBAAgB,CAAC,SAAoC;IAEnE,IAAI,aAAa,GAAG,MAAM,CAAC;IAE3B,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QACjF,aAAa,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,8BAAqB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,aAAa,CAAC;AAEvB,CAAC;AAVD,4CAUC"}
+{"version":3,"file":"get-parameter-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-parameter-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,sCAAkD;AAElD;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,SAAoC;IAEnE,IAAI,aAAa,GAAG,MAAM,CAAC;IAE3B,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QACjF,aAAa,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,8BAAqB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,aAAa,CAAC;AAEvB,CAAC;AAVD,4CAUC"}

package/src/lib/utilities/get-reqeust-body.d.ts

@@ -1,3 +1,15 @@
 import { OpenAPIV3 } from 'openapi-types';
 import { AnySchemaObject } from './any-schema-object';
+/**
+ * Extracts the schema object from the request body of an OpenAPI operation.
+ *
+ * This function analyzes the `requestBody` of a given OpenAPI operation object to retrieve the schema definition
+ * for the 'application/json' media type. It ensures that the requestBody is not a reference object, as reference
+ * objects are not supported by this function. If the requestBody or the 'application/json' media type does not
+ * contain a schema, the function returns null.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object containing the requestBody from which the schema is to be extracted.
+ * @returns {OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null} The schema object associated with the 'application/json' media type if available, otherwise null.
+ * @throws {Error} Throws an error if the requestBody itself is a reference object.
+ */
 export declare function GetRequestBody(operation: OpenAPIV3.OperationObject): OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null;

package/src/lib/utilities/get-reqeust-body.js

@@ -3,6 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetRequestBody = void 0;
 const utilities_1 = require("@rxap/utilities");
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Extracts the schema object from the request body of an OpenAPI operation.
+ *
+ * This function analyzes the `requestBody` of a given OpenAPI operation object to retrieve the schema definition
+ * for the 'application/json' media type. It ensures that the requestBody is not a reference object, as reference
+ * objects are not supported by this function. If the requestBody or the 'application/json' media type does not
+ * contain a schema, the function returns null.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object containing the requestBody from which the schema is to be extracted.
+ * @returns {OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null} The schema object associated with the 'application/json' media type if available, otherwise null.
+ * @throws {Error} Throws an error if the requestBody itself is a reference object.
+ */
 function GetRequestBody(operation) {
     if (operation.requestBody) {
         if ((0, is_reference_object_1.IsReferenceObject)(operation.requestBody)) {

package/src/lib/utilities/get-reqeust-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-reqeust-body.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-reqeust-body.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAG3C,+DAA0D;AAE1D,SAAgB,cAAc,CAAC,SAAoC;IAEjE,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,IAAI,IAAA,uCAAiB,EAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,aAAa,GAA0D,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;QAE3G,IAAI,IAAA,oBAAQ,EAAC,aAAa,CAAC,EAAE,CAAC;YAE5B,IAAI,IAAA,uCAAiB,EAAC,aAAa,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,IAAI,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBACtC,MAAM,MAAM,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC3D,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,MAAM,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;QAEH,CAAC;IAEH,CAAC;IAED,OAAO,IAAI,CAAC;AAEd,CAAC;AA7BD,wCA6BC"}
+{"version":3,"file":"get-reqeust-body.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-reqeust-body.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAG3C,+DAA0D;AAE1D;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAAC,SAAoC;IAEjE,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,IAAI,IAAA,uCAAiB,EAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,aAAa,GAA0D,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;QAE3G,IAAI,IAAA,oBAAQ,EAAC,aAAa,CAAC,EAAE,CAAC;YAE5B,IAAI,IAAA,uCAAiB,EAAC,aAAa,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,IAAI,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBACtC,MAAM,MAAM,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;oBAC3D,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,MAAM,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;QAEH,CAAC;IAEH,CAAC;IAED,OAAO,IAAI,CAAC;AAEd,CAAC;AA7BD,wCA6BC"}

package/src/lib/utilities/get-request-body-type.d.ts

@@ -1,4 +1,23 @@
 import { GenerateParameter } from '../types';
+/**
+ * Generates a description of the request body type for a given API operation.
+ *
+ * This function examines the specified operation to determine the type of its request body.
+ * It returns an object containing the type as a string and an optional name for the type.
+ * If the operation does not specify a request body, or if the body cannot be determined,
+ * the type defaults to 'void'. If the body is of a generic or undefined type, it is classified
+ * under a generated name using the operation ID and a suffix. If the body schema is too generic
+ * (i.e., matches any schema), the type is set to 'any'.
+ *
+ * @param {GenerateParameter<any>} operation - The operation object to analyze, which should include
+ * an operationId and potentially other metadata necessary
+ * for determining the request body schema.
+ * @returns {{ type: string, name: string | null }} An object containing:
+ * - `type`: A string representing the determined type of the request body. Possible values
+ * are 'void', a specific classified type name, or 'any'.
+ * - `name`: An optional string representing a name for the request body type, which is
+ * null if no specific name is applicable.
+ */
 export declare function GetRequestBodyType(operation: GenerateParameter<any>): {
     type: string;
     name: string | null;

package/src/lib/utilities/get-request-body-type.js

@@ -6,6 +6,25 @@ const config_1 = require("../config");
 const any_schema_object_1 = require("./any-schema-object");
 const get_reqeust_body_1 = require("./get-reqeust-body");
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Generates a description of the request body type for a given API operation.
+ *
+ * This function examines the specified operation to determine the type of its request body.
+ * It returns an object containing the type as a string and an optional name for the type.
+ * If the operation does not specify a request body, or if the body cannot be determined,
+ * the type defaults to 'void'. If the body is of a generic or undefined type, it is classified
+ * under a generated name using the operation ID and a suffix. If the body schema is too generic
+ * (i.e., matches any schema), the type is set to 'any'.
+ *
+ * @param {GenerateParameter<any>} operation - The operation object to analyze, which should include
+ * an operationId and potentially other metadata necessary
+ * for determining the request body schema.
+ * @returns {{ type: string, name: string | null }} An object containing:
+ * - `type`: A string representing the determined type of the request body. Possible values
+ * are 'void', a specific classified type name, or 'any'.
+ * - `name`: An optional string representing a name for the request body type, which is
+ * null if no specific name is applicable.
+ */
 function GetRequestBodyType(operation) {
     let requestBodyType = 'void';
     let name = null;

package/src/lib/utilities/get-request-body-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-request-body-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-request-body-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAC3C,sCAAqD;AAErD,2DAAwD;AACxD,yDAAoD;AACpD,+DAA0D;AAE1D,SAAgB,kBAAkB,CAAC,SAAiC;IAElE,IAAI,eAAe,GAAG,MAAM,CAAC;IAC7B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAE/B,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,WAAW,GAAG,IAAA,iCAAc,EAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,eAAe,GAAG,MAAM,CAAC;QAC3B,CAAC;aAAM,IAAI,CAAC,IAAA,qCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,IAAI,GAAG,eAAe,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,iCAAwB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,IAAI,CAAC,IAAA,uCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;gBACpC,IAAI,WAAW,CAAC,oBAAoB,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAChF,eAAe,IAAI,gBAAgB,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,KAAK,CAAC;QAC1B,CAAC;IAEH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI;KACL,CAAC;AAEJ,CAAC;AA7BD,gDA6BC"}
+{"version":3,"file":"get-request-body-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-request-body-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAC3C,sCAAqD;AAErD,2DAAwD;AACxD,yDAAoD;AACpD,+DAA0D;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,kBAAkB,CAAC,SAAiC;IAElE,IAAI,eAAe,GAAG,MAAM,CAAC;IAC7B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAE/B,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,WAAW,GAAG,IAAA,iCAAc,EAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,eAAe,GAAG,MAAM,CAAC;QAC3B,CAAC;aAAM,IAAI,CAAC,IAAA,qCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,IAAI,GAAG,eAAe,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,iCAAwB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACjG,IAAI,CAAC,IAAA,uCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;gBACpC,IAAI,WAAW,CAAC,oBAAoB,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAChF,eAAe,IAAI,gBAAgB,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,KAAK,CAAC;QAC1B,CAAC;IAEH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI;KACL,CAAC;AAEJ,CAAC;AA7BD,gDA6BC"}

package/src/lib/utilities/get-response-type.d.ts

@@ -1,4 +1,19 @@
 import { OpenAPIV3 } from 'openapi-types';
+/**
+ * Determines the response type and name for a given OpenAPI operation.
+ *
+ * This function analyzes an OpenAPI operation object to ascertain the appropriate TypeScript type
+ * and name for the response. It defaults to a type of 'void' if no specific response structure is defined
+ * or if the response type is 'any'. If a valid response structure is found and it is not of type 'any',
+ * the function generates a TypeScript type name based on the operation ID and a predefined suffix.
+ * Additionally, if the response object is not a direct reference and either has additional properties
+ * or an undefined type, a generic type parameter 'TResponse' is appended to the response type.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {{ type: string, name: string | null }} An object containing the 'type' as a string
+ * indicating the TypeScript type of the response, and 'name', which is either a string
+ * representing the generated type name or null if no specific type name is generated.
+ */
 export declare function GetResponseType(operation: OpenAPIV3.OperationObject): {
     type: string;
     name: string | null;

package/src/lib/utilities/get-response-type.js

@@ -6,6 +6,21 @@ const config_1 = require("../config");
 const any_schema_object_1 = require("./any-schema-object");
 const get_response_1 = require("./get-response");
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Determines the response type and name for a given OpenAPI operation.
+ *
+ * This function analyzes an OpenAPI operation object to ascertain the appropriate TypeScript type
+ * and name for the response. It defaults to a type of 'void' if no specific response structure is defined
+ * or if the response type is 'any'. If a valid response structure is found and it is not of type 'any',
+ * the function generates a TypeScript type name based on the operation ID and a predefined suffix.
+ * Additionally, if the response object is not a direct reference and either has additional properties
+ * or an undefined type, a generic type parameter 'TResponse' is appended to the response type.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {{ type: string, name: string | null }} An object containing the 'type' as a string
+ * indicating the TypeScript type of the response, and 'name', which is either a string
+ * representing the generated type name or null if no specific type name is generated.
+ */
 function GetResponseType(operation) {
     let responseType = 'void';
     let name = null;

package/src/lib/utilities/get-response-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-response-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-response-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,sCAAiD;AACjD,2DAAwD;AACxD,iDAA6C;AAC7C,+DAA0D;AAE1D,SAAgB,eAAe,CAAC,SAAoC;IAElE,IAAI,YAAY,GAAG,MAAM,CAAC;IAC1B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAE/B,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;QAExC,8DAA8D;QAC9D,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,YAAY,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,6BAAoB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,IAAI,QAAQ,CAAC,oBAAoB,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC1E,YAAY,IAAI,aAAa,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,CAAC;QACxB,CAAC;IAEH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI;KACL,CAAC;AAEJ,CAAC;AA5BD,0CA4BC"}
+{"version":3,"file":"get-response-type.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-response-type.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,sCAAiD;AACjD,2DAAwD;AACxD,iDAA6C;AAC7C,+DAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe,CAAC,SAAoC;IAElE,IAAI,YAAY,GAAG,MAAM,CAAC;IAC1B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAE/B,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;QAExC,8DAA8D;QAC9D,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,YAAY,GAAG,IAAA,oBAAQ,EAAC,CAAE,SAAS,CAAC,WAAW,EAAE,6BAAoB,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,IAAI,QAAQ,CAAC,oBAAoB,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC1E,YAAY,IAAI,aAAa,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,CAAC;QACxB,CAAC;IAEH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI;KACL,CAAC;AAEJ,CAAC;AA5BD,0CA4BC"}

package/src/lib/utilities/get-response.d.ts

@@ -1,3 +1,16 @@
 import { OpenAPIV3 } from 'openapi-types';
 import { AnySchemaObject } from './any-schema-object';
+/**
+ * Extracts the JSON schema from a specified operation's responses in an OpenAPI 3.0 specification.
+ *
+ * This function navigates through the responses of an OpenAPI operation object to find and return the JSON schema
+ * associated with the response content type 'application/json'. It prioritizes the default response, followed by
+ * HTTP 200 and 201 status codes. If a response is found, the function checks if it is a reference object or an actual
+ * response object. For reference objects, a warning is logged indicating that reference objects are not supported.
+ * If an actual response object with a 'application/json' content type is found, the associated schema is returned.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object containing the responses to be analyzed.
+ * @returns {OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null} The JSON schema associated with
+ * the operation's response if available, otherwise null. Note that reference objects are recognized but not supported.
+ */
 export declare function GetResponse(operation: OpenAPIV3.OperationObject): OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null;

package/src/lib/utilities/get-response.js

@@ -2,6 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetResponse = void 0;
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Extracts the JSON schema from a specified operation's responses in an OpenAPI 3.0 specification.
+ *
+ * This function navigates through the responses of an OpenAPI operation object to find and return the JSON schema
+ * associated with the response content type 'application/json'. It prioritizes the default response, followed by
+ * HTTP 200 and 201 status codes. If a response is found, the function checks if it is a reference object or an actual
+ * response object. For reference objects, a warning is logged indicating that reference objects are not supported.
+ * If an actual response object with a 'application/json' content type is found, the associated schema is returned.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object containing the responses to be analyzed.
+ * @returns {OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject | AnySchemaObject | null} The JSON schema associated with
+ * the operation's response if available, otherwise null. Note that reference objects are recognized but not supported.
+ */
 function GetResponse(operation) {
     if (operation.responses) {
         let response = undefined;

package/src/lib/utilities/get-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-response.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-response.ts"],"names":[],"mappings":";;;AAEA,+DAA0D;AAE1D,SAAgB,WAAW,CAAC,SAAoC;IAE9D,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAExB,IAAI,QAAQ,GAAqE,SAAS,CAAC;QAE3F,IAAI,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YAEb,IAAI,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC;oBAC3D,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,MAAM,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;QAEH,CAAC;IAEH,CAAC;IAED,OAAO,IAAI,CAAC;AAEd,CAAC;AAjCD,kCAiCC"}
+{"version":3,"file":"get-response.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-response.ts"],"names":[],"mappings":";;;AAEA,+DAA0D;AAE1D;;;;;;;;;;;;GAYG;AACH,SAAgB,WAAW,CAAC,SAAoC;IAE9D,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAExB,IAAI,QAAQ,GAAqE,SAAS,CAAC;QAE3F,IAAI,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YAEb,IAAI,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC;oBAC3D,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,MAAM,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;QAEH,CAAC;IAEH,CAAC;IAED,OAAO,IAAI,CAAC;AAEd,CAAC;AAjCD,kCAiCC"}

package/src/lib/utilities/get-type-parameters.d.ts

@@ -1,3 +1,17 @@
 import { OpenAPIV3 } from 'openapi-types';
 import { OptionalKind, TypeParameterDeclarationStructure } from 'ts-morph';
+/**
+ * Extracts type parameters for the response and request body of a given OpenAPI operation object.
+ * This function analyzes the operation's response and request body to determine if type parameters
+ * should be defined based on the presence of additional properties or undefined types.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {Array<OptionalKind<TypeParameterDeclarationStructure>>} An array of type parameter declarations.
+ * Each type parameter is represented with a name and a default type. If the operation's response or request body
+ * has additional properties set to true or an undefined type, type parameters 'TResponse' and 'TRequestBody'
+ * are added with a default type of 'unknown'.
+ *
+ * Note: The function assumes that the operation object is well-formed and contains the necessary properties
+ * to perform checks on the response and request body. It returns an empty array if no type parameters are needed.
+ */
 export declare function GetTypeParameters(operation: OpenAPIV3.OperationObject): Array<OptionalKind<TypeParameterDeclarationStructure>>;

package/src/lib/utilities/get-type-parameters.js

@@ -5,6 +5,20 @@ const any_schema_object_1 = require("./any-schema-object");
 const get_reqeust_body_1 = require("./get-reqeust-body");
 const get_response_1 = require("./get-response");
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Extracts type parameters for the response and request body of a given OpenAPI operation object.
+ * This function analyzes the operation's response and request body to determine if type parameters
+ * should be defined based on the presence of additional properties or undefined types.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to analyze.
+ * @returns {Array<OptionalKind<TypeParameterDeclarationStructure>>} An array of type parameter declarations.
+ * Each type parameter is represented with a name and a default type. If the operation's response or request body
+ * has additional properties set to true or an undefined type, type parameters 'TResponse' and 'TRequestBody'
+ * are added with a default type of 'unknown'.
+ *
+ * Note: The function assumes that the operation object is well-formed and contains the necessary properties
+ * to perform checks on the response and request body. It returns an empty array if no type parameters are needed.
+ */
 function GetTypeParameters(operation) {
     const typeParameters = [];
     if (operation.operationId) {

package/src/lib/utilities/get-type-parameters.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-type-parameters.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-type-parameters.ts"],"names":[],"mappings":";;;AAKA,2DAAwD;AACxD,yDAAoD;AACpD,iDAA6C;AAC7C,+DAA0D;AAE1D,SAAgB,iBAAiB,CAAC,SAAoC;IAEpE,MAAM,cAAc,GAA2D,EAAE,CAAC;IAElF,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAA,iCAAc,EAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7E,IAAI,QAAQ,CAAC,oBAAoB,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1E,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,WAAW,IAAI,CAAC,IAAA,qCAAiB,EAAC,WAAW,CAAC,IAAI,CAAC,IAAA,uCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;YACtF,IAAI,WAAW,CAAC,oBAAoB,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAChF,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IAEH,CAAC;IAED,OAAO,cAAc,CAAC;AAExB,CAAC;AA/BD,8CA+BC"}
+{"version":3,"file":"get-type-parameters.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/get-type-parameters.ts"],"names":[],"mappings":";;;AAKA,2DAAwD;AACxD,yDAAoD;AACpD,iDAA6C;AAC7C,+DAA0D;AAE1D;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAAC,SAAoC;IAEpE,MAAM,cAAc,GAA2D,EAAE,CAAC;IAElF,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAA,iCAAc,EAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7E,IAAI,QAAQ,CAAC,oBAAoB,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1E,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,WAAW,IAAI,CAAC,IAAA,qCAAiB,EAAC,WAAW,CAAC,IAAI,CAAC,IAAA,uCAAiB,EAAC,WAAW,CAAC,EAAE,CAAC;YACtF,IAAI,WAAW,CAAC,oBAAoB,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAChF,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IAEH,CAAC;IAED,OAAO,cAAc,CAAC;AAExB,CAAC;AA/BD,8CA+BC"}

package/src/lib/utilities/has-operation-paramters.d.ts

@@ -1,3 +1,13 @@
 import { OpenAPIV3 } from 'openapi-types';
 export type OperationObjectWithParameters = Omit<OpenAPIV3.OperationObject, 'parameters'> & Required<Pick<OpenAPIV3.OperationObject, 'parameters'>>;
+/**
+ * Checks if the provided OpenAPI operation object has any parameters defined.
+ *
+ * This function is a type guard that determines whether the `operation` object
+ * conforms to the `OperationObjectWithParameters` type, which is an extension
+ * of the standard `OpenAPIV3.OperationObject` with a non-empty `parameters` array.
+ *
+ * @param operation - The OpenAPI operation object to check.
+ * @returns `true` if the `operation` object has a non-empty array of parameters, `false` otherwise.
+ */
 export declare function HasOperationParameters(operation: OpenAPIV3.OperationObject): operation is OperationObjectWithParameters;

package/src/lib/utilities/has-operation-paramters.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HasOperationParameters = void 0;
+/**
+ * Checks if the provided OpenAPI operation object has any parameters defined.
+ *
+ * This function is a type guard that determines whether the `operation` object
+ * conforms to the `OperationObjectWithParameters` type, which is an extension
+ * of the standard `OpenAPIV3.OperationObject` with a non-empty `parameters` array.
+ *
+ * @param operation - The OpenAPI operation object to check.
+ * @returns `true` if the `operation` object has a non-empty array of parameters, `false` otherwise.
+ */
 function HasOperationParameters(operation) {
     return Array.isArray(operation.parameters) && operation.parameters.length !== 0;
 }

package/src/lib/utilities/has-operation-paramters.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-operation-paramters.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/has-operation-paramters.ts"],"names":[],"mappings":";;;AAMA,SAAgB,sBAAsB,CAAC,SAAoC;IACzE,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;AAClF,CAAC;AAFD,wDAEC"}
+{"version":3,"file":"has-operation-paramters.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/has-operation-paramters.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAC,SAAoC;IACzE,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;AAClF,CAAC;AAFD,wDAEC"}

package/src/lib/utilities/has-operation-request-body.d.ts

@@ -1,3 +1,13 @@
 import { OpenAPIV3 } from 'openapi-types';
 export type OperationObjectWithRequestBody = Omit<OpenAPIV3.OperationObject, 'requestBody'> & Required<Pick<OpenAPIV3.OperationObject, 'requestBody'>>;
+/**
+ * Checks if the provided OpenAPI operation object includes a request body.
+ *
+ * This function is a type guard that determines whether the `operation` object
+ * conforms to the `OperationObjectWithRequestBody` interface, which is an extension
+ * of the standard OpenAPIV3 `OperationObject` that includes a `requestBody`.
+ *
+ * @param operation - The OpenAPI operation object to check.
+ * @returns `true` if the `operation` includes a `requestBody`, otherwise `false`.
+ */
 export declare function HasOperationRequestBody(operation: OpenAPIV3.OperationObject): operation is OperationObjectWithRequestBody;

package/src/lib/utilities/has-operation-request-body.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HasOperationRequestBody = void 0;
+/**
+ * Checks if the provided OpenAPI operation object includes a request body.
+ *
+ * This function is a type guard that determines whether the `operation` object
+ * conforms to the `OperationObjectWithRequestBody` interface, which is an extension
+ * of the standard OpenAPIV3 `OperationObject` that includes a `requestBody`.
+ *
+ * @param operation - The OpenAPI operation object to check.
+ * @returns `true` if the `operation` includes a `requestBody`, otherwise `false`.
+ */
 function HasOperationRequestBody(operation) {
     return !!operation.requestBody;
 }

package/src/lib/utilities/has-operation-request-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"has-operation-request-body.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/has-operation-request-body.ts"],"names":[],"mappings":";;;AAMA,SAAgB,uBAAuB,CAAC,SAAoC;IAC1E,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;AACjC,CAAC;AAFD,0DAEC"}
+{"version":3,"file":"has-operation-request-body.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/has-operation-request-body.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,SAAoC;IAC1E,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;AACjC,CAAC;AAFD,0DAEC"}

package/src/lib/utilities/http-request.d.ts

@@ -1 +1,31 @@
+/**
+ * Performs an HTTP GET request to retrieve JSON data from the specified URL.
+ *
+ * This function supports both HTTP and HTTPS protocols based on the URL provided.
+ * It returns a promise that resolves with the JSON parsed data if the request is successful
+ * and the response contains valid JSON content. If the request fails or the response is not
+ * valid JSON, the promise is rejected with an error message.
+ *
+ * @param {string} url - The URL from which to fetch data. Must be a valid HTTP or HTTPS URL.
+ * @returns {Promise<T>} A promise that resolves with the parsed JSON data as type T, or rejects with an error message.
+ *
+ * @template T - The type of the JSON data expected to be returned by the server.
+ *
+ * ### Example
+ *
+ * interface User {
+ * id: number;
+ * name: string;
+ * }
+ *
+ * const userPromise: Promise<User> = HttpRequest<User>('https://api.example.com/users/1');
+ * userPromise.then(user => console.log(user.name)).catch(error => console.error(error));
+ * ```
+ *
+ * ### Error Handling
+ * - If the status code of the response is not 200, the promise is rejected with "Request Failed. Status Code: [statusCode]".
+ * - If the content type of the response is not `application/json`, the promise is rejected with "Invalid content-type. Expected application/json but received [contentType]".
+ * - If there is an error in parsing the JSON data, the promise is rejected with the parsing error message.
+ * - Network errors or other request issues result in a promise rejection with the respective error message.
+ */
 export declare function HttpRequest<T>(url: string): Promise<T>;

package/src/lib/utilities/http-request.js

@@ -3,6 +3,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpRequest = void 0;
 const http = require("http");
 const https = require("https");
+/**
+ * Performs an HTTP GET request to retrieve JSON data from the specified URL.
+ *
+ * This function supports both HTTP and HTTPS protocols based on the URL provided.
+ * It returns a promise that resolves with the JSON parsed data if the request is successful
+ * and the response contains valid JSON content. If the request fails or the response is not
+ * valid JSON, the promise is rejected with an error message.
+ *
+ * @param {string} url - The URL from which to fetch data. Must be a valid HTTP or HTTPS URL.
+ * @returns {Promise<T>} A promise that resolves with the parsed JSON data as type T, or rejects with an error message.
+ *
+ * @template T - The type of the JSON data expected to be returned by the server.
+ *
+ * ### Example
+ *
+ * interface User {
+ * id: number;
+ * name: string;
+ * }
+ *
+ * const userPromise: Promise<User> = HttpRequest<User>('https://api.example.com/users/1');
+ * userPromise.then(user => console.log(user.name)).catch(error => console.error(error));
+ * ```
+ *
+ * ### Error Handling
+ * - If the status code of the response is not 200, the promise is rejected with "Request Failed. Status Code: [statusCode]".
+ * - If the content type of the response is not `application/json`, the promise is rejected with "Invalid content-type. Expected application/json but received [contentType]".
+ * - If there is an error in parsing the JSON data, the promise is rejected with the parsing error message.
+ * - Network errors or other request issues result in a promise rejection with the respective error message.
+ */
 function HttpRequest(url) {
     function callback(resolve, reject) {
         return function (res) {

package/src/lib/utilities/http-request.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-request.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/http-request.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAC7B,+BAA+B;AAE/B,SAAgB,WAAW,CAAI,GAAW;IAExC,SAAS,QAAQ,CAAC,OAA6B,EAAE,MAA4B;QAE3E,OAAO,UAAU,GAAyB;YAExC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;YAC3B,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAEhD,IAAI,KAAK,CAAC;YACV,wDAAwD;YACxD,oCAAoC;YACpC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,KAAK,GAAG,IAAI,KAAK,CAAC,mBAAmB;oBACnC,gBAAiB,UAAW,EAAE,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,WAAW,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,KAAK,GAAG,IAAI,KAAK,CAAC,yBAAyB;oBACzC,0CAA2C,WAAY,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,KAAK,EAAE,CAAC;gBACV,0CAA0C;gBAC1C,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvB,OAAO,IAAI,KAAK,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,CAAM,EAAE,CAAC;oBAChB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACzB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QAEL,CAAC,CAAC;IAEJ,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;IACL,CAAC;AAEH,CAAC;AAvDD,kCAuDC"}
+{"version":3,"file":"http-request.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/http-request.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAC7B,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,WAAW,CAAI,GAAW;IAExC,SAAS,QAAQ,CAAC,OAA6B,EAAE,MAA4B;QAE3E,OAAO,UAAU,GAAyB;YAExC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;YAC3B,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAEhD,IAAI,KAAK,CAAC;YACV,wDAAwD;YACxD,oCAAoC;YACpC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,KAAK,GAAG,IAAI,KAAK,CAAC,mBAAmB;oBACnC,gBAAiB,UAAW,EAAE,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,WAAW,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,KAAK,GAAG,IAAI,KAAK,CAAC,yBAAyB;oBACzC,0CAA2C,WAAY,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,KAAK,EAAE,CAAC;gBACV,0CAA0C;gBAC1C,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvB,OAAO,IAAI,KAAK,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,CAAM,EAAE,CAAC;oBAChB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBACzB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QAEL,CAAC,CAAC;IAEJ,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;IACL,CAAC;AAEH,CAAC;AAvDD,kCAuDC"}

package/src/lib/utilities/ignore-operation.d.ts

@@ -1,2 +1,13 @@
 import { OpenAPIV3 } from 'openapi-types';
+/**
+ * Creates a predicate function that checks if an OpenAPI operation should be ignored based on its tags.
+ *
+ * The returned function evaluates whether any of the operation's tags match the specified tags to ignore.
+ * If a match is found, the operation is considered for ignoring (i.e., the function returns `true`).
+ * If no tags are specified in the input, or the operation has no tags, the function will return `false`.
+ *
+ * @param {string[]} tags - An array of strings representing the tags to check against the operation's tags.
+ * @returns {(operation: OpenAPIV3.OperationObject) => boolean} A function that takes an OpenAPI operation object
+ * and returns `true` if any of the operation's tags match the tags to ignore, otherwise `false`.
+ */
 export declare function IgnoreOperation(tags?: string[]): (operation: OpenAPIV3.OperationObject) => boolean;

package/src/lib/utilities/ignore-operation.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IgnoreOperation = void 0;
+/**
+ * Creates a predicate function that checks if an OpenAPI operation should be ignored based on its tags.
+ *
+ * The returned function evaluates whether any of the operation's tags match the specified tags to ignore.
+ * If a match is found, the operation is considered for ignoring (i.e., the function returns `true`).
+ * If no tags are specified in the input, or the operation has no tags, the function will return `false`.
+ *
+ * @param {string[]} tags - An array of strings representing the tags to check against the operation's tags.
+ * @returns {(operation: OpenAPIV3.OperationObject) => boolean} A function that takes an OpenAPI operation object
+ * and returns `true` if any of the operation's tags match the tags to ignore, otherwise `false`.
+ */
 function IgnoreOperation(tags = []) {
     return operation => {
         var _a;

package/src/lib/utilities/ignore-operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"ignore-operation.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/ignore-operation.ts"],"names":[],"mappings":";;;AAEA,SAAgB,eAAe,CAAC,OAAiB,EAAE;IACjD,OAAO,SAAS,CAAC,EAAE;;QAEjB,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,0CAAE,MAAM,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,KAAK,CAAC;IAEf,CAAC,CAAC;AACJ,CAAC;AAVD,0CAUC"}
+{"version":3,"file":"ignore-operation.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/ignore-operation.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,OAAiB,EAAE;IACjD,OAAO,SAAS,CAAC,EAAE;;QAEjB,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,0CAAE,MAAM,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,KAAK,CAAC;IAEf,CAAC,CAAC;AACJ,CAAC;AAVD,0CAUC"}

package/src/lib/utilities/is-collection-response.d.ts

@@ -1,2 +1,15 @@
 import { OpenAPIV3 } from 'openapi-types';
+/**
+ * Determines if the given OpenAPI operation object represents a collection response.
+ *
+ * This function checks if the operation's response schema explicitly defines an array type,
+ * indicating that the response is a collection of items rather than a single item. It first
+ * retrieves the response schema from the operation object, then verifies that the schema
+ * is neither a wildcard schema object nor a reference to another schema. If these conditions
+ * are met and the response type is an array, the function returns true, indicating a collection
+ * response.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to evaluate.
+ * @returns {boolean} True if the operation's response is a collection (array type), false otherwise.
+ */
 export declare function IsCollectionResponse(operation: OpenAPIV3.OperationObject): boolean;

package/src/lib/utilities/is-collection-response.js

@@ -4,6 +4,19 @@ exports.IsCollectionResponse = void 0;
 const any_schema_object_1 = require("./any-schema-object");
 const get_response_1 = require("./get-response");
 const is_reference_object_1 = require("./is-reference-object");
+/**
+ * Determines if the given OpenAPI operation object represents a collection response.
+ *
+ * This function checks if the operation's response schema explicitly defines an array type,
+ * indicating that the response is a collection of items rather than a single item. It first
+ * retrieves the response schema from the operation object, then verifies that the schema
+ * is neither a wildcard schema object nor a reference to another schema. If these conditions
+ * are met and the response type is an array, the function returns true, indicating a collection
+ * response.
+ *
+ * @param {OpenAPIV3.OperationObject} operation - The OpenAPI operation object to evaluate.
+ * @returns {boolean} True if the operation's response is a collection (array type), false otherwise.
+ */
 function IsCollectionResponse(operation) {
     const response = (0, get_response_1.GetResponse)(operation);
     if (response && !(0, any_schema_object_1.IsAnySchemaObject)(response)) {

package/src/lib/utilities/is-collection-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-collection-response.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/is-collection-response.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,iDAA6C;AAC7C,+DAA0D;AAE1D,SAAgB,oBAAoB,CAAC,SAAoC;IAEvE,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;IAExC,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAXD,oDAWC"}
+{"version":3,"file":"is-collection-response.js","sourceRoot":"","sources":["../../../../../../../packages/workspace/open-api/src/lib/utilities/is-collection-response.ts"],"names":[],"mappings":";;;AACA,2DAAwD;AACxD,iDAA6C;AAC7C,+DAA0D;AAE1D;;;;;;;;;;;;GAYG;AACH,SAAgB,oBAAoB,CAAC,SAAoC;IAEvE,MAAM,QAAQ,GAAG,IAAA,0BAAW,EAAC,SAAS,CAAC,CAAC;IAExC,IAAI,QAAQ,IAAI,CAAC,IAAA,qCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAA,uCAAiB,EAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAXD,oDAWC"}