@depup/openapi-typescript 7.13.0-depup.0

package/dist/transform/index.mjs

@@ -0,0 +1,118 @@
+import { performance } from 'node:perf_hooks';
+import ts from 'typescript';
+import { stringToAST, tsModifiers, tsRecord, NEVER, STRING } from '../lib/ts.mjs';
+import { debug, createRef } from '../lib/utils.mjs';
+import transformComponentsObject from './components-object.mjs';
+import makeApiPathsEnum from './paths-enum.mjs';
+import transformPathsObject from './paths-object.mjs';
+import transformSchemaObject from './schema-object.mjs';
+import transformWebhooksObject from './webhooks-object.mjs';
+
+const transformers = {
+  paths: transformPathsObject,
+  webhooks: transformWebhooksObject,
+  components: transformComponentsObject,
+  $defs: (node, options) => transformSchemaObject(node, { path: createRef(["$defs"]), ctx: options, schema: node })
+};
+const READ_WRITE_HELPER_TYPES = `
+export type $Read<T> = { readonly $read: T };
+export type $Write<T> = { readonly $write: T };
+export type Readable<T> = T extends $Write<any> ? never : T extends $Read<infer U> ? Readable<U> : T extends (infer E)[] ? Readable<E>[] : T extends object ? { [K in keyof T as NonNullable<T[K]> extends $Write<any> ? never : K]: Readable<T[K]> } : T;
+export type Writable<T> = T extends $Read<any> ? never : T extends $Write<infer U> ? Writable<U> : T extends (infer E)[] ? Writable<E>[] : T extends object ? { [K in keyof T as NonNullable<T[K]> extends $Read<any> ? never : K]: Writable<T[K]> } & { [K in keyof T as NonNullable<T[K]> extends $Read<any> ? K : never]?: never } : T;
+`;
+function transformSchema(schema, ctx) {
+  const type = [];
+  if (ctx.readWriteMarkers) {
+    const helperNodes = stringToAST(READ_WRITE_HELPER_TYPES);
+    type.push(...helperNodes);
+  }
+  if (ctx.inject) {
+    const injectNodes = stringToAST(ctx.inject);
+    type.push(...injectNodes);
+  }
+  for (const root of Object.keys(transformers)) {
+    const emptyObj = ts.factory.createTypeAliasDeclaration(
+      /* modifiers      */
+      tsModifiers({ export: true }),
+      /* name           */
+      root,
+      /* typeParameters */
+      void 0,
+      /* type           */
+      tsRecord(STRING, NEVER)
+    );
+    if (schema[root] && typeof schema[root] === "object") {
+      const rootT = performance.now();
+      const subTypes = [].concat(transformers[root](schema[root], ctx));
+      for (const subType of subTypes) {
+        if (ts.isTypeNode(subType)) {
+          if (subType.members?.length) {
+            type.push(
+              ctx.exportType ? ts.factory.createTypeAliasDeclaration(
+                /* modifiers      */
+                tsModifiers({ export: true }),
+                /* name           */
+                root,
+                /* typeParameters */
+                void 0,
+                /* type           */
+                subType
+              ) : ts.factory.createInterfaceDeclaration(
+                /* modifiers       */
+                tsModifiers({ export: true }),
+                /* name            */
+                root,
+                /* typeParameters  */
+                void 0,
+                /* heritageClauses */
+                void 0,
+                /* members         */
+                subType.members
+              )
+            );
+            debug(`${root} done`, "ts", performance.now() - rootT);
+          } else {
+            type.push(emptyObj);
+            debug(`${root} done (skipped)`, "ts", 0);
+          }
+        } else if (ts.isTypeAliasDeclaration(subType)) {
+          type.push(subType);
+        } else {
+          type.push(emptyObj);
+          debug(`${root} done (skipped)`, "ts", 0);
+        }
+      }
+    } else {
+      type.push(emptyObj);
+      debug(`${root} done (skipped)`, "ts", 0);
+    }
+  }
+  let hasOperations = false;
+  for (const injectedType of ctx.injectFooter) {
+    if (!hasOperations && injectedType?.name?.escapedText === "operations") {
+      hasOperations = true;
+    }
+    type.push(injectedType);
+  }
+  if (!hasOperations) {
+    type.push(
+      ts.factory.createTypeAliasDeclaration(
+        /* modifiers      */
+        tsModifiers({ export: true }),
+        /* name           */
+        "operations",
+        /* typeParameters */
+        void 0,
+        /* type           */
+        tsRecord(STRING, NEVER)
+      )
+    );
+  }
+  if (ctx.makePathsEnum && schema.paths) {
+    type.push(makeApiPathsEnum(schema.paths));
+  }
+  return type;
+}
+
+export { transformSchema as default };
+//# sourceMappingURL=index.mjs.map

