@genapi/presets 3.0.0

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@genapi/presets",
+  "type": "module",
+  "version": "3.0.0",
+  "author": "Hairyf <wwu710632@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/hairyf/genapi#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hairyf/genapi.git"
+  },
+  "bugs": "https://github.com/hairyf/genapi/issues",
+  "keywords": [
+    "genapi",
+    "shared"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./swag-axios-js": {
+      "types": "./dist/axios/js/index.d.ts",
+      "import": "./dist/axios/js/index.js"
+    },
+    "./swag-axios-ts": {
+      "types": "./dist/axios/ts/index.d.ts",
+      "import": "./dist/axios/ts/index.js"
+    },
+    "./swag-fetch-js": {
+      "types": "./dist/fetch/js/index.d.ts",
+      "import": "./dist/fetch/js/index.js"
+    },
+    "./swag-fetch-ts": {
+      "types": "./dist/fetch/ts/index.d.ts",
+      "import": "./dist/fetch/ts/index.js"
+    },
+    "./swag-got-js": {
+      "types": "./dist/got/js/index.d.ts",
+      "import": "./dist/got/js/index.js"
+    },
+    "./swag-got-ts": {
+      "types": "./dist/got/ts/index.d.ts",
+      "import": "./dist/got/ts/index.js"
+    },
+    "./swag-ky-js": {
+      "types": "./dist/ky/js/index.d.ts",
+      "import": "./dist/ky/js/index.js"
+    },
+    "./swag-ky-ts": {
+      "types": "./dist/ky/ts/index.d.ts",
+      "import": "./dist/ky/ts/index.js"
+    },
+    "./swag-ofetch-js": {
+      "types": "./dist/ofetch/js/index.d.ts",
+      "import": "./dist/ofetch/js/index.js"
+    },
+    "./swag-ofetch-ts": {
+      "types": "./dist/ofetch/ts/index.d.ts",
+      "import": "./dist/ofetch/ts/index.js"
+    }
+  },
+  "dependencies": {
+    "openapi-specification-types": "^0.0.3",
+    "@genapi/shared": "3.0.0",
+    "@genapi/pipeline": "3.0.0",
+    "@genapi/parser": "3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "start": "tsx src/index.ts"
+  }
+}

package/src/axios/index.ts

@@ -0,0 +1,2 @@
+export * as js from './js'
+export * as ts from './ts'

package/src/axios/js/config/index.ts

@@ -0,0 +1,19 @@
+import type { ApiPipeline } from '@genapi/shared'
+import { replaceMainext } from '@genapi/parser'
+import { config as _config } from '@genapi/pipeline'
+
+export function config(userConfig: ApiPipeline.Config): ApiPipeline.ConfigRead {
+  userConfig.import = userConfig.import || {}
+  userConfig.output = userConfig.output || {}
+  userConfig.import.http = userConfig.import.http || 'axios'
+  userConfig.output = replaceMainext(userConfig.output) || 'src/api/index.js'
+
+  const configRead = _config(userConfig)
+
+  configRead.graphs.imports.push({
+    name: 'http',
+    value: userConfig.import.http,
+  })
+
+  return configRead
+}

package/src/axios/js/index.ts

@@ -0,0 +1,19 @@
+import type { ApiPipeline } from '@genapi/shared'
+import pipeline, { compiler, dest, generate, original } from '@genapi/pipeline'
+import { config } from './config'
+import { parser } from './parser'
+
+function openapiPipeline(userConfig: ApiPipeline.Config) {
+  const process = pipeline(
+    userConfig => config(userConfig),
+    configRead => original(configRead),
+    configRead => parser(configRead),
+    configRead => compiler(configRead),
+    configRead => generate(configRead),
+    configRead => dest(configRead),
+  )
+  return process(userConfig)
+}
+export { compiler, config, dest, generate, original, parser }
+
+export default openapiPipeline

package/src/axios/js/parser/index.ts

