@goast/core 0.4.2 → 0.5.0-beta.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2021 Marc Schmidt
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2021 Marc Schmidt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/esm/mod.d.ts

@@ -17,6 +17,7 @@ export * from './src/utils/common.utils.js';
 export * from './src/utils/endpoint.utils.js';
 export * from './src/utils/error.utils.js';
 export * from './src/utils/factory.js';
+export * from './src/utils/file-system.utils.js';
 export * from './src/utils/generator.utils.js';
 export * from './src/utils/object.utils.js';
 export * from './src/utils/schema.utils.js';

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC/F,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC/F,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC"}

package/esm/mod.js

@@ -17,6 +17,7 @@ export * from './src/utils/common.utils.js';
 export * from './src/utils/endpoint.utils.js';
 export * from './src/utils/error.utils.js';
 export * from './src/utils/factory.js';
+export * from './src/utils/file-system.utils.js';
 export * from './src/utils/generator.utils.js';
 export * from './src/utils/object.utils.js';
 export * from './src/utils/schema.utils.js';

package/esm/src/codegen/config.d.ts

@@ -11,6 +11,17 @@ export type OpenApiGeneratorConfig = SourceBuilderOptions & OpenApiParserOptions
      * @default true
      */
     clearOutputDir: boolean;
+    /**
+     * How to handle existing files in the output directory.
+     * - 'override': overwrite existing files.
+     * - 'skip': skip generating files that already exist.
+     * - 'error': throw an error if a file already exists.
+     *
+     * Is is recommended to use `'error'` to prevent issues of two schemas generating the same file and overwriting each other.
+     * If `clearOutputDir` is set to `false`, it is recommended to use `'override'` to ensure that the generated files are up to date.
+     * @default 'error'
+     */
+    existingFileBehavior: 'override' | 'skip' | 'error';
 };
 export declare const defaultOpenApiGeneratorConfig: OpenApiGeneratorConfig;
 //# sourceMappingURL=config.d.ts.map

package/esm/src/codegen/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/codegen/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,oBAAoB,GACpB;IACA;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,sBAM3C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/codegen/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,oBAAoB,GACpB;IACA;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;;;;OASG;IACH,oBAAoB,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;CACrD,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,sBAO3C,CAAC"}

package/esm/src/codegen/config.js

@@ -5,4 +5,5 @@ export const defaultOpenApiGeneratorConfig = {
     ...defaultOpenApiTransformerOptions,
     outputDir: 'generated',
     clearOutputDir: true,
+    existingFileBehavior: 'error',
 };

package/esm/src/utils/file-system.utils.d.ts

