@goast/kotlin 0.6.0 → 0.7.0-beta.2

package/src/src/generators/services/spring-controllers/spring-controllers-generator.ts

@@ -1,140 +0,0 @@
-import {
-  type ApiService,
-  type AppendValueGroup,
-  appendValueGroup,
-  Factory,
-  type MaybePromise,
-  type OpenApiGeneratorContext,
-  OpenApiServicesGenerationProviderBase,
-} from '@goast/core';
-
-import { kt } from '../../../ast/index.js';
-import { KotlinFileBuilder } from '../../../file-builder.js';
-import {
-  defaultKotlinServicesGeneratorConfig,
-  type KotlinServiceGeneratorOutput,
-  type KotlinServicesGeneratorConfig,
-  type KotlinServicesGeneratorContext,
-  type KotlinServicesGeneratorInput,
-  type KotlinServicesGeneratorOutput,
-} from './models.js';
-import { getReferenceFactories } from './refs.js';
-import {
-  DefaultKotlinSpringControllerGenerator,
-  type KotlinSpringControllerGenerator,
-} from './spring-controller-generator.js';
-
-type Input = KotlinServicesGeneratorInput;
-type Output = KotlinServicesGeneratorOutput;
-type Config = KotlinServicesGeneratorConfig;
-type ServiceOutput = KotlinServiceGeneratorOutput;
-type Context = KotlinServicesGeneratorContext;
-
-export class KotlinSpringControllersGenerator extends OpenApiServicesGenerationProviderBase<
-  Input,
-  Output,
-  Config,
-  ServiceOutput,
-  Context
-> {
-  private readonly _serviceGeneratorFactory: Factory<
-    KotlinSpringControllerGenerator,
-    []
-  >;
-
-  constructor(
-    serviceGeneratorFactory?: Factory<KotlinSpringControllerGenerator, []>,
-  ) {
-    super();
-    this._serviceGeneratorFactory = serviceGeneratorFactory ??
-      Factory.fromValue(new DefaultKotlinSpringControllerGenerator());
-  }
-
-  protected initResult(): Output {
-    return {
-      kotlin: {
-        services: {},
-      },
-    };
-  }
-
-  protected generateService(
-    ctx: Context,
-    service: ApiService,
-  ): MaybePromise<ServiceOutput> {
-    const serviceGenerator = this._serviceGeneratorFactory.create();
-    return serviceGenerator.generate({
-      ...ctx,
-      service,
-    });
-  }
-
-  protected addServiceResult(
-    ctx: Context,
-    service: ApiService,
-    result: ServiceOutput,
-  ): void {
-    ctx.output.kotlin.services[service.id] = result;
-  }
-
-  protected buildContext(
-    context: OpenApiGeneratorContext<KotlinServicesGeneratorInput>,
-    config?: Partial<Config> | undefined,
-  ): Context {
-    context.data.services = context.data.services.filter(
-      (x) => x.name !== 'exclude-from-generation',
-    );
-    const providerContext = this.getProviderContext(
-      context,
-      config,
-      defaultKotlinServicesGeneratorConfig,
-    );
-    return Object.assign(providerContext, {
-      refs: getReferenceFactories(providerContext.config),
-    });
-  }
-
-  protected override generateAdditionalFiles(
-    ctx: KotlinServicesGeneratorContext,
-  ): void {
-    this.generateApiExceptionHandler(ctx);
-  }
-
-  protected generateApiExceptionHandler(ctx: Context): void {
-    const packageName = ctx.refs.apiExceptionHandler.packageName ?? ctx.config.packageName;
-    const dir = `${ctx.config.outputDir}/${packageName.replace(/\./g, '/')}`;
-    const fileName = `${ctx.refs.apiExceptionHandler.refName}.kt`;
-    console.log(`Generating Api Exception Handler to ${fileName}...`);
-
-    const builder = new KotlinFileBuilder(packageName, ctx.config);
-    builder.append(this.getApiExceptionHandlerInterface(ctx));
-    builder.writeToFile(`${dir}/${fileName}`);
-  }
-
-  protected getApiExceptionHandlerFileContent(
-    ctx: Context,
-  ): AppendValueGroup<KotlinFileBuilder> {
-    return appendValueGroup([this.getApiExceptionHandlerInterface(ctx)], '\n');
-  }
-
-  protected getApiExceptionHandlerInterface(
-    ctx: Context,
-  ): kt.Interface<KotlinFileBuilder> {
-    return kt.interface(ctx.refs.apiExceptionHandler.refName, {
-      members: [
-        kt.function('handleApiException', {
-          doc: kt.doc('Handler for API exceptions.', [
-            kt.docTag('return', 'Response entity.'),
-          ]),
-          suspend: ctx.config.suspendingFunctions,
-          parameters: [
-            kt.parameter('exception', kt.refs.throwable(), {
-              description: 'Exception that has been thrown by the API.',
-            }),
-          ],
-          returnType: kt.refs.spring.responseEntity(['*']),
-        }),
-      ],
-    });
-  }
-}

