@sdk-it/spec 0.44.0 → 0.46.0

package/dist/lib/processing-plugins/normalize-paths.js

@@ -0,0 +1,67 @@
+import { methods } from "@sdk-it/core/paths.js";
+import { followRef } from "@sdk-it/core/ref.js";
+function normalizePaths() {
+  return {
+    name: "normalize-paths",
+    process({ spec, report }) {
+      const paths = {};
+      const operationSources = /* @__PURE__ */ new Map();
+      for (const [path, pathItem] of Object.entries(spec.paths)) {
+        const normalizedPath = path.replace(/:([^/]+)/g, "{$1}");
+        const target = paths[normalizedPath] ??= {};
+        const source = pathItem.$ref ? {
+          ...followRef(spec, pathItem.$ref),
+          ...pathItem
+        } : pathItem;
+        delete source.$ref;
+        Object.assign(
+          target,
+          Object.fromEntries(
+            Object.entries(source).filter(
+              ([key]) => key !== "parameters" && !methods.some((method) => method === key)
+            )
+          )
+        );
+        for (const method of methods) {
+          const operation = source[method];
+          if (operation) {
+            const operationKey = `${normalizedPath}:${method}`;
+            const previousPath = operationSources.get(operationKey);
+            if (previousPath) {
+              const message = `Both ${previousPath} and ${path} define ${method.toUpperCase()} after path normalization`;
+              report({
+                severity: "error",
+                code: "path-operation-collision",
+                message,
+                path: `${method.toUpperCase()} ${normalizedPath}`
+              });
+              throw new Error(message);
+            }
+            const parameters = [
+              ...source.parameters ?? [],
+              ...operation.parameters ?? []
+            ];
+            target[method] = {
+              ...operation,
+              ...parameters.length > 0 ? { parameters } : {}
+            };
+            operationSources.set(operationKey, path);
+          }
+        }
+        if (normalizedPath !== path) {
+          report({
+            severity: "info",
+            code: "path-normalized",
+            message: `Normalized path ${path} to ${normalizedPath}`,
+            path
+          });
+        }
+      }
+      spec.paths = paths;
+    }
+  };
+}
+export {
+  normalizePaths
+};
+//# sourceMappingURL=normalize-paths.js.map

