@goast/typescript 0.4.0-beta3 → 0.4.0

package/esm/src/generators/services/angular-services/angular-service-generator.js

@@ -0,0 +1,302 @@
+import { resolve } from 'node:path';
+import { appendValueGroup, builderTemplate as s, toCasing, } from '@goast/core';
+import { ts } from '../../../ast/index.js';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { TypeScriptFileGenerator } from '../../file-generator.js';
+export class DefaultTypeScriptAngularServiceGenerator extends TypeScriptFileGenerator {
+    generate(ctx) {
+        const responseModels = this.generateResponseModels(ctx);
+        const filePath = this.getServiceFilePath(ctx);
+        const name = this.getServiceClassName(ctx);
+        TypeScriptFileBuilder.generate({
+            logName: `service ${name}`,
+            filePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getServiceFileContent(ctx)),
+        });
+        return {
+            filePath,
+            component: name,
+            responseModels,
+        };
+    }
+    // #region Response Model
+    generateResponseModels(ctx) {
+        const result = {};
+        const filePath = this.getResponseModelFilePath(ctx);
+        const builder = new TypeScriptFileBuilder(filePath, ctx.config);
+        for (const endpoint of ctx.service.endpoints) {
+            const name = this.getResponseModelName(ctx, endpoint);
+            builder.appendLine(this.getResponseModelFileContent(ctx, endpoint));
+            result[endpoint.id] = { component: name, filePath };
+        }
+        builder.writeToFile();
+        return result;
+    }
+    getResponseModelFileContent(ctx, endpoint) {
+        const result = appendValueGroup([]);
+        const statusCodes = this.getEndpointStatusCodes(ctx, endpoint);
+        let statusCodeType;
+        const statusCodesTypeName = toCasing(`${endpoint.name}_StatusCodes`, ctx.config.typeNameCasing);
+        result.values.push(ts.typeAlias(statusCodesTypeName, ts.unionType(Object.keys(statusCodes))));
+        if (ctx.config.strictResponseTypes) {
+            statusCodeType = ts.reference(statusCodesTypeName);
+        }
+        else {
+            statusCodeType = ctx.refs.httpStatusCode();
+        }
+        result.values.push(ts.typeAlias(this.getResponseModelName(ctx, endpoint), ts.intersectionType([
+            ts.unionType([
+                ...Object.entries(statusCodes).map(([key, value]) => {
+                    const isSuccess = key.startsWith('2');
+                    return ts.intersectionType([
+                        isSuccess ? ts.refs.angular.httpResponse([value.type]) : ts.refs.angular.httpErrorResponse(),
+                        ts.objectType({
+                            members: [
+                                isSuccess ? null : ts.property('error', { type: ts.unionType([value.type, ts.refs.null_()]) }),
+                                ts.property('status', { type: key }),
+                                ts.property('ok', { type: isSuccess ? 'true' : 'false' }),
+                            ],
+                        }),
+                    ]);
+                }),
+                !ctx.config.strictResponseTypes
+                    ? ts.intersectionType([
+                        ts.refs.angular.httpResponse([this.getAnyType(ctx)]),
+                        ts.objectType({
+                            members: [
+                                ts.property('status', {
+                                    type: ts.refs.exclude([ctx.refs.httpStatusCode(), ts.reference(statusCodesTypeName)]),
+                                }),
+                            ],
+                        }),
+                    ])
+                    : null,
+            ]),
+            ts.objectType({ members: [ts.property('status', { type: 'TStatus' })] }),
+        ]), {
+            doc: ts.doc({
+                description: `Response model for operation ${this.getEndpointMethodName(ctx, endpoint)}`,
+                tags: [endpoint.deprecated ? ts.docTag('deprecated') : null],
+            }),
+            export: true,
+            generics: [
+                ts.genericParameter('TStatus', {
+                    constraint: statusCodeType,
+                    default: statusCodeType,
+                }),
+            ],
+        }));
+        return result;
+    }
+    getEndpointStatusCodes(ctx, endpoint) {
+        return Object.fromEntries([
+            ...Object.entries(ctx.config.defaultStatusCodeResponseTypes).map(([key, value]) => {
+                var _a;
+                return [
+                    key,
+                    {
+                        parser: (_a = value === null || value === void 0 ? void 0 : value.parser) !== null && _a !== void 0 ? _a : 'text',
+                        type: typeof (value === null || value === void 0 ? void 0 : value.type) === 'function'
+                            ? this.getSchemaType(ctx, value.type(ctx.data.schemas))
+                            : value !== null && value !== void 0 ? value : ts.refs.never(),
+                    },
+                ];
+            }),
+            ...endpoint.responses
+                .filter((x) => x.statusCode)
+                .map((x) => {
+                var _a, _b;
+                return [
+                    x.statusCode,
+                    {
+                        parser: this.contentTypeToResponseType((_a = x.contentOptions[0]) === null || _a === void 0 ? void 0 : _a.type),
+                        type: this.getSchemaType(ctx, (_b = x.contentOptions[0]) === null || _b === void 0 ? void 0 : _b.schema, ts.refs.never()),
+                    },
+                ];
+            }),
+        ]);
+    }
+    // #endregion
+    getServiceFileContent(ctx) {
+        const code = appendValueGroup([], '\n');
+        for (const endpoint of ctx.service.endpoints) {
+            if (endpoint.parameters.length > 0 || endpoint.requestBody !== undefined) {
+                code.values.push(this.getEndpointParamsType(ctx, endpoint));
+            }
+        }
+        code.values.push(this.getClass(ctx));
+        return code;
+    }
+    getEndpointParamsType(ctx, endpoint) {
+        const type = ts.objectType();
+        for (const parameter of endpoint.parameters) {
+            const schema = parameter.schema;
+            type.members.push(ts.property(toCasing(parameter.name, ctx.config.propertyNameCasing), {
+                doc: ts.doc({
+                    description: parameter.description,
+                    tags: [parameter.deprecated ? ts.docTag('deprecated') : null],
+                }),
+                type: schema ? (b) => b.appendModelUsage(ctx.input.typescript.models[schema.id]) : this.getAnyType(ctx),
+                optional: !parameter.required,
+            }));
+        }
+        if (endpoint.requestBody !== undefined) {
+            const body = endpoint.requestBody;
+            const schema = body.content[0].schema;
+            type.members.push(ts.property('body', {
+                doc: ts.doc({ description: body.description }),
+                type: schema ? (b) => b.appendModelUsage(ctx.input.typescript.models[schema.id]) : this.getAnyType(ctx),
+                optional: !body.required,
+            }));
+        }
+        return ts.typeAlias(this.getEndpointParamsTypeName(ctx, endpoint), type, {
+            doc: ts.doc({ description: `Parameters for operation ${this.getEndpointMethodName(ctx, endpoint)}` }),
+        });
+    }
+    getClass(ctx) {
+        return ts.class(this.getServiceClassName(ctx), {
+            doc: ts.doc({
+                description: ctx.service.description,
+                tags: [
+                    ctx.service.endpoints.length === 0 || ctx.service.endpoints.some((x) => !x.deprecated)
+                        ? null
+                        : ts.docTag('deprecated'),
+                ],
+            }),
+            decorators: [
+                ts.decorator(ts.refs.angular.injectable(), ctx.config.provideKind === 'root' ? [ts.toNode({ providedIn: 'root' })] : []),
+            ],
+            export: true,
+            extends: ctx.refs.apiBaseService(),
+            members: [
+                ...ctx.service.endpoints.map((e) => ts.property(this.getEndpointPathPropertyName(ctx, e), {
+                    accessModifier: 'private',
+                    static: true,
+                    readonly: true,
+                    value: ts.string(e.path),
+                })),
+                ...ctx.service.endpoints.map((e) => this.getEndpointMethod(ctx, e)),
+            ],
+        });
+    }
+    getEndpointMethod(ctx, endpoint) {
+        var _a;
+        const hasParams = this.hasEndpointParams(ctx, endpoint);
+        const paramsOptional = !endpoint.parameters.some((p) => p.required) && !((_a = endpoint.requestBody) === null || _a === void 0 ? void 0 : _a.required);
+        const responseModelType = ts.reference(this.getResponseModelName(ctx, endpoint), this.getResponseModelFilePath(ctx), {
+            importType: 'type-import',
+        });
+        const returnType = ctx.refs.abortablePromise([responseModelType]);
+        const accept = this.getEndpointSuccessResponseType(ctx, endpoint);
+        const responseType = this.contentTypeToResponseType(accept);
+        return ts.method(this.getEndpointMethodName(ctx, endpoint), {
+            accessModifier: 'public',
+            parameters: [
+                hasParams
+                    ? ts.parameter('params', {
+                        optional: paramsOptional,
+                        type: ts.reference(this.getEndpointParamsTypeName(ctx, endpoint)),
+                    })
+                    : null,
+                ts.parameter('context', { optional: true, type: ts.refs.angular.httpContext() }),
+            ],
+            doc: ts.doc({
+                description: endpoint.description,
+                tags: [endpoint.deprecated ? ts.docTag('deprecated') : null],
+            }),
+            returnType,
+            body: appendValueGroup([
+                s `const rb = new ${ctx.refs.requestBuilder()}(this.rootUrl, ${this.getServiceClassName(ctx)}.${this.getEndpointPathPropertyName(ctx, endpoint)}, '${endpoint.method}');`,
+                hasParams
+                    ? (b) => {
+                        var _a;
+                        return b.appendIf(paramsOptional, 'if (params) ').parenthesizeIf(paramsOptional, '{}', appendValueGroup([
+                            ...endpoint.parameters
+                                .filter((p) => p.target === 'path' || p.target === 'query' || p.target === 'header')
+                                .map((p) => {
+                                const options = ts.object({
+                                    members: [
+                                        p.style !== undefined ? ts.property('style', { value: ts.string(p.style) }) : null,
+                                        p.explode !== undefined ? ts.property('explode', { value: ts.toNode(p.explode) }) : null,
+                                    ],
+                                });
+                                return s `rb.${p.target}(${ts.string(p.name)}, params.${toCasing(p.name, ctx.config.propertyNameCasing)}, ${options});`;
+                            }),
+                            endpoint.requestBody
+                                ? s `rb.body(params.body, ${ts.string((_a = endpoint.requestBody.content[0].type) !== null && _a !== void 0 ? _a : 'application/json')});`
+                                : null,
+                        ], '\n'), { multiline: true });
+                    }
+                    : null,
+                '',
+                s `return ${ctx.refs.waitForResponse([responseModelType])}(${s.indent `
+              this.http.request(rb.build({${s.indent `
+                responseType: ${ts.string(responseType)},
+                accept: ${ts.string(accept)},
+                context,`}
+              })),
+              {${s.indent `
+                errorResponseTypes: ${ts.object({
+                    members: [
+                        ...Object.entries(this.getEndpointStatusCodes(ctx, endpoint))
+                            .filter(([key]) => !key.startsWith('2'))
+                            .map(([key, value]) => {
+                            return ts.property(key, { value: ts.string(value.parser) });
+                        }),
+                    ],
+                })}`}
+              }`}
+            )`,
+            ], '\n'),
+        });
+    }
+    getEndpointSuccessResponseType(ctx, endpoint) {
+        var _a, _b, _c, _d, _e, _f;
+        const response = this.getEndpointSuccessResponse(ctx, endpoint);
+        if (!response)
+            return '*/*';
+        if (!ctx.config.defaultSuccessResponseType)
+            return (_b = (_a = response.contentOptions[0]) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : '*/*';
+        return ((_f = (_d = (_c = response.contentOptions.find((x) => x.type === ctx.config.defaultSuccessResponseType)) === null || _c === void 0 ? void 0 : _c.type) !== null && _d !== void 0 ? _d : (_e = response.contentOptions[0]) === null || _e === void 0 ? void 0 : _e.type) !== null && _f !== void 0 ? _f : '*/*');
+    }
+    getEndpointSuccessResponse(_ctx, endpoint) {
+        var _a;
+        return ((_a = endpoint.responses.find((x) => x.statusCode && x.statusCode >= 200 && x.statusCode < 300)) !== null && _a !== void 0 ? _a : endpoint.responses.find((x) => x.statusCode === undefined));
+    }
+    getServiceClassName(ctx) {
+        return toCasing(ctx.service.name + '_Service', ctx.config.typeNameCasing);
+    }
+    getResponseModelName(ctx, endpoint) {
+        return toCasing(`${this.getEndpointMethodName(ctx, endpoint)}ApiResponse`, ctx.config.typeNameCasing);
+    }
+    getEndpointParamsTypeName(ctx, endpoint) {
+        return toCasing(this.getEndpointMethodName(ctx, endpoint) + '_Params', ctx.config.typeNameCasing);
+    }
+    getEndpointPathPropertyName(ctx, endpoint) {
+        return toCasing(this.getEndpointMethodName(ctx, endpoint) + '_Path', ctx.config.constantNameCasing);
+    }
+    getEndpointMethodName(ctx, endpoint) {
+        return toCasing(endpoint.name, ctx.config.functionNameCasing);
+    }
+    getServiceFilePath(ctx) {
+        var _a;
+        return resolve(ctx.config.outputDir, ctx.config.servicesDir, `${toCasing(ctx.service.name, (_a = ctx.config.serviceFileNameCasing) !== null && _a !== void 0 ? _a : ctx.config.fileNameCasing)}.ts`);
+    }
+    getResponseModelFilePath(ctx) {
+        var _a;
+        return resolve(ctx.config.outputDir, ctx.config.responseModelsDir, `${toCasing(ctx.service.name, (_a = ctx.config.responseModelFileNameCasing) !== null && _a !== void 0 ? _a : ctx.config.fileNameCasing)}.ts`);
+    }
+    hasEndpointParams(_ctx, endpoint) {
+        return endpoint.parameters.length > 0 || endpoint.requestBody !== undefined;
+    }
+    getSchemaType(ctx, schema, fallback) {
+        const output = schema && ctx.input.typescript.models[schema.id];
+        if (!output)
+            return fallback !== null && fallback !== void 0 ? fallback : this.getAnyType(ctx);
+        return (b) => b.appendModelUsage(output);
+    }
+    contentTypeToResponseType(contentType) {
+        return (contentType === null || contentType === void 0 ? void 0 : contentType.includes('json')) ? 'json' : 'text';
+    }
+}