package/dist/transform/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../src/transform/index.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport ts, { type InterfaceDeclaration, type TypeLiteralNode } from \"typescript\";\nimport { NEVER, STRING, stringToAST, tsModifiers, tsRecord } from \"../lib/ts.js\";\nimport { createRef, debug } from \"../lib/utils.js\";\nimport type { GlobalContext, OpenAPI3 } from \"../types.js\";\nimport transformComponentsObject from \"./components-object.js\";\nimport makeApiPathsEnum from \"./paths-enum.js\";\nimport transformPathsObject from \"./paths-object.js\";\nimport transformSchemaObject from \"./schema-object.js\";\nimport transformWebhooksObject from \"./webhooks-object.js\";\n\ntype SchemaTransforms = keyof Pick<OpenAPI3, \"paths\" | \"webhooks\" | \"components\" | \"$defs\">;\n\nconst transformers: Record<SchemaTransforms, (node: any, options: GlobalContext) => ts.Node | ts.Node[]> = {\n  paths: transformPathsObject,\n  webhooks: transformWebhooksObject,\n  components: transformComponentsObject,\n  $defs: (node, options) => transformSchemaObject(node, { path: createRef([\"$defs\"]), ctx: options, schema: node }),\n};\n\n// Inline helper types for readOnly/writeOnly markers (when readWriteMarkers is enabled)\nconst READ_WRITE_HELPER_TYPES = `\nexport type $Read<T> = { readonly $read: T };\nexport type $Write<T> = { readonly $write: T };\nexport type Readable<T> = T extends $Write<any> ? never : T extends $Read<infer U> ? Readable<U> : T extends (infer E)[] ? Readable<E>[] : T extends object ? { [K in keyof T as NonNullable<T[K]> extends $Write<any> ? never : K]: Readable<T[K]> } : T;\nexport type Writable<T> = T extends $Read<any> ? never : T extends $Write<infer U> ? Writable<U> : T extends (infer E)[] ? Writable<E>[] : T extends object ? { [K in keyof T as NonNullable<T[K]> extends $Read<any> ? never : K]: Writable<T[K]> } & { [K in keyof T as NonNullable<T[K]> extends $Read<any> ? K : never]?: never } : T;\n`;\n\nexport default function transformSchema(schema: OpenAPI3, ctx: GlobalContext) {\n  const type: ts.Node[] = [];\n\n  // Add inline helper types for readOnly/writeOnly markers\n  if (ctx.readWriteMarkers) {\n    const helperNodes = stringToAST(READ_WRITE_HELPER_TYPES) as ts.Node[];\n    type.push(...helperNodes);\n  }\n\n  if (ctx.inject) {\n    const injectNodes = stringToAST(ctx.inject) as ts.Node[];\n    type.push(...injectNodes);\n  }\n\n  for (const root of Object.keys(transformers) as SchemaTransforms[]) {\n    const emptyObj = ts.factory.createTypeAliasDeclaration(\n      /* modifiers      */ tsModifiers({ export: true }),\n      /* name           */ root,\n      /* typeParameters */ undefined,\n      /* type           */ tsRecord(STRING, NEVER),\n    );\n\n    if (schema[root] && typeof schema[root] === \"object\") {\n      const rootT = performance.now();\n      const subTypes = ([] as ts.Node[]).concat(transformers[root](schema[root], ctx));\n      for (const subType of subTypes) {\n        if (ts.isTypeNode(subType)) {\n          if ((subType as ts.TypeLiteralNode).members?.length) {\n            type.push(\n              ctx.exportType\n                ? ts.factory.createTypeAliasDeclaration(\n                    /* modifiers      */ tsModifiers({ export: true }),\n                    /* name           */ root,\n                    /* typeParameters */ undefined,\n                    /* type           */ subType,\n                  )\n                : ts.factory.createInterfaceDeclaration(\n                    /* modifiers       */ tsModifiers({ export: true }),\n                    /* name            */ root,\n                    /* typeParameters  */ undefined,\n                    /* heritageClauses */ undefined,\n                    /* members         */ (subType as TypeLiteralNode).members,\n                  ),\n            );\n            debug(`${root} done`, \"ts\", performance.now() - rootT);\n          } else {\n            type.push(emptyObj);\n            debug(`${root} done (skipped)`, \"ts\", 0);\n          }\n        } else if (ts.isTypeAliasDeclaration(subType)) {\n          type.push(subType);\n        } else {\n          type.push(emptyObj);\n          debug(`${root} done (skipped)`, \"ts\", 0);\n        }\n      }\n    } else {\n      type.push(emptyObj);\n      debug(`${root} done (skipped)`, \"ts\", 0);\n    }\n  }\n\n  // inject\n  let hasOperations = false;\n  for (const injectedType of ctx.injectFooter) {\n    if (!hasOperations && (injectedType as InterfaceDeclaration)?.name?.escapedText === \"operations\") {\n      hasOperations = true;\n    }\n    type.push(injectedType);\n  }\n  if (!hasOperations) {\n    // if no operations created, inject empty operations type\n    type.push(\n      ts.factory.createTypeAliasDeclaration(\n        /* modifiers      */ tsModifiers({ export: true }),\n        /* name           */ \"operations\",\n        /* typeParameters */ undefined,\n        /* type           */ tsRecord(STRING, NEVER),\n      ),\n    );\n  }\n\n  if (ctx.makePathsEnum && schema.paths) {\n    type.push(makeApiPathsEnum(schema.paths));\n  }\n\n  return type;\n}\n"],"names":[],"mappings":"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"}