package/dist/lib/processing-plugins/normalize-paths.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-paths.ts"],
+  "sourcesContent": ["import type { PathItemObject, PathsObject } from 'openapi3-ts/oas31';\n\nimport { methods } from '@sdk-it/core/paths.js';\nimport { followRef } from '@sdk-it/core/ref.js';\n\nimport type { ProcessingPlugin } from '../processing.js';\n\nexport function normalizePaths(): ProcessingPlugin {\n  return {\n    name: 'normalize-paths',\n    process({ spec, report }) {\n      const paths: PathsObject = {};\n      const operationSources = new Map<string, string>();\n      for (const [path, pathItem] of Object.entries(spec.paths)) {\n        const normalizedPath = path.replace(/:([^/]+)/g, '{$1}');\n        const target = (paths[normalizedPath] ??= {});\n        const source = pathItem.$ref\n          ? {\n              ...followRef<PathItemObject>(spec, pathItem.$ref),\n              ...pathItem,\n            }\n          : pathItem;\n        delete source.$ref;\n        Object.assign(\n          target,\n          Object.fromEntries(\n            Object.entries(source).filter(\n              ([key]) =>\n                key !== 'parameters' &&\n                !methods.some((method) => method === key),\n            ),\n          ),\n        );\n        for (const method of methods) {\n          const operation = source[method];\n          if (operation) {\n            const operationKey = `${normalizedPath}:${method}`;\n            const previousPath = operationSources.get(operationKey);\n            if (previousPath) {\n              const message = `Both ${previousPath} and ${path} define ${method.toUpperCase()} after path normalization`;\n              report({\n                severity: 'error',\n                code: 'path-operation-collision',\n                message,\n                path: `${method.toUpperCase()} ${normalizedPath}`,\n              });\n              throw new Error(message);\n            }\n            const parameters = [\n              ...(source.parameters ?? []),\n              ...(operation.parameters ?? []),\n            ];\n            target[method] = {\n              ...operation,\n              ...(parameters.length > 0 ? { parameters } : {}),\n            };\n            operationSources.set(operationKey, path);\n          }\n        }\n        if (normalizedPath !== path) {\n          report({\n            severity: 'info',\n            code: 'path-normalized',\n            message: `Normalized path ${path} to ${normalizedPath}`,\n            path,\n          });\n        }\n      }\n      spec.paths = paths;\n    },\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAInB,SAAS,iBAAmC;AACjD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,MAAM,OAAO,GAAG;AACxB,YAAM,QAAqB,CAAC;AAC5B,YAAM,mBAAmB,oBAAI,IAAoB;AACjD,iBAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACzD,cAAM,iBAAiB,KAAK,QAAQ,aAAa,MAAM;AACvD,cAAM,SAAU,MAAM,cAAc,MAAM,CAAC;AAC3C,cAAM,SAAS,SAAS,OACpB;AAAA,UACE,GAAG,UAA0B,MAAM,SAAS,IAAI;AAAA,UAChD,GAAG;AAAA,QACL,IACA;AACJ,eAAO,OAAO;AACd,eAAO;AAAA,UACL;AAAA,UACA,OAAO;AAAA,YACL,OAAO,QAAQ,MAAM,EAAE;AAAA,cACrB,CAAC,CAAC,GAAG,MACH,QAAQ,gBACR,CAAC,QAAQ,KAAK,CAAC,WAAW,WAAW,GAAG;AAAA,YAC5C;AAAA,UACF;AAAA,QACF;AACA,mBAAW,UAAU,SAAS;AAC5B,gBAAM,YAAY,OAAO,MAAM;AAC/B,cAAI,WAAW;AACb,kBAAM,eAAe,GAAG,cAAc,IAAI,MAAM;AAChD,kBAAM,eAAe,iBAAiB,IAAI,YAAY;AACtD,gBAAI,cAAc;AAChB,oBAAM,UAAU,QAAQ,YAAY,QAAQ,IAAI,WAAW,OAAO,YAAY,CAAC;AAC/E,qBAAO;AAAA,gBACL,UAAU;AAAA,gBACV,MAAM;AAAA,gBACN;AAAA,gBACA,MAAM,GAAG,OAAO,YAAY,CAAC,IAAI,cAAc;AAAA,cACjD,CAAC;AACD,oBAAM,IAAI,MAAM,OAAO;AAAA,YACzB;AACA,kBAAM,aAAa;AAAA,cACjB,GAAI,OAAO,cAAc,CAAC;AAAA,cAC1B,GAAI,UAAU,cAAc,CAAC;AAAA,YAC/B;AACA,mBAAO,MAAM,IAAI;AAAA,cACf,GAAG;AAAA,cACH,GAAI,WAAW,SAAS,IAAI,EAAE,WAAW,IAAI,CAAC;AAAA,YAChD;AACA,6BAAiB,IAAI,cAAc,IAAI;AAAA,UACzC;AAAA,QACF;AACA,YAAI,mBAAmB,MAAM;AAC3B,iBAAO;AAAA,YACL,UAAU;AAAA,YACV,MAAM;AAAA,YACN,SAAS,mBAAmB,IAAI,OAAO,cAAc;AAAA,YACrD;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AACA,WAAK,QAAQ;AAAA,IACf;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/normalize-request-bodies.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessingPlugin } from '../processing.js';
+export declare function normalizeRequestBodies(): ProcessingPlugin;
+//# sourceMappingURL=normalize-request-bodies.d.ts.map

package/dist/lib/processing-plugins/normalize-request-bodies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-request-bodies.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-request-bodies.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAwCzD"}

package/dist/lib/processing-plugins/normalize-request-bodies.js

@@ -0,0 +1,44 @@
+import { resolveRef } from "@sdk-it/core/ref.js";
+import { iterateOperations } from "../for-each-operation.js";
+import { patchParameters, tuneRequestBody } from "../tune-request-body.js";
+function normalizeRequestBodies() {
+  return {
+    name: "normalize-request-bodies",
+    process({ spec }) {
+      for (const { operation } of iterateOperations(spec)) {
+        const tunedOperation = operation;
+        if (operation.requestBody) {
+          const requestBody = resolveRef(
+            spec,
+            operation.requestBody
+          );
+          const schemas = Object.values(requestBody.content).map(
+            ({ schema }) => schema ? resolveRef(spec, schema) : void 0
+          );
+          if (schemas.length > 0 && schemas.every((schema) => schema?.["x-requestbody"])) {
+            for (const schema of new Set(schemas)) {
+              patchParameters(
+                spec,
+                schema,
+                tunedOperation.parameters,
+                operation.security ?? []
+              );
+            }
+            continue;
+          }
+        }
+        tunedOperation.requestBody = tuneRequestBody(
+          spec,
+          tunedOperation.operationId,
+          operation,
+          tunedOperation.parameters,
+          operation.security ?? []
+        );
+      }
+    }
+  };
+}
+export {
+  normalizeRequestBodies
+};
+//# sourceMappingURL=normalize-request-bodies.js.map

package/dist/lib/processing-plugins/normalize-request-bodies.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-request-bodies.ts"],
+  "sourcesContent": ["import type { RequestBodyObject, SchemaObject } from 'openapi3-ts/oas31';\n\nimport { resolveRef } from '@sdk-it/core/ref.js';\n\nimport { iterateOperations } from '../for-each-operation.js';\nimport type { ProcessingPlugin } from '../processing.js';\nimport { patchParameters, tuneRequestBody } from '../tune-request-body.js';\nimport type { TunedOperationObject } from '../types.js';\n\nexport function normalizeRequestBodies(): ProcessingPlugin {\n  return {\n    name: 'normalize-request-bodies',\n    process({ spec }) {\n      for (const { operation } of iterateOperations(spec)) {\n        const tunedOperation = operation as TunedOperationObject;\n        if (operation.requestBody) {\n          const requestBody = resolveRef<RequestBodyObject>(\n            spec,\n            operation.requestBody,\n          );\n          const schemas = Object.values(requestBody.content).map(\n            ({ schema }) =>\n              schema ? resolveRef<SchemaObject>(spec, schema) : undefined,\n          );\n          if (\n            schemas.length > 0 &&\n            schemas.every((schema) => schema?.['x-requestbody'])\n          ) {\n            for (const schema of new Set(schemas)) {\n              patchParameters(\n                spec,\n                schema as SchemaObject,\n                tunedOperation.parameters,\n                operation.security ?? [],\n              );\n            }\n            continue;\n          }\n        }\n        tunedOperation.requestBody = tuneRequestBody(\n          spec,\n          tunedOperation.operationId,\n          operation,\n          tunedOperation.parameters,\n          operation.security ?? [],\n        );\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,kBAAkB;AAE3B,SAAS,yBAAyB;AAElC,SAAS,iBAAiB,uBAAuB;AAG1C,SAAS,yBAA2C;AACzD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,iBAAW,EAAE,UAAU,KAAK,kBAAkB,IAAI,GAAG;AACnD,cAAM,iBAAiB;AACvB,YAAI,UAAU,aAAa;AACzB,gBAAM,cAAc;AAAA,YAClB;AAAA,YACA,UAAU;AAAA,UACZ;AACA,gBAAM,UAAU,OAAO,OAAO,YAAY,OAAO,EAAE;AAAA,YACjD,CAAC,EAAE,OAAO,MACR,SAAS,WAAyB,MAAM,MAAM,IAAI;AAAA,UACtD;AACA,cACE,QAAQ,SAAS,KACjB,QAAQ,MAAM,CAAC,WAAW,SAAS,eAAe,CAAC,GACnD;AACA,uBAAW,UAAU,IAAI,IAAI,OAAO,GAAG;AACrC;AAAA,gBACE;AAAA,gBACA;AAAA,gBACA,eAAe;AAAA,gBACf,UAAU,YAAY,CAAC;AAAA,cACzB;AAAA,YACF;AACA;AAAA,UACF;AAAA,QACF;AACA,uBAAe,cAAc;AAAA,UAC3B;AAAA,UACA,eAAe;AAAA,UACf;AAAA,UACA,eAAe;AAAA,UACf,UAAU,YAAY,CAAC;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/normalize-responses.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessingPlugin } from '../processing.js';
+export declare function normalizeResponses(): ProcessingPlugin;
+//# sourceMappingURL=normalize-responses.d.ts.map

package/dist/lib/processing-plugins/normalize-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-responses.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-responses.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,wBAAgB,kBAAkB,IAAI,gBAAgB,CA8BrD"}

package/dist/lib/processing-plugins/normalize-responses.js

@@ -0,0 +1,38 @@
+import { iterateOperations } from "../for-each-operation.js";
+import { isSuccessStatusCode } from "../is.js";
+import { resolveResponses } from "../tune-response.js";
+function normalizeResponses() {
+  return {
+    name: "normalize-responses",
+    process({ spec, options, report }) {
+      for (const { entry, operation } of iterateOperations(spec)) {
+        if (!operation.operationId) {
+          throw new Error(
+            `Cannot normalize responses before assigning an operation ID for ${entry.method.toUpperCase()} ${entry.path}`
+          );
+        }
+        const hadSuccessResponse = Object.keys(operation.responses ?? {}).some(
+          isSuccessStatusCode
+        );
+        operation.responses = resolveResponses(
+          spec,
+          operation.operationId,
+          operation,
+          options.responses
+        );
+        if (!hadSuccessResponse) {
+          report({
+            severity: "warning",
+            code: "success-response-added",
+            message: "Added a default 200 success response",
+            path: `${entry.method.toUpperCase()} ${entry.path}`
+          });
+        }
+      }
+    }
+  };
+}
+export {
+  normalizeResponses
+};
+//# sourceMappingURL=normalize-responses.js.map

package/dist/lib/processing-plugins/normalize-responses.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-responses.ts"],
+  "sourcesContent": ["import { iterateOperations } from '../for-each-operation.js';\nimport { isSuccessStatusCode } from '../is.js';\nimport type { ProcessingPlugin } from '../processing.js';\nimport { resolveResponses } from '../tune-response.js';\nimport type { TunedOperationObject } from '../types.js';\n\nexport function normalizeResponses(): ProcessingPlugin {\n  return {\n    name: 'normalize-responses',\n    process({ spec, options, report }) {\n      for (const { entry, operation } of iterateOperations(spec)) {\n        if (!operation.operationId) {\n          throw new Error(\n            `Cannot normalize responses before assigning an operation ID for ${entry.method.toUpperCase()} ${entry.path}`,\n          );\n        }\n        const hadSuccessResponse = Object.keys(operation.responses ?? {}).some(\n          isSuccessStatusCode,\n        );\n        (operation as TunedOperationObject).responses = resolveResponses(\n          spec,\n          operation.operationId,\n          operation,\n          options.responses,\n        );\n        if (!hadSuccessResponse) {\n          report({\n            severity: 'warning',\n            code: 'success-response-added',\n            message: 'Added a default 200 success response',\n            path: `${entry.method.toUpperCase()} ${entry.path}`,\n          });\n        }\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AAEpC,SAAS,wBAAwB;AAG1B,SAAS,qBAAuC;AACrD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,MAAM,SAAS,OAAO,GAAG;AACjC,iBAAW,EAAE,OAAO,UAAU,KAAK,kBAAkB,IAAI,GAAG;AAC1D,YAAI,CAAC,UAAU,aAAa;AAC1B,gBAAM,IAAI;AAAA,YACR,mEAAmE,MAAM,OAAO,YAAY,CAAC,IAAI,MAAM,IAAI;AAAA,UAC7G;AAAA,QACF;AACA,cAAM,qBAAqB,OAAO,KAAK,UAAU,aAAa,CAAC,CAAC,EAAE;AAAA,UAChE;AAAA,QACF;AACA,QAAC,UAAmC,YAAY;AAAA,UAC9C;AAAA,UACA,UAAU;AAAA,UACV;AAAA,UACA,QAAQ;AAAA,QACV;AACA,YAAI,CAAC,oBAAoB;AACvB,iBAAO;AAAA,YACL,UAAU;AAAA,YACV,MAAM;AAAA,YACN,SAAS;AAAA,YACT,MAAM,GAAG,MAAM,OAAO,YAAY,CAAC,IAAI,MAAM,IAAI;AAAA,UACnD,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/normalize-schemas.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessingPlugin } from '../processing.js';
+export declare function normalizeSchemas(): ProcessingPlugin;
+//# sourceMappingURL=normalize-schemas.d.ts.map

package/dist/lib/processing-plugins/normalize-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD"}

package/dist/lib/processing-plugins/normalize-schemas.js

@@ -0,0 +1,13 @@
+import { fixSpec } from "../tune.js";
+function normalizeSchemas() {
+  return {
+    name: "normalize-schemas",
+    process({ spec }) {
+      fixSpec(spec, Object.values(spec.components.schemas));
+    }
+  };
+}
+export {
+  normalizeSchemas
+};
+//# sourceMappingURL=normalize-schemas.js.map

package/dist/lib/processing-plugins/normalize-schemas.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-schemas.ts"],
+  "sourcesContent": ["import type { ProcessingPlugin } from '../processing.js';\nimport { fixSpec } from '../tune.js';\n\nexport function normalizeSchemas(): ProcessingPlugin {\n  return {\n    name: 'normalize-schemas',\n    process({ spec }) {\n      fixSpec(spec, Object.values(spec.components.schemas));\n    },\n  };\n}\n"],
+  "mappings": "AACA,SAAS,eAAe;AAEjB,SAAS,mBAAqC;AACnD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,cAAQ,MAAM,OAAO,OAAO,KAAK,WAAW,OAAO,CAAC;AAAA,IACtD;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing-plugins/normalize-tags.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessingPlugin } from '../processing.js';
+export declare function normalizeTags(): ProcessingPlugin;
+//# sourceMappingURL=normalize-tags.d.ts.map

package/dist/lib/processing-plugins/normalize-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-tags.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-tags.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,aAAa,IAAI,gBAAgB,CAWhD"}

package/dist/lib/processing-plugins/normalize-tags.js

@@ -0,0 +1,18 @@
+import { snakecase } from "@sdk-it/core/utils.js";
+import { iterateOperations } from "../for-each-operation.js";
+function normalizeTags() {
+  return {
+    name: "normalize-tags",
+    process({ spec, options }) {
+      for (const { entry, operation } of iterateOperations(spec)) {
+        const tag = options.tag(operation, entry.path);
+        operation["x-fn-group"] = tag;
+        operation.tags = [snakecase(tag)];
+      }
+    }
+  };
+}
+export {
+  normalizeTags
+};
+//# sourceMappingURL=normalize-tags.js.map

package/dist/lib/processing-plugins/normalize-tags.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/processing-plugins/normalize-tags.ts"],
+  "sourcesContent": ["import { snakecase } from '@sdk-it/core/utils.js';\n\nimport { iterateOperations } from '../for-each-operation.js';\nimport type { ProcessingPlugin } from '../processing.js';\n\nexport function normalizeTags(): ProcessingPlugin {\n  return {\n    name: 'normalize-tags',\n    process({ spec, options }) {\n      for (const { entry, operation } of iterateOperations(spec)) {\n        const tag = options.tag(operation, entry.path);\n        operation['x-fn-group'] = tag;\n        operation.tags = [snakecase(tag)];\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,yBAAyB;AAG3B,SAAS,gBAAkC;AAChD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,MAAM,QAAQ,GAAG;AACzB,iBAAW,EAAE,OAAO,UAAU,KAAK,kBAAkB,IAAI,GAAG;AAC1D,cAAM,MAAM,QAAQ,IAAI,WAAW,MAAM,IAAI;AAC7C,kBAAU,YAAY,IAAI;AAC1B,kBAAU,OAAO,CAAC,UAAU,GAAG,CAAC;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/processing.d.ts

@@ -0,0 +1,33 @@
+import { type GenerateSdkConfig, coeraceConfig as coerceConfig } from './options.js';
+import type { IR } from './types.js';
+export type ProcessingDiagnosticSeverity = 'info' | 'warning' | 'error';
+export interface ProcessingDiagnostic {
+    plugin: string;
+    severity: ProcessingDiagnosticSeverity;
+    code: string;
+    message: string;
+    path?: string;
+}
+export type ProcessingOptions = Omit<ReturnType<typeof coerceConfig>, 'spec'>;
+export interface ProcessingContext {
+    spec: IR;
+    options: ProcessingOptions;
+    diagnostics: ProcessingDiagnostic[];
+    signal?: AbortSignal;
+    report(diagnostic: Omit<ProcessingDiagnostic, 'plugin'>): ProcessingDiagnostic;
+}
+export interface ProcessingPlugin {
+    name: string;
+    process(context: ProcessingContext): void | Promise<void>;
+}
+export interface ProcessSpecConfig extends GenerateSdkConfig {
+    plugins: readonly ProcessingPlugin[];
+    signal?: AbortSignal;
+    onDiagnostic?: (diagnostic: ProcessingDiagnostic) => void;
+}
+export interface ProcessingResult {
+    spec: IR;
+    diagnostics: ProcessingDiagnostic[];
+}
+export declare function processSpec(config: ProcessSpecConfig): Promise<ProcessingResult>;
+//# sourceMappingURL=processing.d.ts.map

package/dist/lib/processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processing.d.ts","sourceRoot":"","sources":["../../src/lib/processing.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,IAAI,YAAY,EAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,4BAA4B,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,EAAE,CAAC;IACT,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CACJ,UAAU,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAC/C,oBAAoB,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,EAAE,CAAC;IACT,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B"}

package/dist/lib/processing.js

@@ -0,0 +1,41 @@
+import {
+  coeraceConfig as coerceConfig
+} from "./options.js";
+async function processSpec(config) {
+  const { plugins, signal, onDiagnostic, ...generateConfig } = config;
+  signal?.throwIfAborted();
+  const coerced = coerceConfig({
+    ...generateConfig,
+    spec: structuredClone(generateConfig.spec)
+  });
+  const { spec, ...options } = coerced;
+  const diagnostics = [];
+  const pluginNames = plugins.map((plugin) => plugin.name);
+  const configuration = JSON.stringify({
+    pagination: options.pagination,
+    responses: options.responses
+  });
+  for (const plugin of plugins) {
+    signal?.throwIfAborted();
+    const context = {
+      spec,
+      options,
+      diagnostics,
+      signal,
+      report(diagnostic) {
+        const reported = { ...diagnostic, plugin: plugin.name };
+        diagnostics.push(reported);
+        onDiagnostic?.(reported);
+        return reported;
+      }
+    };
+    await plugin.process(context);
+    signal?.throwIfAborted();
+  }
+  spec["x-sdk-processing"] = { plugins: pluginNames, configuration };
+  return { spec, diagnostics };
+}
+export {
+  processSpec
+};
+//# sourceMappingURL=processing.js.map

package/dist/lib/processing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/processing.ts"],
+  "sourcesContent": ["import type { OpenAPIObject } from 'openapi3-ts/oas31';\n\nimport {\n  type GenerateSdkConfig,\n  coeraceConfig as coerceConfig,\n} from './options.js';\nimport type { IR } from './types.js';\n\nexport type ProcessingDiagnosticSeverity = 'info' | 'warning' | 'error';\n\nexport interface ProcessingDiagnostic {\n  plugin: string;\n  severity: ProcessingDiagnosticSeverity;\n  code: string;\n  message: string;\n  path?: string;\n}\n\nexport type ProcessingOptions = Omit<ReturnType<typeof coerceConfig>, 'spec'>;\n\nexport interface ProcessingContext {\n  spec: IR;\n  options: ProcessingOptions;\n  diagnostics: ProcessingDiagnostic[];\n  signal?: AbortSignal;\n  report(\n    diagnostic: Omit<ProcessingDiagnostic, 'plugin'>,\n  ): ProcessingDiagnostic;\n}\n\nexport interface ProcessingPlugin {\n  name: string;\n  process(context: ProcessingContext): void | Promise<void>;\n}\n\nexport interface ProcessSpecConfig extends GenerateSdkConfig {\n  plugins: readonly ProcessingPlugin[];\n  signal?: AbortSignal;\n  onDiagnostic?: (diagnostic: ProcessingDiagnostic) => void;\n}\n\nexport interface ProcessingResult {\n  spec: IR;\n  diagnostics: ProcessingDiagnostic[];\n}\n\nexport async function processSpec(\n  config: ProcessSpecConfig,\n): Promise<ProcessingResult> {\n  const { plugins, signal, onDiagnostic, ...generateConfig } = config;\n  signal?.throwIfAborted();\n  const coerced = coerceConfig({\n    ...generateConfig,\n    spec: structuredClone(generateConfig.spec) as OpenAPIObject,\n  });\n  const { spec, ...options } = coerced;\n  const diagnostics: ProcessingDiagnostic[] = [];\n  const pluginNames = plugins.map((plugin) => plugin.name);\n  const configuration = JSON.stringify({\n    pagination: options.pagination,\n    responses: options.responses,\n  });\n\n  for (const plugin of plugins) {\n    signal?.throwIfAborted();\n    const context: ProcessingContext = {\n      spec,\n      options,\n      diagnostics,\n      signal,\n      report(diagnostic) {\n        const reported = { ...diagnostic, plugin: plugin.name };\n        diagnostics.push(reported);\n        onDiagnostic?.(reported);\n        return reported;\n      },\n    };\n    await plugin.process(context);\n    signal?.throwIfAborted();\n  }\n\n  spec['x-sdk-processing'] = { plugins: pluginNames, configuration };\n\n  return { spec, diagnostics };\n}\n"],
+  "mappings": "AAEA;AAAA,EAEE,iBAAiB;AAAA,OACZ;AAyCP,eAAsB,YACpB,QAC2B;AAC3B,QAAM,EAAE,SAAS,QAAQ,cAAc,GAAG,eAAe,IAAI;AAC7D,UAAQ,eAAe;AACvB,QAAM,UAAU,aAAa;AAAA,IAC3B,GAAG;AAAA,IACH,MAAM,gBAAgB,eAAe,IAAI;AAAA,EAC3C,CAAC;AACD,QAAM,EAAE,MAAM,GAAG,QAAQ,IAAI;AAC7B,QAAM,cAAsC,CAAC;AAC7C,QAAM,cAAc,QAAQ,IAAI,CAAC,WAAW,OAAO,IAAI;AACvD,QAAM,gBAAgB,KAAK,UAAU;AAAA,IACnC,YAAY,QAAQ;AAAA,IACpB,WAAW,QAAQ;AAAA,EACrB,CAAC;AAED,aAAW,UAAU,SAAS;AAC5B,YAAQ,eAAe;AACvB,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,YAAY;AACjB,cAAM,WAAW,EAAE,GAAG,YAAY,QAAQ,OAAO,KAAK;AACtD,oBAAY,KAAK,QAAQ;AACzB,uBAAe,QAAQ;AACvB,eAAO;AAAA,MACT;AAAA,IACF;AACA,UAAM,OAAO,QAAQ,OAAO;AAC5B,YAAQ,eAAe;AAAA,EACzB;AAEA,OAAK,kBAAkB,IAAI,EAAE,SAAS,aAAa,cAAc;AAEjE,SAAO,EAAE,MAAM,YAAY;AAC7B;",
+  "names": []
+}

package/dist/lib/reserved-keywords.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reserved-keywords.d.ts","sourceRoot":"","sources":["../../src/lib/reserved-keywords.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAkD3B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAI9B,CAAC"}
+{"version":3,"file":"reserved-keywords.d.ts","sourceRoot":"","sources":["../../src/lib/reserved-keywords.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAmE3B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAI9B,CAAC"}

package/dist/lib/reserved-keywords.js

@@ -57,7 +57,24 @@ const reservedKeywords = /* @__PURE__ */ new Set([
   // Strict mode / Generator functions
   // 'arguments' is not technically a reserved word, but it's a special identifier within functions
   // and assigning to it or declaring it can cause issues or unexpected behavior.
-  "arguments"
+  "arguments",
+  // Common operation verbs are ambiguous group identifiers in generated SDKs.
+  "get",
+  "list",
+  "create",
+  "update",
+  "post",
+  "put",
+  "patch",
+  "do",
+  "send",
+  "add",
+  "remove",
+  "set",
+  "find",
+  "search",
+  "check",
+  "make"
 ]);
 const reservedSdkKeywords = /* @__PURE__ */ new Set([
   "ClientError",

package/dist/lib/reserved-keywords.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/reserved-keywords.ts"],
-  "sourcesContent": ["/**\n * Set of reserved TypeScript keywords and common verbs potentially used as tags.\n */\nexport const reservedKeywords = new Set([\n  'await', // Reserved in async functions\n  'break',\n  'case',\n  'catch',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'else',\n  'enum',\n  'export',\n  'extends',\n  'false',\n  'finally',\n  'for',\n  'function',\n  'if',\n  'implements', // Strict mode\n  'import',\n  'in',\n  'instanceof',\n  'interface', // Strict mode\n  'let', // Strict mode\n  'new',\n  'null',\n  'package', // Strict mode\n  'private', // Strict mode\n  'protected', // Strict mode\n  'public', // Strict mode\n  'return',\n  'static', // Strict mode\n  'super',\n  'switch',\n  'this',\n  'throw',\n  'true',\n  'try',\n  'typeof',\n  'var',\n  'void',\n  'while',\n  'with',\n  'yield', // Strict mode / Generator functions\n  // 'arguments' is not technically a reserved word, but it's a special identifier within functions\n  // and assigning to it or declaring it can cause issues or unexpected behavior.\n  'arguments',\n]);\n\nexport const reservedSdkKeywords = new Set([\n  'ClientError',\n  'Error',\n  'ConflictError',\n]);\n"],
-  "mappings": "AAGO,MAAM,mBAAmB,oBAAI,IAAI;AAAA,EACtC;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAGA;AACF,CAAC;AAEM,MAAM,sBAAsB,oBAAI,IAAI;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,CAAC;",
+  "sourcesContent": ["/**\n * Set of reserved TypeScript keywords and common verbs potentially used as tags.\n */\nexport const reservedKeywords = new Set([\n  'await', // Reserved in async functions\n  'break',\n  'case',\n  'catch',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'else',\n  'enum',\n  'export',\n  'extends',\n  'false',\n  'finally',\n  'for',\n  'function',\n  'if',\n  'implements', // Strict mode\n  'import',\n  'in',\n  'instanceof',\n  'interface', // Strict mode\n  'let', // Strict mode\n  'new',\n  'null',\n  'package', // Strict mode\n  'private', // Strict mode\n  'protected', // Strict mode\n  'public', // Strict mode\n  'return',\n  'static', // Strict mode\n  'super',\n  'switch',\n  'this',\n  'throw',\n  'true',\n  'try',\n  'typeof',\n  'var',\n  'void',\n  'while',\n  'with',\n  'yield', // Strict mode / Generator functions\n  // 'arguments' is not technically a reserved word, but it's a special identifier within functions\n  // and assigning to it or declaring it can cause issues or unexpected behavior.\n  'arguments',\n  // Common operation verbs are ambiguous group identifiers in generated SDKs.\n  'get',\n  'list',\n  'create',\n  'update',\n  'post',\n  'put',\n  'patch',\n  'do',\n  'send',\n  'add',\n  'remove',\n  'set',\n  'find',\n  'search',\n  'check',\n  'make',\n]);\n\nexport const reservedSdkKeywords = new Set([\n  'ClientError',\n  'Error',\n  'ConflictError',\n]);\n"],
+  "mappings": "AAGO,MAAM,mBAAmB,oBAAI,IAAI;AAAA,EACtC;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAGA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,sBAAsB,oBAAI,IAAI;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,CAAC;",
   "names": []
 }

package/dist/lib/tag.js

@@ -6,7 +6,7 @@ function sanitizeTag(tag) {
   }
   tag = tag.replace(/[^A-Za-z0-9_-]/g, "").replace(/-+/g, "-");
   if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {
-    return `$${tag}`;
+    return `${tag}_`;
   }
   return tag;
 }
@@ -16,7 +16,7 @@ function sanitizeImportName(tag) {
   }
   tag = tag.replace(/[^A-Za-z0-9_-]/g, "");
   if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {
-    return `$${tag}`;
+    return `${tag}_`;
   }
   return tag;
 }

package/dist/lib/tag.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/tag.ts"],
-  "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\n\nimport { camelcase } from '@sdk-it/core';\n\nimport { reservedKeywords, reservedSdkKeywords } from './reserved-keywords.js';\n\nexport function sanitizeTag(tag: string): string {\n  // Prepend underscore if starts with a number\n  if (/^\\d/.test(tag)) {\n    return `_${tag}`;\n  }\n\n  tag = tag\n    // Remove any non-alphanumeric characters except underscores and dashes\n    .replace(/[^A-Za-z0-9_-]/g, '')\n    // Normalize multiple dashes to a single dash\n    .replace(/-+/g, '-');\n\n  // Append underscore if it's a reserved keyword\n  if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {\n    return `$${tag}`;\n  }\n  return tag;\n}\nexport function sanitizeImportName(tag: string): string {\n  // Prepend underscore if starts with a number\n  if (/^\\d/.test(tag)) {\n    return `_${tag}`;\n  }\n\n  tag = tag\n    // Remove any non-alphanumeric characters except underscores\n    .replace(/[^A-Za-z0-9_-]/g, '');\n\n  // Append underscore if it's a reserved keyword\n  if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {\n    return `$${tag}`;\n  }\n  return tag;\n}\n\n/**\n * Attempts to determine a generic tag for an OpenAPI operation based on path and operationId.\n * Rules and fallbacks are documented within the code.\n * @param pathString The path string.\n * @param operation The OpenAPI Operation Object.\n * @returns A sanitized, camelCased tag name string.\n */\nexport function determineGenericTag(\n  pathString: string,\n  operation: OperationObject,\n): string {\n  const operationId = operation.operationId || '';\n  const VERSION_REGEX = /^[vV]\\d+$/;\n  const commonVerbs = new Set([\n    // Verbs to potentially strip from operationId prefix\n    'get',\n    'list',\n    'create',\n    'update',\n    'delete',\n    'post',\n    'put',\n    'patch',\n    'do',\n    'send',\n    'add',\n    'remove',\n    'set',\n    'find',\n    'search',\n    'check',\n    'make',\n  ]);\n\n  const segments = pathString.split('/').filter(Boolean);\n\n  const potentialCandidates = segments.filter(\n    (segment) =>\n      segment &&\n      !segment.startsWith('{') &&\n      !segment.endsWith('}') &&\n      !VERSION_REGEX.test(segment),\n  );\n\n  // --- Heuristic 1: Last non-'@' path segment ---\n  for (let i = potentialCandidates.length - 1; i >= 0; i--) {\n    const segment = potentialCandidates[i];\n    if (!segment.startsWith('@')) {\n      // Sanitize just before returning\n      return sanitizeTag(camelcase(segment));\n    }\n  }\n\n  const canFallbackToPathSegment = potentialCandidates.length > 0;\n\n  // --- Heuristic 2: OperationId parsing ---\n  if (operationId) {\n    const lowerOpId = operationId.toLowerCase();\n    const parts = operationId\n      .replace(/([a-z])([A-Z])/g, '$1_$2')\n      .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')\n      .replace(/([a-zA-Z])(\\d)/g, '$1_$2')\n      .replace(/(\\d)([a-zA-Z])/g, '$1_$2')\n      .toLowerCase()\n      .split(/[_-\\s]+/);\n\n    const validParts = parts.filter(Boolean);\n\n    // Quick skip: If opId is just a verb and we can use Heuristic 3, prefer that.\n    if (\n      commonVerbs.has(lowerOpId) &&\n      validParts.length === 1 &&\n      canFallbackToPathSegment\n    ) {\n      // Proceed directly to Heuristic 3\n    }\n    // Only process if there are valid parts and the quick skip didn't happen\n    else if (validParts.length > 0) {\n      const firstPart = validParts[0];\n      const isFirstPartVerb = commonVerbs.has(firstPart);\n\n      // Case 2a: Starts with verb, has following parts\n      if (isFirstPartVerb && validParts.length > 1) {\n        const verbPrefixLength = firstPart.length;\n        let nextPartStartIndex = -1;\n        if (operationId.length > verbPrefixLength) {\n          // Simplified check for next part start\n          const charAfterPrefix = operationId[verbPrefixLength];\n          if (charAfterPrefix >= 'A' && charAfterPrefix <= 'Z') {\n            nextPartStartIndex = verbPrefixLength;\n          } else if (charAfterPrefix >= '0' && charAfterPrefix <= '9') {\n            nextPartStartIndex = verbPrefixLength;\n          } else if (['_', '-'].includes(charAfterPrefix)) {\n            nextPartStartIndex = verbPrefixLength + 1;\n          } else {\n            const match = operationId\n              .substring(verbPrefixLength)\n              .match(/[A-Z0-9]/);\n            if (match && match.index !== undefined) {\n              nextPartStartIndex = verbPrefixLength + match.index;\n            }\n            if (\n              nextPartStartIndex === -1 &&\n              operationId.length > verbPrefixLength\n            ) {\n              nextPartStartIndex = verbPrefixLength; // Default guess\n            }\n          }\n        }\n\n        if (\n          nextPartStartIndex !== -1 &&\n          nextPartStartIndex < operationId.length\n        ) {\n          const remainingOriginalSubstring =\n            operationId.substring(nextPartStartIndex);\n          const potentialTag = camelcase(remainingOriginalSubstring);\n          if (potentialTag) {\n            // Sanitize just before returning\n            return sanitizeTag(potentialTag);\n          }\n        }\n\n        // Fallback: join remaining lowercased parts\n        const potentialTagJoined = camelcase(validParts.slice(1).join('_'));\n        if (potentialTagJoined) {\n          // Sanitize just before returning\n          return sanitizeTag(potentialTagJoined);\n        }\n      }\n\n      // Case 2b: Doesn't start with verb, or only one part (might be verb)\n      const potentialTagFull = camelcase(operationId);\n      if (potentialTagFull) {\n        const isResultSingleVerb = validParts.length === 1 && isFirstPartVerb;\n\n        // Avoid returning only a verb if Heuristic 3 is possible\n        if (!(isResultSingleVerb && canFallbackToPathSegment)) {\n          if (potentialTagFull.length > 0) {\n            // Sanitize just before returning\n            return sanitizeTag(potentialTagFull);\n          }\n        }\n      }\n\n      // Case 2c: Further fallbacks within OpId if above failed/skipped\n      const firstPartCamel = camelcase(firstPart);\n      if (firstPartCamel) {\n        const isFirstPartCamelVerb = commonVerbs.has(firstPartCamel);\n        if (\n          !isFirstPartCamelVerb ||\n          validParts.length === 1 ||\n          !canFallbackToPathSegment\n        ) {\n          // Sanitize just before returning\n          return sanitizeTag(firstPartCamel);\n        }\n      }\n      if (\n        isFirstPartVerb &&\n        validParts.length > 1 &&\n        validParts[1] &&\n        canFallbackToPathSegment\n      ) {\n        const secondPartCamel = camelcase(validParts[1]);\n        if (secondPartCamel) {\n          // Sanitize just before returning\n          return sanitizeTag(secondPartCamel);\n        }\n      }\n    } // End if(validParts.length > 0) after quick skip check\n  } // End if(operationId)\n\n  // --- Heuristic 3: First path segment (stripping '@') ---\n  if (potentialCandidates.length > 0) {\n    let firstCandidate = potentialCandidates[0];\n    if (firstCandidate.startsWith('@')) {\n      firstCandidate = firstCandidate.substring(1);\n    }\n    if (firstCandidate) {\n      // Sanitize just before returning\n      return sanitizeTag(camelcase(firstCandidate));\n    }\n  }\n\n  // --- Heuristic 4: Default ---\n  console.warn(\n    `Could not determine a suitable tag for path: ${pathString}, operationId: ${operationId}. Using 'unknown'.`,\n  );\n  return 'unknown'; // 'unknown' is safe\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\n\nimport { camelcase } from '@sdk-it/core';\n\nimport { reservedKeywords, reservedSdkKeywords } from './reserved-keywords.js';\n\nexport function sanitizeTag(tag: string): string {\n  // Prepend underscore if starts with a number\n  if (/^\\d/.test(tag)) {\n    return `_${tag}`;\n  }\n\n  tag = tag\n    // Remove any non-alphanumeric characters except underscores and dashes\n    .replace(/[^A-Za-z0-9_-]/g, '')\n    // Normalize multiple dashes to a single dash\n    .replace(/-+/g, '-');\n\n  // Append underscore if it's a reserved keyword\n  if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {\n    return `${tag}_`;\n  }\n  return tag;\n}\nexport function sanitizeImportName(tag: string): string {\n  // Prepend underscore if starts with a number\n  if (/^\\d/.test(tag)) {\n    return `_${tag}`;\n  }\n\n  tag = tag\n    // Remove any non-alphanumeric characters except underscores\n    .replace(/[^A-Za-z0-9_-]/g, '');\n\n  // Append underscore if it's a reserved keyword\n  if (reservedKeywords.has(tag) || reservedSdkKeywords.has(tag)) {\n    return `${tag}_`;\n  }\n  return tag;\n}\n\n/**\n * Attempts to determine a generic tag for an OpenAPI operation based on path and operationId.\n * Rules and fallbacks are documented within the code.\n * @param pathString The path string.\n * @param operation The OpenAPI Operation Object.\n * @returns A sanitized, camelCased tag name string.\n */\nexport function determineGenericTag(\n  pathString: string,\n  operation: OperationObject,\n): string {\n  const operationId = operation.operationId || '';\n  const VERSION_REGEX = /^[vV]\\d+$/;\n  const commonVerbs = new Set([\n    // Verbs to potentially strip from operationId prefix\n    'get',\n    'list',\n    'create',\n    'update',\n    'delete',\n    'post',\n    'put',\n    'patch',\n    'do',\n    'send',\n    'add',\n    'remove',\n    'set',\n    'find',\n    'search',\n    'check',\n    'make',\n  ]);\n\n  const segments = pathString.split('/').filter(Boolean);\n\n  const potentialCandidates = segments.filter(\n    (segment) =>\n      segment &&\n      !segment.startsWith('{') &&\n      !segment.endsWith('}') &&\n      !VERSION_REGEX.test(segment),\n  );\n\n  // --- Heuristic 1: Last non-'@' path segment ---\n  for (let i = potentialCandidates.length - 1; i >= 0; i--) {\n    const segment = potentialCandidates[i];\n    if (!segment.startsWith('@')) {\n      // Sanitize just before returning\n      return sanitizeTag(camelcase(segment));\n    }\n  }\n\n  const canFallbackToPathSegment = potentialCandidates.length > 0;\n\n  // --- Heuristic 2: OperationId parsing ---\n  if (operationId) {\n    const lowerOpId = operationId.toLowerCase();\n    const parts = operationId\n      .replace(/([a-z])([A-Z])/g, '$1_$2')\n      .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')\n      .replace(/([a-zA-Z])(\\d)/g, '$1_$2')\n      .replace(/(\\d)([a-zA-Z])/g, '$1_$2')\n      .toLowerCase()\n      .split(/[_-\\s]+/);\n\n    const validParts = parts.filter(Boolean);\n\n    // Quick skip: If opId is just a verb and we can use Heuristic 3, prefer that.\n    if (\n      commonVerbs.has(lowerOpId) &&\n      validParts.length === 1 &&\n      canFallbackToPathSegment\n    ) {\n      // Proceed directly to Heuristic 3\n    }\n    // Only process if there are valid parts and the quick skip didn't happen\n    else if (validParts.length > 0) {\n      const firstPart = validParts[0];\n      const isFirstPartVerb = commonVerbs.has(firstPart);\n\n      // Case 2a: Starts with verb, has following parts\n      if (isFirstPartVerb && validParts.length > 1) {\n        const verbPrefixLength = firstPart.length;\n        let nextPartStartIndex = -1;\n        if (operationId.length > verbPrefixLength) {\n          // Simplified check for next part start\n          const charAfterPrefix = operationId[verbPrefixLength];\n          if (charAfterPrefix >= 'A' && charAfterPrefix <= 'Z') {\n            nextPartStartIndex = verbPrefixLength;\n          } else if (charAfterPrefix >= '0' && charAfterPrefix <= '9') {\n            nextPartStartIndex = verbPrefixLength;\n          } else if (['_', '-'].includes(charAfterPrefix)) {\n            nextPartStartIndex = verbPrefixLength + 1;\n          } else {\n            const match = operationId\n              .substring(verbPrefixLength)\n              .match(/[A-Z0-9]/);\n            if (match && match.index !== undefined) {\n              nextPartStartIndex = verbPrefixLength + match.index;\n            }\n            if (\n              nextPartStartIndex === -1 &&\n              operationId.length > verbPrefixLength\n            ) {\n              nextPartStartIndex = verbPrefixLength; // Default guess\n            }\n          }\n        }\n\n        if (\n          nextPartStartIndex !== -1 &&\n          nextPartStartIndex < operationId.length\n        ) {\n          const remainingOriginalSubstring =\n            operationId.substring(nextPartStartIndex);\n          const potentialTag = camelcase(remainingOriginalSubstring);\n          if (potentialTag) {\n            // Sanitize just before returning\n            return sanitizeTag(potentialTag);\n          }\n        }\n\n        // Fallback: join remaining lowercased parts\n        const potentialTagJoined = camelcase(validParts.slice(1).join('_'));\n        if (potentialTagJoined) {\n          // Sanitize just before returning\n          return sanitizeTag(potentialTagJoined);\n        }\n      }\n\n      // Case 2b: Doesn't start with verb, or only one part (might be verb)\n      const potentialTagFull = camelcase(operationId);\n      if (potentialTagFull) {\n        const isResultSingleVerb = validParts.length === 1 && isFirstPartVerb;\n\n        // Avoid returning only a verb if Heuristic 3 is possible\n        if (!(isResultSingleVerb && canFallbackToPathSegment)) {\n          if (potentialTagFull.length > 0) {\n            // Sanitize just before returning\n            return sanitizeTag(potentialTagFull);\n          }\n        }\n      }\n\n      // Case 2c: Further fallbacks within OpId if above failed/skipped\n      const firstPartCamel = camelcase(firstPart);\n      if (firstPartCamel) {\n        const isFirstPartCamelVerb = commonVerbs.has(firstPartCamel);\n        if (\n          !isFirstPartCamelVerb ||\n          validParts.length === 1 ||\n          !canFallbackToPathSegment\n        ) {\n          // Sanitize just before returning\n          return sanitizeTag(firstPartCamel);\n        }\n      }\n      if (\n        isFirstPartVerb &&\n        validParts.length > 1 &&\n        validParts[1] &&\n        canFallbackToPathSegment\n      ) {\n        const secondPartCamel = camelcase(validParts[1]);\n        if (secondPartCamel) {\n          // Sanitize just before returning\n          return sanitizeTag(secondPartCamel);\n        }\n      }\n    } // End if(validParts.length > 0) after quick skip check\n  } // End if(operationId)\n\n  // --- Heuristic 3: First path segment (stripping '@') ---\n  if (potentialCandidates.length > 0) {\n    let firstCandidate = potentialCandidates[0];\n    if (firstCandidate.startsWith('@')) {\n      firstCandidate = firstCandidate.substring(1);\n    }\n    if (firstCandidate) {\n      // Sanitize just before returning\n      return sanitizeTag(camelcase(firstCandidate));\n    }\n  }\n\n  // --- Heuristic 4: Default ---\n  console.warn(\n    `Could not determine a suitable tag for path: ${pathString}, operationId: ${operationId}. Using 'unknown'.`,\n  );\n  return 'unknown'; // 'unknown' is safe\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/tune-request-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tune-request-body.d.ts","sourceRoot":"","sources":["../../src/lib/tune-request-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,YAAY,EACZ,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,EAAE,EACR,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,EAAE,yBAAyB,EAAE,QA+BtC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,EAAE,EACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,EAAE,yBAAyB,EAAE,GACpC,oBAAoB,CA+DtB"}
+{"version":3,"file":"tune-request-body.d.ts","sourceRoot":"","sources":["../../src/lib/tune-request-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,YAAY,EACZ,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,EAAE,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,EAAE,EACR,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,EAAE,yBAAyB,EAAE,QAiCtC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,EAAE,EACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,EAC1B,UAAU,EAAE,eAAe,EAAE,EAC7B,QAAQ,EAAE,yBAAyB,EAAE,GACpC,oBAAoB,CAuEtB"}

package/dist/lib/tune-request-body.js

@@ -8,11 +8,13 @@ function patchParameters(spec, schema, parameters, security) {
     security,
     spec.components.securitySchemes
   );
-  let required = Array.isArray(schema.required) ? schema.required : [];
+  const required = new Set(
+    Array.isArray(schema.required) ? schema.required : []
+  );
   schema["x-properties"] ??= {};
   for (const param of parameters) {
     if (param.required) {
-      required.push(param.name);
+      required.add(param.name);
     }
     schema["x-properties"][param.name] = {
       "x-in": param.in,
@@ -20,25 +22,26 @@ function patchParameters(spec, schema, parameters, security) {
     };
   }
   for (const param of securityOptions) {
-    required = required.filter((name) => name !== param.name);
+    required.delete(param.name);
     schema["x-properties"][param.name] = {
       "x-in": "header",
       ...isRef(param.schema) ? followRef(spec, param.schema.$ref) : param.schema ?? { type: "string" }
     };
   }
-  schema["x-required"] = required;
+  schema["x-required"] = [...required];
 }
 function tuneRequestBody(spec, operationId, operation, parameters, security) {
-  const inputName = findUniqueSchemaName(spec, operationId, [
-    "input",
-    "payload",
-    "request"
-  ]);
-  const requestBody = isRef(operation.requestBody) ? followRef(spec, operation.requestBody.$ref) : operation.requestBody ?? {
+  const requestBodySource = isRef(operation.requestBody) ? followRef(spec, operation.requestBody.$ref) : operation.requestBody ?? {
     content: {},
     required: false
   };
+  const requestBody = structuredClone(requestBodySource);
   if (isEmpty(requestBody.content)) {
+    const inputName = findUniqueSchemaName(spec, operationId, [
+      "input",
+      "payload",
+      "request"
+    ]);
     const schema = {
       "x-inputname": inputName,
       "x-requestbody": true
@@ -57,10 +60,17 @@ function tuneRequestBody(spec, operationId, operation, parameters, security) {
   }
   for (const contentType in requestBody.content) {
     const mediaType = requestBody.content[contentType];
+    const inputName = findUniqueSchemaName(spec, operationId, [
+      "input",
+      "payload",
+      "request"
+    ]);
     let schema;
     switch (true) {
       case isRef(mediaType.schema):
-        schema = followRef(spec, mediaType.schema.$ref);
+        schema = structuredClone(
+          followRef(spec, mediaType.schema.$ref)
+        );
         break;
       case isEmpty(mediaType.schema):
         schema ??= {};
@@ -69,7 +79,7 @@ function tuneRequestBody(spec, operationId, operation, parameters, security) {
         );
         break;
       default:
-        schema = mediaType.schema;
+        schema = structuredClone(mediaType.schema);
         break;
     }
     patchParameters(spec, schema, parameters, security);