package/esm/src/generators/services/angular-services/angular-services-generator.d.ts

@@ -0,0 +1,31 @@
+import { type ApiService, type AppendValueGroup, Factory, type MaybePromise, type OpenApiGeneratorContext, OpenApiServicesGenerationProviderBase } from '@goast/core';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { type TypeScriptAngularServiceGenerator } from './angular-service-generator.js';
+import { type TypeScriptAngularServiceGeneratorOutput, type TypeScriptAngularServicesGeneratorConfig, type TypeScriptAngularServicesGeneratorContext, type TypeScriptAngularServicesGeneratorInput, type TypeScriptAngularServicesGeneratorOutput } from './models.js';
+type Input = TypeScriptAngularServicesGeneratorInput;
+type Output = TypeScriptAngularServicesGeneratorOutput;
+type Config = TypeScriptAngularServicesGeneratorConfig;
+type ServiceOutput = TypeScriptAngularServiceGeneratorOutput;
+type Context = TypeScriptAngularServicesGeneratorContext;
+export declare class TypeScriptAngularServicesGenerator extends OpenApiServicesGenerationProviderBase<Input, Output, Config, ServiceOutput, Context> {
+    private readonly _clientGeneratorFactory;
+    constructor(clientGeneratorFactory?: Factory<TypeScriptAngularServiceGenerator, []>);
+    protected initResult(): Output;
+    protected buildContext(context: OpenApiGeneratorContext<Input>, config?: Partial<Config> | undefined): Context;
+    protected generateAdditionalFiles(ctx: TypeScriptAngularServicesGeneratorContext): Promise<void>;
+    protected generateService(ctx: Context, service: ApiService): MaybePromise<ServiceOutput>;
+    protected addServiceResult(ctx: Context, service: ApiService, result: ServiceOutput): void;
+    protected generateUtilsFiles(ctx: Context): Promise<void>;
+    protected getApiConfigurationFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getApiBaseServiceFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getHttpStatusCodeFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getProvideFnFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getRootUrl(ctx: Context): string;
+    protected generateIndexFiles(ctx: Context): Output['typescript']['indexFiles'];
+    protected getServicesIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getResponseModelsIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getServicesIndexFilePath(ctx: Context): string | null;
+    protected getResponseModelsIndexFilePath(ctx: Context): string | null;
+}
+export {};
+//# sourceMappingURL=angular-services-generator.d.ts.map

