@goast/kotlin 0.4.7-beta2 → 0.4.8

package/src/src/generators/services/okhttp3-clients/refs.ts

@@ -0,0 +1,55 @@
+import { kt } from '../../../ast/index.js';
+
+// See packages/kotlin/assets/client/okhttp3 for reference
+export function getReferenceFactories(infrastructurePackageName: string): {
+  multiValueMap: kt.ReferenceFactory;
+  collectionDelimiter: kt.ReferenceFactory;
+  defaultMultiValueConverter: kt.ReferenceFactory;
+  toMultiValueMap: kt.GenericReferenceFactory<1>;
+  apiClient: kt.ReferenceFactory;
+  responseType: kt.ReferenceFactory;
+  apiResponse: kt.GenericReferenceFactory<1>;
+  success: kt.GenericReferenceFactory<1>;
+  informational: kt.GenericReferenceFactory<1>;
+  redirection: kt.GenericReferenceFactory<1>;
+  clientError: kt.GenericReferenceFactory<1>;
+  serverError: kt.GenericReferenceFactory<1>;
+  clientException: kt.ReferenceFactory;
+  serverException: kt.ReferenceFactory;
+  partConfig: kt.GenericReferenceFactory<1>;
+  requestConfig: kt.GenericReferenceFactory<1>;
+  requestMethod: kt.ReferenceFactory;
+} {
+  return {
+    // ApiAbstractions.kt
+    multiValueMap: kt.reference.factory('MultiValueMap', infrastructurePackageName),
+    collectionDelimiter: kt.reference.factory('collectionDelimiter', infrastructurePackageName),
+    defaultMultiValueConverter: kt.reference.factory('defaultMultiValueConverter', infrastructurePackageName),
+    toMultiValueMap: kt.reference.genericFactory<1>('toMultiValueMap', infrastructurePackageName),
+
+    // ApiClient.kt
+    apiClient: kt.reference.factory('ApiClient', infrastructurePackageName),
+
+    // ApiResponse.kt
+    responseType: kt.reference.factory('ResponseType', infrastructurePackageName),
+    apiResponse: kt.reference.genericFactory<1>('ApiResponse', infrastructurePackageName),
+    success: kt.reference.genericFactory<1>('Success', infrastructurePackageName),
+    informational: kt.reference.genericFactory<1>('Informational', infrastructurePackageName),
+    redirection: kt.reference.genericFactory<1>('Redirection', infrastructurePackageName),
+    clientError: kt.reference.genericFactory<1>('ClientError', infrastructurePackageName),
+    serverError: kt.reference.genericFactory<1>('ServerError', infrastructurePackageName),
+
+    // Errors.kt
+    clientException: kt.reference.factory('ClientException', infrastructurePackageName),
+    serverException: kt.reference.factory('ServerException', infrastructurePackageName),
+
+    // PartConfig.kt
+    partConfig: kt.reference.genericFactory<1>('PartConfig', infrastructurePackageName),
+
+    // RequestConfig.kt
+    requestConfig: kt.reference.genericFactory<1>('RequestConfig', infrastructurePackageName),
+
+    // RequestMethod.kt
+    requestMethod: kt.reference.factory('RequestMethod', infrastructurePackageName),
+  };
+}

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

