codegen-openapi-ts 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,172 @@
+declare enum HttpClient {
+    FETCH = "fetch",
+    XHR = "xhr",
+    NODE = "node",
+    AXIOS = "axios"
+}
+
+declare enum Indent {
+    SPACE_4 = "4",
+    SPACE_2 = "2",
+    TAB = "tab"
+}
+
+type Options = {
+    input: string | Record<string, any>;
+    output: string;
+    httpClient?: HttpClient;
+    clientName?: string;
+    useOptions?: boolean;
+    useUnionTypes?: boolean;
+    exportCore?: boolean;
+    exportServices?: boolean;
+    exportModels?: boolean;
+    exportSchemas?: boolean;
+    indent?: Indent;
+    postfixServices?: string;
+    postfixModels?: string;
+    request?: string;
+    write?: boolean;
+    selectedOnly?: boolean;
+    appendTemplate?: ReturnType<typeof defineConfig>['appendTemplate'];
+};
+/**
+ * Generate the OpenAPI client. This method will read the OpenAPI specification and based on the
+ * given language it will generate the client, including the typed models, validation schemas,
+ * service layer, etc.
+ * @param input The relative location of the OpenAPI spec
+ * @param output The relative location of the output directory
+ * @param httpClient The selected httpClient (fetch, xhr, node or axios)
+ * @param clientName Custom client class name
+ * @param useOptions Use options or arguments functions
+ * @param useUnionTypes Use union types instead of enums
+ * @param exportCore Generate core client classes
+ * @param exportServices Generate services
+ * @param exportModels Generate models
+ * @param exportSchemas Generate schemas
+ * @param indent Indentation options (4, 2 or tab)
+ * @param postfixServices Service name postfix
+ * @param postfixModels Model name postfix
+ * @param request Path to custom request file
+ * @param write Write the files to disk (true or false)
+ */
+declare const generate: ({ input, output, httpClient, clientName, useOptions, useUnionTypes, exportCore, exportServices, exportModels, exportSchemas, indent, postfixServices, postfixModels, request, write, selectedOnly, appendTemplate, }: Options) => Promise<void>;
+declare const _default: {
+    HttpClient: typeof HttpClient;
+    generate: ({ input, output, httpClient, clientName, useOptions, useUnionTypes, exportCore, exportServices, exportModels, exportSchemas, indent, postfixServices, postfixModels, request, write, selectedOnly, appendTemplate, }: Options) => Promise<void>;
+};
+
+/**
+ * Generate the OpenAPI client with options to convert swagger to openapi etc.
+ * @param converterInput.from The schema specification for the response (swagger_1, swagger_2, openapi_3)
+ * @param converterInput.to The schema specification for the output (openapi_3)
+ * @param converterInput.source The relative location of the OpenAPI spec
+ * @param options.httpClient The selected httpClient (fetch, xhr, node or axios)
+ * @param options.useUnionTypes Use union types instead of enums
+ * @param options.exportCore: Generate core client classes
+ * @param options.exportServices: Generate services
+ * @param options.exportModels: Generate models
+ * @param options.exportSchemas: Generate schemas
+ * @param options.postfix: Service name postfix
+ * @param options.request: Path to custom request file
+ * @param options.write Write the files to disk (true or false)
+ */
+declare function convertAndGenerate({ from, source }: {
+    from: string;
+    source: string;
+}, { input, output, useOptions, useUnionTypes }: Options, urlMethodMapping?: ServiceConfigWithMappings['urlMethodMapping'], selectedOnly?: ServiceConfigWithMappings['selectedOnly'], modelNameMapping?: BaseServiceConfig['modelNameMapping'], appendTemplate?: ReturnType<typeof defineConfig>['appendTemplate'], proxyConfig?: BaseServiceConfig['proxyConfig']): Promise<void>;
+type BaseServiceConfig = {
+    /**
+     * API Docs request url for the json response
+     */
+    source: string;
+    /**
+     * Specify the API specs response format version
+     */
+    from: 'swagger_1' | 'swagger_2' | 'openapi_3' | 'api_blueprint' | 'io_docs' | 'google' | 'raml' | 'wadl';
+    /**
+     * Specify the folder for the codegen output
+     */
+    output: string;
+    /**
+     * Create a function for proxying the request
+     * @example
+     * {
+     *  // ... other config
+     *  proxyConfig: (path) => {
+     *    return path.replace('/api/', '/be/')
+     *  }
+     * }
+     * @param {string} path
+     */
+    proxyConfig?: (path: string) => string;
+    /**
+     * Can be used to replace long model names specified on the schema.
+     * Please use the api-schema.json generated on root project folder
+     * to debug the desired results. Also note that the original schema name
+     * with dot (.) will be generated as underscore (_). Example:
+     * some.long.name will be generated as some_long_name,
+     * if this modelNameMapping supplied
+     * @example
+     * {
+     *  // ... other config
+     *  modelNameMapping: (json) => {
+     *    // remember to use global flag to all regexp used here
+     *    return config.replace(new RegExp('some.long.name', g), 'shortname')
+     *  }
+     * }
+     *
+     * @param {string} json - stringified json schema
+     */
+    modelNameMapping?: (json: string) => string;
+};
+type ServiceConfigDefault = BaseServiceConfig & {
+    urlMethodMapping: undefined;
+    selectedOnly: undefined;
+};
+declare type ServiceConfigWithMappings = BaseServiceConfig & {
+    /**
+     * Custom spec paths mapping. You can configure to rename the method name
+     * or customise the proxyUrl for the specific API
+     *
+     * @example
+     * {
+     *  // ... other config
+     *  urlMethodMapping: [
+     *    { originalUrl: '/pokemon-list', method: 'get', methodName: 'GetPokemonList' },
+     *    { originalUrl: '/pokemon-detail/{id}', method: 'get', methodName: 'GetPokemonList', proxyUrl: '/proxy/pokemon-detail/{id}' }
+     *  ]
+     * }
+     *
+     */
+    urlMethodMapping: {
+        originalUrl: string;
+        method: 'get' | 'post' | 'put' | 'delete';
+        methodName: string;
+        proxyUrl?: string;
+    }[];
+    /**
+     * Flag to only generate listed specs based on urlMethodMapping.
+     * The codegen will still generate all the models listed on the api specs
+     */
+    selectedOnly: boolean;
+};
+/**
+ * Type helper to make it easier to use codegen.config.js
+ */
+declare function defineConfig(config: {
+    /**
+     * Custom api templates append on top of service files
+     */
+    appendTemplate?: string;
+    /**
+     * List config for every services
+     */
+    services: (ServiceConfigDefault | ServiceConfigWithMappings)[];
+}): {
+    appendTemplate?: string | undefined;
+    services: (ServiceConfigDefault | ServiceConfigWithMappings)[];
+};
+
+export { HttpClient, Indent, convertAndGenerate, _default as default, defineConfig, generate };
+export type { BaseServiceConfig, Options, ServiceConfigDefault, ServiceConfigWithMappings };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "codegen-openapi-ts",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "Library that generates Typescript clients based on the OpenAPI specification.",
     "type": "module",
     "author": "devteaa",
@@ -93,9 +93,9 @@
         "@types/fs-extra": "^11.0.4",
         "@types/glob": "8.1.0",
         "@types/node": "^24.0.0",
-        "@types/shelljs": "^0.8.15",
         "@types/node-fetch": "2.6.10",
         "@types/qs": "6.9.11",
+        "@types/shelljs": "^0.8.15",
         "@typescript-eslint/eslint-plugin": "6.20.0",
         "@typescript-eslint/parser": "6.20.0",
         "@vitest/coverage-v8": "^2.1.0",
@@ -116,6 +116,7 @@
         "qs": "6.11.2",
         "rimraf": "5.0.5",
         "rollup": "4.7.0",
+        "rollup-plugin-dts": "6.5.1",
         "tslib": "2.6.2",
         "typescript": "5.2.2",
         "vitest": "^2.1.0"