package/dist/transform/media-type-object.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+const ts = require('../lib/ts.cjs');
+const schemaObject = require('./schema-object.cjs');
+
+function transformMediaTypeObject(mediaTypeObject, options) {
+  if (!mediaTypeObject.schema) {
+    return ts.UNKNOWN;
+  }
+  return schemaObject.default(mediaTypeObject.schema, options);
+}
+
+module.exports = transformMediaTypeObject;
+//# sourceMappingURL=media-type-object.cjs.map

package/dist/transform/media-type-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type-object.cjs","sources":["../../src/transform/media-type-object.ts"],"sourcesContent":["import type ts from \"typescript\";\nimport { UNKNOWN } from \"../lib/ts.js\";\nimport type { MediaTypeObject, TransformNodeOptions } from \"../types.js\";\nimport transformSchemaObject from \"./schema-object.js\";\n\n/**\n * Transform MediaTypeObject nodes (4.8.14)\n * @see https://spec.openapis.org/oas/v3.1.0#media-type-object\n */\nexport default function transformMediaTypeObject(\n  mediaTypeObject: MediaTypeObject,\n  options: TransformNodeOptions,\n): ts.TypeNode {\n  if (!mediaTypeObject.schema) {\n    return UNKNOWN;\n  }\n  return transformSchemaObject(mediaTypeObject.schema, options);\n}\n"],"names":["UNKNOWN","transformSchemaObject"],"mappings":";;;;;AASA,SAAwB,wBAAA,CACtB,iBACA,OAAA,EACa;AACb,EAAA,IAAI,CAAC,gBAAgB,MAAA,EAAQ;AAC3B,IAAA,OAAOA,UAAA;AAAA,EACT;AACA,EAAA,OAAOC,oBAAA,CAAsB,eAAA,CAAgB,MAAA,EAAQ,OAAO,CAAA;AAC9D;;;;"}

package/dist/transform/media-type-object.mjs

@@ -0,0 +1,12 @@
+import { UNKNOWN } from '../lib/ts.mjs';
+import transformSchemaObject from './schema-object.mjs';
+
+function transformMediaTypeObject(mediaTypeObject, options) {
+  if (!mediaTypeObject.schema) {
+    return UNKNOWN;
+  }
+  return transformSchemaObject(mediaTypeObject.schema, options);
+}
+
+export { transformMediaTypeObject as default };
+//# sourceMappingURL=media-type-object.mjs.map

package/dist/transform/media-type-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type-object.mjs","sources":["../../src/transform/media-type-object.ts"],"sourcesContent":["import type ts from \"typescript\";\nimport { UNKNOWN } from \"../lib/ts.js\";\nimport type { MediaTypeObject, TransformNodeOptions } from \"../types.js\";\nimport transformSchemaObject from \"./schema-object.js\";\n\n/**\n * Transform MediaTypeObject nodes (4.8.14)\n * @see https://spec.openapis.org/oas/v3.1.0#media-type-object\n */\nexport default function transformMediaTypeObject(\n  mediaTypeObject: MediaTypeObject,\n  options: TransformNodeOptions,\n): ts.TypeNode {\n  if (!mediaTypeObject.schema) {\n    return UNKNOWN;\n  }\n  return transformSchemaObject(mediaTypeObject.schema, options);\n}\n"],"names":[],"mappings":";;;AASA,SAAwB,wBAAA,CACtB,iBACA,OAAA,EACa;AACb,EAAA,IAAI,CAAC,gBAAgB,MAAA,EAAQ;AAC3B,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,OAAO,qBAAA,CAAsB,eAAA,CAAgB,MAAA,EAAQ,OAAO,CAAA;AAC9D;;;;"}

