typed-openapi 1.4.5 → 1.5.1

package/dist/pretty.export.js

@@ -0,0 +1,6 @@
+import {
+  prettify
+} from "./chunk-KAEXXJ7X.js";
+export {
+  prettify
+};

package/dist/types-DLE5RaXi.d.ts

@@ -0,0 +1,242 @@
+import * as openapi3_ts_oas31 from 'openapi3-ts/oas31';
+import { OpenAPIObject, ReferenceObject, OperationObject, SchemaObject } from 'openapi3-ts/oas31';
+import { SchemaObject as SchemaObject$1 } from 'openapi3-ts/oas30';
+
+declare class Box<T extends AnyBoxDef = AnyBoxDef> {
+    definition: T;
+    type: T["type"];
+    value: T["value"];
+    params: T["params"];
+    schema: T["schema"];
+    ctx: T["ctx"];
+    constructor(definition: T);
+    toJSON(): {
+        type: T["type"];
+        value: T["value"];
+    };
+    toString(): string;
+    recompute(callback: OpenapiSchemaConvertContext["onBox"]): Box<AnyBoxDef>;
+    static fromJSON(json: string): Box<any>;
+    static isBox(box: unknown): box is Box<AnyBoxDef>;
+    static isUnion(box: Box<AnyBoxDef>): box is Box<BoxUnion>;
+    static isIntersection(box: Box<AnyBoxDef>): box is Box<BoxIntersection>;
+    static isArray(box: Box<AnyBoxDef>): box is Box<BoxArray>;
+    static isOptional(box: Box<AnyBoxDef>): box is Box<BoxOptional>;
+    static isReference(box: Box<AnyBoxDef>): box is Box<BoxRef>;
+    static isKeyword(box: Box<AnyBoxDef>): box is Box<BoxKeyword>;
+    static isObject(box: Box<AnyBoxDef>): box is Box<BoxObject>;
+    static isLiteral(box: Box<AnyBoxDef>): box is Box<BoxLiteral>;
+}
+
+type RefInfo = {
+    /**
+     * The (potentially autocorrected) ref
+     * @example "#/components/schemas/MySchema"
+     */
+    ref: string;
+    /**
+     * The name of the ref
+     * @example "MySchema"
+     * */
+    name: string;
+    normalized: string;
+    kind: "schemas" | "responses" | "parameters" | "requestBodies" | "headers";
+};
+declare const createRefResolver: (doc: OpenAPIObject, factory: GenericFactory, nameTransform?: NameTransformOptions) => {
+    get: <T = LibSchemaObject>(ref: string) => NonNullable<T>;
+    unwrap: <T extends ReferenceObject | {}>(component: T) => Exclude<T, ReferenceObject>;
+    getInfosByRef: (ref: string) => RefInfo;
+    infos: Map<string, RefInfo>;
+    /**
+     * Get the schemas in the order they should be generated, depending on their dependencies
+     * so that a schema is generated before the ones that depend on it
+     */
+    getOrderedSchemas: () => [schema: Box<AnyBoxDef>, infos: RefInfo][];
+    directDependencies: Map<string, Set<string>>;
+    transitiveDependencies: Map<string, Set<string>>;
+};
+interface RefResolver extends ReturnType<typeof createRefResolver> {
+}
+
+declare const mapOpenApiEndpoints: (doc: OpenAPIObject, options?: {
+    nameTransform?: NameTransformOptions;
+}) => {
+    doc: OpenAPIObject;
+    refs: {
+        get: <T = LibSchemaObject>(ref: string) => NonNullable<T>;
+        unwrap: <T extends openapi3_ts_oas31.ReferenceObject | {}>(component: T) => Exclude<T, openapi3_ts_oas31.ReferenceObject>;
+        getInfosByRef: (ref: string) => RefInfo;
+        infos: Map<string, RefInfo>;
+        getOrderedSchemas: () => [schema: Box<AnyBoxDef>, infos: RefInfo][];
+        directDependencies: Map<string, Set<string>>;
+        transitiveDependencies: Map<string, Set<string>>;
+    };
+    endpointList: Endpoint<DefaultEndpoint>[];
+    factory: {
+        union: (types: StringOrBox[]) => string;
+        intersection: (types: StringOrBox[]) => string;
+        array: (type: StringOrBox) => string;
+        optional: (type: StringOrBox) => string;
+        reference: (name: string, typeArgs: StringOrBox[] | undefined) => string;
+        literal: (value: StringOrBox) => string;
+        string: () => "string";
+        number: () => "number";
+        boolean: () => "boolean";
+        unknown: () => "unknown";
+        any: () => "any";
+        never: () => "never";
+        object: (props: Record<string, StringOrBox>) => string;
+    };
+};
+type MutationMethod = "post" | "put" | "patch" | "delete";
+type Method = "get" | "head" | "options" | MutationMethod;
+type EndpointParameters = {
+    body?: Box<BoxRef>;
+    query?: Box<BoxRef> | Record<string, AnyBox>;
+    header?: Box<BoxRef> | Record<string, AnyBox>;
+    path?: Box<BoxRef> | Record<string, AnyBox>;
+};
+type RequestFormat = "json" | "form-data" | "form-url" | "binary" | "text";
+type DefaultEndpoint = {
+    parameters?: EndpointParameters | undefined;
+    response: AnyBox;
+    responseHeaders?: Record<string, AnyBox>;
+};
+type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
+    operation: OperationObject;
+    method: Method;
+    path: string;
+    parameters?: TConfig["parameters"];
+    requestFormat: RequestFormat;
+    meta: {
+        alias: string;
+        hasParameters: boolean;
+        areParametersRequired: boolean;
+    };
+    response: TConfig["response"];
+    responseHeaders?: TConfig["responseHeaders"];
+};
+
+type LibSchemaObject = SchemaObject & SchemaObject$1;
+type BoxDefinition = {
+    type: string;
+    params: unknown;
+    value: string;
+};
+type BoxParams = string | BoxDefinition;
+type WithSchema = {
+    schema: LibSchemaObject | ReferenceObject | undefined;
+    ctx: OpenapiSchemaConvertContext;
+};
+type BoxUnion = WithSchema & {
+    type: "union";
+    params: {
+        types: Array<BoxParams>;
+    };
+    value: string;
+};
+type BoxIntersection = WithSchema & {
+    type: "intersection";
+    params: {
+        types: Array<BoxParams>;
+    };
+    value: string;
+};
+type BoxArray = WithSchema & {
+    type: "array";
+    params: {
+        type: BoxParams;
+    };
+    value: string;
+};
+type BoxOptional = WithSchema & {
+    type: "optional";
+    params: {
+        type: BoxParams;
+    };
+    value: string;
+};
+type BoxRef = WithSchema & {
+    type: "ref";
+    params: {
+        name: string;
+        generics?: BoxParams[] | undefined;
+    };
+    value: string;
+};
+type BoxLiteral = WithSchema & {
+    type: "literal";
+    params: {};
+    value: string;
+};
+type BoxKeyword = WithSchema & {
+    type: "keyword";
+    params: {
+        name: string;
+    };
+    value: string;
+};
+type BoxObject = WithSchema & {
+    type: "object";
+    params: {
+        props: Record<string, BoxParams>;
+    };
+    value: string;
+};
+type AnyBoxDef = BoxUnion | BoxIntersection | BoxArray | BoxOptional | BoxRef | BoxLiteral | BoxKeyword | BoxObject;
+type AnyBox = Box<AnyBoxDef>;
+type OpenapiSchemaConvertArgs = {
+    schema: SchemaObject | ReferenceObject;
+    ctx: OpenapiSchemaConvertContext;
+    meta?: {} | undefined;
+};
+type FactoryCreator = (schema: SchemaObject | ReferenceObject, ctx: OpenapiSchemaConvertContext) => GenericFactory;
+type NameTransformOptions = {
+    transformSchemaName?: (name: string) => string;
+    transformEndpointName?: (endpoint: {
+        alias: string;
+        operation: OperationObject;
+        method: Method;
+        path: string;
+    }) => string;
+};
+type OpenapiSchemaConvertContext = {
+    factory: FactoryCreator | GenericFactory;
+    refs: RefResolver;
+    onBox?: (box: Box<AnyBoxDef>) => Box<AnyBoxDef>;
+    nameTransform?: NameTransformOptions;
+};
+type StringOrBox = string | Box<AnyBoxDef>;
+type BoxFactory = {
+    union: (types: Array<StringOrBox>) => Box<BoxUnion>;
+    intersection: (types: Array<StringOrBox>) => Box<BoxIntersection>;
+    array: (type: StringOrBox) => Box<BoxArray>;
+    object: (props: Record<string, StringOrBox>) => Box<BoxObject>;
+    optional: (type: StringOrBox) => Box<BoxOptional>;
+    reference: (name: string, generics?: Array<StringOrBox> | undefined) => Box<BoxRef>;
+    literal: (value: StringOrBox) => Box<BoxLiteral>;
+    string: () => Box<BoxKeyword>;
+    number: () => Box<BoxKeyword>;
+    boolean: () => Box<BoxKeyword>;
+    unknown: () => Box<BoxKeyword>;
+    any: () => Box<BoxKeyword>;
+    never: () => Box<BoxKeyword>;
+};
+type GenericFactory = {
+    callback?: OpenapiSchemaConvertContext["onBox"];
+    union: (types: Array<StringOrBox>) => string;
+    intersection: (types: Array<StringOrBox>) => string;
+    array: (type: StringOrBox) => string;
+    object: (props: Record<string, StringOrBox>) => string;
+    optional: (type: StringOrBox) => string;
+    reference: (name: string, generics?: Array<StringOrBox> | undefined) => string;
+    literal: (value: StringOrBox) => string;
+    string: () => string;
+    number: () => string;
+    boolean: () => string;
+    unknown: () => string;
+    any: () => string;
+    never: () => string;
+};
+
+export { type AnyBoxDef as A, type BoxFactory as B, type EndpointParameters as E, type FactoryCreator as F, type GenericFactory as G, type LibSchemaObject as L, type Method as M, type NameTransformOptions as N, type OpenapiSchemaConvertContext as O, type RefInfo as R, type StringOrBox as S, type WithSchema as W, type OpenapiSchemaConvertArgs as a, Box as b, type Endpoint as c, createRefResolver as d, type RefResolver as e, type BoxDefinition as f, type BoxParams as g, type BoxUnion as h, type BoxIntersection as i, type BoxArray as j, type BoxOptional as k, type BoxRef as l, mapOpenApiEndpoints as m, type BoxLiteral as n, type BoxKeyword as o, type BoxObject as p, type AnyBox as q };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "typed-openapi",
   "type": "module",