package/esm/src/generators/services/angular-services/angular-services-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-services-generator.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/angular-services/angular-services-generator.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,qCAAqC,EAEtC,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,uCAAuC,EAC5C,KAAK,wCAAwC,EAC7C,KAAK,yCAAyC,EAC9C,KAAK,uCAAuC,EAC5C,KAAK,wCAAwC,EAC9C,MAAM,aAAa,CAAC;AAGrB,KAAK,KAAK,GAAG,uCAAuC,CAAC;AACrD,KAAK,MAAM,GAAG,wCAAwC,CAAC;AACvD,KAAK,MAAM,GAAG,wCAAwC,CAAC;AACvD,KAAK,aAAa,GAAG,uCAAuC,CAAC;AAC7D,KAAK,OAAO,GAAG,yCAAyC,CAAC;AAEzD,qBAAa,kCAAmC,SAAQ,qCAAqC,CAC3F,KAAK,EACL,MAAM,EACN,MAAM,EACN,aAAa,EACb,OAAO,CACR;IACC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAiD;gBAE7E,sBAAsB,CAAC,EAAE,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;cAMhE,UAAU,IAAI,MAAM;cASpB,YAAY,CAC7B,OAAO,EAAE,uBAAuB,CAAC,KAAK,CAAC,EACvC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,GACnC,OAAO;cAOe,uBAAuB,CAAC,GAAG,EAAE,yCAAyC,GAAG,OAAO,CAAC,IAAI,CAAC;cAK5F,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,CAAC,aAAa,CAAC;cAQ/E,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;cAKnF,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC/D,SAAS,CAAC,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAwB/F,SAAS,CAAC,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAkC7F,SAAS,CAAC,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAY7F,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IA+BxF,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAS1C,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC;IAwB9E,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAU5F,SAAS,CAAC,iCAAiC,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAQlG,SAAS,CAAC,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAI/D,SAAS,CAAC,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAMtE"}

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