package/dist/transform/operation-object.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const ts$1 = require('typescript');
+const ts = require('../lib/ts.cjs');
+const utils = require('../lib/utils.cjs');
+const parametersArray = require('./parameters-array.cjs');
+const requestBodyObject = require('./request-body-object.cjs');
+const responsesObject = require('./responses-object.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const ts__default = /*#__PURE__*/_interopDefaultCompat(ts$1);
+
+function transformOperationObject(operationObject, options) {
+  const type = [];
+  type.push(...parametersArray.transformParametersArray(operationObject.parameters ?? [], options));
+  if (operationObject.requestBody) {
+    const requestBodyType = "$ref" in operationObject.requestBody ? ts.oapiRef(operationObject.requestBody.$ref) : requestBodyObject(operationObject.requestBody, {
+      ...options,
+      path: utils.createRef([options.path, "requestBody"])
+    });
+    const required = !!("$ref" in operationObject.requestBody ? options.ctx.resolve(operationObject.requestBody.$ref) : operationObject.requestBody)?.required;
+    const property = ts__default.factory.createPropertySignature(
+      /* modifiers     */
+      ts.tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      ts.tsPropertyIndex("requestBody"),
+      /* questionToken */
+      required ? void 0 : ts.QUESTION_TOKEN,
+      /* type          */
+      requestBodyType
+    );
+    ts.addJSDocComment(operationObject.requestBody, property);
+    type.push(property);
+  } else {
+    type.push(
+      ts__default.factory.createPropertySignature(
+        /* modifiers     */
+        ts.tsModifiers({ readonly: options.ctx.immutable }),
+        /* name          */
+        ts.tsPropertyIndex("requestBody"),
+        /* questionToken */
+        ts.QUESTION_TOKEN,
+        /* type          */
+        ts.NEVER
+      )
+    );
+  }
+  type.push(
+    ts__default.factory.createPropertySignature(
+      /* modifiers     */
+      ts.tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      ts.tsPropertyIndex("responses"),
+      /* questionToken */
+      void 0,
+      /* type          */
+      responsesObject(operationObject.responses ?? {}, options)
+    )
+  );
+  return type;
+}
+function injectOperationObject(operationId, operationObject, options) {
+  let operations = options.ctx.injectFooter.find(
+    (node) => ts__default.isInterfaceDeclaration(node) && node.name.text === "operations"
+  );
+  if (!operations) {
+    operations = ts__default.factory.createInterfaceDeclaration(
+      /* modifiers       */
+      ts.tsModifiers({
+        export: true
+        // important: do NOT make this immutable
+      }),
+      /* name            */
+      ts__default.factory.createIdentifier("operations"),
+      /* typeParameters  */
+      void 0,
+      /* heritageClauses */
+      void 0,
+      /* members         */
+      []
+    );
+    options.ctx.injectFooter.push(operations);
+  }
+  const type = transformOperationObject(operationObject, options);
+  operations.members = ts__default.factory.createNodeArray([
+    ...operations.members,
+    ts__default.factory.createPropertySignature(
+      /* modifiers     */
+      ts.tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      ts.tsPropertyIndex(operationId),
+      /* questionToken */
+      void 0,
+      /* type          */
+      ts__default.factory.createTypeLiteralNode(type)
+    )
+  ]);
+}
+
+exports.default = transformOperationObject;
+exports.injectOperationObject = injectOperationObject;
+//# sourceMappingURL=operation-object.cjs.map

package/dist/transform/operation-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-object.cjs","sources":["../../src/transform/operation-object.ts"],"sourcesContent":["import ts from \"typescript\";\nimport { addJSDocComment, NEVER, oapiRef, QUESTION_TOKEN, tsModifiers, tsPropertyIndex } from \"../lib/ts.js\";\nimport { createRef } from \"../lib/utils.js\";\nimport type { OperationObject, RequestBodyObject, TransformNodeOptions } from \"../types.js\";\nimport { transformParametersArray } from \"./parameters-array.js\";\nimport transformRequestBodyObject from \"./request-body-object.js\";\nimport transformResponsesObject from \"./responses-object.js\";\n\n/**\n * Transform OperationObject nodes (4.8.10)\n * @see https://spec.openapis.org/oas/v3.1.0#operation-object\n */\nexport default function transformOperationObject(\n  operationObject: OperationObject,\n  options: TransformNodeOptions,\n): ts.TypeElement[] {\n  const type: ts.TypeElement[] = [];\n\n  // parameters\n  type.push(...transformParametersArray(operationObject.parameters ?? [], options));\n\n  // requestBody\n  if (operationObject.requestBody) {\n    const requestBodyType =\n      \"$ref\" in operationObject.requestBody\n        ? oapiRef(operationObject.requestBody.$ref)\n        : transformRequestBodyObject(operationObject.requestBody, {\n            ...options,\n            path: createRef([options.path, \"requestBody\"]),\n          });\n    const required = !!(\n      \"$ref\" in operationObject.requestBody\n        ? options.ctx.resolve<RequestBodyObject>(operationObject.requestBody.$ref)\n        : operationObject.requestBody\n    )?.required;\n    const property = ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(\"requestBody\"),\n      /* questionToken */ required ? undefined : QUESTION_TOKEN,\n      /* type          */ requestBodyType,\n    );\n    addJSDocComment(operationObject.requestBody, property);\n    type.push(property);\n  } else {\n    type.push(\n      ts.factory.createPropertySignature(\n        /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n        /* name          */ tsPropertyIndex(\"requestBody\"),\n        /* questionToken */ QUESTION_TOKEN,\n        /* type          */ NEVER,\n      ),\n    );\n  }\n\n  // responses\n  type.push(\n    ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(\"responses\"),\n      /* questionToken */ undefined,\n      /* type          */ transformResponsesObject(operationObject.responses ?? {}, options),\n    ),\n  );\n\n  return type;\n}\n\n/** inject an operation at the top level */\nexport function injectOperationObject(\n  operationId: string,\n  operationObject: OperationObject,\n  options: TransformNodeOptions,\n): void {\n  // find or create top-level operations interface\n  let operations = options.ctx.injectFooter.find(\n    (node) => ts.isInterfaceDeclaration(node) && (node as ts.InterfaceDeclaration).name.text === \"operations\",\n  ) as unknown as ts.InterfaceDeclaration;\n  if (!operations) {\n    operations = ts.factory.createInterfaceDeclaration(\n      /* modifiers       */ tsModifiers({\n        export: true,\n        // important: do NOT make this immutable\n      }),\n      /* name            */ ts.factory.createIdentifier(\"operations\"),\n      /* typeParameters  */ undefined,\n      /* heritageClauses */ undefined,\n      /* members         */ [],\n    );\n    options.ctx.injectFooter.push(operations);\n  }\n\n  // inject operation object\n  const type = transformOperationObject(operationObject, options);\n  // @ts-expect-error this is OK to mutate\n  operations.members = ts.factory.createNodeArray([\n    ...operations.members,\n    ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(operationId),\n      /* questionToken */ undefined,\n      /* type          */ ts.factory.createTypeLiteralNode(type),\n    ),\n  ]);\n}\n"],"names":["transformParametersArray","oapiRef","transformRequestBodyObject","createRef","ts","tsModifiers","tsPropertyIndex","QUESTION_TOKEN","addJSDocComment","NEVER","transformResponsesObject"],"mappings":"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"}

