@goast/typescript 0.4.0-beta4 → 0.4.1-beta1

package/esm/src/generators/services/fetch-clients/models.d.ts

@@ -0,0 +1,84 @@
+import type { ApiService, DefaultGenerationProviderConfig, ExtendedStringCasing, Nullable, OpenApiServicesGenerationProviderContext } from '@goast/core';
+import type { TypeScriptExportOutput } from '../../../common-results.js';
+import { type TypeScriptGeneratorConfig } from '../../../config.js';
+import type { TypeScriptModelsGeneratorOutput } from '../../models/models.js';
+import type { getReferenceFactories } from './refs.js';
+export type TypeScriptFetchClientsGeneratorConfig = TypeScriptGeneratorConfig & {
+    /**
+     * The casing of the client file names. If nullish, the `fileNameCasing` is used.
+     * @default { casing: 'kebab', suffix: '-client' }
+     */
+    clientFileNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * The casing of the client interface file names. If nullish, the `fileNameCasing` is used.
+     * @default { casing: 'kebab', suffix: '-client' }
+     */
+    clientInterfaceFileNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * The casing of the client names. If nullish, the `typeNameCasing` is used.
+     * @default { casing: 'pascal', suffix: 'Client' }
+     */
+    clientNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * The casing of the client interface names. If nullish, the `typeNameCasing` is used.
+     * @default { prefix: 'I', casing: 'pascal', suffix: 'Client' }
+     */
+    clientInterfaceNameCasing: Nullable<ExtendedStringCasing>;
+    /**
+     * Determines how the client files should be generated.
+     * - `interface` - generates only the interface
+     * - `class` - generates only the class
+     * - `class-and-interface` - generates both the class and the interface
+     * @default 'class'
+     */
+    clientFileKind: 'interface' | 'class' | 'class-and-interface';
+    /**
+     * The directory where the client files should be saved. The path is relative to the output directory.
+     * @default 'clients'
+     */
+    clientDir: string;
+    /**
+     * The directory where the client interface files should be saved. The path is relative to the output directory.
+     * @default 'clients/interfaces'
+     */
+    clientInterfaceDir: Nullable<string>;
+    /**
+     * The index file where all clients should be exported. The path is relative to the output directory. If nullish, no index file will be generated.
+     * @default 'clients.ts'
+     */
+    clientsIndexFile: Nullable<string>;
+    /**
+     * The index file where all client interfaces should be exported. The path is relative to the output directory. If nullish, no index file will be generated.
+     * @default 'clients.ts'
+     */
+    clientInterfacesIndexFile: 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 defaultTypeScriptFetchClientsGeneratorConfig: DefaultGenerationProviderConfig<TypeScriptFetchClientsGeneratorConfig>;
+export type TypeScriptFetchClientsGeneratorInput = TypeScriptModelsGeneratorOutput;
+export type TypeScriptFetchClientsGeneratorOutput = {
+    typescript: {
+        clients: {
+            [serviceId: string]: TypeScriptFetchClientGeneratorOutput;
+        };
+        indexFiles: {
+            clients: Nullable<string>;
+            clientInterfaces: Nullable<string>;
+        };
+    };
+};
+export type TypeScriptFetchClientGeneratorOutput = {
+    client?: TypeScriptExportOutput;
+    clientInterface?: TypeScriptExportOutput;
+};
+export type TypeScriptFetchClientsGeneratorContext = OpenApiServicesGenerationProviderContext<TypeScriptFetchClientsGeneratorInput, TypeScriptFetchClientsGeneratorOutput, TypeScriptFetchClientsGeneratorConfig, TypeScriptFetchClientGeneratorOutput> & {
+    refs: ReturnType<typeof getReferenceFactories>;
+};
+export type TypeScriptFetchClientGeneratorContext = TypeScriptFetchClientsGeneratorContext & {
+    readonly service: ApiService;
+};
+//# sourceMappingURL=models.d.ts.map

package/esm/src/generators/services/fetch-clients/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/fetch-clients/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,+BAA+B,EAC/B,oBAAoB,EACpB,QAAQ,EACR,wCAAwC,EACzC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAoC,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtG,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,qCAAqC,GAAG,yBAAyB,GAAG;IAC9E;;;OAGG;IACH,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAErD;;;OAGG;IACH,6BAA6B,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAE9D;;;OAGG;IACH,gBAAgB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAEjD;;;OAGG;IACH,yBAAyB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAE1D;;;;;;OAMG;IACH,cAAc,EAAE,WAAW,GAAG,OAAO,GAAG,qBAAqB,CAAC;IAE9D;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErC;;;OAGG;IACH,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEnC;;;OAGG;IACH,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE5C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,4CAA4C,EAAE,+BAA+B,CACxF,qCAAqC,CAgBtC,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,+BAA+B,CAAC;AAEnF,MAAM,MAAM,qCAAqC,GAAG;IAClD,UAAU,EAAE;QACV,OAAO,EAAE;YACP,CAAC,SAAS,EAAE,MAAM,GAAG,oCAAoC,CAAC;SAC3D,CAAC;QACF,UAAU,EAAE;YACV,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1B,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;SACpC,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAC9C,wCAAwC,CACxC,oCAAoC,EACpC,qCAAqC,EACrC,qCAAqC,EACrC,oCAAoC,CACrC,GACC;IACA,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;CAChD,CAAC;AAEJ,MAAM,MAAM,qCAAqC,GAAG,sCAAsC,GAAG;IAC3F,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B,CAAC"}

package/esm/src/generators/services/fetch-clients/refs.d.ts

@@ -0,0 +1,8 @@
+import { ts } from '../../../ast/index.js';
+import type { TypeScriptFetchClientsGeneratorConfig } from './models.js';
+export declare function getReferenceFactories(options: TypeScriptFetchClientsGeneratorConfig): {
+    typedResponse: ts.GenericModuleReferenceFactory<1>;
+    fetchClientOptions: ts.ModuleReferenceFactory;
+    urlBuilder: ts.ModuleReferenceFactory;
+};
+//# sourceMappingURL=refs.d.ts.map

package/esm/src/generators/services/fetch-clients/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/fetch-clients/refs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,aAAa,CAAC;AAGzE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qCAAqC,GAAG;IACrF,aAAa,EAAE,EAAE,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;IACnD,kBAAkB,EAAE,EAAE,CAAC,sBAAsB,CAAC;IAC9C,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC;CACvC,CAUA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/k6-clients/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC"}

package/esm/src/generators/services/k6-clients/k6-client-generator.d.ts

@@ -0,0 +1,40 @@
+import { type ApiEndpoint, type ApiResponse, type ApiSchema, type AppendValueGroup, type MaybePromise } from '@goast/core';
+import { ts } from '../../../ast/index.js';
+import type { TypeScriptExportOutput } from '../../../common-results.js';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import type { TypeScriptImportOptions } from '../../../import-collection.js';
+import { TypeScriptFileGenerator } from '../../file-generator.js';
+import type { TypeScriptK6ClientGeneratorContext, TypeScriptK6ClientGeneratorOutput } from './models.js';
+type Context = TypeScriptK6ClientGeneratorContext;
+type Output = TypeScriptK6ClientGeneratorOutput;
+type Builder = TypeScriptFileBuilder;
+export interface TypeScriptK6ClientGenerator<TOutput extends Output = Output> {
+    generate(context: Context): MaybePromise<TOutput>;
+}
+export declare class DefaultTypeScriptK6ClientGenerator extends TypeScriptFileGenerator<Context, Output> implements TypeScriptK6ClientGenerator {
+    generate(ctx: TypeScriptK6ClientGeneratorContext): MaybePromise<TypeScriptK6ClientGeneratorOutput>;
+    protected generateResponseModels(ctx: Context): Record<string, TypeScriptExportOutput>;
+    protected getResponseModelFileContent(ctx: Context, endpoint: ApiEndpoint): AppendValueGroup<Builder>;
+    protected getEndpointStatusCodes(ctx: Context, endpoint: ApiEndpoint): Record<number, {
+        type: ts.Type<Builder>;
+    }>;
+    protected getClientFileContent(ctx: Context): AppendValueGroup<Builder>;
+    protected getEndpointParamsType(ctx: Context, endpoint: ApiEndpoint): ts.Doc<Builder>;
+    protected getClass(ctx: Context): ts.Class<Builder>;
+    protected getEndpointMethod(ctx: Context, endpoint: ApiEndpoint): ts.Method<Builder>;
+    protected getGetK6ParamsMethod(_ctx: Context): ts.Method<Builder>;
+    protected getEndpointSuccessResponse(_ctx: Context, endpoint: ApiEndpoint): ApiResponse | undefined;
+    protected getSchemaType(ctx: Context, schema: ApiSchema | undefined, options?: TypeScriptImportOptions & {
+        fallback?: ts.Type<Builder>;
+    }): ts.Type<Builder>;
+    protected getClassName(ctx: Context): string;
+    protected getResponseModelName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointParamsTypeName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointPathPropertyName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getEndpointMethodName(ctx: Context, endpoint: ApiEndpoint): string;
+    protected getFilePath(ctx: Context): string;
+    protected getResponseModelFilePath(ctx: Context): string;
+    protected hasEndpointParams(_ctx: Context, endpoint: ApiEndpoint): boolean;
+}
+export {};
+//# sourceMappingURL=k6-client-generator.d.ts.map

package/esm/src/generators/services/k6-clients/k6-client-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k6-client-generator.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/k6-clients/k6-client-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,gBAAgB,EAGrB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,kCAAkC,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAEzG,KAAK,OAAO,GAAG,kCAAkC,CAAC;AAClD,KAAK,MAAM,GAAG,iCAAiC,CAAC;AAChD,KAAK,OAAO,GAAG,qBAAqB,CAAC;AAErC,MAAM,WAAW,2BAA2B,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAC1E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,qBAAa,kCAAmC,SAAQ,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAC7F,YAAW,2BAA2B;IACtB,QAAQ,CAAC,GAAG,EAAE,kCAAkC,GAAG,YAAY,CAAC,iCAAiC,CAAC;IAqBlH,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAetF,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAqErG,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAuBjH,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAqBvE,SAAS,CAAC,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAmCrF,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAwCnD,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;IAqFpF,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;IAajE,SAAS,CAAC,0BAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS;IAOnG,SAAS,CAAC,aAAa,CACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;KAAE,GAClE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;IAMnB,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5C,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAI3E,SAAS,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAIhF,SAAS,CAAC,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAIlF,SAAS,CAAC,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM;IAI5E,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAQ3C,SAAS,CAAC,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAQxD,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO;CAG3E"}

package/esm/src/generators/services/k6-clients/k6-client-generator.js

@@ -0,0 +1,311 @@
+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 DefaultTypeScriptK6ClientGenerator extends TypeScriptFileGenerator {
+    generate(ctx) {
+        const responseModels = this.generateResponseModels(ctx);
+        const filePath = this.getFilePath(ctx);
+        const name = this.getClassName(ctx);
+        TypeScriptFileBuilder.generate({
+            logName: `k6 client ${name}`,
+            filePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getClientFileContent(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]) => {
+                    return ts.intersectionType([
+                        ts.refs.omit([ts.refs.k6.response(), ts.string('json')]),
+                        ts.objectType({
+                            members: [
+                                ts.property('status', { type: key }),
+                                ts.method('json', {
+                                    returnType: value.type,
+                                }),
+                                ts.method('json', {
+                                    parameters: [ts.parameter('selector', { type: ts.refs.string() })],
+                                    returnType: ts.refs.k6.jsonValue(),
+                                }),
+                            ],
+                        }),
+                    ]);
+                }),
+                !ctx.config.strictResponseTypes
+                    ? ts.intersectionType([
+                        ts.refs.k6.response(),
+                        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;
+                return [
+                    x.statusCode,
+                    {
+                        type: this.getSchemaType(ctx, (_a = x.contentOptions[0]) === null || _a === void 0 ? void 0 : _a.schema, { fallback: ts.refs.never() }),
+                    },
+                ];
+            }),
+        ]);
+    }
+    // #endregion
+    getClientFileContent(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(appendValueGroup(ctx.service.endpoints.map((e) => ts.variable(this.getEndpointPathPropertyName(ctx, e), {
+            readonly: true,
+            value: ts.string(e.path),
+        }))));
+        code.values.push(this.getClass(ctx));
+        return code;
+    }
+    getEndpointParamsType(ctx, endpoint) {
+        const type = ts.doc({
+            description: `Parameters for operation ${this.getEndpointMethodName(ctx, endpoint)}`,
+            tags: [ts.docTag('typedef', this.getEndpointParamsTypeName(ctx, endpoint))],
+        });
+        for (const parameter of endpoint.parameters) {
+            const schema = parameter.schema;
+            const name = toCasing(parameter.name, ctx.config.propertyNameCasing);
+            type.tags.push(ts.docTag('property', parameter.required ? name : `[${name}]`, {
+                type: schema
+                    ? (b) => b.appendModelUsage(ctx.input.typescript.models[schema.id], { type: 'js-doc' })
+                    : this.getAnyType(ctx),
+                text: (parameter.deprecated ? 'Deprecated: ' : '') + parameter.description,
+            }));
+        }
+        if (endpoint.requestBody !== undefined) {
+            const body = endpoint.requestBody;
+            const schema = body.content[0].schema;
+            type.tags.push(ts.docTag('property', body.required ? 'body' : '[body]', {
+                type: schema
+                    ? (b) => b.appendModelUsage(ctx.input.typescript.models[schema.id], { type: 'js-doc' })
+                    : this.getAnyType(ctx),
+                text: body.description,
+            }));
+        }
+        return type;
+    }
+    getClass(ctx) {
+        return ts.class(this.getClassName(ctx), {
+            doc: ts.doc({
+                description: ctx.service.description,
+                tags: [
+                    ts.docTag('property', 'rootUrl', 'The root URL for this client.', {
+                        type: ts.refs.string(),
+                    }),
+                    ctx.service.endpoints.length === 0 || ctx.service.endpoints.some((x) => !x.deprecated)
+                        ? null
+                        : ts.docTag('deprecated'),
+                ],
+            }),
+            export: true,
+            members: [
+                ts.constructor({
+                    doc: ts.doc({
+                        description: 'Creates a new instance of the client.',
+                        tags: [
+                            ts.docTag('param', 'rootUrl', 'The root URL for this client.', { type: ts.refs.string() }),
+                            ts.docTag('param', '[defaultK6ParamsFactory]', 'A factory function that returns the default K6 parameters.', {
+                                type: ts.functionType({ returnType: ts.refs.k6.params({ importType: 'js-doc' }) }),
+                            }),
+                        ],
+                    }),
+                    parameters: [ts.constructorParameter('rootUrl'), ts.constructorParameter('defaultK6ParamsFactory')],
+                    body: s `this.rootUrl = rootUrl;
+                  this._defaultK6ParamsFactory = defaultK6ParamsFactory;`,
+                }),
+                ...ctx.service.endpoints.map((e) => this.getEndpointMethod(ctx, e)),
+                this.getGetK6ParamsMethod(ctx),
+            ],
+        });
+    }
+    getEndpointMethod(ctx, endpoint) {
+        var _a, _b, _c, _d;
+        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: 'js-doc',
+        });
+        const returnType = responseModelType;
+        const accept = (_d = (_c = (_b = this.getEndpointSuccessResponse(ctx, endpoint)) === null || _b === void 0 ? void 0 : _b.contentOptions[0]) === null || _c === void 0 ? void 0 : _c.type) !== null && _d !== void 0 ? _d : '*/*';
+        return ts.method(this.getEndpointMethodName(ctx, endpoint), {
+            async: ctx.config.async,
+            parameters: [hasParams ? ts.parameter('params') : null, ts.parameter('k6Params')],
+            doc: ts.doc({
+                description: endpoint.description,
+                tags: [
+                    hasParams
+                        ? ts.docTag('param', paramsOptional ? '[params]' : 'params', {
+                            type: ts.reference(this.getEndpointParamsTypeName(ctx, endpoint)),
+                        })
+                        : null,
+                    ts.docTag('param', '[k6Params]', {
+                        type: ts.refs.k6.params({ importType: 'js-doc' }),
+                    }),
+                    ts.docTag('returns', {
+                        type: ctx.config.async ? ts.refs.promise([returnType]) : returnType,
+                    }),
+                    endpoint.deprecated ? ts.docTag('deprecated') : null,
+                ],
+            }),
+            body: appendValueGroup([
+                s `const rb = new ${ctx.refs.requestBuilder()}(this.rootUrl, ${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 /** @type {${returnType}} */ (${s.indent `
+              ${ctx.config.async ? 'await rb.buildAsync' : 'rb.build'}({${s.indent `
+                accept: ${ts.string(accept)},
+                params: this.getK6Params(k6Params),`}
+              })`}
+            );`,
+            ], '\n'),
+        });
+    }
+    getGetK6ParamsMethod(_ctx) {
+        return ts.method('getK6Params', {
+            doc: ts.doc({
+                tags: [
+                    ts.docTag('private'),
+                    ts.docTag('param', '[k6Params]', { type: ts.refs.k6.params({ importType: 'js-doc' }) }),
+                ],
+            }),
+            parameters: [ts.parameter('k6Params')],
+            body: s `return Object.assign({}, this._defaultK6ParamsFactory ? this._defaultK6ParamsFactory() : {}, k6Params);`,
+        });
+    }
+    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));
+    }
+    getSchemaType(ctx, schema, options) {
+        var _a;
+        const output = schema && ctx.input.typescript.models[schema.id];
+        if (!output)
+            return (_a = options === null || options === void 0 ? void 0 : options.fallback) !== null && _a !== void 0 ? _a : this.getAnyType(ctx);
+        return (b) => b.appendModelUsage(output, options);
+    }
+    getClassName(ctx) {
+        var _a;
+        return toCasing(ctx.service.name, (_a = ctx.config.clientNameCasing) !== null && _a !== void 0 ? _a : 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);
+    }
+    getFilePath(ctx) {
+        var _a;
+        return resolve(ctx.config.outputDir, ctx.config.clientDir, `${toCasing(ctx.service.name, (_a = ctx.config.clientFileNameCasing) !== null && _a !== void 0 ? _a : ctx.config.fileNameCasing)}.js`);
+    }
+    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;
+    }
+}

