@goast/typescript 0.3.13 → 0.4.0-beta2

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

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeScriptAngularServicesGenerator = void 0;
+const tslib_1 = require("tslib");
+const node_path_1 = require("node:path");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const core_1 = require("@goast/core");
+const angular_service_generator_js_1 = require("./angular-service-generator.js");
+const models_js_1 = require("./models.js");
+const refs_js_1 = require("./refs.js");
+const index_js_1 = require("../../../ast/index.js");
+const file_builder_js_1 = require("../../../file-builder.js");
+const utils_js_1 = require("../../../utils.js");
+const assets_js_1 = require("../../../assets.js");
+class TypeScriptAngularServicesGenerator extends core_1.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 : core_1.Factory.fromValue(new angular_service_generator_js_1.DefaultTypeScriptAngularServiceGenerator());
+    }
+    initResult() {
+        return {
+            typescript: {
+                services: {},
+                indexFiles: { services: undefined, responseModels: undefined },
+            },
+        };
+    }
+    buildContext(context, config) {
+        const providerContext = this.getProviderContext(context, config, models_js_1.defaultTypeScriptAngularServicesGeneratorConfig);
+        return Object.assign(providerContext, {
+            refs: (0, refs_js_1.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 = (0, node_path_1.resolve)(ctx.config.outputDir, ctx.config.utilsDir);
+        await fs_extra_1.default.ensureDir(targetDir);
+        await (0, assets_js_1.copyAssetFile)('client/angular/request-builder.ts', targetDir, 'Request Builder');
+        await (0, assets_js_1.copyAssetFile)('client/angular/angular-service.utils.ts', targetDir, 'Angular Service Utils');
+        file_builder_js_1.TypeScriptFileBuilder.generate({
+            logName: 'api configuration',
+            filePath: (0, node_path_1.resolve)(targetDir, 'api-configuration.ts'),
+            options: ctx.config,
+            generator: (b) => b.append(this.getApiConfigurationFileContent(ctx)),
+        });
+        file_builder_js_1.TypeScriptFileBuilder.generate({
+            logName: 'api base service',
+            filePath: (0, node_path_1.resolve)(targetDir, 'api-base-service.ts'),
+            options: ctx.config,
+            generator: (b) => b.append(this.getApiBaseServiceFileContent(ctx)),
+        });
+        if (!ctx.config.strictResponseTypes) {
+            file_builder_js_1.TypeScriptFileBuilder.generate({
+                logName: 'http status codes',
+                filePath: (0, node_path_1.resolve)(targetDir, 'http-status-code.ts'),
+                options: ctx.config,
+                generator: (b) => b.append(this.getHttpStatusCodeFileContent(ctx)),
+            });
+        }
+        if (ctx.config.provideKind === 'provide-fn') {
+            file_builder_js_1.TypeScriptFileBuilder.generate({
+                logName: 'providers',
+                filePath: (0, node_path_1.resolve)(targetDir, 'provide.ts'),
+                options: ctx.config,
+                generator: (b) => b.append(this.getProvideFnFileContent(ctx)),
+            });
+        }
+    }
+    getApiConfigurationFileContent(ctx) {
+        var _a, _b;
+        return (0, core_1.appendValueGroup)([
+            index_js_1.ts.class((0, core_1.toCasing)(`${(_a = ctx.config.domainName) !== null && _a !== void 0 ? _a : ''}ApiConfiguration`, ctx.config.typeNameCasing), {
+                doc: index_js_1.ts.doc({ description: `${(_b = ctx.config.domainName) !== null && _b !== void 0 ? _b : 'Global'} API Configuration.` }),
+                decorators: [
+                    index_js_1.ts.decorator(index_js_1.ts.refs.angular.injectable(), [
+                        ctx.config.provideKind === 'root' ? index_js_1.ts.toNode({ providedIn: 'root' }) : null,
+                    ]),
+                ],
+                export: true,
+                members: [
+                    index_js_1.ts.property('rootUrl', {
+                        accessModifier: 'public',
+                        type: index_js_1.ts.refs.string(),
+                        value: index_js_1.ts.string(this.getRootUrl(ctx)),
+                    }),
+                ],
+            }),
+        ], '\n');
+    }
+    getApiBaseServiceFileContent(ctx) {
+        return (0, core_1.appendValueGroup)([
+            index_js_1.ts.class('ApiBaseService', {
+                doc: index_js_1.ts.doc({ description: 'Base class for API services.' }),
+                export: true,
+                abstract: true,
+                members: [
+                    index_js_1.ts.property('config', {
+                        accessModifier: 'protected',
+                        value: (b) => b.append(index_js_1.ts.refs.angular.inject(), '(', ctx.refs.apiConfiguration(), ')'),
+                    }),
+                    index_js_1.ts.property('http', {
+                        accessModifier: 'protected',
+                        value: (b) => b.append(index_js_1.ts.refs.angular.inject(), '(', index_js_1.ts.refs.angular.httpClient(), ')'),
+                    }),
+                    index_js_1.ts.property('_rootUrl', { accessModifier: 'private', type: index_js_1.ts.refs.string(), value: index_js_1.ts.string('') }),
+                    index_js_1.ts.property('rootUrl', {
+                        doc: index_js_1.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: index_js_1.ts.refs.string(),
+                        get: index_js_1.ts.property.getter({ body: 'return this._rootUrl || this.config.rootUrl;' }),
+                        set: index_js_1.ts.property.setter({ body: 'this._rootUrl = value;' }),
+                    }),
+                ],
+            }),
+        ], '\n');
+    }
+    getHttpStatusCodeFileContent(ctx) {
+        return (0, core_1.appendValueGroup)([
+            index_js_1.ts.typeAlias('HttpStatusCode', index_js_1.ts.unionType(ctx.config.possibleStatusCodes), {
+                doc: index_js_1.ts.doc({ description: 'The possible status codes that any API endpoint can return.' }),
+                export: true,
+            }),
+        ], '\n');
+    }
+    getProvideFnFileContent(ctx) {
+        var _a;
+        return (0, core_1.appendValueGroup)([
+            index_js_1.ts.function((0, core_1.toCasing)(`provide_${(_a = ctx.config.domainName) !== null && _a !== void 0 ? _a : ''}_Api`, ctx.config.functionNameCasing), {
+                doc: index_js_1.ts.doc({
+                    description: 'Provides all the API services' +
+                        (ctx.config.domainName ? ` for ${ctx.config.domainName}` : '') + '.',
+                }),
+                export: true,
+                parameters: [index_js_1.ts.parameter('config', { type: ctx.refs.apiConfiguration(), optional: true })],
+                returnType: index_js_1.ts.refs.angular.provider(),
+                body: (0, core_1.appendValueGroup)([
+                    'return ',
+                    index_js_1.ts.tuple([
+                        (b) => b.append('config ? { provide: ', ctx.refs.apiConfiguration(), ', useValue: config } : ', ctx.refs.apiConfiguration()),
+                        ...Object.values(ctx.output.typescript.services).map((x) => index_js_1.ts.reference(x.component, x.filePath)),
+                    ]),
+                    ';',
+                ]),
+            }),
+        ], '\n');
+    }
+    getRootUrl(ctx) {
+        var _a, _b, _c, _d, _e, _f;
+        return (0, utils_js_1.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);
+        file_builder_js_1.TypeScriptFileBuilder.tryGenerate({
+            logName: 'services index file',
+            filePath: servicesIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getServicesIndexFileContent(ctx)),
+        });
+        file_builder_js_1.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 (0, core_1.appendValueGroup)([
+            index_js_1.ts.export(ctx.refs.apiConfiguration.refName, ctx.refs.apiConfiguration.moduleNameOrfilePath),
+            ctx.config.provideKind === 'provide-fn'
+                ? index_js_1.ts.export(ctx.refs.provide.refName, ctx.refs.provide.moduleNameOrfilePath)
+                : null,
+            ...Object.values(ctx.output.typescript.services).map((x) => index_js_1.ts.export(x.component, x.filePath)),
+        ]);
+    }
+    getResponseModelsIndexFileContent(ctx) {
+        return (0, core_1.appendValueGroup)(Object.values(ctx.output.typescript.services)
+            .flatMap((x) => Object.values(x.responseModels))
+            .map((x) => index_js_1.ts.export(x.component, x.filePath, { kind: 'type-export' })));
+    }
+    getServicesIndexFilePath(ctx) {
+        return ctx.config.servicesIndexFile ? (0, node_path_1.resolve)(ctx.config.outputDir, ctx.config.servicesIndexFile) : null;
+    }
+    getResponseModelsIndexFilePath(ctx) {
+        return ctx.config.responseModelsIndexFile
+            ? (0, node_path_1.resolve)(ctx.config.outputDir, ctx.config.responseModelsIndexFile)
+            : null;
+    }
+}
+exports.TypeScriptAngularServicesGenerator = TypeScriptAngularServicesGenerator;

package/script/lib/generators/services/angular-services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './angular-service-generator.js';
+export * from './angular-services-generator.js';
+export * from './models.js';
+//# sourceMappingURL=index.d.ts.map

package/script/lib/generators/services/angular-services/index.d.ts.map

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

package/script/lib/generators/services/angular-services/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./angular-service-generator.js"), exports);
+tslib_1.__exportStar(require("./angular-services-generator.js"), exports);
+tslib_1.__exportStar(require("./models.js"), exports);

package/script/lib/generators/services/angular-services/models.d.ts

@@ -0,0 +1,142 @@
+import type { ApiEndpoint, ApiSchema, ApiService, DefaultGenerationProviderConfig, ExtendedStringCasing, Nullable, OpenApiServicesGenerationProviderContext } from '@goast/core';
+import type { getReferenceFactories } from './refs.js';
+import type { ts } from '../../../ast/index.js';
+import type { TypeScriptExportOutput } from '../../../common-results.js';
+import { type TypeScriptGeneratorConfig } from '../../../config.js';
+import type { TypeScriptFileBuilder } from '../../../file-builder.js';
+import type { TypeScriptModelGeneratorOutput } from '../../models/index.js';
+export type TypeScriptAngularServicesGeneratorConfig = TypeScriptGeneratorConfig & {
+    /**
+     * How the services should be provided in the Angular application.
+     * - `root` - provides all the services using `Injectable({ providedIn: 'root' })`
+     * - `provide-fn` - generates a function `provideApiClients` that provides the services
+     * @default 'root'
+     */
+    provideKind: 'root' | 'provide-fn';
+    /**
+     * The domain name of the API. Used as a prefix for exported components (e.g. `ApiConfiguration`).
+     * @default undefined
+     */
+    domainName: Nullable<string>;
+    /**
+     * Whether to use strict response types for the services.
+     * If enabled only the status codes are included that are defined in the OpenAPI specification or the `defaultStatusCodeResponseTypes` option.
+     * @default true
+     */
+    strictResponseTypes: boolean;
+    /**
+     * The default response types for status codes that are not defined in the OpenAPI specification.
+     * @example
+     * {
+     *   400: {
+     *     parser: 'json',
+     *     type: schemas =>
+     *       schemas.find(s => s.name === 'BadRequestResponse')
+     *         ?? throwExp('BadRequestResponse not found'),
+     *   },
+     *   404: null,
+     *   500: {
+     *     parser: 'json',
+     *     type: ts.refs.any(),
+     *   },
+     * }
+     * @default
+     * {
+     *   401: null,
+     *   403: null,
+     *   500: null,
+     * }
+     */
+    defaultStatusCodeResponseTypes: Record<number, {
+        parser: 'text' | 'json';
+        type: Exclude<ts.Type<TypeScriptFileBuilder>, Function> | ((schemas: readonly ApiSchema[]) => ApiSchema);
+    } | null>;
+    /**
+     * The default content type which is used for the success response. If not defined the first one defined in the OpenApi specification is used.
+     * @default undefined
+     */
+    defaultSuccessResponseType: Nullable<string>;
+    /**
+     * The possible status codes that any API endpoint can return.
+     * This is only used when `strictResponseTypes` is set to `false`.
+     * @default
+     * [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]
+     */
+    possibleStatusCodes: number[];
+    /**
+     * Explicitly set the root URL of the API. If `undefined`, the root URL is taken from the first `server` in the OpenAPI specification.
+     * @default undefined
+     */
+    rootUrl: Nullable<string | RegExp | ((rootUrl: string) => string)>;
+    /**
+     * Modifier that is applied to the path of each endpoint.
+     * @default undefined
+     */
+    pathModifier: Nullable<RegExp | ((path: string, endpoint: ApiEndpoint) => string)>;
+    /**
+     * The directory where the services should be saved. The path is relative to the output directory.
+     * @default 'services'
+     */
+    servicesDir: string;
+    /**
+     * The casing of the file names for the services. If nullish, the `fileNameCasing` is used.
+     * @default { casing: 'kebab', suffix: '.service' }
+     */
+    serviceFileNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * The path to the index file where all services should be exported. The path is relative to the output directory. If nullish, no index file will be generated.
+     * @default 'services.ts'
+     */
+    servicesIndexFile: Nullable<string>;
+    /**
+     * The directory where the response models should be saved. The path is relative to the output directory.
+     * @default 'models/responses'
+     */
+    responseModelsDir: string;
+    /**
+     * The casing of the file names for the response models. If nullish, the `fileNameCasing` is used.
+     * @default { casing: 'kebab', suffix: '-responses.model' }
+     */
+    responseModelFileNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * The path to the index file where all response models should be exported. The path is relative to the output directory. If nullish, no index file will be generated.
+     * @default 'responses.ts'
+     */
+    responseModelsIndexFile: Nullable<string>;
+    /**
+     * The directory where the utilies should be saved. The path is relative to the output directory.
+     * @default 'utils'
+     */
+    utilsDir: string;
+};
+export declare const defaultTypeScriptAngularServicesGeneratorConfig: DefaultGenerationProviderConfig<TypeScriptAngularServicesGeneratorConfig>;
+export type TypeScriptAngularServicesGeneratorInput = {
+    typescript: {
+        models: {
+            [schemaId: string]: TypeScriptModelGeneratorOutput;
+        };
+    };
+};
+export type TypeScriptAngularServicesGeneratorOutput = {
+    typescript: {
+        services: {
+            [serviceId: string]: TypeScriptAngularServiceGeneratorOutput;
+        };
+        indexFiles: {
+            services: Nullable<string>;
+            responseModels: Nullable<string>;
+        };
+    };
+};
+export type TypeScriptAngularServiceGeneratorOutput = TypeScriptExportOutput & {
+    responseModels: {
+        [operationId: string]: TypeScriptExportOutput;
+    };
+};
+export type TypeScriptAngularServicesGeneratorContext = OpenApiServicesGenerationProviderContext<TypeScriptAngularServicesGeneratorInput, TypeScriptAngularServicesGeneratorOutput, TypeScriptAngularServicesGeneratorConfig, TypeScriptAngularServiceGeneratorOutput> & {
+    refs: ReturnType<typeof getReferenceFactories>;
+};
+export type TypeScriptAngularServiceGeneratorContext = TypeScriptAngularServicesGeneratorContext & {
+    readonly service: ApiService;
+};
+//# sourceMappingURL=models.d.ts.map

package/script/lib/generators/services/angular-services/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../../src/lib/generators/services/angular-services/models.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTypeScriptAngularServicesGeneratorConfig = void 0;
+const config_js_1 = require("../../../config.js");
+exports.defaultTypeScriptAngularServicesGeneratorConfig = {
+    ...config_js_1.defaultTypeScriptGeneratorConfig,
+    provideKind: 'provide-fn',
+    domainName: undefined,
+    strictResponseTypes: true,
+    defaultStatusCodeResponseTypes: {
+        401: null,
+        403: null,
+        500: null,
+    },
+    defaultSuccessResponseType: undefined,
+    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,
+    ],
+    rootUrl: undefined,
+    pathModifier: undefined,
+    servicesDir: 'services',
+    serviceFileNameCasing: { casing: 'kebab', suffix: '.service' },
+    servicesIndexFile: 'services.ts',
+    responseModelsDir: 'models/responses',
+    responseModelFileNameCasing: { casing: 'kebab', suffix: '-responses.model' },
+    responseModelsIndexFile: 'responses.ts',
+    utilsDir: 'utils',
+};

