feat: Add the inject option (openapi-ts#1766)

* feat: Add the inject option

* Create little-pets-perform.md

Author: phk422

src/index.ts

@@ -83,6 +83,7 @@ export default async function openapiTS(
     propertiesRequiredByDefault: options.propertiesRequiredByDefault ?? false,
     redoc,
     silent: options.silent ?? false,
+    inject: options.inject ?? undefined,
     transform: typeof options.transform === "function" ? options.transform : undefined,
     resolve($ref) {
       return resolveRef(schema, $ref, { silent: options.silent ?? false });

src/transform/index.ts

@@ -1,5 +1,5 @@
 import ts, { type InterfaceDeclaration, type TypeLiteralNode } from "typescript";
-import { NEVER, STRING, tsModifiers, tsRecord } from "../lib/ts.js";
+import { NEVER, STRING, stringToAST, tsModifiers, tsRecord } from "../lib/ts.js";
 import { createRef, debug } from "../lib/utils.js";
 import type { GlobalContext, OpenAPI3 } from "../types.js";
 import transformComponentsObject from "./components-object.js";
@@ -19,6 +19,11 @@ const transformers: Record<SchemaTransforms, (node: any, options: GlobalContext)
 export default function transformSchema(schema: OpenAPI3, ctx: GlobalContext) {
   const type: ts.Node[] = [];
 
+  if (ctx.inject) {
+    const injectNodes = stringToAST(ctx.inject) as ts.Node[];
+    type.push(...injectNodes);
+  }
+
   for (const root of Object.keys(transformers) as SchemaTransforms[]) {
     const emptyObj = ts.factory.createTypeAliasDeclaration(
       /* modifiers      */ tsModifiers({ export: true }),

src/types.ts

@@ -660,6 +660,8 @@ export interface OpenAPITSOptions {
    * @see https://redocly.com/docs/cli/configuration/
    */
   redocly?: RedoclyConfig;
+  /** Inject arbitrary TypeScript types into the start of the file */
+  inject?: string;
 }
 
 /** Context passed to all submodules */
@@ -688,6 +690,7 @@ export interface GlobalContext {
   transform: OpenAPITSOptions["transform"];
   /** retrieve a node by $ref */
   resolve<T>($ref: string): T | undefined;
+  inject?: string;
 }
 
 export type $defs = Record<string, SchemaObject>;

test/index.test.ts

@@ -668,6 +668,32 @@ export type operations = Record<string, never>;`,
         // options: DEFAULT_OPTIONS,
       },
     ],
+    [
+      "inject option",
+      {
+        given: {
+          openapi: "3.1",
+          info: { title: "Test", version: "1.0" },
+        },
+        want: `type Foo = string;
+type Bar = number;
+export type paths = Record<string, never>;
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: never;
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;`,
+        options: {
+          inject: "type Foo = string;\ntype Bar = number;",
+        },
+      },
+    ],
   ];
 
   for (const [testName, { given, want, options, ci }] of tests) {