@@ -1,3 +1,4 @@
+import type { OpenApiGeneratorConfig } from '../codegen/config.js';
 import type { Nullable } from './type.utils.js';
 export type DirectoryScanOptions = {
     recursive: boolean;
@@ -6,4 +7,5 @@ export type DirectoryScanOptions = {
 };
 export declare const defaultDirectoryScanOptions: DirectoryScanOptions;
 export declare function getFiles(dir: string, options?: Partial<DirectoryScanOptions>): Promise<string[]>;
+export declare function writeGeneratedFile(config: OpenApiGeneratorConfig, filePath: string, content: string): void;
 //# sourceMappingURL=file-system.utils.d.ts.map

package/esm/src/utils/file-system.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/file-system.utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtG"}
+{"version":3,"file":"file-system.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/file-system.utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtG;AA0BD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAU1G"}

package/esm/src/utils/file-system.utils.js

@@ -1,4 +1,4 @@
-import { resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
 import fs from 'fs-extra';
 export const defaultDirectoryScanOptions = {
     recursive: false,
@@ -29,3 +29,13 @@ async function getFilesImpl(dir, options, files, currentDepth) {
         }
     }
 }
+export function writeGeneratedFile(config, filePath, content) {
+    if (config.existingFileBehavior !== 'override' && fs.existsSync(filePath)) {
+        if (config.existingFileBehavior === 'error') {
+            throw new Error(`File already exists: ${filePath}`);
+        }
+        return;
+    }
+    fs.ensureDirSync(dirname(filePath));
+    fs.writeFileSync(filePath, content);
+}

package/esm/src/utils/schema.utils.d.ts

@@ -1,6 +1,7 @@
 import type { OpenApiSchema } from '../parse/openapi-types.js';
 import type { ApiSchema } from '../transform/api-types.js';
 export declare function resolveAnyOfAndAllOf(schema: ApiSchema<'combined' | 'object'>, ignoreNonObjectParts: boolean): ApiSchema<'object'> | undefined;
+export declare const DEFAULT_IGNORED_SCHEMA_PROPERTIES: (keyof OpenApiSchema)[];
 /**
  * Retrieves the first schema reference and the reference chain of a given schema that
  * defines some schema properties. (e.g. schemas with just "$ref" are skipped)

package/esm/src/utils/schema.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/schema.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,2BAA2B,CAAC;AAEnG,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC,EACxC,oBAAoB,EAAE,OAAO,GAC5B,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAgCjC;AA0FD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,SAAS,CAM5G"}
+{"version":3,"file":"schema.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/schema.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,2BAA2B,CAAC;AAEnG,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC,EACxC,oBAAoB,EAAE,OAAO,GAC5B,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAgCjC;AA0FD,eAAO,MAAM,iCAAiC,EAAE,CAAC,MAAM,aAAa,CAAC,EAIpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,SAAS,CAM5G"}

package/esm/src/utils/schema.utils.js

@@ -102,6 +102,11 @@ function hasInvalidSubSchema(subSchemas) {
     return subSchemas.some((x) => x.kind !== 'object' &&
         (x.kind !== 'combined' || (!hasInvalidSubSchema(x.allOf) && !hasInvalidSubSchema(x.anyOf))));
 }
+export const DEFAULT_IGNORED_SCHEMA_PROPERTIES = [
+    'description',
+    'example',
+    'deprecated',
+];
 /**
  * Retrieves the first schema reference and the reference chain of a given schema that
  * defines some schema properties. (e.g. schemas with just "$ref" are skipped)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goast/core",
-  "version": "0.4.2",
+  "version": "0.5.0-beta.1",
   "description": "A tool designed to transform OpenAPI specifications into various forms with flexibility and extensibility at its core.",
   "author": {
     "name": "Marc Schmidt (MaSch0212)",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "tslib": "^2.6.2",
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.3.3",
     "yaml": "^2.5.1",
     "undici": "^6.0.0"
   },

package/script/mod.d.ts

@@ -17,6 +17,7 @@ export * from './src/utils/common.utils.js';
 export * from './src/utils/endpoint.utils.js';
 export * from './src/utils/error.utils.js';
 export * from './src/utils/factory.js';
+export * from './src/utils/file-system.utils.js';
 export * from './src/utils/generator.utils.js';
 export * from './src/utils/object.utils.js';
 export * from './src/utils/schema.utils.js';

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC/F,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC/F,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC"}

package/script/mod.js

@@ -21,6 +21,7 @@ tslib_1.__exportStar(require("./src/utils/common.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/endpoint.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/error.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/factory.js"), exports);
+tslib_1.__exportStar(require("./src/utils/file-system.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/generator.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/object.utils.js"), exports);
 tslib_1.__exportStar(require("./src/utils/schema.utils.js"), exports);

package/script/src/codegen/config.d.ts

@@ -11,6 +11,17 @@ export type OpenApiGeneratorConfig = SourceBuilderOptions & OpenApiParserOptions
      * @default true
      */
     clearOutputDir: boolean;
+    /**
+     * How to handle existing files in the output directory.
+     * - 'override': overwrite existing files.
+     * - 'skip': skip generating files that already exist.
+     * - 'error': throw an error if a file already exists.
+     *
+     * Is is recommended to use `'error'` to prevent issues of two schemas generating the same file and overwriting each other.
+     * If `clearOutputDir` is set to `false`, it is recommended to use `'override'` to ensure that the generated files are up to date.
+     * @default 'error'
+     */
+    existingFileBehavior: 'override' | 'skip' | 'error';
 };
 export declare const defaultOpenApiGeneratorConfig: OpenApiGeneratorConfig;
 //# sourceMappingURL=config.d.ts.map

package/script/src/codegen/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/codegen/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,oBAAoB,GACpB;IACA;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,sBAM3C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/codegen/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEpG,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,oBAAoB,GACpB;IACA;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;;;;OASG;IACH,oBAAoB,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;CACrD,CAAC;AAEJ,eAAO,MAAM,6BAA6B,EAAE,sBAO3C,CAAC"}

package/script/src/codegen/config.js

@@ -8,4 +8,5 @@ exports.defaultOpenApiGeneratorConfig = {
     ...types_js_1.defaultOpenApiTransformerOptions,
     outputDir: 'generated',
     clearOutputDir: true,
+    existingFileBehavior: 'error',
 };

package/script/src/utils/file-system.utils.d.ts