package/src/src/generators/services/spring-reactive-web-clients/args.ts

@@ -1,114 +0,0 @@
-import type { ApiEndpoint, ApiParameter, ApiSchema, SourceBuilder } from '@goast/core';
-import type { kt } from '../../../ast/index.js';
-import type { ApiParameterWithMultipartInfo } from '../../../types.js';
-
-export type GetClientFileContent = object;
-
-export type GetRequestsObject = object;
-
-export type GetEndpointMembers = { endpoint: ApiEndpoint; parameters: ApiParameterWithMultipartInfo[] };
-
-export type GetEndpointFunctionName = { endpoint: ApiEndpoint };
-
-export type GetEndpointDeprecatedAnnotations = { endpoint: ApiEndpoint };
-
-export type GetEndpointFunction = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointFunctionBody = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointRequestFunctionName = { endpoint: ApiEndpoint };
-
-export type GetEndpointRequestFunction = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointRequestFunctionBody = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointFunctionWithHandler = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointFunctionWithHandlerBody = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-  responseSchema: ApiSchema | undefined;
-};
-
-export type GetEndpointUriCall = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-};
-
-export type GetUriPathVariablesValue = { endpoint: ApiEndpoint };
-
-export type GetUriQueryParameterCalls = { endpoint: ApiEndpoint };
-
-export type GetEndpointUriFunctionName = { endpoint: ApiEndpoint };
-
-export type GetEndpointUriFunction = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-};
-
-export type GetEndpointUriFunctionBody = {
-  endpoint: ApiEndpoint;
-  parameters: ApiParameterWithMultipartInfo[];
-};
-
-export type GetParameterToString = {
-  endpoint: ApiEndpoint;
-  parameter: ApiParameterWithMultipartInfo;
-};
-
-export type GetAdditionalClientMembers = object;
-
-export type GetParameterType = { endpoint: ApiEndpoint; parameter: ApiParameterWithMultipartInfo };
-
-export type GetRequestBodyType = { endpoint: ApiEndpoint };
-
-export type GetParameterDefaultValue = {
-  endpoint: ApiEndpoint;
-  parameter: ApiParameter;
-};
-
-export type GetTypeUsage<TBuilder extends SourceBuilder> = {
-  schema: ApiSchema | undefined;
-  nullable?: boolean;
-  fallback?: kt.Type<TBuilder>;
-};
-
-export type GetPackageName = object;
-
-export type GetResponseSchema = { endpoint: ApiEndpoint };
-
-export type GetSchemaType = { schema: ApiSchema | undefined };
-
-export type GetAllParameters = { endpoint: ApiEndpoint };
-
-export type GetRequestBodyParamName = { endpoint: ApiEndpoint };
-
-export type GetEndpointDocDescription = { endpoint: ApiEndpoint };
-
-export type GetBasePath = object;
-
-export type GetEndpointPath = { endpoint: ApiEndpoint };
-
-export type GetFilePath = { packageName: string };
-
-export type GetRequestsObjectName = object;

package/src/src/generators/services/spring-reactive-web-clients/index.ts

@@ -1,4 +0,0 @@
-export * as DefaultKotlinSpringReactiveWebClientGeneratorArgs from './args.js';
-export * from './models.js';
-export * from './spring-reactive-web-client-generator.js';
-export * from './spring-reactive-web-clients-generator.js';

package/src/src/generators/services/spring-reactive-web-clients/models.ts