package/dist/transform/operation-object.mjs

@@ -0,0 +1,96 @@
+import ts from 'typescript';
+import { oapiRef, tsModifiers, tsPropertyIndex, QUESTION_TOKEN, addJSDocComment, NEVER } from '../lib/ts.mjs';
+import { createRef } from '../lib/utils.mjs';
+import { transformParametersArray } from './parameters-array.mjs';
+import transformRequestBodyObject from './request-body-object.mjs';
+import transformResponsesObject from './responses-object.mjs';
+
+function transformOperationObject(operationObject, options) {
+  const type = [];
+  type.push(...transformParametersArray(operationObject.parameters ?? [], options));
+  if (operationObject.requestBody) {
+    const requestBodyType = "$ref" in operationObject.requestBody ? oapiRef(operationObject.requestBody.$ref) : transformRequestBodyObject(operationObject.requestBody, {
+      ...options,
+      path: createRef([options.path, "requestBody"])
+    });
+    const required = !!("$ref" in operationObject.requestBody ? options.ctx.resolve(operationObject.requestBody.$ref) : operationObject.requestBody)?.required;
+    const property = ts.factory.createPropertySignature(
+      /* modifiers     */
+      tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      tsPropertyIndex("requestBody"),
+      /* questionToken */
+      required ? void 0 : QUESTION_TOKEN,
+      /* type          */
+      requestBodyType
+    );
+    addJSDocComment(operationObject.requestBody, property);
+    type.push(property);
+  } else {
+    type.push(
+      ts.factory.createPropertySignature(
+        /* modifiers     */
+        tsModifiers({ readonly: options.ctx.immutable }),
+        /* name          */
+        tsPropertyIndex("requestBody"),
+        /* questionToken */
+        QUESTION_TOKEN,
+        /* type          */
+        NEVER
+      )
+    );
+  }
+  type.push(
+    ts.factory.createPropertySignature(
+      /* modifiers     */
+      tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      tsPropertyIndex("responses"),
+      /* questionToken */
+      void 0,
+      /* type          */
+      transformResponsesObject(operationObject.responses ?? {}, options)
+    )
+  );
+  return type;
+}
+function injectOperationObject(operationId, operationObject, options) {
+  let operations = options.ctx.injectFooter.find(
+    (node) => ts.isInterfaceDeclaration(node) && node.name.text === "operations"
+  );
+  if (!operations) {
+    operations = ts.factory.createInterfaceDeclaration(
+      /* modifiers       */
+      tsModifiers({
+        export: true
+        // important: do NOT make this immutable
+      }),
+      /* name            */
+      ts.factory.createIdentifier("operations"),
+      /* typeParameters  */
+      void 0,
+      /* heritageClauses */
+      void 0,
+      /* members         */
+      []
+    );
+    options.ctx.injectFooter.push(operations);
+  }
+  const type = transformOperationObject(operationObject, options);
+  operations.members = ts.factory.createNodeArray([
+    ...operations.members,
+    ts.factory.createPropertySignature(
+      /* modifiers     */
+      tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      tsPropertyIndex(operationId),
+      /* questionToken */
+      void 0,
+      /* type          */
+      ts.factory.createTypeLiteralNode(type)
+    )
+  ]);
+}
+
+export { transformOperationObject as default, injectOperationObject };
+//# sourceMappingURL=operation-object.mjs.map

