@goast/typescript 0.0.5 → 0.2.0

package/esm/lib/generators/services/angular-services/angular-services-generator.js

@@ -1,11 +1,11 @@
-import { readFileSync } from 'fs';
 import { dirname, resolve } from 'path';
-import { ensureDirSync, writeFileSync } from 'fs-extra';
-import { Factory, OpenApiServicesGenerationProviderBase, notNullish, } from '@goast/core';
+import { copyFileSync, ensureDirSync } from 'fs-extra';
+import { Factory, OpenApiServicesGenerationProviderBase, appendValueGroup, toCasing, } from '@goast/core';
 import { DefaultTypeScriptAngularServiceGenerator, } from './angular-service-generator';
 import { defaultTypeScriptAngularServicesGeneratorConfig, } from './models';
+import { getReferenceFactories } from './refs';
+import { ts } from '../../../ast';
 import { TypeScriptFileBuilder } from '../../../file-builder';
-import { ImportExportCollection } from '../../../import-collection';
 import { modifyString } from '../../../utils';
 export class TypeScriptAngularServicesGenerator extends OpenApiServicesGenerationProviderBase {
     constructor(clientGeneratorFactory) {
@@ -16,17 +16,19 @@ export class TypeScriptAngularServicesGenerator extends OpenApiServicesGeneratio
     initResult() {
         return {
             services: {},
-            servicesIndexFilePath: undefined,
-            responseModelsIndexFilePath: undefined,
+            indexFiles: { services: undefined, responseModels: undefined },
         };
     }
     buildContext(context, config) {
-        return this.getProviderContext(context, config, defaultTypeScriptAngularServicesGeneratorConfig);
+        const providerContext = this.getProviderContext(context, config, defaultTypeScriptAngularServicesGeneratorConfig);
+        return Object.assign(providerContext, {
+            refs: getReferenceFactories(providerContext.config),
+        });
     }
     onGenerate(ctx) {
         const output = super.onGenerate(ctx);
-        this.copyUtilsFiles(ctx);
-        output.servicesIndexFilePath = this.generateServicesIndexFile(ctx);
+        this.generateUtilsFiles(ctx);
+        output.indexFiles = this.generateIndexFiles(ctx);
         return output;
     }
     generateService(ctx, service) {
@@ -36,83 +38,173 @@ export class TypeScriptAngularServicesGenerator extends OpenApiServicesGeneratio
     addServiceResult(ctx, service, result) {
         ctx.output.services[service.id] = result;
     }
-    generateServicesIndexFile(ctx) {
-        if (!this.shouldGenerateServicesIndexFile(ctx)) {
-            return undefined;
+    // #region Utils
+    generateUtilsFiles(ctx) {
+        const sourceDir = resolve(dirname(require.resolve('@goast/typescript')), '../assets/client/angular');
+        const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDirPath);
+        ensureDirSync(targetDir);
+        this.copyFile('request builder', sourceDir, targetDir, 'request-builder.ts');
+        TypeScriptFileBuilder.generate({
+            logName: 'api configuration',
+            filePath: resolve(targetDir, 'api-configuration.ts'),
+            options: ctx.config,
+            generator: (b) => b.append(this.getApiConfigurationFileContent(ctx)),
+        });
+        TypeScriptFileBuilder.generate({
+            logName: 'api base service',
+            filePath: resolve(targetDir, 'api-base-service.ts'),
+            options: ctx.config,
+            generator: (b) => b.append(this.getApiBaseServiceFileContent(ctx)),
+        });
+        if (!ctx.config.strictResponseTypes) {
+            TypeScriptFileBuilder.generate({
+                logName: 'http status codes',
+                filePath: resolve(targetDir, 'http-status-code.ts'),
+                options: ctx.config,
+                generator: (b) => b.append(this.getHttpStatusCodeFileContent(ctx)),
+            });
+        }
+        if (ctx.config.provideKind === 'provide-fn') {
+            TypeScriptFileBuilder.generate({
+                logName: 'providers',
+                filePath: resolve(targetDir, 'provide.ts'),
+                options: ctx.config,
+                generator: (b) => b.append(this.getProvideFnFileContent(ctx)),
+            });
         }
-        const filePath = this.getServicesIndexFilePath(ctx);
-        console.log(`Generating index file to ${filePath}...`);
-        ensureDirSync(dirname(filePath));
-        const builder = new TypeScriptFileBuilder(filePath, ctx.config);
-        this.generateServicesIndexFileContent(ctx, builder);
-        writeFileSync(filePath, builder.toString());
-        return filePath;
     }
-    getServicesIndexFilePath(ctx) {
+    getApiConfigurationFileContent(ctx) {
+        var _a, _b;
+        return appendValueGroup([
+            ts.class(toCasing(`${(_a = ctx.config.domainName) !== null && _a !== void 0 ? _a : ''}ApiConfiguration`, ctx.config.typeNameCasing), {
+                doc: ts.doc({ description: `${(_b = ctx.config.domainName) !== null && _b !== void 0 ? _b : 'Global'} API Configuration.` }),
+                decorators: [
+                    ts.decorator(ts.refs.angular.injectable(), [
+                        ctx.config.provideKind === 'root' ? ts.toNode({ providedIn: 'root' }) : null,
+                    ]),
+                ],
+                export: true,
+                members: [
+                    ts.property('rootUrl', {
+                        accessModifier: 'public',
+                        type: ts.refs.string(),
+                        value: ts.string(this.getRootUrl(ctx)),
+                    }),
+                ],
+            }),
+        ], '\n');
+    }
+    getApiBaseServiceFileContent(ctx) {
+        return appendValueGroup([
+            ts.class('ApiBaseService', {
+                doc: ts.doc({ description: 'Base class for API services.' }),
+                export: true,
+                abstract: true,
+                members: [
+                    ts.property('config', {
+                        accessModifier: 'protected',
+                        value: (b) => b.append(ts.refs.angular.inject(), '(', ctx.refs.apiConfiguration(), ')'),
+                    }),
+                    ts.property('http', {
+                        accessModifier: 'protected',
+                        value: (b) => b.append(ts.refs.angular.inject(), '(', ts.refs.angular.httpClient(), ')'),
+                    }),
+                    ts.property('_rootUrl', { accessModifier: 'private', type: ts.refs.string(), value: ts.string('') }),
+                    ts.property('rootUrl', {
+                        doc: ts.doc({
+                            description: `Gets or sets the root URL for API operations provided by this service.\nFalls back to \`${ctx.refs.apiConfiguration.refName}.rootUrl\` if not set in this service.`,
+                        }),
+                        accessModifier: 'public',
+                        type: ts.refs.string(),
+                        get: ts.property.getter({ body: 'return this._rootUrl || this.config.rootUrl;' }),
+                        set: ts.property.setter({ body: 'this._rootUrl = value;' }),
+                    }),
+                ],
+            }),
+        ], '\n');
+    }
+    getHttpStatusCodeFileContent(ctx) {
+        return appendValueGroup([
+            ts.typeAlias('HttpStatusCode', ts.unionType(ctx.config.possibleStatusCodes), {
+                doc: ts.doc({ description: 'The possible status codes that any API endpoint can return.' }),
+                export: true,
+            }),
+        ], '\n');
+    }
+    getProvideFnFileContent(ctx) {
         var _a;
-        return resolve(ctx.config.outputDir, (_a = ctx.config.indexFilePath) !== null && _a !== void 0 ? _a : 'clients.ts');
+        return appendValueGroup([
+            ts.function(toCasing(`provide_${(_a = ctx.config.domainName) !== null && _a !== void 0 ? _a : ''}_Api`, ctx.config.functionNameCasing), {
+                doc: ts.doc({
+                    description: 'Provides all the API services' + (ctx.config.domainName ? ` for ${ctx.config.domainName}` : '') + '.',
+                }),
+                export: true,
+                parameters: [ts.parameter('config', { type: ctx.refs.apiConfiguration(), optional: true })],
+                returnType: ts.refs.angular.provider(),
+                body: appendValueGroup([
+                    'return ',
+                    ts.tuple([
+                        (b) => b.append('config ? { provide: ', ctx.refs.apiConfiguration(), ', useValue: config } : ', ctx.refs.apiConfiguration()),
+                        ...Object.values(ctx.output.services).map((x) => ts.reference(x.component, x.filePath)),
+                    ]),
+                    ';',
+                ]),
+            }),
+        ], '\n');
     }
-    shouldGenerateServicesIndexFile(ctx) {
-        return notNullish(ctx.config.indexFilePath);
+    getRootUrl(ctx) {
+        var _a, _b, _c, _d, _e, _f;
+        return modifyString((_f = (_e = (_d = (_c = ((_a = ctx.data.services[0].$src) !== null && _a !== void 0 ? _a : (_b = ctx.data.services[0].endpoints[0]) === null || _b === void 0 ? void 0 : _b.$src)) === null || _c === void 0 ? void 0 : _c.document.servers) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.url) !== null && _f !== void 0 ? _f : '/', ctx.config.rootUrl);
     }
-    generateServicesIndexFileContent(ctx, builder) {
-        const exports = new ImportExportCollection();
-        for (const serviceId in ctx.output.services) {
-            const service = ctx.output.services[serviceId];
-            exports.addExport(service.component, service.filePath);
-        }
-        exports.writeTo(builder);
+    // #endregion
+    // #region Index
+    generateIndexFiles(ctx) {
+        const servicesIndexFilePath = this.getServicesIndexFilePath(ctx);
+        const responseModelsIndexFilePath = this.getResponseModelsIndexFilePath(ctx);
+        TypeScriptFileBuilder.tryGenerate({
+            logName: 'services index file',
+            filePath: servicesIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getServicesIndexFileContent(ctx)),
+        });
+        TypeScriptFileBuilder.tryGenerate({
+            logName: 'response models index file',
+            filePath: responseModelsIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getResponseModelsIndexFileContent(ctx)),
+        });
+        return {
+            services: servicesIndexFilePath,
+            responseModels: responseModelsIndexFilePath,
+        };
     }
-    generateResponseModelsIndexFile(ctx) {
-        if (!this.shouldGenerateResponseModelsIndexFile(ctx)) {
-            return undefined;
-        }
-        const filePath = this.getResponseModelsIndexFilePath(ctx);
-        console.log(`Generating response models index file to ${filePath}...`);
-        ensureDirSync(dirname(filePath));
-        const builder = new TypeScriptFileBuilder(filePath, ctx.config);
-        this.generateResponseModelsIndexFileContent(ctx, builder);
-        writeFileSync(filePath, builder.toString());
-        return filePath;
+    getServicesIndexFileContent(ctx) {
+        return appendValueGroup([
+            ts.export(ctx.refs.apiConfiguration.refName, ctx.refs.apiConfiguration.moduleNameOrfilePath),
+            ctx.config.provideKind === 'provide-fn'
+                ? ts.export(ctx.refs.provide.refName, ctx.refs.provide.moduleNameOrfilePath)
+                : null,
+            ...Object.values(ctx.output.services).map((x) => ts.export(x.component, x.filePath)),
+        ]);
     }
-    getResponseModelsIndexFilePath(ctx) {
-        var _a;
-        return resolve(ctx.config.outputDir, (_a = ctx.config.responseModelsIndexFilePath) !== null && _a !== void 0 ? _a : 'responses.ts');
-    }
-    shouldGenerateResponseModelsIndexFile(ctx) {
-        return notNullish(ctx.config.responseModelsDirPath) && notNullish(ctx.config.responseModelsIndexFilePath);
-    }
-    generateResponseModelsIndexFileContent(ctx, builder) {
-        const exports = new ImportExportCollection();
-        for (const serviceId in ctx.output.services) {
-            const service = ctx.output.services[serviceId];
-            for (const operationId in service.responseModels) {
-                const responseModel = service.responseModels[operationId];
-                if (responseModel.filePath) {
-                    exports.addExport(responseModel.component, responseModel.filePath);
-                }
-            }
-        }
-        exports.writeTo(builder);
+    getResponseModelsIndexFileContent(ctx) {
+        return appendValueGroup(Object.values(ctx.output.services)
+            .flatMap((x) => Object.values(x.responseModels))
+            .map((x) => ts.export(x.component, x.filePath)));
     }
-    copyUtilsFiles(ctx) {
-        const sourceDir = resolve(dirname(require.resolve('@goast/typescript')), '../assets/service/angular');
-        const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDirPath);
-        ensureDirSync(targetDir);
-        const files = ['api-configuration.ts', 'base-service.ts', 'request-builder.ts', 'strict-http-response.ts'];
-        if (ctx.config.clientMethodFlavor === 'response-handler') {
-            files.push('response-handler.ts');
-        }
-        const rootUrl = this.getRootUrl(ctx);
-        for (const file of files) {
-            const fileContent = readFileSync(resolve(sourceDir, file))
-                .toString()
-                .replace(/@ROOT_URL@/g, rootUrl);
-            writeFileSync(resolve(targetDir, file), fileContent);
-        }
+    getServicesIndexFilePath(ctx) {
+        return ctx.config.servicesIndexFilePath ? resolve(ctx.config.outputDir, ctx.config.servicesIndexFilePath) : null;
     }
-    getRootUrl(ctx) {
-        var _a, _b, _c, _d, _e, _f;
-        return modifyString((_f = (_e = (_d = (_c = ((_a = ctx.data.services[0].$src) !== null && _a !== void 0 ? _a : (_b = ctx.data.services[0].endpoints[0]) === null || _b === void 0 ? void 0 : _b.$src)) === null || _c === void 0 ? void 0 : _c.document.servers) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.url) !== null && _f !== void 0 ? _f : '/', ctx.config.rootUrl);
+    getResponseModelsIndexFilePath(ctx) {
+        return ctx.config.responseModelsIndexFilePath
+            ? resolve(ctx.config.outputDir, ctx.config.responseModelsIndexFilePath)
+            : null;
+    }
+    // #endregion
+    copyFile(logName, sourceDir, targetDir, fileName) {
+        const source = resolve(sourceDir, fileName);
+        const target = resolve(targetDir, fileName);
+        console.log(`Generating ${logName} to ${target}...`);
+        copyFileSync(source, target);
     }
 }

package/esm/lib/generators/services/angular-services/models.js

@@ -1,2 +1,11 @@
+import { ts } from '../../../ast';
 import { defaultTypeScriptGeneratorConfig } from '../../../config';
-export const defaultTypeScriptAngularServicesGeneratorConfig = Object.assign(Object.assign({}, defaultTypeScriptGeneratorConfig), { fileNameCasing: { casing: 'kebab', suffix: '.service' }, responseModelsFileNameCasing: { casing: 'kebab', suffix: '-responses.model' }, exposeResponseMethods: false, exposePathProperties: false, clientMethodFlavor: 'default', servicesDirPath: 'services', responseModelsDirPath: 'models/responses', utilsDirPath: 'utils', indexFilePath: 'services.ts', responseModelsIndexFilePath: 'responses.ts' });
+export const defaultTypeScriptAngularServicesGeneratorConfig = Object.assign(Object.assign({}, defaultTypeScriptGeneratorConfig), { fileNameCasing: { casing: 'kebab', suffix: '.service' }, responseModelFileNameCasing: { casing: 'kebab', suffix: '-responses.model' }, provideKind: 'provide-fn', strictResponseTypes: true, defaultStatusCodeResponseTypes: {
+        401: ts.refs.never(),
+        403: ts.refs.never(),
+        500: ts.refs.never(),
+    }, possibleStatusCodes: [
+        100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308,
+        400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 421, 422, 423, 424, 425,
+        426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511,
+    ], servicesDirPath: 'services', servicesIndexFilePath: 'services.ts', responseModelsDirPath: 'models/responses', responseModelsIndexFilePath: 'responses.ts', utilsDirPath: 'utils' });

package/esm/lib/generators/services/angular-services/refs.js

@@ -0,0 +1,20 @@
+import { join, resolve } from 'path';
+import { toCasing } from '@goast/core';
+import { ts } from '../../../ast';
+// See packages/typescript/assets/client/angular for reference
+export function getReferenceFactories(options) {
+    var _a, _b;
+    const utilsDirPath = resolve(options.outputDir, options.utilsDirPath);
+    return {
+        // request-builder.ts
+        requestBuilder: ts.reference.factory('RequestBuilder', join(utilsDirPath, 'request-builder.ts')),
+        // api-configuration.ts - generated in angular-services-generator.ts
+        apiConfiguration: ts.reference.factory(toCasing(`${(_a = options.domainName) !== null && _a !== void 0 ? _a : ''}ApiConfiguration`, options.typeNameCasing), join(utilsDirPath, 'api-configuration.ts')),
+        // api-base-service.ts - generated in angular-service-generator.ts
+        apiBaseService: ts.reference.factory('ApiBaseService', join(utilsDirPath, 'api-base-service.ts')),
+        // http-status-code.ts - generated in angular-services-generator.ts
+        httpStatusCode: ts.reference.factory('HttpStatusCode', join(utilsDirPath, 'http-status-code.ts')),
+        // provide.ts - generated in angular-services-generator.ts
+        provide: ts.reference.factory(toCasing(`provide_${(_b = options.domainName) !== null && _b !== void 0 ? _b : ''}_Api`, options.functionNameCasing), join(utilsDirPath, 'provide.ts')),
+    };
+}

package/esm/lib/generators/services/easy-network-stub/easy-network-stub-generator.js

@@ -0,0 +1,165 @@
+import { resolve } from 'path';
+import { adjustCasing, appendValueGroup, builderTemplate as s, toCasing, } from '@goast/core';
+import { ts } from '../../../ast';
+import { TypeScriptFileBuilder } from '../../../file-builder';
+import { TypeScriptFileGenerator } from '../../file-generator';
+export class DefaultTypeScriptEasyNetworkStubGenerator extends TypeScriptFileGenerator {
+    generate(ctx) {
+        const filePath = this.getStubFilePath(ctx);
+        const name = this.getStubClassName(ctx);
+        TypeScriptFileBuilder.generate({
+            logName: `stub ${name}`,
+            filePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getStubFileContent(ctx)),
+        });
+        return {
+            filePath,
+            component: name,
+        };
+    }
+    getStubFileContent(ctx) {
+        return appendValueGroup([...ctx.service.endpoints.map((endpoint) => this.getResponderVariable(ctx, endpoint)), this.getStubClass(ctx)], '\n');
+    }
+    getResponderVariable(ctx, endpoint) {
+        return ts.variable(this.getResponderVariableName(ctx, endpoint), {
+            readonly: true,
+            value: ts.call(ctx.refs.getStubResponder([
+                ts.objectType({
+                    members: Object.entries(this.getEndpointStatusCodes(ctx, endpoint)).map(([statusCode, type]) => ts.property(statusCode, { type })),
+                }),
+            ]), []),
+        });
+    }
+    getStubClass(ctx) {
+        return ts.class(this.getStubClassName(ctx), {
+            export: true,
+            extends: ctx.refs.easyNetworkStubBase(),
+            members: [
+                ...ctx.service.endpoints.map((endpoint) => ts.property(this.getEndpointPathPropertyName(ctx, endpoint), {
+                    static: true,
+                    readonly: true,
+                    accessModifier: 'private',
+                    value: s `${ts.string(this.getStubRoute(ctx, endpoint))} as const`,
+                })),
+                '\n',
+                ...ctx.service.endpoints.map((endpoint) => ts.property(this.getEndpointRequestsFieldName(ctx, endpoint), {
+                    readonly: true,
+                    accessModifier: 'private',
+                    type: this.getEndpointRequestsType(ctx, endpoint),
+                    value: ts.tuple([]),
+                })),
+                '\n',
+                ...ctx.service.endpoints.map((endpoint) => ts.property(this.getEndpointRequestsPropertyName(ctx, endpoint), {
+                    readonly: true,
+                    accessModifier: 'public',
+                    type: this.getEndpointRequestsType(ctx, endpoint, { readonly: true }),
+                    get: ts.property.getter({
+                        body: appendValueGroup([`return this.${this.getEndpointRequestsFieldName(ctx, endpoint)};`], '\n'),
+                    }),
+                })),
+                ...ctx.service.endpoints.map((endpoint) => this.getEndpointStubMethod(ctx, endpoint)),
+                ts.method('reset', {
+                    accessModifier: 'public',
+                    override: true,
+                    returnType: ts.refs.void_(),
+                    body: appendValueGroup([
+                        ...ctx.service.endpoints.map((endpoint) => `this.${this.getEndpointRequestsFieldName(ctx, endpoint)}.length = 0;`),
+                        'super.reset();',
+                    ], '\n'),
+                }),
+            ],
+        });
+    }
+    getEndpointRequestsType(ctx, endpoint, options) {
+        var _a;
+        return ts.arrayType(ctx.refs.stubRequestInfo([
+            ts.typeof(ts.call([this.getStubClassName(ctx), this.getEndpointPathPropertyName(ctx, endpoint)])),
+            this.getSchemaType(ctx, (_a = endpoint.requestBody) === null || _a === void 0 ? void 0 : _a.content[0].schema),
+        ]), options);
+    }
+    getEndpointStubMethod(ctx, endpoint) {
+        var _a;
+        const requestType = this.getSchemaType(ctx, (_a = endpoint.requestBody) === null || _a === void 0 ? void 0 : _a.content[0].schema);
+        return ts.method(this.getEndpointStubMethodName(ctx, endpoint), {
+            accessModifier: 'public',
+            parameters: [
+                ts.parameter('response', {
+                    type: ctx.refs.strictRouteResponseCallback([
+                        requestType,
+                        ts.typeof(ts.call([this.getStubClassName(ctx), this.getEndpointPathPropertyName(ctx, endpoint)])),
+                        ts.typeof(this.getResponderVariableName(ctx, endpoint)),
+                    ]),
+                }),
+            ],
+            returnType: 'this',
+            body: appendValueGroup([
+                s `this.stubWrapper.stub2<${requestType}>()(${s.indent `
+              ${ts.string(endpoint.method.toUpperCase())},
+              ${this.getStubClassName(ctx)}.${this.getEndpointPathPropertyName(ctx, endpoint)},
+              async (request) => {${s.indent `
+                if (this.stubWrapper.options.rememberRequests) {${s.indent `
+                  this.${this.getEndpointRequestsFieldName(ctx, endpoint)}.push(request);`}
+                }
+                throw await response(${this.getResponderVariableName(ctx, endpoint)}, request);`}
+              }`}
+            );`,
+                'return this;',
+            ], '\n'),
+        });
+    }
+    getStubFilePath(ctx) {
+        return resolve(ctx.config.outputDir, ctx.config.stubsDirPath, `${toCasing(ctx.service.name, ctx.config.fileNameCasing)}.ts`);
+    }
+    getResponderVariableName(ctx, endpoint) {
+        return toCasing(endpoint.name + '_Responder', ctx.config.propertyNameCasing);
+    }
+    getStubClassName(ctx) {
+        return toCasing(ctx.service.name + '_Stubs', ctx.config.typeNameCasing);
+    }
+    getEndpointPathPropertyName(ctx, endpoint) {
+        return toCasing(endpoint.name + '_Path', ctx.config.constantNameCasing);
+    }
+    getEndpointRequestsFieldName(ctx, endpoint) {
+        return toCasing(endpoint.name + '_Requests', adjustCasing(ctx.config.propertyNameCasing, { prefix: '_' }));
+    }
+    getEndpointRequestsPropertyName(ctx, endpoint) {
+        return toCasing(endpoint.name + '_Requests', ctx.config.propertyNameCasing);
+    }
+    getEndpointStubMethodName(ctx, endpoint) {
+        return toCasing('stub_' + endpoint.name, ctx.config.functionNameCasing);
+    }
+    getStubRoute(ctx, endpoint) {
+        var _a, _b;
+        let path = endpoint.path;
+        let isFirstQueryParam = true;
+        for (const param of endpoint.parameters) {
+            const type = ((_b = (param.schema && ((_a = ctx.input.models[param.schema.id]) === null || _a === void 0 ? void 0 : _a.component))) !== null && _b !== void 0 ? _b : ts.refs.unknown.name).replace(/^readonly /, '');
+            if (param.target === 'path') {
+                path = path.replace(`{${param.name}}`, `{${param.name}${param.required ? '' : '?'}:${type}}`);
+            }
+            else if (param.target === 'query') {
+                path = path + (isFirstQueryParam ? '?' : '&') + `{${param.name}${param.required ? '' : '?'}:${type}}`;
+                isFirstQueryParam = false;
+            }
+        }
+        return path.replace(/^\/+/, '');
+    }
+    getEndpointStatusCodes(ctx, endpoint) {
+        return Object.fromEntries([
+            ...Object.entries(ctx.config.defaultStatusCodeResponseTypes).map(([key, value]) => [
+                key,
+                typeof value === 'function' ? this.getSchemaType(ctx, value(ctx.data.schemas)) : value,
+            ]),
+            ...endpoint.responses
+                .filter((x) => x.statusCode)
+                .map((x) => { var _a; return [x.statusCode, this.getSchemaType(ctx, (_a = x.contentOptions[0]) === null || _a === void 0 ? void 0 : _a.schema, ts.refs.never())]; }),
+        ]);
+    }
+    getSchemaType(ctx, schema, fallback) {
+        const output = schema && ctx.input.models[schema.id];
+        if (!output)
+            return fallback !== null && fallback !== void 0 ? fallback : this.getAnyType(ctx);
+        return (b) => b.appendModelUsage(output);
+    }
+}

package/esm/lib/generators/services/easy-network-stub/easy-network-stubs-generator.js

@@ -0,0 +1,69 @@
+import { dirname, resolve } from 'path';
+import { copyFileSync, ensureDirSync } from 'fs-extra';
+import { Factory, OpenApiServicesGenerationProviderBase, appendValueGroup, } from '@goast/core';
+import { DefaultTypeScriptEasyNetworkStubGenerator, } from './easy-network-stub-generator';
+import { defaultTypeScriptEasyNetworkStubsGeneratorConfig, } from './models';
+import { getReferenceFactories } from './refs';
+import { ts } from '../../../ast';
+import { TypeScriptFileBuilder } from '../../../file-builder';
+export class TypeScriptEasyNetworkStubsGenerator extends OpenApiServicesGenerationProviderBase {
+    constructor(generatorFactory) {
+        super();
+        this._generatorFactory = generatorFactory !== null && generatorFactory !== void 0 ? generatorFactory : Factory.fromValue(new DefaultTypeScriptEasyNetworkStubGenerator());
+    }
+    initResult() {
+        return {
+            stubs: {},
+            indexFiles: { stubs: undefined },
+        };
+    }
+    buildContext(context, config) {
+        const providerContext = this.getProviderContext(context, config, defaultTypeScriptEasyNetworkStubsGeneratorConfig);
+        return Object.assign(providerContext, {
+            refs: getReferenceFactories(providerContext.config),
+        });
+    }
+    onGenerate(ctx) {
+        const output = super.onGenerate(ctx);
+        this.generateUtilsFiles(ctx);
+        output.indexFiles = this.generateIndexFiles(ctx);
+        return output;
+    }
+    generateService(ctx, service) {
+        const clientGenerator = this._generatorFactory.create();
+        return clientGenerator.generate(Object.assign(Object.assign({}, ctx), { service }));
+    }
+    addServiceResult(ctx, service, result) {
+        ctx.output.stubs[service.id] = result;
+    }
+    generateUtilsFiles(ctx) {
+        const sourceDir = resolve(dirname(require.resolve('@goast/typescript')), '../assets/stubs/easy-network-stub');
+        const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDirPath);
+        ensureDirSync(targetDir);
+        this.copyFile('easy-network-stub utils', sourceDir, targetDir, 'easy-network-stub.utils.ts');
+    }
+    generateIndexFiles(ctx) {
+        const stubsIndexFilePath = this.getStubsIndexFilePath(ctx);
+        TypeScriptFileBuilder.tryGenerate({
+            logName: 'stubs index file',
+            filePath: stubsIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getStubsIndexFileContent(ctx)),
+        });
+        return {
+            stubs: stubsIndexFilePath,
+        };
+    }
+    getStubsIndexFileContent(ctx) {
+        return appendValueGroup(Object.values(ctx.output.stubs).map((x) => ts.export(x.component, x.filePath)));
+    }
+    getStubsIndexFilePath(ctx) {
+        return ctx.config.stubsIndexFilePath ? resolve(ctx.config.outputDir, ctx.config.stubsIndexFilePath) : null;
+    }
+    copyFile(logName, sourceDir, targetDir, fileName) {
+        const source = resolve(sourceDir, fileName);
+        const target = resolve(targetDir, fileName);
+        console.log(`Generating ${logName} to ${target}...`);
+        copyFileSync(source, target);
+    }
+}

package/esm/lib/generators/services/easy-network-stub/index.js

@@ -0,0 +1,3 @@
+export * from './easy-network-stub-generator';
+export * from './easy-network-stubs-generator';
+export * from './models';

package/esm/lib/generators/services/easy-network-stub/models.js

@@ -0,0 +1,7 @@
+import { ts } from '../../../ast';
+import { defaultTypeScriptGeneratorConfig } from '../../../config';
+export const defaultTypeScriptEasyNetworkStubsGeneratorConfig = Object.assign(Object.assign({}, defaultTypeScriptGeneratorConfig), { fileNameCasing: { casing: 'kebab', suffix: '.stubs' }, defaultStatusCodeResponseTypes: {
+        401: ts.refs.never(),
+        403: ts.refs.never(),
+        500: ts.refs.never(),
+    }, stubsDirPath: 'stubs', stubsIndexFilePath: 'stubs.ts', utilsDirPath: 'utils' });

package/esm/lib/generators/services/easy-network-stub/refs.js

@@ -0,0 +1,17 @@
+import { join, resolve } from 'path';
+import { ts } from '../../../ast';
+// See packages/typescript/assets/stubs/easy-network-stub for reference
+export function getReferenceFactories(options) {
+    const utilsDirPath = resolve(options.outputDir, options.utilsDirPath);
+    const easyNetworkStubUtilsPath = join(utilsDirPath, 'easy-network-stub.utils.ts');
+    return {
+        // easy-network-stub.utils.ts
+        easyNetworkStubWrapperOptions: ts.reference.factory('EasyNetworkStubWrapperOptions', easyNetworkStubUtilsPath),
+        stubRequestItem: ts.reference.factory('StubRequestItem', easyNetworkStubUtilsPath),
+        stubRequestInfo: ts.reference.genericFactory('StubRequestInfo', easyNetworkStubUtilsPath),
+        strictRouteResponseCallback: ts.reference.genericFactory('StrictRouteResponseCallback', easyNetworkStubUtilsPath),
+        getStubResponder: ts.reference.genericFactory('getStubResponder', easyNetworkStubUtilsPath),
+        easyNetworkStubWrapper: ts.reference.factory('EasyNetworkStubWrapper', easyNetworkStubUtilsPath),
+        easyNetworkStubBase: ts.reference.factory('EasyNetworkStubBase', easyNetworkStubUtilsPath),
+    };
+}