@@ -1,3 +1,4 @@
+import type { OpenApiGeneratorConfig } from '../codegen/config.js';
 import type { Nullable } from './type.utils.js';
 export type DirectoryScanOptions = {
     recursive: boolean;
@@ -6,4 +7,5 @@ export type DirectoryScanOptions = {
 };
 export declare const defaultDirectoryScanOptions: DirectoryScanOptions;
 export declare function getFiles(dir: string, options?: Partial<DirectoryScanOptions>): Promise<string[]>;
+export declare function writeGeneratedFile(config: OpenApiGeneratorConfig, filePath: string, content: string): void;
 //# sourceMappingURL=file-system.utils.d.ts.map

package/script/src/utils/file-system.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/file-system.utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtG"}
+{"version":3,"file":"file-system.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/file-system.utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtG;AA0BD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAU1G"}

package/script/src/utils/file-system.utils.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultDirectoryScanOptions = void 0;
 exports.getFiles = getFiles;
+exports.writeGeneratedFile = writeGeneratedFile;
 const tslib_1 = require("tslib");
 const node_path_1 = require("node:path");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -34,3 +35,13 @@ async function getFilesImpl(dir, options, files, currentDepth) {
         }
     }
 }
+function writeGeneratedFile(config, filePath, content) {
+    if (config.existingFileBehavior !== 'override' && fs_extra_1.default.existsSync(filePath)) {
+        if (config.existingFileBehavior === 'error') {
+            throw new Error(`File already exists: ${filePath}`);
+        }
+        return;
+    }
+    fs_extra_1.default.ensureDirSync((0, node_path_1.dirname)(filePath));
+    fs_extra_1.default.writeFileSync(filePath, content);
+}

package/script/src/utils/schema.utils.d.ts

@@ -1,6 +1,7 @@
 import type { OpenApiSchema } from '../parse/openapi-types.js';
 import type { ApiSchema } from '../transform/api-types.js';
 export declare function resolveAnyOfAndAllOf(schema: ApiSchema<'combined' | 'object'>, ignoreNonObjectParts: boolean): ApiSchema<'object'> | undefined;