@@ -0,0 +1,96 @@
+import type { ApiPipeline, StatementFunction, StatementInterface } from '@genapi/shared'
+import type { Paths } from 'openapi-specification-types'
+import {
+  literalFieldsToString,
+  parseHeaderCommits,
+  parseMethodMetadata,
+  parseMethodParameters,
+  parseOpenapiSpecification,
+  transformBaseURL,
+  transformDefinitions,
+  transformParameters,
+  transformUrlSyntax,
+  traversePaths,
+} from '@genapi/parser'
+
+export interface PathsTransformOptions {
+  configRead: ApiPipeline.ConfigRead
+  interfaces: StatementInterface[]
+  functions: StatementFunction[]
+}
+
+export function parser(configRead: ApiPipeline.ConfigRead) {
+  const source = parseOpenapiSpecification(configRead.source)
+
+  const comments = parseHeaderCommits(source)
+
+  const interfaces: StatementInterface[] = []
+  const functions: StatementFunction[] = []
+
+  transformBaseURL(source, {
+    configRead,
+  })
+
+  transformDefinitions(source.definitions, {
+    interfaces,
+  })
+
+  transformPaths(source.paths, {
+    configRead,
+    functions,
+    interfaces,
+  })
+
+  configRead.graphs.comments = comments
+  configRead.graphs.functions = functions
+  configRead.graphs.interfaces = interfaces
+
+  return configRead
+}
+
+export function transformPaths(paths: Paths, { configRead, functions, interfaces }: PathsTransformOptions) {
+  traversePaths(paths, (config) => {
+    /**
+     * function params/function options/function use interfaces
+     */
+    const { parameters, interfaces: attachInters, options } = parseMethodParameters(config, {
+      body: 'data',
+      query: 'params',
+    })
+    let { name, description, url, responseType } = parseMethodMetadata(config)
+
+    options.push(['...', 'config'])
+    interfaces.push(...attachInters)
+    parameters.push({
+      type: 'import(\'axios\').AxiosRequestConfig',
+      name: 'config',
+      required: false,
+    })
+    options.unshift('url')
+    options.unshift(['method', `"${config.method}"`])
+    if (configRead.config.baseURL)
+      options.unshift('baseURL')
+
+    transformParameters(parameters, {
+      syntax: 'ecmascript',
+      configRead,
+      description,
+      interfaces,
+      responseType,
+      generic: 'import(\'axios\').AxiosResponse<{__type__}>',
+    })
+
+    url = transformUrlSyntax(url)
+
+    functions.push({
+      export: true,
+      name,
+      description,
+      parameters,
+      body: [
+        `const url = ${url}`,
+        `return http.request({ ${literalFieldsToString(options)} })`,
+      ],
+    })
+  })
+}

package/src/axios/ts/config/index.ts

@@ -0,0 +1,24 @@
+import type { ApiPipeline } from '@genapi/shared'
+import { config as _config } from '@genapi/pipeline'
+
+export function config(userConfig: ApiPipeline.Config): ApiPipeline.ConfigRead {
+  userConfig.import = userConfig.import || {}
+  userConfig.import.http = userConfig.import.http || 'axios'
+
+  const configRead = _config(userConfig)
+
+  configRead.graphs.imports.push({
+    name: 'http',
+    names: userConfig.import.http === 'axios' ? ['AxiosRequestConfig'] : undefined,
+    value: userConfig.import.http,
+  })
+
+  if (userConfig.import.http !== 'axios') {
+    configRead.graphs.imports.push({
+      names: ['AxiosRequestConfig'],
+      value: 'axios',
+    })
+  }
+
+  return configRead
+}

package/src/axios/ts/index.ts

@@ -0,0 +1,20 @@
+import type { ApiPipeline } from '@genapi/shared'
+import pipeline, { compiler, dest, generate, original } from '@genapi/pipeline'
+
+import { config } from './config'
+import { parser } from './parser'
+
+function openapiPipeline(userConfig: ApiPipeline.Config) {
+  const process = pipeline(
+    userConfig => config(userConfig),
+    configRead => original(configRead),
+    configRead => parser(configRead),
+    configRead => compiler(configRead),
+    configRead => generate(configRead),
+    configRead => dest(configRead),
+  )
+  return process(userConfig)
+}
+export { compiler, config, dest, generate, original, parser }
+
+export default openapiPipeline

package/src/axios/ts/parser/index.ts

