@goast/typescript 0.5.3 → 0.6.0-beta.1

package/src/src/generators/services/fetch-clients/fetch-clients-generator.ts

@@ -1,163 +0,0 @@
-import { resolve } from 'node:path';
-
-
-import fs from 'fs-extra';
-
-import {
-  type ApiService,
-  type AppendValueGroup,
-  appendValueGroup,
-  Factory,
-  type MaybePromise,
-  notNullish,
-  type OpenApiGeneratorContext,
-  OpenApiServicesGenerationProviderBase,
-} from '@goast/core';
-
-import { copyAssetFile } from '../../../assets.js';
-import { ts } from '../../../ast/index.js';
-import { TypeScriptFileBuilder } from '../../../file-builder.js';
-import {
-  DefaultTypeScriptFetchClientGenerator,
-  type TypeScriptFetchClientGenerator,
-} from './fetch-client-generator.js';
-import {
-  defaultTypeScriptFetchClientsGeneratorConfig,
-  type TypeScriptFetchClientGeneratorOutput,
-  type TypeScriptFetchClientsGeneratorConfig,
-  type TypeScriptFetchClientsGeneratorContext,
-  type TypeScriptFetchClientsGeneratorInput,
-  type TypeScriptFetchClientsGeneratorOutput,
-} from './models.js';
-import { getReferenceFactories } from './refs.js';
-
-type Input = TypeScriptFetchClientsGeneratorInput;
-type Output = TypeScriptFetchClientsGeneratorOutput;
-type Config = TypeScriptFetchClientsGeneratorConfig;
-type ServiceOutput = TypeScriptFetchClientGeneratorOutput;
-type Context = TypeScriptFetchClientsGeneratorContext;
-
-export class TypeScriptFetchClientsGenerator extends OpenApiServicesGenerationProviderBase<
-  Input,
-  Output,
-  Config,
-  ServiceOutput,
-  Context
-> {
-  private readonly _clientGeneratorFactory: Factory<TypeScriptFetchClientGenerator, []>;
-
-  constructor(clientGeneratorFactory?: Factory<TypeScriptFetchClientGenerator, []>) {
-    super();
-    this._clientGeneratorFactory = clientGeneratorFactory ??
-      Factory.fromValue(new DefaultTypeScriptFetchClientGenerator());
-  }
-
-  protected override initResult(): Output {
-    return {
-      typescript: {
-        clients: {},
-        indexFiles: {
-          clients: undefined,
-          clientInterfaces: undefined,
-        },
-      },
-    };
-  }
-
-  protected override buildContext(
-    context: OpenApiGeneratorContext<Input>,
-    config?: Partial<Config> | undefined,
-  ): Context {
-    const providerContext = this.getProviderContext(context, config, defaultTypeScriptFetchClientsGeneratorConfig);
-    return Object.assign(providerContext, {
-      refs: getReferenceFactories(providerContext.config),
-    });
-  }
-
-  protected override async generateAdditionalFiles(ctx: TypeScriptFetchClientsGeneratorContext): Promise<void> {
-    await this.copyUtilsFiles(ctx);
-    ctx.output.typescript.indexFiles.clients = this.generateIndexFile(ctx);
-    ctx.output.typescript.indexFiles.clientInterfaces = this.generateInterfaceIndexFile(ctx);
-  }
-
-  protected override generateService(ctx: Context, service: ApiService): MaybePromise<ServiceOutput> {
-    const clientGenerator = this._clientGeneratorFactory.create();
-    return clientGenerator.generate({
-      ...ctx,
-      service,
-    });
-  }
-
-  protected override addServiceResult(ctx: Context, service: ApiService, result: ServiceOutput): void {
-    ctx.output.typescript.clients[service.id] = result;
-  }
-
-  protected generateIndexFile(ctx: Context): string | null {
-    const filePath = this.getIndexFilePath(ctx);
-
-    TypeScriptFileBuilder.tryGenerate({
-      logName: 'clients index file',
-      filePath,
-      options: ctx.config,
-      generator: (b) => b.append(this.getIndexFileContent(ctx)),
-    });
-
-    return filePath;
-  }
-
-  protected generateInterfaceIndexFile(ctx: Context): string | null {
-    const filePath = this.getInterfaceIndexFilePath(ctx);
-    const clientsFilePath = this.getIndexFilePath(ctx);
-
-    if (filePath && filePath === clientsFilePath) {
-      return clientsFilePath;
-    }
-
-    TypeScriptFileBuilder.tryGenerate({
-      logName: 'client interfaces index file',
-      filePath,
-      options: ctx.config,
-      generator: (b) => b.append(this.getInterfaceIndexFileContent(ctx)),
-    });
-
-    return filePath;
-  }
-
-  protected getIndexFilePath(ctx: Context): string | null {
-    return ctx.config.clientsIndexFile ? resolve(ctx.config.outputDir, ctx.config.clientsIndexFile) : null;
-  }
-
-  protected getInterfaceIndexFilePath(ctx: Context): string | null {
-    return ctx.config.clientInterfacesIndexFile
-      ? resolve(ctx.config.outputDir, ctx.config.clientInterfacesIndexFile)
-      : null;
-  }
-
-  protected getIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder> {
-    const cIndexPath = this.getIndexFilePath(ctx);
-    const iIndexPath = this.getInterfaceIndexFilePath(ctx);
-    return appendValueGroup(
-      (iIndexPath && iIndexPath === cIndexPath
-        ? Object.values(ctx.output.typescript.clients).flatMap((c) => [c.client, c.clientInterface])
-        : Object.values(ctx.output.typescript.clients).map((c) => c.client))
-        .filter(notNullish)
-        .map((x) => ts.export(x.component, x.filePath)),
-    );
-  }
-
-  protected getInterfaceIndexFileContent(ctx: Context): AppendValueGroup<TypeScriptFileBuilder> {
-    return appendValueGroup(
-      Object.values(ctx.output.typescript.clients)
-        .map((c) => c.clientInterface)
-        .filter(notNullish)
-        .map((x) => ts.export(x.component, x.filePath)),
-    );
-  }
-
-  private async copyUtilsFiles(ctx: Context): Promise<void> {
-    const targetDir = resolve(ctx.config.outputDir, ctx.config.utilsDir);
-    await fs.ensureDir(targetDir);
-
-    await copyAssetFile('client/fetch/fetch-client.utils.ts', targetDir);
-  }
-}