-  "version": "1.4.5",
+  "version": "1.5.1",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",
-    "./node": "./dist/node.export.js"
+    "./node": "./dist/node.export.js",
+    "./pretty": "./dist/pretty.export.js"
   },
   "bin": {
     "typed-openapi": "bin.js"

package/src/cli.ts

@@ -15,11 +15,7 @@ cli
     `Runtime to use for validation; defaults to \`none\`; available: ${allowedRuntimes.toString()}`,
     { default: "none" },
   )
-  .option(
-    "--schemas-only",
-    "Only generate schemas, skipping client generation (defaults to false)",
-    { default: false },
-  )
+  .option("--schemas-only", "Only generate schemas, skipping client generation (defaults to false)", { default: false })
   .option(
     "--tanstack [name]",
     "Generate tanstack client, defaults to false, can optionally specify a name for the generated file",

package/src/generate-client-files.ts

@@ -7,6 +7,7 @@ import { allowedRuntimes, generateFile } from "./generator.ts";
 import { mapOpenApiEndpoints } from "./map-openapi-endpoints.ts";
 import { generateTanstackQueryFile } from "./tanstack-query.generator.ts";
 import { prettify } from "./format.ts";
+import type { NameTransformOptions } from "./types.ts";
 
 const cwd = process.cwd();
 const now = new Date();
@@ -26,17 +27,24 @@ export const optionsSchema = type({
   schemasOnly: "boolean",
 });
 
-export async function generateClientFiles(input: string, options: typeof optionsSchema.infer) {
+type GenerateClientFilesOptions = typeof optionsSchema.infer & {
+  nameTransform?: NameTransformOptions;
+};
+
+export async function generateClientFiles(input: string, options: GenerateClientFilesOptions) {
   const openApiDoc = (await SwaggerParser.bundle(input)) as OpenAPIObject;
 
-  const ctx = mapOpenApiEndpoints(openApiDoc);
+  const ctx = mapOpenApiEndpoints(openApiDoc, options);
   console.log(`Found ${ctx.endpointList.length} endpoints`);
 
-  const content = await prettify(generateFile({
-    ...ctx,
-    runtime: options.runtime,
-    schemasOnly: options.schemasOnly,
-  }));
+  const content = await prettify(
+    generateFile({
+      ...ctx,
+      runtime: options.runtime,
+      schemasOnly: options.schemasOnly,
+      nameTransform: options.nameTransform,
+    }),
+  );
   const outputPath = join(
     cwd,
     options.output ?? input + `.${options.runtime === "none" ? "client" : options.runtime}.ts`,
@@ -49,9 +57,12 @@ export async function generateClientFiles(input: string, options: typeof options
   if (options.tanstack) {
     const tanstackContent = await generateTanstackQueryFile({
       ...ctx,
-      relativeApiClientPath: './' + basename(outputPath),
+      relativeApiClientPath: "./" + basename(outputPath),
     });
-    const tanstackOutputPath = join(dirname(outputPath), typeof options.tanstack === "string" ? options.tanstack : `tanstack.client.ts`);
+    const tanstackOutputPath = join(
+      dirname(outputPath),
+      typeof options.tanstack === "string" ? options.tanstack : `tanstack.client.ts`,
+    );
     console.log("Generating tanstack client...", tanstackOutputPath);
     await ensureDir(dirname(tanstackOutputPath));
     await writeFile(tanstackOutputPath, tanstackContent);

package/src/generator.ts

@@ -6,10 +6,12 @@ import * as Codegen from "@sinclair/typebox-codegen";
 import { match } from "ts-pattern";
 import { type } from "arktype";
 import { wrapWithQuotesIfNeeded } from "./string-utils.ts";
+import type { NameTransformOptions } from "./types.ts";
 
 type GeneratorOptions = ReturnType<typeof mapOpenApiEndpoints> & {
   runtime?: "none" | keyof typeof runtimeValidationGenerator;
   schemasOnly?: boolean;
+  nameTransform?: NameTransformOptions | undefined;
 };
 type GeneratorContext = Required<GeneratorOptions>;
 
@@ -132,6 +134,25 @@ const parameterObjectToString = (parameters: Box<AnyBoxDef> | Record<string, Any
   }
   return str + "}";
 };
+
+const responseHeadersObjectToString = (responseHeaders: Record<string, AnyBox>, ctx: GeneratorContext) => {
+  let str = "{";
+  for (const [key, responseHeader] of Object.entries(responseHeaders)) {
+    const value =
+      ctx.runtime === "none"
+        ? responseHeader.recompute((box) => {
+            if (Box.isReference(box) && !box.params.generics && box.value !== "null") {
+              box.value = `Schemas.${box.value}`;
+            }
+
+            return box;
+          }).value
+        : responseHeader.value;
+    str += `${wrapWithQuotesIfNeeded(key.toLowerCase())}: ${value},\n`;
+  }
+  return str + "}";
+};
+
 const generateEndpointSchemaList = (ctx: GeneratorContext) => {
   let file = `
   ${ctx.runtime === "none" ? "export namespace Endpoints {" : ""}
@@ -178,6 +199,11 @@ const generateEndpointSchemaList = (ctx: GeneratorContext) => {
             }).value
           : endpoint.response.value
       },
+      ${
+        endpoint.responseHeaders
+          ? `responseHeaders: ${responseHeadersObjectToString(endpoint.responseHeaders, ctx)},`
+          : ""
+      }
     }\n`;
   });
 
@@ -246,6 +272,7 @@ type RequestFormat = "json" | "form-data" | "form-url" | "binary" | "text";
 export type DefaultEndpoint = {
   parameters?: EndpointParameters | undefined;
   response: unknown;
+  responseHeaders?: Record<string, unknown>;
 };
 
 export type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
@@ -260,6 +287,7 @@ export type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
     areParametersRequired: boolean;
   };
   response: TConfig["response"];
+  responseHeaders?: TConfig["responseHeaders"]
 };
 
 export type Fetcher = (method: Method, url: string, parameters?: EndpointParameters | undefined) => Promise<Response>;

package/src/map-openapi-endpoints.ts

@@ -8,11 +8,13 @@ import { createRefResolver } from "./ref-resolver.ts";
 import { tsFactory } from "./ts-factory.ts";
 import { AnyBox, BoxRef, OpenapiSchemaConvertContext } from "./types.ts";
 import { pathToVariableName } from "./string-utils.ts";
+import { NameTransformOptions } from "./types.ts";
 import { match, P } from "ts-pattern";
+import { sanitizeName } from "./sanitize-name.ts";
 
 const factory = tsFactory;
 
-export const mapOpenApiEndpoints = (doc: OpenAPIObject) => {
+export const mapOpenApiEndpoints = (doc: OpenAPIObject, options?: { nameTransform?: NameTransformOptions }) => {
   const refs = createRefResolver(doc, factory);
   const ctx: OpenapiSchemaConvertContext = { refs, factory };
   const endpointList = [] as Array<Endpoint>;
@@ -22,6 +24,10 @@ export const mapOpenApiEndpoints = (doc: OpenAPIObject) => {
     Object.entries(pathItem).forEach(([method, operation]) => {
       if (operation.deprecated) return;
 
+      let alias = getAlias({ path, method, operation } as Endpoint);
+      if (options?.nameTransform?.transformEndpointName) {
+        alias = options.nameTransform.transformEndpointName({ alias, path, method: method as Method, operation });
+      }
       const endpoint = {
         operation,
         method: method as Method,
@@ -29,7 +35,7 @@ export const mapOpenApiEndpoints = (doc: OpenAPIObject) => {
         requestFormat: "json",
         response: openApiSchemaToTs({ schema: {}, ctx }),
         meta: {
-          alias: getAlias({ path, method, operation } as Endpoint),
+          alias,
           areParametersRequired: false,
           hasParameters: false,
         },
@@ -84,7 +90,7 @@ export const mapOpenApiEndpoints = (doc: OpenAPIObject) => {
 
         if (matchingMediaType && content[matchingMediaType]) {
           params.body = openApiSchemaToTs({
-            schema: content[matchingMediaType]?.schema ?? {} ?? {},
+            schema: content[matchingMediaType]?.schema ?? {},
             ctx,
           });
         }
@@ -139,12 +145,25 @@ export const mapOpenApiEndpoints = (doc: OpenAPIObject) => {
         const matchingMediaType = Object.keys(content).find(isResponseMediaType);
         if (matchingMediaType && content[matchingMediaType]) {
           endpoint.response = openApiSchemaToTs({
-            schema: content[matchingMediaType]?.schema ?? {} ?? {},
+            schema: content[matchingMediaType]?.schema ?? {},
             ctx,
           });
         }
       }
 
+      // Map response headers
+      const headers = responseObject?.headers;
+      if (headers) {
+        endpoint.responseHeaders = Object.entries(headers).reduce(
+          (acc, [name, headerOrRef]) => {
+            const header = refs.unwrap(headerOrRef);
+            acc[name] = openApiSchemaToTs({ schema: header.schema ?? {}, ctx });
+            return acc;
+          },
+          {} as Record<string, Box>,
+        );
+      }
+
       endpointList.push(endpoint);
     });
   });
@@ -167,10 +186,13 @@ const isAllowedParamMediaTypes = (
 
 const isResponseMediaType = (mediaType: string) => mediaType === "application/json";
 const getAlias = ({ path, method, operation }: Endpoint) =>
-  (method + "_" + capitalize(operation.operationId ?? pathToVariableName(path))).replace(/-/g, "__");
+  sanitizeName(
+    (method + "_" + capitalize(operation.operationId ?? pathToVariableName(path))).replace(/-/g, "__"),
+    "endpoint",
+  );
 
 type MutationMethod = "post" | "put" | "patch" | "delete";
-type Method = "get" | "head" | "options" | MutationMethod;
+export type Method = "get" | "head" | "options" | MutationMethod;
 
 export type EndpointParameters = {
   body?: Box<BoxRef>;
@@ -184,6 +206,7 @@ type RequestFormat = "json" | "form-data" | "form-url" | "binary" | "text";
 type DefaultEndpoint = {
   parameters?: EndpointParameters | undefined;
   response: AnyBox;
+  responseHeaders?: Record<string, AnyBox>;
 };
 
 export type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
@@ -198,4 +221,5 @@ export type Endpoint<TConfig extends DefaultEndpoint = DefaultEndpoint> = {
     areParametersRequired: boolean;
   };
   response: TConfig["response"];
+  responseHeaders?: TConfig["responseHeaders"];
 };

package/src/node.export.ts

@@ -1,2 +1 @@
-export { prettify } from "./format.ts";
 export { generateClientFiles } from "./generate-client-files.ts";

package/src/openapi-schema-to-ts.ts

@@ -53,9 +53,9 @@ export const openApiSchemaToTs = ({ schema, meta: _inheritedMeta, ctx }: Openapi
 
     if (schema.allOf) {
       const types = schema.allOf.map((prop) => openApiSchemaToTs({ schema: prop, ctx, meta }));
-      const {allOf, externalDocs,  example, examples, description, title,  ...rest} = schema
+      const { allOf, externalDocs, example, examples, description, title, ...rest } = schema;
       if (Object.keys(rest).length > 0) {
-        types.push(openApiSchemaToTs({schema: rest, ctx, meta}))
+        types.push(openApiSchemaToTs({ schema: rest, ctx, meta }));
       }
       return t.intersection(types);
     }
@@ -72,7 +72,7 @@ export const openApiSchemaToTs = ({ schema, meta: _inheritedMeta, ctx }: Openapi
           } else if (value === false) {
             return t.literal("false");
           } else if (typeof value === "number") {
-            return t.literal(`${value}`)
+            return t.literal(`${value}`);
           } else {
             return t.literal(`"${value}"`);
           }
@@ -95,16 +95,18 @@ export const openApiSchemaToTs = ({ schema, meta: _inheritedMeta, ctx }: Openapi
       if (schemaType === "null") return t.literal("null");
     }
     if (!schemaType && schema.enum) {
-      return t.union(schema.enum.map((value) => {
-        if (typeof value === "string") {
-          return t.literal(`"${value}"`)
-        }
-        if (value === null) {
-          return t.literal("null")
-        }
-        // handle boolean and number literals
-        return t.literal(value)
-      }));
+      return t.union(
+        schema.enum.map((value) => {
+          if (typeof value === "string") {
+            return t.literal(`"${value}"`);
+          }
+          if (value === null) {
+            return t.literal("null");
+          }
+          // handle boolean and number literals
+          return t.literal(value);
+        }),
+      );
     }
 
     if (schemaType === "array") {

package/src/pretty.export.ts

@@ -0,0 +1 @@
+export { prettify } from "./format.ts";

package/src/ref-resolver.ts

@@ -5,8 +5,10 @@ import { Box } from "./box.ts";
 import { isReferenceObject } from "./is-reference-object.ts";
 import { openApiSchemaToTs } from "./openapi-schema-to-ts.ts";
 import { normalizeString } from "./string-utils.ts";
+import { NameTransformOptions } from "./types.ts";
 import { AnyBoxDef, GenericFactory, type LibSchemaObject } from "./types.ts";
 import { topologicalSort } from "./topological-sort.ts";
+import { sanitizeName } from "./sanitize-name.ts";
 
 const autocorrectRef = (ref: string) => (ref[1] === "/" ? ref : "#/" + ref.slice(1));
 const componentsWithSchemas = ["schemas", "responses", "parameters", "requestBodies", "headers"];
@@ -26,7 +28,11 @@ export type RefInfo = {
   kind: "schemas" | "responses" | "parameters" | "requestBodies" | "headers";
 };
 
-export const createRefResolver = (doc: OpenAPIObject, factory: GenericFactory) => {
+export const createRefResolver = (
+  doc: OpenAPIObject,
+  factory: GenericFactory,
+  nameTransform?: NameTransformOptions,
+) => {
   // both used for debugging purpose
   const nameByRef = new Map<string, string>();
   const refByName = new Map<string, string>();
@@ -48,7 +54,11 @@ export const createRefResolver = (doc: OpenAPIObject, factory: GenericFactory) =
 
     // "#/components/schemas/Something.jsonld" -> "Something.jsonld"
     const name = split[split.length - 1]!;
-    const normalized = normalizeString(name);
+    let normalized = normalizeString(name);
+    if (nameTransform?.transformSchemaName) {
+      normalized = nameTransform.transformSchemaName(normalized);
+    }
+    normalized = sanitizeName(normalized, "schema");
 
     nameByRef.set(correctRef, normalized);
     refByName.set(normalized, correctRef);

package/src/sanitize-name.ts

@@ -0,0 +1,79 @@
+const reservedWords = new Set([
+  // TS keywords and built-ins
+  "import",
+  "package",
+  "namespace",
+  "Record",
+  "Partial",
+  "Required",
+  "Readonly",
+  "Pick",
+  "Omit",
+  "String",
+  "Number",
+  "Boolean",
+  "Object",
+  "Array",
+  "Function",
+  "any",
+  "unknown",
+  "never",
+  "void",
+  "extends",
+  "super",
+  "class",
+  "interface",
+  "type",
+  "enum",
+  "const",
+  "let",
+  "var",
+  "if",
+  "else",
+  "for",
+  "while",
+  "do",
+  "switch",
+  "case",
+  "default",
+  "break",
+  "continue",
+  "return",
+  "try",
+  "catch",
+  "finally",
+  "throw",
+  "new",
+  "delete",
+  "in",
+  "instanceof",
+  "typeof",
+  "void",
+  "with",
+  "yield",
+  "await",
+  "static",
+  "public",
+  "private",
+  "protected",
+  "abstract",
+  "as",
+  "asserts",
+  "from",
+  "get",
+  "set",
+  "module",
+  "require",
+  "keyof",
+  "readonly",
+  "global",
+  "symbol",
+  "bigint",
+]);
+
+export function sanitizeName(name: string, type: "schema" | "endpoint") {
+  let n = name.replace(/[\W/]+/g, "_");
+  if (/^\d/.test(n)) n = "_" + n;
+  if (reservedWords.has(n)) n = (type === "schema" ? "Schema_" : "Endpoint_") + n;
+  return n;
+}