package/script/lib/generators/services/angular-services/refs.d.ts

@@ -0,0 +1,63 @@
+import { ts } from '../../../ast/index.js';
+import type { TypeScriptAngularServicesGeneratorConfig } from './models.js';
+export declare function getReferenceFactories(options: TypeScriptAngularServicesGeneratorConfig): {
+    abortablePromise: (<TBuilder extends import("@goast/core").SourceBuilder>(generics: [ts.Type<TBuilder>], options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    } | undefined) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+        infer: <TBuilder extends import("@goast/core").SourceBuilder>() => ts.Reference<TBuilder, never>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    waitForResponse: (<TBuilder extends import("@goast/core").SourceBuilder>(generics: [ts.Type<TBuilder>], options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    } | undefined) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+        infer: <TBuilder extends import("@goast/core").SourceBuilder>() => ts.Reference<TBuilder, never>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    requestBuilder: (<TBuilder extends import("@goast/core").SourceBuilder>(options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    }) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    apiConfiguration: (<TBuilder extends import("@goast/core").SourceBuilder>(options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    }) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    apiBaseService: (<TBuilder extends import("@goast/core").SourceBuilder>(options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    }) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    httpStatusCode: (<TBuilder extends import("@goast/core").SourceBuilder>(options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    }) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+    provide: (<TBuilder extends import("@goast/core").SourceBuilder>(options?: {
+        importType?: import("@goast/core").Nullable<import("../../../common-results.js").TypeScriptImportType>;
+    }) => ts.Reference<TBuilder, never>) & {
+        refName: string;
+        moduleNameOrfilePath: import("@goast/core").Nullable<string>;
+    } & {
+        moduleNameOrfilePath: string;
+    };
+};
+//# sourceMappingURL=refs.d.ts.map

