@team-supercharge/oasg 13.0.1 → 13.1.0-master-ac68fc1d.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-supercharge/oasg",
-  "version": "13.0.1",
+  "version": "13.1.0-master-ac68fc1d.0",
   "description": "Node-based tool to lint OpenAPI documents and generate clients, servers and documentation from them",
   "author": "Supercharge",
   "license": "MIT",

package/targets/react/generator-config.json

@@ -10,5 +10,15 @@
     "ARRAY_ITEM_SUFFIX": "",
     "MAP_ITEM_SUFFIX": "",
     "SKIP_SCHEMA_REUSE": "true"
+  },
+  "files": {
+    "hook.mustache": {
+      "destinationFilename": ".hook.ts",
+      "templateType": "API"
+    },
+    "use-api.hook.mustache": {
+      "folder": "src/apis",
+      "destinationFilename": "use-api.hook.tsx"
+    }
   }
 }

package/targets/react/templates/apis.index.mustache

@@ -0,0 +1,18 @@
+/* tslint:disable */
+/* eslint-disable */
+{{#useSagaAndRecords}}
+export * from './SagaApiManager{{importFileExtension}}'
+export * from './allSagas{{importFileExtension}}'
+{{/useSagaAndRecords}}
+export * from './use-api.hook{{importFileExtension}}';
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+export * from './{{ classFilename }}{{importFileExtension}}';
+export * from './{{ classFilename }}.hook{{importFileExtension}}';
+{{#useSagaAndRecords}}
+export * from './{{{ classFilename }}}Sagas{{importFileExtension}}';
+{{/useSagaAndRecords}}
+{{/operations}}
+{{/apis}}
+{{/apiInfo}}

package/targets/react/templates/hook.mustache

@@ -0,0 +1,111 @@
+/* tslint:disable */
+/* eslint-disable */
+{{>licenseInfo}}
+
+import { useMutation, UseMutationOptions, UseMutationResult, useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import { useApi } from './use-api.hook';
+{{#imports.0}}
+import type {
+  {{#imports}}
+  {{className}},
+  {{/imports}}
+} from '../models/index{{importFileExtension}}';
+{{/imports.0}}
+{{#operations}}
+import {
+  {{classname}},
+{{#operation}}
+{{#allParams.0}}
+  {{#prefixParameterInterfaces}}{{classname}}{{/prefixParameterInterfaces}}{{operationIdCamelCase}}Request,
+{{/allParams.0}}
+{{/operation}}
+} from './{{ classFilename }}{{importFileExtension}}';
+{{/operations}}
+
+{{#operations}}
+{{#operation}}
+
+export type {{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters =
+{{^useSingleRequestParameter}}
+  { parameters: Parameters<{{classname}}['{{nickname}}']>};
+{{/useSingleRequestParameter}}
+{{#useSingleRequestParameter}}
+  {{#allParams.0}}{{#prefixParameterInterfaces}}{{classname}}{{/prefixParameterInterfaces}}{{operationIdCamelCase}}Request{{/allParams.0}}{{^allParams.0}}void{{/allParams.0}};
+{{/useSingleRequestParameter}}
+
+/**
+  {{#notes}}
+  * {{&notes}}
+  {{/notes}}
+  {{#summary}}
+  * {{&summary}}
+  {{/summary}}
+  {{#isDeprecated}}
+  * @deprecated
+  {{/isDeprecated}}
+  */
+export const use{{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Mutation = <TContext = unknown>(
+  { onSuccess, ...options }: Omit<UseMutationOptions<{{{returnType}}}{{^returnType}}void{{/returnType}}, Error, {{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters, TContext>, 'mutationFn'> = {}
+): UseMutationResult<{{{returnType}}}{{^returnType}}void{{/returnType}}, Error, {{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters, TContext> => {
+  const api = useApi({{classname}});
+  return useMutation<{{{returnType}}}{{^returnType}}void{{/returnType}}, Error, {{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters, TContext>({
+{{^useSingleRequestParameter}}
+    mutationFn: ({ parameters }) => api.{{nickname}}(...parameters),
+{{/useSingleRequestParameter}}
+{{#useSingleRequestParameter}}
+{{#allParams.0}}
+    mutationFn: (parameters) => api.{{nickname}}(parameters),
+{{/allParams.0}}
+{{^allParams.0}}
+    mutationFn: () => api.{{nickname}}(),
+{{/allParams.0}}
+{{/useSingleRequestParameter}}
+    ...options,
+  });
+}
+/**
+  {{#notes}}
+  * {{&notes}}
+  {{/notes}}
+  {{#summary}}
+  * {{&summary}}
+  {{/summary}}
+  {{#isDeprecated}}
+  * @deprecated
+  {{/isDeprecated}}
+  */
+export const use{{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Query = (
+  options: Partial<Omit<UseQueryOptions<{{{returnType}}}{{^returnType}}void{{/returnType}}>, 'queryFn'>> = {}
+{{^useSingleRequestParameter}}
+  ,{parameters}: Partial<{{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters>
+{{/useSingleRequestParameter}}
+{{#useSingleRequestParameter}}
+{{#allParams.0}}
+  ,parameter: {{classname}}{{#lambda.titlecase}}{{nickname}}{{/lambda.titlecase}}Parameters | undefined
+{{/allParams.0}}
+{{/useSingleRequestParameter}}
+): UseQueryResult<{{{returnType}}}{{^returnType}}void{{/returnType}}> => {
+  const api = useApi({{classname}});
+  return useQuery<{{{returnType}}}{{^returnType}}void{{/returnType}}>({
+{{^useSingleRequestParameter}}
+    queryKey: ['{{classname}}','{{nickname}}', ...requestParameters],
+    queryFn: ({ signal }) => api.{{nickname}}(...requestParameters.slice(0, -1), { ...requestParameters[requestParameters.length - 1], signal }),
+    enabled: !!parameters,
+{{/useSingleRequestParameter}}
+{{#useSingleRequestParameter}}
+{{#allParams.0}}
+    queryKey: ['{{classname}}','{{nickname}}', parameter],
+    queryFn: ({ signal }) => api.{{nickname}}(parameter, { signal }),
+    enabled: !!parameter,
+{{/allParams.0}}
+{{^allParams.0}}
+    queryKey: ['{{classname}}','{{nickname}}'],
+    queryFn: ({ signal }) => api.{{nickname}}({ signal }),
+{{/allParams.0}}
+{{/useSingleRequestParameter}}
+    ...options,
+  });
+}
+{{/operation}}
+
+{{/operations}}

package/targets/react/templates/package.mustache

@@ -0,0 +1,45 @@
+{
+  "name": "{{npmName}}",
+  "version": "{{npmVersion}}",
+  "description": "OpenAPI client for {{npmName}}",
+  "author": "OpenAPI-Generator",
+  "repository": {
+    "type": "git",
+    "url": "https://{{gitHost}}/{{gitUserId}}/{{gitRepoId}}.git"
+  },
+{{#packageAsSourceOnlyLibrary}}
+  "main": "./index.ts",
+{{/packageAsSourceOnlyLibrary}}
+{{^packageAsSourceOnlyLibrary}}
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
+{{#supportsES6}}
+  "module": "./dist/esm/index.js",
+  "sideEffects": false,
+{{/supportsES6}}
+  "scripts": {
+    "build": "tsc{{#supportsES6}} && tsc -p tsconfig.esm.json{{/supportsES6}}"{{^sagasAndRecords}},
+    "prepare": "npm run build"{{/sagasAndRecords}}
+  },
+{{/packageAsSourceOnlyLibrary}}
+  "devDependencies": {
+{{#sagasAndRecords}}
+    "immutable": "^4.0.0-rc.12",
+    "normalizr": "^3.6.1",
+    "redux-saga": "^1.1.3",
+    "redux-ts-simple": "^3.2.0",
+    "reselect": "^4.0.0",
+{{/sagasAndRecords}}
+    "typescript": "^4.0",
+    "@types/react": "^18.2.24"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@tanstack/react-query": "^5.12.2"
+  }{{#npmRepository}},{{/npmRepository}}
+{{#npmRepository}}
+  "publishConfig": {
+    "registry": "{{npmRepository}}"
+  }
+{{/npmRepository}}
+}

package/targets/react/templates/tsconfig.esm.mustache

@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "esnext",
+    "outDir": "dist/esm",
+    "jsx": "react-jsx"
+  }
+}

package/targets/react/templates/tsconfig.mustache

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "declaration": true,
+    "target": "{{#supportsES6}}es6{{/supportsES6}}{{^supportsES6}}es5{{/supportsES6}}",
+{{#sagasAndRecords}}
+    "strict": true,
+{{/sagasAndRecords}}
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "outDir": "dist",
+    {{^supportsES6}}
+    "lib": [
+      "es6",
+      "dom"
+    ],
+    {{/supportsES6}}
+    "typeRoots": [
+      "node_modules/@types"
+    ],
+    "jsx": "react-jsx",
+  },
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}

package/targets/react/templates/use-api.hook.mustache

@@ -0,0 +1,155 @@
+import {
+  createContext,
+  useContext,
+  useCallback,
+  useMemo,
+  FC,
+  PropsWithChildren,
+} from "react";
+import * as runtime from '../runtime';
+{{#apiInfo}}
+{{#apis}}
+{{#operations}}
+import { {{classname}} } from './{{ classFilename }}{{importFileExtension}}';
+{{/operations}}
+{{/apis}}
+
+
+type APIS_IN_ORDER = [
+  {{#apis}}
+  {{#operations}}
+  {{classname}},
+  {{/operations}}
+  {{/apis}}
+];
+
+export type APIS = APIS_IN_ORDER[number];
+
+export declare interface Type<T> extends Function {
+  new (...args: any[]): T;
+}
+
+export const ApiContext = createContext<{ getApi: <T extends APIS>(api: Type<T>) => T | undefined }>({
+  getApi: () => undefined,
+});
+
+export const getApiInstance = <TArray extends APIS[], T extends TArray[number]>(
+  api: Type<T>,
+  apis: TArray
+): T => {
+  return  apis.find((a) => a instanceof api) as T;
+};
+
+export const ApiProvider: FC<PropsWithChildren<{ apis: APIS[] }>> = ({
+  apis,
+  children,
+}) => {
+  const parent = useContext(ApiContext);
+  const getApi = useCallback(<T extends APIS>(api: Type<T>): T => {
+    const apiInstance = (apis.find((a) => a instanceof api) ?? parent.getApi(api)) as T | undefined;
+    if (!apiInstance) {
+      throw new Error(`API instance for ${api.name} not found. Please provide it using ApiProvider from '{{npmName}}'`);
+    }
+    return apiInstance;
+  }, [apis, parent.getApi]);
+  const value = useMemo(() => ({ getApi }), [getApi]);
+
+  return (
+    <ApiContext.Provider value={value}>
+      {children}
+    </ApiContext.Provider>
+  );
+};
+
+export const useApi = <T extends APIS>(api: Type<T>): T => {
+  const { getApi } = useContext(ApiContext);
+  return getApi(api);
+}
+
+export const ApiConfigContext = createContext<runtime.ConfigurationParameters>({});
+
+export const ApiConfigProvider: FC<PropsWithChildren<{ config: runtime.ConfigurationParameters }>> = ({
+  config,
+  children,
+}) => {
+  return (
+    <ApiConfigContext.Provider value={config}>
+      {children}
+    </ApiConfigContext.Provider>
+  );
+};
+
+export const ApiConfigWithInheritProvider: FC<PropsWithChildren<{ config: runtime.ConfigurationParameters }>> = ({
+  config,
+  children,
+}) => {
+  const parent = useContext(ApiConfigContext);
+  const value = useMemo(() => ({
+    ...parent,
+    ...config,
+    middleware: [...parent.middleware ?? [], ...config.middleware ?? []],
+    headers: { ...parent.headers, ...config.headers },
+  }), [parent, config]);
+
+  return (
+    <ApiConfigContext.Provider value={value}>
+      {children}
+    </ApiConfigContext.Provider>
+  );
+};
+
+export const useApiConfig = (): runtime.Configuration => {
+  const configParameters = useContext(ApiConfigContext);
+  const config = useMemo(() => new runtime.Configuration(configParameters), [configParameters]);
+  return config;
+}
+
+type ReadonlyApiConstructorToType<T> = T extends [
+  infer ARRAYFIRST,
+  ...infer ARRAYREST
+]
+  ? ARRAYFIRST extends InstanceType<infer ARRAYFIRSTTYPE>
+    ? [InstanceType<ARRAYFIRST>, ...ReadonlyApiConstructorToType<ARRAYREST>]
+    : []
+  : [];
+
+type ApiConstructorToType<T extends Array<unknown>> = T[0] extends undefined
+  ? APIS_IN_ORDER
+  : ReadonlyApiConstructorToType<T> extends []
+  ? APIS[]
+  : ReadonlyApiConstructorToType<T>;
+
+export const createApiInstances = <T extends Type<APIS>[]>(
+  config: runtime.Configuration,
+  apis: T = [] as unknown as T
+): ApiConstructorToType<T> => {
+  if (apis.length > 0) {
+    return apis.map((api) => new api(config)) as ApiConstructorToType<T>;
+  }
+  return [
+    {{#apis}}
+    {{#operations}}
+    new {{classname}}(config),
+    {{/operations}}
+    {{/apis}}
+  ] as unknown as ApiConstructorToType<T>;
+};
+
+export const useCreateApiInstances = <T extends Type<APIS>[]>(
+  apis: T = [] as unknown as T
+): ApiConstructorToType<T> => {
+  const config = useApiConfig();
+  return useMemo(() => createApiInstances(config, apis), [apis, config]);
+};
+{{/apiInfo}}
+
+export const ApiInstancesProvider: FC<PropsWithChildren<{ apis: Type<APIS>[] }>> = (
+  { apis, children }
+) => {
+  const apiInstances = useCreateApiInstances(apis);
+  return (
+    <ApiProvider apis={apiInstances}>
+      {children}
+    </ApiProvider>
+  );
+};