package/dist/transform/operation-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-object.mjs","sources":["../../src/transform/operation-object.ts"],"sourcesContent":["import ts from \"typescript\";\nimport { addJSDocComment, NEVER, oapiRef, QUESTION_TOKEN, tsModifiers, tsPropertyIndex } from \"../lib/ts.js\";\nimport { createRef } from \"../lib/utils.js\";\nimport type { OperationObject, RequestBodyObject, TransformNodeOptions } from \"../types.js\";\nimport { transformParametersArray } from \"./parameters-array.js\";\nimport transformRequestBodyObject from \"./request-body-object.js\";\nimport transformResponsesObject from \"./responses-object.js\";\n\n/**\n * Transform OperationObject nodes (4.8.10)\n * @see https://spec.openapis.org/oas/v3.1.0#operation-object\n */\nexport default function transformOperationObject(\n  operationObject: OperationObject,\n  options: TransformNodeOptions,\n): ts.TypeElement[] {\n  const type: ts.TypeElement[] = [];\n\n  // parameters\n  type.push(...transformParametersArray(operationObject.parameters ?? [], options));\n\n  // requestBody\n  if (operationObject.requestBody) {\n    const requestBodyType =\n      \"$ref\" in operationObject.requestBody\n        ? oapiRef(operationObject.requestBody.$ref)\n        : transformRequestBodyObject(operationObject.requestBody, {\n            ...options,\n            path: createRef([options.path, \"requestBody\"]),\n          });\n    const required = !!(\n      \"$ref\" in operationObject.requestBody\n        ? options.ctx.resolve<RequestBodyObject>(operationObject.requestBody.$ref)\n        : operationObject.requestBody\n    )?.required;\n    const property = ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(\"requestBody\"),\n      /* questionToken */ required ? undefined : QUESTION_TOKEN,\n      /* type          */ requestBodyType,\n    );\n    addJSDocComment(operationObject.requestBody, property);\n    type.push(property);\n  } else {\n    type.push(\n      ts.factory.createPropertySignature(\n        /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n        /* name          */ tsPropertyIndex(\"requestBody\"),\n        /* questionToken */ QUESTION_TOKEN,\n        /* type          */ NEVER,\n      ),\n    );\n  }\n\n  // responses\n  type.push(\n    ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(\"responses\"),\n      /* questionToken */ undefined,\n      /* type          */ transformResponsesObject(operationObject.responses ?? {}, options),\n    ),\n  );\n\n  return type;\n}\n\n/** inject an operation at the top level */\nexport function injectOperationObject(\n  operationId: string,\n  operationObject: OperationObject,\n  options: TransformNodeOptions,\n): void {\n  // find or create top-level operations interface\n  let operations = options.ctx.injectFooter.find(\n    (node) => ts.isInterfaceDeclaration(node) && (node as ts.InterfaceDeclaration).name.text === \"operations\",\n  ) as unknown as ts.InterfaceDeclaration;\n  if (!operations) {\n    operations = ts.factory.createInterfaceDeclaration(\n      /* modifiers       */ tsModifiers({\n        export: true,\n        // important: do NOT make this immutable\n      }),\n      /* name            */ ts.factory.createIdentifier(\"operations\"),\n      /* typeParameters  */ undefined,\n      /* heritageClauses */ undefined,\n      /* members         */ [],\n    );\n    options.ctx.injectFooter.push(operations);\n  }\n\n  // inject operation object\n  const type = transformOperationObject(operationObject, options);\n  // @ts-expect-error this is OK to mutate\n  operations.members = ts.factory.createNodeArray([\n    ...operations.members,\n    ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(operationId),\n      /* questionToken */ undefined,\n      /* type          */ ts.factory.createTypeLiteralNode(type),\n    ),\n  ]);\n}\n"],"names":[],"mappings":"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"}

package/dist/transform/parameter-object.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+const ts = require('../lib/ts.cjs');
+const schemaObject = require('./schema-object.cjs');
+
+function transformParameterObject(parameterObject, options) {
+  return parameterObject.schema ? schemaObject.default(parameterObject.schema, options) : ts.STRING;
+}
+
+module.exports = transformParameterObject;
+//# sourceMappingURL=parameter-object.cjs.map

package/dist/transform/parameter-object.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-object.cjs","sources":["../../src/transform/parameter-object.ts"],"sourcesContent":["import type ts from \"typescript\";\nimport { STRING } from \"../lib/ts.js\";\nimport type { ParameterObject, TransformNodeOptions } from \"../types.js\";\nimport transformSchemaObject from \"./schema-object.js\";\n\n/**\n * Transform ParameterObject nodes (4.8.12)\n * @see https://spec.openapis.org/oas/v3.1.0#parameter-object\n */\nexport default function transformParameterObject(\n  parameterObject: ParameterObject,\n  options: TransformNodeOptions,\n): ts.TypeNode {\n  return parameterObject.schema ? transformSchemaObject(parameterObject.schema, options) : STRING; // assume a parameter is a string by default rather than \"unknown\"\n}\n"],"names":["transformSchemaObject","STRING"],"mappings":";;;;;AASA,SAAwB,wBAAA,CACtB,iBACA,OAAA,EACa;AACb,EAAA,OAAO,gBAAgB,MAAA,GAASA,oBAAA,CAAsB,eAAA,CAAgB,MAAA,EAAQ,OAAO,CAAA,GAAIC,SAAA;AAC3F;;;;"}

package/dist/transform/parameter-object.mjs

@@ -0,0 +1,9 @@
+import { STRING } from '../lib/ts.mjs';
+import transformSchemaObject from './schema-object.mjs';
+
+function transformParameterObject(parameterObject, options) {
+  return parameterObject.schema ? transformSchemaObject(parameterObject.schema, options) : STRING;
+}
+
+export { transformParameterObject as default };
+//# sourceMappingURL=parameter-object.mjs.map

package/dist/transform/parameter-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-object.mjs","sources":["../../src/transform/parameter-object.ts"],"sourcesContent":["import type ts from \"typescript\";\nimport { STRING } from \"../lib/ts.js\";\nimport type { ParameterObject, TransformNodeOptions } from \"../types.js\";\nimport transformSchemaObject from \"./schema-object.js\";\n\n/**\n * Transform ParameterObject nodes (4.8.12)\n * @see https://spec.openapis.org/oas/v3.1.0#parameter-object\n */\nexport default function transformParameterObject(\n  parameterObject: ParameterObject,\n  options: TransformNodeOptions,\n): ts.TypeNode {\n  return parameterObject.schema ? transformSchemaObject(parameterObject.schema, options) : STRING; // assume a parameter is a string by default rather than \"unknown\"\n}\n"],"names":[],"mappings":";;;AASA,SAAwB,wBAAA,CACtB,iBACA,OAAA,EACa;AACb,EAAA,OAAO,gBAAgB,MAAA,GAAS,qBAAA,CAAsB,eAAA,CAAgB,MAAA,EAAQ,OAAO,CAAA,GAAI,MAAA;AAC3F;;;;"}