package/esm/src/generators/services/k6-clients/k6-clients-generator.d.ts

@@ -0,0 +1,27 @@
+import { type ApiService, type AppendValueGroup, Factory, type MaybePromise, type OpenApiGeneratorContext, OpenApiServicesGenerationProviderBase } from '@goast/core';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { type TypeScriptK6ClientGenerator } from './k6-client-generator.js';
+import { type TypeScriptK6ClientGeneratorOutput, type TypeScriptK6ClientsGeneratorConfig, type TypeScriptK6ClientsGeneratorContext, type TypeScriptK6ClientsGeneratorInput, type TypeScriptK6ClientsGeneratorOutput } from './models.js';
+type Input = TypeScriptK6ClientsGeneratorInput;
+type Output = TypeScriptK6ClientsGeneratorOutput;
+type Config = TypeScriptK6ClientsGeneratorConfig;
+type ServiceOutput = TypeScriptK6ClientGeneratorOutput;
+type Context = TypeScriptK6ClientsGeneratorContext;
+export declare class TypeScriptK6ClientsGenerator extends OpenApiServicesGenerationProviderBase<Input, Output, Config, ServiceOutput, Context> {
+    private readonly _clientGeneratorFactory;
+    constructor(clientGeneratorFactory?: Factory<TypeScriptK6ClientGenerator, []>);
+    protected initResult(): Output;
+    protected buildContext(context: OpenApiGeneratorContext<Input>, config?: Partial<Config> | undefined): Context;
+    protected generateAdditionalFiles(ctx: TypeScriptK6ClientsGeneratorContext): 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 getHttpStatusCodeFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected generateIndexFiles(ctx: Context): Output['typescript']['indexFiles'];
+    protected getIndexFilePath(ctx: Context): string | null;
+    protected getResponseModelsIndexFilePath(ctx: Context): string | null;
+    protected getIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+    protected getResponseModelsIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder>;
+}
+export {};
+//# sourceMappingURL=k6-clients-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"k6-clients-generator.d.ts","sourceRoot":"","sources":["../../../../../src/src/generators/services/k6-clients/k6-clients-generator.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,qCAAqC,EACtC,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAsC,KAAK,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAChH,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EACxC,KAAK,iCAAiC,EACtC,KAAK,kCAAkC,EACxC,MAAM,aAAa,CAAC;AAGrB,KAAK,KAAK,GAAG,iCAAiC,CAAC;AAC/C,KAAK,MAAM,GAAG,kCAAkC,CAAC;AACjD,KAAK,MAAM,GAAG,kCAAkC,CAAC;AACjD,KAAK,aAAa,GAAG,iCAAiC,CAAC;AACvD,KAAK,OAAO,GAAG,mCAAmC,CAAC;AAEnD,qBAAa,4BAA6B,SAAQ,qCAAqC,CACrF,KAAK,EACL,MAAM,EACN,MAAM,EACN,aAAa,EACb,OAAO,CACR;IACC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2C;gBAEvE,sBAAsB,CAAC,EAAE,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;cAM1D,UAAU,IAAI,MAAM;cAYpB,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,mCAAmC,GAAG,OAAO,CAAC,IAAI,CAAC;cAKtF,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;cAInF,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/D,SAAS,CAAC,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAY7F,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC;IAwB9E,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIvD,SAAS,CAAC,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAMrE,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;IAMpF,SAAS,CAAC,iCAAiC,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAAC,qBAAqB,CAAC;CAOnG"}