@@ -0,0 +1,213 @@
+import { resolve } from 'node:path';
+import fs from 'fs-extra';
+import { appendValueGroup, Factory, OpenApiServicesGenerationProviderBase, toCasing, } from '@goast/core';
+import { copyAssetFile } from '../../../assets.js';
+import { ts } from '../../../ast/index.js';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { modifyString } from '../../../utils.js';
+import { DefaultTypeScriptAngularServiceGenerator, } from './angular-service-generator.js';
+import { defaultTypeScriptAngularServicesGeneratorConfig, } from './models.js';
+import { getReferenceFactories } from './refs.js';
+export class TypeScriptAngularServicesGenerator extends OpenApiServicesGenerationProviderBase {
+    constructor(clientGeneratorFactory) {
+        super();
+        Object.defineProperty(this, "_clientGeneratorFactory", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this._clientGeneratorFactory = clientGeneratorFactory !== null && clientGeneratorFactory !== void 0 ? clientGeneratorFactory : Factory.fromValue(new DefaultTypeScriptAngularServiceGenerator());
+    }
+    initResult() {
+        return {
+            typescript: {
+                services: {},
+                indexFiles: { services: undefined, responseModels: undefined },
+            },
+        };
+    }
+    buildContext(context, config) {
+        const providerContext = this.getProviderContext(context, config, defaultTypeScriptAngularServicesGeneratorConfig);
+        return Object.assign(providerContext, {
+            refs: getReferenceFactories(providerContext.config),
+        });
+    }
+    async generateAdditionalFiles(ctx) {
+        await this.generateUtilsFiles(ctx);
+        ctx.output.typescript.indexFiles = this.generateIndexFiles(ctx);
+    }
+    generateService(ctx, service) {
+        const clientGenerator = this._clientGeneratorFactory.create();
+        return clientGenerator.generate({
+            ...ctx,
+            service,
+        });
+    }
+    addServiceResult(ctx, service, result) {
+        ctx.output.typescript.services[service.id] = result;
+    }
+    // #region Utils
+    async generateUtilsFiles(ctx) {
+        const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDir);
+        await fs.ensureDir(targetDir);
+        await copyAssetFile('client/angular/request-builder.ts', targetDir, 'Request Builder');
+        await copyAssetFile('client/angular/angular-service.utils.ts', targetDir, 'Angular Service Utils');
+        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)),
+            });
+        }
+    }
+    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 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.typescript.services).map((x) => ts.reference(x.component, x.filePath)),
+                    ]),
+                    ';',
+                ]),
+            }),
+        ], '\n');
+    }
+    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);
+    }
+    // #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,
+        };
+    }
+    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.typescript.services).map((x) => ts.export(x.component, x.filePath)),
+        ]);
+    }
+    getResponseModelsIndexFileContent(ctx) {
+        return appendValueGroup(Object.values(ctx.output.typescript.services)
+            .flatMap((x) => Object.values(x.responseModels))
+            .map((x) => ts.export(x.component, x.filePath, { kind: 'type-export' })));
+    }
+    getServicesIndexFilePath(ctx) {
+        return ctx.config.servicesIndexFile ? resolve(ctx.config.outputDir, ctx.config.servicesIndexFile) : null;
+    }
+    getResponseModelsIndexFilePath(ctx) {
+        return ctx.config.responseModelsIndexFile
+            ? resolve(ctx.config.outputDir, ctx.config.responseModelsIndexFile)
+            : null;
+    }
+}

package/esm/src/generators/services/angular-services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/angular-services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,aAAa,CAAC"}