+export declare const DEFAULT_IGNORED_SCHEMA_PROPERTIES: (keyof OpenApiSchema)[];
 /**
  * Retrieves the first schema reference and the reference chain of a given schema that
  * defines some schema properties. (e.g. schemas with just "$ref" are skipped)

package/script/src/utils/schema.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/schema.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,2BAA2B,CAAC;AAEnG,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC,EACxC,oBAAoB,EAAE,OAAO,GAC5B,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAgCjC;AA0FD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,SAAS,CAM5G"}
+{"version":3,"file":"schema.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/schema.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,2BAA2B,CAAC;AAEnG,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC,EACxC,oBAAoB,EAAE,OAAO,GAC5B,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAgCjC;AA0FD,eAAO,MAAM,iCAAiC,EAAE,CAAC,MAAM,aAAa,CAAC,EAIpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,SAAS,CAM5G"}

package/script/src/utils/schema.utils.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_IGNORED_SCHEMA_PROPERTIES = void 0;
 exports.resolveAnyOfAndAllOf = resolveAnyOfAndAllOf;
 exports.getSchemaReference = getSchemaReference;
 const internal_utils_js_1 = require("../internal-utils.js");
@@ -106,6 +107,11 @@ function hasInvalidSubSchema(subSchemas) {
     return subSchemas.some((x) => x.kind !== 'object' &&
         (x.kind !== 'combined' || (!hasInvalidSubSchema(x.allOf) && !hasInvalidSubSchema(x.anyOf))));
 }
+exports.DEFAULT_IGNORED_SCHEMA_PROPERTIES = [
+    'description',
+    'example',
+    'deprecated',
+];
 /**
  * Retrieves the first schema reference and the reference chain of a given schema that
  * defines some schema properties. (e.g. schemas with just "$ref" are skipped)

package/src/_dnt.shims.ts

@@ -1,69 +0,0 @@
-import { fetch, File, FormData, Headers, Request, Response } from "undici";
-export { fetch, File, FormData, Headers, Request, Response, type BodyInit, type HeadersInit, type ReferrerPolicy, type RequestInit, type RequestCache, type RequestMode, type RequestRedirect, type ResponseInit } from "undici";
-
-const dntGlobals = {
-  fetch,
-  File,
-  FormData,
-  Headers,
-  Request,
-  Response,
-};
-export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
-
-function createMergeProxy<T extends object, U extends object>(
-  baseObj: T,
-  extObj: U,
-): Omit<T, keyof U> & U {
-  return new Proxy(baseObj, {
-    get(_target, prop, _receiver) {
-      if (prop in extObj) {
-        return (extObj as any)[prop];
-      } else {
-        return (baseObj as any)[prop];
-      }
-    },
-    set(_target, prop, value) {
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-      }
-      (baseObj as any)[prop] = value;
-      return true;
-    },
-    deleteProperty(_target, prop) {
-      let success = false;
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-        success = true;
-      }
-      if (prop in baseObj) {
-        delete (baseObj as any)[prop];
-        success = true;
-      }
-      return success;
-    },
-    ownKeys(_target) {
-      const baseKeys = Reflect.ownKeys(baseObj);
-      const extKeys = Reflect.ownKeys(extObj);
-      const extKeysSet = new Set(extKeys);
-      return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
-    },
-    defineProperty(_target, prop, desc) {
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-      }
-      Reflect.defineProperty(baseObj, prop, desc);
-      return true;
-    },
-    getOwnPropertyDescriptor(_target, prop) {
-      if (prop in extObj) {
-        return Reflect.getOwnPropertyDescriptor(extObj, prop);
-      } else {
-        return Reflect.getOwnPropertyDescriptor(baseObj, prop);
-      }
-    },
-    has(_target, prop) {
-      return prop in extObj || prop in baseObj;
-    },
-  }) as any;
-}

package/src/mod.ts

@@ -1,33 +0,0 @@
-export * from './src/ast/node.js';
-
-export * from './src/codegen/config.js';
-export * from './src/codegen/endpoints-generator.js';
-export * from './src/codegen/generator.js';
-export * from './src/codegen/schemas-generator.js';
-export * from './src/codegen/services-generator.js';
-export * from './src/codegen/types.js';
-
-export * from './src/parse/openapi-types.js';
-export * from './src/parse/parser.js';
-export * from './src/parse/types.js';
-
-export * from './src/transform/api-types.js';
-export * from './src/transform/transformer.js';
-
-export * from './src/utils/array.utils.js';
-export * from './src/utils/asset-manager.js';
-export * from './src/utils/class.utils.js';
-export * from './src/utils/common.utils.js';
-export * from './src/utils/endpoint.utils.js';
-export * from './src/utils/error.utils.js';
-export * from './src/utils/factory.js';
-export * from './src/utils/generator.utils.js';
-export * from './src/utils/object.utils.js';
-export * from './src/utils/schema.utils.js';
-export * from './src/utils/source-builder.js';
-export * from './src/utils/string-builder/options.js';
-export { type AppendParam, StringBuilder } from './src/utils/string-builder/string-builder.js';
-export * from './src/utils/string-builder/utils.js';
-export * from './src/utils/string.utils.js';
-export * from './src/utils/string.utils.types.js';
-export * from './src/utils/type.utils.js';

package/src/src/ast/node.ts

@@ -1,46 +0,0 @@
-import type { StringBuilder } from '../utils/string-builder/string-builder.js';
-import type { AppendValue } from '../utils/string-builder/utils.js';
-import type { Prettify } from '../utils/type.utils.js';
-
-const NODE_HISTORY_SYMBOL = Symbol('node-history');
-type BuilderWithHistory<T extends StringBuilder = StringBuilder> = T & { [NODE_HISTORY_SYMBOL]?: AstNode[] };
-
-export type AstNodeInject<TBuilder extends StringBuilder, TInjects extends string> = {
-  [K in `${'after' | 'before'}${Capitalize<TInjects>}`]?: AppendValue<TBuilder>;
-};
-
-export type AstNodeOptions<
-  // deno-lint-ignore no-explicit-any
-  TBase extends abstract new (...args: any) => any,
-  // deno-lint-ignore ban-types
-  TExtensions extends object = {},
-> = Prettify<TExtensions & ConstructorParameters<TBase>[0]>;
-
-export abstract class AstNode<TBuilder extends StringBuilder = StringBuilder, TInjects extends string = never> {
-  public inject: AstNodeInject<TBuilder, TInjects | ''>;
-
-  constructor(options: { inject?: AstNode<TBuilder, TInjects>['inject'] }) {
-    this.inject = options.inject ?? {};
-  }
-
-  public write(builder: TBuilder): void {
-    let history = (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL];
-    if (!history) {
-      history = [];
-      (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL] = history;
-    }
-
-    history.push(this);
-    builder.append(this.inject.before);
-    this.onWrite(builder);
-    builder.append(this.inject.after);
-    history.pop();
-  }
-
-  protected getParentNode(builder: TBuilder): AstNode | undefined {
-    const history = (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL];
-    return history?.at(-2);
-  }
-
-  protected abstract onWrite(builder: TBuilder): void;
-}

package/src/src/codegen/config.ts

@@ -1,28 +0,0 @@
-import type { OpenApiParserOptions } from '../parse/types.js';
-import { defaultOpenApiTransformerOptions } from '../transform/types.js';
-import { defaultSourceBuilderOptions, type SourceBuilderOptions } from '../utils/source-builder.js';
-
-export type OpenApiGeneratorConfig =
-  & SourceBuilderOptions
-  & OpenApiParserOptions
-  & {
-    /**
-     * The directory where the generated files should be saved.
-     * @default 'generated'
-     */
-    outputDir: string;
-
-    /**
-     * Whether to clear the output directory before generating the files.
-     * @default true
-     */
-    clearOutputDir: boolean;
-  };
-
-export const defaultOpenApiGeneratorConfig: OpenApiGeneratorConfig = {
-  ...defaultSourceBuilderOptions,
-  ...defaultOpenApiTransformerOptions,
-
-  outputDir: 'generated',
-  clearOutputDir: true,
-};