package/esm/src/generators/services/k6-clients/k6-clients-generator.js

@@ -0,0 +1,109 @@
+import { resolve } from 'node:path';
+import fs from 'fs-extra';
+import { appendValueGroup, Factory, OpenApiServicesGenerationProviderBase, } from '@goast/core';
+import { copyAssetFile } from '../../../assets.js';
+import { ts } from '../../../ast/index.js';
+import { TypeScriptFileBuilder } from '../../../file-builder.js';
+import { DefaultTypeScriptK6ClientGenerator } from './k6-client-generator.js';
+import { defaultTypeScriptK6ClientsGeneratorConfig, } from './models.js';
+import { getReferenceFactories } from './refs.js';
+export class TypeScriptK6ClientsGenerator 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 DefaultTypeScriptK6ClientGenerator());
+    }
+    initResult() {
+        return {
+            typescript: {
+                k6Clients: {},
+                indexFiles: {
+                    k6Clients: undefined,
+                    k6ResponseModels: undefined,
+                },
+            },
+        };
+    }
+    buildContext(context, config) {
+        const providerContext = this.getProviderContext(context, config, defaultTypeScriptK6ClientsGeneratorConfig);
+        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.k6Clients[service.id] = result;
+    }
+    async generateUtilsFiles(ctx) {
+        const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDir);
+        await fs.ensureDir(targetDir);
+        await copyAssetFile('client/k6/request-builder.js', targetDir, 'Request Builder');
+        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)),
+            });
+        }
+    }
+    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');
+    }
+    generateIndexFiles(ctx) {
+        const clientsIndexFilePath = this.getIndexFilePath(ctx);
+        const responseModelsIndexFilePath = this.getResponseModelsIndexFilePath(ctx);
+        TypeScriptFileBuilder.tryGenerate({
+            logName: 'clients index file',
+            filePath: clientsIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getIndexFileContent(ctx)),
+        });
+        TypeScriptFileBuilder.tryGenerate({
+            logName: 'response models index file',
+            filePath: responseModelsIndexFilePath,
+            options: ctx.config,
+            generator: (b) => b.append(this.getResponseModelsIndexFileContent(ctx)),
+        });
+        return {
+            k6Clients: clientsIndexFilePath,
+            k6ResponseModels: responseModelsIndexFilePath,
+        };
+    }
+    getIndexFilePath(ctx) {
+        return ctx.config.clientsIndexFile ? resolve(ctx.config.outputDir, ctx.config.clientsIndexFile) : null;
+    }
+    getResponseModelsIndexFilePath(ctx) {
+        return ctx.config.responseModelsIndexFile
+            ? resolve(ctx.config.outputDir, ctx.config.responseModelsIndexFile)
+            : null;
+    }
+    getIndexFileContent(ctx) {
+        return appendValueGroup(Object.values(ctx.output.typescript.k6Clients).map((x) => ts.export(x.component, x.filePath)));
+    }
+    getResponseModelsIndexFileContent(ctx) {
+        return appendValueGroup(Object.values(ctx.output.typescript.k6Clients)
+            .flatMap((x) => Object.values(x.responseModels))
+            .map((x) => ts.export(x.component, x.filePath)));
+    }
+}