package/script/lib/generators/services/angular-services/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../../src/lib/generators/services/angular-services/refs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAE3C,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,aAAa,CAAC;AAG5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCtF"}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReferenceFactories = getReferenceFactories;
+const node_path_1 = require("node:path");
+const core_1 = require("@goast/core");
+const index_js_1 = require("../../../ast/index.js");
+// See packages/typescript/assets/client/angular for reference
+function getReferenceFactories(options) {
+    var _a, _b;
+    const utilsDirPath = (0, node_path_1.resolve)(options.outputDir, options.utilsDir);
+    return {
+        // angular-service.utils.ts
+        abortablePromise: index_js_1.ts.reference.genericFactory('AbortablePromise', (0, node_path_1.join)(utilsDirPath, 'angular-service.utils.ts'), {
+            importType: 'type-import',
+        }),
+        waitForResponse: index_js_1.ts.reference.genericFactory('waitForResponse', (0, node_path_1.join)(utilsDirPath, 'angular-service.utils.ts')),
+        // request-builder.ts
+        requestBuilder: index_js_1.ts.reference.factory('RequestBuilder', (0, node_path_1.join)(utilsDirPath, 'request-builder.ts')),
+        // api-configuration.ts - generated in angular-services-generator.ts
+        apiConfiguration: index_js_1.ts.reference.factory((0, core_1.toCasing)(`${(_a = options.domainName) !== null && _a !== void 0 ? _a : ''}ApiConfiguration`, options.typeNameCasing), (0, node_path_1.join)(utilsDirPath, 'api-configuration.ts')),
+        // api-base-service.ts - generated in angular-service-generator.ts
+        apiBaseService: index_js_1.ts.reference.factory('ApiBaseService', (0, node_path_1.join)(utilsDirPath, 'api-base-service.ts')),
+        // http-status-code.ts - generated in angular-services-generator.ts
+        httpStatusCode: index_js_1.ts.reference.factory('HttpStatusCode', (0, node_path_1.join)(utilsDirPath, 'http-status-code.ts'), {
+            importType: 'type-import',
+        }),
+        // provide.ts - generated in angular-services-generator.ts
+        provide: index_js_1.ts.reference.factory((0, core_1.toCasing)(`provide_${(_b = options.domainName) !== null && _b !== void 0 ? _b : ''}_Api`, options.functionNameCasing), (0, node_path_1.join)(utilsDirPath, 'provide.ts')),
+    };
+}