@@ -0,0 +1,95 @@
+import type { ApiPipeline, StatementFunction, StatementInterface } from '@genapi/shared'
+import type { Paths } from 'openapi-specification-types'
+import {
+  literalFieldsToString,
+  parseHeaderCommits,
+  parseMethodMetadata,
+  parseMethodParameters,
+  parseOpenapiSpecification,
+  transformBaseURL,
+  transformDefinitions,
+  transformParameters,
+  transformUrlSyntax,
+  traversePaths,
+} from '@genapi/parser'
+
+export interface PathsTransformOptions {
+  configRead: ApiPipeline.ConfigRead
+  interfaces: StatementInterface[]
+  functions: StatementFunction[]
+}
+
+export function parser(configRead: ApiPipeline.ConfigRead) {
+  const source = parseOpenapiSpecification(configRead.source)
+
+  const comments = parseHeaderCommits(source)
+
+  const interfaces: StatementInterface[] = []
+  const functions: StatementFunction[] = []
+
+  transformBaseURL(source, {
+    configRead,
+  })
+
+  transformDefinitions(source.definitions, {
+    interfaces,
+  })
+
+  transformPaths(source.paths, {
+    configRead,
+    functions,
+    interfaces,
+  })
+
+  configRead.graphs.comments = comments
+  configRead.graphs.functions = functions
+  configRead.graphs.interfaces = interfaces
+
+  return configRead
+}
+
+export function transformPaths(paths: Paths, { configRead, functions, interfaces }: PathsTransformOptions) {
+  traversePaths(paths, (config) => {
+    /**
+     * function params/function options/function use interfaces
+     */
+    const { parameters, interfaces: attachInters, options } = parseMethodParameters(config, {
+      body: 'data',
+      query: 'params',
+    })
+
+    let { name, description, url, responseType } = parseMethodMetadata(config)
+
+    options.push(['...', 'config'])
+    interfaces.push(...attachInters)
+    parameters.push({
+      name: 'config',
+      type: 'AxiosRequestConfig',
+      required: false,
+    })
+    options.unshift('url')
+    options.unshift(['method', `"${config.method}"`])
+    if (configRead.config.baseURL)
+      options.unshift('baseURL')
+
+    const { spaceResponseType } = transformParameters(parameters, {
+      syntax: 'typescript',
+      configRead,
+      description,
+      interfaces,
+      responseType,
+    })
+    url = transformUrlSyntax(url)
+
+    functions.push({
+      export: true,
+      name,
+      description,
+      parameters,
+      body: [
+        `const url = ${url}`,
+        `return http.request<${spaceResponseType}>({ ${literalFieldsToString(options)} })`,
+      ],
+    })
+  })
+}

package/src/fetch/index.ts

@@ -0,0 +1,2 @@
+export * as js from './js'
+export * as ts from './ts'

package/src/fetch/js/config/index.ts

@@ -0,0 +1,12 @@
+import type { ApiPipeline } from '@genapi/shared'
+import { replaceMainext } from '@genapi/parser'
+import { config as _config } from '@genapi/pipeline'
+
+export function config(userConfig: ApiPipeline.Config): ApiPipeline.ConfigRead {
+  userConfig.import = userConfig.import || {}
+  userConfig.output = userConfig.output || {}
+  userConfig.output = replaceMainext(userConfig.output) || 'src/api/index.js'
+  const configRead = _config(userConfig)
+
+  return configRead
+}

package/src/fetch/js/index.ts

@@ -0,0 +1,19 @@
+import type { ApiPipeline } from '@genapi/shared'
+import pipeline, { compiler, dest, generate, original } from '@genapi/pipeline'
+import { config } from './config'
+import { parser } from './parser'
+
+function openapiPipeline(userConfig: ApiPipeline.Config) {
+  const process = pipeline(
+    userConfig => config(userConfig),
+    configRead => original(configRead),
+    configRead => parser(configRead),
+    configRead => compiler(configRead),
+    configRead => generate(configRead),
+    configRead => dest(configRead),
+  )
+  return process(userConfig)
+}
+export { compiler, config, dest, generate, original, parser }
+
+export default openapiPipeline

package/src/fetch/js/parser/index.ts