@@ -0,0 +1,88 @@
+import type { ApiEndpoint, ApiResponse, ApiSchema, SourceBuilder } from '@goast/core';
+
+import type { kt } from '../../../ast/index.js';
+import type { ApiParameterWithMultipartInfo } from '../../../types.js';
+
+// #region API Response Entities
+export type GenerateApiResponseEntitiesFile = {
+  dirPath: string;
+  packageName: string;
+};
+
+export type GetApiResponseEntitiesFileContent = { packageName: string };
+
+export type GetApiResponseEntities = object;
+// #endregion
+
+// #region API Interface
+export type GenerateApiInterfaceFile = {
+  dirPath: string;
+  packageName: string;
+};
+
+export type GetApiInterfaceFileContent = { interfaceName: string };
+
+export type GetApiInterface = { interfaceName: string };
+
+export type GetApiInterfaceEndpointMethod = { endpoint: ApiEndpoint };
+
+export type GetApiResponseEntityClass = { endpoint: ApiEndpoint };
+// #endregion
+
+// #region API Controller
+export type GenerateApiControllerFile = {
+  dirPath: string;
+  packageName: string;
+};
+
+export type GetApiControllerFileContent = { controllerName: string };
+
+export type GetApiController = { controllerName: string };
+// #endregion
+
+// #region API Delegate Interface
+export type GenerateApiDelegateInterfaceFile = {
+  dirPath: string;
+  packageName: string;
+};
+
+export type GetApiDelegateInterfaceFileContent = { delegateInterfaceName: string };
+
+export type GetApiDelegateInterface = { delegateInterfaceName: string };
+
+export type GetApiDelegateInterfaceEndpointMethod = { endpoint: ApiEndpoint };
+// #endregion
+
+export type GetParameterType = { endpoint: ApiEndpoint; parameter: ApiParameterWithMultipartInfo };
+
+export type GetResponseType = { endpoint: ApiEndpoint; response?: ApiResponse };
+
+export type GetTypeUsage<TBuilder extends SourceBuilder> = {
+  schema: ApiSchema | undefined;
+  nullable?: boolean;
+  fallback?: kt.Type<TBuilder>;
+};
+
+export type GetSchemaType = { schema: ApiSchema | undefined };
+
+export type GetControllerRequestMapping = { prefix?: string };
+
+export type GetBasePath = object;
+
+export type GetEndpointPath = { endpoint: ApiEndpoint };
+
+export type GetDirectoryPath = { packageName: string };
+
+export type GetPathConstantName = { endpoint: ApiEndpoint };
+
+export type GetPackageName = object;
+
+export type GetApiResponseEntityName = { endpoint: ApiEndpoint };
+
+export type GetApiInterfaceName = object;
+
+export type GetApiDelegateInterfaceName = object;
+
+export type GetApiControllerName = object;
+
+export type GetAllParameters = { endpoint: ApiEndpoint };

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

@@ -0,0 +1,4 @@
+export * as DefaultKotlinSpringControllerGeneratorArgs from './args.js';
+export * from './models.js';
+export * from './spring-controller-generator.js';
+export * from './spring-controllers-generator.js';

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

@@ -0,0 +1,66 @@
+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';
+
+export type KotlinServicesGeneratorConfig = KotlinGeneratorConfig & {
+  packageName: string;
+  packageSuffix: string | ((service: ApiService) => string);
+
+  basePath?: string | RegExp | ((basePath: string, service: ApiService) => string);
+  pathModifier?: RegExp | ((path: string, endpoint: ApiEndpoint) => string);
+
+  addSwaggerAnnotations: boolean;
+  addJakartaValidationAnnotations: boolean;
+  arrayType: 'list' | 'flux';
+
+  strictResponseEntities: boolean;
+  defaultStatusCodes: number[];
+};
+
+export const defaultKotlinServicesGeneratorConfig: DefaultGenerationProviderConfig<KotlinServicesGeneratorConfig> = {
+  ...defaultKotlinGeneratorConfig,
+
+  packageName: 'com.openapi.generated',
+  packageSuffix: '.api',
+
+  addSwaggerAnnotations: true,
+  addJakartaValidationAnnotations: true,
+  arrayType: 'flux',
+
+  strictResponseEntities: false,
+  defaultStatusCodes: [400, 401, 403, 500, 501],
+};
+
+export type KotlinServicesGeneratorInput = KotlinModelsGeneratorOutput;
+
+export type KotlinServicesGeneratorOutput = {
+  kotlin: {
+    services: {
+      [serviceId: string]: KotlinServiceGeneratorOutput;
+    };
+  };
+};
+
+export type KotlinServiceGeneratorOutput = {
+  apiInterface: KotlinImport;
+  apiController: KotlinImport;
+  apiDelegate: KotlinImport;
+};
+
+export type KotlinServicesGeneratorContext = OpenApiServicesGenerationProviderContext<
+  KotlinServicesGeneratorInput,
+  KotlinServicesGeneratorOutput,
+  KotlinServicesGeneratorConfig,
+  KotlinServiceGeneratorOutput
+>;
+
+export type KotlinServiceGeneratorContext = KotlinServicesGeneratorContext & {
+  service: ApiService;
+};