@@ -1,78 +0,0 @@
-import type {
-  ApiEndpoint,
-  ApiService,
-  DefaultGenerationProviderConfig,
-  OpenApiServicesGenerationProviderContext,
-} from '@goast/core';
-
-import type { KotlinImport } from '../../../common-results.js';
-import { defaultKotlinGeneratorConfig, type KotlinGeneratorConfig } from '../../../config.js';
-import type { KotlinModelsGeneratorOutput } from '../../models/index.js';
-import type { getReferenceFactories } from './refs.js';
-
-export type KotlinSpringReactiveWebClientsGeneratorConfig = KotlinGeneratorConfig & {
-  packageName: string;
-  packageSuffix: string | ((service?: ApiService) => string);
-  infrastructurePackageName:
-    | string
-    | { mode: 'append-package-name' | 'append-full-package-name' | 'replace'; value: string };
-
-  basePath?: string | RegExp | ((basePath: string, service: ApiService) => string);
-  pathModifier?: RegExp | ((path: string, endpoint: ApiEndpoint) => string);
-  serializerJsonInclude: 'always' | 'non-null' | 'non-absent' | 'non-default' | 'non-empty' | 'use-defaults';
-
-  /**
-   * Whether the generated request functions pass the URI template (e.g. `pets/{id}`) to `WebClient` instead of an
-   * already expanded URI string. Only with the template does Spring populate
-   * `ClientRequestObservationContext.uriTemplate`, which keeps the `uri` tag of `http.client.requests` bounded by the
-   * number of endpoints instead of by the number of distinct path parameter values.
-   *
-   * Note that path parameter values are then encoded as URI variables, i.e. reserved characters (`/`, `?`, `#`, `%`)
-   * inside a value are percent-encoded. Values consisting of unreserved characters are unaffected, so for those the
-   * request is byte-identical to the expanded form.
-   *
-   * The `<endpoint>Uri(...)` helper functions are generated either way.
-   * @default true
-   */
-  preserveUriTemplate: boolean;
-};
-
-export const defaultKotlinSpringReactiveWebClientsGeneratorConfig: DefaultGenerationProviderConfig<
-  KotlinSpringReactiveWebClientsGeneratorConfig
-> = {
-  ...defaultKotlinGeneratorConfig,
-
-  packageName: 'com.openapi.generated',
-  packageSuffix: '.api.client',
-  infrastructurePackageName: { mode: 'append-full-package-name', value: '.infrastructure' },
-  serializerJsonInclude: 'non-absent',
-  preserveUriTemplate: true,
-};
-
-export type KotlinSpringReactiveWebClientsGeneratorInput = KotlinModelsGeneratorOutput;
-
-export type KotlinSpringReactiveWebClientsGeneratorOutput = {
-  kotlin: {
-    clients: {
-      [serviceId: string]: KotlinSpringReactiveWebClientGeneratorOutput;
-    };
-  };
-};
-
-export type KotlinSpringReactiveWebClientGeneratorOutput = KotlinImport;
-
-export type KotlinSpringReactiveWebClientsGeneratorContext =
-  & OpenApiServicesGenerationProviderContext<
-    KotlinSpringReactiveWebClientsGeneratorInput,
-    KotlinSpringReactiveWebClientsGeneratorOutput,
-    KotlinSpringReactiveWebClientsGeneratorConfig,
-    KotlinSpringReactiveWebClientGeneratorOutput
-  >
-  & {
-    infrastructurePackageName: string;
-    refs: ReturnType<typeof getReferenceFactories>;
-  };
-
-export type KotlinSpringReactiveWebClientGeneratorContext = KotlinSpringReactiveWebClientsGeneratorContext & {
-  service: ApiService;
-};

package/src/src/generators/services/spring-reactive-web-clients/refs.ts

@@ -1,11 +0,0 @@
-import { kt } from '../../../ast/index.js';
-
-// See packages/kotlin/assets/client/spring-reactive-web-clients for reference
-export function getReferenceFactories(infrastructurePackageName: string): {
-  apiRequestFile: kt.ReferenceFactory;
-} {
-  return {
-    // ApiRequestFile.kt
-    apiRequestFile: kt.reference.factory('ApiRequestFile', infrastructurePackageName),
-  };
-}