@@ -0,0 +1,107 @@
+import type { ApiPipeline, StatementFunction, StatementInterface } from '@genapi/shared'
+import type { Paths } from 'openapi-specification-types'
+import {
+  literalFieldsToString,
+  parseHeaderCommits,
+  parseMethodMetadata,
+  parseMethodParameters,
+  parseOpenapiSpecification,
+  transformBaseURL,
+  transformBodyStringify,
+  transformDefinitions,
+  transformHeaderOptions,
+  transformParameters,
+  transformQueryParams,
+  transformUrlSyntax,
+  traversePaths,
+} from '@genapi/parser'
+
+export interface PathsTransformOptions {
+  configRead: ApiPipeline.ConfigRead
+  interfaces: StatementInterface[]
+  functions: StatementFunction[]
+}
+
+export function parser(configRead: ApiPipeline.ConfigRead) {
+  const source = parseOpenapiSpecification(configRead.source)
+
+  const comments = parseHeaderCommits(source)
+
+  const interfaces: StatementInterface[] = []
+  const functions: StatementFunction[] = []
+
+  transformBaseURL(source, {
+    configRead,
+  })
+
+  transformDefinitions(source.definitions, {
+    interfaces,
+  })
+
+  transformPaths(source.paths, {
+    configRead,
+    functions,
+    interfaces,
+  })
+
+  configRead.graphs.comments = comments
+  configRead.graphs.functions = functions
+  configRead.graphs.interfaces = interfaces
+
+  return configRead
+}
+
+export function transformPaths(paths: Paths, { configRead, functions, interfaces }: PathsTransformOptions) {
+  traversePaths(paths, (config) => {
+    /**
+     * function params/function options/function use interfaces
+     */
+    const { parameters, interfaces: attachInters, options } = parseMethodParameters(config, {
+      formData: 'body',
+    })
+
+    let { name, description, url, responseType, body } = parseMethodMetadata(config)
+
+    interfaces.push(...attachInters)
+    parameters.push({
+      name: 'config',
+      type: 'RequestInit',
+      required: false,
+    })
+
+    if (config.method.toLowerCase() !== 'get')
+      options.unshift(['method', `"${config.method}"`])
+
+    transformHeaderOptions('body', { options, parameters })
+
+    options.push(['...', 'config'])
+
+    transformParameters(parameters, {
+      syntax: 'ecmascript',
+      configRead,
+      description,
+      interfaces,
+      responseType,
+    })
+
+    transformBodyStringify('body', { options, parameters })
+
+    url = transformQueryParams('query', { body, options, url })
+    url = transformUrlSyntax(url, { baseURL: configRead.config.baseURL })
+
+    functions.push({
+      export: true,
+      async: true,
+      name,
+      description,
+      parameters,
+      body: [
+        ...body,
+        `const response = await fetch(${url}, { 
+          ${literalFieldsToString(options)} 
+        })`,
+        'return response.json()',
+      ],
+    })
+  })
+}

package/src/fetch/ts/config/index.ts

@@ -0,0 +1,11 @@
+import type { ApiPipeline } from '@genapi/shared'
+import { config as _config } from '@genapi/pipeline'
+
+export function config(userConfig: ApiPipeline.Config): ApiPipeline.ConfigRead {
+  userConfig.import = userConfig.import || {}
+  userConfig.import.http = userConfig.import.http || 'axios'
+
+  const configRead = _config(userConfig)
+
+  return configRead
+}

package/src/fetch/ts/index.ts

@@ -0,0 +1,20 @@
+import type { ApiPipeline } from '@genapi/shared'
+import pipeline, { compiler, dest, generate, original } from '@genapi/pipeline'
+
+import { config } from './config'
+import { parser } from './parser'
+
+function openapiPipeline(userConfig: ApiPipeline.Config) {
+  const process = pipeline(
+    userConfig => config(userConfig),
+    configRead => original(configRead),
+    configRead => parser(configRead),
+    configRead => compiler(configRead),
+    configRead => generate(configRead),
+    configRead => dest(configRead),
+  )
+  return process(userConfig)
+}
+export { compiler, config, dest, generate, original, parser }
+
+export default openapiPipeline

package/src/fetch/ts/parser/index.ts