package/script/lib/generators/services/easy-network-stub/easy-network-stub-generator.d.ts

@@ -0,0 +1,33 @@
+import { type ApiEndpoint, type ApiSchema, type AppendValueGroup, type MaybePromise } from '@goast/core';
+import type { TypeScriptEasyNetworkStubGeneratorContext, TypeScriptEasyNetworkStubGeneratorOutput } from './models.js';
+import { ts } from '../../../ast/index.js';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { TypeScriptFileGenerator } from '../../file-generator.js';
+type Context = TypeScriptEasyNetworkStubGeneratorContext;
+type Output = TypeScriptEasyNetworkStubGeneratorOutput;
+type Builder = TypeScriptFileBuilder;
+export interface TypeScriptEasyNetworkStubGenerator<TOutput extends Output = Output> {
+    generate(ctx: Context): MaybePromise<TOutput>;
+}
+export declare class DefaultTypeScriptEasyNetworkStubGenerator extends TypeScriptFileGenerator<Context, Output> implements TypeScriptEasyNetworkStubGenerator {
+    generate(ctx: Context): MaybePromise<Output>;
+    protected getStubFileContent(ctx: Context): AppendValueGroup<Builder>;
+    protected getResponderVariable(ctx: Context, endpoint: ApiEndpoint): ts.Variable<Builder>;
+    protected getStubClass(ctx: Context): ts.Class<Builder>;
+    protected getEndpointRequestsType(ctx: Context, endpoint: ApiEndpoint, options?: {
+        readonly?: boolean;
+    }): ts.Type<Builder>;
+    protected getEndpointStubMethod(ctx: Context, endpoint: ApiEndpoint): ts.Method<Builder>;
+    protected getStubFilePath(ctx: Context): string;
+    protected getResponderVariableName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getStubClassName(ctx: Context): string;
+    protected getEndpointPathPropertyName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointRequestsFieldName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointRequestsPropertyName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointStubMethodName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getStubRoute(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointStatusCodes(ctx: Context, endpoint: ApiEndpoint): Record<number, ts.Type<Builder>>;
+    protected getSchemaType(ctx: Context, schema: ApiSchema | undefined, fallback?: ts.Type<Builder>): ts.Type<Builder>;
+}
+export {};
+//# sourceMappingURL=easy-network-stub-generator.d.ts.map

package/script/lib/generators/services/easy-network-stub/easy-network-stub-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easy-network-stub-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/generators/services/easy-network-stub/easy-network-stub-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EAGrB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,yCAAyC,EAAE,wCAAwC,EAAE,MAAM,aAAa,CAAC;AACvH,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,KAAK,OAAO,GAAG,yCAAyC,CAAC;AACzD,KAAK,MAAM,GAAG,wCAAwC,CAAC;AACvD,KAAK,OAAO,GAAG,qBAAqB,CAAC;AAErC,MAAM,WAAW,kCAAkC,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACjF,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED,qBAAa,yCAA0C,SAAQ,uBAAuB,CAAC,OAAO,EAAE,MAAM,CACpG,YAAW,kCAAkC;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC;IAiBnD,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAOrE,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;IAgBzF,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAoDvD,SAAS,CAAC,uBAAuB,CAC/B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;IAUnB,SAAS,CAAC,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;IAiCxF,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAQ/C,SAAS,CAAC,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAI/E,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAIhD,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAIlF,SAAS,CAAC,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAInF,SAAS,CAAC,+BAA+B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAItF,SAAS,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAIhF,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAyBnE,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAYvG,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;CAKpH"}