package/dist/transform/parameters-array.cjs

@@ -0,0 +1,120 @@
+'use strict';
+
+const ts$1 = require('typescript');
+const ts = require('../lib/ts.cjs');
+const utils = require('../lib/utils.cjs');
+const parameterObject = require('./parameter-object.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const ts__default = /*#__PURE__*/_interopDefaultCompat(ts$1);
+
+const PATH_PARAM_RE = /\{([^}]+)\}/g;
+function createPathParameter(paramName) {
+  return {
+    name: paramName,
+    in: "path",
+    required: true,
+    schema: { type: "string" }
+  };
+}
+function extractPathParamsFromUrl(path) {
+  const params = [];
+  const matches = path.match(PATH_PARAM_RE);
+  if (matches) {
+    for (const match of matches) {
+      const paramName = match.slice(1, -1);
+      params.push(createPathParameter(paramName));
+    }
+  }
+  return params;
+}
+function transformParametersArray(parametersArray, options) {
+  const type = [];
+  const workingParameters = [...parametersArray];
+  if (options.ctx.generatePathParams && options.path) {
+    const pathString = Array.isArray(options.path) ? options.path[0] : options.path;
+    if (typeof pathString === "string") {
+      const pathParams = extractPathParamsFromUrl(pathString);
+      for (const param of pathParams) {
+        const exists = workingParameters.some((p) => {
+          const resolved = "$ref" in p ? options.ctx.resolve(p.$ref) : p;
+          return resolved?.in === "path" && resolved?.name === param.name;
+        });
+        if (!exists) {
+          workingParameters.push(param);
+        }
+      }
+    }
+  }
+  const paramType = [];
+  for (const paramIn of ["query", "header", "path", "cookie"]) {
+    const paramLocType = [];
+    let operationParameters = workingParameters.map((param) => ({
+      original: param,
+      resolved: "$ref" in param ? options.ctx.resolve(param.$ref) : param
+    }));
+    if (options.ctx.alphabetize) {
+      operationParameters.sort((a, b) => (a.resolved?.name ?? "").localeCompare(b.resolved?.name ?? ""));
+    }
+    if (options.ctx.excludeDeprecated) {
+      operationParameters = operationParameters.filter(
+        ({ resolved }) => !resolved?.deprecated && !resolved?.schema?.deprecated
+      );
+    }
+    for (const { original, resolved } of operationParameters) {
+      if (resolved?.in !== paramIn) {
+        continue;
+      }
+      let optional;
+      if (paramIn !== "path" && !resolved.required) {
+        optional = ts.QUESTION_TOKEN;
+      }
+      const subType = "$ref" in original ? ts.oapiRef(original.$ref, resolved) : parameterObject(resolved, {
+        ...options,
+        path: utils.createRef([options.path, "parameters", resolved.in, resolved.name])
+      });
+      const property = ts__default.factory.createPropertySignature(
+        /* modifiers     */
+        ts.tsModifiers({ readonly: options.ctx.immutable }),
+        /* name          */
+        ts.tsPropertyIndex(resolved?.name),
+        /* questionToken */
+        optional,
+        /* type          */
+        subType
+      );
+      ts.addJSDocComment(resolved, property);
+      paramLocType.push(property);
+    }
+    const allOptional = paramLocType.every((node) => !!node.questionToken);
+    paramType.push(
+      ts__default.factory.createPropertySignature(
+        /* modifiers     */
+        ts.tsModifiers({ readonly: options.ctx.immutable }),
+        /* name          */
+        ts.tsPropertyIndex(paramIn),
+        /* questionToken */
+        allOptional || !paramLocType.length ? ts.QUESTION_TOKEN : void 0,
+        /* type          */
+        paramLocType.length ? ts__default.factory.createTypeLiteralNode(paramLocType) : ts.NEVER
+      )
+    );
+  }
+  type.push(
+    ts__default.factory.createPropertySignature(
+      /* modifiers     */
+      ts.tsModifiers({ readonly: options.ctx.immutable }),
+      /* name          */
+      ts.tsPropertyIndex("parameters"),
+      /* questionToken */
+      !paramType.length ? ts.QUESTION_TOKEN : void 0,
+      /* type          */
+      paramType.length ? ts__default.factory.createTypeLiteralNode(paramType) : ts.NEVER
+    )
+  );
+  return type;
+}
+
+exports.transformParametersArray = transformParametersArray;
+//# sourceMappingURL=parameters-array.cjs.map