@@ -0,0 +1,98 @@
+import type { ApiPipeline, StatementFunction, StatementInterface } from '@genapi/shared'
+import type { Paths } from 'openapi-specification-types'
+import {
+  parseHeaderCommits,
+  parseMethodMetadata,
+  parseMethodParameters,
+  parseOpenapiSpecification,
+  transformBaseURL,
+  transformBodyStringify,
+  transformDefinitions,
+  transformFetchBody,
+  transformHeaderOptions,
+  transformParameters,
+  transformQueryParams,
+  transformUrlSyntax,
+  traversePaths,
+} from '@genapi/parser'
+
+export interface PathsTransformOptions {
+  configRead: ApiPipeline.ConfigRead
+  interfaces: StatementInterface[]
+  functions: StatementFunction[]
+}
+
+export function parser(configRead: ApiPipeline.ConfigRead) {
+  const source = parseOpenapiSpecification(configRead.source)
+  const comments = parseHeaderCommits(source)
+
+  const interfaces: StatementInterface[] = []
+  const functions: StatementFunction[] = []
+
+  transformBaseURL(source, {
+    configRead,
+  })
+  transformDefinitions(source.definitions, {
+    interfaces,
+  })
+
+  transformPaths(source.paths, {
+    configRead,
+    functions,
+    interfaces,
+  })
+
+  configRead.graphs.comments = comments
+  configRead.graphs.functions = functions
+  configRead.graphs.interfaces = interfaces
+
+  return configRead
+}
+
+export function transformPaths(paths: Paths, { configRead, functions, interfaces }: PathsTransformOptions) {
+  traversePaths(paths, (config) => {
+    /**
+     * function params/function options/function use interfaces
+     */
+    const { parameters, interfaces: attachInters, options } = parseMethodParameters(config)
+    let { name, description, url, responseType, body } = parseMethodMetadata(config)
+
+    interfaces.push(...attachInters)
+    parameters.push({
+      name: 'config',
+      type: 'RequestInit',
+      required: false,
+    })
+
+    if (config.method.toLowerCase() !== 'get')
+      options.unshift(['method', `"${config.method}"`])
+
+    transformHeaderOptions('body', { options, parameters })
+
+    options.push(['...', 'config'])
+
+    const { spaceResponseType } = transformParameters(parameters, {
+      syntax: 'typescript',
+      configRead,
+      description,
+      interfaces,
+      responseType,
+    })
+
+    transformBodyStringify('body', { options, parameters })
+    url = transformQueryParams('query', { body, options, url })
+    url = transformUrlSyntax(url, { baseURL: configRead.config.baseURL })
+    const fetch = transformFetchBody(url, options, spaceResponseType)
+    functions.push({
+      export: true,
+      async: true,
+      name,
+      description,
+      parameters,
+      body: [
+        ...body,
+        ...fetch,
+      ],
+    })
+  })
+}

package/src/got/index.ts

@@ -0,0 +1,2 @@
+export * as js from './js'
+export * as ts from './ts'

package/src/got/js/config/index.ts

@@ -0,0 +1,19 @@
+import type { ApiPipeline } from '@genapi/shared'
+import { replaceMainext } from '@genapi/parser'
+import { config as _config } from '@genapi/pipeline'
+
+export function config(userConfig: ApiPipeline.Config): ApiPipeline.ConfigRead {
+  userConfig.import = userConfig.import || {}
+  userConfig.output = userConfig.output || {}
+  userConfig.import.http = userConfig.import.http || 'got'
+  userConfig.output = replaceMainext(userConfig.output) || 'src/api/index.js'
+
+  const configRead = _config(userConfig)
+
+  configRead.graphs.imports.push({
+    name: 'http',
+    value: userConfig.import.http,
+  })
+
+  return configRead
+}

package/src/got/js/index.ts

@@ -0,0 +1,20 @@
+import type { ApiPipeline } from '@genapi/shared'
+import pipeline, { compiler, dest, generate, original } from '@genapi/pipeline'
+
+import { config } from './config'
+import { parser } from './parser'
+
+function openapiPipeline(userConfig: ApiPipeline.Config) {
+  const process = pipeline(
+    userConfig => config(userConfig),
+    configRead => original(configRead),
+    configRead => parser(configRead),
+    configRead => compiler(configRead),
+    configRead => generate(configRead),
+    configRead => dest(configRead),
+  )
+  return process(userConfig)
+}
+export { compiler, config, dest, generate, original, parser }
+
+export default openapiPipeline