package/src/src/generators/services/fetch-clients/index.ts

@@ -1,3 +0,0 @@
-export * from './fetch-client-generator.js';
-export * from './fetch-clients-generator.js';
-export * from './models.js';

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

@@ -1,130 +0,0 @@
-import type {
-  ApiService,
-  DefaultGenerationProviderConfig,
-  ExtendedStringCasing,
-  Nullable,
-  OpenApiServicesGenerationProviderContext,
-} from '@goast/core';
-
-import type { TypeScriptExportOutput } from '../../../common-results.js';
-import { defaultTypeScriptGeneratorConfig, 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 const defaultTypeScriptFetchClientsGeneratorConfig: DefaultGenerationProviderConfig<
-  TypeScriptFetchClientsGeneratorConfig
-> = {
-  ...defaultTypeScriptGeneratorConfig,
-
-  clientFileNameCasing: { casing: 'kebab', suffix: '-client' },
-  clientInterfaceFileNameCasing: undefined,
-
-  clientNameCasing: { casing: 'pascal', suffix: 'Client' },
-  clientInterfaceNameCasing: { prefix: 'I', casing: 'pascal', suffix: 'Client' },
-
-  clientFileKind: 'class',
-  clientDir: 'clients',
-  clientInterfaceDir: 'clients/interfaces',
-  clientsIndexFile: 'clients.ts',
-  clientInterfacesIndexFile: 'clients.ts',
-  utilsDir: 'utils',
-};
-
-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;
-};

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

@@ -1,21 +0,0 @@
-import { resolve } from 'node:path';
-
-import { ts } from '../../../ast/index.js';
-import type { TypeScriptFetchClientsGeneratorConfig } from './models.js';
-
-// See packages/typescript/assets/client/fetch for reference
-export function getReferenceFactories(options: TypeScriptFetchClientsGeneratorConfig): {
-  typedResponse: ts.GenericModuleReferenceFactory<1>;
-  fetchClientOptions: ts.ModuleReferenceFactory;
-  urlBuilder: ts.ModuleReferenceFactory;
-} {
-  const utilsDirPath = resolve(options.outputDir, options.utilsDir);
-  const fetchClientUtilsPath = resolve(utilsDirPath, 'fetch-client.utils.ts');
-
-  return {
-    // fetch-client.utils.ts
-    typedResponse: ts.reference.genericFactory<1>('TypedResponse', fetchClientUtilsPath, { importType: 'type-import' }),
-    fetchClientOptions: ts.reference.factory('FetchClientOptions', fetchClientUtilsPath, { importType: 'type-import' }),
-    urlBuilder: ts.reference.factory('UrlBuilder', fetchClientUtilsPath),
-  };
-}

package/src/src/generators/services/k6-clients/index.ts

@@ -1,3 +0,0 @@
-export * from './k6-client-generator.js';
-export * from './k6-clients-generator.js';
-export * from './models.js';