package/dist/transform/parameters-array.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters-array.cjs","sources":["../../src/transform/parameters-array.ts"],"sourcesContent":["import ts from \"typescript\";\nimport { addJSDocComment, NEVER, oapiRef, QUESTION_TOKEN, tsModifiers, tsPropertyIndex } from \"../lib/ts.js\";\nimport { createRef } from \"../lib/utils.js\";\nimport type { ParameterObject, ReferenceObject, TransformNodeOptions } from \"../types.js\";\nimport transformParameterObject from \"./parameter-object.js\";\n\n// Regex to match path parameters in URL\nconst PATH_PARAM_RE = /\\{([^}]+)\\}/g;\n\n/**\n * Create a synthetic path parameter object from a parameter name\n */\nfunction createPathParameter(paramName: string): ParameterObject {\n  return {\n    name: paramName,\n    in: \"path\",\n    required: true,\n    schema: { type: \"string\" },\n  };\n}\n\n/**\n * Extract path parameters from a URL\n */\nfunction extractPathParamsFromUrl(path: string): ParameterObject[] {\n  const params: ParameterObject[] = [];\n  const matches = path.match(PATH_PARAM_RE);\n  if (matches) {\n    for (const match of matches) {\n      const paramName = match.slice(1, -1);\n      params.push(createPathParameter(paramName));\n    }\n  }\n  return params;\n}\n\n/**\n * Synthetic type. Array of (ParameterObject | ReferenceObject)s found in OperationObject and PathItemObject.\n */\nexport function transformParametersArray(\n  parametersArray: (ParameterObject | ReferenceObject)[],\n  options: TransformNodeOptions,\n): ts.TypeElement[] {\n  const type: ts.TypeElement[] = [];\n\n  // Create a working copy of parameters array\n  const workingParameters = [...parametersArray];\n\n  // Generate path parameters if enabled\n  if (options.ctx.generatePathParams && options.path) {\n    const pathString = Array.isArray(options.path) ? options.path[0] : options.path;\n    if (typeof pathString === \"string\") {\n      const pathParams = extractPathParamsFromUrl(pathString);\n      // Only add path parameters that aren't already defined\n      for (const param of pathParams) {\n        const exists = workingParameters.some((p) => {\n          const resolved = \"$ref\" in p ? options.ctx.resolve<ParameterObject>(p.$ref) : p;\n          return resolved?.in === \"path\" && resolved?.name === param.name;\n        });\n        if (!exists) {\n          workingParameters.push(param);\n        }\n      }\n    }\n  }\n\n  // parameters\n  const paramType: ts.TypeElement[] = [];\n  for (const paramIn of [\"query\", \"header\", \"path\", \"cookie\"] as ParameterObject[\"in\"][]) {\n    const paramLocType: ts.TypeElement[] = [];\n    let operationParameters = workingParameters.map((param) => ({\n      original: param,\n      resolved: \"$ref\" in param ? options.ctx.resolve<ParameterObject>(param.$ref) : param,\n    }));\n\n    // this is the only array type in the spec, so we have to one-off sort here\n    if (options.ctx.alphabetize) {\n      operationParameters.sort((a, b) => (a.resolved?.name ?? \"\").localeCompare(b.resolved?.name ?? \"\"));\n    }\n    if (options.ctx.excludeDeprecated) {\n      operationParameters = operationParameters.filter(\n        ({ resolved }) => !resolved?.deprecated && !resolved?.schema?.deprecated,\n      );\n    }\n    for (const { original, resolved } of operationParameters) {\n      if (resolved?.in !== paramIn) {\n        continue;\n      }\n      let optional: ts.QuestionToken | undefined;\n      if (paramIn !== \"path\" && !(resolved as ParameterObject).required) {\n        optional = QUESTION_TOKEN;\n      }\n      const subType =\n        \"$ref\" in original\n          ? oapiRef(original.$ref, resolved)\n          : transformParameterObject(resolved as ParameterObject, {\n              ...options,\n              path: createRef([options.path, \"parameters\", resolved.in, resolved.name]),\n            });\n      const property = ts.factory.createPropertySignature(\n        /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n        /* name          */ tsPropertyIndex(resolved?.name),\n        /* questionToken */ optional,\n        /* type          */ subType,\n      );\n      addJSDocComment(resolved, property);\n      paramLocType.push(property);\n    }\n    const allOptional = paramLocType.every((node) => !!node.questionToken);\n    paramType.push(\n      ts.factory.createPropertySignature(\n        /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n        /* name          */ tsPropertyIndex(paramIn),\n        /* questionToken */ allOptional || !paramLocType.length ? QUESTION_TOKEN : undefined,\n        /* type          */ paramLocType.length ? ts.factory.createTypeLiteralNode(paramLocType) : NEVER,\n      ),\n    );\n  }\n  type.push(\n    ts.factory.createPropertySignature(\n      /* modifiers     */ tsModifiers({ readonly: options.ctx.immutable }),\n      /* name          */ tsPropertyIndex(\"parameters\"),\n      /* questionToken */ !paramType.length ? QUESTION_TOKEN : undefined,\n      /* type          */ paramType.length ? ts.factory.createTypeLiteralNode(paramType) : NEVER,\n    ),\n  );\n\n  return type;\n}\n"],"names":["QUESTION_TOKEN","oapiRef","transformParameterObject","createRef","ts","tsModifiers","tsPropertyIndex","addJSDocComment","NEVER"],"mappings":"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"}