package/src/src/codegen/endpoints-generator.ts

@@ -1,72 +0,0 @@
-import type { ApiEndpoint } from '../transform/api-types.js';
-import type { MaybePromise } from '../utils/type.utils.js';
-import { type DefaultGenerationProviderConfig, OpenApiGenerationProviderBase } from './generator.js';
-import { addSourceIfTest } from './internal-utils.js';
-import type {
-  AnyConfig,
-  OpenApiGenerationProviderContext,
-  OpenApiGeneratorContext,
-  OpenApiGeneratorInput,
-  OpenApiGeneratorOutput,
-} from './types.js';
-
-export type OpenApiEndpointsGenerationProviderContext<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TEndpointOutput extends OpenApiGeneratorOutput,
-> = OpenApiGenerationProviderContext<TInput, TConfig> & {
-  existingEndpointResults: Map<string, TEndpointOutput>;
-  output: TOutput;
-};
-
-export abstract class OpenApiEndpointsGenerationProviderBase<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TEndpointOutput extends OpenApiGeneratorOutput,
-  TContext extends OpenApiEndpointsGenerationProviderContext<TInput, TOutput, TConfig, TEndpointOutput>,
-> extends OpenApiGenerationProviderBase<TInput, TOutput, TConfig, TContext> {
-  protected override getProviderContext(
-    context: OpenApiGeneratorContext<TInput>,
-    config: Partial<TConfig> | undefined,
-    defaultConfig: DefaultGenerationProviderConfig<TConfig>,
-  ): OpenApiEndpointsGenerationProviderContext<TInput, TOutput, TConfig, TEndpointOutput> {
-    const ctx = super.getProviderContext(context, config, defaultConfig);
-    return Object.assign(ctx, {
-      existingEndpointResults: new Map<string, TEndpointOutput>(),
-      output: this.initResult(ctx),
-    });
-  }
-
-  protected override async onGenerate(ctx: TContext): Promise<TOutput> {
-    for (const endpoint of ctx.data.endpoints) {
-      await this.getEndpointResult(ctx, endpoint);
-    }
-
-    await this.generateAdditionalFiles(ctx);
-
-    return ctx.output;
-  }
-
-  public async getEndpointResult(ctx: TContext, endpoint: ApiEndpoint): Promise<TEndpointOutput> {
-    const existingResult = ctx.existingEndpointResults.get(endpoint.id);
-    if (existingResult) return existingResult;
-
-    const result = await this.generateEndpoint(ctx, endpoint);
-    addSourceIfTest(ctx.config, result, () => `${endpoint.$src.file}#${endpoint.$src.path}`);
-    this.addEndpointResult(ctx, endpoint, result);
-    return result;
-  }
-
-  protected abstract initResult(ctx: OpenApiGenerationProviderContext<TInput, TConfig>): TOutput;
-
-  protected abstract generateEndpoint(ctx: TContext, endpoint: ApiEndpoint): Promise<TEndpointOutput>;
-
-  protected abstract addEndpointResult(ctx: TContext, endpoint: ApiEndpoint, result: TEndpointOutput): void;
-
-  // deno-lint-ignore no-unused-vars
-  protected generateAdditionalFiles(ctx: TContext): MaybePromise<void> {
-    // Override if needed
-  }
-}